# 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
- Placeholder cache
- Animation frames
- In-game editor
- Live reload
- Config backups
- Diagnostics command
- 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
- **Geyser/Floodgate** - detected fail-soft
- **ProtocolLib** - detected fail-soft

Missing integrations will not crash the plugin.

## Commands

```text
/noventra help
/noventra about
/noventra doctor
/noventra reload
/noventra defaults
/noventra editor
/noventra preview
/noventra debug
/noventra layout list
/noventra layout <layout>
/noventra animation
```

## Configuration

Noventra TAB uses separated configuration files instead of one giant YAML:

```text
config.yml
messages.yml
layouts/default.yml
layouts/survival.yml
layouts/events.yml
animations.yml
groups.yml
placeholders.yml
```

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.

## Performance

Noventra TAB is designed around performance-friendly rendering:

- No full redraw every tick
- Differential updates
- 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.