Commands Configuration

Commands Configuration

File: commands/categories.json

This file controls how server commands are displayed and categorized in the Info Hub.

Complete Example

{
  "settings": {
    "groupBy": "auto",
    "showAliases": true,
    "showPermissions": false,
    "itemsPerPage": 6,
    "showDefaultCommands": true,
    "showModCommandsOnly": false,
    "hiddenCommands": [],
    "hiddenPrefixes": [],
    "allowedPlugins": [],
    "blockedPlugins": []
  },
  "execution": {
    "enabled": false,
    "requireConfirmation": true,
    "allowedCommands": [],
    "blockedCommands": ["ban", "kick", "mute", "op", "deop", "stop", "restart"],
    "parameterInputEnabled": true
  },
  "uncategorized": {
    "name": "Other",
    "icon": "Deco_Chest",
    "color": "#797b7c"
  },
  "pluginMappings": {},
  "categories": [
    {
      "id": "general",
      "name": "General",
      "description": "Basic server commands",
      "icon": "Deco_Book",
      "permission": null,
      "priority": 1,
      "color": "#b4c8c9",
      "plugins": [],
      "commands": ["help", "info", "spawn", "rules"]
    }
  ],
  "customCommands": []
}

---

Settings

Display Settings

Setting	Type	Default	Description
groupBy	String	"auto"	How to group commands (see below)
showAliases	Boolean	true	Show command aliases
showPermissions	Boolean	false	Show permission nodes
itemsPerPage	Integer	6	Commands per page
showDefaultCommands	Boolean	true	Show Hytale default commands
showModCommandsOnly	Boolean	false	Only show mod/plugin commands
hiddenCommands	Array	[]	Commands to always hide
hiddenPrefixes	Array	[]	Hide commands starting with these prefixes (e.g., "hytale:", "debug:")
allowedPlugins	Array	[]	Only show commands from these plugins (empty = all)
blockedPlugins	Array	[]	Hide commands from these plugins

Grouping Options (groupBy)

Value	Description
"plugin"	Recommended! Automatic categories per plugin
"category"	Only use manually defined categories
"auto"	Automatic assignment based on command names
"none"	No categorization, single list

---

Command Execution

Setting	Type	Default	Description
execution.enabled	Boolean	false	Allow executing commands from UI
execution.requireConfirmation	Boolean	true	Require confirmation before execution
execution.allowedCommands	Array	[]	Only allow these commands (empty = all except blocked)
execution.blockedCommands	Array	["ban", "kick", "mute", "op", "deop", "stop", "restart"]	Never allow these commands
execution.parameterInputEnabled	Boolean	true	Allow parameter input in UI

:::caution Disabled by Default Command execution is disabled by default for security. Enable it only if you want players to be able to run commands directly from the Info Hub UI. When enabled, confirmation is required by default. :::

Security Recommendation

Always block dangerous commands:

"execution": {
  "enabled": true,
  "requireConfirmation": true,
  "blockedCommands": ["op", "deop", "stop", "restart", "ban", "kick", "mute"]
}

---

Categories

Category Definition

{
  "id": "teleport",
  "name": "Teleportation",
  "description": "Movement and teleport commands",
  "icon": "Consumable_Pearl",
  "permission": null,
  "priority": 2,
  "color": "#7a9cc6",
  "plugins": ["personal-warps"],
  "commands": ["tp", "tpa", "home", "sethome", "warp"]
}

Field	Type	Description
id	String	Unique category ID
name	String	Display name
description	String	Description text
icon	String	Item ID for icon
permission	String	Permission to view (null = everyone)
priority	Integer	Sort order (lower = higher)
color	String	Hex color code
plugins	Array	Auto-assign all commands from these plugins
commands	Array	Manually assign specific commands

Admin Category Example

{
  "id": "admin",
  "name": "Administration",
  "description": "Admin only",
  "icon": "Deco_CommandBlock",
  "permission": "infohub.admin",
  "priority": 10,
  "color": "#e94560",
  "plugins": [],
  "commands": ["ban", "kick", "mute", "gamemode"]
}

---

Plugin Mappings

Assign all commands from a plugin to a specific category:

"pluginMappings": {
  "Achievement-System": "achievements",
  "RPG-Leveling": "leveling",
  "Economy": "economy"
}

The key is the plugin name, the value is the category ID.

---

Custom Commands

For commands that aren’t automatically detected:

"customCommands": [
  {
    "name": "daily",
    "description": "Claim daily reward",
    "usage": "/daily",
    "aliases": ["reward"],
    "permission": null,
    "category": "gameplay",
    "plugin": "DailyRewards",
    "executable": true
  }
]

Field	Type	Description
name	String	Command name (without /)
description	String	Command description
usage	String	Usage syntax
aliases	Array	Command aliases
permission	String	Required permission
category	String	Category ID to assign to
plugin	String	Plugin name to display
executable	Boolean	Allow execution from UI

---

Examples

Hide Specific Commands

"settings": {
  "hiddenCommands": ["debug", "test", "internal"]
}

Only Show Specific Plugins

"settings": {
  "allowedPlugins": ["Achievement-System", "Economy", "Teleport"]
}

Block Certain Plugins

"settings": {
  "blockedPlugins": ["AdminTools", "Debug"]
}

Uncategorized Commands Style

"uncategorized": {
  "name": "Miscellaneous",
  "icon": "Deco_Chest",
  "color": "#888888"
}