Roguelike World

当前默认内容

MOD默认只提供 1 个 roguelike 维度和 1 个关卡：

维度：灰烬墓穴（roguelikeworld:ashen_catacombs）
关卡：灰烬起点（roguelikeworld:ashen_entry）

默认维度配置概览：

房间组数量为 3，支持最多 3 名玩家同时分配到不同房间组。
单组地牢为 4 x 4 房间网格。
基础房间边长为 32。
Boss 房固定在 (3, 3)。
默认生成 2 个奖励房。
场景材质以深板岩砖、深板岩瓦和镀金黑石为主，奖励容器使用木桶。

默认关卡配置概览：

当前为第 1 关，使用灰烬墓穴维度配置。
怪物生命倍率为 1.1，伤害倍率为 1.0。
掉落倍率为 1.05。
普通房为 2 波，首波 2 只，第二波 2 到 3 只。
精英房为 2 波，数量为 1 只到 2 只。
奖励房守卫为 2 波，每波 1 只。
Boss 候选池当前为监守者，二阶段增援数量为 2。
奖励战利品表当前使用原版地牢和要塞走廊箱子表。

当前玩法

当前地牢玩法为线性关卡制。

玩家通过指令 rlw 打开关卡选择界面，指令权限等级为 4。
也可以对地牢传送方块使用地牢钥匙来打开同一个选择界面。
进入关卡后会被传送到对应地牢维度，并切换为冒险模式。
每次进入都会分配一个独立房间组，避免玩家之间互相干扰。
房间布局会在生成时打乱；当玩家死亡、超时、离开或异常退出后，对应房间组会被清空并重新生成。
重建时会清除房间组内的怪物、掉落物等实体，避免旧战斗残留影响新一轮挑战。
起始房间通往后续房间的推进依赖门口阻挡；进入战斗房、精英房、奖励房后会封门，清完当前房间全部波次后才会开门。
Boss 房会单独封闭，Boss 生命降到一定阶段后会触发二阶段增援。
Boss 击败后会生成奖励并激活撤离祭坛，玩家靠近并潜行即可撤离。
挑战结束、超时或死亡后，会返回主世界并恢复进入前的游戏模式。

当前特性

关卡、维度、怪物池、波次和奖励表均由数据包驱动。
支持多房间组并发使用，只有某个维度全部房间组都被占用时才会禁止进入。
支持普通房、精英房、奖励房和 Boss 房四类核心房间流程。
支持怪物生命、攻击、伤害减免和掉落倍率缩放。
支持奖励房清场后发奖，Boss 击败后再发放 Boss 奖励。
支持 Roguelike 维度内禁止放置和破坏方块。
支持挑战超时提示、强制结算和结算结果界面。

Datapack

默认维度配置位于 src/main/resources/data/roguelikeworld/roguelike_dimension_profiles。

维度配置常用字段：

id: 地牢维度 ID，必须与实际维度 ID 一致。
titleKey / descriptionKey: 维度名称与描述的语言键；可省略，省略时默认使用 dimension.<namespace>.<path> 和对应的 .desc。
floorBlock / wallBlock / accentBlock / rewardBlock: 地板、墙体、强调块、奖励容器方块。
roomGroupCount: 该维度同时可用的房间组数量。
roomGroupSpacingChunks: 房间组之间的区块间隔，用于拉开不同房间组的位置。
roomRows / roomColumns: 房间网格大小。
baseRoomSize: 单个房间的基础边长。
bossRow / bossColumn: Boss 房所在网格坐标。
treasureRooms: 奖励房数量。

新增维度时需要同时提供：

Minecraft/NeoForge 原生维度数据，例如 data/<namespace>/dimension 和需要时的 dimension_type。
一份 roguelike_dimension_profiles/<name>.json，id 指向这个维度。
至少一个关卡文件把 dimensionId 指向该维度。

运行规则：

每个维度会按 roomGroupCount 提供多组房间，进入时分配空闲组。
只有该维度所有房间组都被占用时，玩家才会收到等待提示。
玩家退出、超时、死亡或异常离开后，会清空并重建自己使用的那一组房间。
Roguelike 维度内不允许方块破坏和放置。

默认关卡数据位于 src/main/resources/data/roguelikeworld/roguelike_stages。

关卡文件常用字段：

