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:

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

Placeholders

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

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

License

MIT — see LICENSE for details.

Made by fantac4t for TSNSMP