Built-in Commands List
Complete reference for all built-in server commands, organized by source plugin.
Plugins
Section titled “Plugins”| Directory | Description | Namespace |
|---|---|---|
| system/ | Core server commands (always available) | hytale.system.command.* |
| teleport/ | Teleportation and warps | hytale.command.* |
| npc/ | NPC spawning and AI | hytale.command.npc.* |
| world/ | World, time, weather, chunks, blocks | hytale.command.* |
| spawning/ | NPC spawning system | hytale.command.spawning.* |
| buildertools/ | Building and editing tools | hytale.editor.* |
Each directory contains a README.md with an overview and quick reference for its commands.
Architecture
Section titled “Architecture”Hytale uses a modular plugin architecture. Even “vanilla” Hytale consists of:
Core Server (System Commands)
- Registered directly to
CommandManagerduring server bootstrap - Essential infrastructure that exists before plugins load
- Cannot be disabled - required for server operation
- Uses
hytale.system.command.*permission namespace
Internal Plugins (Plugin Commands)
- Ship with Hytale but are still technically plugins
- Can be enabled/disabled via
/plugincommand - Replaceable by custom plugins with same functionality
- Use
hytale.command.*orhytale.editor.*namespaces
This design allows server operators to:
- Disable features by unloading plugins
- Replace built-in functionality with custom implementations
- Keep servers lean by only loading needed features
Syntax Legend
Section titled “Syntax Legend”| Format | Meaning |
|---|---|
<arg> | Required argument |
[arg] | Optional argument |
[--arg=default] | Optional with default value |
[--flag] | Boolean flag |
See Command Syntax for the full parsing reference — quoting, escape characters, relative coordinates, lists, and argument abbreviation.
Permission System
Section titled “Permission System”Permission Namespaces
Section titled “Permission Namespaces”| Namespace | Format | Source |
|---|---|---|
| System | hytale.system.command.<cmd> | Core server (always available) |
| Plugin | hytale.command.<cmd> | Internal plugins (can be disabled) |
| Editor | hytale.editor.<feature> | BuilderToolsPlugin |
Permission Groups
Section titled “Permission Groups”| Group | Description |
|---|---|
| Adventure | Basic player commands (available to all players) |
| Creative | Building/editing commands (auto-granted in Creative mode) |
Self/Other Pattern
Section titled “Self/Other Pattern”Many commands have .self and .other variants:
.self- Execute on yourself.other- Execute on other players
Quick Reference
Section titled “Quick Reference”Core Server Commands
Section titled “Core Server Commands”Always available - cannot be disabled
Namespace: hytale.system.command.*
Server Control
Section titled “Server Control”| Command | Usage | Description | Permission |
|---|---|---|---|
/stop | /stop [--crash] | Shutdown server | stop |
/kick | /kick <player> | Kick player | kick |
/maxplayers | /maxplayers <count> | Set max players | maxplayers |
/backup | /backup | Create backup | backup |
/version | /version | Show version | version |
/notify | /notify <message> | Send notification | notify |
/sudo | /sudo <player> <command...> | Run command as player | sudo |
/who | /who | List online players | who |
/hide | /hide <player> [--target=?] | Hide players | hide.* |
/auth | /auth <status|login|logout> | Authentication | auth.* |
Access Control
Section titled “Access Control”| Command | Usage | Description | Permission |
|---|---|---|---|
/ban | /ban <player> [reason...] | Ban player | ban |
/unban | /unban <player> | Unban player | unban |
/whitelist | /whitelist <enable|disable|add|remove|list|status|clear> | Whitelist management | whitelist.* |
/op add | /op add <player> | Grant operator | op.add |
/op remove | /op remove <player> | Remove operator | op.remove |
/op self | /op self | Self-op (password) | (special) |
/perm | /perm <get|set|unset|list> | Permission management | perm.* |
Player Management
Section titled “Player Management”| Command | Usage | Description | Permission |
|---|---|---|---|
/gamemode | /gamemode <mode> [player] | Change game mode | gamemode.self/other |
/kill | /kill [player] | Kill player | kill.self/other |
/damage | /damage [player] [--amount=1.0] | Deal damage | damage.self/other |
/give | /give <item> [--quantity=1] [player] | Give items | give.self/other |
/give armor | /give armor <armorSet> | Give armor set | give.self/other |
/inventory | /inventory <clear|see|item|backpack> | Inventory management | inventory.* |
/player stats | /player stats <get|set|add|reset|dump|settomax> | Player statistics | player.stats.* |
/player effect | /player effect apply <effect> [--duration=100] | Apply effects | player.effect.* |
/player camera | /player camera <reset|topdown|sidescroller|demo> | Camera controls | player.camera.* |
/whoami | /whoami [player] | Show player info | whoami.self/other |
/whereami | /whereami [player] | Show location | whereami.self/other |
/ping | /ping [--detail] | Check ping | (Adventure) |
/hotbar | /hotbar <slot> [--save] | Hotbar management | (Creative) |
Entity Management
Section titled “Entity Management”| Command | Usage | Description | Permission |
|---|---|---|---|
/entity remove | /entity remove [--entity=?] [--others] | Remove entities | entity.remove |
/entity clone | /entity clone [--entity=?] [--count=?] | Clone entity | entity.clone |
/entity dump | /entity dump [--entity=?] | Dump entity data | entity.dump |
/entity stats | /entity stats <get|set|add|reset|dump> | Entity stats | entity.stats.* |
/entity effect | /entity effect <effect> [--duration=?] | Entity effects | entity.effect |
Debug & Diagnostics
Section titled “Debug & Diagnostics”| Command | Usage | Description | Permission |
|---|---|---|---|
/debug shape | /debug shape <clear|sphere|cube|arrow> | Debug shapes | debug.* |
/hitbox | /hitbox | Hitbox debug | hitbox |
/log | /log | Logging controls | log |
/network | /network | Network diagnostics | network |
TeleportPlugin
Section titled “TeleportPlugin”Teleportation and location management - can be disabled/replaced
Namespace: hytale.command.*
| Command | Usage | Description | Permission |
|---|---|---|---|
/tp | /tp <x> <y> <z> [--yaw=?] [--pitch=?] | Teleport to coords | teleport.self |
/tp | /tp <player> | Teleport to player | teleport.self |
/tp | /tp <player> <x> <y> <z> | Teleport player to coords | teleport.other |
/tp all | /tp all <x> <y> <z> | Teleport all players | teleport.all |
/tp home | /tp home | Teleport to home | teleport.home |
/tp top | /tp top | Teleport to surface | teleport.top |
/tp back | /tp back [count] | Undo teleport | teleport.back |
/tp forward | /tp forward [count] | Redo teleport | teleport.forward |
/tp history | /tp history | View teleport history | teleport.history |
/tp world | /tp world <world> | Teleport to world | teleport.world |
/spawn | /spawn [--spawnIndex=?] | Teleport to spawn | spawn.self |
/spawn set | /spawn set | Set spawn point | spawn.set |
/spawn default | /spawn default | Reset to default spawn | spawn.default |
/warp go | /warp go <name> | Teleport to warp | warp.go |
/warp set | /warp set <name> | Create warp | warp.set |
/warp remove | /warp remove <name> | Delete warp | warp.remove |
/warp list | /warp list | List warps | warp.list |
NPCPlugin
Section titled “NPCPlugin”NPC spawning and AI management - can be disabled/replaced
Namespace: hytale.command.npc.*
| Command | Usage | Description | Permission |
|---|---|---|---|
/npc spawn | /npc spawn <role> [--count=1] [--radius=8] | Spawn NPC | npc.spawn |
/npc all | /npc all [--distance=4.0] | Spawn all roles | npc.all |
/npc clean | /npc clean | Remove all NPCs | npc.clean |
/npc freeze | /npc freeze | Freeze all NPCs | npc.freeze |
/npc thaw | /npc thaw | Unfreeze all NPCs | npc.thaw |
/npc dump | /npc dump [--entity=?] [--json] | Dump NPC data | npc.dump |
/npc appearance | /npc appearance <model> [--entity=?] | Appearance settings | npc.appearance |
/npc attack | /npc attack [attack...] [--entity=?] | Attack overrides | npc.attack |
/npc blackboard | /npc blackboard <subcommand> | AI state data | npc.blackboard |
/npc flock | /npc flock <leave|grab|join|playerleave> | Flocking (view cone) | npc.flock.* |
/npc path | /npc path <instructions> or polygon <sides> | Set path | npc.path |
/npc role | /npc role [role] [--entity=?] | Get/set role | npc.role |
/npc give | /npc give <item> or nothing | Give/clear item | npc.give |
/npc message | /npc message <message> [--expiration=?] [--all] | Send message | npc.message |
/npc debug | /npc debug <show|set|toggle|defaults|clear|presets> | Debug flags | npc.debug |
/npc step | /npc step [--entity=?] [--all] [--dt=?] | Step behavior | npc.step |
/npc benchmark | /npc benchmark [--roles] [--sensorsupport] | NPC benchmarking | npc.benchmark |
WorldPlugin
Section titled “WorldPlugin”World, time, weather, and block management - can be disabled/replaced
Namespace: hytale.command.*
| Command | Usage | Description | Permission |
|---|---|---|---|
/world list | /world list | List worlds | world.list |
/world add | /world add <name> [options...] | Create world | world.add |
/world remove | /world remove <name> | Delete world | world.remove |
/world load | /world load <name> | Load world | world.load |
/world save | /world save [name] | Save world | world.save |
/world settings | /world settings <setting> [set <value>|reset] | World settings | world.settings |
/time | /time | Show current time | time |
/time set | /time set <hours> | Set time (0-24) | time.set |
/time dawn | /time dawn | Set to dawn | time.dawn |
/time pause | /time pause | Freeze time | time.pause |
/time dilation | /time dilation <multiplier> | Set time speed | time.dilation |
/weather get | /weather get | Show weather | weather.get |
/weather set | /weather set <weather> | Set weather | weather.set |
/chunk info | /chunk info | Current chunk info | chunk.info |
/chunk regenerate | /chunk regenerate | Regenerate chunk | chunk.regenerate |
/lighting | /lighting <get|info|invalidate> | Lighting management | lighting.* |
/block set | /block set <block> [position] | Set block | block.set |
/block get | /block get [position] | Get block info | block.get |
SpawningPlugin
Section titled “SpawningPlugin”NPC spawning system - can be disabled/replaced
Namespace: hytale.command.*
| Command | Usage | Description | Permission |
|---|---|---|---|
/spawning enable | /spawning enable | Enable NPC spawning | spawning.enable |
/spawning disable | /spawning disable | Disable NPC spawning | spawning.disable |
/spawning populate | /spawning populate | Force spawn population | spawning.populate |
/spawning beacons | /spawning beacons | Spawn beacon info | spawning.beacons |
/spawning stats | /spawning stats | Spawning statistics | spawning.stats |
BuilderToolsPlugin
Section titled “BuilderToolsPlugin”Building, selection, and world editing - can be disabled/replaced
Namespace: hytale.editor.*
Selection
Section titled “Selection”| Command | Usage | Description | Permission |
|---|---|---|---|
/pos1 | /pos1 [x y z] | Set corner 1 | selection.use |
/pos2 | /pos2 [x y z] | Set corner 2 | selection.use |
/deselect | /deselect | Clear selection | (Creative) |
/expand | /expand <amount> [direction] | Expand selection | selection.use |
/contract | /contract <amount> [direction] | Contract selection | selection.use |
Fill & Replace
Section titled “Fill & Replace”| Command | Usage | Description | Permission |
|---|---|---|---|
/setBlocks | /setBlocks <pattern> (alias: set) | Fill with block | (Creative) |
/fillBlocks | /fillBlocks <pattern> (alias: fill) | Fill with pattern | (Creative) |
/replace | /replace [from] <to> | Replace blocks | selection.modify |
/clearBlocks | /clearBlocks (alias: clear) | Clear blocks | (Creative) |
/gmask | /gmask <mask> (alias: globalmask) | Edit mask | (Creative) |
/tint | /tint <color> | Tint blocks | selection.modify |
Clipboard
Section titled “Clipboard”| Command | Usage | Description | Permission |
|---|---|---|---|
/copy | /copy | Copy to clipboard | selection.clipboard |
/cut | /cut | Cut to clipboard | selection.clipboard |
/paste | /paste | Paste clipboard | selection.clipboard |
/undo | /undo [count] | Undo edit | history |
/redo | /redo [count] | Redo edit | history |
Transformation
Section titled “Transformation”| Command | Usage | Description | Permission |
|---|---|---|---|
/move | /move <direction> <amount> | Move contents | (Creative) |
/stack | /stack <count> [direction] | Stack selection | (Creative) |
/rotate | /rotate <degrees> | Rotate | (Creative) |
/flip | /flip <axis> | Flip | (Creative) |
/hollow | /hollow [block] [thickness] | Make hollow | (Creative) |
/wall | /wall [thickness] (aliases: walls, sides) | Create walls | (Creative) |
Prefabs
Section titled “Prefabs”| Command | Usage | Description | Permission |
|---|---|---|---|
/prefab | /prefab | Prefab browser | prefab.use |
/editprefab | /editprefab <select|load|save|...> | Prefab editor | prefab.* |
/path | /path <new|list|add|edit|...> (alias: prefabpath) | Prefab paths | (Creative) |
| Command | Usage | Description | Permission |
|---|---|---|---|
/scriptedbrushes | /scriptedbrushes <load|list|clear> (aliases: sb) | Brush config | brush.config |
Editor Permissions
Section titled “Editor Permissions”Non-command permissions for editor functionality (all prefixed with hytale.):
| Permission | Description |
|---|---|
editor.asset | Asset editor access |
editor.packs.create | Create asset packs |
editor.packs.edit | Edit asset packs |
editor.packs.delete | Delete asset packs |
editor.builderTools | Builder tools (auto-granted in Creative) |
editor.brush.use | Use brushes |
editor.brush.config | Configure brushes |
editor.prefab.use | Use prefabs |
editor.prefab.manage | Manage prefabs |
editor.selection.use | Use selection tools |
editor.selection.clipboard | Clipboard operations |
editor.selection.modify | Modify selections |
editor.history | Undo/redo history |
camera.flycam | Fly camera mode |