Noventra TAB
Noventra TAB 是一款面向现代 Paper 服务器的简洁 TAB 和 HUD 插件。
它通过可配置的 TAB 列表、侧边栏记分板、BossBar、ActionBar、名称标签、布局、MiniMessage 样式、动画和缓存占位符,为您的服务器打造精致的游戏内标识。
Noventra TAB 专为 SMP、生存、经济、原版增强(vanilla+)、生命窃取以及社区服务器设计,旨在提供美观的 HUD,无需网页面板、云账户、市场或 SaaS 系统及外部许可证后端。
功能
- 自定义 TAB 标题和页脚
- 玩家列表格式化
- 基于组、权限、世界和姓名的排序
- 侧边栏记分板
- BossBar
- ActionBar
- 基于团队的名称标签
- MiniMessage 和 RGB 渐变
- 布局系统
- 内置布局:default、survival、lobby、events 和 staff
- 占位符缓存
- 动画帧
- 基础游戏内编辑器和预览工具
- 热重载
- 配置备份
- 清晰的诊断、状态和占位符测试命令
- 可选集成
可选集成
Noventra TAB 可独立运行。
安装以下插件时会添加额外数据:
- LuckPerms - 组、前缀、后缀和权重
- PlaceholderAPI - 外部
%placeholder% 扩展
- Vault - 经济余额占位符
以下插件以容错方式检测以进行兼容性诊断:
- Geyser/Floodgate
- ProtocolLib
缺失的集成不会导致插件崩溃。
命令
/ntab 是 /noventra 的简短别名。
| 命令 |
用途 |
/noventra help |
显示命令菜单 |
/noventra status |
显示插件、模块、布局和集成状态 |
/noventra doctor [player] |
诊断插件及玩家的解析布局 |
/noventra modules |
显示启用的 HUD 模块 |
/noventra dump |
打印用于错误报告的支持/调试信息 |
/noventra validate |
验证配置文件、布局和占位符 |
/noventra placeholders |
列出内置占位符 |
/noventra parse [player] <text> |
测试占位符输出 |
/noventra reload |
重新加载配置 |
/noventra defaults |
使用备份恢复内置高级默认值 |
/noventra editor |
打开基础游戏内编辑器 |
/noventra preview [layout] |
应用布局预览 |
/noventra layout list |
列出已加载的布局 |
/noventra layout <layout> |
设置个人预览布局 |
/noventra animation |
列出动画 |
权限
| 权限 |
用途 |
noventra.admin |
授予所有 Noventra 命令权限 |
noventra.reload |
允许重载和默认值恢复 |
noventra.editor |
允许使用游戏内编辑器 |
noventra.preview |
允许布局预览 |
noventra.debug |
允许使用状态、医生、模块、dump、调试和解析工具 |
noventra.validate |
允许配置验证 |
noventra.placeholders |
允许列出占位符 |
noventra.layout |
允许管理布局预览 |
noventra.animation |
允许检查动画 |
noventra.bypass |
绕过可见性规则 |
内置占位符
| 占位符 |
含义 |
{player} |
玩家名称 |
{display_name} |
玩家显示名称 |
{world} |
当前世界 |
{online} |
在线玩家数 |
{max_players} |
服务器最大玩家数 |
{ping} |
玩家延迟 |
{tps} |
服务器 TPS |
{group} |
解析后的 Noventra 组 |
{prefix} |
解析后的组前缀 |
{suffix} |
解析后的组后缀 |
{stat_player_kills} |
玩家击杀统计 |
{vault_balance} |
当安装了 Vault 和经济插件时的 Vault 余额 |
{luckperms_group} |
安装时 LuckPerms 主组 |
{luckperms_prefix} |
安装时 LuckPerms 前缀 |
{luckperms_suffix} |
安装时 LuckPerms 后缀 |
{animation:<id>} |
来自 animations.yml 的动画帧 |
快速开始
- 将 jar 文件安装到
plugins 文件夹中。
- 重启服务器。
- 运行
/noventra status。
- 运行
/noventra validate。
- 使用
/noventra preview survival、/noventra preview lobby、/noventra preview events 或 /noventra preview staff 预览设计。
配置
Noventra TAB 使用分离的配置文件,而不是一个巨大的 YAML 文件:
config.yml
messages.yml
layouts/default.yml
layouts/survival.yml
layouts/lobby.yml
layouts/events.yml
layouts/staff.yml
animations.yml
groups.yml
placeholders.yml
config.yml 包含 config-version。如果安装的配置文件版本低于内置版本,Noventra 会记录警告。
内置的默认配置旨在安装后立即呈现精致的外观。
您可以随时通过以下命令恢复内置的高级配置:
/noventra defaults
替换前会先备份旧文件。
故障排除
布局未生效
运行 /noventra doctor <player> 并检查布局原因。布局可以通过世界、权限、组或手动预览覆盖来匹配。
占位符显示为空
运行 /noventra placeholders,然后使用以下命令测试确切文本:
/noventra parse <player> <text>
记分板、BossBar 或名称标签不可见
运行 /noventra modules 并检查 config.yml -> features。
编辑 YAML 后出现问题
运行:
/noventra validate
/noventra reload
安装了其他 TAB 或记分板插件
禁用其中一个插件中的重叠模块。两个插件不应同时控制相同的 TAB、记分板、BossBar、ActionBar 或名称标签团队。
性能
Noventra TAB 围绕性能友好的渲染进行设计:
- 采用计划间隔更新,而非每刻全重绘
- 尽可能使用差分渲染
- 缓存 MiniMessage 组件
- 缓存占位符值
- 可配置的更新间隔
- 安全清理(禁用时)
- 安全重载行为
要求
- 服务器软件: Paper 或兼容的 Paper 分支
- Minecraft: 1.21.x
- Java: 21 或更高版本
- 适用端: 仅限服务端
备注
Noventra TAB 负责管理玩家的 TAB 列表、侧边栏计分板、Boss 血条、动作栏以及名称标签团队。如果你使用了其他同样控制相同 HUD 元素的插件,请禁用其中一个插件中重叠的模块以避免冲突。
Noventra TAB
Noventra TAB is a clean TAB and HUD plugin for modern Paper servers.
It gives your server a polished in-game identity with a configurable TAB list, sidebar scoreboard, bossbar, actionbar, nametags, layouts, MiniMessage styling, animations and cached placeholders.
Noventra TAB is made for SMP, survival, economy, vanilla+, lifesteal and community servers that want a good-looking HUD without a web panel, cloud account, marketplace, SaaS system or external license backend.
Features
- Custom TAB header and footer
- Player list formatting
- Group, permission, world and name based sorting
- Sidebar scoreboard
- BossBar
- ActionBar
- Team-based nametags
- MiniMessage and RGB gradients
- Layout system
- Bundled layouts: default, survival, lobby, events and staff
- Placeholder cache
- Animation frames
- Basic in-game editor and preview tools
- Live reload
- Config backups
- Clean diagnostics, status and placeholder test commands
- Optional integrations
Optional Integrations
Noventra TAB works standalone.
These plugins add extra data when installed:
- LuckPerms - group, prefix, suffix and weight
- PlaceholderAPI - external
%placeholder% expansions
- Vault - economy balance placeholders
These plugins are detected fail-soft for compatibility diagnostics:
- Geyser/Floodgate
- ProtocolLib
Missing integrations will not crash the plugin.
Commands
/ntab is available as a short alias for /noventra.
| Command |
Purpose |
/noventra help |
Shows the command menu |
/noventra status |
Shows plugin, module, layout and integration status |
/noventra doctor [player] |
Diagnoses the plugin and a player's resolved layout |
/noventra modules |
Shows enabled HUD modules |
/noventra dump |
Prints support/debug information for bug reports |
/noventra validate |
Validates config files, layouts and placeholders |
/noventra placeholders |
Lists built-in placeholders |
/noventra parse [player] <text> |
Tests placeholder output |
/noventra reload |
Reloads configuration |
/noventra defaults |
Restores bundled premium defaults with backups |
/noventra editor |
Opens the basic in-game editor |
/noventra preview [layout] |
Applies a layout preview |
/noventra layout list |
Lists loaded layouts |
/noventra layout <layout> |
Sets a personal preview layout |
/noventra animation |
Lists animations |
Permissions
| Permission |
Purpose |
noventra.admin |
Grants all Noventra command permissions |
noventra.reload |
Allows reload and default restoration |
noventra.editor |
Allows the in-game editor |
noventra.preview |
Allows layout previews |
noventra.debug |
Allows status, doctor, modules, dump, debug and parse tools |
noventra.validate |
Allows config validation |
noventra.placeholders |
Allows placeholder listing |
noventra.layout |
Allows layout preview management |
noventra.animation |
Allows animation inspection |
noventra.bypass |
Bypasses visibility rules |
Built-in Placeholders
| Placeholder |
Meaning |
{player} |
Player name |
{display_name} |
Player display name |
{world} |
Current world |
{online} |
Online players |
{max_players} |
Server max players |
{ping} |
Player ping |
{tps} |
Server TPS |
{group} |
Resolved Noventra group |
{prefix} |
Resolved group prefix |
{suffix} |
Resolved group suffix |
{stat_player_kills} |
Player kill statistic |
{vault_balance} |
Vault balance when Vault and an economy plugin are installed |
{luckperms_group} |
LuckPerms primary group when installed |
{luckperms_prefix} |
LuckPerms prefix when installed |
{luckperms_suffix} |
LuckPerms suffix when installed |
{animation:<id>} |
Animation frame from animations.yml |
Quick Start
- Install the jar into
plugins.
- Restart the server.
- Run
/noventra status.
- Run
/noventra validate.
- Preview a design with
/noventra preview survival, /noventra preview lobby, /noventra preview events or /noventra preview staff.
Configuration
Noventra TAB uses separated configuration files instead of one giant YAML:
config.yml
messages.yml
layouts/default.yml
layouts/survival.yml
layouts/lobby.yml
layouts/events.yml
layouts/staff.yml
animations.yml
groups.yml
placeholders.yml
config.yml includes config-version. Noventra logs a warning if an installed config is older than the bundled version.
The bundled default configuration is designed to look polished immediately after installation.
You can restore the bundled premium configuration at any time with:
/noventra defaults
Old files are backed up before being replaced.
Troubleshooting
A layout does not apply
Run /noventra doctor <player> and check the layout reason. Layouts can match by world, permission, group or manual preview override.
A placeholder looks empty
Run /noventra placeholders, then test the exact text with:
/noventra parse <player> <text>
The scoreboard, bossbar or nametag is not visible
Run /noventra modules and check config.yml -> features.
Something broke after editing YAML
Run:
/noventra validate
/noventra reload
Another TAB or scoreboard plugin is installed
Disable overlapping modules in one of the plugins. Two plugins should not control the same TAB, scoreboard, bossbar, actionbar or nametag teams at the same time.
Performance
Noventra TAB is designed around performance-friendly rendering:
- Scheduled interval updates instead of every-tick full redraws
- Differential rendering where possible
- Cached MiniMessage components
- Cached placeholder values
- Configurable update intervals
- Safe cleanup on disable
- Safe reload behavior
Requirements
- Server software: Paper or compatible Paper fork
- Minecraft: 1.21.x
- Java: 21 or newer
- Side: Server-side only
Notes
Noventra TAB manages the player TAB, sidebar scoreboard, bossbar, actionbar and nametag teams. If you use another plugin that also controls the same HUD elements, disable overlapping modules in one of the plugins to avoid conflicts.
评论 0
登录后参与评分
还没有评论,来抢沙发吧