AquaCommands - Custom Commands System

AquaCommands - Custom Commands System for Hytale

Take control of your Hytale server chat with AquaCommands. This mod allows admins to easily create, edit, and manage custom chat commands directly in-game using a user-friendly interface, without ever touching a config file manually.

Whether you need shortcut commands for players, information displays, or social media links, AquaCommands makes Hytale server management simple and efficient.

✅ Now fully compatible with LuckPerms for Hytale!

🌊 Key Features

• In-Game GUI Editor: Forget manual configs. Create, edit, and delete custom commands visually using the /aquacmd interface.
• Instant Hot Reload: Apply changes instantly without needing to restart your Hytale server using the /aquareload command.
• LuckPerms Integration: Seamless permission management with full support for LuckPerms contexts and groups.
• Smart Links: URLs in command responses automatically become clickable for players.
• Safe Persistent Storage: All your custom commands are saved securely in commands.json.

🚀 Installation Guide

1. Download the latest AquaCommands-x.x.x.jar.
2. Place the jar file into your Hytale server's mods/ folder.
3. Restart the server.
4. (Highly Recommended) Install LuckPerms-Hytale for advanced permission management.

📋 Admin Commands & Permissions

Command	Description	Permission Node
/aquacmd	Open the Creator GUI to manage commands	aquacommands.manage
/aqualist	View a list of all active custom commands	aquacommands.manage
/aquacmdremove	Delete an existing command	aquacommands.manage
/aquareload	Hot reload configuration from disk	aquacommands.reload

Custom Command Permissions (LuckPerms)

When you create a new custom command (e.g., /discord), AquaCommands automatically generates a permission node following this simple format:

aquacommands.<command_name>

Examples:

• To allow a player to use /discord: aquacommands.discord
• To allow a player to use /rules: aquacommands.rules
• Admin Access: To allow access to ALL custom commands (e.g., for admins or VIPs), use the wildcard: aquacommands.*

Note: If LuckPermsis not installed, all players can use custom commands by default, but only OPs can manage/create them.

🎮 How to Use

1. Create a Command: Type /aquacmd. Enter the desired command name (e.g., vote) and the message/response. Click Create.
2. List Commands: Type /aqualist to see what's available.
3. Delete a Command: Type /aquacmdremove and select the command to delete.

📝 Configuration File (Advanced)

Commands are stored in mods/AquaCommands/commands.json. You can edit this file manually if preferred:

{
  "discord": "Join our community: discord.gg/example",
  "map": "View the world map at: map.example.com"
}

Run /aquareload after manual edits to apply changes.

---

---

AquaCommands - Sistema de Comandos Personalizados para Hytale

Toma el control del chat de tu servidor de Hytale con AquaCommands. Este mod permite a los administradores crear, editar y gestionar fácilmente comandos de chat personalizados directamente dentro del juego usando una interfaz amigable, sin necesidad de editar archivos de configuración manualmente.

Ya sea que necesites atajos para jugadores, pantallas de información o enlaces a redes sociales, AquaCommands simplifica la gestión de servidores de Hytale.

✅ ¡Ahora totalmente compatible con LuckPerms para Hytale!

🌊 Características Principales

• Editor GUI en el juego: Olvídate de las configuraciones manuales. Crea, edita y elimina comandos personalizados visualmente usando la interfaz /aquacmd.
• Recarga Rápida (Hot Reload): Aplica los cambios al instante sin necesidad de reiniciar tu servidor de Hytale usando el comando /aquareload.
• Integración con LuckPerms: Gestión de permisos fluida con soporte completo para contextos y grupos de LuckPerms.
• Enlaces Inteligentes (Smart Links): Las URLs en las respuestas de los comandos se vuelven automáticamente clicables para los jugadores.
• Almacenamiento Persistente: Todos tus comandos personalizados se guardan de forma segura en commands.json.

🚀 Guía de Instalación

1. Descarga el último archivo AquaCommands-x.x.x.jar.
2. Colócalo en la carpeta mods/ de tu servidor de Hytale.
3. Reinicia el servidor.
4. (Altamente Recomendado) Instala LuckPerms-Hytale para una gestión avanzada de permisos.

📋 Comandos de Administrador y Permisos

Comando	Descripción	Nodo de Permiso
/aquacmd	Abre la GUI del Creador para añadir/editar comandos	aquacommands.manage
/aqualist	Ver una lista de todos los comandos personalizados	aquacommands.manage
/aquacmdremove	Eliminar un comando existente	aquacommands.manage
/aquareload	Recarga rápida de la configuración desde el disco	aquacommands.reload

Permisos de Comandos Personalizados (LuckPerms)

Cuando creas un nuevo comando personalizado (ej., /discord), AquaCommands genera automáticamente un nodo de permiso siguiendo este formato simple:

aquacommands.<nombre_del_comando>

Ejemplos:

• Permitir a un jugador usar /discord: aquacommands.discord
• Permitir a un jugador usar /reglas: aquacommands.rules
• Acceso de Admin: Para dar acceso a TODOS los comandos personalizados (ej., para admins o VIPs), usa el comodín: aquacommands.*

Nota: Si LuckPermsno está instalado, todos los jugadores pueden usar los comandos personalizados por defecto, pero solo los OPs pueden gestionarlos/crearlos.

🎮 Cómo Usar

1. Crear un Comando: Escribe /aquacmd. Introduce el nombre deseado (ej., votar) y el mensaje de respuesta. Haz clic en Crear.
2. Listar Comandos: Escribe /aqualist para ver qué hay disponible.
3. Eliminar un Comando: Escribe /aquacmdremove y selecciona el comando a borrar.

📝 Archivo de Configuración (Avanzado)

Los comandos se almacenan en mods/AquaCommands/commands.json. Puedes editar este archivo manualmente si lo prefieres:

{
  "discord": "Únete a nuestra comunidad: discord.gg/ejemplo",
  "mapa": "Mira el mapa del mundo en: mapa.ejemplo.com"
}

Ejecuta /aquareload después de realizar ediciones manuales para aplicar los cambios.