Перейти к содержимому
Mineforgian

hxwi1structures

An NBT structure generator for modpack makers. Visual GUI config, four placement modes, biome tags, dimensions, Y range, chance, min distance. High‑performance, no Mixin, good compatibility. For 1.20.1 Forge / 1.21.1 NeoForge.

Загрузки
143
Подписчики
2
Обновлён
2 июня 2026 г.
Лицензия
MIT

Опубликован 30 мая 2026 г.

Hxwi1Structures

NBT structure generation mod designed for modpack authors – visual config, high performance, ready to use.

Modrinth Forge NeoForge

📦 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

If you like this mod, recommend it to your favourite modpack authors!

Ченджлог

0.3.1Альфа1.20.1 · 2 июня 2026 г.

v0.3.1-alpha

Added

  • Configuration GUI — /hxwi1 config opens a dual-panel GUI
    • Left panel automatically scans NBT files
    • Right panel scrollable form for editing all fields
    • Auto‑serializes to JSON on save
  • Config reload — /hxwi1 reload hot‑reloads rules without restart
  • Flatten ground — flatten_ground field: fills gaps under the structure with a specified block before placement
  • Ground block — ground_block field: customisable block for flattening (default minecraft:dirt)
  • Extra block removal — clear_blocks field: manually specify blocks to remove (solves trees from mods that don’t register standard tags)
  • Biome tag support — biomes field supports tags like #minecraft:is_forest, can be mixed with exact IDs
  • Command — /hxwi1 biomeinfo shows current biome and list of NBT files that can generate there
  • Command — /hxwi1 spawn <file> manually spawns a structure at your current position (Tab‑completion, supports subfolders)
  • NBT subfolders — recursively scans all .nbt files inside structures/
  • Entity placement — entities inside the template (villagers, armour stands, etc.) are spawned with the structure
  • Rotation offset — rotation_offset corrects orientation errors from saved NBT files
  • README — tutorial file supports hot‑reload, no game restart required
  • Language support — UI and readme tutorial auto‑switch between Chinese and English; other languages are outdated but still usable, planned to be fully updated in the future
  • Command toggle — mod_settings.json allows disabling all /hxwi1 debug commands
  • Auto‑backup — automatically backs up config when saving to prevent accidental deletion (backup count configurable via max_backups)

Fixes

  • Flowers and replaceable plants are now treated as replaceable by default, preventing structures from floating
  • place_on_water renamed to Snap to Water Surface
  • Fixed border rendering on the right panel of ConfigScreen; scissor cropping prevents control overflow

Compatibility testing

  • Verified to run normally in Better MC v58 (BMC4) and All the Mods 10 - 7.0, with negligible performance impact
  • Semi‑compatible with Dynamic Trees mod; may require extra configuration in clear_blocks to fully remove Dynamic Trees blocks

New configuration options

  • commands_enabled — modpack/server owners can disable all /hxwi1 commands
  • max_backups — number of backups to keep (0–20, default 2)
  • enabled — each rule can be individually toggled on/off
  • min_chunk_distance — minimum chunk distance between same‑type structures (default 5 chunks)

Known issues

  • Underground generation does not have collision detection enabled and may overlap with other mods’ dungeons. Mitigate by adjusting Y range or increasing min_chunk_distance.
0.3.1Альфа1.21.1 · 2 июня 2026 г.

v0.3.1-alpha

Added

  • Configuration GUI — /hxwi1 config opens a dual-panel GUI
    • Left panel automatically scans NBT files
    • Right panel scrollable form for editing all fields
    • Auto‑serializes to JSON on save
  • Config reload — /hxwi1 reload hot‑reloads rules without restart
  • Flatten ground — flatten_ground field: fills gaps under the structure with a specified block before placement
  • Ground block — ground_block field: customisable block for flattening (default minecraft:dirt)
  • Extra block removal — clear_blocks field: manually specify blocks to remove (solves trees from mods that don’t register standard tags)
  • Biome tag support — biomes field supports tags like #minecraft:is_forest, can be mixed with exact IDs
  • Command — /hxwi1 biomeinfo shows current biome and list of NBT files that can generate there
  • Command — /hxwi1 spawn <file> manually spawns a structure at your current position (Tab‑completion, supports subfolders)
  • NBT subfolders — recursively scans all .nbt files inside structures/
  • Entity placement — entities inside the template (villagers, armour stands, etc.) are spawned with the structure
  • Rotation offset — rotation_offset corrects orientation errors from saved NBT files
  • README — tutorial file supports hot‑reload, no game restart required
  • Language support — UI and readme tutorial auto‑switch between Chinese and English; other languages are outdated but still usable, planned to be fully updated in the future
  • Command toggle — mod_settings.json allows disabling all /hxwi1 debug commands
  • Auto‑backup — automatically backs up config when saving to prevent accidental deletion (backup count configurable via max_backups)

