================================================================================ PhantomTab v1.0.0 - CHANGELOG Animated tab list + ping display for Paper 26.3 Made by PhantomDevelopment

FILE : PhantomTab-1.0.0.jar SIZE : 53 KB SERVER : Paper 26.3 (build 231 tested) JAVA : Java 25 (server requirement) API : paper-api 26.3.build.231-stable COMMAND : /phantontab (aliases: /ptab, /pt, /phantomtab) FOLDER : plugins/PhantomTab/config.yml (generated on first start)

---

v1.0.0 - INITIAL RELEASE

TAB LIST

• Animated header and footer with unlimited frames
• Frames rotate on a real 20-tick clock (default: new frame every 3 seconds)
• Refresh every 2 ticks (10x per second) for smooth motion
• Server name and store link placeholders at the top of the config
• Optional join flash (welcome tab list for a few seconds after joining)

ANIMATED PLACEHOLDERS

• %title% gradient title that slides through your colour palette
• %bar% / %bar_long% / %bar_short% bars that fill and empty with a moving tip
• %tps_bar% / %tps_bar_long% TPS bar, changes colour when the server lags
• %pulse% breathing ping dot
• %spinner% rotating spinner
• %dot% variants %dots%
• %sparkle% / %sparkle_alt% flickering sparkles
• %marquee% scrolling text (server - store - discord)
• %rotate% rotating announcements from the config list

PING

• Colour-coded ping with editable thresholds (green / yellow / gold / red)
• Ping bars (5 levels) per player
• Ping inside the tab list header/footer
• Each player's own ping next to their name in the player list
• Names are padded so the ping column lines up perfectly
• Optional player list sorting: none / ping / name

SERVER INFO PLACEHOLDERS

• %server% %servername% %store% %discord% %website%
• %online% %max% %staff% %world_players%
• %tps% %tps_colored% %mspt% %uptime% %time% %date%
• %player% %displayname% %world% %layout% %pad% %pad_long%

LAYOUTS

• Extra layouts by permission and/or world
• Highest priority that matches wins, everyone else gets the default design
• Per-layout player list format (example: staff layout shipped, plus a disabled world-based "event" example)

COLOURS

• Classic codes &b &l &c &r
• Hex &#ff00aa
• MiniMessage gradient:#00e0ff:#a05bfftext, , , , <✨>
• All three styles work together in the same line

COMMANDS

• /ptab help
• /ptab preview shows your header, footer and player rows in chat
• /ptab info version, server name, store, layout, ping status, hooks
• /ptab ping [player] colour-coded ping
• /ptab toggle [player] hide / show the tab list
• /ptab reload reloads config.yml, reports the time taken
• /ptab version
• Tab completion for every subcommand and player names

PERMISSIONS

• phantontab.use (default: everyone)
• phantontab.reload (default: op)
• phantontab.toggle (default: everyone)
• phantontab.toggle.others (default: op)
• phantontab.ping (default: everyone)
• phantontab.ping.others (default: op)
• phantontab.info (default: op)
• phantontab.staff (default: op)
• phantontab.layout.staff (default: op)

EXTRA

• Optional PlaceholderAPI support (reflection based, works fine without it)
• Worlds can be excluded from the tab list
• Timezone / time / date format configurable
• NO auto-updater, no bStats, no external connections, no downloads
• "Made by PhantomDevelopment" in the console banner, /ptab version, the default footer and the JAR manifest
• Broken config.yml can never take the server down:
  • on /ptab reload it keeps the previous settings and tells you
  • on startup the bad file is saved as config-broken-.yml and a fresh default config is written automatically
• Old config versions are backed up as config-old--.yml
• Performance: ~54 microseconds per rendered line, placeholder resolution in a single pass with a component cache (raise update-interval-ticks to 4-10 on very large servers)

---

INSTALL

1. Put PhantomTab-1.0.0.jar into your plugins/ folder
2. Restart the server
3. Edit plugins/PhantomTab/config.yml (server name + store are at the top)
4. Run /ptab reload and /ptab preview

---

TESTING PERFORMED ON THIS BUILD

• Compiled against paper-api 26.3.build.231-stable with JDK 25
• 20 automated tests pass (load, tab content, animation timing, layouts, toggle, join flash, reload, every placeholder, ping thresholds, config recovery, performance budget)
• Booted on a real Paper 26.3 build 231 server: clean enable, no errors, commands verified, TPS 20.0
• Broken config handling verified live (reload + startup repair)

---

Made by PhantomDevelopment