Dimensional Structure Restrict

# Dimensional Structure Restrict DimStructRestrict is a lightweight Minecraft Forge mod for **Minecraft 1.20.1** that allows you to **control where structures can spawn** based on dimension and structure rules. Designed and developed by **Troy Cook (@cookta2012)**, this mod provides fine-grained control over world generation behavior — especially useful for modpack developers and world designers. Initial release will be 1.20.1 other versions will be coming later. --- ## 🌍 Features - Prevent or allow specific structures from generating in specific dimensions. - Define whitelist or blacklist rules. - Optionally flag structures to not place the structure while it believes it placed it. - JSON-based configuration — supports comments and regenerates missing keys automatically. - Logs rule enforcement with structure/dimension context for debugging. --- ## 🔧 Configuration The config file is located at: ``` /config/dimstructrestrict.json ``` If the file doesn't exist, it will be generated with example entries. --- ### 📐 Structure of `dimstructrestrict.json` ```jsonc { "structures": [ { // Individual structure rules will override dimension rules FULL STOP "id": "minecraft:village_plains", // Structure ID "whitelist": ["minecraft:overworld"], // Allowed dimensions "false_place": false, // If true, the structure will be "falsely placed" (may break mods) "active": true // Whether this rule is active } ], "dimensions": [ { "id": "minecraft:overworld", // Dimension ID "whitelist": [], // Structures allowed in this dimension "active": true } ] } ``` --- ## 🧠 Rule Types ### ✅ `whitelist` Only listed dimensions or structures are allowed. ### ❌ `blacklist` Listed dimensions or structures will be prevented. ### ⚙️ `false_place` (optional, default `false`) If `true`, prevents the structure from placing **without skipping the generation step** meaning it is marked on the map as generated. > ⚠️ May cause issues with some structure-dependent mods. ### 🔄 `active` (optional, default `false`) Controls whether the rule is enforced. Useful for temporarily disabling rules without removing them. --- ## 🧪 Example Use Case ```json { "structures": [ { "id": "minecraft:ruined_portal", "blacklist": ["minecraft:the_end", "minecraft:the_nether"], "active": true } ], "dimensions": [ { "id": "minecraft:overworld", "whitelist": ["minecraft:village_savanna", "minecraft:village_plains"], "false_place": true, "active": true } ] } ``` --- ## 🛠️ Advanced Setup The mod uses a generic `Rule` system internally with two maps: - `STRUCTURE_RULES` for structure-specific rules - `DIMENSION_RULES` for dimension-based restrictions Each `Rule` is backed by: - `id`: ResourceLocation - `mode`: WHITELIST or BLACKLIST - `resource`: Set of targets (structure/dimension IDs) - `false_place`: Boolean - `active`: Boolean --- ## 🧑‍💻 Developer Notes - Author: **Troy Cook** - GitHub: [@cookta2012](https://github.com/cookta2012) - Language: Java - Environment: Minecraft Forge for Minecraft 1.20.1 --- ## 📄 License MIT License. --- ## 📬 Feedback & Contributions Feel free to open an issue or fork the project if you'd like to expand the system (e.g., gamerule-based control, datapack integration, or GUI support).