Commands and Permissions

Commands & Permissions 📜

This page lists all the commands, aliases, and permission nodes associated with the Sculk Companion plugin.

---

💬 Commands

The plugin features a main command group (/sculk) and a direct-question alias command (/ask).

Command	Alias	Permission	Description
/sculk ask <question>	/ask <question>	sculk.use	Ask Sculk a direct question.
/sculk toggle	/sculk chat	sculk.use	Toggles Chat Mode. When active, all your chat messages are sent to Sculk without needing the keyword.
/sculk reload	None	sculk.admin	Reloads config.yml and lore.txt from disk.

---

🔑 Permissions

Permissions allow you to control which players can chat with Sculk and limit what administrative powers the AI has over specific users.

User Permissions

• sculk.use (Default: true)
  • Description: Allows players to run /sculk ask, /ask, toggle chat mode, and query Sculk by mentioning its name in public chat.

Administrative Permissions

• sculk.admin (Default: op)
  • Description: Allows players to reload the configurations (/sculk reload).

AI Sudo Permissions

These permissions gate high-level actions. When the AI attempts to execute a tool on a player, the target player must have the matching permission, or the AI will receive an authorization failure.

• sculk.sudo (Default: op)
  • Description: Allows the AI to use the kick_player tool on this player.
• sculk.sudo.teleport (Default: op)
  • Description: Allows the AI to use the teleport_player tool (teleporting this player to another target).
• sculk.sudo.monitor (Default: op)
  • Description: Allows the AI to query server status metrics (get_server_status) on behalf of this player.
• sculk.sudo.broadcast (Default: op)
  • Description: Allows the AI to broadcast announcements (broadcast_announcement) on behalf of this player.