Mythical Races Free - 自定义奇幻种族

Mythical Races 是一款允许玩家选择种族的插件，例如精灵、矮人等。每个种族都会赋予玩家独特的属性和药水效果。你还可以添加自定义种族，并为每个种族配置专属的属性和效果，所有操作都通过配置文件完成，无需编程经验。

💡核心特性

• 种族进化树：每个基础种族可拥有多达 53 种进化形态。
• GUI 选择界面：通过图形界面选择种族。
• 情境效果：可根据生物群系、所处方块、Y轴高度、世界、天气或光照等级触发特定效果。
• 自定义升级系统：提供 12 种不同的经验获取与等级提升方式。
• 无限扩展：可以创建任意数量的自定义种族。

🎮默认种族

配置文件中默认包含以下种族

• Elf, Human, Dwarf, Whelp, Dhampir, Demon, Angel
• Slime, Merfolk, Waspling, Dragonborn, Gremlin, Golem

添加自定义种族

你可以通过编辑配置文件轻松添加任意数量的新种族，理论上支持上百个。

🔧命令与权限

所有命令均以 /races 为基础。

玩家命令

• /races choose [race]
• 权限：mythicalraces.race.[race] (例如：mythicalraces.race.Elf)
• /races gui
• 权限：mythicalraces.gui
• /races tree
• 权限：mythicalraces.tree
• /races profile
• 权限：mythicalraces.profile
• /races biome
• 权限：mythicalraces.biome
• /races list
• 权限：mythicalraces.list.races

管理员命令

• /races help
• 权限：mythicalraces.help
• /races info [race]
• 权限：mythicalraces.info.races
• /races profile [player]
• 权限：mythicalraces.profile.other
• /races set {race} {player}
• 权限：mythicalraces.race.setrace (请勿授予普通玩家)
• /races lvlset [player] [level]
• 权限：mythicalraces.lvlset

其他权限

• mythicalraces.cooldown.bypass：绕过选择种族的冷却时间。

✨PlaceholderAPI 变量

• %mythicalraces_race% – 玩家当前种族
• %mythicalraces_display_race_name% – 种族显示名称
• %mythicalraces_cooldown_time% – 剩余冷却时间
• %mythicalraces_has_cooldown% – 是否处于冷却中
• %mythicalraces_get_xp% – 当前经验值
• %mythicalraces_get_level% – 当前等级
• %mythicalraces_get_max_xp% – 升级所需最大经验
• %mythicalraces_get_xp/max_xp% – 经验进度 (当前/最大)

⭐可配置属性与效果

在配置文件中，你可以为种族设置以下类型的增益。

属性类型

• GENERIC_MAX_HEALTH
• GENERIC_KNOCKBACK_RESISTANCE
• GENERIC_MOVEMENT_SPEED
• GENERIC_ATTACK_DAMAGE
• GENERIC_ATTACK_SPEED
• GENERIC_ARMOR
• GENERIC_ARMOR_TOUGHNESS
• GENERIC_LUCK

药水效果类型

• SPEED, SLOW, FAST_DIGGING, SLOW_DIGGING
• INCREASE_DAMAGE, HEAL, HARM, JUMP
• CONFUSION, REGENERATION, DAMAGE_RESISTANCE
• FIRE_RESISTANCE, WATER_BREATHING, INVISIBILITY
• BLINDNESS, NIGHT_VISION, HUNGER, WEAKNESS
• POISON, WITHER, HEALTH_BOOST, ABSORPTION
• SATURATION, GLOWING, LEVITATION, LUCK
• UNLUCK, SLOW_FALLING, CONDUIT_POWER
• DOLPHINS_GRACE, BAD_OMEN, HERO_OF_THE_VILLAGE

❓常见问题与须知

安装与依赖

• 权限插件是必需的：玩家选择种族需要权限节点控制。
• 推荐组合：使用 LuckPerms + Vault 以获得最佳体验。
• 及时更新：请保持插件为最新版本，以获取错误修复和新功能。

支持与版本

• 支持渠道：请勿在评论区内寻求技术支持。如需帮助，请通过 Discord 联系，速度更快：https://discord.gg/GK3rmrze2Q
• 高级版本：本插件提供功能更强大的付费版本 MRPremiumAddons，详情请访问：https://www.spigotmc.org/resources/mrpremiumaddons.102328/

🔧视频教程与展示

• 第一部分：[视频链接]
• 第二部分：[视频链接]
• 第三部分：[视频链接]
• 可选部分（核心机制示例）：[视频链接]

Mythical Races 是一款为 Minecraft 服务器设计的角色扮演插件，允许玩家选择并升级不同的种族，每个种族都拥有独特的日间/夜间被动效果、属性加成和成长系统。通过高度可配置的 YAML 文件，服主可以轻松创建或修改种族，为玩家带来深度的 RPG 体验。

💡核心特性

• 自定义种族系统：创建拥有独特名称、材质、描述和 GUI 位置的种族。
• 动态属性与效果：为每个种族配置基于时间（日/夜）的被动药水效果和实体属性。
• 条件触发效果：效果可根据生物群系、Y轴高度、附近方块、光照等级、天气和世界等复杂条件触发。
• 成长与等级：种族可通过多种活动类型（如奔跑、挖掘、狩猎等）获得经验并升级，属性会随等级成长。
• 子种族系统：支持创建需要达到特定主种族等级才能解锁的子种族。
• 完整的命令与权限：提供选择、查看信息、打开GUI等玩家命令，以及为管理员设置的权限节点。

