Cobblemon Cards

一款沉浸式且功能丰富的 Minecraft 模组（Fabric 与 NeoForge），为 Cobblemon 宇宙引入了终极集换式卡牌游戏！
收集、交易、评级，并自豪地将你最喜欢的宝可梦展示在精美的 3D 卡牌上，卡牌配有动态全息光影。

🌟 主要特性

📦 主题与世代补充包

• 超过 20 种不同的补充包，可通过交互式自定义开包界面开启。
• 第 1 至第 9 世代：将你的收藏聚焦于特定地区和世代！
• 属性主题补充包：通过仅包含特定属性（火、水、草、电、幽灵等）的元素补充包来精准搜寻。
• 神包券：一件传说级物品，保证你的下一个补充包将是超稀有的“神包”！

🎴 可收集的宝可梦卡牌

• 多个稀有度等级：普通、罕见、稀有、史诗、传说和神话。
• 视觉变体：普通卡牌和全画幅闪光（Chromatiques）变体，配有自定义视觉模型。
• 特殊形态：完整集成地区形态（阿罗拉、伽勒尔、洗翠）和超级进化。

✨ 动态全息光影与视觉效果

见证超过 20 种独特的程序化全息效果，由自定义光影驱动，随着你的视角移动而闪烁变幻：

• 箔星、彩虹棱镜、等离子、宇宙星座、赛博尘埃、魔法之风……
• 自定义特殊形态效果，如超级漩涡、阿罗拉海岸、伽勒尔蒸汽、帕底亚太晶、扭曲裂隙、时间齿轮、空间裂缝和棱镜之星……

📖 卡册与储物柜

• 分级卡册：制作皮革、铁、金、钻石、下界合金卡册，以及终极的大师图鉴。
• RPG属性与被动加成：将卡册装备到饰品栏位！插入卡册的卡牌会提供被动属性加成（挖掘速度、移动速度、攻击伤害、幸运、护甲、最大生命值，以及自定义的野生生成率倍率）。
• 卡牌柜：精美的家具，可存放多达12,000张卡牌，并内置搜索、排序和筛选功能。

🔬评级站与回收系统

• 评级站：分析并评定卡牌等级（1至10级）。高等级卡牌可大幅提升生效中的RPG属性！
• 卡牌回收机：将重复或不需要的卡牌研磨成圆石卡牌粉尘。
• 使用粉尘为扫描设备供能，或加快卡牌评级流程。

📡即时图鉴工具与结构圆盘

• 即时图鉴扫描器：可手持使用的工具，用于扫描野外的宝可梦。
• 卡牌结构圆盘：装入卡牌粉尘并锁定目标种类，然后在野外扫描；编译进度达到100%后，即可打印出实体卡牌！

🌌3D全息投影仪

• 使用普通和高级全息投影仪，在基地展示你的珍藏卡牌。
• 6种展示模式：持续旋转、面向玩家、动态（旋转并面向玩家）、固定、平面和简单浮动。
• 高级投影仪可插入并依次展示动态卡牌画廊，最多包含27张卡牌！

⚙️配置（MidnightConfig）

<details> <summary>⚙️点击展开配置选项</summary>

Cobblemon Cards 开箱即用，且可通过MidnightConfig进行全面配置。你可以在游戏内打开配置菜单（需要ModMenu），也可以编辑config/cobblemon-cards.json文件。

</details>

📦 整合包适配与独立运行说明

[!NOTE] 专为整合包设计：Cobblemon Cards 主要面向大型整合包进行设计与平衡。虽然本模组经过精心打造，作为 Cobblemon 的完整附属模组也能独立完美运行，但与其他模组、任务和自定义进度系统搭配时，游戏循环、掉落率和 RPG 属性奖励才能发挥最佳效果。

🛠️ 必需的前置

要运行 Cobblemon Cards，请根据所使用的模组加载器，下载并安装对应版本的前置：

🪶 Fabric 用户

🛠️ NeoForge 用户

[!TIP] 配方查看器（EMI、REI、JEI）：本模组已完整集成配方查看器的 compileOnly 接口，方便玩家在游戏中查看束带、柜子、回收机和评级站的自定义合成配方！

