Server Commands

While VoiceCraft.Server is running, console commands are available for moderation and entity management.

Basic

  • list [--clientsOnly] [--limit N] list entities currently known to the server
  • stop stop the server
  • shutdown alias of stop
  • kick <id> disconnect a network client

Client state management

  • mute <id>
  • unmute <id>
  • deafen <id>
  • undeafen <id>

Important behavior:

  • on regular entities, these toggle entity mute / deafen state
  • on connected network clients, the server uses the dedicated server-side flags (ServerMuted, ServerDeafened)

Entity data management

  • setname <id> <value>
  • settitle <id> <value>
  • setdescription <id> <value>
  • setposition <id> <x> <y> <z>
  • setworldid <id> <value>

Notes:

  • settitle and setdescription target network entities
  • setname, setposition, and setworldid work on general entities
  • empty title / description values are normalized to an empty string

list options

  • --clientsOnly list only connected network clients
  • --limit <N> limit the number of rows shown

Example:

list --clientsOnly --limit 25

Practical workflow

list --clientsOnly
setworldid 12 spawn_world
setposition 12 100 64 100
mute 15
kick 18

Failure cases

The server returns an error when:

  • the entity ID does not exist
  • a command expects a network client but receives a non-network entity
  • list --limit is negative

When these commands are useful

  • testing addon or plugin integration
  • correcting bad entity metadata
  • staff moderation
  • validating world ID and position updates during setup