# Commands Reference

# Commands Reference

Complete reference of all Hytale server commands available through the panel console.

## Player Commands

### Basic Player Management

| Command | Description | Usage |
|---------|-------------|-------|
| `/kick` | Kick a player | `/kick <player> [reason]` |
| `/ban` | Ban a player | `/ban <player> [reason]` |
| `/unban` | Unban a player | `/unban <player>` |
| `/mute` | Mute a player | `/mute <player>` |
| `/unmute` | Unmute a player | `/unmute <player>` |
| `/pardon` | Unban (alias) | `/pardon <player>` |

### Teleportation

| Command | Description | Usage |
|---------|-------------|-------|
| `/tp` | Teleport player | `/tp <player> <target>` |
| `/tp` | Teleport to coords | `/tp <player> <x> <y> <z>` |
| `/spawn` | Teleport to spawn | `/spawn [player]` |
| `/setspawn` | Set spawn point | `/setspawn` |
| `/home` | Teleport home | `/home [player]` |
| `/warp` | Teleport to warp | `/warp <name>` |

### Player State

| Command | Description | Usage |
|---------|-------------|-------|
| `/gamemode` | Change gamemode | `/gamemode <mode> [player]` |
| `/heal` | Heal a player | `/heal [player]` |
| `/kill` | Kill a player | `/kill [player]` |
| `/effect` | Apply effect | `/effect <player> <effect> [duration]` |

### Inventory

| Command | Description | Usage |
|---------|-------------|-------|
| `/give` | Give items | `/give <player> <item> [amount]` |
| `/clear` | Clear inventory | `/clear [player]` |

## Administration Commands

### Server Control

| Command | Description | Usage |
|---------|-------------|-------|
| `/stop` | Stop the server | `/stop` |
| `/save-all` | Save all worlds | `/save-all` |
| `/save` | Save current world | `/save` |
| `/save-on` | Enable auto-save | `/save-on` |
| `/save-off` | Disable auto-save | `/save-off` |

:::tip
To restart the server, use the Panel interface or stop and start via Docker.
:::

### Operator Management

| Command | Description | Usage |
|---------|-------------|-------|
| `/op` | Grant operator | `/op <player>` |
| `/deop` | Remove operator | `/deop <player>` |

### Whitelist

| Command | Description | Usage |
|---------|-------------|-------|
| `/whitelist add` | Add to whitelist | `/whitelist add <player>` |
| `/whitelist remove` | Remove from whitelist | `/whitelist remove <player>` |
| `/whitelist list` | Show whitelist | `/whitelist list` |
| `/whitelist on` | Enable whitelist | `/whitelist on` |
| `/whitelist off` | Disable whitelist | `/whitelist off` |

### Broadcasting

| Command | Description | Usage |
|---------|-------------|-------|
| `/say` | Server message | `/say <message>` |
| `/broadcast` | Broadcast message | `/broadcast <message>` |
| `/title` | Show title | `/title <player> <text>` |

## World Commands

### Time

| Command | Description | Usage |
|---------|-------------|-------|
| `/time set` | Set time | `/time set <day\|night\|noon\|value>` |
| `/time add` | Add time | `/time add <value>` |
| `/time query` | Query time | `/time query <daytime\|gametime\|day>` |

### Weather

| Command | Description | Usage |
|---------|-------------|-------|
| `/weather` | Set weather | `/weather <clear\|rain\|thunder>` |

### World Management

| Command | Description | Usage |
|---------|-------------|-------|
| `/seed` | Show world seed | `/seed` |
| `/setworldspawn` | Set spawn point | `/setworldspawn [x] [y] [z]` |

## Game Mechanics

### Difficulty

| Command | Description | Usage |
|---------|-------------|-------|
| `/difficulty` | Set difficulty | `/difficulty <peaceful\|easy\|normal\|hard>` |

### Gamerules

| Command | Description | Usage |
|---------|-------------|-------|
| `/gamerule` | Set gamerule | `/gamerule <rule> [value]` |

Common gamerules:
- `doDaylightCycle` - Day/night cycle
- `doMobSpawning` - Mob spawning
- `keepInventory` - Keep items on death
- `mobGriefing` - Mob world damage
- `pvp` - Player vs Player

## Debug Commands

### Information

| Command | Description | Usage |
|---------|-------------|-------|
| `/list` | List online players | `/list` |
| `/tps` | Show TPS | `/tps` |
| `/memory` | Show memory usage | `/memory` |

### Debug

| Command | Description | Usage |
|---------|-------------|-------|
| `/debug start` | Start profiling | `/debug start` |
| `/debug stop` | Stop profiling | `/debug stop` |

## Update Commands

Native Hytale update system (v24.01.2026+):

| Command | Description | Usage |
|---------|-------------|-------|
| `/update status` | Check update status | `/update status` |
| `/update check` | Check for updates | `/update check` |
| `/update download` | Download update | `/update download` |
| `/update apply` | Apply update | `/update apply` |

## Authentication Commands

| Command | Description | Usage |
|---------|-------------|-------|
| `/auth login device` | Start OAuth login | `/auth login device` |
| `/auth status` | Show auth status | `/auth status` |
| `/auth logout` | Log out | `/auth logout` |

## Permission Requirements

Most commands require operator status or specific permissions:

| Permission Level | Commands |
|-----------------|----------|
| **All Players** | Basic chat |
| **Moderator** | Kick, mute, teleport |
| **Operator** | Ban, gamemode, give |
| **Admin** | Stop, restart, op/deop |

## Quick Reference

### Most Used Commands

```bash
# Kick a griefer
/kick PlayerName Griefing is not allowed

# Give diamond sword
/give PlayerName diamond_sword 1

# Teleport player to you
/tphere PlayerName

# Set time to day
/time set day

# Save the server
/save-all

# Emergency broadcast
/say [!] Server restarting in 5 minutes!
```

### Gamemode Shortcuts

```bash
/gamemode creative    # or /gmc
/gamemode adventure   # or /gma
```

:::note
Hytale only supports **Creative** and **Adventure** gamemodes.
:::