id: 当前关卡的唯一 ID。
dimensionId: 该关卡使用的地牢维度/场景配置。
order: 关卡顺序，决定线性解锁关系。
titleKey / descriptionKey: 对应语言文件里的名称和描述键。
scalars.mobHealthMultiplier: 怪物生命倍率。
scalars.mobDamageMultiplier: 怪物伤害倍率。
scalars.mobDamageReduction: 怪物额外伤害减免比例。
scalars.mobDamageReductionCap: 怪物伤害减免上限，最终减免不会超过该值。
scalars.lootMultiplier: 战利品数量倍率。
scalars.roomSizeBonus: 房间尺寸额外修正。
scalars.rewardBlocks: 奖励房和 Boss 房生成的奖励容器数量基准。
scalars.combatMonsterMin / scalars.combatMonsterMax: 未配置 combatWaves 时，普通房单波怪物数量范围。
scalars.eliteMonsterCount: 精英房怪物数量。
scalars.treasureGuardCount: 奖励房守卫数量。
scalars.bossReinforcementCount: Boss 二阶段增援数量。
combatWaves: 普通房波次列表；每一项代表一波。
eliteWaves: 精英房波次列表；省略时回退到单波和 scalars.eliteMonsterCount。
treasureWaves: 奖励房守卫波次列表；省略时回退到单波和 scalars.treasureGuardCount。
combatWaves[].monsterMin / combatWaves[].monsterMax: 该波怪物数量范围。
combatWaves[].monsterPool: 可选，覆盖当前波使用的普通怪物池；不写则沿用 pools.combatMonsterPool。
eliteWaves[].monsterMin / eliteWaves[].monsterMax: 该波精英怪数量范围。
eliteWaves[].monsterPool: 可选，覆盖当前波使用的精英怪池；不写则沿用 pools.eliteMonsterPool。
treasureWaves[].monsterMin / treasureWaves[].monsterMax: 该波奖励房守卫数量范围。
treasureWaves[].monsterPool: 可选，覆盖当前波奖励房守卫怪池；不写则沿用 pools.combatMonsterPool。
pools.combatMonsterPool: 普通房默认怪物池。
pools.eliteMonsterPool: 精英房怪物池。
pools.bossMonsterPool: Boss 候选池。
pools.rewardLootTables: 奖励容器可抽取的战利品表。

说明：

除 Boss 房外，战斗房、精英房、奖励房都支持波次；清完当前波后才会进入下一波，最后一波结束才开门。
如果 waves 配置省略，会回退到各自原本的单波数量字段。
奖励房最终奖励会在最后一波守卫清完后生成，Boss 房奖励会在 Boss 被击杀后生成。
额外维度不是硬编码写死的；只要原生维度数据、dimension profile 和 stage 配置都存在，就会被动态识别。

Roguelike World (English)

Default Content

This mod currently provides only one roguelike dimension and one stage:

Dimension: Ashen Catacombs (roguelikeworld:ashen_catacombs)
Stage: Ashen Entry (roguelikeworld:ashen_entry)

Dimension settings overview:

3 room groups, up to 3 players can be assigned to different groups simultaneously.
Each group is a 4 x 4 room grid.
Base room size: 32.
Boss room fixed at (3, 3).
2 reward rooms by default.
Main blocks: deepslate bricks, deepslate tiles, gilded blackstone. Reward containers use barrels.

Stage settings overview:

Stage 1, uses Ashen Catacombs dimension.
Mob health multiplier: 1.1, damage multiplier: 1.0.
Loot multiplier: 1.05.
Combat rooms: 2 waves, first wave 2 mobs, second wave 2-3 mobs.
Elite rooms: 2 waves, 1-2 mobs per wave.
Reward rooms: 2 waves, 1 guard per wave.
Boss pool: Warden, phase two reinforcement count: 2.
Reward loot tables: vanilla stronghold corridor and dungeon chests.

Gameplay

The dungeon uses a linear stage system.

Use the /rlw command (permission level 4) to open the stage selection screen.
You can also use the Dungeon Key item on the Dungeon Portal block to open the same screen.
After entering, you are teleported to the dimension and switched to Adventure mode.
Each entry assigns you an isolated room group, preventing interference between players.
Room layout is randomized each time; if you die, timeout, leave, or disconnect, your group is cleared and rebuilt.
Rebuilding clears all mobs and dropped items in the group, preventing leftover entities from affecting new runs.
Progression relies on door barriers; combat, elite, and reward rooms are sealed until all waves are cleared.
Boss room is sealed; phase two triggers reinforcements when boss health drops.
Defeating the boss spawns rewards and activates the extraction altar; sneak near it to leave.
After finishing, timeout, or death, you return to the overworld and your previous game mode is restored.

