Fanta's Smart Placeholders

A Fabric server-side mod that adds live streaming status, custom name colors, player roles, no-sleep toggling, and real-time voice chat indicators via Placeholder API.

Originally built for TSNSMP and designed to work alongside any chat/tablist mod that supports Placeholder API.

[!IMPORTANT] To use this mod's full features, you must have a compatible mod that supports Placeholder API — such as Styled Chat or Styled Player List. The placeholders this mod provides will not appear anywhere without one.

Features

🔴 Live Status

Players who stream can mark themselves as live directly in-game. A configurable LIVE tag appears via placeholder in chat, the tablist, or anywhere your chat mod supports placeholders. A server-wide broadcast announces the stream with a clickable link.

• Toggle with /live
• Set your stream URL with /live link <url>
• Optionally keep live status across reconnects with /live autoLiveOnDisconnect

🎨 Custom Name Colors

Players can set a personal RGB hex color for their name, rendered wherever the color placeholder is used.

• Set with /color <#hex> — e.g. /color #ff6b6b or /color ff6b6b
• Remove with /color clear

🏷️ Player Roles & Suffixes

Assign configurable role symbols to players (supporter, owner, member, etc.). Symbols are fully customizable in the config file and exposed as placeholders. Operators can also assign freeform suffix text to any player.

💤 No-Sleep

Players can opt out of night-skipping. When a no-sleep player is online, anyone who tries to sleep sees a warning title/subtitle and a sound cue. The no-sleep player's placeholder shows a ☠ skull indicator.

• Toggle with /nosleep

🎙️ Voice Chat Integration (optional)

When Simple Voice Chat is installed, real-time voice status icons appear automatically via placeholder:

State Icon Speaking ⌬ Muted ⌭ (currently not working) Deafened ⌮ Disconnected ⌯ In group ⌰ (currently not working)

Icons map to a resource pack font — include the bundled resource pack for correct rendering.

📝 Suffix System (operator only)

Operators can assign custom text suffixes to any player.

• /suffix <player> <text> — set a suffix (max 48 characters)
• /suffix get <player> — view a player's current suffix
• /suffix clear <player> — remove a suffix

Commands

Command Permission Description /live Everyone Toggle your live status /live link <url> Everyone Set your stream URL /live autoLiveOnDisconnect Everyone Toggle auto-off on disconnect /color <hex> Everyone Set your name color /color clear Everyone Remove your name color /nosleep Everyone Toggle no-sleep status /suffix <player> <text> Operator Set a player's suffix /suffix get <player> Operator Get a player's suffix /suffix clear <player> Operator Clear a player's suffix

Placeholders

All placeholders are registered with Placeholder API and work in any compatible chat/tablist mod.

Placeholder Description %playerstatus:live% LIVE tag if the player is live, empty otherwise %playerstatus:stream% Raw stream URL if the player is live, empty otherwise %playerstatus:live_stream% LIVE tag + stream URL combined %playerstatus:clickable_stream% Clickable, hoverable stream link (optional label as argument) %playerstatus:coloredname% Player's name rendered in their chosen color %playerstatus:color% Player's chosen hex color value %playerstatus:role% Player's role symbol (also %playerstatus:suffix%) %playerstatus:vc_status% Current voice chat status icon %playerstatus:nosleep% ☠ skull icon if no-sleep is active, empty otherwise

Installation

1. Install Fabric Loader ≥ 0.18.4
2. Install Fabric API
3. Install Placeholder API
4. Drop FantasSmartPlaceholders-1.5.0.jar into your server's mods/ folder
5. (Optional) Install Simple Voice Chat for voice status icons
6. Start the server — a default config is generated at config/playerstatus/config.json

Configuration

Config is generated at config/playerstatus/config.json on first launch. All message fields support QuickText / MiniMessage formatting.

{ "livePlaceholder": "<red><bold>LIVE</bold></red>", "notLivePlaceholder": "", "liveOnMessage": "<green>You are now live!</green>", "liveOffMessage": "<yellow>You are no longer live.</yellow>", "liveBroadcastMessage": "<gold>{player}</gold> is now live: <aqua><underline><click:open_url:{link}>{link}</click></underline></aqua>", "roles": { "owner": "^", "supporter": "$", "member": "" }, "vcSpeakingIcon": "⌬", "vcMutedIcon": "⌭", "vcDeafenedIcon": "⌮", "vcDisconnectedIcon": "⌯", "vcGroupIcon": "⌰", "noSleepPlaceholder": "<red>☠</red>", "noSleepOnMessage": "<red>You have toggled no-sleep on.</red>", "noSleepOffMessage": "<green>You have toggled no-sleep off.</green>", "noSleepBroadcastOnMessage": "<red>{player} doesn't want to skip the night!</red>", "noSleepBroadcastOffMessage": "<green>{player} is now okay with skipping the night.</green>", "noSleepBedTitle": "<red>Can't skip the night!</red>", "noSleepBedSubtitle": "<yellow>{players} don't want to sleep!</yellow>" }

Template tokens: {player} = player's name, {link} = stream URL, {players} = comma-separated list of no-sleep players.

Requirements

Dependency Type Version Minecraft Required 1.21.11 Fabric Loader Required ≥ 0.18.4 Fabric API Required Any Placeholder API Required Any Simple Voice Chat Optional Any

License

MIT — see LICENSE for details.

Made by fantac4t for TSNSMP