Placeholders

SocketSVC publishes its live voice state as placeholders, so other plugins and mods can put "who is talking" into a tab list, scoreboard, chat format or hologram without touching the voice API.

The same values are served on every platform — only the syntax differs.

Both are optional. If the placeholder framework is not installed, SocketSVC logs nothing beyond a debug line and voice chat is unaffected — there is no config to enable.

Identifiers複製段落連結

Server-wide複製段落連結

These answer the same for everyone and work in console or player-less renders.

About the viewing player複製段落連結

These are answered about whoever the placeholder is being rendered for.

status is the one identifier written to be shown as-is. It is ranked, not combined: a deafened player reads deafened even while their microphone is open, because they are not hearing anyone.

About another player複製段落連結

These take a second player's name and answer from the viewer's point of view.

Text Placeholder API passes the name as an argument after a space instead: %socketsvc:can_hear Alex%. Both forms are accepted on both platforms.

These are directional. can_hear_Alex rendered for Steve asks whether Steve hears Alex, which is not the same question as the reverse once one side has deafened themselves, lost socketsvc.listen, or is hidden by visible-players-only. Names are matched exactly and case-sensitively against online players; an unknown name resolves to an empty string.

The answer applies every rule the relay itself applies — range falloff, world, visibility, spectator mode, deafen and both players' permissions — because it is computed by the same code that decides what to route. A can_hear of true means audio is genuinely flowing right now.

Values複製段落連結

Values are machine-readable rather than pretty, because placeholder output is usually fed into another plugin's comparison or formatting:

• Booleans are true / false, never Yes / No or a coloured symbol.
• Numbers carry no units, separators or trailing .0.
• An unknown identifier is left untouched rather than blanked, so a typo is visible instead of silently producing an empty column.
• A player-scoped identifier rendered with no player (console, or a template compiled once at startup) resolves to an empty string rather than an error.

Turn them into something readable with whatever conditional or replacement feature your tab-list, scoreboard or chat plugin already provides — most compare a placeholder's value against a string and substitute text for it. %socketsvc_status% is usually the one to branch on, since its four values map directly onto four icons.

Examples複製段落連結

# Scoreboard line
"&7Voice: &f%socketsvc_connected_count% &7online, &f%socketsvc_speaking_count% &7talking"

# Chat format prefix
"%socketsvc_status% &8| &f%player_name%&7: "

# Only render a proximity marker when they can actually hear you
"%socketsvc_can_hear_Alex%"

Notes and limits複製段落連結

• Mute is not a placeholder. SocketSVC enforces microphone mute entirely on the client, which never tells the server about it, so the server genuinely does not know. speaking is the honest equivalent: a muted player simply never relays a frame. Deafen is known, because it changes what the server routes.
• speaking is a 400 ms window after the last relayed frame, matching the client's own speaking indicator so a nameplate and a tab-list column never disagree. It stays false for a player whose frames are being dropped for lack of socketsvc.speak.
• Reload-safe. /ssvc-server reload swaps the listener underneath; placeholders follow it without re-registration and never need a server restart.
• Text Placeholder API is bound reflectively, because it is published per Minecraft version and its releases do not cover SocketSVC's whole supported matrix. One code path therefore serves every version and loader, and simply does nothing when the mod is absent. If a future release changes the API shape, SocketSVC logs a warning and carries on rather than failing to start.
• For mods without a placeholder framework, SocketSvcModApi.placeholder(viewer, identifier) returns the same values directly. See the mod API. The Paper plugin exposes the resolver the same way through SocketSvcPlugin#placeholderSource().