Paper currency - banknote with anti-dupe - 纸钞货币 - 防复制经济插件

PaperCurrency 是一款简单高效的 Minecraft 材质货币管理插件，内置防复制机制，支持与 Vault 经济系统无缝集成，并提供灵活的配置选项和丰富的视觉效果。

💡功能特性

• 便捷管理：易于使用的界面，轻松管理货币。
• 快速兑换：右键点击即可快速兑换纸币。
• 经济集成：无缝集成 Vault，实现平滑的经济与资金处理。
• 防复制系统：强大的防复制机制，防止纸币被复制。
• 材质自由：可使用任意材料作为货币。
• 灵活取款：可提取任意所需金额。
• 自动惩罚：对试图复制货币的行为进行自动处罚。
• 限额配置：可配置最小和最大交易限额。
• 可选税收：可为纸币配置税收，以平衡经济。
• 取款上限：控制游戏内货币流动的最大取款限额。
• Discord 警报：通过 Webhook 发送重要货币事件警报。
• 等级音效：为不同玩家等级或角色设置独特的音效。
• 视觉特效：为货币添加醒目的发光效果。
• 信息显示：通过 MiniMessages、ActionBar 和标题显示货币信息。
• 多世界黑名单：支持多世界黑名单功能。
• 自定义描述：支持在物品描述（Lore）中使用任何占位符。
• 贷款系统：引入新的贷款系统，用于高级货币管理。
• 自定义模块：支持自定义模块数据，并提供免费材质包（可从 GitHub 下载）。
• Hex 颜色：全插件支持 Hex 颜色代码。

✨安装指南

• 从 Spigot 页面下载本插件及 Vault。
• 将下载的文件放入您 Minecraft 服务器的 plugins 文件夹。
• 重启服务器以加载插件及其依赖。
• 根据需要为玩家授予相应权限。
• 开始享受流畅的材质货币管理。

依赖项：Vault + 任意经济插件 + PlaceholderAPI

🎮权限列表

• pc.withdraw：授予提取货币的权限。
• pc.redeem：授予兑换纸币的权限。
• pc.admin：授予插件的管理权限。
• pc.withdrawall：授予提取所有可用货币的权限。
• pc.loan：授予使用贷款系统的权限。
• pc.balance：查看纸币中总经验值和金钱的权限。

🔧命令列表

• /papercurrency withdraw <金额> 或 /papercurrency withdraw <金额> xp：提取指定金额的货币或经验。
• /pcreload：重载插件配置。
• /pc give <玩家>/all <金额> 或 /pc give <玩家>/all <金额> xp：给予特定玩家或所有玩家一定金额的货币或经验。
• /pcmax withdraw 或 /pcmax withdraw xp：提取允许的最大货币或经验金额。
• /pcrandom give <玩家> <最小值> <最大值> 或 /pcrandom give <玩家> <最小值> <最大值> xp：给予玩家指定范围内的随机金额货币或经验。
• /pcbalance：查看纸币中总经验值和金钱。

⭐占位符

• %papercurrency_totaltax%：显示从 Vault 收取的总税收。
• %papercurrency_totaltaxxp%：显示从经验值收取的总税收。

❓常见问题

问：防复制功能是如何工作的？

答：插件在每张纸币创建时会为其分配一个唯一的 UUID 并保存。当纸币被兑换时，插件会检查该 UUID 是否已被使用过，从而有效防止复制。

问：纸币有可能被复制吗？

答：虽然从技术上讲可以创建重复的纸币，但插件的防复制系统会识别重复的 UUID，并在兑换时不会增加任何额外的货币。

问：存在误封的风险吗？

答：不存在。插件包含 punishsame 选项，该选项仅在纸币创建者和兑换者是同一玩家时才会执行封禁。否则，它只会发出警告，并且不会增加来自重复纸币的货币。

问：使用命令时出现空值（null）错误？

答：请安装 PlaceholderAPI 来修复此问题。或者，您也可以将配置中 %formatter_number_format_%amount%% 格式的占位符替换为 %amount%，这样就不需要 PlaceholderAPI 了。

🔧开发计划

• 每笔交易记录器。
• 记录被其他玩家兑换的纸币。

✨致谢

捐赠者：MCbasement - $50

💡免责声明

欢迎您提出任何改进插件的建议。

如果您遇到任何问题或有任何功能需求，请使用讨论区或 GitHub 页面进行反馈。

Discord：仅用于快速支持（链接略）。

视频演示：（略）

---

默认配置预览

# 通用设置
item: 'PAPER'
name: '☆⁺˚*♡#fb0000P#fb1500a#fb2a00p#fa3f00e#fa5400r#fa6900c#fa7f00u#f99400r#f9a900r#f9be00e#f9d300n#f8e800c#f8fd00y♡⁺˚*☆'
glow: true

