
根据你的自定义结构图生成的地牢,直接放置在你的世界中。玩家使用指南针追踪地牢位置,并用钥匙、破坏镐或计时器打开宝箱获取战利品。
Paper 1.21.4+ Folia Java 21
工作原理
- 将结构图放入
schem 文件夹并运行 /rs spawn。
- 插件会在匹配的生物群系中找到一块平坦区域,保存地形并在 WorldGuard 区域内粘贴地牢。
- 玩家通过指南针找到地牢,并使用钥匙、破坏镐或计时器打开潜影盒。
- 当地牢被清空后,它会消失,地形恢复,新的地牢将在世界中生成。
每种地牢类型都是 structures 文件夹中的独立文件,因此你可以为每种类型设置结构图、生物群系、生成位置和开启方式。
功能特性
- 支持陆地、水深至少 3 格的水面以及距离地面 30 到 60 格高的空中生成地牢。
- 支持来自 WorldEdit 和 FastAsyncWorldEdit 文件夹的自定义
.schem 文件。
- 生物群系过滤:支持单个生物群系、通配符掩码(如
"*ocean*")或数据包中的所有生物群系(如 "terralith:*")。
- 类型权重:权重为 10 的地牢生成频率是权重为 5 的地牢的两倍。
- 3 种开启宝箱的方式:使用钥匙、用破坏镐敲击 12 次或使用 60 秒倒计时。
- 钥匙从 20 种原版战利品来源掉落,范围涵盖村庄到嗅探兽。你可以在菜单中设置每种来源的掉落几率。
- 指南针显示隐藏最后两位数字的地牢坐标。每 8 小时可使用一次。
- 在菜单中设置潜影盒和木桶的战利品:放入物品并设置其 1% 到 100% 的掉落几率。
- 每个地牢周围都有 WorldGuard 区域:包含 17 个标志位,3 格缓冲距离,地牢之间至少相距 100 格。
- 插件在粘贴前会保存地形,并通过
/rs undo 逐块恢复地形。
- 清空后自动移除,操作栏显示倒计时,1 秒后重新生成新地牢。
- 配合 FancyHolograms 或 DecentHolograms 在宝箱上方显示全息广告:锁定状态、已开启状态、倒计时状态。
- 默认文本为俄语。所有文本均可在
messages.yml 和 items.yml 中编辑。
- 支持 MiniMessage、SQLite 或 MySQL,支持 Folia。
宝箱开启方式
每种地牢类型都有其独特的开启方式。你可以通过地牢文件中的 open-type 进行设置。
| 方式 |
玩家操作 |
默认设置 |
key |
使用来自原版结构战利品的钥匙打开潜影盒 |
钥匙有 50% 的几率保留 |
pickaxe |
持续敲击潜影盒直到其打开 |
需要敲击 12 次,镐子耐久度 64 |
timer |
点击潜影盒并等待倒计时结束 |
60 秒 |
依赖要求
| 服务端 |
Java |
必需插件 |
可选插件 |
| Paper 1.21.4+ 或 Folia |
21 |
WorldEdit 或 FastAsyncWorldEdit, WorldGuard |
FancyHolograms 或 DecentHolograms |
命令与权限
| 命令 |
功能 |
/rs help |
显示命令列表 |
/rs menu |
打开菜单:战利品、钥匙几率、地牢、类型 |
/rs spawn [数量] [世界] |
生成 1 到 20 个地牢 |
/rs spawn cancel |
取消正在进行的生成过程 |
/rs undo [ID] |
移除一个地牢并恢复地形 |
/rs give <key|compass|pickaxe> [玩家] [数量] |
给予钥匙、指南针或破坏镐 |
/rs admin <test|remove|loot> |
添加、移除或填充你注视的潜影盒 |
/rs reload |
重载配置文件 |
别名:/rstructures。所有命令均需权限 rstructures.admin。玩家无需任何权限即可发现地牢并开启宝箱,无需使用命令。
config.yml
debug: false # 用于故障排除的详细控制台消息
command:
main: rstructures # 主命令名称
aliases: [ rs ] # 额外命令别名
# 插件查找结构图的文件夹,除了 plugins/rStructures/schem 之外
schematic-folders:
- "WorldEdit/schematics"
- "FastAsyncWorldEdit/schematics"
containers: # 地牢文件中默认的宝箱方块
- SHULKER_BOX
# 宝箱上方的全息广告。需要 FancyHolograms 或 DecentHolograms
holograms:
enabled: true
height: 1.6 # 方块上方的高度
view-distance: 32 # 视距,单位为格
closed: # 宝箱已锁定
- "<red><b>!"
opened: # 宝箱已开启
- "<green><b>✔"
timer: # 倒计时进行中。{time}: 剩余时间
- "<yellow><b>{time}"
scale: 1.3 # 文字大小
billboard: center # 文字面向玩家的方式
background: none # 文字背景
text-shadow: true # 文字阴影
see-through: false # 穿透方块可见
# 音效。空键值表示关闭声音
sounds:
shulker-open: # 宝箱开启
key: "minecraft:block.iron_door.open" # 音效 ID
volume: 1.0 # 音量,从 0.0 到 1.0
pitch: 1.0 # 音调,从 0.5 到 2.0
shulker-closed: # 点击锁定的宝箱
key: "minecraft:block.chest.locked"
volume: 1.0
pitch: 1.0
key-saved: # 钥匙未损坏
key: "minecraft:entity.experience_orb.pickup"
volume: 1.0
pitch: 1.2
compass: # 指南针找到了地牢
key: "minecraft:item.lodestone_compass.lock"
volume: 1.0
pitch: 1.0
menu-click: # 菜单点击
key: "minecraft:ui.button.click"
volume: 0.5
pitch: 1.0
# 宝箱处的粒子效果
particles:
shulker-open:
type: HAPPY_VILLAGER # 粒子类型
count: 30 # 数量
spread: 0.5 # 扩散范围,单位为格
speed: 0.05 # 速度
shulker-closed:
type: SMOKE
count: 15
spread: 0.3
speed: 0.02
config-version: 1 # 内部字段,请保持原样
structures/<type>.yml
structures 文件夹中的每个文件代表一种独立的地牢类型。文件名即为类型 ID。插件自带 ground.yml、water.yml 和 air.yml。
name: "<white>Наземный данж" # 菜单和生成消息中显示的名称
配置:
文件: ground1.schem # 来自 plugins/rStructures/schem 或 schematic-folders 的 schem 文件
忽略空气: true # true: 结构中的空气不会替换世界方块
偏移: # 从找到的位置偏移的结构,以方块为单位
x: 0
y: 1
z: 0
# 粘贴前清除的内容。玩家、宠物和命名实体保持不变
清除:
物品: true # 掉落的物品
怪物: true # 敌对生物
动物: true # 动物
载具: false # 船和矿车
植被: true # 草、花朵、树叶
液体: false # 水和岩浆
雪: true # 雪层
生成:
世界: world # 生成世界
放置: ground # ground: 在陆地上, water: 在水面上至少 3 格深, air: 在空中
# plains: 一个生物群系。"*ocean*": 名称中包含 ocean 的所有生物群系。"*": 所有生物群系
生物群系: [plains, sunflower_plains, meadow, snowy_plains]
权重: 10 # 选择类型时的权重
限制: -1 # 同时存在的此类地牢数量, -1 表示无限制
平坦度: 3 # 地牢下方允许的高度差
高度: 0 # 相对于表面的高度偏移
# 仅适用于 placement: air
# air:
# min: 30 # 高于表面的高度,随机从 min 到 max
# max: 60
功能:
开启类型: key # key, pickaxe 或 timer
开启时间: 60s # 计时器的倒计时长度: 30s, 5m, 1h
镐子击打次数: 12 # 镐子所需的击打次数
钥匙保留几率: 50 # 钥匙幸存的几率,范围 0 到 100
容器: [SHULKER_BOX] # 变成锁定保险箱的结构方块
战利品容器: [BARREL] # 装满战利品且无锁的方块
自动:
启用: true # 清理后移除地牢
时间: 10s # 清理后的移除延迟
寿命: 0 # 无论如何在此时长后移除,0 表示无限制
需要: # 什么算作已清理
打开: true # 每个保险箱都已打开
搜刮: true # 每个保险箱都已清空
actionbar: true # 在地牢内玩家的移除倒计时
重生:
启用: true # 移除后在同一世界生成新地牢
时间: 1s # 新生成前的延迟
需要玩家: false # true: 仅在世界中有玩家时生成
</details>
<details>
<summary>world.yml</summary>
```yaml
# 插件查找地牢位置的地方
生成:
min-x: -5000 # 搜索区域边界
max-x: 5000
min-z: -5000
max-z: 5000
平坦度: 3 # 结构文件的默认高度差
尝试次数: 36 # 检查的随机点数
半径: 32 # 围绕一点的搜索半径
步长: 4 # 检查步长,以方块为单位
每刻区块数: 12 # 每刻检查的区块数
生成区块: true # true: 生成尚不存在的区块
紧急区块: false # true: 以高优先级加载区块
建造:
每刻层数: 8 # 每刻粘贴的结构层数
配置版本: 1 # 内部字段,保持原样
region.yml
区域:
填充: 3 # 结构周围的区域填充,以方块为单位
名称: "struct_{id}" # WorldGuard 区域名称。{id}: 地牢编号
标志: # 区域标志:允许或拒绝
使用: allow
破坏方块: deny
建造: deny
生物生成: deny
pvp: allow
tnt: deny
箱子访问: allow
苦力怕爆炸: deny
伤害动物: deny
恶魂火球: deny
重生锚: deny
破坏载具: deny
末影龙方块破坏: deny
生物伤害: deny
岩浆火: deny
闪电: deny
打火石: deny
限制:
距离: 100 # 地牢之间的最小方块数
最大: -1 # 每个世界中同时存在的地牢数量, -1 表示无限制
避免区域: true # true: 绝不将地牢放置在其他区域上方
配置版本: 1 # 内部字段,保持原样
items.yml
# 锁定保险箱的钥匙。
key:
材质: TRIPWIRE_HOOK # 物品
纹理: "" # PLAYER_HEAD 的 base64 纹理
名称: "<white>Ключ от данжа" # 名称,MiniMessage 格式
描述:
- ""
- " <#FEF06A>Ключ <white>открывает закрытый"
- " <white>шалкер в данже."
- ""
模型数据: 0 # 资源包的 CustomModelData
闪烁: true # 附魔光泽
标志: [] # 物品标志:HIDE_ATTRIBUTES 等
功能:
发光: true # 掉落时有发光轮廓
退出掉落: false # true: 玩家离开服务器时物品掉落
禁止合成: true # 该物品不能用于合成
保留几率: 50 # 钥匙幸存的几率
# 指向地牢的指南针。lore 中的 {cooldown} 显示剩余时间。
compass:
材质: COMPASS
纹理: ""
名称: "<white>Компас данжей"
描述: []
模型数据: 0
闪烁: false
标志: []
功能:
发光: true
退出掉落: false
禁止合成: true
加密: true # 隐藏坐标的最后几位数字
加密位数: 2 # 隐藏多少位数字
指针: false # true: 指南针指针指向地牢
冷却: 8h # 使用之间的延迟
消耗: false # true: 使用后指南针消失
目标: random # random: 随机地牢, nearest: 最近的地牢
# 破坏用镐子。
pickaxe:
材质: NETHERITE_PICKAXE
纹理: ""
名称: "<white>Кирка взломщика"
描述: []
模型数据: 0
闪烁: false
标志: []
功能:
发光: true
退出掉落: false
禁止合成: true
击打次数: 12 # 每个保险箱所需的击打次数
耐久度: 64 # 镐子的耐久度
配置版本: 1 # 内部字段,保持原样
database.yml
存储: sqlite # 存储地牢、战利品和保存地形的地方:sqlite 或 mysql
# 仅在 storage: mysql 时读取
mysql:
主机: localhost # 数据库服务器地址
端口: 3306 # 端口
数据库: rstructures # 数据库名称
用户: "root" # 用户
密码: "" # 密码
配置版本: 1 # 内部字段,保持原样

Dungeons from your own schematics placed right in your world. Players track them with a compass and break into loot vaults with a key, a pickaxe or a timer.
Paper 1.21.4+ Folia Java 21
How it works
- Put a schematic into the
schem folder and run /rs spawn.
- The plugin finds a flat spot in a matching biome, saves the terrain and pastes the dungeon inside a WorldGuard region.
- A player finds the dungeon with the compass and opens the shulker boxes with a key, the breaker pickaxe or a timer.
- Once the dungeon is cleared, it disappears, the terrain comes back and a new dungeon spawns in the world.
Each dungeon type is a separate file in the structures folder, so you set the schematic, biomes, placement and opening method for every type.
Features
- Dungeons on land, on water at least 3 blocks deep and in the air 30 to 60 blocks above the ground.
- Your own
.schem files from the WorldEdit and FastAsyncWorldEdit folders.
- Biome filter: a single biome, a mask like
"*ocean*" or every biome of a datapack with "terralith:*".
- Type weight: a dungeon with weight 10 spawns twice as often as one with weight 5.
- 3 ways to open a vault: a key, 12 hits with the breaker pickaxe or a 60 second countdown.
- Keys drop from 20 vanilla loot sources, from villages to the sniffer. You set the chance for each in the menu.
- The compass shows dungeon coordinates with the last 2 digits hidden. It works once every 8 hours.
- Loot for shulker boxes and barrels is set in the menu: drop an item in and set its chance from 1 to 100%.
- A WorldGuard region around each dungeon: 17 flags, 3 block padding, at least 100 blocks between dungeons.
- The plugin saves the terrain before pasting, and
/rs undo restores it block by block.
- Auto removal after clearing, a countdown in the action bar and a new spawn 1 second later.
- Holograms above vaults with FancyHolograms or DecentHolograms: locked, opened, timer.
- Default texts are in Russian. Every text is editable in
messages.yml and items.yml.
- MiniMessage, SQLite or MySQL, Folia support.
Vaults
Each dungeon type opens its own way. You set it with open-type in the dungeon file.
| Method |
What the player does |
Default |
key |
Opens a shulker box with a key from vanilla structure loot |
The key survives with a 50% chance |
pickaxe |
Hits the shulker box until it opens |
12 hits, pickaxe durability 64 |
timer |
Clicks the shulker box and waits for the countdown |
60 seconds |
Requirements
| Server |
Java |
Required plugins |
Optional plugins |
| Paper 1.21.4+ or Folia |
21 |
WorldEdit or FastAsyncWorldEdit, WorldGuard |
FancyHolograms or DecentHolograms |
Commands and permissions
| Command |
What it does |
/rs help |
Shows the command list |
/rs menu |
Opens the menu: loot, key chance, dungeons, types |
/rs spawn [amount] [world] |
Spawns 1 to 20 dungeons |
/rs spawn cancel |
Cancels a running spawn |
/rs undo [id] |
Removes a dungeon and restores the terrain |
/rs give <key|compass|pickaxe> [player] [amount] |
Gives a key, a compass or a pickaxe |
/rs admin <test|remove|loot> |
Adds, removes or fills the shulker box you look at |
/rs reload |
Reloads the configs |
Alias: /rstructures. Every command requires rstructures.admin. Players need no permissions: they find dungeons and open vaults without commands.
config.yml
debug: false # detailed console messages for troubleshooting
command:
main: rstructures # main command name
aliases: [ rs ] # extra command names
# Folders where the plugin looks for schematics, besides plugins/rStructures/schem
schematic-folders:
- "WorldEdit/schematics"
- "FastAsyncWorldEdit/schematics"
containers: # default vault blocks for dungeon files
- SHULKER_BOX
# Holograms above vaults. Needs FancyHolograms or DecentHolograms
holograms:
enabled: true
height: 1.6 # height above the block
view-distance: 32 # view distance, in blocks
closed: # vault is locked
- "<red><b>!"
opened: # vault is open
- "<green><b>✔"
timer: # countdown is running. {time}: time left
- "<yellow><b>{time}"
scale: 1.3 # text size
billboard: center # how the text turns to the player
background: none # text background
text-shadow: true # text shadow
see-through: false # visible through blocks
# Sounds. An empty key turns a sound off
sounds:
shulker-open: # vault opened
key: "minecraft:block.iron_door.open" # sound ID
volume: 1.0 # from 0.0 to 1.0
pitch: 1.0 # from 0.5 to 2.0
shulker-closed: # click on a locked vault
key: "minecraft:block.chest.locked"
volume: 1.0
pitch: 1.0
key-saved: # the key did not break
key: "minecraft:entity.experience_orb.pickup"
volume: 1.0
pitch: 1.2
compass: # the compass found a dungeon
key: "minecraft:item.lodestone_compass.lock"
volume: 1.0
pitch: 1.0
menu-click: # click in the menu
key: "minecraft:ui.button.click"
volume: 0.5
pitch: 1.0
# Particles at the vault
particles:
shulker-open:
type: HAPPY_VILLAGER # particle type
count: 30 # amount
spread: 0.5 # spread, in blocks
speed: 0.05 # speed
shulker-closed:
type: SMOKE
count: 15
spread: 0.3
speed: 0.02
config-version: 1 # internal field, leave it as is
structures/<type>.yml
Each file in the structures folder is a separate dungeon type. The file name is the type ID. The plugin ships with ground.yml, water.yml and air.yml.
name: "<white>Наземный данж" # name in the menu and in the spawn message
schematic:
file: ground1.schem # schematic from plugins/rStructures/schem or schematic-folders
ignore-air: true # true: air from the schematic does not replace world blocks
offset: # schematic offset from the found spot, in blocks
x: 0
y: 1
z: 0
# What to clear before pasting. Players, pets and named entities stay untouched
clear:
items: true # dropped items
monsters: true # hostile mobs
animals: true # animals
vehicles: false # boats and minecarts
vegetation: true # grass, flowers, leaves
liquids: false # water and lava
snow: true # snow layers
spawn:
world: world # spawn world
placement: ground # ground: on land, water: on water at least 3 blocks deep, air: in the air
# plains: one biome. "*ocean*": every biome with ocean in its name. "*": every biome
biomes: [plains, sunflower_plains, meadow, snowy_plains]
weight: 10 # weight when picking a type
limit: -1 # dungeons of this type at once, -1 for no limit
flatness: 3 # allowed height difference under the dungeon
height: 0 # height offset from the surface
# Only for placement: air
# air:
# min: 30 # height above the surface, random from min to max
# max: 60
functions:
open-type: key # key, pickaxe or timer
open-time: 60s # countdown length for timer: 30s, 5m, 1h
pickaxe-hits: 12 # pickaxe hits for pickaxe
key-save-chance: 50 # chance from 0 to 100 that the key survives
containers: [SHULKER_BOX] # schematic blocks that become locked vaults
loot-containers: [BARREL] # blocks filled with loot without a lock
auto:
enabled: true # remove the dungeon after clearing
time: 10s # removal delay after clearing
lifetime: 0 # remove this long after spawning in any case, 0 for no limit
require: # what counts as cleared
opened: true # every vault is open
looted: true # every vault is empty
actionbar: true # removal countdown for players inside the dungeon
respawn:
enabled: true # spawn a new dungeon in the same world after removal
time: 1s # delay before the new spawn
need-players: false # true: spawn only if the world has players
world.yml
# Where the plugin looks for a dungeon spot
spawn:
min-x: -5000 # search area borders
max-x: 5000
min-z: -5000
max-z: 5000
flatness: 3 # default height difference for dungeon files
attempts: 36 # random points to check
radius: 32 # search radius around a point
step: 4 # check step, in blocks
chunks-per-tick: 12 # chunks checked per tick
generate-chunks: true # true: generate chunks that do not exist yet
urgent-chunks: false # true: load chunks with high priority
build:
layers-per-tick: 8 # schematic layers pasted per tick
config-version: 1 # internal field, leave it as is
region.yml
region:
padding: 3 # region padding around the schematic, in blocks
name: "struct_{id}" # WorldGuard region name. {id}: dungeon number
flags: # region flags: allow or deny
use: allow
block-break: deny
build: deny
mob-spawning: deny
pvp: allow
tnt: deny
chest-access: allow
creeper-explosion: deny
damage-animals: deny
ghast-fireball: deny
respawn-anchors: deny
destroy-vehicle: deny
enderdragon-block-damage: deny
mob-damage: deny
lava-fire: deny
lightning: deny
lighter: deny
limits:
distance: 100 # minimum blocks between dungeons
max: -1 # dungeons per world at once, -1 for no limit
avoid-regions: true # true: never place a dungeon over other regions
config-version: 1 # internal field, leave it as is
items.yml
# Key for a locked vault.
key:
material: TRIPWIRE_HOOK # item
texture: "" # base64 texture for PLAYER_HEAD
name: "<white>Ключ от данжа" # name, MiniMessage format
lore:
- ""
- " <#FEF06A>Ключ <white>открывает закрытый"
- " <white>шалкер в данже."
- ""
model-data: 0 # CustomModelData for a resource pack
glint: true # enchantment glint
flags: [] # item flags: HIDE_ATTRIBUTES and others
functions:
glow: true # glowing outline when dropped
drop-on-quit: false # true: the item drops when the player leaves the server
deny-craft: true # the item cannot be used in crafting
save-chance: 50 # chance that the key survives
# Compass that points to a dungeon. {cooldown} in lore shows the time left.
compass:
material: COMPASS
texture: ""
name: "<white>Компас данжей"
lore: []
model-data: 0
glint: false
flags: []
functions:
glow: true
drop-on-quit: false
deny-craft: true
encrypt: true # hide the last digits of the coordinates
encrypt-digits: 2 # how many digits to hide
pointer: false # true: the compass needle points to the dungeon
cooldown: 8h # delay between uses
consume: false # true: the compass disappears after use
target: random # random: a random dungeon, nearest: the closest one
# Breaker pickaxe.
pickaxe:
material: NETHERITE_PICKAXE
texture: ""
name: "<white>Кирка взломщика"
lore: []
model-data: 0
glint: false
flags: []
functions:
glow: true
drop-on-quit: false
deny-craft: true
hits: 12 # hits per vault
durability: 64 # pickaxe durability
config-version: 1 # internal field, leave it as is
database.yml
storage: sqlite # where dungeons, loot and saved terrain are stored: sqlite or mysql
# Read only with storage: mysql
mysql:
host: localhost # database server address
port: 3306 # port
database: rstructures # database name
user: "root" # user
password: "" # password
config-version: 1 # internal field, leave it as is
评论 0
登录后参与评分
还没有评论,来抢沙发吧