概述

这个模组可以为世界添加新的地牢维度，玩家可以自己制作一个地牢数据包并用本模组安装。这些地牢维度可以通过主世界的一些传送门等途径进入，允许在多人游戏中和朋友一起加入地牢维度。

默认情况下玩家在地牢中无法破坏和放置任何方块，类似冒险模式，但可以在数据包文件中设置玩家能破坏和放置的方块种类。

模组自身就内置有一个地牢维度，要添加更多地牢需要玩家自行编写数据包。

添加地牢数据包

编写的数据包必须放在 data\dungeonz\dungeon\ 目录下。

模组默认添加的地牢维度数据包文件如下：

{    "dungeon_type": "dark_dungeon",  //地牢 ID
    "difficulty": {     //难度
        "easy": {            
        "mob_modificator": 1.0, //增强怪物攻击力的参数
        "loot_table_ids": [   //箱子和木桶的战利品表
                "dungeonz:chests/dark_dungeon_low_tier_chest_loot",                
                "dungeonz:chests/dark_dungeon_mid_tier_chest_loot"
            ],            
            "boss_modificator": 1.0,            
            "boss_loot_table_id": "dungeonz:chests/dark_dungeon_easy_boss_loot"
        },        
        "normal": {            
        "mob_modificator": 1.5,            
        "loot_table_ids": [                
        "dungeonz:chests/dark_dungeon_low_tier_chest_loot",                
        "dungeonz:chests/dark_dungeon_mid_tier_chest_loot",                
        "dungeonz:chests/dark_dungeon_high_tier_chest_loot"
            ],            
            "boss_modificator": 2.0,            
            "boss_loot_table_id": "dungeonz:chests/dark_dungeon_normal_boss_loot"
        }
    },    "blocks": {        
    "minecraft:gold_block": {            "spawns": [  //特殊方块上可以生成的生物
                "minecraft:skeleton"
            ],            
            "chance": { //每个难度的生物生成几率
                "easy": 0.4,                
                "normal": 0.7
            },            
            "replace": "minecraft:air"
        },        
        "minecraft:iron_block": {            
        "spawns": [                
        "minecraft:zombie"
            ],            
            "chance": {                
            "easy": 0.4,                
            "normal": 0.7
            },            
            "replace": "minecraft:air"
        },        
        "minecraft:netherite_block": {            
            "boss_entity": "minecraft:warden", //生成 Boss 的方块
            "data": "", //可选的额外 NBT
            "replace": "minecraft:air"
        },        
        "minecraft:emerald_block": {            
            "boss_loot_block": true, //这个方块在 Boss 战后会生成一个战利品宝箱
            "replace": "minecraft:air"
        },        
        "minecraft:quartz_block": {            
            "exit_block": true, //这个方块在 Boss 战后会生成离开地牢的传送门
            "replace": "minecraft:stone_bricks"
        }
    },    
    "spawner": { //刷怪笼持续刷怪的最长时间
        "minecraft:zombie": 10,        
        "minecraft:skeleton": 5
    },    
    "breakable": [], // 允许玩家破坏的地牢方块
    "placeable": [ //允许玩家放置的地牢方块
        "minecraft:torch"
    ],    
    "required": { //进入地牢消耗的方块
        "minecraft:stick": 3
    },    
    "elytra": false,    
    "max_group_size": 5,    
    "min_group_size": 0, //可选
    "cooldown": 108000, //完成或失败地牢挑战并离开后可再次进入的冷却时间，以游戏刻计
    "background_texture": "", //地牢传送门可以以一个图片作为纹理
    "dungeon_structure_pool_id": "dungeonz:dark_dungeon/dungeon_spawn" // 地牢开始生成的地方
    }

确保地牢的第一个结构部件"dungeon_structure_pool_id"中有一个名为"dungeonz:spawn"的拼图方块，这是玩家进入地牢后初始的方块。

模组默认添加的通向地牢的主世界结构如下：

{    "type": "dungeonz:dimension_structures",
     "start_pool": "dungeonz:overworld_test_start",    
     "size": 1,    
     "max_distance_from_center": 80,    
     "biomes": "#minecraft:is_overworld",    
     "step": "surface_structures",    
     "start_height": {        
     "absolute": 0
    },    
    "project_start_to_heightmap": "WORLD_SURFACE_WG",    
    "spawn_overrides": {},    
    "dungeon_type": "dark_dungeon"
    }

末尾的"dungeon_type"处需要写结构文件中设置好的地牢id。

模组还添加了一个进度触发器，可以在玩家完成地牢时达成进度，示例如下：

    "criteria": {        
    "completion_example": {            
    "trigger": "dungeonz:dungeon_completion",            
    "conditions": {
                    "dungeon_type": "dark_dungeon",                
                    "difficulty": "easy"
            }
        }
    }

如果玩家难以完成地牢挑战，使用命令 /dungeon leave 即可离开当前地牢进入主世界原本的位置。