Skip to content

Debug Commands

System commands - uses hytale.system.command.* namespace

Debug visualization tools.

Permission: hytale.system.command.debug.*

/debug shape clear
/debug shape sphere
/debug shape cube
/debug shape arrow
/debug shape cone
/debug shape cylinder
/debug shape showforce

Subcommands:

SubcommandPermissionDescription
shape cleardebug.shape.clearClear all debug shapes
shape spheredebug.shape.sphereDraw debug sphere (fixed radius=2.0)
shape cubedebug.shape.cubeDraw debug cube
shape arrowdebug.shape.arrowDraw debug arrow
shape conedebug.shape.coneDraw debug cone
shape cylinderdebug.shape.cylinderDraw debug cylinder
shape showforcedebug.shape.showforceShow force vectors

Note: Shape commands use hardcoded values (radius=2.0, duration=30s, random colors). No arguments are accepted.


Hitbox debugging.

Permission: hytale.system.command.hitbox

/hitbox <hitbox>
/hitbox extents [threshold]
SubcommandArgumentsDescription
(default)<hitbox>Get hitbox info
extents[threshold]Calculate filler block extents
ArgumentTypeRequiredDefaultDescription
hitboxStringYes-Hitbox identifier
thresholdDoubleNo0.5Filler block threshold

Toggles hit detection visual debugging.

Permission: hytale.system.command.hitdetection

/hitdetection

Debug player position tracking.

Permission: hytale.system.command.debugplayerposition

/debugplayerposition

Logging level controls.

Permission: hytale.system.command.log

/log <logger> [level] [--save] [--reset]
ArgumentTypeRequiredDescription
loggerStringYesLogger name or global
levelLogLevelNoLog level to set
--saveFlagNoSave to config
--resetFlagNoRemove from config

Log Levels: OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, ALL


Network diagnostics.

Aliases: net

Permission: hytale.system.command.network.*

/network latencysimulation set <delay> [player]
/network latencysimulation reset [player]
/network serverknockback
/network debugknockback

Subcommands:

SubcommandAliasesArgumentsPermissionDescription
latencysimulation setlatsim set<delay> [player]network.latencysimulation.setSet latency simulation delay
latencysimulation resetlatsim reset, clear[player]network.latencysimulation.resetReset latency simulation
serverknockback--network.serverknockbackServer knockback settings
debugknockback--network.debugknockbackDebug knockback

Network packet statistics.

Permission: hytale.system.command.packetstats

/packetstats <packet> [player]
ArgumentTypeRequiredDescription
packetStringYesPacket name to show stats for
playerPlayerNoTarget player

Control chunk data transmission to clients.

Permission: hytale.system.command.networkchunksending

/networkChunkSending <sendNetworkChunks>
ArgumentTypeRequiredDescription
sendNetworkChunksBooleanYesEnable/disable chunk sending to clients

PID validation check.

Permission: hytale.system.command.pidcheck

/pidcheck

Validate CPB (compiled prefab) files.

Permission: hytale.system.command.validatecpb

/validatecpb

Convert prefab formats.

Permission: hytale.system.command.convertprefabs

/convertprefabs

Set world ticking state.

Permission: hytale.system.command.setticking

/setticking <enabled>

Sleep system testing.

Permission: hytale.system.command.sleep.*

/sleep offset [offset] [--percent]
/sleep test [sleep] [count]
SubcommandArgumentsPermissionDescription
offset[offset] [--percent]sleep.offsetSet sleep time offset
test[sleep] [count]sleep.testTest sleep system
ArgumentTypeRequiredDefaultDescription
offsetFloatNo-Sleep offset value
--percentFlagNo-Interpret as percentage
sleepIntegerNo10Sleep duration (ms)
countIntegerNo1000Test iterations

Server stress testing.

Permission: hytale.system.command.stresstest.*

/stresstest start
/stresstest stop
SubcommandPermissionDescription
startstresstest.startStart stress test
stopstresstest.stopStop stress test

Entity repulsion debugging.

Permission: hytale.system.command.repulsion.*

/repulsion add entity
/repulsion add self
/repulsion remove entity
/repulsion remove self
SubcommandPermissionDescription
add entityrepulsion.add.entityAdd repulsion to targeted entity
add selfrepulsion.add.selfAdd repulsion to self
remove entityrepulsion.remove.entityRemove repulsion from targeted entity
remove selfrepulsion.remove.selfRemove repulsion from self

Hitbox collision debugging.

Permission: hytale.system.command.hitboxcollision.*

/hitboxcollision add entity
/hitboxcollision add self
/hitboxcollision remove entity
/hitboxcollision remove self
SubcommandPermissionDescription
add entityhitboxcollision.add.entityAdd collision to targeted entity
add selfhitboxcollision.add.selfAdd collision to self
remove entityhitboxcollision.remove.entityRemove collision from targeted entity
remove selfhitboxcollision.remove.selfRemove collision from self

HUD/UI testing.

Permission: hytale.system.command.hudtest

/hudtest

Opens a UI for testing HUD elements and displays.