NFCNotes - 纸币经济插件

NFCNotes 是一款允许玩家将游戏内货币转换为实体纸币的插件。这些纸币可以被其他插件或其他玩家兑换回货币，为服务器经济系统增添了灵活性和趣味性。

💡核心特性

• 完全自定义纸币：你可以自由修改纸币的物品名称和描述文本，甚至可以隐藏其面值。所有必要信息都作为隐藏属性存储。
• 防欺诈提醒：可配置当玩家提取或存入超过特定金额时，向管理成员发出警告。
• 广泛兼容性：支持从 Spigot 1.21 开始的所有版本，并基于最新的 API 构建，支持 RGB 颜色格式（使用 &#<十六进制代码>）。
• 工作台使用限制：可以阻止玩家在任何工作台（包括未来版本的新工作台）中使用 NFCNotes 纸币。
• 丰富的占位符：在纸币名称和描述中支持使用 {money}（金额）和 {issuer}（发行者）占位符。
• 外观与音效：

- 可更改纸币的材质（支持所有有效的 Minecraft 材料）。

- 可为纸币添加附魔光效。

- 可设置纸币被兑换时播放音效。

• 资源包支持：通过 CustomModelData 支持使用材质包为纸币应用自定义模型。

🎮命令

基础命令

• /withdraw <金额> [数量]：将你的货币提取为一张或多张纸币。例如，/withdraw 1200 5 会给你 5 张面值 1200 的纸币。[数量] 参数可选。
• /withdraw all：提取你所有的可用货币。

存入命令

• /deposit [all/stack/纸币数量]：兑换你持有的纸币。可以兑换全部、当前手持的一组，或指定数量。

管理命令

• /createnote [玩家] <面值> [数量]：直接创建一张新纸币，不会扣除任何货币。默认仅 OP 可用。[玩家] 和 [数量] 参数可选。

- 别名：`/cn`

• /count [玩家]：查看你（或指定玩家）库存中所有纸币的总价值。
• /nfcnotes [reload/check/update]：

- 无参数：显示插件信息。

- `reload`：重载配置和所有消息文件。

- `check` / `update`：检查插件是否为最新版本。

🔧快捷操作（需手持纸币）

• 右键点击：兑换手持的这张纸币。
• Shift + 右键点击：兑换你库存中所有的纸币。

✨权限节点

提取权限

• nfcnotes.withdraw.*：使用任何方式提取货币。
• nfcnotes.withdraw.one：允许使用 /withdraw <金额>。
• nfcnotes.withdraw.multiple：允许使用 /withdraw <金额> <数量>。
• nfcnotes.withdraw.all：允许使用 /withdraw all。

存入权限

• nfcnotes.deposit.*：使用任何方式存入货币。
• nfcnotes.deposit.action.*：使用任何操作存入纸币。
• nfcnotes.deposit.action.deposit：允许通过右键点击存入。
• nfcnotes.deposit.massdeposit：允许通过 Shift+右键点击存入全部。
• nfcnotes.deposit.command.*：允许使用任何 /deposit 命令。
• nfcnotes.deposit.command.one：允许使用 /deposit。
• nfcnotes.deposit.command.multiple：允许使用 /deposit <数量>。
• nfcnotes.deposit.command.stack：允许使用 /deposit stack。
• nfcnotes.deposit.command.all：允许使用 /deposit all。

查询与其他权限

• nfcnotes.count.*：允许使用任何 /count 子命令。
• nfcnotes.count.self：允许使用 /count（不指定玩家）。
• nfcnotes.staff.*：包含以下所有管理权限：

- `nfcnotes.staff.warn`：当有人提取或存入超过配置金额时收到警告（默认 OP）。

- `nfcnotes.staff.createnote`：允许执行 `/createnote` 命令（默认 OP）。

- `nfcnotes.staff.reload`：允许执行 `/nfcnotes reload`（默认 OP）。

- `nfcnotes.staff.check-updates`：当有新版本时，玩家加入服务器会收到通知。

- `nfcnotes.staff.withdraw.bypass.disabled-world`：绕过世界限制进行提取。

- `nfcnotes.staff.deposit.bypass.disabled-world`：绕过世界限制进行存入。

- `nfcnotes.staff.count.others`：允许使用 `/count [玩家]`。

⭐配置与事件

配置文件

• 默认 config.yml：你可以在此查看默认配置文件。
• 默认 messages.yml：你可以在此查看默认消息文件。你可以修改插件发送的几乎每一条消息。

事件

NFCNotes 在玩家提取或存入货币时会调用两个事件，方便其他开发者集成：

• WithdrawEvent（提取事件）
• DepositEvent（存入事件）

你可以修改这些事件中的值，以实现自定义逻辑。

❓依赖与要求

必需依赖

本插件依赖于以下**其中一个**经济插件

• Vault
• Essentials

如果服务器中未安装其中任何一个，NFCNotes 将无法工作。除此之外，无需其他操作即可运行插件，但我们强烈建议你自定义配置文件以符合服务器需求。

统计信息

NFCNotes 通过 bStats 收集匿名数据（如服务器玩家人数）。如果你不希望发送数据，可以在 plugins/bStats/ 文件夹中禁用 bStats。

🔧问题与支持

如果你发现任何问题，请在 GitHub 上提交报告。请注意，在评论部分报告的问题将无法获得技术支持。 你的反馈将帮助我改进 NFCNotes，任何建议都随时欢迎！