Vulire Skill Mod v1.3.2

概述

Vulire Skill Mod 是一套适用于 Minecraft 1.20.1 的综合技能系统，新增了21 种独特技能，分为 5 个类别，带来数百小时以成长进阶为核心的游戏内容。该模组通过加入有意义的角色成长、社交功能和富有挑战性的目标，改变 Minecraft 的游戏体验。

主要特色

21 种技能，等级上限为 99，并采用平衡的经验值成长曲线
坐骑系统 – 按实体分别为马和船升级；骑乘可获得经验值和属性加成
数据驱动的配置系统 – 通过 JSON 文件完全自定义技能
多技能需求 – 高级物品可能要求满足多项技能条件（如攻击 + 力量等）
精美 GUI，包含羊皮纸风格的技能书和技能图标
高级氏族系统，基于能力系统持久保存数据，支持阶级、聊天频道、联盟和战争
经验灯系统，提供 8 种灯（500–100,000 点经验值），并通过命令使用
完善的成就系统，包含 100 多项成就和区域日志
猎杀系统，包含 200 多种任务模板，并可自动生成任务
精通加成，面向等级达到 90 级及以上的玩家，提供伤害、效率和掉落率加成
高级配置，支持按技能设置经验值倍率、战斗成长曲线和精通选项
祈祷增益，提供神圣庇护和经验值加成
性能优化，采用缓存系统并提升安全性
开发者 API，支持与模组进行全面集成

技术信息

模组详情

模组 ID：vulireskillmod
版本：1.3.2
Minecraft 版本：1.20.1
Forge 版本：47.4.0
Java 版本：17+
许可证：保留所有权利

依赖项

Minecraft：1.20.1
Forge：47.4.4 或更高版本
Java：17 或更高版本

技能系统

战斗技能（5 种）

攻击 🗡️ – 近战武器效果和工具需求
力量 💪 – 提高近战伤害
防御 🛡️ – 护甲效果和伤害减免
生命值 ❤️ – 提升生命值和生命恢复
远程 🏹 – 提升弓和弩的效果

采集技能（5 种）

采矿 ⛏️ – 矿石开采和地下探索
伐木 🪓 – 砍伐树木和木材加工
挖掘 ⛏️ – 挖掘和开采软质材料
钓鱼 🎣 – 采集水生资源
耕种 🌾 – 农业发展和作物管理

工匠技能（6 种）

烹饪 🍳 – 食物准备和强化
制箭 🏹 – 弓箭制作
生火 🔥 – 火相关活动和熔炉效率
制作 🔨 – 通用物品制作和工具制造
锻造 ⚒️ – 金属加工以及武器和护甲制作
建造 🏗️ – 建筑和工程项目

辅助技能（5 种）

敏捷 🏃 – 改善移动能力和障碍穿越
草药学 🧪 – 药水酿造和炼金强化
盗窃 🥷 – 潜行活动和资源获取
猎杀 ⚔️ – 猎杀怪物和完成任务
祈祷 🙏 – 神圣庇护和灵性强化

坐骑系统

马匹和船只升级

坐骑系统允许单匹马和船作为实体升级，通过被骑乘和使用获得经验值和属性加成。

马匹升级 🐎

经验来源：
- 被动骑乘：移动时每100刻获得15点经验（最小移动距离1格）
- 高速移动：速度≥0.5格/刻时每80刻获得25点经验
等级进度：马匹从1级升至50级，经验需求呈二次增长（100 + 等级² × 25）
等级加成：
- 速度加成：每级+1%移动速度（可配置，默认0.01 = 1%）
- 生命加成：每级+1点生命值（可配置，默认1.0点生命值 = 0.5颗心）
视觉指示：骑乘时马匹上方显示等级和经验值

船只升级 ⛵

经验来源：
- 被动骑乘：移动时每100刻获得15点经验（最小移动距离1格）
- 高速移动：速度≥0.5格/刻时每80刻获得25点经验
- 距离航行：在水面上每航行50格获得30点经验
等级进度：船只从1级升至50级，经验需求呈二次增长
等级加成：
- 速度加成：每级+5%水上速度（可配置，默认0.05 = 5%）
持久化：船只可被拾取（潜行+右键），其等级在物品形态下得以保留
视觉指示：骑乘时船只上方显示等级和经验值

坐骑特性

逐实体进度：每匹马和每艘船独立升级
实时经验显示：动作栏显示经验获取和当前等级/经验进度
升级通知：坐骑达到新等级时显示特殊消息
配置：所有经验速率和加成均可在服务器设置中完全配置
多人游戏支持：坐骑进度在多人游戏环境中正常工作

数据驱动配置系统

概述

