Paper Money - 纸币系统

PaperMoney 是一个将服务器经济系统中的虚拟货币转化为实体纸币的插件。这些纸币可以在玩家之间自由交易、拆分或合并，为服务器经济增添了实体交互的维度。

💡核心功能

• 实体货币：将账户中的钱提取为实体纸币物品，也可将其存回账户。
• 物品自定义：纸币的材质、名称、描述、附魔、自定义模型数据（custommodeldata）等均可高度自定义，可模拟真实钞票或硬币。
• 全息显示：纸币上方可显示其面值的悬浮全息文字（需配合 HolographicDisplays、DecentHolograms 插件）。
• 拆分与合并：

- **拆分**：可将一张大额纸币拆分为多张指定面额的小额纸币。

- **合并**：可通过将纸币放入副手的方式，将多张纸币合并为一张。

• 沉浸模式：可禁用右键存款功能，让纸币必须通过玩家间交易流通。
• 面值精度：可配置纸币支持的小数位数。
• 外部支持：兼容 PlaceholderAPI，可在物品文本中使用变量。

🎮指令与权限

玩家指令

• /pmoney take <金额> - 从自己账户提取指定金额，生成纸币。

- 所需权限：`papermoney.take`

• /pmoney split <金额1> <金额2> ... - 拆分手中持有的纸币。

- 所需权限：`papermoney.split`

管理员/特殊指令

• /pmoney make <金额> - 凭空生成一张指定面值的纸币（不消耗账户资金）。

- 所需权限：`papermoney.make`

• /pmoney take <金额> <玩家名> - 从指定玩家账户提取金额，生成纸币。

- 所需权限：`papermoney.take.others`

• /pmoney make <金额> <玩家名> - 为指定玩家凭空生成一张纸币（适用于商店、礼包等场景）。

- 所需权限：`papermoney.make.others`

• /pmoney reload - 重载插件配置和语言文件。

- 所需权限：`papermoney.reload`

🔧配置说明

主要配置文件为 config.yml 和 messages.yml。

config.yml 关键选项

• Prefix: 插件消息前缀。
• Enable_Money_Splitting: 是否启用纸币拆分功能。

- **警告**：启用此功能本质上允许复制纸张物品，请谨慎使用并确保玩家拥有 `papermoney.split` 权限。

• Min_Amount: 纸币的最小面值，防止创建面值为0的纸币进行复制。
• Maximum_Decimal_Places: 纸币面值支持的最大小数位数（例如 2 代表支持到“分”，如 $19.99）。
• Use_Holograms_If_Possible: 是否启用全息显示。
• Disable_Right_Click_Deposit: 设为 true 可禁用右键存款，实现完全实体货币流通。
• Item: 用于自定义纸币的物品属性。

- `id`: 物品材质（如 `PAPER`）。

- `custommodeldata`: 用于配合资源包自定义纹理。

- `Item_Name` 和 `Item_Lore`: 物品显示名称和描述，支持变量：

- `%pm_bill_worth%` - 纸币面值

- `%pm_player_money%` - 玩家持有金额

- `%pm_player_name%` - 玩家名称

messages.yml

用于自定义插件发送的所有提示信息，使其更符合服务器风格或支持多语言。

✨依赖与要求

• 必需插件：

- Vault (用于经济系统挂钩)

• 可选插件：

- HolographicDisplays (V3.0+) 或 DecentHolograms (用于全息显示)

- PlaceholderAPI (用于在物品文本中使用更多变量)

❓注意事项与提示

• 纸币拆分功能 (Enable_Money_Splitting) 存在复制纸张的基础物品风险，请在了解风险后启用，并配合权限管理使用。
• 通过 custommodeldata 配合资源包，可以将纸币外观改为真实的美元、硬币或其他自定义纹理。
• 合并纸币的操作方法是：主手持有一张纸币，副手也放入纸币，按 F 键（交换手中物品）即可合并。可重复操作合并多张。
• 当 Disable_Right_Click_Deposit 启用时，纸币将无法通过右键点击存回银行，实现了完全实体化的经济系统，货币分发方式需服务器自行设计。

---

支持开发

如果您喜欢这个插件，可以考虑支持开发者（一名大学生）：

• PayPal: https://paypal.me/AaronSkeels