ENGLISH (US)

Blocks that fly. Debris is a block physics library for Hytale: blocks are ripped out of the world, fly through the air as real 3D blocks, spin, tumble... and land again as blocks.

It's the engine behind the tornadoes and hurricanes coming to my mod Extreme Weather, and any modder can use it in their own mods (as a required mod).

WHAT IT DOES?

- Rips blocks out of the ground and turns them into real flying 3D blocks.
- Whirlwinds: blocks rise out of the ground, spin in a funnel, tumble in the air and get flung out.
- Smart landing: every block finds its own free spot, crushes the grass or bush below it and lands the right way up. No ghost blocks, no blocks inside each other.
- Strength levels: a weak wind only takes leaves; a medium one also takes dirt, grass, sand and gravel; only the strongest rips out wood and tree trunks. Stone, ores, chests and benches are never touched.
- Smooth: 200 flying blocks at once with no lag in my tests. There is a limit you can change for smaller servers.

TRY IT

/debris test [blocks] [strength 1-3] – a whirlwind around you (example: /debris test 100 2)
/debris drop – drops every flying block right now

⚙️ CONFIG

A debris.properties file is created on first launch:
- maxFlying – most blocks in the air at once (default 300)
- test.seconds – how long the test whirlwind lasts

🛠️ FOR MODDERS

Add MingoCreator:Debris as a dependency and use the API (always from the world thread, for example inside world.execute):

Debris.launch(world, x, y, z, velocity) – throw one block; it lands and is placed back
Debris.lift(world, x, y, z) – lift a block and steer it yourself (setVelocity, then release)
Debris.vortex(world, center, strength, seconds).addArea(radius, maxBlocks) – a whirlwind
Debris.dropAll(world) – drop everything
Resistance.of(blockType) – how hard a block is to rip out (0-3)

🔮 COMING NEXT

- Explosions that throw blocks into the air
- Small things (torches, plants, furniture) dropped as items when they land
- A JSON list so other mods can say which of their blocks can fly and how strong they are
- Tornadoes and hurricanes in Extreme Weather, powered by Debris

🛠️ STATUS: BETA

It works, but it's still in active development. Please report anything strange in the comments!

☕ SUPPORT MY WORK
I make these mods in my free time. If you enjoy them, you can buy me a coffee here: 👉 https://ko-fi.com/mingocreator 💗

CHECK OUT MY OTHER MODS!!

ESPAÑOL (ES)

🌪️ Bloques que vuelan. Debris es una librería de físicas de bloques para Hytale: los bloques se arrancan del mundo, vuelan por el aire como bloques 3D de verdad, giran, dan vueltas... y vuelven a caer como bloques.

Es el motor de los tornados y huracanes que llegarán a mi mod Extreme Weather, y cualquier modder puede usarlo en sus propios mods.

QUÉ HACE?

- Arranca bloques del suelo y los convierte en bloques 3D que vuelan de verdad.
- Remolinos: los bloques salen del suelo, giran en embudo, dan vueltas en el aire y salen despedidos.
- Aterrizaje inteligente: cada bloque busca su propio hueco libre, aplasta la hierba o el arbusto de debajo y cae del derecho. Sin bloques fantasma ni bloques metidos unos en otros.
- Niveles de fuerza: un viento débil solo se lleva hojas; uno medio también tierra, hierba, arena y grava; solo el más fuerte arranca madera y troncos. La piedra, los minerales, los cofres y las mesas nunca se tocan.
- Fluido: 200 bloques volando a la vez sin tirones en mis pruebas. Hay un límite que se puede bajar para servidores más modestos. (Probado en ordenador de alta gama: RTX 5070 TI, Ryzen 7 7800x3d, déjame saber en los comentarios si presentas problemas de rendimiento)

PRUÉBALO

/debris test [bloques] [fuerza 1-3] – un remolino a tu alrededor (ejemplo: /debris test 100 2)
/debris drop – suelta todos los bloques que estén volando

⚙️ CONFIGURACIÓN

Al arrancar por primera vez se crea el archivo debris.properties:
- maxFlying – máximo de bloques en el aire a la vez (300 por defecto)
- test.seconds – cuánto dura el remolino de prueba

🛠️ PARA MODDERS

Añade MingoCreator:Debris como dependencia y usa la API (siempre desde el hilo del mundo, por ejemplo dentro de world.execute):

Debris.launch(world, x, y, z, velocidad) – lanza un bloque; cae y se vuelve a colocar
Debris.lift(world, x, y, z) – levanta un bloque y dirígelo tú (setVelocity y luego release)
Debris.vortex(world, centro, fuerza, segundos).addArea(radio, maxBloques) – un remolino
Debris.dropAll(world) – suelta todo
Resistance.of(blockType) – lo difícil que es arrancar un bloque (0-3)

🔮 PRÓXIMAMENTE

- Explosiones que lanzan bloques por los aires
- Las cosas pequeñas (antorchas, plantas, muebles) caerán como objetos al aterrizar
- Una lista en JSON para que otros mods digan qué bloques suyos pueden volar y con qué fuerza
- Tornados y huracanes en Extreme Weather, gracias a Debris

🛠️ ESTADO: BETA
Funciona, pero sigue en desarrollo. Si ves algo raro, cuéntamelo en los comentarios.

☕ APOYA MI TRABAJO
Hago estos mods en mi tiempo libre. Si te gustan, puedes invitarme a un café aquí: 👉 https://ko-fi.com/mingocreator 💗

MIRA MIS OTROS MODS!!