原创 游戏模式 盲期-末日核心 1.2.2

MRcore 傻瓜版 Wiki（零基础服主专用）​

文档定位：纯零基础友好版，全程手把手教学，不需要懂Java、不需要懂开发，跟着步骤走就能让插件正常运行，新手服主直接抄作业即可。​

核心原则：先跑通基础功能，再微调平衡，不建议一开始乱改大量配置！​

---

​

0. 插件核心功能一览​

安装MRcore后，你的MC末日生存服务器将解锁全套硬核生存玩法，核心功能覆盖：

• 生存五维属性：饱食、口渴、体温、感染、生命联动，全方位模拟末日生存压力​
• 动态天气系统：不同天气直接影响属性消耗、体温变化、感染增速，还会触发属性减益​
• 区域丧尸体系：按区域等级刷新怪物，支持蓝潮感染热点，可手动触发全局/玩家专属尸潮​
• 完整烹饪系统：自定义配方、品质分级、熟练度升级、食物冷却，搭配图纸解锁机制​
• 热炉保暖系统：右键添加燃料，范围内玩家自动维持体温，抵御低温惩罚​
• 新增负重系统：按物品Lore重量计算负重，超额触发移速惩罚，提升生存真实感​

最新版本 1.2.3 更新日志​

• 新增：负重系统，根据背包物品Lore重量计算负重，按比例削减移动速度​
• 修复：烹饪系统左键点击食谱崩溃问题（IllegalArgumentException: CARROTS isn't an item）​
• 优化：提升胡萝卜、土豆等部分物品材质的兼容性识别率​

---

​

1. 安装前必备准备（缺一不可）​

提前核对好环境和文件，避免安装后插件加载失败，少走弯路！​

1.1 服务器环境要求​

• 服务端核心：Spigot/Paper 1.20.1（其他版本暂不兼容，请勿混用）​
• Java版本：Java 17（Java版本过低会直接导致插件无法加载）​

1.2 依赖插件清单​

• 必装依赖：AttributePlus（无此插件MRcore完全无法运行）​
• 选装依赖：PlaceholderAPI（记分板/HUD变量显示）、WorldGuard（区域防护联动）、MythicMobs（自定义怪物/物品兼容）​

1.3 核心文件准备​

提前下载好以下jar包，统一存放备用：

• MRcore主插件：MrCore-1.2.3.jar​
• 必装依赖：AttributePlus-3.3.2.7.jar​

---

​

2. 5分钟极速安装流程（零失误版）​

严格按照步骤操作，全程不超过5分钟，新手直接照搬即可​

第一步：关闭服务器​

先彻底停止服务器运行，禁止热加载插件，否则会导致配置文件生成残缺、功能异常​

第二步：放入插件文件​

将下载好的两个jar包，全部放入服务器根目录下的 plugins/ 文件夹内，不要放错路径​

第三步：启动服务器一次​

正常启动服务器，等待加载完成，控制台出现 MrCore 已启用 字样，代表插件基础加载成功​

第四步：核对配置文件​

进入 plugins/MRcore/目录，检查是否自动生成以下核心配置文件，缺失则重启服务器重试：

• 总配置：config.yml​
• 天气配置：weather.yml​
• 区域配置：regions.yml​
• 烹饪配方：recipes.yml​
• 食物效果：food.yml​
• 中文语言：lang/zh_CN.yml​

第五步：进服功能验证​

进入游戏，输入命令：/survivor status，能正常弹出自身生存状态面板，代表主功能完全正常​

---

​

3. 服主快速上手（常用命令+权限）​

3.1 立刻可用核心命令​

• /survivor status / 简写 /sur status：查看自身饱食、口渴、体温、感染等生存状态（玩家通用，无需权限）​
• /survivor reload / 简写 /sur reload：重载全部配置文件，改完配置必执行​
• /survivor setinfection 玩家名 数值：手动设置玩家感染值（管理员专用）​

3.2 权限说明​

• 管理员权限：MrCore.admin（默认OP自动拥有，普通玩家无此权限）​
• 基础状态查询：所有玩家默认可用，无需额外授权​

