- 版权类型
- 原创
- 插件中文名称
- 重铸系统
- 插件英文名称
- ReforgeSystem
- 原帖地址
- #
- 支持的核心(服务端)
- Paper
- 语言支持
- 中文(简体)
- 前置组件
- neigeitems https://github.com/ankhorg/NeigeItems-Kotlin/releases
Vault https://www.spigotmc.org/resources/vault.34315
PlayerPoints https://www.spigotmc.org/resources/playerpoints.80745
- 适配版本(Java)
- 1.12
ReforgeSystem
WEAPON REFORGING SYSTEM
一套灵活、可配置的 RPG 武器重铸系统ReforgeSystem 是一款面向 Minecraft RPG 服务器的武器重铸插件。通过配置文件即可创建独立的武器重铸配方,自定义材料消耗、品质奖池、随机权重以及品阶保底机制。
无需为每件武器单独编写代码,也无需改变服务器原有的装备体系。
灵活的配方管理 · 独立的概率控制 · 完整的装备养成机制
✦ 01 / FEATURES
核心功能
所有重铸规则均由 YAML 配方文件管理。
- 支持创建多个独立重铸配方。
- 支持通过物品名称与 Lore 识别武器。
- 支持精准匹配与模糊匹配。
- 支持同一配方配置多个武器匹配条件。
- 不同配方拥有独立的消耗与产出规则。
◆ 自定义材料消耗 · Custom Materials
重铸所需资源可以根据服务器的经济体系自由组合。
| 消耗类型 | 功能 |
|---|---|
| Vault | 金币消耗 |
| PlayerPoints | 点券消耗 |
| NeigeItems | 普通重铸材料 |
| NeigeItems | 至臻重铸材料 |
同一类型支持设置多个可选材料,玩家只需放入其中一种符合要求的材料即可完成重铸。
✧ 权重随机 · Weighted Random
每个配方均可拥有独立的品质产出奖池。
通过权重控制不同品质的产出比例,让装备成长节奏完全由服主掌控。
示例奖池:
| 装备品质 | 产出权重 |
|---|---|
| 普通 | 40 |
| 极品 | 30 |
| 史诗 | 20 |
| 传奇 | 10 |
不同武器之间互不影响。
♛ 至臻材料 · Guaranteed Highest Tier
为追求确定性产出的玩家提供另一种重铸选择。
使用指定的至臻材料时,本次重铸将直接获得当前配方指定的最高品质装备。
- 普通材料:参与概率随机。
- 至臻材料:直接获得最高品质。
- 两种材料独立配置,互不干扰。
◈ 品阶保底 · Pity System
内置独立的品质保底机制,避免玩家长期投入却始终无法获得理想结果。
主要特性:
- 支持全局开启或关闭。
- 支持自定义保底触发次数。
- 未获得最高品质时累计保底次数。
- 获得最高品质后自动清零。
- 使用至臻材料获得最高品质后同样清零。
- 玩家保底数据独立保存,退出服务器不会丢失。
▣ 自定义 GUI · Interface Customization
提供独立的 GUI 配置文件,可根据服务器 UI 风格调整重铸界面。
支持自定义:
- 界面标题与大小
- 武器放置槽位置
- 材料放置槽位置
- 重铸按钮位置
- 边框与装饰物品
- 按钮名称及 Lore
- 保底进度展示
- 当前配方与消耗信息
关闭界面时,槽内真实物品会自动退还。
- 内置 SQLite 数据库,无需额外部署数据库服务。
- 玩家保底数据独立保存。
- 支持异步数据写入。
- 内置玩家操作锁与点击频率限制。
- 支持配置及配方热重载。
- 支持自定义音效、粒子及烟花效果。
✦ 02 / REQUIREMENTS
运行环境
| 项目 | 说明 |
|---|---|
| Minecraft | 1.12.2 |
| 服务端核心 | Paper |
| Java | Java 8 |
| 插件语言 | 中文 |
| 数据存储 | SQLite |
| 资源价格 | 免费 |
以下组件根据配方实际使用的功能按需安装,并非全部强制依赖。
| 组件 | 用途 |
|---|---|
| NeigeItems | 自定义材料与物品产出 |
| MythicMobs | MM 物品产出 |
| Vault | 金币消耗 |
| PlayerPoints | 点券消耗 |
- ni-:NeigeItems
- mm-:MythicMobs
✦ 03 / INSTALLATION
安装与初始化
Step 01 — 将插件文件放入服务器插件目录。plugins/
└── ReforgeSystem-1.3.6.jar
Step 02 — 启动服务器,等待插件生成配置文件。
Step 03 — 进入插件目录,根据服务器需求修改配置。
plugins/
└── ReforgeSystem/
├── config.yml
├── gui.yml
├── messages.yml
├── reforge.db
└── recipes/
└── example.yml
Step 04 — 根据需要安装对应前置组件,并编写重铸配方。
Step 05 — 使用重载指令载入配置。
/reforge reload
完成以上步骤即可开始使用。
✦ 04 / RECIPE CONFIGURATION
配方配置说明
ReforgeSystem 采用独立 YAML 配方管理机制。每个配方主要由以下部分组成:
| 配置节点 | 作用 |
|---|---|
| match | 武器识别规则 |
| outputs | 重铸产出奖池 |
| term | 重铸消耗条件 |
example_sword:
# 武器识别
match:
- name:
- "p-&6劫渊之剑"
lore:
- "v-&f品质:"
# 重铸产出
outputs:
module:
- highest-items: ni-主手传奇
weight: 10
- items: ni-主手史诗
weight: 20
- items: ni-主手极品
weight: 30
- items: ni-主手普通
weight: 40
# 重铸消耗
term:
vault: 1000
points: 0
items:
ni-重铸石: 1
ascension-items:
ni-天命重铸石: 1
▸ 武器匹配规则
| 前缀 | 说明 |
|---|---|
| p- | 精准匹配,名称或 Lore 完全一致 |
| v- | 模糊匹配,名称或 Lore 包含指定内容 |
支持颜色代码匹配,同一配方也可以配置多个匹配条件。
▸ 材料消耗规则
普通材料:
items:
ni-重铸石一级: 1
ni-重铸石二级: 2
至臻材料:
ascension-items:
ni-天命重铸石: 1
ni-至臻重铸石: 1
每种材料类型支持多个可选项,玩家只需放入一种符合要求的材料。
▸ 产出奖池规则
outputs:
module:
- highest-items: ni-主手传奇
weight: 10
- items: ni-主手史诗
weight: 20
weight 为权重值,不是百分比。
使用 highest-items 标记配方的最高品质产出,该物品同时用于至臻材料和保底机制。
✦ 05 / CONFIGURATION
配置文件
插件提供三个主要配置文件:| 文件 | 功能 |
|---|---|
| config.yml | 数据库、材料识别、保底及特效设置 |
| gui.yml | 重铸界面布局、按钮及装饰 |
| messages.yml | 玩家提示与操作反馈 |
- 数据库文件名称
- 数据写入间隔
- 材料识别模式(NAME / FULL)
- 保底机制开关
- 保底触发次数
- 重铸成功与失败音效
- 粒子与烟花效果
/reforge reload
即可重新载入配置与配方,无需重启服务器。
✦ 06 / COMMANDS & PERMISSIONS
指令与权限
玩家指令| 指令 | 说明 |
|---|---|
| /reforge | 查看插件帮助 |
| /reforge open | 打开重铸祭坛 |
| /reforge reset | 重置自己的保底进度 |
| /reforge help | 查看帮助 |
| /rs | 插件命令别名 |
| 指令 | 说明 |
|---|---|
| /reforge reload | 重载配置与配方 |
| /reforge reset <玩家> | 重置指定玩家的保底进度 |
| 权限 | 默认值 | 说明 |
|---|---|---|
| reforge.use | true | 使用重铸界面及重置自身保底 |
| reforge.admin | OP | 管理命令及重置其他玩家 |
| reforge.bypass.cooldown | false | 跳过点击冷却与连点检测 |
✦ 07 / FAQ
常见问题
Q:添加新武器需要修改插件代码吗?不需要。在 recipes/ 中创建对应 YAML 配方即可。
Q:同一件武器可以配置多种重铸材料吗?
可以。普通材料和至臻材料均支持配置多个可选项。
Q:至臻材料会参与普通概率随机吗?
不会。使用至臻材料时直接获得配方指定的最高品质。
Q:玩家退出服务器后,保底次数会丢失吗?
不会。保底数据保存在 SQLite 数据库中。
Q:修改配方后需要重启服务器吗?
不需要,使用 /reforge reload 即可重新载入。
Q:可以不安装 Vault 或 PlayerPoints 吗?
可以。不使用对应经济消耗功能时,无需安装相应组件。
✦ 08 / CHANGELOG
更新日志
v1.3.6- 新增普通重铸材料多选配置。
- 新增至臻重铸材料多选配置。
- 优化材料槽匹配与消耗逻辑。
- 完善配方配置说明及示例。
感谢使用。希望它能成为你服务器装备养成体系中的一部分。