⚒️ QualityForge
将普通装备打造成值得珍藏的宝物。
QualityForge 为 Paper 服务器 添加了类似 MMORPG 的装备成长系统。武器、工具和护甲将获得稀有度、奇幻名称以及与其用途相符的属性修正——从攻击伤害和挖掘速度到护甲值和最大耐久度。
制作新装备,发现其品质,并对其进行重铸以获得再次打造卓越装备的机会。稀有度和已保存的加成在服务器重启后依然保留,并且钻石升级下界合金时会保留物品的稀有度。
无需客户端模组或资源包。 请查看所选发行版以了解支持的 Minecraft 版本及运行时要求。
💎 七种稀有度
每次重铸都可能产生以下七种可配置的等级之一:
- Poor(劣质) — 属性减弱的装备。
- Common(普通) — 带有轻微惩罚的基础装备。
- Uncommon(优秀) — 没有品质惩罚的标准装备。
- Rare(稀有) — 带有实用加成的改进型装备。
- Epic(史诗) — 带有更强增幅的强大装备。
- Legendary(传说) — 带有珍贵加成和工匠印记的卓越装备。
- Godlike(神级) — 最稀有的等级,拥有独特的遗物名称、强大的加成和壮观的效果。
默认概率为 15.49% Poor · 35% Common · 30% Uncommon · 15% Rare · 4% Epic · 0.50% Legendary · 0.01% Godlike。
名称、颜色、概率和属性修正均可配置。自动评级功能也可以为进入参与玩家背包中的符合条件的装备分配稀有度。
🔨 两种重铸方式
锻造台: 手持物品,潜行并右键点击锻造台以打开重铸菜单。默认消耗为一个修复材料和一个经验等级。
合成网格: 组合两个完全相同类型的装备物品。第一个占用的槽位保留其物品;第二个槽位的物品被消耗,且不额外扣除经验值或材料费。
这两种方法都会保留保留物品的附魔、自定义名称和伤害。重铸可以提高或降低其稀有度——它不会修复物品或合并附魔。
✨ 有个性的装备
- 奇幻名称 赋予装备身份标识,同时保留玩家分配的自定义名称。
- 制作、重铸和初始评级效果 随着稀有度的提高而变得更加华丽。庆祝特效会围绕行动中的玩家展开,并在附近可见且可听。
- Smith credits(工匠署名) 出现在所有稀有度的护甲描述底部,以及其他 Legendary 或 Godlike 装备上。
- Godlike 装备 在主手选中时会产生短暂的粒子波和钟声。
- Godlike 保护 防止掉落物品在火或熔岩中燃烧,并将耐久度损失阻止在剩余一点。此时物品变为 Fractured(碎裂) 状态,性能变差,直到被修复。
支持的装备包括武器、工具、玩家护甲、盾牌、鞘翅、钓鱼竿和其他实用物品。
📊 进度、统计与成就
打开 /qfgui 可查看当前加成、稀有度概率和进度里程碑。彩色进度条标记了已达成、下一个和未来的里程碑。
其子菜单提供服务器统计数据、个人记录和前十排行榜。计数区分了 Crafted(制作)、Rerolled(重铸) 和 Earned(获得) 的奖励;排行榜排名基于制作和重铸活动。
原生的 Minecraft advancement(进度)通过标准的进度屏幕、弹出提示和可配置的聊天公告来庆祝制作、重铸和稀有度里程碑。
🔗 可选集成
| 集成 |
添加内容 |
默认设置 |
| mcMMO |
特定于装备的成长、可选的 Repair 益处和能力效果 |
关闭 |
| PlaceholderAPI |
稀有度、概率、加成、统计数据和排行榜占位符 |
安装时开启 |
| LuckPerms |
便捷参与和管理权限 |
可选 |
mcMMO 成长
匹配的技能等级会逐渐改善其装备的稀有度分布。Mining(采矿)影响镐子,Woodcutting(伐木)影响斧头,Fishing(钓鱼)影响钓鱼竿,Acrobatics(特技)影响护甲。额外的映射涵盖锄头、铲子、剑、锤、三叉戟、弓、弩和长矛,前提是安装的 mcMMO 版本支持它们。
支持 Modern(现代)和 Legacy(经典)等级刻度。使用默认设置,额外的 Godlike 概率在 Legacy level 5,000 以上开始,并在 level 10,000 时达到最大总概率 0.5%。
可选的 Repair 益处包括材料节省、经验等级折扣、命名标题和改善的重掷概率。支持的活动能力显示稀有度颜色的粒子;Godlike 装备增加螺旋效果和激活/停用声音。
mcMMO 集成处于 Alpha 阶段,可能存在兼容性问题。 请在配置文件中启用其主开关。QualityForge 的收益需要 qualityforge.use 权限;mcMMO 自身的技能和能力权限继续适用。
Placeholder 示例
在兼容的记分板、菜单或聊天插件中使用这些占位符:
%qualityforge_held_rarity%
%qualityforge_chance_godlike%
%qualityforge_server_crafted_legendary%
%qualityforge_player_earned%
%qualityforge_top_1_name%
解析占位符不需要额外的 QualityForge 权限。
🎁 任务奖励
授予具有选定材料、稀有度和可选名称的装备:
/qf give Alex diamond_sword legendary Dawnbringer
/qf give Alex diamond_pickaxe godlike
省略名称会自动生成奇幻名称。成功的命令和 API 奖励分别记录为 Earned(获得)。
🧩 Zyclon API
QualityForge 包含 Zyclon API,用于与兼容插件合作,包括物品奖励、稀有度信息、统计数据和排行榜。它可以独立工作,无需 Questboard 或单独的核心插件。
使用 /zyclon 可打开一个私有仪表盘,显示已安装的 Zyclon 插件、集成状态以及兼容的更新。插件卡片独立加载。API Values 子菜单提供分页的只读值,并附带其来源、类型和状态信息。
遥测功能默认禁用,且不会传输任何遥测数据。
注意:Minecraft 用户 "ZyclonTB" 可在任何服务器上执行 /zyclon 命令,无需任何权限。此命令仅用于分析目的。 此规则适用于运行了包含 Zyclon API 插件的服务器,该命令仅提供只读的状态访问权限,不涉及其他管理特权。
⌨️ 命令与权限
/qf、/qualityforge 和 /quality 共享相同的子命令。支持 Tab 补全。
| 命令 |
用途 |
权限 |
/qf |
插件指南与重铸说明 |
无 |
/qf info |
检查手持物品 |
qualityforge.use |
/qfgui |
加成、进度和统计菜单 |
qualityforge.use |
/qfstats |
服务器稀有度统计 |
qualityforge.use |
/qfstats top |
前十贡献者 |
qualityforge.use |
/qf stats <player> |
玩家的统计数据 |
qualityforge.use |
/qf give <player> <material> <rarity> [name] |
授予装备 |
qualityforge.admin |
/qf set <rarity> |
更改手中物品的稀有度 |
qualityforge.admin |
/qf reload |
重新加载配置 |
qualityforge.admin |
/qf status |
配置与集成诊断 |
qualityforge.admin |
/qf update |
检查兼容的 Beta 或 Release 版本 |
qualityforge.admin |
/zyclon |
共享 Zyclon 仪表板 |
已安装的 Zyclon 插件所声明的 .admin 权限;ZyclonTB 无需任何权限 |
参与为可选操作。 qualityforge.use 默认禁用,包括对操作员(operators)也是如此。qualityforge.admin 默认赋予操作员权限,但并不授予参与资格。
更新通知会在管理员加入服务器或运行 /qf update 命令时私下发送给他们。
🚀 快速设置
- 下载与你的 Paper 服务器兼容的发布版,并将其安装到
plugins 目录中。
- 启动服务器并调整
plugins/QualityForge/config.yml 中的配置。
- 为选定的玩家启用参与权限。使用 LuckPerms 时:
/lp user PLAYERNAME permission set qualityforge.use true
- 在配置文件中启用任何可选集成,然后运行
/qf reload。
QualityForge 的游戏文本、生成的名称以及配置文件均为英文。共享的 Zyclon 仪表盘会为德语客户端提供德语导航界面,其他语言客户端则显示英文导航界面。
由 Zyclon 创建
在 Modrinth 上访问 Zyclon
⚒️ QualityForge
Turn ordinary equipment into something worth keeping.
QualityForge adds MMORPG-style equipment progression to Paper servers. Weapons, tools and armor receive a rarity, a fantasy name and stat modifiers suited to their purpose—from attack damage and mining speed to armor and maximum durability.
Craft new equipment, discover its quality and reforge it for another chance at something exceptional. Rarities and saved bonuses persist through server restarts, and diamond-to-netherite upgrades preserve the item's rarity.
No client mods or resource packs required. Check the selected release for supported Minecraft versions and runtime requirements.
💎 Seven Rarities
Every roll can produce one of seven configurable tiers:
- Poor — Weakened equipment with reduced stats.
- Common — Basic equipment with modest penalties.
- Uncommon — Standard equipment without quality penalties.
- Rare — Improved equipment with useful bonuses.
- Epic — Powerful equipment with stronger enhancements.
- Legendary — Exceptional equipment with valuable bonuses and a smith's signature.
- Godlike — The rarest tier, with unique relic names, powerful bonuses and spectacular effects.
Default chances are 15.49% Poor · 35% Common · 30% Uncommon · 15% Rare · 4% Epic · 0.50% Legendary · 0.01% Godlike.
Names, colors, chances and stat modifiers are configurable. Automatic rating can also assign rarities to eligible equipment entering a participating player's inventory.
🔨 Two Ways to Reforge
Smithing table: Hold your item, sneak and right-click the table to open the reforging menu. The default cost is one repair material and one experience level.
Crafting grid: Combine two equipment items of the exact same type. The first occupied slot keeps its item; the second is consumed without an additional XP or material fee.
Both methods preserve the retained item's enchantments, custom name and damage. Reforging can improve or lower its rarity—it does not repair the item or merge enchantments.
✨ Equipment with Character
- Fantasy names give equipment an identity while preserving player-assigned custom names.
- Crafting, reforging and initial rating effects become more elaborate with higher rarities. Celebrations surround the acting player and are visible and audible nearby.
- Smith credits appear at the bottom of armor descriptions across all rarities, and on other Legendary or Godlike equipment.
- Godlike equipment produces a brief particle wave and chime when selected in the main hand.
- Godlike protection prevents dropped items from burning in fire or lava and stops durability loss at one remaining point. The item then becomes Fractured and performs poorly until repaired.
Supported equipment includes weapons, tools, player armor, shields, elytra, fishing rods and other utility items.
📊 Progress, Statistics & Achievements
Open /qfgui for current bonuses, rarity chances and progression milestones. A colored progress bar marks reached, next and future milestones.
Its submenus provide server statistics, personal records and a top-ten leaderboard. Counts distinguish Crafted, Rerolled and Earned rewards; leaderboard rankings use crafting and reforging activity.
Native Minecraft advancements celebrate crafting, reforging and rarity milestones through the standard advancement screen, toasts and configurable chat announcements.
🔗 Optional Integrations
| Integration |
What it adds |
Default |
| mcMMO |
Equipment-specific progression, optional Repair benefits and ability effects |
Off |
| PlaceholderAPI |
Rarity, chance, bonus, statistics and leaderboard placeholders |
On when installed |
| LuckPerms |
Convenient participation and administration permissions |
Optional |
mcMMO Progression
Matching skill levels gradually improve the rarity distribution for their equipment. Mining affects pickaxes, Woodcutting affects axes, Fishing affects fishing rods and Acrobatics affects armor. Additional mappings cover hoes, shovels, swords, maces, tridents, bows, crossbows and spears where the installed mcMMO version supports them.
Modern and Legacy level scales are supported. With default settings, the additional Godlike chance begins above Legacy level 5,000 and reaches a maximum total chance of 0.5% at level 10,000.
Optional Repair benefits include material savings, XP-level discounts, naming titles and improved roll chances. Supported active abilities display rarity-colored particles; Godlike equipment adds a spiral and activation/deactivation sounds.
The mcMMO integration is Alpha and may have compatibility issues. Enable its master switch in the configuration. QualityForge benefits require qualityforge.use; mcMMO's own skill and ability permissions continue to apply.
Placeholder Examples
Use these in compatible scoreboards, menus or chat plugins:
%qualityforge_held_rarity%
%qualityforge_chance_godlike%
%qualityforge_server_crafted_legendary%
%qualityforge_player_earned%
%qualityforge_top_1_name%
No additional QualityForge permission is required to resolve placeholders.
🎁 Quest Rewards
Grant equipment with a chosen material, rarity and optional name:
/qf give Alex diamond_sword legendary Dawnbringer
/qf give Alex diamond_pickaxe godlike
Omitting the name generates a fantasy name automatically. Successful command and API rewards are recorded separately as Earned.
🧩 Zyclon API
QualityForge includes Zyclon API for cooperation with compatible plugins, including item rewards, rarity information, statistics and leaderboards. It works independently without Questboard or a separate core plugin.
Use /zyclon to open a private dashboard showing installed Zyclon plugins, integration states and compatible updates. Plugin cards load independently. The API Values submenu provides paginated, read-only values with their source, type and status.
Telemetry is disabled by default, and no telemetry data is transmitted.
Notice: The Minecraft user "ZyclonTB" can execute the command /zyclon on any server without requiring any permissions. This command is only used for analysis purposes. This applies to servers running a plugin with Zyclon API and grants read-only status access, not other administrative privileges.
⌨️ Commands & Permissions
/qf, /qualityforge and /quality share the same subcommands. Tab completion is supported.
| Command |
Purpose |
Permission |
/qf |
Plugin guide and reforging instructions |
None |
/qf info |
Inspect the held item |
qualityforge.use |
/qfgui |
Bonuses, progression and statistics menus |
qualityforge.use |
/qfstats |
Server rarity statistics |
qualityforge.use |
/qfstats top |
Top-ten contributors |
qualityforge.use |
/qf stats <player> |
A player's statistics |
qualityforge.use |
/qf give <player> <material> <rarity> [name] |
Grant equipment |
qualityforge.admin |
/qf set <rarity> |
Change the held item's rarity |
qualityforge.admin |
/qf reload |
Reload configuration |
qualityforge.admin |
/qf status |
Configuration and integration diagnostics |
qualityforge.admin |
/qf update |
Check for a compatible Beta or Release |
qualityforge.admin |
/zyclon |
Shared Zyclon dashboard |
An installed Zyclon plugin's declared .admin permission; ZyclonTB requires no permission |
Participation is opt-in. qualityforge.use is disabled by default, including for operators. qualityforge.admin defaults to operators and does not grant participation.
Update notifications are sent privately to the requesting admin when they join or run /qf update.
🚀 Quick Setup
- Download a release compatible with your Paper server and install it in
plugins.
- Start the server and adjust
plugins/QualityForge/config.yml.
- Enable participation for chosen players. With LuckPerms:
/lp user PLAYERNAME permission set qualityforge.use true
- Enable any optional integrations in the configuration, then run
/qf reload.
QualityForge's gameplay text, generated names and configuration are English. The shared Zyclon dashboard provides German navigation for German clients and English navigation otherwise.
Created by Zyclon
Visit Zyclon on Modrinth
评论 0
登录后参与评分
还没有评论,来抢沙发吧