转载 工具 合成物品-奥运会 2.0.5

[MD]
# Craftingitems-Igrzyska-K4：物品兑换插件

Craftingitems-Igrzyska-K4 是一款基于信标（Beacon）的物品兑换插件。玩家可在指定信标处使用背包中的所需物品兑换奖励。

该系统适用于活动道具、Boss 掉落物兑换、限量奖励、赛季配方以及出生点的特殊交易。每个信标上方均可显示全息图，展示奖励名称、当前状态、领取限制和所需材料列表。

插件同时支持普通物品与自定义物品。自定义物品可识别名称、颜色、附魔、发光效果、`CustomModelData` 及其他物品元数据。

## 功能特性

- 创建多个拥有独立配方的兑换信标
- 玩家右键点击信标即可领取奖励
- 自动从玩家背包中扣除所需物品
- 支持将普通物品设置为兑换材料
- 支持将特殊自定义物品设置为兑换材料
- 检测自定义名称、附魔、发光效果、`CustomModelData` 和物品元数据
- 在信标上方显示彩色全息图
- 在全息图上方展示奖励物品
- 为每个信标设置领取次数限制
- 达到领取上限后自动隐藏材料列表
- 缺少材料时显示提示信息
- 在全息图和消息中显示物品的自定义名称
- 可全局启用或禁用兑换系统
- 可单独启用或禁用指定信标
- 提供全息图修复与刷新命令
- 优化全息图数据，避免玩家进入服务器时产生过大的数据包
- 可配置消息文本和前缀
- 管理命令支持 Tab 补全

## 使用场景

- 使用 Boss 掉落物兑换活动武器
- 在出生点设置限量奖励
- 无需使用原版工作台的赛季合成配方
- 使用稀有资源进行特殊兑换
- 设置仅可领取固定次数的奖励
- 要求特定自定义物品的活动兑换内容

## 管理命令

- `/crafting set <id>`：设置当前准星所指向的信标
- `/crafting dodaj <id>`：将手持物品添加为奖励
- `/crafting koszt <id> add`：添加普通材料
- `/crafting koszt <id> add special`：添加特殊自定义材料
- `/crafting zmien <id> <nr>`：切换当前启用的配方
- `/crafting lista [id]`：查看配方列表
- `/crafting toggle <id>`：启用或禁用指定信标
- `/crafting toggle-global <on|off>`：启用或禁用整个系统
- `/crafting limit <id> <liczba>`：设置领取次数上限
- `/crafting fixholo`：修复并刷新全息图
- `/crafting itemholo <id> <on|off>`：启用或禁用全息图上方的物品展示

## 安装方法

1. 将 `Craftingitems-Igrzyska-K4` 插件上传至 `/plugins**.` 文件夹。
2. 将必需的 `Licencja-K4` 插件上传至 `/plugins**.` 文件夹。
3. 启动服务器，以生成配置文件。
4. 如尚未安装许可证插件，请前往作者的 Discord 下载。
5. 在 Discord 中使用命令 `/licencjak4 utworz` 生成许可证。
6. 将生成的许可证粘贴到 `Licencja-K4` 插件的配置文件中。
7. 重启服务器。

## 运行要求

- Paper、Purpur 或 Spigot 服务端
- Minecraft `1.20+`
- 支持版本：`1.21.x`
- Java 17 或更高版本
- `Licencja-K4` 插件

## 说明

该插件面向活动服和生存服务器设计，提供无需打开额外 GUI 的简洁物品兑换系统。

所有信标、配方、材料、领取限制和全息图均可通过管理命令直接配置与管理。
[/MD]