AquaDrop: The Definitive Drop Management API for Hytale

AquaDrop is the ultimate API for managing drops from mobs and blocks. Whether you are a server administrator, a beginner modder familiarizing yourself with Hytale's Asset Editor, or an advanced developer, AquaDrop provides the tools you need to customize loot seamlessly—no coding required.

Currently in active development, this utility API was built from the ground up to eliminate mod conflicts and empower creators to add custom drops without the headache of overriding vanilla or modded loot tables.

⬇️ Jump directly to How to Use & Configuration

🚀 Who is it for?

🛠️ Server Admins & Asset Editor Users: No coding skills? No problem. Easily configure exactly what items drop from specific mobs or blocks. Perfect for adding custom items to your server or fixing drop rates.
👨‍💻 Advanced Modders: A reliable utility API that handles the heavy lifting of drop calculation. Ensure your mod's drops play nicely with everything else installed on the server.

✨ Core Features & Advantages

➕ Additive Drops (No Overrides): AquaDrop works alongside existing loot. The drops you configure are additional to what the entity or block already drops. No more breaking vanilla mechanics or overriding other mods!
⚡ Real-Time Layer Calculation (Works on Existing Worlds): The API operates directly on the game's layer, calculating drops in real-time. You don't need to wipe your server or start over; AquaDrop works flawlessly on already generated worlds and seamlessly integrates with entities that already have predefined drops.
🎯 Ultimate Compatibility: Add highly exclusive drops to almost anything. Want a custom item to drop from a specific boss from another mod? AquaDrop makes it happen without conflicts.

⬇️ Jump directly to How to Use & Configuration

AquaDrop: La API Definitiva para la Gestión de Drops en Hytale

AquaDrop es la API definitiva para la gestión de drops, ya sea en mobs o en bloques. Si eres administrador de un servidor, un modder que apenas empieza usando el Asset Editor de Hytale, o un desarrollador avanzado, esta herramienta está diseñada para facilitarte la vida sin necesidad de programar.

Actualmente en desarrollo, esta utilidad busca eliminar de forma sencilla los conflictos entre mods y ofrecer una herramienta accesible para quienes buscan añadir botín personalizado sin sobrescribir las tablas de loot originales o de otros mods.

⬇️ Saltar directamente a Cómo usar y Configurar

🚀 ¿Para quién es AquaDrop?

🛠️ Owners de Servidores y Usuarios del Asset Editor: Sin necesidad de saber programar, puedes configurar qué ítems quieres que se dropeen. Muy cómodo si notas que faltan ítems en tu servidor o si tienes ítems personalizados que quieres repartir.
👨‍💻 Modders Avanzados: Una API de utilidad robusta para evitar conflictos entre mobs, asegurando que tus drops funcionen perfectamente en cualquier ecosistema de mods.

✨ Características y Ventajas Principales

➕ Dropeos Adicionales: Este dropeo es adicional al que ya tiene la entidad o el ítem original. No sobreescribes ni rompes nada; simplemente añades más posibilidades.
⚡ Cálculo en Tiempo Real (Funciona en Mundos ya Generados): La API trabaja sobre la capa del juego calculando el dropeo en tiempo real. No necesitas reiniciar tu servidor ni crear un mundo nuevo; AquaDrop funciona a la perfección en mundos que ya están en progreso y en entidades que ya tienen su propio botín predefinido.
🎯 Compatibilidad Extrema: Consigue que tus ítems personalizados se dropeen de formas muy exclusivas. ¿Quieres que un jefe (boss) de otro mod suelte tu ítem? Con AquaDrop es completamente posible y libre de conflictos.

⬇️ Saltar directamente a Cómo usar y Configurar

⚙️ How to use & configure AquaDrop (English)

🔍 Pro Tip for finding IDs: Before setting up your drops, you will need the exact IDs of the blocks or entities. We highly recommend going into Creative Mode and hovering your mouse over an item to see its ID, or using the in-game entity spawn tool. You can also find a complete list of mob IDs at hytaleguide.net/mobs.

🛡️ 1. For Server Admins

Managing drops has never been easier. Just use the built-in command:

/aquadrop config: Opens an In-Game Admin UI (visual menu) where you can add and hot-reload your drop rules on the fly, without restarting the server.

📦 2. For Asset Editor Modders

If you are creating custom content and packaging it via the Asset Editor, setting up your drops takes only two steps:

With the mod installed

Create a text file and name it aquadrops.json. (example at the end or you can generate the file with the Server Manager tools)
Place this file inside the root folder of your custom Mod's Asset .zip package.

⚠️ Crucial Step for Publishing: When sharing your mod, you must explicitly instruct your users to download and install AquaDrop for your custom drops to work. We highly recommend adding AquaDrop as a Required Dependency in the "Related Projects" tab on your CurseForge page.

👨‍💻 3. For Advanced Developers (API usage)

If you are writing Java code and want to leverage AquaDrop's native ECS processing natively, we have a comprehensive guide for you:

👉 Read the Full API Guide on GitHub

----------------------------------------------------------------------------------------------------------------------

📝 General Configuration Example (JSON)

{
  "BlockDrops": [
    {
      "SourceId": "Furniture_Village_Coffin",
      "DropId": "AquaAmulets_Magic_Fragment",
      "Probability": 5.5,
      "Quantity": 1
    }
  ],
  "MobDrops": [
    {
      "SourceId": "Skeleton_Burnt_Alchemist",
      "DropId": "AquaAmulets_Dark_Ring",
      "Probability": 30.0,
      "Quantity": 3
    }
  ]
}

In the example above, breaking a Coffin block has a 5.5% chance to drop 1 Magic Fragment. Killing a Burnt Alchemist has a 30% chance to drop 3 Dark Rings. The API safely processes these alongside any existing drops!

⚙️ Cómo usar y configurar AquaDrop (Español)

🔍 Consejo para encontrar IDs: Antes de configurar tus drops, necesitarás las IDs exactas. Te recomendamos entrar en Modo Creativo y pasar el ratón sobre un ítem para ver su ID, o usar la herramienta in-game de aparición de entidades. También puedes consultar una lista completa en hytaleguide.net/mobs.

🛡️ 1. Para Administradores de Servidores

No necesitas complicarte editando archivos. AquaDrop incluye una interfaz visual directamente en el juego:

/aquadrop config: Abre un menú visual de administrador donde puedes añadir y recargar (hot-reload) reglas de drops al instante, sin necesidad de reiniciar el servidor.

📦 2. Para Modders del Asset Editor

Si estás empaquetando tus mods creados en el Asset Editor, configurar tus drops requiere solo dos pasos:

con el mod instalado

Crea un archivo llamado aquadrops.json. (ejemplo al final o puedes generar el archivo con las herramientas de Administradores de servidores)
Colócalo en la carpeta raíz (root) del paquete .zip de los Assets de tu mod.

⚠️ Paso Crucial para Publicar: Al compartir tu mod, debes especificar claramente a tus usuarios que necesitan descargar e instalar AquaDrop para que los drops funcionen. Te recomendamos ampliamente marcar AquaDrop como una Dependencia Requerida (Related Projects) en la configuración de tu página de CurseForge.

👨‍💻 3. Para Desarrolladores (Uso de la API)

Si programas en Java y quieres aprovechar las consultas ultrarrápidas sobre ECS de AquaDrop, tenemos la documentación completa en nuestro repositorio:

👉 Lee la Guía de la API en GitHub