Fixes

  • Flowers and replaceable plants are now treated as replaceable by default, preventing structures from floating
  • place_on_water renamed to Snap to Water Surface
  • Fixed border rendering on the right panel of ConfigScreen; scissor cropping prevents control overflow

Compatibility testing

  • Verified to run normally in Better MC v58 (BMC4) and All the Mods 10 - 7.0, with negligible performance impact
  • Semi‑compatible with Dynamic Trees mod; may require extra configuration in clear_blocks to fully remove Dynamic Trees blocks

New configuration options

  • commands_enabled — modpack/server owners can disable all /hxwi1 commands
  • max_backups — number of backups to keep (0–20, default 2)
  • enabled — each rule can be individually toggled on/off
  • min_chunk_distance — minimum chunk distance between same‑type structures (default 5 chunks)

Known issues

  • Underground generation does not have collision detection enabled and may overlap with other mods’ dungeons. Mitigate by adjusting Y range or increasing min_chunk_distance.
0.1.2Альфа1.21.1 · 30 мая 2026 г.

v0.2.0-alpha

Added

  • Visual configuration editor – entry point not yet available
    • Left pane automatically scans NBT files
    • Right pane scrollable form to edit all fields
    • Auto‑serialises to JSON on save
  • NeoForge 1.21.1 support
  • Structure density control – grid_interval global sampling interval
  • Underwater mode – underwater_mode only generates in water
  • Dock mode – dock_mode automatically detects water edge orientation
  • Y offset – y_offset vertical fine‑tuning
  • Clear trees – clear_trees BFS removes logs and leaves
  • Loot tables – loot_table automatically injects into containers
  • Multi‑language readme – auto‑generated tutorial in 10 languages

Fixes

  • Structure overlapping across chunk borders
  • Duplicate generation after server restart (SavedData persistence)
  • Over‑aggressive tree clearing (BFS radius reduced from 2 to 1)

v0.1.0 (internal version)

  • JSON‑driven NBT structure generation
  • Biome / dimension / chance / Y range filtering
  • Snap to surface, place on water, collision detection
  • Delayed queue processing (2 chunks per tick)
  • LRU template cache
  • Default example rules and NBT files
0.1.2Альфа1.20.1 · 30 мая 2026 г.

v0.2.0-alpha

Added

  • Visual configuration editor – entry point not yet available
    • Left pane automatically scans NBT files
    • Right pane scrollable form to edit all fields
    • Auto‑serialises to JSON on save
  • NeoForge 1.21.1 support
  • Structure density control – grid_interval global sampling interval
  • Underwater mode – underwater_mode only generates in water
  • Dock mode – dock_mode automatically detects water edge orientation
  • Y offset – y_offset vertical fine‑tuning
  • Clear trees – clear_trees BFS removes logs and leaves
  • Loot tables – loot_table automatically injects into containers
  • Multi‑language readme – auto‑generated tutorial in 10 languages

Fixes

  • Structure overlapping across chunk borders
  • Duplicate generation after server restart (SavedData persistence)
  • Over‑aggressive tree clearing (BFS radius reduced from 2 to 1)

v0.1.0 (internal version)

  • JSON‑driven NBT structure generation
  • Biome / dimension / chance / Y range filtering
  • Snap to surface, place on water, collision detection
  • Delayed queue processing (2 chunks per tick)
  • LRU template cache
  • Default example rules and NBT files

Комментарии

Загружаем…