Commands Reference
Every in-game /command and Discord !command that works on this server.
In-game commands
SimpleEssentials - general utilities
| Command | What it does |
|---|
/home | Teleport to your set home. /sethome to set it. |
/spawn | Return to the world spawn point. |
/tpa <player> | Request teleport to another player. They must accept. |
/tpaccept / /tpdeny | Respond to the most recent teleport request. |
/msg <player> <text> | Private whisper. |
/back | Return to your last position (typically after death). |
SimpleClaims - chunk protection
| Command | What it does |
|---|
/sc claim | Claim the chunk you're standing on for yourself or your party. |
/sc unclaim | Release the current chunk. |
/sc party create <name> | Make a party. Anyone added can build in your claims. |
/sc party invite <player> | Invite a player into your party. |
/sc info | Show who owns the current chunk. |
VeinMining
| Command | What it does |
|---|
| Hold Left Alt while mining | Vein-mine all connected blocks of the same type. |
/veinmining | Open your per-player config (toggle, max blocks, etc.). |
AutoQuickStack (SuperFriends original)
| Command | What it does |
|---|
/astack | Push matching items from your inventory out to nearby chests that already hold that type. Run with your inventory open. Respects SimpleClaims. |
WaybackCharm
| Action | What it does |
|---|
| Right-click the Wayback Charm | Teleports you to your set return point. Craft via the recipe shown in the in-game codex. |
Discord bot commands
Post in #hytail-llm. Prefix with ! to ask Hytail LLM a question, or use one of the commands below.
Everyone
| Command | What it does |
|---|
!<anything> | Ask the AI game-guide. Searches the RAG corpus, installed mod files, and (if the local model can't answer) the web or Gemini Flash. |
!broken | Report a broken mod feature during the recovery window after an incident. |
!correct <text> | Correct the bot's last answer. Goes into a review queue for admins. |
!forget | Tell the bot to forget your conversation history for this session. |
Teach the bot (community RAG learning)
When the local model falls back to Gemini Flash for an answer, the bot will ask "Did that help?". If you reply with one of these within 5 minutes, the Q&A gets saved into the local RAG corpus so the next person who asks the same thing gets an instant answer without hitting the cloud.
| Command | What it does |
|---|
!y | Confirm the last Gemini answer was correct. Saves the Q&A into the community RAG file and triggers re-ingest. If more than one Gemini answer is pending, the bot will list them and ask you to pick. |
!n | The answer didn't help - discard all pending answers for you. |
!1, !2, ... !N | When multiple answers are pending (more than one !-question in the last 5 minutes), pick a specific one to save. |
!all | Save every pending Gemini answer in the last 5 minutes. |
Admin only - quick fixes
| Command | What it does |
|---|
!fix <key> <value> | Inject a pinned fact into the RAG corpus. |
!reloadrag | Reload the RAG corpus from disk. |
!quiet | Silence the bot for 10 minutes. |
!lastq | Show the last few user questions. |
Admin only - direct file editing
Mechanical file ops against the bot and website trees (/opt/hytale-server/bot/, /opt/hytale-server/web/, /opt/hytale-server/backups/). Every edit creates a timestamped .bak-* next to the file. LanceDB, .git, and __pycache__ paths are blocked.
| Command | What it does |
|---|
!view <path> [start-end] | Show a file (or a line range). Example: !view /opt/hytale-server/web/rules.html 20-40 |
!list <dir> | List a directory inside the allowed roots. |
!edit <path> <old> ==> <new> | Replace the first occurrence of old with new in the file. Creates a backup. |
!edit-all <path> <old> ==> <new> | Replace every occurrence of old with new. Creates a backup. |
!append <path> <text> | Append a single line of text to a file. |
!linedel <path> <start-end> | Delete a range of lines (inclusive). Creates a backup. |
!reload | Restart the hytale-bot service (uses scoped sudo NOPASSWD). |
!ragreingest | Re-ingest the entire RAG corpus in the background. |
Admin only - let the LLM plan the edit
For when you want to describe a fix in plain English and let Gemini Flash translate it into a concrete sequence of file ops. The plan is shown to you as a preview and not executed until you confirm.
| Command | What it does |
|---|
!aifix <request in plain English> | Ask the bot to propose a list of file-op commands. Example: !aifix PvP is off by default - update the rules page to say so. The bot replies with a numbered plan and waits for !confirm. |
!confirm | Execute the most recent !aifix plan (valid for 10 minutes). |
!abort | Discard the pending plan without running it. |
Audit trail: every admin edit is logged to /opt/hytale-server/bot/admin_ops.log with the user, command, and timestamp. Every file change leaves a .bak-<name>.<nanosecond-ts> backup next to the original.
Missing a command? The bot itself is the best reference - ask !what commands does <mod> have and it will check the mod's manifest and sidecar docs in real time.