- 版权类型
- 原创
- 插件中文名称
- VC-Forge
- 插件英文名称
- VC-Forge
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- 语言支持
- 中文（简体）
- 前置组件
- [硬前置]Vault
[硬前置]PlaceholderAPI
[软前置]DragonCore
- 适配版本（Java）
- 1.12
# VC-Forge —— 高度自定义锻造系统，品质、强度、随机属性与多插件联动 [1.12.2]
# QQ交流群：1040990615
## 插件简介
VC-Forge 是一款面向 RPG 服务器的配置驱动锻造插件，支持从基础材料消耗到装备成品生成的完整锻造流程。
插件适合副本装备、职业装备、套装收集、随机词条和长期养成玩法。所有锻造内容均可通过配置扩展，服主可以自由设计属于自己的装备成长体系。
## 插件特色
### 高度自由的锻造配置
- 图纸、材料、金币、成功率、锻造时间均可自由配置。
- 支持一个文件配置一件装备，也支持一个文件配置整套装备。
- 支持每个部位独立配置，主手、副手、防具和饰品互不影响。
- 配置文件数量和图纸数量不设固定上限。
- 支持多种图纸分类，方便管理不同副本、职业和装备套装。
### 多品质装备体系
- 支持普通、优秀、稀有、史诗、圣器等任意数量的品质。
- 每种品质可以独立设置名称、颜色、权重和属性数值区间。
- 品质越高，可以拥有更高的属性上限或不同的随机词条组合。
- 品质重铸可以让玩家围绕同一件装备持续培养。
### 强度系统
- 装备强度范围为 0%-100%。
- 强度 0% 获取当前品质的最低数值。
- 强度 100% 获取当前品质的最高数值。
- 中间强度按照区间自动计算实际属性。
- 支持强度进度条、进度颜色和百分比显示。
- 支持强度校准，让玩家逐步提升装备价值。
例如属性区间为 100-300：
| 强度 | 属性数值 |
| --- | ---: |
| 0% | 100 |
| 50% | 200 |
| 100% | 300 |
### 随机属性与随机 Lore
- 支持通过 RandomItem 生成随机品质和随机属性。
- 每种品质可以使用独立的属性池和数值范围。
- 支持属性权重、词条权重和互斥组。
- 随机数值最多保留一位小数，可以生成 `1.5`、`5.9` 等数值。
- 随机属性只写入物品名称和 Lore，显示直观，兼容性更好。
- 不强制写入 AttributesProperty NBT，不改变其他属性插件的数据结构。
### 原版 GUI 与 DragonCore 自定义 GUI
- 支持无需客户端资源包的原版 Inventory GUI。
- 支持 DragonCore EasyGUI 自定义界面。
- 主页面、图纸页面、锻造队列页面和成功领取页面可以独立配置。
- 可以自由调整背景、按钮、文字、容器位置和界面布局。
- DragonCore 不可用时自动回退到原版 GUI。
### 完整的锻造流程
- 图纸展示与分类浏览。
- 材料放入与材料识别。
- 材料不足提示。
- 锻造成功、失败和队列状态提示。
- 延迟锻造与锻造队列。
- 锻造成功后自动领取成品。
- 支持图纸学习、锻造等级、玩家等级和图纸熟练度。
### 多种物品库适配
支持通过原版物品、名称、Lore 或外部插件物品 ID 识别材料和成品，并可适配多种常见物品库。
适合用于原版物品、MythicMobs、MMOItems、SX-Attribute、NeigeItems、OptiItems 等装备体系。
### 套装与装备构筑联动
- 支持与 VC-Suit 联动。
- 每件成品可以写入独立套装 ID 和部位 ID。
- 开启唯一部位识别后，重复装备同一部位不能用于凑套装数量。
- 主手、副手、防具和饰品可以分别属于不同套装或同一套装的不同部位。
- 支持宝石孔、普通词条孔和 BD 特化孔分开配置。
### 金币、材料返还与邮箱保护
- 支持通过 Vault 扣除锻造、校准、重铸和分解费用。
- 锻造失败可以按照配置返还不同材料。
- 装备分解后可以返还指定材料。
- 背包空间不足时，成品和返还材料可以自动发送到 VC-Mail。
- 玩家下线、切换 BC 子服或服务器异常时，托管中的材料不会直接消失。
- JSON 和 MySQL 均支持保存玩家进度与延迟锻造任务。
- 多服环境可以使用 MySQL 共享玩家锻造数据。
### 条件表达式与执行动作
- 支持权限、世界、玩家等级、锻造等级和熟练度条件。
- 支持 PlaceholderAPI 条件。
- 支持数值表达式、布尔表达式、比较运算和逻辑运算。
- 支持锻造成功、失败后的消息、声音、指令、经验、熟练度和奖励动作。
- 可以根据不同条件设计复杂的锻造玩法和服务器活动。
### 管理员工具
- 管理员可以直接发放图纸。
- 支持直接获取指定品质的成品。
- 支持直接指定成品强度，例如 0%、50% 或 100%。
- 方便测试装备数值、检查 Lore、验证套装和洗练联动。
## 配置展示
下面是一份“单个部位、单张图纸”的简化示例，可以直观看到 VC-Forge 的配置自由度：
```yaml
# 文件名：recipes/c1_sword_off.yml
display: '&b裂骨残锋剑'
category: 'C1/剑'
# 锻造等级、玩家等级和锻造成功后的经验。
forge-level: 1
player-level: 20
forge-exp: 10
# 锻造费用：金币和材料可以同时配置。
forge-cost:
money: 25000
materials:
material-a:
type: material
material: PAPER
name: '&fMG_MAT_C01_A'
amount: 288
# 普通宝石孔、普通洗练词条孔和 BD 特化孔分开计算。
sockets:
gem-slots: 1
reroll-slots: 2
special:
bd-gem-slots: 0
bd-core-slots: 0
output:
type: material
material: DIAMOND_SWORD
name: '{quality_color}{quality_display} &f裂骨残锋剑'
lore:
- '&7品质：{quality_color}{quality_display}'
- '&7强度：{strength_bar} {strength_display}'
- '&7攻击力：&f{physical_damage}'
- '{random_lores}'
# 每个品质都可以拥有独立权重和属性区间。
random-attributes:
enabled: true
apply-quality-multiplier: false
qualities:
common:
weight: 60
color: '&f'
display: '普通'
entries:
physical_damage:
min: 100
max: 300
lore: '&f攻击力：+{value}'
rare:
weight: 10
color: '&b'
display: '稀有'
entries:
physical_damage:
min: 180
max: 500
lore: '&b攻击力：+{value}'
```
同一张图纸可以继续增加更多品质、属性、材料、条件和执行动作；也可以把每个部位拆成独立文件，方便长期维护。
## 指令展示
### 玩家指令
| 指令 | 权限 | 作用 |
| --- | --- | --- |
| `/vcforge` | `vcforge.use` | 打开锻造图纸列表 |
| `/vcforge open <图纸ID>` | `vcforge.use` | 打开指定图纸 |
| `/vcforge category <分类>` | `vcforge.use` | 打开指定锻造分类 |
| `/vcforge queue` | `vcforge.use` | 查看锻造队列 |
| `/vcforge learn <图纸ID>` | `vcforge.use` | 学习指定图纸 |
| `/vcforge level` | `vcforge.use` | 查看锻造等级和经验 |
| `/vcforge calibrate` | `vcforge.use` | 校准主手装备强度 |
| `/vcforge reforge` | `vcforge.use` | 重铸主手装备品质 |
| `/vcforge dismantle` | `vcforge.use` | 分解主手锻造装备 |
### 管理员指令
| 指令 | 权限 | 作用 |
| --- | --- | --- |
| `/vcforge reload` | `vcforge.admin` | 重载配置和图纸 |
| `/vcforge give <玩家> <图纸ID> [数量]` | `vcforge.admin` | 发放锻造图纸 |
| `/vcforge give-quality <玩家> <图纸ID> <品质> <强度> [数量]` | `vcforge.admin` | 发放指定品质和强度的成品 |
管理员发放指定成品示例：
```text
/vcforge give-quality Steve c1_sword_main rare 80 1
```
其中强度范围为 `0-100`，品质必须使用图纸中已经配置的品质 ID。
## 适用场景
- RPG 服务器装备锻造系统。
- 副本装备和职业套装制作。
- 随机品质、随机词条和装备毕业玩法。
- 强度校准、品质重铸和装备分解玩法。
- DragonCore 自定义装备界面。
- 多服 BC 网络的共享锻造进度。
- 需要与套装、洗练、BD 和邮箱插件联动的综合 RPG 服务器。
## 交流群
# QQ交流群：1040990615
欢迎加入交流群交流锻造玩法、装备构筑、随机属性、洗练词条、DragonCore UI 和插件联动配置。
# QQ交流群：1040990615
## 插件简介
VC-Forge 是一款面向 RPG 服务器的配置驱动锻造插件，支持从基础材料消耗到装备成品生成的完整锻造流程。
插件适合副本装备、职业装备、套装收集、随机词条和长期养成玩法。所有锻造内容均可通过配置扩展，服主可以自由设计属于自己的装备成长体系。
## 插件特色
### 高度自由的锻造配置
- 图纸、材料、金币、成功率、锻造时间均可自由配置。
- 支持一个文件配置一件装备，也支持一个文件配置整套装备。
- 支持每个部位独立配置，主手、副手、防具和饰品互不影响。
- 配置文件数量和图纸数量不设固定上限。
- 支持多种图纸分类，方便管理不同副本、职业和装备套装。
### 多品质装备体系
- 支持普通、优秀、稀有、史诗、圣器等任意数量的品质。
- 每种品质可以独立设置名称、颜色、权重和属性数值区间。
- 品质越高，可以拥有更高的属性上限或不同的随机词条组合。
- 品质重铸可以让玩家围绕同一件装备持续培养。
### 强度系统
- 装备强度范围为 0%-100%。
- 强度 0% 获取当前品质的最低数值。
- 强度 100% 获取当前品质的最高数值。
- 中间强度按照区间自动计算实际属性。
- 支持强度进度条、进度颜色和百分比显示。
- 支持强度校准，让玩家逐步提升装备价值。
例如属性区间为 100-300：
| 强度 | 属性数值 |
| --- | ---: |
| 0% | 100 |
| 50% | 200 |
| 100% | 300 |
### 随机属性与随机 Lore
- 支持通过 RandomItem 生成随机品质和随机属性。
- 每种品质可以使用独立的属性池和数值范围。
- 支持属性权重、词条权重和互斥组。
- 随机数值最多保留一位小数，可以生成 `1.5`、`5.9` 等数值。
- 随机属性只写入物品名称和 Lore，显示直观，兼容性更好。
- 不强制写入 AttributesProperty NBT，不改变其他属性插件的数据结构。
### 原版 GUI 与 DragonCore 自定义 GUI
- 支持无需客户端资源包的原版 Inventory GUI。
- 支持 DragonCore EasyGUI 自定义界面。
- 主页面、图纸页面、锻造队列页面和成功领取页面可以独立配置。
- 可以自由调整背景、按钮、文字、容器位置和界面布局。
- DragonCore 不可用时自动回退到原版 GUI。
### 完整的锻造流程
- 图纸展示与分类浏览。
- 材料放入与材料识别。
- 材料不足提示。
- 锻造成功、失败和队列状态提示。
- 延迟锻造与锻造队列。
- 锻造成功后自动领取成品。
- 支持图纸学习、锻造等级、玩家等级和图纸熟练度。
### 多种物品库适配
支持通过原版物品、名称、Lore 或外部插件物品 ID 识别材料和成品，并可适配多种常见物品库。
适合用于原版物品、MythicMobs、MMOItems、SX-Attribute、NeigeItems、OptiItems 等装备体系。
### 套装与装备构筑联动
- 支持与 VC-Suit 联动。
- 每件成品可以写入独立套装 ID 和部位 ID。
- 开启唯一部位识别后，重复装备同一部位不能用于凑套装数量。
- 主手、副手、防具和饰品可以分别属于不同套装或同一套装的不同部位。
- 支持宝石孔、普通词条孔和 BD 特化孔分开配置。
### 金币、材料返还与邮箱保护
- 支持通过 Vault 扣除锻造、校准、重铸和分解费用。
- 锻造失败可以按照配置返还不同材料。
- 装备分解后可以返还指定材料。
- 背包空间不足时，成品和返还材料可以自动发送到 VC-Mail。
- 玩家下线、切换 BC 子服或服务器异常时，托管中的材料不会直接消失。
- JSON 和 MySQL 均支持保存玩家进度与延迟锻造任务。
- 多服环境可以使用 MySQL 共享玩家锻造数据。
### 条件表达式与执行动作
- 支持权限、世界、玩家等级、锻造等级和熟练度条件。
- 支持 PlaceholderAPI 条件。
- 支持数值表达式、布尔表达式、比较运算和逻辑运算。
- 支持锻造成功、失败后的消息、声音、指令、经验、熟练度和奖励动作。
- 可以根据不同条件设计复杂的锻造玩法和服务器活动。
### 管理员工具
- 管理员可以直接发放图纸。
- 支持直接获取指定品质的成品。
- 支持直接指定成品强度，例如 0%、50% 或 100%。
- 方便测试装备数值、检查 Lore、验证套装和洗练联动。
## 配置展示
下面是一份“单个部位、单张图纸”的简化示例，可以直观看到 VC-Forge 的配置自由度：
```yaml
# 文件名：recipes/c1_sword_off.yml
display: '&b裂骨残锋剑'
category: 'C1/剑'
# 锻造等级、玩家等级和锻造成功后的经验。
forge-level: 1
player-level: 20
forge-exp: 10
# 锻造费用：金币和材料可以同时配置。
forge-cost:
money: 25000
materials:
material-a:
type: material
material: PAPER
name: '&fMG_MAT_C01_A'
amount: 288
# 普通宝石孔、普通洗练词条孔和 BD 特化孔分开计算。
sockets:
gem-slots: 1
reroll-slots: 2
special:
bd-gem-slots: 0
bd-core-slots: 0
output:
type: material
material: DIAMOND_SWORD
name: '{quality_color}{quality_display} &f裂骨残锋剑'
lore:
- '&7品质：{quality_color}{quality_display}'
- '&7强度：{strength_bar} {strength_display}'
- '&7攻击力：&f{physical_damage}'
- '{random_lores}'
# 每个品质都可以拥有独立权重和属性区间。
random-attributes:
enabled: true
apply-quality-multiplier: false
qualities:
common:
weight: 60
color: '&f'
display: '普通'
entries:
physical_damage:
min: 100
max: 300
lore: '&f攻击力：+{value}'
rare:
weight: 10
color: '&b'
display: '稀有'
entries:
physical_damage:
min: 180
max: 500
lore: '&b攻击力：+{value}'
```
同一张图纸可以继续增加更多品质、属性、材料、条件和执行动作；也可以把每个部位拆成独立文件，方便长期维护。
## 指令展示
### 玩家指令
| 指令 | 权限 | 作用 |
| --- | --- | --- |
| `/vcforge` | `vcforge.use` | 打开锻造图纸列表 |
| `/vcforge open <图纸ID>` | `vcforge.use` | 打开指定图纸 |
| `/vcforge category <分类>` | `vcforge.use` | 打开指定锻造分类 |
| `/vcforge queue` | `vcforge.use` | 查看锻造队列 |
| `/vcforge learn <图纸ID>` | `vcforge.use` | 学习指定图纸 |
| `/vcforge level` | `vcforge.use` | 查看锻造等级和经验 |
| `/vcforge calibrate` | `vcforge.use` | 校准主手装备强度 |
| `/vcforge reforge` | `vcforge.use` | 重铸主手装备品质 |
| `/vcforge dismantle` | `vcforge.use` | 分解主手锻造装备 |
### 管理员指令
| 指令 | 权限 | 作用 |
| --- | --- | --- |
| `/vcforge reload` | `vcforge.admin` | 重载配置和图纸 |
| `/vcforge give <玩家> <图纸ID> [数量]` | `vcforge.admin` | 发放锻造图纸 |
| `/vcforge give-quality <玩家> <图纸ID> <品质> <强度> [数量]` | `vcforge.admin` | 发放指定品质和强度的成品 |
管理员发放指定成品示例：
```text
/vcforge give-quality Steve c1_sword_main rare 80 1
```
其中强度范围为 `0-100`，品质必须使用图纸中已经配置的品质 ID。
## 适用场景
- RPG 服务器装备锻造系统。
- 副本装备和职业套装制作。
- 随机品质、随机词条和装备毕业玩法。
- 强度校准、品质重铸和装备分解玩法。
- DragonCore 自定义装备界面。
- 多服 BC 网络的共享锻造进度。
- 需要与套装、洗练、BD 和邮箱插件联动的综合 RPG 服务器。
## 交流群
# QQ交流群：1040990615
欢迎加入交流群交流锻造玩法、装备构筑、随机属性、洗练词条、DragonCore UI 和插件联动配置。
