Xen's Trading Cards - 可配置怪物卡牌收集插件

Trading Cards 是一款为 Minecraft 服务器设计的趣味收集插件，允许你创建可被怪物随机掉落的“卡牌”。它拥有极高的可定制性，并包含卡组、卡包和定期赠送等独特功能，为喜欢收集的玩家带来无限乐趣。

💡核心特性

卡牌

卡牌是插件的核心。它们是带有自定义名称和描述的纸片，代表你配置的收藏卡。

• 默认包含所有当前及部分已移除的 Minecraft 生物。
• 可从敌对生物、中立生物、被动生物和首领生物处随机掉落，掉落率可配置。
• 支持闪亮版本，拥有极低的出现几率。
• 每张卡牌可配置系列、类型、描述和购买价格。

卡组

卡组是专门用于安全存放卡牌的自定义容器。

• 可配置为 27 格（单箱）或 54 格（双箱）。
• 只能存放卡牌，其他物品会被自动弹出或删除。
• 用于追踪玩家拥有的卡牌，是完成稀有度收集的基础。
• 可通过 /cards getdeck <编号> 获取。

卡包

卡包是支持服务器经济的特色功能，允许玩家购买随机卡牌组合。

• 完全可配置，可定义卡包内各稀有度卡牌的数量和升级几率。
• 可以完全禁用或调整价格。
• 默认提供四种卡包：Starter_Pack、Advanced_Pack、Expert_Pack、Ultimate_Pack。

收集奖励

当玩家收集齐某一稀有度的所有卡牌时，可以兑换奖励。

• 奖励可配置，例如给予经济奖励、物品或权限组。
• 支持全服广播收集成就。
• 可选择是否将闪亮卡牌计入收集进度。

🎮命令与权限

管理命令

• /cards reload (cards.reload) - 重载插件配置。
• /cards giveaway <稀有度> (cards.giveaway) - 给所有在线玩家一张指定稀有度的随机卡牌。
• /cards giverandomcard <生物名> <玩家名> (cards.giverandomcard) - 给予玩家一张基于特定生物类型的随机卡牌。
• /cards giveboosterpack <玩家名> <卡包名> (cards.giveboosterpack) - 给予玩家一个指定的卡包。
• /cards givecard <稀有度> <卡牌名> (cards.givecard) - 给予一张指定稀有度和名称的普通卡牌。
• /cards giveshinycard <稀有度> <卡牌名> (cards.giveshinycard) - 给予一张指定稀有度和名称的闪亮卡牌。
• /cards create <稀有度> <名称> <系列> <类型> <hasShiny> <描述> (cards.create) - 创建一张新卡牌。
• /cards toggle (cards.toggle) - 切换生物是否掉落卡牌。

玩家命令

• /cards list [玩家名] (cards.list, cards.list.others) - 列出服务器所有卡牌或指定玩家的收集进度。
• /cards listpacks (cards.listpacks) - 列出所有可购买的卡包。
• /cards getdeck <编号> (cards.getdeck) - 获取指定编号的卡组物品。
• /cards buy pack|(card) (<稀有度>) <名称> (cards.buy) - 购买卡包或单张卡牌（需经济系统支持）。
• /cards worth (cards.worth) - 查看手中卡牌的价值。
• /cards resolve <玩家名> (cards.resolve) - 查询玩家的 UUID。
• /cards reward <稀有度> (cards.reward) - 兑换收集齐某一稀有度卡牌的奖励。
• 打开卡包 - (cards.openboosterpack)。
• 获取特定编号卡组 - (cards.decks.#)。

🔧配置指南

创建新卡牌

在 cards.yml 配置文件中，找到目标稀有度（如 Common），并在其下新建一个以卡牌名（游戏内下划线将显示为空格）为键的段落。填入以下值：

卡牌名:
  Series: ‘你的系列名‘
  Type: ‘你的卡牌类型‘
  Has-Shiny-Version: true/false
  Info: ‘卡牌描述（若无则写“None”）‘
  Buy-Price: 100.00 #（可选）购买价格，需 Vault 支持

• Series（系列）：可以是年份、版本号等，用于区分不同卡牌系列。
• Type（类型）：卡牌分类，如“怪物”、“动物”等。
• Has-Shiny-Version：是否生成闪亮版本。
• Info（描述）：卡牌的描述文本。

主要配置选项 (`config.yml`)

• General（常规）：设置服务器名称、卡牌/卡包/卡组的材质和前缀、是否在创造模式使用卡组、卡组大小等。
• Chances（几率）：配置各类生物（敌对、中立、被动、首领）的卡牌掉落率，以及各稀有度的权重。
• BoosterPacks（卡包）：定义每个卡包包含的卡牌数量、稀有度、升级几率和价格。
• Rarities（稀有度）：为每个稀有度设置颜色和收集完成后可执行的奖励命令。
• PluginSupport（插件支持）：配置与 Towny、MobArena、MythicMobs、Vault 的集成选项。
• World-Blacklist（世界黑名单）：禁止卡牌掉落的世界列表。
• Schedule-Cards（定时赠送）：设置是否定期向全服在线玩家赠送卡牌。

✨支持的插件

• Towny
• MobArena
• MythicMobs
• Vault（用于经济系统）

❓常见问题与提示

• 插件完全免费，并已更新支持 1.16.1。
• 默认配置文件已包含大量 Minecraft 生物的卡牌示例。
• 使用 /cards reload 后请检查控制台是否有错误。
• 可通过黑名单/白名单功能控制特定玩家或世界的卡牌掉落。
• 与 MythicMobs 集成时，可基于怪物等级设置不同的掉落几率。
• 玩家在 PvP 中被杀时，可配置其掉落自身角色卡牌的几率。

---

开发者: Xenoyia (xPXenoyia)

致谢: @zThana

GitHub: https://github.com/Xenoyia/XenTradingCards/

捐赠: 开发者出于热爱进行开发，欢迎捐赠以保持其动力。