BiologicalManagement 插件配置文件详解

本文档详细介绍 BiologicalManagement 插件的配置文件结构、参数含义和高级配置技巧，帮助您精确控制游戏中生物的属性。

配置文件结构

插件的配置文件位于 plugins/BiologicalManagement/config.yml，使用 YAML 格式编写。配置文件的基本结构如下：

# 生物属性配置文件
# 每个生物的配置项:
# <entity_type>:
#   bloodmax: <最大生命值>
#   speed: <移动速度，单位：每秒方块数>
#   attack: <攻击伤害>

生物类型1:
  bloodmax: 数值
  speed: 数值
  attack: 数值

生物类型2:
  bloodmax: 数值
  speed: 数值
  attack: 数值

# 以此类推...

参数详解

生物类型（Entity Type）

• 作用: 指定要配置的生物类型
• 格式: 必须使用 Minecraft 中生物的实体类型名称（全部小写）
• 示例: zombie, skeleton, creeper
• 注意: 如果指定的生物类型不存在，插件会忽略该配置

bloodmax（最大生命值）

• 作用: 设置生物的最大生命值
• 格式: 必须是大于0的数值（可以是小数）
• 默认值: Minecraft 原版生物的默认生命值
• 示例: bloodmax: 100.0
• 注意: 设置后，生物会立即拥有满生命值

speed（移动速度）

• 作用: 设置生物的移动速度
• 单位: 每秒方块数
• 格式: 必须是大于等于0的数值（可以是小数）
• 转换关系: 配置文件中的1单位等于Minecraft中的0.1速度单位
• 示例: speed: 2.0（实际在游戏中为0.2速度单位）
• 注意: 速度为0时，生物将无法移动

attack（攻击伤害）

• 作用: 设置生物的基础攻击伤害
• 格式: 必须是大于等于0的数值（可以是小数）
• 默认值: Minecraft 原版生物的默认攻击力
• 示例: attack: 10.0
• 注意: 此数值不包括武器或其他加成的伤害

配置技巧

批量配置相似生物

您可以为具有相似特性的生物设置相同或相近的属性，以保持游戏的一致性：

#  undead类型生物配置
zombie:
  bloodmax: 100.0
  speed: 2.0
  attack: 10.0

drowned:
  bloodmax: 100.0
  speed: 2.5  # 在水中移动更快
  attack: 10.0

husk:
  bloodmax: 100.0
  speed: 2.0
  attack: 10.0

zombie_villager:
  bloodmax: 100.0
  speed: 1.8  # 村民僵尸移动稍慢
  attack: 10.0

渐进式难度调整

您可以根据生物的强度设置渐进式的属性值，创建更有层次感的游戏体验：

# 渐进式难度配置
# 基础生物
zombie:
  bloodmax: 50.0
  speed: 1.5
  attack: 5.0

# 精英生物
zombie_elite:
  bloodmax: 150.0
  speed: 2.5
  attack: 15.0

# 首领生物
zombie_boss:
  bloodmax: 500.0
  speed: 3.0
  attack: 30.0

特殊生物特殊配置

对于具有特殊能力的生物，可以根据其特性调整配置：

# 特殊生物配置
creeper:
  bloodmax: 60.0     # 较低的生命值
  speed: 1.2         # 较慢的移动速度
  attack: 40.0       # 较高的爆炸伤害

enderman:
  bloodmax: 100.0    # 较高的生命值
  speed: 6.0         # 快速移动
  attack: 15.0       # 较高的伤害

spider:
  bloodmax: 70.0
  speed: 4.0         # 快速移动
  attack: 8.0

配置文件验证

在保存配置文件并重载前，可以先检查配置是否存在以下问题：

1. YAML 语法错误: 确保缩进正确，冒号后有空格
2. 数值格式错误: 确保所有数值都是数字格式，没有包含字母或特殊字符
3. 生物类型错误: 确保使用了正确的生物实体类型名称
4. 参数范围错误: 确保 bloodmax 大于0，speed 和 attack 大于等于0

备份和恢复配置

为了防止配置丢失或出现问题，建议定期备份配置文件：

1. 在进行重要修改前，复制当前配置文件并重命名（如 config_backup.yml）
2. 如果新配置出现问题，可以恢复备份文件并使用 /bmreload 命令重新加载

常见问题排查

问题: 修改配置后，生物属性没有变化

解决方案:

1. 确认已保存配置文件
2. 使用 /bmreload 命令重载配置
3. 检查配置文件中是否存在语法错误
4. 确认生物类型名称是否正确
5. 检查数值格式是否正确

问题: 重载配置后游戏出现异常

解决方案:

1. 立即恢复之前的备份配置
2. 重新使用 /bmreload 命令
3. 检查是否有不合理的数值设置（如过大或过小的数值）