MythicRPG ¥298
以双路线成长为核心，把冥想、圣所、炼金、集市与神殿试炼串成完整闭环的 RPG 插件。
插件定位
先说结论
MythicRPG 不是单一的数值插件，而是一套完整的 RPG 成长框架。玩家围绕当前修炼路线积累魔力，经过小阶段晋升、大阶段试炼、资源循环与装备消耗，逐步完成整条成长链。
从源码结构来看，插件的核心由 双路线境界、冥想获取资源、圣所/印记被动产出、炼金配方与品质、随机集市、神殿试炼突破 组成，同时配有 GUI、PAPI、数据库持久化与管理员工具链。
和旧版文档相比，当前代码里还额外实现了 系统圣所、圣所转印记、管理员魔力药水、在线玩家魔力查看 等功能，官网页面以下内容按当前源码行为整理。
核心循环：/rpg 打开主菜单 → 切换当前修炼路线 → 冥想 / 药水 / 圣所获取魔力 → 小阶段晋升 → 满足条件后进入神殿试炼 → 突破大等阶 → 继续用集市与炼金扩展成长资源。
功能分析
成长主轴很清晰
插件把“获取魔力 → 晋升 → 突破 → 获取更高资源”做成了标准闭环，适合做 RPG 主线系统，而不是零散功能堆叠。
双路线是核心卖点
法术和战士两条线独立记录等阶与魔力，属性叠加，但当前生效路线可切换，冥想、药水和被动收益会进入当前路线的经验池。
资源系统不只一个入口
主动资源来自冥想、药水、集市购买，持续资源来自个人圣所、系统圣所、满级后的印记，被动与主动获取方式都有。
管理侧工具比较完整
管理员可直接设定路线魔力、发放配方与圣所、设置试炼世界、创建公共圣所、发放固定/随机魔力药水，并查看在线玩家法术/战士魔力。
源码里值得注意的几个点
当前默认配置中每日冥想上限为 50 次，圣所/印记每 10 秒 结算一次魔力，神殿试炼有 附近玩家增伤 机制，圣所升满后还能转成 全域生效的印记。
主要功能
- 双路线境界：法术与战士两条成长线独立记录，属性叠加，当前路线可随时在 GUI 中切换。
- 主菜单 GUI：主菜单、等阶、炼金、圣所、集市全部做了形状化 GUI，支持 ItemsAdder 标题贴图。
- 冥想批量结算：左键可一次冥想 5 次，右键可直接消耗剩余次数，并叠加连击加成。
- 圣所领域：玩家放置圣所水晶后生成个人领域，在范围内每个结算周期获得魔力并显示全息信息。
- 系统圣所：管理员可创建公共圣所，可做主城、宗门、活动区等公共魔力区域，且能与个人圣所 / 印记叠加。
- 印记系统：圣所升满后可转化为印记，脱离地块限制，改为全图持续被动产出，并支持头顶称号全息。
- 炼金配方与品质：学习配方后消耗材料炼制药水或神盾，品质会随炼金等级提升而提高。
- 随机集市：商品池按配置随机生成，支持自动刷新、手动刷新、配方购买、绑定药水与 MMOItems 材料售卖。
- 神殿试炼：大阶段突破需要进入试炼世界承受 9 道天雷，失败会损失魔力并进入冷却。
- 完整扩展接口：支持 PlaceholderAPI、多数据库存储、管理员命令、离线玩家发放资源与 MMOItems 物品同步。
玩家命令
主命令：/rpg，别名：/adventure
| 命令 | 说明 |
|---|---|
/rpg | 打开主菜单“冒险者之书” |
/rpg info | 查看当前路线、双路线等阶、战斗力、炼金等级、圣所/印记状态 |
/rpg rank | 打开等阶界面，查看法术/战士路线、当前路线切换与晋升信息 |
/rpg ascend | 尝试晋升当前路线；小阶段直接消耗魔力，大阶段提示进入试炼 |
/rpg meditate | 进行一次冥想获取当前路线魔力 |
/rpg sanctum | 打开圣所管理界面 |
/rpg sanctum upgrade | 升级圣所聚焦器 |
/rpg alchemy | 打开炼金台 |
/rpg market | 打开集市 |
/rpg market restock | 花费冒险币手动刷新集市 |
/rpg trial | 校验条件并传送到试炼世界 |
当前路线切换不走单独命令，而是在 /rpg rank GUI 里点击切换。冥想、药水、圣所和印记收益都会进入“当前路线”的魔力池。
管理命令
管理命令：/rpgadmin，别名：/rpga，权限：mythicrpg.admin
| 命令 | 说明 |
|---|---|
/rpgadmin reload | 重载配置、GUI、消息与系统圣所，并重新同步 MATERIAL_FB |
/rpgadmin trial setworld | 把当前位置设置为试炼场入口 |
/rpgadmin trial setreturn | 设置试炼成功/失败后的返回点 |
/rpgadmin sanctum create <名称> <魔力> [范围] | 创建系统圣所；范围可写数字，也可用 world 表示全世界 |
/rpgadmin sanctum delete <名称> | 删除系统圣所 |
/rpgadmin sanctum setskull | 读取手中头颅贴图，写入圣所水晶皮肤 |
/rpgadmin set rank <玩家> <等阶> <阶段> | 设置法术路线等阶与阶段 |
/rpgadmin set mana <玩家> <magic|warrior> <数值> | 直接设置对应路线魔力 |
/rpgadmin give mana <玩家> <magic|warrior> <数值> | 给在线或离线玩家追加路线魔力 |
/rpgadmin give manapotion ... | 发放固定值或随机区间的管理员魔力药水 |
/rpgadmin give sanctum <玩家> | 发放圣所水晶 |
/rpgadmin give recipe <玩家> <配方ID> | 授予配方 |
/rpgadmin view mana [页码] | 打开在线玩家法术/战士魔力查看界面 |
/rpgadmin reset daily <玩家> | 重置每日冥想、药水、集市刷新次数 |
/rpgadmin fixattr | 刷新在线玩家等阶属性 |
境界系统
插件内部同时维护 法术路线 与 战士路线。两条路线各有自己的等阶、阶段与魔力值，属性总加成会叠在角色身上，但“当前路线”决定了冥想、药水、圣所等收益流向哪一条线。
法术路线
偏向魔法成长线，从凡尘术士一路提升到法术之神，默认主资源变量为 exp / mana 系列占位符。
战士路线
偏向近战成长线，从田野农夫一路提升到武神之裔，拥有独立的战士魔力池和单独的阶段晋升。
| 项目 | 当前实现 |
|---|---|
| 路线数量 | 2 条：法术 / 战士 |
| 小阶段 | 前期 novice / 中期 intermediate / 后期 advanced |
| 路线切换 | 在等阶 GUI 内点击切换，不需要单独命令 |
| 小阶段晋升 | 直接消耗当前路线魔力 |
| 大阶段晋升 | 达到后期并满足下一阶魔力要求后，进入试炼完成突破 |
| 属性结算 | 使用 MythicLib 应用生命、攻击、防御、速度等阶属性 |
当前路线只影响“资源进入哪条线”，不会清空另一条线。也就是说两条线可以并行养成，只是同一时间你只能把新获取的魔力灌到其中一条。
圣所与印记
圣所系统是插件的被动资源核心。玩家放置圣所水晶后会在周围形成个人领域；站在范围内时，系统每 10 秒结算一次魔力。管理员还可以额外创建 系统圣所，让主城或活动区也持续产出魔力。
| 项目 | 默认值 / 规则 |
|---|---|
| 个人圣所范围 | 30 x 30 x 30 |
| 基础魔力 | 每 10 秒 5 |
| 等级加成 | 每级额外 +3 |
| 放置限制 | 每名玩家同时只能放置 1 个个人圣所 |
| 占地检测 | 不能与其他玩家圣所重叠 |
| 升级上限 | 个人圣所升到 Lv.10 后可转印记 |
| 升级费用 | 当前实现为 (下一级) x 1,000,000 冒险币 |
圣所
需要摆放地块，只有站在范围内才持续获得魔力，适合做家园、宗门、修炼地一类的领地玩法。
印记
圣所满级后可转化为印记，改成全图被动生效，不再受站位限制，还能显示头顶称号全息，且可继续无限升级。
系统圣所
管理员可用 /rpgadmin sanctum create 创建公共圣所，支持指定范围或整世界生效。系统圣所的魔力收益会和玩家个人圣所、印记收益叠加。
炼金系统
炼金系统通过 alchemy.yml 加载配方，玩家在学会配方后消耗材料进行炼制。普通配方产出的是带品质的药水，特殊配方可直接产出神盾等功能性道具。
| 配方 ID | 产物 | 作用 |
|---|---|---|
exp_potion | 经验药水 | 饮用后给当前路线增加魔力 |
strength_elixir | 力量药剂 | 高阶药剂配方示例 |
ascension_elixir | 晋升药剂 | 用于成长中后期突破链路 |
aegis_shield | 神盾 | 试炼时自动减免 30% 天雷伤害 |
品质与使用规则
- 品质机制：普通、非凡、稀有、史诗、传说五档，炼金等级越高，高品质概率越高。
- 炼金经验：每次成功炼制默认获得
10点炼金经验。 - 饮用限制：插件药水每日默认最多饮用
20次。 - 购买绑定：从集市买到的药水会绑定买家，自己炼制的药水不绑定。
- 管理员扩展：支持固定值与随机区间的管理员魔力药水，适合活动或补偿发放。
集市系统
集市会从 market.yml 的商品池随机抽取商品，写入玩家个人货架。支持自动刷新和手动刷新，商品类型包含配方、药水、MMOItems 材料与特殊道具。
| 项目 | 当前默认值 / 行为 |
|---|---|
| 自动刷新 | 每 7200 秒自动刷新一次 |
| 手动刷新 | /rpg market restock，消耗 100 冒险币 |
| 每日手动上限 | 20 次 |
| 展示槽位 | 12 个商品位 |
| 商品类型 | RECIPE / POTION / MMOITEM / SPECIAL |
| 重复配方 | 已学会时会退还冒险币，不会白扣 |
如果商品类型是 MMOITEM，集市会直接调用 MMOItems 物品；如果是药水或神盾，则会生成与实际购买结果一致的预览堆栈，适合做完整的 RPG 物资循环。
神殿试炼
大阶段突破需要通过试炼世界。玩家满足条件后会被传送到试炼场，随后自动开始 9 道天雷判定。试炼成功后晋升到下一大等阶；失败则损失当前路线部分魔力并进入冷却。
满足前置条件
当前路线必须处于后期阶段，并且达到下一大等阶所需魔力；如果失败过，还需要等冷却结束。
进入试炼世界
执行 /rpg trial 或点击 GUI 试炼按钮，插件会把玩家传送到管理员设定好的试炼入口。
承受 9 道天雷
每道雷按最大生命值百分比造成伤害，默认从 5% 递增到 35%，期间会切换雷暴天气。
成功或失败结算
成功则自动完成大阶段突破并广播；失败则默认损失 20% 当前路线魔力，并进入 24 小时冷却。
源码里的真实危险项
试炼有“围观增伤”机制。默认会检查玩家周围 10 格内的其他玩家数量，每多 1 人，天雷伤害额外提高 10%。神盾可抵消 30% 伤害，但会在触发时消耗。
PAPI 变量
占位符前缀统一为 %mrpg_*。当前实现不只提供基础等级信息，还覆盖路线、圣所、印记、集市、冥想与试炼状态。
| 占位符 | 说明 |
|---|---|
%mrpg_active_path% | 当前路线（法术 / 战士） |
%mrpg_active_rank_full% | 当前路线完整等阶 + 阶段 |
%mrpg_rank_magic_full% | 法术路线完整等阶 |
%mrpg_rank_warrior_full% | 战士路线完整等阶 |
%mrpg_combat_power% | 综合战斗力 |
%mrpg_alchemy_level% | 炼金等级 |
%mrpg_sanctum_level% | 圣所等级 |
%mrpg_in_system_sanctum% | 是否位于任意系统圣所中 |
%mrpg_sigil_level% | 印记等级 |
%mrpg_market_items% | 当前货架可购买商品数量 |
%mrpg_trial_cd% | 试炼冷却剩余时间 |
%mrpg_meditation_daily% | 今日已冥想次数 |
依赖与配置
| 组件 | 状态 | 说明 |
|---|---|---|
| MythicLib | 必需 | 等阶属性应用核心 |
| PlaceholderAPI | 必需 | 占位符扩展注册 |
| DecentHolograms | 必需 | 圣所与印记全息显示 |
| Vault | 必需 | 冒险币经济系统 |
| PlayerPoints | 必需 | 蓝宝石积分系统 |
| ItemsAdder | 可选 | GUI 标题贴图与 ModelData 辅助显示 |
| MMOItems | 可选 | 炼金材料、集市物品与 MATERIAL_FB 同步 |
| 数据库 | 支持 | MySQL 与 SQLite 双后端 |
当前默认配置重点
meditation:
daily-max: 50
sanctum:
range: 30
base-mana-per-tick: 5
level-bonus-per-tick: 3
mana-tick-interval: 200
market:
auto-refresh-interval: 7200
manual-refresh-cost: 100
daily-manual-refresh-limit: 20
slots: 12