# 每人纸币创建上限
limitvault: 1000
limitxp: 1000
custom_data_vault: 2222
custom_data_xp: 2222

# 帮助将纸币从 1.5 版本转换至最新版
legacy: false

# 如果纸币创建者和兑换者是同一人则无税，若不同则税收归服务器
taxother: false

#----------------------------------
# 如果 punishment 为 true，插件将在发现复制时封禁
# 如果 punishmentsame 为 true，插件仅在纸币制作人和兑换者是同一人时才封禁
# 这可以防止在复制纸币被分发时误封（无人会获得金钱，但仍会显示复制信息）
punishment: false
punishmentsame: true
# 可设置为 ban, kick, ipban 等
punish: 'ban'
banmessage: 'found you duping'
#----------------------------------

# 添加拥有特殊音效的等级
ranks:
  - vip
  - default
# 音效列表：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
# global 音效适用于不在 ranks 列表中的玩家
sound:
  global: 'BLOCK_ANCIENT_DEBRIS_STEP'
  default: 'BLOCK_ANVIL_PLACE'
  vip: 'ENTITY_EXPERIENCE_ORB_PICKUP'
  volume: 1
  pitch: 0
#----------------------------------

actionbar: true
title: true
round: true

#----------------------------------
# Discord Webhook
webhook: false
# 获取此链接：进入您希望接收消息的频道设置 -> 集成 -> 创建新的 Webhook 并复制粘贴至此
url: 'https://discord.com/api/webhooks/123/blabla'
#---------------------------------

# 添加您希望允许使用命令的世界
worlds:
  - 'world'
  - 'world_nether'
  - 'world_the_end'
  - 'pvp'
#---------------------------------

message:
  dupe: '&cDuper found %player% is redeemer and %player1% is note creater'
  discord: 'Duper found %player% is redeemer and %player1% is note creater'
  world: '&cThis command is not allowed in this world'
  limit: '&cReached creation limit'
  balance: '&fYou have &6%totalxp%&2xp &fand &2$&6%totalvault%'
#---------------------------------

# 经济设置
pc:
  min: 1
  max: 100000000
  # 1=无税, 0.1=10%, 0.2=20%
  tax: 0.1
  message:
    # 可使用 PlaceholderAPI，如示例所示
    # 别忘了执行 /papi ecloud download Formatter
    lore:
      - '#fb0000+#ef030d-#e20619-#d60926-#ca0c33-#bd0f3f-#b1114c-#a51459-#981765-#8c1a72-#801d7f-#73208b-#672398-#5a26a4-#4e29b1-#422cbe-#352eca-#2931d7-#1d34e4-#1037f0-#043afd+'
      - '&bAmount - &6$&2%formatter_number_format_%amount%%'
      - '&7by %player% &7on &8%date%'
      - '&7Tax : &d%tax%%'
      - '#fb0000+#ef030d-#e20619-#d60926-#ca0c33-#bd0f3f-#b1114c-#a51459-#981765-#8c1a72-#801d7f-#73208b-#672398-#5a26a4-#4e29b1-#422cbe-#352eca-#2931d7-#1d34e4-#1037f0-#043afd+'
    redeem: '&a%amount%- amount of banknote is added to balance'
    amount: '&eYou dont have %amount%'
    actionbar: '&6>> &6$&a%amount%- amount of banknote is added to balance &6<<'
    title: '&6>> &6$&a%amount%- amount of banknote is added to balance &6<<'
#------------------------------

# 经验设置
xp:
  min: 1
  max: 1000
  tax: 1
  message:
    lore:
      - '&6+------------------ -+'
      - '&bAmount - &2%amount% &6xp'
      - '&7by %player% &7on &8%date%'
      - '&7Tax : &d%tax%%'
      - '&6+------------------ -+'
    redeem: '&a%amount%- amount of xp is added to balance'
    amount: '&eYou dont have %amount% xp'
    actionbar: '&6>> &a%amount%- amount of xp is added to balance &6<<'
    title: '&6>> &a%amount%- amount of xp is added to balance &6<<'
#--------------------------------------------------

# 贷款系统
loan:
  min: 1
  max: 10000
  # 利率百分比
  intrest: 2
  increment: 1
  # 单位：秒
  every: 60
  maxintrest: 100
  # 提醒间隔（秒），-1 为关闭提醒
  reminder: 3600
  message:
    negative: '&cNegetive or zero loan not allowed'
    loan: '&2loan recived of $%amount%'
    already: '&cyou already have a loan of $%amount%'
    fullpay: '&2Full amount paid of $%amount%'
    notpaid: '&eFull amount not paid, You still have $%amount% to pay'
    repay: '&2You dont have any loan'
    reminder: 'You have %amount% loan dont forget to pay'

媒体与里程碑

• 100 次下载 ✅
• 200 次下载 ✅
• 500 次下载
• 1000 次下载