NeoTab – Modern Tablist, Scoreboard & ActionBar Customization

NeoTab is a modern, lightweight, and highly customizable Minecraft plugin for Paper, Spigot, and CraftBukkit servers.
It combines animated tab headers and footers, configurable scoreboards, ActionBar modules, region-based profiles, optional plugin integrations, and in-game management tools in a single shared JAR.

NeoTab is built for lobbies, SMPs, challenge servers, small networks, and server owners who want polished visuals without installing a heavy all-in-one plugin.

---

✨ Main Features

• Animated tab header and footer
• Live RAM, ping, average ping, and player statistics
• Configurable scoreboards
• ActionBar modules
• Region-based profiles
• In-game GUI and commands
• Optional LuckPerms and PlaceholderAPI support
• Performance presets and custom update intervals
• One shared JAR for Paper, Spigot, and CraftBukkit
• Anonymous bStats metrics
• Extensive permission and lifecycle handling

---

🎨 Animated Tablist

Customize your server name and tablist with multiple animation styles:

• ✨
• purple-pulse
• gradient-wave
• static

NeoTab supports:

• MiniMessage formatting
• RGB colors and gradients
• Custom color palettes
• Bold and decorated text
• Animated server names
• Dynamic footer values

The tablist can display:

• RAM usage and percentage
• Player ping and average server ping
• Online / maximum players
• Custom text and placeholders

---

📋 Configurable Scoreboard

NeoTab includes an optional scoreboard system with:

• Animated titles
• Multiple visual styles
• Custom lines
• RAM and ping information
• Player and server placeholders
• Global and per-player enable states
• Presets
• External scoreboard ownership detection
• Automatic recovery when another plugin releases the scoreboard

Fast update intervals remain available for small servers that want smooth animations.
NeoTab warns about potentially expensive configurations instead of enforcing a slow minimum interval.

---

💬 ActionBar Modules

NeoTab offers several optional ActionBar modules:

• Timer
• Stopwatch
• Clock
• Welcome messages
• Random messages
• Advancement counter
• Nearest player display

Each module can be enabled or disabled independently.
Random messages support MiniMessage, legacy colors, RGB colors, gradients, and automatic NeoTab palette formatting.
The Nearest Player module respects Bukkit visibility and does not reveal vanished players.

---

🗺️ Region Profiles

Region Profiles let you apply different NeoTab settings based on a player’s location.
They are ideal for:

• Spawn areas
• Minigame zones
• PvP arenas
• Shops
• Event areas
• Themed regions
• World-specific tab or scoreboard layouts

Region changes are optimized and debounced to avoid unnecessary refresh storms.
WorldEdit and FastAsyncWorldEdit can optionally be used for region selection.

---

🖥️ In-Game Management

Most important settings can be changed without editing files manually.

Main command:

/tab
Examples:

/tab setname <name>
/tab style <style>
/tab footer
/tab refresh
/tab reload
/tab performance <preset>
/tab scoreboard
/tab region
/tab timer

NeoTab also provides GUI-based management for several systems.
All changes are stored persistently and remain active after a restart.

---

⚡ Performance First

NeoTab is designed to stay lightweight under both normal and heavy server load.

Performance features include:

• Cached player names and permission decorations
• Cached RAM, ping, and footer data
• Batched join and quit refreshes
• Debounced region updates
• Reduced unnecessary global refreshes
• Cached static scoreboard templates
• Reduced PlaceholderAPI work
• Skipped updates when displayed content has not changed
• Cached platform bridges and reflection strategies
• Non-blocking YAML persistence
• Configurable performance presets

Available performance modes:

• smooth
• balanced
• light
• Custom tick values

Small servers can still use very fast intervals, while larger servers receive warnings when a configuration may become expensive.

---

🔌 Optional Integrations

NeoTab works completely without additional plugins.

Optional integrations:

• PlaceholderAPI
• LuckPerms
• WorldEdit
• FastAsyncWorldEdit
• Geyser detection

Missing optional plugins never prevent NeoTab from starting.

---

🔐 Permissions

NeoTab uses a detailed permission system for commands, GUI actions, scoreboards, timers, regions, reloads, and administrative changes.

Common permissions:

• neotab.admin
• neotab.reload
• neotab.gui
• neotab.scoreboard
• neotab.timer
• neotab.timer.admin
• neotab.region

Child permissions allow individual features to be delegated without granting full administrative access.

---

⚙️ Configuration

NeoTab is designed to be easy to configure while still offering advanced control.

You can customize:

• Server name
• Animation style
• Color palette
• Header and footer format
• Scoreboard title and lines
• Update intervals
• Performance mode
• ActionBar modules
• Region profiles
• Language
• Optional integrations
• Metrics
• Permissions and feature defaults

Existing configurations remain compatible across updates whenever possible.
New values are added without overwriting user settings.

---

📊 Anonymous Metrics

NeoTab uses bStats to collect anonymous usage statistics.

Metrics may include:

• Server platform
• Minecraft version
• Java version
• Enabled NeoTab features
• Optional integration availability
• Configured language
• Animation count category

NeoTab never sends:

• IP addresses
• Server names
• Player names or UUIDs
• Messages
• World names
• Permissions
• Configuration contents
• Displayed tablist or scoreboard text
• File paths
• Secrets or tokens

Metrics can be disabled in the NeoTab configuration or globally through bStats.

✅ Compatibility

NeoTab supports:

• Paper
• Spigot
• CraftBukkit

Requirements:

• Minecraft 1.20.6 or newer
• Java 21 or newer

The same NeoTab JAR is used across all supported platforms.

NeoTab is tested across multiple Minecraft versions and server implementations before every release.

---

🧪 Beta Versions

Beta releases are used for large updates and major internal changes.

They undergo automated tests, platform testing, manual checks, and dedicated security, logic, and performance reviews before publication.

Beta versions may still contain undiscovered edge cases and should be tested carefully before deployment on large production servers.

Always keep a backup of your NeoTab configuration before updating.

---

🐛 Bug Reports

Found a bug, console warning, compatibility issue, permission problem, or unexpected behavior?

Please report it on GitHub Issues:

https://github.com/DasEtwa/NeoTab/issues

Please include:

• NeoTab version
• Server software and version
• Minecraft version
• Java version
• Installed plugins
• Relevant configuration
• Full console error or log
• Steps to reproduce the issue

Please avoid reporting bugs only through Modrinth comments — GitHub Issues are much easier to track, reproduce, and fix.

---

📦 Links

• GitHub: https://github.com/DasEtwa/NeoTab
• Bug Reports: https://github.com/DasEtwa/NeoTab/issues
• Modrinth: /plugins/neotab
• bstats: https://bstats.org/plugin/bukkit/NeoTab/32846

---

Why NeoTab?

NeoTab is for server owners who want a modern, animated, and highly configurable tablist experience without installing a massive all-in-one plugin.

One JAR.
Multiple platforms.
Clean visuals.
Flexible configuration.
Strong performance.
No unnecessary bloat.