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

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 LuckPerms is 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

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 LuckPerms no 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.