🚀 安装指南

1. 为 Minecraft 1.21.1 下载并安装 Fabric 加载器或 NeoForge。
2. 下载上方列出的依赖项，并将它们放入 .minecraft/mods 文件夹。
3. 下载或编译 Cobblemon Cards .jar 文件，并将其放入 mods 文件夹。
4. 启动游戏，开启你的终极收藏之旅！

💻 开发者指南：从源代码编译

如果你想修改源代码或手动构建模组：

1. 克隆此代码仓库：

   git clone https://github.com/Howlite-UI/CobblemonCards.git
   cd CobblemonCards

1. 反编译并设置 Minecraft 环境：

   ./gradlew genSources

1. 构建模组 JAR（编译后可在 build/libs/ 中找到）：

   ./gradlew build

🤫 彩蛋

<details> <summary>🔍 点击此处揭开模组的秘密！（剧透）</summary>

👤 自定义玩家卡牌

• 背包中携带卡牌结构盘时，使用即时图鉴扫描仪扫描另一名玩家，即可立即消耗结构盘，并获得一张神话级 10 阶装饰卡牌，上面印有该玩家的 Minecraft 皮肤！
• 注意：玩家卡牌纯属装饰，不会提供被动属性加成。

👾 传说中的 MissingNo.

• 夜间处于黑暗效果影响下的满月期间扫描宝可梦，现实的帷幕便会发生故障！
• 你会听到令人毛骨悚然的故障尖叫声，并获得传说中的神话级 10 阶 MissingNo. 卡牌，卡牌采用自定义故障风像素画纹理，并拥有特殊属性！

👻 紫苑镇幽灵

• 午夜前后（世界时间刻数为 16000 至 20000），站在灵魂沙或灵魂土上扫描 Gastly、Haunter、Gengar、Cubone 或 Marowak。
• 即可获得一张描绘诡异紫苑镇幽灵的神话级 10 阶装饰卡牌！

🌟 神圣的 Bidoof

• 副手持有金苹果或附魔金苹果时，扫描一只野生 Bidoof。
• 即可获得传说中的神话级 10 阶装饰卡牌：神圣的 Bidoof！

💎 水晶 Onix

• 副手持有紫水晶碎片时，扫描一只野生 Onix。
• 即可获得一张描绘惊艳水晶 Onix 的神话级 10 阶装饰卡牌！

🖤 暗影 Lugia

• 雷暴期间处于凋零状态效果影响下时，扫描一只野生 Lugia。
• 即可获得一张描绘堕落暗影 Lugia 的神话级 10 阶装饰卡牌！

🏳️‍⚧️ 骄傲月 Sylveon

• 副手持有粉红色染料、淡蓝色染料或白色染料（跨性别骄傲旗的颜色）时，扫描一只野生 Sylveon。
• 即可获得一张骄傲月 Sylveon 的神话级 10 阶装饰卡牌！

💝 你与 Mew

• 背包中携带一张自定义玩家卡牌（通过扫描另一名玩家获得）时，扫描一只野生 Mew。
• 此操作会消耗玩家卡牌和结构盘，并获得终极神话级 10 阶装饰卡牌，描绘你与 Mew！

🎵 唱片机全息音乐

• 将全息投影仪或高级全息投影仪直接放在唱片机上方，并插入一张卡牌，即可触发自定义宝可梦音乐！
• 播放的曲目会根据卡牌的稀有度、闪光状态或属性动态变化：
  • 幻之宝可梦: 灵魂之心
  • 传说级 & 闪光: 对战！奈克洛兹玛
  • 传说级: 竹兰
  • 其他闪光宝可梦: 对战！米可利
  • 火属性或攻击属性值: 对战！等离子队
  • 水属性或速度属性值: 209号道路
  • 草属性或生命值: 未白镇
  • 冰属性或护甲属性值: 雪峰市 </details>

📜 许可证

本项目采用 CC0 1.0 通用许可证授权，详情请参阅 LICENSE 文件。

由 Minecraft 宝可梦卡牌爱好者用 ❤️ 制作。