# Commands list

### **1. Authentication**

These commands are used to link your server to the Hytale online services.

| **Command**           | **Description**                                                                               |
| --------------------- | --------------------------------------------------------------------------------------------- |
| `/auth login device`  | Starts the device authentication flow. Generates a code to enter on the Hytale website.       |
| `/auth login browser` | Starts a browser-based login. Note: Only works if the server has a graphical interface (GUI). |
| `/auth status`        | Checks if the server is currently authenticated and online.                                   |
| `/auth logout`        | Logs the server out and ends the active session.                                              |

### **2. Operator & Permissions**

Commands to manage server admins (Operators) and fine-grained permissions for users and groups.

| **Command**                              | **Description**                                                                 |
| ---------------------------------------- | ------------------------------------------------------------------------------- |
| `/op add <PlayerName>`                   | Grants full admin/operator rights to a player.                                  |
| `/op remove <PlayerName>`                | Revokes admin/operator rights from a player.                                    |
| `/perm user list <uuid>`                 | Displays all permissions currently assigned to a specific user (requires UUID). |
| `/perm user add <uuid> <node>`           | Adds a specific permission node (e.g., `world.edit`) to a user.                 |
| `/perm user remove <uuid> <node>`        | Removes a specific permission node from a user.                                 |
| `/perm user group list <uuid>`           | Shows which permission groups (ranks) a user belongs to.                        |
| `/perm user group add <uuid> <group>`    | Assigns a user to a specific permission group.                                  |
| `/perm user group remove <uuid> <group>` | Removes a user from a specific permission group.                                |
| `/perm group list <group>`               | Displays all permissions assigned to a specific group.                          |
| `/perm group add <group> <node>`         | Adds a permission node to a group.                                              |
| `/perm group remove <group> <node>`      | Removes a permission node from a group.                                         |

### **3. Whitelist Management**

Control who is allowed to join the server.

| **Command**                      | **Description**                                          |
| -------------------------------- | -------------------------------------------------------- |
| `/whitelist enable`              | Turns the whitelist ON. Only listed players can join.    |
| `/whitelist disable`             | Turns the whitelist OFF. Anyone can join.                |
| `/whitelist status`              | Checks if the whitelist is currently active or inactive. |
| `/whitelist add <playername>`    | Adds a player to the allowed list.                       |
| `/whitelist remove <playername>` | Removes a player from the allowed list.                  |
| `/whitelist list`                | Displays all players currently on the whitelist.         |
| `/whitelist clear`               | Removes all players from the whitelist instantly.        |

### **4. World Management**

Commands to create, load, and manage different worlds within the server.

| **Syntax**                 | **Description**                                                  |
| -------------------------- | ---------------------------------------------------------------- |
| `/world create <name>`     | Generates a new world file with the given name.                  |
| `/world load <name>`       | Loads an existing world into memory so players can join it.      |
| `/world unload <name>`     | Saves and closes a world (frees up RAM) without deleting it.     |
| `/world remove <name>`     | Permanently deletes a world and all its data.                    |
| `/world setdefault <name>` | Sets which world is loaded automatically when the server starts. |

### **5. Teleportation & Positioning**

Commands for moving players around the map.

| **Command**                | **Description**                                                    |
| -------------------------- | ------------------------------------------------------------------ |
| `/list`                    | Shows a list of all currently connected players.                   |
| `/tp <player> <target>`    | Teleports the specific `player` to the `target` player's location. |
| `/tp <player> <x> <y> <z>` | Teleports a player to exact X, Y, Z coordin                        |

### **6. Utility & Help**

General server information and assistance.

| **Syntax**        | **Description**                                                            |
| ----------------- | -------------------------------------------------------------------------- |
| `/help`           | Displays a list of all available commands.                                 |
| `/help <command>` | Displays detailed usage info for a specific command (e.g., `/help world`). |
| `/status`         | Shows current server performance, runtime, and status.                     |

{% hint style="success" %}
**Good to know:** Browse through amazing Hytale builds – hubs, spawns and lobbies, arenas, SkyBlock islands and much more <https://www.breadbuilds.com/hytale-builds>
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.breadbuilds.com/hytale-tutorials/commands-list.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.