Cobblemon 卡片

一款沉浸式且功能丰富的 Minecraft 模组（支持 Fabric 和 NeoForge），为 Cobblemon 世界带来了终极卡牌收集游戏！ 收集、交易、评级，并在精美的 3D 全息动画卡牌上自豪地展示您最喜爱的精灵宝可梦。

💫 主要特色

🛍️ 主题与世代补充包

• 超过20种不同的补充包，可使用交互式自定义开启界面打开。
• 第一至第九世代：专注于特定地区和世代的收集！
• 属性主题补充包：通过包含特定属性（火、水、草、电、幽灵等）的元素包来定向搜索。
• 传说卡包券：一种传奇物品，保证您的下一个补充包将是超稀有的“传说卡包”！

🎴 可收集的精灵宝可梦卡牌

• 多种稀有度等级：普通、稀有、史诗、传说 和 神话。
• 视觉变体：普通卡牌和全艺术闪光（异色）变体，带有自定义视觉模型。
• 特殊形态：完全集成了地区形态（阿罗拉、伽勒尔、洗翠）和超级进化。

✨ 动态全息着色器与视觉效果

见证超过20种独特的程序化全息效果，这些效果由自定义着色器驱动，会随着您的视角移动而闪烁变化：

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

📖 卡牌收集册与储存柜

• 分级收集册：可制作皮革、铁、金、钻石、下界合金以及终极大师相册。
• RPG 属性与被动增益：在饰品栏装备收集册！放入的卡牌会提供被动属性增益（挖掘速度、移动速度、攻击伤害、幸运值、护甲值、最大生命值以及自定义野生生成概率倍数）。
• 卡牌储存柜：一件精美的家具，最多可存储 12,000 张卡牌，内置搜索、排序和过滤功能。

🔬 评级站与回收系统

• 评级站：分析并评定您的卡牌（1至10级）。高等级卡牌可为活跃的 RPG 属性提供巨大倍数增益！
• 卡牌回收机：将重复或不想要的卡牌研磨成卡牌粉尘。
• 使用粉尘为扫描设备供能或加速卡牌评级过程。

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

• 即时图鉴扫描仪：一种手持实用工具，用于扫描野外中的野生精灵宝可梦。
• 卡牌结构光盘：装入卡牌粉尘，锁定目标物种，在野外扫描它们，一旦完成度达到 100%，即可打印出实体卡牌！

🌌 3D 全息投影仪

• 使用普通和高级全息投影仪，在您的基地展示您的珍藏卡牌。
• 6种显示模式：连续旋转、面向玩家、动态（旋转和面向）、固定、平放和简单浮动。
• 高级投影仪允许您放入并排列多达 27 张卡牌的动态画廊！

⚙️ 配置 (MidnightConfig)

⚙️ 点击展开配置选项

Cobblemon Cards 通过 MidnightConfig 实现开箱即用的完全可配置性。您可以在游戏中访问配置菜单（需要 ModMenu），或编辑 config/cobblemon-cards.json 文件。

配置选项	默认值	范围/类型	描述
globalStatMultiplier	10.0	0.1 - 100.0	应用于所有由已放入卡牌提供的被动 RPG 属性加成的倍数。
recyclerProcessTime	40	1 - 1200	卡牌回收机处理一张卡牌所需的时间（以刻为单位）。
gradingStationProcessTime	100	1 - 12000	评级站评级一张卡牌所需的时间（以刻为单位）。
gradingStationDustCost	5	0 - 64	评级一张卡牌所需的卡牌粉尘数量。
godPackTicketChance	1.0	0.0 - 100.0	打开补充包时获得传说卡包券的百分比概率。
cardDropChance	1.0	0.0 - 100.0	击败或捕获的精灵宝可梦掉落卡牌的百分比概率。
enableBoosterChestSpawn	true	布尔值	经典补充包是否应该在 Minecraft 结构宝箱中生成。
boosterChestSpawnChance	2.0	0.0 - 100.0	在结构宝箱中找到经典补充包的百分比概率。

📦 整合包集成与独立使用须知

[!注意] 专为整合包设计： Cobblemon Cards 主要设计并平衡为更大整合包的一部分来游玩。虽然我们已确保所有内容都能作为独立模组完美运行（作为 Cobblemon 的完整扩展），但其游戏循环、掉落率和 RPG 属性奖励在与其他模组、任务和自定义进度系统集成时效果最佳。

🛠️ 必需依赖项