Vulire Skill Mod v1.2.8 引入了全面的数据驱动配置系统，允许服务器管理员通过 JSON 文件自定义技能系统的各个方面。

主要优势

单一数据源：所有技能数据集中存放在易于编辑的 JSON 文件中
服务器自定义：管理员可以调整经验值、等级需求和技能进度
模组兼容性：通过简单的 JSON 配置即可轻松与其他模组集成
版本控制友好：更改隔离在特定的技能文件中
无需修改代码：无需触碰 Java 代码即可完全自定义

配置文件

位于data/vulireskillmod/skills/：

基于方块的技能（采矿、伐木、农耕、建造）

{
  "skill": "mining",
  "description": "The art of extracting ore and minerals from the earth",
  "blocks": {
    "minecraft:stone": { "xp": 3, "level_required": 1 },
    "minecraft:coal_ore": { "xp": 17, "level_required": 10 },
    "minecraft:iron_ore": { "xp": 35, "level_required": 15 },
    "minecraft:diamond_ore": { "xp": 100, "level_required": 50 }
  }
}

基于物品的技能（合成、锻造、烹饪、制箭）

{
  "skill": "crafting",
  "description": "Creating items from raw materials",
  "items": {
    "minecraft:planks": { "xp": 5, "level_required": 1 },
    "minecraft:stick": { "xp": 2, "level_required": 1 },
    "minecraft:chest": { "xp": 25, "level_required": 15 }
  }
}

基于实体的技能（战斗、杀戮）

{
  "skill": "combat",
  "description": "Combat training and monster hunting",
  "entities": {
    "minecraft:zombie": { "xp": 25, "level_required": 1 },
    "minecraft:skeleton": { "xp": 30, "level_required": 5 },
    "minecraft:ender_dragon": { "xp": 500, "level_required": 80 }
  }
}

基于装备的技能（战斗、祈祷等）

{
  "skill": "combat",
  "description": "Combat training and weapon mastery",
  "weapons": {
    "minecraft:wooden_sword": {
      "requirements": {
        "attack": 1
      },
      "damage_bonus": 0,
      "rarity": "common"
    },
    "minecraft:diamond_sword": {
      "requirements": {
        "attack": 40,
        "strength": 30
      },
      "damage_bonus": 2.0,
      "rarity": "rare"
    },
    "minecraft:netherite_sword": {
      "requirements": {
        "attack": 60,
        "strength": 50,
        "hitpoints": 40
      },
      "damage_bonus": 3.0,
      "rarity": "legendary"
    }
  }
}

工具与装备要求

{
  "tools": {
    "minecraft:iron_pickaxe": { "level_required": 10 },
    "minecraft:diamond_pickaxe": { "level_required": 30 },
    "minecraft:netherite_pickaxe": { "level_required": 75 }
  },
  "equipment": {
    "minecraft:iron_sword": { "level_required": 10 },
    "minecraft:diamond_sword": { "level_required": 30 }
  }
}

标签支持

该系统支持使用 Minecraft 标签对多个物品/方块进行分组：

{
  "tags": {
    "#minecraft:logs": { "xp": 25, "level_required": 1 },
    "#forge:ores": { "xp": 35, "level_required": 15 }
  }
}

多技能要求

最强大的功能之一，是能够为物品、方块和装备设置多个技能要求。这会形成贴近实际的进度门槛，让高级物品需要掌握多种技能。

多技能要求的工作方式

必须满足所有要求 – 玩家需要满足每一项技能要求才能使用该物品
灵活组合 – 可任意混合技能（攻击 + 力量、采矿 + 建造等）
渐进难度 – 更高阶的物品需要更多技能达到更高等级
贴近实际的进度 – 高级武器需要兼具进攻与防御技能

多技能要求示例

高级武器：

{
  "weapons": {
    "minecraft:diamond_sword": {
      "requirements": {
        "attack": 40,
        "strength": 30
      }
    },
    "minecraft:netherite_sword": {
      "requirements": {
        "attack": 60,
        "strength": 50,
        "hitpoints": 40
      }
    }
  }
}

专用工具：

{
  "tools": {
    "modded:master_drill": {
      "requirements": {
        "mining": 80,
        "smithing": 70,
        "construction": 60
      }
    }
  }
}

高级方块：

{
  "blocks": {
    "modded:reinforced_obsidian": {
      "requirements": {
        "mining": 85,
        "smithing": 75
      }
    }
  }
}

常见的多技能组合

战斗装备：攻击 + 力量 + 生命值
高级工具：主技能 + 锻造 + 建造
魔法物品：祈祷 + 草药学 + 制作
专用装备：多种战斗技能 + 相关辅助技能

对服务器管理员的好处

