================================================================================ PhantomTab v1.3.0 - CHANGELOG Animated tab list + ping display for Minecraft servers Made by PhantomDevelopment

FILE : PhantomTab-1.3.0.jar SUPPORTS : Minecraft 1.16.5 -> 26.3 (and newer) Paper, Purpur, Pufferfish, forks and plain Spigot JAVA : 17 or newer CONFIG : plugins/PhantomTab/config.yml (config-version 4) DATA : plugins/PhantomTab/data.yml (records, joins, first joins) DESIGNS : neon / royal / minimal / aurora / halloween / cyber / festive / custom

---

v1.3.0 - WAY MORE FEATURES

CONDITIONAL LINES - any header/footer line can hide itself

• A line can be a mapping with a "when:" condition: - text: "Server is lagging!" when: "tps<18"
• 20+ flags: afk, event, staff, day, night, weekend, weekday, rain, storm, clear, full, empty, record, firstjoin, returning, hex, paper
• prefixes: permission:, world:, design:, team:, gamemode:
• numbers: online>, max>, tps<, mspt>, ping>, ram>, rampercent>, hour>=, session>, uptime>, peak>, totaljoins>, afkcount>, eventin>, staffcount>
• combine with && and ||, negate with !

AFK SYSTEM

• Automatic away detection (movement, clicks, blocks, commands, item swaps)
• /ptab afk for a manual toggle, cleared the moment you move again
• afk.timeout-seconds, afk.tag, afk.status-online / status-afk, sort-last
• %afk% %status% %afk_time% %idle% %afk_count%

EVENT MODE

• /ptab event start [minutes] [label] / /ptab event stop
• Switches the tab list to a dedicated event layout while it runs
• %event% %event_in% %event_state% %event_label% (countdown included)
• Broadcast to everyone on start/stop, fully configurable

AUTOMATIC THEMES

• The design changes itself: auto-theme.night-design, day-design
• Seasonal date ranges (MM-DD, wrapping over new year) - halloween and festive ship configured out of the box
• /ptab design pins a design, /ptab design auto hands control back

RECORDS + PERSISTENCE (data.yml)

• All time player record, when it was set, total joins
• Announcement when the record breaks (records.announce + message)
• Per player first join date and current session length
• %peak% %record% %record_date% %record_line% %total_joins% %session% %first_join%

WELCOME / LEAVE

• First time players get a different welcome than returning ones
• Optional leave flash for everyone when somebody disconnects
• %greeting% (morning / afternoon / evening / night, configurable)

NEW COMMANDS

• /ptab design [name|save|auto] switch the look, optionally save it
• /ptab event start|stop event mode
• /ptab afk mark yourself away
• /ptab check validate config.yml, line lengths, designs
• /ptab placeholders every placeholder, in game
• /ptab tags inline tags + the whole condition list

PERFORMANCE

• settings.update-mode: spread - refresh a slice of players per tick instead of everybody at once (smoother on busy servers)
• Everything still runs on the real 20 tick clock

NEW DESIGNS

• cyber - terminal green/cyan, NODES/RAM/IDLE readouts, typewriter uplink
• festive - red/green seasonal look with a first-join welcome line
• Both use conditional lines so they react to AFK, records and lag

CONFIG

• config-version 4: new afk:, event:, auto-theme:, records:, welcome-back:, greetings:, leave-flash: sections. Older configs are backed up, never lost.

---

v1.2.0 - ONE JAR, EVERY VERSION

• Works on 1.16.5 -> 26.3, Paper / Purpur / Spigot
• Own text engine (no Adventure/MiniMessage dependency), legacy § output
• Runtime detection for ping, TPS, list order and RGB colour support

---

v1.1.0 - DESIGN SYSTEM

• 5 designs, inline effect tags, %title_*%, %ram_bar%, %players_bar%, %day_bar%, %ingame_time%, per-design palettes and player rows

---

v1.0.0 - FIRST RELEASE

• Animated header/footer, ping display, layouts, announcements, join flash

---

INSTALL / UPGRADE

1. Put PhantomTab-1.3.0.jar in plugins/ (delete older PhantomTab jars)
2. Start the server - config.yml is generated, an old one is backed up
3. Set server.name and server.store
4. Pick a design with settings.active-design (or /ptab design )
5. /ptab reload, then /ptab check and /ptab preview

---

TESTED

• 35 automated tests green: conditions, conditional lines, AFK, event mode, records/persistence, automatic themes, config checker, text engine, designs, layouts, ping, inline-tag + placeholder resolution, uniform look for staff, performance
• Paper 1.20.6 build 151: full boot, /ptab check reports a clean config, /ptab design lists every design, /ptab event start broadcasts and the countdown updates, banner reports "Paper 1.20.6 | colours: RGB"
• Paper 26.3 build 231: enables and reports itself correctly
• Same sources compile against the Spigot 1.16.5 API (mvn -Plegacy-api-check)
• Real client wire check: a protocol bot joined the server and the tab list packet was decoded for all 7 designs, all 3 frames each - every line, every colour, the store link and the player row verified as the client receives it, with zero unresolved placeholders
• Design mock-ups + animation strips rendered from real plugin output (release/mockups, .png and -strip.png)

---

Made by PhantomDevelopment