---

​

4. 核心配置文件详解（零基础看懂）​

不用怕YAML配置，这里只讲每个文件的核心作用和必改项，复杂参数默认即可​

4.1 config.yml（总配置，最常用）​

核心作用：插件全局总开关，控制所有基础生存参数、丧尸、热炉、负重、感染阈值​

高频修改项：

• 属性消耗：饱食度/口渴度自然间隔秒数（数值越小，消耗越快，生存越难）​
• 感染阈值：轻度、中度、重度感染临界值，重度可开启强制变身​
• 热炉系统：热炉方块、燃料、作用半径、持续时长、目标体温​
• 负重系统：开关、基础最大负重、Lore匹配规则、移速惩罚阶段​
• 尸潮参数：全局/玩家尸潮怪物权重、刷新上限​

4.2 weather.yml（天气系统）​

核心作用：设置不同天气对玩家的属性影响、减益效果​

关键知识点：AP3属性削减为百分比机制，例如 攻击力: -15 代表攻击力降低15%，正数为加成，常规平衡建议-5~-20，不建议低于-30​

4.3 regions.yml（丧尸区域）​

配置丧尸刷新区域、坐标范围、怪物等级、刷新上限，设置蓝潮感染热点，打造差异化生存区域​

4.4 recipes.yml（烹饪配方）​

自定义所有烹饪配方的材料、品质规则、解锁等级、图纸配置，支持MythicMobs自定义物品作为材料​

4.5 food.yml（食物效果）​

设置每种食物的饱食、口渴、回血、感染削减效果，搭配冷却时间、临时BUFF，区分食物品质差异​

4.6 lang/zh_CN.yml（语言文件）​

修改玩家游戏内看到的所有提示文本、GUI文字，自定义专属提示语​

---

​

5. 新增重点模块详解​

5.1 热炉系统（保暖核心）​

使用流程：放置配置好的热炉方块 → 手持对应燃料 → 右键热炉添加燃料 → 范围内玩家自动维持体温​

常见问题：右键无反应=方块/燃料名称配置错误；有提示无效果=玩家超出作用半径​

5.2 负重系统（1.2.3新增）​

核心逻辑：自动扫描玩家背包物品Lore，匹配“重量: X.Xkg”字段计算总负重，超出比例触发移速惩罚​

参考配置：​

代码：