要运行 Cobblemon Cards，请根据您的模组加载器下载并放置正确版本的依赖项：

🪶 对于 Fabric 用户

模组	所需版本	用途
Fabric API	0.116.10+1.21.1	Fabric 核心库
Cobblemon	1.6.0+	精灵宝可梦核心模组
Architectury API	13.0.6+	跨平台兼容性助手
Cloth Config	15.0.140+	模组配置和 UI 系统
Trinkets	3.10.0+	启用饰品槽以装备收集册，获得 RPG 属性
MidnightLib	1.9.2+1.21.1	轻量级配置库
Cardinal Components	6.1.3+	实体数据附加系统

🛠️ 对于 NeoForge 用户

模组	所需版本	用途
Cobblemon	1.6.0+	精灵宝可梦核心模组
Architectury API	13.0.6+	跨平台兼容性助手
Cloth Config	15.0.140+	模组配置和 UI 系统
Accessories	1.1.0-beta.53+	启用饰品槽以装备收集册，获得 RPG 属性
MidnightLib	1.9.2+	轻量级配置库

[!提示] 配方查看器 (EMI, REI, JEI)： 该模组完全集成了配方查看器的 compileOnly 合约。这使得玩家可以轻松地在游戏中查看收集册、储存柜、回收机和评级站的自定义合成配方！

🚀 安装指南

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

💻 面向开发者：从源代码编译

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

1. 克隆此仓库：

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

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

   ./gradlew genSources
   

3. 构建模组 JAR 文件（编译后位于 build/libs/ 下）：

   ./gradlew build
   

🤫 彩蛋

🔍 点击此处揭示模组的秘密！（剧透警告）

👤 自定义玩家卡牌

• 当您的物品栏中有卡牌结构光盘时，使用即时图鉴扫描仪扫描另一名玩家，将立即消耗该光盘并打印一张神话级 10 级装饰性卡牌，上面带有该玩家的 Minecraft 皮肤！
• 注意：玩家卡牌纯属装饰，不提供被动属性增益。

👾 传奇的 MissingNo.

• 如果您在夜晚满月期间，并处于黑暗效果影响下扫描精灵宝可梦，现实的架构会发生故障！
• 您将听到一声令人不安的故障尖叫声，并获得传奇的神话级 10 级 MissingNo. 卡牌，带有自定义故障像素艺术纹理和特殊属性！

👻 紫苑镇之魂

• 在接近午夜时（世界时间刻度 16000 至 20000），站在灵魂沙或灵魂土上，扫描鬼斯、鬼斯通、耿鬼、卡拉卡拉或嘎啦嘎啦。
• 可以获得一张神话级 10 级装饰性卡牌，上面有可怕的紫苑镇之魂！

🌟 神之大牙狸

• 副手持有金苹果或附魔金苹果时，扫描野生大牙狸。
• 可以获得传奇的神话级 10 级神之大牙狸装饰性卡牌！

💎 水晶大岩蛇

• 副手持有紫水晶碎片时，扫描野生大岩蛇。
• 可以获得一张神话级 10 级装饰性卡牌，上面有惊艳的水晶大岩蛇！

🖤 暗影洛奇亚

• 在雷暴期间，并处于凋零效果影响下，扫描野生洛奇亚。
• 可以获得一张神话级 10 级装饰性卡牌，上面有被腐蚀的暗影洛奇亚！

🏳️‍⚧️ 骄傲仙子伊布

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

💝 你与梦幻

• 物品栏中携带自定义玩家卡牌（通过扫描其他玩家获得）时，扫描野生梦幻。
• 会消耗玩家卡牌和结构光盘，并获得一张终极神话级 10 级装饰性卡牌，代表您和梦幻！

🎵 唱片机全息音乐

• 将全息投影仪或高级全息投影仪直接放置在唱片机上方，并放入一张卡牌，将触发自定义的精灵宝可梦音乐曲目！
• 播放的曲目会根据卡牌的稀有度、闪光状态或属性动态适配：
  • 神话级：魂心
  • 传说级且闪光：战斗！奈克洛兹玛
  • 传说级：竹兰
  • 其他闪光：战斗！希嘉娜
  • 火属性或攻击属性：战斗！等离子队
  • 水属性或速度属性：209号道路
  • 草属性或生命属性：未白镇
  • 冰属性或护甲属性：雪峰市

📜 许可证

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

由 Minecraft 中的精灵宝可梦卡牌爱好者 ❤️ 制作。