- 版权类型
- 原创
- 插件中文名称
- KaGeneration
- 插件英文名称
- KaGeneration
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- Purpur
- 语言支持
- 中文(简体)
- 前置组件
- PlaceholderAPI
- 适配版本(Java)
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
[MD]
# KaGeneration 插件文档
## 概述
KaGeneration 是一个专为 Minecraft 空岛生存服务器设计的 Bukkit 插件,它通过修改水和岩浆交汇时生成的方块,使石头和原石有概率被替换为矿石,从而保证生存玩法的进行,你也可以自定义刷矿的世界(如地狱),插件提供了丰富的配置选项和功能,让服务器管理员可以根据需求定制矿石生成机制。
## 核心功能
### 1. 矿石生成系统
- 当水和岩浆交汇生成石头或原石时,根据配置的概率替换为矿石
- 支持多种矿石类型:钻石矿、铁矿、煤矿等
- 多权限组系统,不同权限玩家享受不同矿石生成概率
- 优先级系统,当玩家有多个权限时使用最高优先级组
- 支持ItemsAdder方块
### 2. 世界白名单
- 只在配置的世界中生效
- 支持任意数量的世界
- 默认在所有世界生效(当白名单为空时)
- 支持正则表达式判断
### 3. 功能开关
- **黑曜石转换**:手持空桶右键黑曜石可获得岩浆桶
- **下界水桶**:允许在下界放置水桶(突破原版限制)
- **冰块融水**:在下界破坏冰块可生成水源
### 4. 指令
- `/kg reload` - 重载插件配置
- `/kg info` - 显示当前配置状态
- `/kg place [world] [x] [y] [z] [block] -s` - 在指定位置放置方块 (-s 静默执行)
- `/kg help` - 显示帮助信息
### 5. PlaceholderAPI
- `%kageneration_level%` - 返回玩家当前的矿石组名称,如: level2
- `%kageneration_priority%` - 返回玩家当前的优先级,如: 2
### 6. 用法建议
- **地狱刷石** 创建一个地狱刷矿组,开启地狱可倒水桶功能,然后设置一个地狱世界的权限节点,使玩家在地狱也能刷矿!
- **疯狂时刻** 创建一个刷矿组(钻石块,金块,铁块等高价值方块),然后使用权限插件给玩家这个刷矿组的1分钟权限,这一分钟内会刷出这些高价值方块。
- **升级系统** 配置不同刷矿组各个矿石的概率,然后使用菜单插件出售各个刷矿组的权限,以实现类似升级刷石机的效果。
## 配置文件
配置文件位于 `plugins/KaGeneration/config.yml`
[/MD]
YAML:
# 注意:每个组所有矿石的概率合计应为 100!
Language: "en_US" # 内置语音文件 zh_CN, en_US
Setting:
# 使用指令place放置方块时是否播放音效和粒子效果 (true/false)
play_block_effects: true
# 是否启用黑曜石转换岩浆桶功能 (true/false)
get_lava_bucket: true
# 是否允许在下界放置水桶 (true/false)
allow_water_in_nether: true
# 是否在下界通过破坏冰块生成水源 (true/false)
generate_water_from_ice: true
Sound:
# 黑曜石转换岩浆桶时的音效 (Minecraft音效名称)
lava_bucket: "ITEM_BUCKET_FILL_LAVA"
# 在下界放置水桶时的音效 (Minecraft音效名称)
water_in_nether: "ITEM_BUCKET_EMPTY"
# 破坏冰块生成水源时的音效 (Minecraft音效名称)
ice_to_water: "BLOCK_GLASS_BREAK"
# 世界白名单(仅在这些世界生效)
World: # 留空[]则所有世界启用
- "skyblock" # 直接匹配
# - ".*_nether" # 正则表达式匹配(名称以_nether结尾的世界)
# - "resource_.*" # 正则表达式匹配(名称以resource_开头的世界)
# - ".*island.*" # 正则表达式匹配(名称包含island的世界)
Generation:
# 默认组(没有权限时使用)
default:
priority: 0 #优先级
iron_ore: 3
coal_ore: 5
stone: 92
# 等级1 - 需要权限 kageneration.level1
level1:
priority: 1
diamond_ore: 5
iron_ore: 10
coal_ore: 10
stone: 70
ia:test_block: 5 # ItemsAdder 方块支持
# 等级2 - 需要权限 kageneration.level2
level2:
priority: 2
diamond_ore: 10
iron_ore: 15
coal_ore: 15
stone: 60
# 等级3 - 需要权限 kageneration.level3
level3:
priority: 3
diamond_ore: 15
iron_ore: 20
coal_ore: 20
stone: 45
# 等级理论可无限添加,但优先级不允许相同,当拥有多个级别权限时,优先级最高的生效。