贴近实际的进度：高级物品需要全面发展的人物
技能平衡：鼓励玩家发展多种技能
服务器自定义：创建独特的进度路线
模组集成：非常适合需要多种技能的模组物品

自定义示例

调整经验值获取速率：提高经验值，让采矿更有回报
更改等级要求：降低要求，让成长更轻松
添加模组内容：添加其他模组的物品 ID
平衡技能：单独微调各项技能，不影响其他技能
创建自定义成长曲线：为你的服务器设计独特的经验值曲线

氏族系统

核心功能

基于能力的存储：使用 Minecraft 的能力系统，可靠地持久保存数据
多级等级体系：拥有者、副手、将军、中士、下士、新兵
权限系统：精细控制氏族成员的操作权限
创建氏族：使用自定义名称和标签创建氏族

交流系统

氏族聊天（/cc <message>）：氏族成员通用交流
军官聊天（/oc <message>）：仅供领导层交流
首领聊天（/lc <message>）：仅限拥有者和副手交流
聊天格式：根据等级设置聊天前缀和颜色

外交功能

联盟系统：与其他氏族结盟
宣战：宣战以进行竞技对抗
中立关系：与其他氏族保持中立关系
外交命令：通过命令管理氏族关系

成就系统

成就类别

技能成就：所有技能的等级里程碑
战斗成就：猎杀怪物和挑战 Boss
屠戮成就：完成任务的里程碑
综合成就：采矿、合成和探索目标

成就日记

按区域划分的成就合集，设有不同难度等级：

简单任务：基础技能要求和简单目标
中等任务：需要投入精力才能达成的进阶目标
困难任务：需要技巧才能完成的挑战性目标
精英任务：献给专注玩家的大师级成就

经验值灯系统

可用的经验值灯

500 经验值灯：适用于早期成就的基础灯
1000 经验值灯：简单成就的常见奖励
2500 经验值灯：中等成就奖励
5000 经验值灯：困难成就的丰厚经验值奖励
10000 经验值灯：精英成就的重大经验值奖励
25000 经验值灯：稀有的高价值经验值灯
50000 经验值灯：完成重大成就的卓越奖励
100000 经验值灯：最具挑战性成就的终极经验值灯

使用方法

使用 /xplamp <skillname> 命令，将物品栏中的经验值灯用于任意技能。

配置

服务器配置

位于 config/vulireskillmod-server.toml

经验值倍率

global_xp_multiplier：全局经验值倍率（1.0 = 正常）
combat_xp_multiplier：战斗技能倍率
mining_xp_multiplier：采矿技能倍率
woodcutting_xp_multiplier：伐木技能倍率
fishing_xp_multiplier：钓鱼技能倍率
farming_xp_multiplier：耕作技能倍率
crafting_xp_multiplier：合成技能倍率
cooking_xp_multiplier：烹饪技能倍率
smithing_xp_multiplier：锻造技能倍率
construction_xp_multiplier：建筑技能倍率

精通加成

mastery_damage_bonus：精通等级战斗技能的伤害加成
mastery_efficiency_bonus：精通等级采集技能的效率加成
mastery_rare_drop_bonus：精通等级技能的稀有掉落几率加成
mastery_level_requirement：获得精通加成所需的等级（默认：90）

祈祷系统

prayer_xp_bonus_start_level：祈祷经验加成的起始等级（默认：30）
prayer_xp_bonus_per_level：每级祈祷等级提供的经验加成（默认：0.002）
prayer_xp_bonus_max：祈祷提供的最大经验加成（默认：0.14）

安装

要求

Minecraft：1.20.1
Forge：47.4.0 或更高版本
Java：17 或更高版本

步骤

从发布页面下载最新版本
将 .jar 文件放入 mods 文件夹
使用 Forge 配置文件启动 Minecraft
模组将在首次运行时自动生成配置文件

服务器安装

在客户端和服务器端都安装此模组
在 config/vulireskillmod-server.toml 中配置设置
重启服务器以应用更改

命令

玩家命令

/skills – 打开技能书界面
/skill <skillname> – 查看指定技能的详情
/skilltop <skillname> – 查看技能排行榜
/xplamp <skillname> – 对指定技能使用经验灯
/clan help – 查看氏族命令帮助
/achievements – 查看成就进度

氏族命令

/clan create <name> – 创建新氏族
/clan disband – 解散你的氏族（仅限所有者）
/clan info [clanName] – 查看氏族信息
/clan leave – 离开当前氏族
/clan list – 列出服务器上的所有氏族
/clan invite <player> – 邀请玩家加入你的氏族
/clan accept – 接受氏族邀请
/clan deny – 拒绝氏族邀请
/clan kick <player> – 将玩家移出氏族
/clan promote <player> – 提升氏族成员的职级
/clan demote <player> – 降低氏族成员的职级
/cc <message> – 在氏族聊天中发送消息
/oc <message> – 在军官聊天中发送消息（军士及以上职级）
/lc <message> – 在首领聊天中发送消息（副首领及以上职级）

