原创 其他 盲期-末日合成 1.0

MRcraft 插件使用文档​

文档说明：本文档为MRcraft插件完整版使用手册，适配末日生存类Minecraft服务器，涵盖插件特色、安装配置、配方编辑、指令权限、常见问题全流程内容，支持服务器管理员快速上手配置与运维，玩家也可查阅基础使用方法。

插件概述​

MRcraft是一款专为末日生存类服务器定制的Minecraft自定义合成插件，核心突破原版3x3合成限制，搭载专属4x4合成系统，同时融合熟练度成长、配方动态解锁、可视化编辑等特色功能，彻底打破原版合成单调的局限，为服务器玩家打造更具深度和可玩性的末日生存合成体验，兼顾玩法趣味性与服务器自定义灵活性。

核心插件特色​

插件安装与基础配置​

安装步骤​

核心配置文件 config.yml 详解​

该文件为插件基础运行配置，无需改动数据库相关默认参数，重点调整GUI、熟练度相关参数即可，完整配置示例与注释如下：

代码：

# 数据库设置（默认SQLite本地存储，无需修改，适配绝大多数服务器）
database:
  filename: "mrcraft.db"

# 合成界面核心设置
gui:
  # 合成界面标题，支持&或§颜色代码
  title: "§0末日合成台"
  # 进度条展示物品（预留扩展功能，默认保持不变）
  progress_item: "LIME_STAINED_GLASS_PANE"
  # 界面背景填充物品（非合成区域的背景板，可自主更换材质）
  fill_item: "GRAY_STAINED_GLASS_PANE"

# 玩家熟练度系统配置
proficiency:
  # 熟练度最大等级，可根据服务器玩法自主调整
  max_level: 20
  # 升级经验计算公式：base * level * multiplier
  # 示例：base=100，multiplier=1.5
  # 1级升2级：100 * 1 * 1.5 = 150经验
  # 2级升3级：100 * 2 * 1.5 = 300经验，等级越高所需经验递增
  exp_formula:
    base: 100
    multiplier: 1.5

配方配置指南 recipes.yml​

配方文件是插件核心配置，所有4x4合成规则均在此定义，插件采用固定4x4网格槽位编号，摆放材料时需严格对应槽位，避免配方失效。

4x4合成槽位编号对照表​

[TABLE=ne-table]
[TR]
[td]行 \ 列[/td]
[td]第1列[/td]
[td]第2列[/td]
[td]第3列[/td]
[td]第4列[/td]
[/TR]
[TR]
[td]第1行[/td]
[td]10[/td]
[td]11[/td]
[td]12[/td]
[td]13[/td]
[/TR]
[TR]
[td]第2行[/td]
[td]19[/td]
[td]20[/td]
[td]21[/td]
[td]22[/td]
[/TR]
[TR]
[td]第3行[/td]
[td]28[/td]
[td]29[/td]
[td]30[/td]
[td]31[/td]
[/TR]
[TR]
[td]第4行[/td]
[td]37[/td]
[td]38[/td]
[td]39[/td]
[td]40[/td]
[/TR]
[/TABLE]

标准配方配置示例​

代码：

# 配方唯一标识符（ID），不可重复，用于指令调用和数据绑定
test_sword:
  # 合成产物配置
  result:
    material: DIAMOND_SWORD  # 产物物品原版ID
    amount: 1               # 产物数量
    name: "§c末日之刃"      # 产物自定义名称，支持颜色代码
    lore:                   # 产物 Lore 描述，支持多行与颜色代码
      - "§7一把锋利的武器"
      - "§7蕴含着末日的力量"
    model_data: 1001        # 支持自定义模型数据，适配材质包
  
  # 合成材料配置（槽位编号: 物品ID），严格对应上方槽位表
  ingredients:
    10: IRON_INGOT    # 第1行第1列放入铁锭
    19: STICK         # 第2行第1列放入木棍
    
  # 合成该物品获得的熟练度经验
  exp: 5
  
  # 基础合成时间（单位：秒）
  # 实际合成时间 = 基础时间 - (玩家熟练度等级 * 0.2)，等级越高速度越快
  time: 2
  
  # 解锁该配方所需的最低熟练度等级
  unlock_level: 1
  
  # 默认解锁开关
  # true：所有玩家默认拥有该配方；false：需图纸解锁，适用于稀有/高阶配方
  default_unlock: true

可视化配方编辑器（推荐使用）​

针对不熟悉yml配置文件的管理员，插件内置游戏内GUI可视化编辑器，全程无需手动改配置，操作简单直观，步骤如下：

指令大全与权限体系​

玩家基础指令（无管理员权限）​

[TABLE=ne-table]
[TR]
[td]指令内容[/td]
[td]功能描述[/td]
[td]对应权限[/td]
[/TR]
[TR]
[td]/mrcraft open[/td]
[td]打开4x4末日合成台界面[/td]
[td]mrcraft.open[/td]
[/TR]
[/TABLE]

管理员专属指令（OP权限）​

[TABLE=ne-table]
[TR]
[td]指令内容[/td]
[td]功能描述[/td]
[td]对应权限[/td]
[/TR]
[TR]
[td]/mrcraft edit <配方ID>[/td]
[td]打开可视化编辑器，创建/修改指定配方（推荐日常使用）[/td]
[td]mrcraft.admin[/td]
[/TR]
[TR]
[td]/mrcraft give <玩家ID> <配方ID>[/td]
[td]给予指定玩家对应配方的解锁图纸，玩家右键即可解锁[/td]
[td]mrcraft.admin[/td]
[/TR]
[TR]
[td]/mrcraft unlock <玩家ID> <配方ID>[/td]
[td]直接为指定玩家解锁对应配方，无需图纸[/td]
[td]mrcraft.admin[/td]
[/TR]
[TR]
[td]/mrcraft setlevel &lt;玩家ID&gt; &lt;等级&gt;[/td]
[td]强制设置指定玩家的熟练度等级，用于测试或补偿[/td]
[td]mrcraft.admin[/td]
[/TR]
[TR]
[td]/mrcraft reload[/td]
[td]重载所有配置文件，修改配置后必执行[/td]
[td]mrcraft.admin[/td]
[/TR]
[/TABLE]

权限节点汇总​

常见问题 FAQ​

Q1：玩家拥有配方材料，却无法合成物品？​

A：按以下步骤逐一排查，99%问题可解决：

Q2：如何设置稀有配方，只能通过图纸解锁？​

A：在对应配方的配置中，将 default_unlock 参数改为 false，管理员通过 /mrcraft give <玩家ID> <配方ID> 发放图纸，也可将图纸配置到服务器商店、副本掉落、宝箱奖励中，提升稀有度。

Q3：如何自定义游戏内提示消息？​

A：修改插件配置文件夹内的lang.yml 文件，所有提示文案均可自主修改，支持& 样式颜色代码，修改后执行 /mrcraft reload 重载生效。

Q4：服务器重启后，玩家熟练度数据丢失？​

A：插件采用SQLite本地数据库存储数据，正常情况下不会丢失。若出现数据异常，检查服务器plugins/MRcraft文件夹权限是否正常，是否有第三方插件清理数据，切勿删除文件夹内的 mrcraft.db 数据库文件。