Features

Stages, dimensions, mob pools, waves, and rewards are all data-driven.
Supports multiple room groups per dimension; entry is blocked only if all groups are occupied.
Supports combat, elite, reward, and boss room flows.
Mob health, damage, resistance, and loot scaling.
Rewards are given after clearing reward rooms and after defeating the boss.
Block breaking and placing are disabled in roguelike dimensions.
Timeout warnings, forced settlement, and result screens are supported.

Datapack

Dimension profiles are in src/main/resources/data/roguelikeworld/roguelike_dimension_profiles.

Common dimension fields:

id: Dimension ID, must match actual dimension.
titleKey / descriptionKey: Language keys for name and description; defaults to dimension.<namespace>.<path> and .desc if omitted.
floorBlock / wallBlock / accentBlock / rewardBlock: Floor, wall, accent, reward container blocks.
roomGroupCount: Number of room groups available in the dimension.
roomGroupSpacingChunks: Chunk spacing between groups.
roomRows / roomColumns: Room grid size.
baseRoomSize: Base room edge length.
bossRow / bossColumn: Boss room grid coordinates.
treasureRooms: Number of reward rooms.

To add a new dimension, provide:

Vanilla/NeoForge dimension data (e.g. data/<namespace>/dimension and dimension_type if needed).
A roguelike_dimension_profiles/<name>.json file with id pointing to the dimension.
At least one stage file with dimensionId pointing to the dimension.

Rules:

Each dimension provides multiple room groups; entry assigns a free group.
Only when all groups are occupied will players see a waiting prompt.
Leaving, timeout, death, or disconnect clears and rebuilds your group.
Block breaking and placing are not allowed in roguelike dimensions.

Stage data is in src/main/resources/data/roguelikeworld/roguelike_stages.

Common stage fields:

id: Unique stage ID.
dimensionId: Dimension used for this stage.
order: Stage order, determines linear unlock.
titleKey / descriptionKey: Language keys for name and description.
scalars.mobHealthMultiplier: Mob health multiplier.
scalars.mobDamageMultiplier: Mob damage multiplier.
scalars.mobDamageReduction: Mob extra damage resistance.
scalars.mobDamageReductionCap: Resistance cap.
scalars.lootMultiplier: Loot multiplier.
scalars.roomSizeBonus: Room size adjustment.
scalars.rewardBlocks: Number of reward containers in reward/boss rooms.
scalars.combatMonsterMin / scalars.combatMonsterMax: Combat room mob count range if combatWaves is omitted.
scalars.eliteMonsterCount: Elite room mob count.
scalars.treasureGuardCount: Reward room guard count.
scalars.bossReinforcementCount: Boss phase two reinforcement count.
combatWaves: List of combat room waves; each entry is a wave.
eliteWaves: List of elite room waves; falls back to single wave and scalars.eliteMonsterCount if omitted.
treasureWaves: List of reward room guard waves; falls back to single wave and scalars.treasureGuardCount if omitted.
combatWaves[].monsterMin / combatWaves[].monsterMax: Mob count range per wave.
combatWaves[].monsterPool: Optional, overrides default pool for the wave; otherwise uses pools.combatMonsterPool.
eliteWaves[].monsterMin / eliteWaves[].monsterMax: Elite mob count range per wave.
eliteWaves[].monsterPool: Optional, overrides default pool for the wave; otherwise uses pools.eliteMonsterPool.
treasureWaves[].monsterMin / treasureWaves[].monsterMax: Reward room guard count range per wave.
treasureWaves[].monsterPool: Optional, overrides default pool for the wave; otherwise uses pools.combatMonsterPool.
pools.combatMonsterPool: Default combat mob pool.
pools.eliteMonsterPool: Elite mob pool.
pools.bossMonsterPool: Boss pool.
pools.rewardLootTables: Reward loot tables.

Notes:

Combat, elite, and reward rooms support waves; only after clearing all waves will the door open.
If waves are omitted, falls back to single wave count fields.
Final reward in reward rooms is generated after clearing the last guard wave; boss rewards are generated after defeating the boss.
Extra dimensions are not hardcoded; as long as vanilla dimension data, profile, and stage config exist, they are recognized dynamically.