管理员命令

/skillmod reload – 重新加载配置文件
/skillmod backup <player> – 备份玩家技能数据
/skillmod restore <player> – 恢复玩家技能数据
/skillmod setlevel <player> <skill> <level> – 设置玩家技能等级
/skillmod addxp <player> <skill> <amount> – 为玩家技能增加经验
/skillmod reset <player> [skill] – 重置玩家技能
/skills test bonuses – 运行自动化技能加成验证

API 文档

面向模组开发者

Vulire Skill Mod 提供了全面的 API，可用于与其他模组集成。

技能 API (ISkillAPI)

// Get player skill level
int level = VulireSkillAPI.getSkillLevel(player, Skill.MINING);

// Add experience with validation
boolean leveledUp = VulireSkillAPI.addExperience(player, Skill.CRAFTING, 100);

// Check skill requirements
boolean hasLevel = VulireSkillAPI.hasLevel(player, Skill.SMITHING, 50);

氏族 API (IClanAPI)

// Get player clan
Clan clan = VulireSkillAPI.getPlayerClan(player);

// Check permissions
boolean canInvite = VulireSkillAPI.hasPermission(player, ClanPermission.INVITE_MEMBERS);

Achievement API (IAchievementAPI)

// Award achievement
VulireSkillAPI.awardAchievement(player, AchievementType.FIRST_LEVEL_50);

// Check completion
boolean completed = VulireSkillAPI.hasAchievement(player, achievement);

开发

开发环境

IDE：推荐使用 IntelliJ IDEA
JDK：Java 17+
Gradle：8.8+
映射：官方 Mojang 映射
测试包含自动化测试套件

版本历史

v1.3.2

新增在聊天栏显示解锁内容的功能（客户端）
修复了伐木不会获得 XP 的问题
修复了部族界面在小屏幕上显示异常的问题

v1.3.1

修复了服务器重启时发放 XP 灯的问题
修复了建筑技能未将已保存方块奖励给玩家的问题

v1.3.0

修复了装备要求达到采集等级才能攻击的问题
修复了装备要求达到攻击等级才能采集的问题
修复了服务器启动时未生成全部数据包文件的问题
将所有配置设置移至数据包
性能优化
更新等级要求

v1.2.9

修复了屠戮之书的界面问题

v1.2.8

新增：坐骑系统 – 每种生物的马匹和船只均可通过骑乘获得 XP 并提升等级，还能获得属性加成
新增：挖掘技能 – 通过使用铲子的相关活动，挖掘和开采柔软材料
新增：数据驱动配置系统 – 通过 JSON 文件全面自定义技能
高级配置选项
性能优化

v1.2.7

已修复物品复制漏洞
全新的部族界面
为技能书和屠戮之书添加快捷键（J 和 K 键）
服务器端部族银行栏位配置

v1.2.6

/clan 现在会打开部族 GUI
XP 灯现在拥有 GUI

v1.2.5

全面重制部族系统，采用基于能力的持久化机制
完善的 XP 灯系统（8 种）
通过日记增强成就系统
高级配置选项
精通加成系统
性能优化
取消屠戮任务
新增关闭加成消息的选项

v1.2.4

在技能法典中添加技能图标
更新服务器 TOML 配置，以启用/禁用技能

性能优化

性能更新
修复了 XP 灯成就相关问题

v1.2.0

大幅升级屠戮系统（200 多项任务）

v1.1.7

当前版本，包含 19 种技能及丰富功能

v1.1.6

新增祈祷增益并扩展屠戮任务

v1.1.5

引入部族系统与成就

v1.1.4

核心技能系统与基础功能

更早版本

开发与测试阶段

鸣谢

开发团队

Nyhr – 首席开发者兼创作者

特别感谢

Minecraft Forge 团队 – 框架与开发工具
Mojang Studios – Minecraft 基础游戏
社区贡献者 – 测试、反馈与建议
Doleman – 感谢你允许我使用你的服务器和社区来进行测试，也感谢你对未来功能提出的宝贵见解
CallOfMage 社区 – 感谢大家参与游戏测试并提供反馈
karasunezumi – 数据包建议
spake404 – 技能书和屠戮之书快捷键建议
*HoodSimba – 升级后显示解锁消息的建议

许可证

感谢使用 Vulire Skill Mod！希望你能享受这段经过增强的 Minecraft 体验：有意义的成长进度、社交功能，以及引人入胜的挑战。

截图

介绍