负重系统:[/SIZE][/COLOR][/HEADING]
[COLOR=#595959][SIZE=13px][HEADING=2]  启用: true[/HEADING]
[HEADING=2]  基础最大负重: 100.0[/HEADING]
[HEADING=2]  Lore匹配规则: "重量: ([0-9.]+)kg"[/HEADING]
[HEADING=2]  惩罚阶段:[/HEADING]
[HEADING=2]    50: 10   # 负重50% 减速10%[/HEADING]
[HEADING=2]    70: 30   # 负重70% 减速30%[/HEADING]
[HEADING=2]    90: 50   # 负重90% 减速50%[/HEADING]
[HEADING=2]    100: 80  # 满负重 减速80%[/HEADING]
[HEADING=2]    120: 95  # 超额负重 几乎无法移动

​

5.3 感染与恢复系统​

• 感染阈值：建议轻度30、中度60、重度90，重度可开启感染者变身​
• 恢复方式：普通床仅回血，医疗床回血+降感染，医疗床方块可自定义（默认重生锚）​

5.4 烹饪系统（图纸+等级+材料）​

制作三要素：解锁图纸 + 烹饪等级达标 + 背包材料充足，缺一不可​

使用方式：右键篝火/熔炉/烟熏炉 或 输入/survivor cook open打开GUI，点击食谱查看材料，满足条件即可制作​

图纸发放：管理员命令 /survivor cook givepaper 玩家名 食谱ID 数量，玩家手持图纸右键解锁​

---

​

6. PlaceholderAPI对接（记分板专用）​

安装PlaceholderAPI后，可直接使用以下变量制作HUD、记分板，实时显示生存属性：

• %mrcore_hunger%：饱食度​
• %mrcore_thirst%：口渴度​
• %mrcore_temperature%：体温​
• %mrcore_infection%：感染值​
• %mrcore_cook_level%：烹饪等级​
• %mrcore_weather%：当前天气​

变量不显示解决：确认安装PAPI → 控制台无报错 → 重启服务器​

---

​

7. 新服一键调参模板（直接抄）​

零基础开服直接用这套参数，先保证游戏流畅，再根据玩家反馈微调：

• 饱食自然间隔：60秒​
• 口渴自然间隔：45秒​
• 重度感染阈值：90​
• 热炉半径：6格，燃料时长：120秒​
• 夜晚丧尸倍率：1.0，白天：0.3​

---

​

8. 插件升级与备份（重中之重）​

升级前必须备份，避免配置丢失、玩家数据损坏

• 备份路径：plugins/MRcore/ 全目录，重点备份 playerdata.db 玩家数据文件​
• 升级步骤：关服 → 备份 → 替换新版jar包 → 开服 → 控制台验证 → 进服测试​

---

​

9. 故障排查大全（按顺序解决）​

问题1：插件完全没加载​

1. 检查是否安装AttributePlus必装依赖​
2. 核对Java版本是否为17，服务端是否为1.20.1​
3. 检查jar包是否放入正确plugins目录​

问题2：配置修改后无效果​

1. 执行 /survivor reload 重载配置​
2. 无效则重启服务器​
3. 检查YAML文件缩进，空格不能乱改，避免语法错误​

问题3：热炉/烹饪/丧尸不生效​

1. 核对配置内物品/方块ID是否正确（区分大小写）​
2. 检查权限、作用范围、功能开关是否开启​
3. 重载配置或重启服务器重试​

问题4：烹饪失败/制作按钮灰色​

1. 确认玩家已解锁对应食谱图纸​
2. 确认烹饪等级达到配方要求​
3. 确认背包内有足够的必需材料​

---

​

10. 全命令与权限清单（完整版）​

10.1 主命令​

主命令：/survivor，支持简写 /sur、/ws​

10.2 子命令明细（管理员+玩家）​

[TABLE=ne-table]​

[TR]​

[td]命令[/td]​

[td]作用[/td]​

[td]权限[/td]​

[td]备注[/td]​

[/TR]​

[TR]​

[td]/sur status[/td]​

[td]查看自身生存状态[/td]​

[td]无[/td]​

[td]玩家通用[/td]​

[/TR]​

[TR]​

[td]/sur reload[/td]​

[td]重载全部配置[/td]​

[td]MrCore.admin[/td]​

[td]改配置必用[/td]​

[/TR]​

[TR]​

[td]/sur setinfection 玩家 数值[/td]​

[td]设置玩家感染值[/td]​

[td]MrCore.admin[/td]​

[td]管理调试[/td]​

[/TR]​

[TR]​

[td]/sur horde start/stop[/td]​

[td]开启/停止全局尸潮[/td]​

[td]MrCore.admin[/td]​

[td]活动专用[/td]​

[/TR]​

[TR]​

[td]/sur cook open[/td]​

[td]打开烹饪GUI[/td]​

[td]无（自用）[/td]​

[td]玩家烹饪[/td]​

[/TR]​

[TR]​

[td]/sur cook givepaper 玩家 食谱ID[/td]​

[td]发放烹饪图纸[/td]​

[td]MrCore.admin[/td]​

[td]管理发放[/td]​

[/TR]​

[/TABLE]​

10.3 权限节点​

唯一管理员权限：MrCore.admin，包含所有管理命令权限，默认OP拥有​

---

​

11. 服主最后建议​

• 第一次开服不要一次性改太多参数，先跑通基础功能，再逐步调整平衡​
• 每次修改1-2项配置，改完立刻进服测试，确认没问题再改下一项​
• 遇到问题先看控制台报错，再对照故障排查清单解决，90%问题都能快速修复​

扩展文档：如需适配普通玩家的简易玩法指南，或更细致的服主平衡调参手册，可另行补充专属文档。​