My - 终极自定义物品 自定义方块 物品与纹理 配方 Fascraft 解构台

💡简介

本插件旨在提升服务器的生存与小型游戏（如UHC、空岛战争等）体验，允许你创建自定义方块、物品、命令以及各种配方。它集成了快速合成、反向合成等功能模块，并支持自定义纹理、NBT数据存储和丰富的物品效果。无论是服务器管理员还是开发者，都能利用它实现高度自定义的游戏内容。

🎮主要特性

核心功能

• 自定义命令：创建具有自定义参数、权限、描述和使用方法的命令。
• 自定义物品与方块：为物品和方块应用自定义纹理（目前各支持最多10个ID），编辑名称、描述、附魔、皮革染色、头颅皮肤，并支持NBT标签和数据存储。
• 自定义配方：创建合成、熔炉和酿造配方，移除原版配方，支持自定义物品作为输入/输出，并可设置合成权限和经验奖励。
• 快速合成 (FastCraft)：提供一个支持自定义配方的GUI，让玩家无需记忆配方即可合成物品。
• 礼物箱 (Giftchests)：创建可随机开出奖励的“战利品袋”物品，支持自定义粒子效果和音效。
• 反向合成 (Uncrafter)：允许玩家将物品分解回其合成材料。
• 物品效果 (ItemEffects)：为食物添加饱食度、饱和度及药水效果；为工具添加自动熔炼、额外经验掉落、破坏基岩等特殊效果。

开发者API

• 提供API以编程方式创建和管理自定义命令、物品、方块及配方。
• 支持通过NBT和数据标签跟踪、扩展自定义物品功能。

🔧下载与安装

• 从发布页面下载插件JAR文件。
• 将其放入服务器的 plugins 文件夹。
• 启动服务器以生成配置文件。
• 根据需求配置插件。
• 重启服务器以应用所有更改。

✨配置教程

基础配置指引

首次使用？建议从以下基础教程开始

• 移除原版配方
• 创建一个命令
• 创建一个物品

移除原版配方

编辑 `recipes.yml` 文件

# 列出你希望禁用的配方，格式：材料:损伤值
remove-vanilla:
  - STONE_PICKAXE:0

创建一个命令

编辑 commands.yml 文件（结构示例）：

<命令标签>:
  arguments: <参数数量，-1表示无限>
  description: '<命令描述>'
  usage: '<用法提示>'
  permission: '<所需权限>'
  aliases:
    - <别名1>
    - <别名2>
  commands:
    - <执行命令1>
    - <执行命令2>

• 使用 server:<命令> 执行控制台命令。
• 使用 {0}、{1} 等作为参数占位符，{sender.name} 代表执行玩家。

创建一个物品

• 在 item_packs 文件夹内创建YAML文件（例如 myitems.yml）。
• 添加物品定义：

MyBigStone:
  material: STONE
  damage: 0
  enchantments:
    - DAMAGE_ALL:2
  name: '&6The Pickaxe'
  lore:
    - '&rThis pickaxe can destroy bedrock. Yes. (Nope)'

进阶功能配置

创建自定义合成配方

在 `recipes.yml` 中添加

CRAFT_MyBigStone:
  type: craft
  shaped: true
  permission: my.stone
  slot:
    '1':
      material: STONE
    # ... 定义其他8个格子
  output:
    custom: MyBigStone
    amount: 1

创建熔炉配方

FURNACE_MyBigStone:
  type: furnace
  permission: my.stone
  input:
    material: STONE
  experience: 10
  output:
    custom: MyBigStone
    amount: 1

创建酿造配方

BREW_MyBigStone:
  type: brew
  material:
    material: STONE
  input:
    material: STONE
  output:
    custom: MyBigStone
    amount: 1

创建带有自定义纹理的方块

• 在物品包中定义方块物品：

HappyFace:
  material: REDSTONE_TORCH
  name: '&cSummon happy face'
  lore:
    - '&rA weird item. When placed you put a happy face instead.'
  data:
    custom:
      block: 1 # 方块ID (1-10)

• 编辑插件提供的资源包中对应ID的纹理（如 texturepack\assets\minecraft\textures\blocks\lapisdemon\bonus\mushroomblocks\001.png）。
• 将资源包打包为ZIP，上传至Dropbox等托管服务，并确保下载链接以 ?dl=1 结尾。
• 在服务器配置中设置资源包链接。

创建礼物箱 (Giftchest)

• 创建代表礼物箱的物品：

MegaChest:
  material: PLAYER_HEAD
  damage: 3
  skull:
    owner: 'MHF_Chest'
  name: '&rMega&6Chest'
  data:
    giftchest: 'MegaChest_loot' # 对应礼物箱配置ID

• 在 giftchest.yml 中定义奖励池：

MegaChest_loot:
  items:
    stone:
      material: STONE
      amount: 4
      enchantments:
        - DAMAGE_ALL:2
    diamond:
      material: DIAMOND
      amount: 1
      name: '&4Diamond'
      enchantments:
        - DAMAGE_ALL:4
  sound: BLOCK_GRASS_BREAK
  particle:
    name: SMOKE
    amount: 10

为工具添加特殊效果

在物品的 `data` 部分添加效果定义

data:
  tool:
    effect: breakbedrock # 效果类型：breakbedrock, autosmelt, xpdrop
    # 若为xpdrop效果，可指定数量：
    # amount: 4

❓常见问题与提示

• 资源包更新后纹理不生效？ 在资源包链接末尾添加 &v=0，下次更新改为 &v=1，依此类推。
• 玩家没有自动接受资源包？ 在服务器配置中将 Server Resource Pack 设置为 Enabled。
• 如何为开发者提供数据存储？ 在物品定义中使用 data: 部分存储任意键值对，其他插件可通过API读取。
• 如何通过代码操作自定义物品？ 使用提供的API类，例如：

  MItemStack mis = new MItemStack(tool);
  String id = mis.getNBTTag("MY_ID");
  if (mis.data.get("tool.effect") == null) return;

⭐注意事项

• 插件功能可按需在配置中禁用，以节省资源。
• 自定义纹理功能需要服务器配置资源包，并确保玩家客户端接受。
• 部分高级教程可能已过时，具体问题可通过Discord/Twitter联系作者或在Github讨论区提问。
• 插件源代码已公开，欢迎开发者通过Github协作。

---

支持与联系：如需捐赠或进一步帮助，请通过Discord/Twitter联系作者。协作开发欢迎访问Github项目页面。