Cobbleloots：战利品球及更多内容！

Cobbleloots 是一个适用于 Cobblemon 的模组，参考原版 Pokémon 电子游戏，增加了多种获取物品的方式。

重要提示（BETA-2.2.0+）：近期更新引入了破坏性变更，尤其是配置方面。你需要更新配置，以确保兼容性。

Cobbleloots：战利品球及更多内容！
功能
战利品球 💎
获取战利品球
贵重物品 💰
地图制作 🗺️
自定义战利品球 🎁
模组配置 ⚙️
命令 🛠️
常见问题
如何让战利品球为每位玩家提供战利品，而不仅仅是第一个玩家？
计划中的功能
隐藏物品 🔍
伪装物品 🪤

功能

战利品球 💎

这些球体包含对玩家有用的物品。打开后可以获得经验值和物品，也可以在生存模式中作为装饰性实体使用。当战利品球没有剩余使用次数时，可以将其摧毁并掉落为装饰性物品（此行为可配置）。

获取战利品球

生成：战利品球可以在世界中找到。其中一些与特定生物群系相关，另一些则更为常见。
刷新：随着时间推移，战利品球会在随机玩家周围的世界中生成。
钓鱼：使用 Cobblemon 钓竿钓鱼时，玩家有机会钓到战利品球。不同的钓竿可以钓到不同等级的战利品球，而使用海之眷顾附魔会提高找到战利品球的概率。

战利品球分为多个等级，这些等级决定了它们的稀有度和战利品质量：普通、不常见、稀有和超稀有。

贵重物品 💰

Cobbleloots 加入了 10 种 Pokémon 中的经典贵重物品，可用作交易商品、奖励或服务器经济代币：

金珠和大金珠（cobbleloots:nugget、cobbleloots:big_nugget）
珍珠、大珍珠和珍珠串（cobbleloots:pearl、cobbleloots:big_pearl、cobbleloots:pearl_string）
星尘、星星碎片和彗星碎片（cobbleloots:stardust、cobbleloots:star_piece、cobbleloots:comet_shard）
稀有骨头（cobbleloots:rare_bone）
香味蘑菇（cobbleloots:balm_mushroom）

每种物品都采用自定义的 16×16 像素艺术材质，配有沉浸式悬浮提示，介绍会以高价收购它们的收藏家和商店，并且可以在 Cobbleloots 创造模式标签页中找到。

地图制作 🗺️

查看文档，了解如何在自定义地图中使用该模组的对象和功能。如果仍有疑问，欢迎在我的 Discord 服务器中提问。

注意：文档仍在持续完善中，部分功能可能尚未完全记录。如果你需要特定功能的帮助，请前往我的 Discord 服务器咨询。

自定义战利品球 🎁

使用全新的 Loot Ball 数据系统，通过不同的物品和属性创建自定义战利品球。你可以自定义多个方面，包括：

游戏内显示的名称。
打开时使用的战利品表。
战利品球的材质。
给予玩家的经验值数量。
玩家再次打开战利品球前的玩家专属计时器（冷却时间）。
战利品球出现的来源（例如 generation、spawning），并支持详细筛选条件：
用于控制稀有度的 weight。
structure 标签。
biome 标签（生物群系键、生物群系标签或生物群系字典）。
dimension 列表。
block 标签（用于生成方块或基础方块）。
fluid 标签。
position（带有最小值/最大值范围的 x、y、z 坐标）。
light 等级（生成时的方块光照和天空光照）。
一天中的 time（支持时段选项）。
date 范围（例如季节性活动）。
weather 条件（晴天、下雨、雷暴）。
同一种战利品球类型的变体，每个变体都可以拥有独立的可选名称、材质和战利品表。

其中一些功能仍在持续完善，但该数据系统的设计注重灵活性，并支持未来扩展更多内容。

模组配置 ⚙️

模组配置由 MidnightLib 提供支持，并支持在游戏内编辑：

Fabric：通过 ModMenu 编辑。
NeoForge：通过模组菜单编辑。
命令：服务器 OP 可以使用 /midnightconfig cobbleloots <key> <value>。

配置文件位于 Minecraft 实例的 config 文件夹中。更多信息请查看配置文档。

命令 🛠️

Cobbleloots 提供了多种游戏内命令，帮助服务器管理员和地图制作者管理战利品球：

/cobbleloots reset loot_ball target [player] [restore_uses]：重置视线范围内（16 格以内）的战利品球，可为自己或指定的玩家执行。
/cobbleloots reset loot_ball all [player] [restore_uses]：重置世界中的所有战利品球（未加载区块也会自动持久化处理）。
/cobbleloots reset loot_ball entity <selector> [player] [restore_uses]：重置与实体选择器匹配的特定战利品球。
/cobbleloots reset loot_ball undo [player]：撤销上一次执行的重置操作。
/cobbleloots debug weights [source_type] [pos]：显示当前位置候选战利品球的加权生成概率表。
/cobbleloots debug check <id> [source_type] [pos]：评估指定战利品球 ID 的每个筛选条件，并报告检查通过或失败的结果。

查看完整的命令参考，了解详细的参数、权限和示例。

常见问题

如何让战利品球给每个玩家都发放战利品，而不只是第一个玩家？

这是服务器中常见的设置，你希望所有玩家都能从同一个球中收集战利品。

你需要两件事：

无限使用 — 将战利品球上的 uses NBT 标签设置为 -1。使用次数为 -1 的战利品球是无限的，并且按每位玩家独立计算：每个玩家都能独立获得自己的战利品。
玩家冷却 _（可选）_ — 将 PlayerTimer NBT 标签设置为一个刻数。这是玩家再次从同一个球收集战利品前的冷却时间。如果省略（或设置为 0），每个玩家只能收集一次。

要将此全局应用于所有新战利品球，请更新默认配置值：

将 loot_ball_default_uses 设置为 -1 → 所有新生成/产生的战利品球都将拥有无限使用次数。
将 loot_ball_default_player_cooldown 设置为所需的冷却刻数（例如 72000 = 1 小时）→ 玩家可以在该时间后再次收集。设置为 0 则允许每个玩家恰好收集一次，无法再次收集。

更多详情请参阅配置文档。

计划中的功能

隐藏物品 🔍

受原版宝可梦游戏启发，隐藏物品是散落在世界各处的隐形物体，等待被发现。

假物品 🪤

请注意，有些物体可能并非表面看起来那样。宝可梦有时会伪装成物体来欺骗你。

Cobbleloots: Loot Balls and More!

截图

介绍