Shiny Charm Plus

Shiny Charm Plus is a Cobblemon addon that adds an upgraded Shiny Charm — boost your wild shiny encounter odds simply by carrying it in your inventory.

✨ Features

🔷 Base Shiny Boost

While the Shiny Charm Plus is in your inventory (main hand, off-hand, cursor, Trinkets belt, or Accessories charm slot), your wild shiny encounter chance is doubled (configurable, default 2×).

⏱️ Time-Based Bonus (Optional)

Turn on enableTimeBonus and the multiplier grows the longer you carry the charm. Every N minutes (default 30), the multiplier increases by a set amount (default +2.0), up to a configurable cap (default 16×). When a catchable wild shiny spawns nearby, the accumulated bonus resets — your persistence is rewarded!

🔄 Reset on Shiny

When a catchable wild shiny Pokémon appears near a charm holder, the accumulated time bonus is reset, keeping the mechanic balanced. A red chat message and sound notify the player.

🎛️ Per-Player Overrides

Admins can set individual config values for specific players, overriding global settings. Different players can have different multipliers, intervals, etc.

📊 Placeholder API Support

Exposes %shiny_charm_plus:denominator% for use with scoreboards, HUDs, chat displays, or any Placeholder API-compatible mod.

🛠️ ModMenu Config GUI

A built-in config GUI accessible via ModMenu — no Cloth Config required. Uses vanilla widgets with tooltips, fully translated.

📦 How to Obtain

The Shiny Charm Plus is available in the Tools creative tab. A survival crafting recipe can be added via datapack or other mods.

⚠️ This mod does not add a survival recipe by default. Server admins can distribute the item via commands.

⚙️ Configuration

Config file: config/shiny_charm_plus.json

All values can be changed in-game via commands or the ModMenu config screen.

🖥️ Commands

All commands require permission level 2 (operator). Root: /shiny_charm_plus

Player fields: multiplier, bonus_time, bonus_amount, max_multiplier, time_bonus

🔗 Integrations

All integrations are soft dependencies — the mod works perfectly without any of them.

📋 Dependencies

Optional: ModMenu, Trinkets, Placeholder API

❓ FAQ

Q: Does the charm work from my inventory, or do I need to hold it? A: Anywhere — main hand, off-hand, cursor, any inventory slot, Trinkets belt, or Accessories charm slot.

Q: Is this compatible with other shiny-boosting mods? A: Yes. It hooks into Cobblemon's SHINY_CHANCE_CALCULATION event alongside other modifiers. Multipliers stack multiplicatively.

闪耀护符 Plus 是一个 Cobblemon 附属模组，添加了闪耀护符的升级版——只需将其携带在背包中，即可提升你遭遇野生闪光宝可梦的概率。

✨ 功能

🔷 基础闪光加成

当 闪耀护符 Plus 在你的物品栏中（主手、副手、鼠标手持、Trinkets 腰带槽、Accessories 护符槽），你的野生闪光遭遇概率将翻倍（可配置倍率，默认 2×）。

⏱️ 时间累积加成 (可选)

开启 enableTimeBonus 后，携带护符的时间越长，倍率越高。每经过 N 分钟（默认 30），倍率增加一个固定值（默认 +2.0），直到达到可配置的上限（默认 16×）。当附近出现可捕捉的野生闪光宝可梦时，累积加成会重置——你的坚持狩猎会得到回报！

🔄 闪光重置

当一只可捕捉的野生闪光宝可梦在护符持有者附近生成时，累积时间加成将被重置，保持机制平衡。玩家会收到红色聊天栏提示和音效。

🎛️ 玩家独立配置

管理员可以为特定玩家设置独立的参数值，覆盖全局配置。不同玩家可以使用不同的倍率、时间间隔等。

📊 Placeholder API 支持

暴露 %shiny_charm_plus:denominator% 占位符，可用于计分板、HUD、聊天栏等任何兼容 Placeholder API 的显示。

🛠️ ModMenu 配置界面

通过 ModMenu 访问内置配置界面——无需 Cloth Config。基于原版控件（文本输入框 + 按钮开关），含中文提示说明。

📦 获取方式

闪耀护符 Plus 可在创造模式的**工具（Tools）**物品栏中找到。生存模式的合成配方可通过数据包或其他模组添加。

⚠️ 本模组默认不添加生存模式合成配方。服务器管理员可通过命令分发物品，或通过数据包自定义配方。

⚙️ 配置

配置文件位置：config/shiny_charm_plus.json

所有配置均可在游戏内通过命令或 ModMenu 界面实时修改。

🖥️ 命令

所有命令需要权限等级 2（管理员/命令方块）。根命令：/shiny_charm_plus

玩家字段： multiplier, bonus_time, bonus_amount, max_multiplier, time_bonus

🔗 联动

以上均为软依赖，未安装时不影响模组正常运行。

📋 依赖

可选： ModMenu、Trinkets、Placeholder API

❓ 常见问题

Q: 护符需要拿在手里还是放在背包就行？ A: 任意位置均可——主手、副手、鼠标手持、背包任意格子、Trinkets 腰带槽、Accessories 护符槽。

Q: 和其他闪光加成模组兼容吗？ A: 兼容。本模组通过 Cobblemon 的 SHINY_CHANCE_CALCULATION 事件挂载倍率修改器，与其他加成乘法叠加。