🎮配置详解

基础种族设置

在配置文件中添加新种族时，请遵循以下结构示例

raceName:
  displayName: '种族显示名'
  material: 'GUI显示材质'
  guiPage: 1
  isSubRace: false
  subRaceType: ''
  treeSlot: 4
  levelRequire: 0
  slot: 11
  lvlType: 'RUNNING'
  maxLevel: 100
  gainXP: 2
  xpPerLevel: 24
  lore:
    - '&4----- &c种族描述标题 &4-----'
    - '&c这里是种族描述'

• lvlType：等级提升类型，可选值包括：
• HUNTING（狩猎）
• RUNNING（奔跑）
• HARVESTING（收割）
• BUILDER（建造）
• FISHING（钓鱼）
• EXCAVATION（挖掘）
• MINER（采矿）
• WOODCUTTER（伐木）
• TANKER（坦克）
• SWIMMING（游泳）
• FLYING（飞行）
• DIGGER（挖掘者）
• ARCHER（弓箭手）

属性与效果类型

• 可配置的实体属性：
• GENERIC_MAX_HEALTH（最大生命值）
• GENERIC_KNOCKBACK_RESISTANCE（击退抗性）
• GENERIC_MOVEMENT_SPEED（移动速度）
• GENERIC_ATTACK_DAMAGE（攻击伤害）
• GENERIC_ATTACK_SPEED（攻击速度）
• GENERIC_ARMOR（护甲值）
• GENERIC_ARMOR_TOUGHNESS（护甲韧性）
• GENERIC_LUCK（幸运值）

• 可配置的药水效果：
• 包括 SPEED, SLOW, JUMP, REGENERATION, NIGHT_VISION, WATER_BREATHING, INVISIBILITY 等所有标准及部分特殊效果（如 DOLPHINS_GRACE, CONDUIT_POWER）。

条件效果数据格式

效果触发条件通过 dayRaceDataPotion 或 nightRaceDataAttribute 等字段设置，格式如下：

'ALL Y > -1000 -1 ALL ALL ALL ALL'

参数含义（按空格分隔）

• 生物群系：ALL 表示全部，或用逗号分隔特定群系名（如 SAVANNA,PLAINS）。
• 固定标识：必须为 Y。
• 高度比较符：> 或 >=。
• 比较高度值：整数。
• 效果放大器：注意：实际等级 = 配置值 + 1。例如，配置 0 对应游戏内效果等级 I。
• 附近方块检测模式：ALL（任意位置）、ABOVE（上方）、MID（同层）、BELOW（下方）、AROUND（周围）。
• 检测的方块列表：ALL 或逗号分隔的材质名（如 STONE,GRASS_BLOCK）。
• 天气条件：TRUE（仅雷雨）、FALSE（仅晴天）、ALL（所有天气）。
• 世界名称：ALL 或逗号分隔的世界名（如 world,world_nether）。

特殊检测模式

• VAMPIRE：检测玩家上方直至天空是否没有固体方块遮挡。
• CUSTOM[num]：检测周围指定半径（num）内是否存在指定方块。例如：CUSTOM10 STONE。
• LIGHTA[num]：检测光照等级高于指定值（0-14）时触发。例如：LIGHTA6。
• LIGHTB[num]：检测光照等级低于指定值（0-14）时触发。例如：LIGHTB6。

🔧命令与权限

玩家命令

• /races choose [race] - 选择一个种族。
• /races help - 查看帮助。
• /races info [race] - 查看某个种族的详细信息。
• /races gui - 打开种族选择GUI。
• /races tree - 查看种族树。
• /races profile - 查看自己的种族信息。

管理员命令

• /races set {race} {player} - 为指定玩家设置种族。

权限节点

• mythicalraces.race.[race] - 允许玩家选择特定种族（例如：mythicalraces.race.Elf）。
• mythicalraces.help - 允许使用 /races help。
• mythicalraces.info.races - 允许使用 /races info。
• mythicalraces.gui - 允许使用 /races gui。
• mythicalraces.tree - 允许使用 /races tree。
• mythicalraces.profile - 允许使用 /races profile。
• mythicalraces.race.setrace - 慎用：允许使用设置种族的管理命令。
• mythicalraces.cooldown.bypass - 绕过选择种族的冷却时间。

使用 LuckPerms 分配权限示例

/lp group default permission set mythicalraces.race.Elf true
/lp group default permission set mythicalraces.race.Dwarf true
/lp group default permission set mythicalraces.gui true

✨重要提示与资源

• 缩进：配置时必须使用空格缩进，切勿使用 Tab 键。
• 效果等级：配置药水效果放大器时，填写值 = 游戏内显示等级 - 1。
• 经验平衡：对于 EXCAVATION、BUILDER、HUNTING 和 HARVESTING 这类容易快速获得经验的升级类型，建议将 xpPerLevel 设置得较高以保持平衡。
• 子种族等级：确保主种族的 maxLevel 不低于其子种族所需的 levelRequire。

实用链接

• 生物群系列表：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/block/Biome.html
• 方块材质列表：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
• 配置教程视频：
• 主要教程：https://youtu.be/Kb7Jn-EHj00
• 第二教程：https://www.youtube.com/watch?v=blx4iUlyqMI

获取帮助

如果遇到添加、编辑或移除种族的问题，可以加入支持 Discord 服务器并联系 Korbsti（Korbsti#0001）。

• 支持 Discord：https://discord.gg/GK3rmrze2Q