Noventra TAB

# 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

1. Install the jar into `plugins`.
2. Restart the server.
3. Run `/noventra status`.
4. Run `/noventra validate`.
5. 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:

```text
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:

```text
/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:

```text
/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:

```text
/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.