RuinedStructures999

Features

• Eleven ruined structures with different environments, layouts, hazards, enemies, and loot.
• Automatic generation in newly generated chunks.
• Deterministic per-chunk spawn decisions, preventing repeated decisions from changing after reloads.
• Configurable global and per-world spawn chances.
• Per-structure world allow-lists and block-lists.
• Configurable biome and vertical-range restrictions.
• Configurable worlds where no structures may generate.
• Empty biome lists mean that every biome is accepted.
• Overlap prevention with a configurable minimum distance between structures.
• Main-thread generation queue with a configurable generation limit per tick.
• Optional protection checks when a protection plugin is installed.
• Configurable mob encounters with entity type, count, and glowing settings.
• Difficulty scaling based on world difficulty and distance from the world origin.
• First-open randomized loot for registered chests and barrels.
• Custom loot tables with amount ranges, weighted chances, and enchantments.
• Persistent loot state across restarts.
• Persistent structure locations, changed-block protection, and bounding-box tracking.
• Safe removal that restores only blocks that players have not changed.
• Regeneration of the nearest tracked structure.
• Locate and management commands for administrators.
• Optional debug logging.

Included Structures

• Piglin Village: A Nether settlement containing piglins, piglin brutes, houses, paths, and valuable supplies.
• Collapsed Watchtower: A damaged defensive tower with ladders, a skeleton spawner, and elevated loot.
• Ruined House: A small surface ruin with a partially collapsed roof, debris, cobwebs, and supplies.
• Sunken Shrine: An underwater ruin with prismarine materials, a drowned spawner, and aquatic loot.
• Bandit Camp: A surface camp with wagons, tents, pillager defenses, and stacked barrels.
• Pillager Castle: A fortified ruin with towers, spawners, rooms, stairs, and several loot containers.
• Abandoned Quarry: A large open excavation with exposed ores, a hut, scaffolding, barrels, and hostile spawners.
• Haunted Graveyard: A surface graveyard with graves, a crypt, undead spawners, and hidden containers.
• Sunken Graveyard: An underwater graveyard with submerged graves, a crypt, drowned enemies, and aquatic loot.
• Collapsed Mineshaft: An underground mine ruin with tunnels, barrels, exposed ores, and a pillager spawner.
• Desert Temple Ruins: A desert ruin with hidden rooms, husk spawners, loot, and a functional TNT pressure-plate trap.

Commands

• /spawnstructure <structure_name>: Queue a structure at your current location.
• /rs999 reload: Reload structure and gameplay settings.
• /rs999 list: List enabled structures, their current-world spawn chances, and whether they are enabled in the current world.
• /rs999 info <structure_name>: Show a structure's spawn chance, accepted biomes, and vertical range.
• /rs999 locate <structure_name> [radius]: Find the nearest tracked structure of the selected type in your world, optionally within a radius.
• /rs999 despawn <radius>: Safely remove tracked structures within the radius while preserving player changes.
• /rs999 regenerate <structure_name>: Safely regenerate the nearest tracked structure of the selected type.

Structure names are:

piglin_village, collapsed_watchtower, ruined_house, sunken_shrine, bandit_camp, pillager_castle, abandoned_quarry, haunted_graveyard, sunken_graveyard, collapsed_mineshaft, and desert_temple_ruins.

Permissions

• ruinedstructures999.spawnstructure: Use /spawnstructure.
• ruinedstructures999.reload: Use /rs999 reload.
• ruinedstructures999.list: Use /rs999 list.
• ruinedstructures999.info: Use /rs999 info.
• ruinedstructures999.locate: Use /rs999 locate.
• ruinedstructures999.despawn: Use /rs999 despawn.
• ruinedstructures999.regenerate: Use /rs999 regenerate.

All permissions default to operators.

Configuration

General settings

• debug: Enables diagnostic logging when set to true.
• disabled-worlds: A list of worlds where no automatic structure generation occurs.
• performance.max-structures-per-tick: Maximum number of queued structures generated per tick.
• performance.auto-save-ticks: Number of ticks between persistence saves. Values below 20 are raised to 20.
• protection.enabled: Enables the optional protection check. If enabled and WorldGuard is installed, generation is checked against protected areas.
• structure-overlap-prevention.enabled: Enables minimum-distance checks.
• structure-overlap-prevention.radius: Minimum distance used to prevent overlapping structure generation.

Mob encounters and difficulty

• mob-encounters.enabled: Enables the shared encounter defaults.
• mob-encounters.entity: Entity type used by shared encounter defaults.
• mob-encounters.count: Base number of encounter entities.
• mob-encounters.glowing: Makes encounter entities glow when enabled.
• difficulty-scaling.base-multiplier: Base encounter multiplier.
• difficulty-scaling.distance-step: Distance interval used for distance scaling.
• difficulty-scaling.distance-factor: Additional multiplier added per distance interval.

Each structure can override encounter settings under structures.<structure_name>.mob-encounter using enabled, entity, count, and glowing.

Per-structure settings

Every structure supports:

• enabled: Enables or disables the structure.
• spawn-chance-per-chunk: Default chance for a new chunk to receive a spawn attempt.
• world-specific-spawn-chance: Optional world-name-to-chance overrides.
• min-spawn-y and max-spawn-y: Allowed vertical range.
• allowed-biomes: Accepted biome names. An empty list accepts every biome.
• enabled-worlds: Optional allow-list. When non-empty, only listed worlds may generate the structure.
• disabled-worlds: Optional block-list for that structure.
• loot-table: Optional weighted custom loot entries.

Custom loot entries

Each loot entry may contain:

• item: A valid item name.
• min-amount: Minimum stack amount.
• max-amount: Maximum stack amount.
• chance: Relative weight used when selecting loot.
• enchantments: Optional list containing an enchantment type and level.

If a structure has no custom loot table, it uses its built-in themed loot pool.