hxwi1structures

# Hxwi1Structures **NBT structure generation mod designed for modpack authors** – visual config, high performance, ready to use. (https://img.shields.io/badge/Modrinth-Hxwi1Structures-00AF5C?logo=modrinth)](https://modrinth.com/mod/hxwi1structures) (https://img.shields.io/badge/Forge-1.20.1-orange?logo=forge)](https://files.minecraftforge.net/) (https://img.shields.io/badge/NeoForge-1.21.1-blue?logo=neoforge)](https://neoforged.net/) --- ## 📦 Overview Tired of manually writing JSON to configure structure generation? Hxwi1Structures lets you manage all your NBT structure generation rules through a **visual GUI**. Drop your buildings, click a few times, and the world will generate them automatically. | Feature | Description | | :--- | :--- | | 🎮 **Visual Config** | `/hxwi1 config` – dual-panel GUI, left pane auto‑scans NBT files, right pane editable fields | | 🔄 **Hot‑Reload** | Configuration reloads automatically after saving – no need to restart | | 🌍 **Four Placement Modes** | Snap to Surface, Snap to Water Surface, Dock Mode, Underwater Mode | | 🎲 **Fine‑Grained Control** | Biomes (tag support), dimensions, Y range, chance, conflict ratio, min chunk distance, rotations, Y offset, etc. | | 🪓 **Extra Block Removal** | `clear_blocks` – manually specify blocks to remove (solves compatibility with Dynamic Trees and similar mods) | | ⛏️ **Flatten Ground** | `flatten_ground` + `ground_block` – automatically fills gaps under the structure | | 💬 **Debug Commands** | `/hxwi1 biomeinfo` – shows current biome and spawnable structures, `/hxwi1 spawn` for manual testing | | ⚡ **High Performance** | Chunk post‑processing + tick throttling + LRU cache, negligible TPS impact | | 🔌 **Excellent Compatibility** | No Mixin – works with major terrain/optimisation mods (verified with Better MC / ATM10) | ## 📥 Installation 1. Download the JAR for your game version (1.20.1 Forge or 1.21.1 NeoForge). 2. Put it into the `mods/` folder. 3. Start the game – config files will be generated in `config/hxwi1structures/`. 4. Place your structure‑block exported `.nbt` files into `config/hxwi1structures/structures/` (subfolders supported). 5. Run `/hxwi1 config` to set up generation rules. ## 🛠️ Quick Start - **Add structures**: Drop `.nbt` files into the `structures/` folder – the mod auto‑detects them. - **Configure rules**: Pick an NBT file in the GUI, set biomes, chance, Y range, etc. - **Test**: Use `/hxwi1 spawn <filename>` to spawn a structure at your current position. - **Debug**: `/hxwi1 biomeinfo` shows which structures can generate in your current biome. ## 📖 Documentation An in‑game multi‑language tutorial file is auto‑generated at: `config/hxwi1structures/readme.txt` It contains a complete field reference, workflow examples, and FAQ. ## ⚠️ Current Version Status - **v0.3.1-alpha** – core features stable, above‑ground generation has been validated in large modpacks. - **Known issue**: Underground generation does not have collision detection and may overlap with other mods‘ dungeons. Mitigate by adjusting Y range or increasing `min_chunk_distance`. - **Semi‑compatible with Dynamic Trees**: may require manually adding Dynamic Trees’ blocks to `clear_blocks` for complete removal. ## 🧪 Compatibility - ✅ Better MC v58 (BMC4) - ✅ All the Mods 10 - 7.0 - ✅ C2ME, TerraForged, Terralith, Biomes O’ Plenty, etc. - ⚠️ Dynamic Trees (semi‑compatible, may need extra `clear_blocks` configuration) ## 📝 License & Open Source - **Code**: MIT License - **NBT structure assets**: Copyright retained by their creators. Redistribution of extracted NBT files for other mods is prohibited. They may be distributed as part of an entire modpack together with this mod. --- ## 🔗 Links - **GitHub**: (https://github.com/hxwi1/hxwi1structures) - **Feedback**: (mailto:djyelylyeys2022@outlook.com) --- **If you like this mod, recommend it to your favourite modpack authors!**