ILoveMagic

Tired of the long walk, or of hunting for magic buckets? Now you just press F6 or F7, and the map's magic buckets come to you.

In Voodoo Fishin', magic buckets spawn in pairs somewhere in the map. Finding them, carrying one where you want it, then going back for its partner is a lot of walking for a teleport pair.

This mod does not create new buckets. It picks up buckets that are already spawned — from a distance. Press F6 to bring one into your hands, press F7 to bring its partner. Drop them wherever you like with the game's normal drop key, and the pair is connected.

Usage

1. Press F6 — one of the map's existing magic buckets is placed in your hands.
2. Carry it wherever you want and drop it with the game's normal action for heavy objects.
3. Press F7 — its partner bucket is placed in your hands.
4. Carry it somewhere else and drop it. The two buckets are now linked: step into either one and you come out at the other.

Both keys are configurable.

Installation

With a mod manager (Thunderstore Mod Manager, r2modman, Gale): install normally — BepInEx 6 (IL2CPP) is pulled in as a dependency.

Manually: place ILoveMagic.dll in <profile>/BepInEx/plugins/.

On startup the BepInEx log should show ILoveMagic loaded (A=F6, B=F7).

Configuration

BepInEx/config/voodoofishin.magicbucketsummon.cfg

Key values are UnityEngine.InputSystem.Key names, e.g. F6, F7, H, J, Numpad1.

Notes

• Verified in singleplayer. Co-op has not been tested.
• Only one heavy object at a time. If your hands are already full, the pickup may be refused by the server (the log will say so).
• Multiple bucket pairs: F6 picks the lowest BucketId, which may not be the pair you had in mind. F7 always targets the partner of the bucket F6 grabbed, so the pair itself is always correct.
• The mod relies on game internals. A game update can change them and break it; a matching mod update would then be needed.

How it works

The game does not check pickup distance for magic buckets, so RequestPickupServerRpc(bucketId, clientId) can bring any already-spawned bucket to your hold point. The partner is read from the public Teleporter.LinkedTeleporter property, so no id-pattern guessing is involved.

AI disclosure

Per Thunderstore's AI policy, this mod discloses its use of generative AI:

• Code generation: the mod's source code, the reverse-engineering work behind it, and this README were produced with the assistance of the deepseek-v4-flash model via the DeepSeek API, driven through the Claude Code CLI.
• No runtime AI: the mod itself does not call any AI service, does not collect or transmit data, and contains no analytics.
• The same disclosure is embedded in the assembly metadata (AI_Assisted_Creation, AI_Model_Vendor, AI_Model_Name, AI_Agent).

The mod was built and tested by a human before release.

Changelog

See CHANGELOG.md.

中文说明

厌倦了长途跋涉或者寻找魔法桶了吗？现在只需要按下 F6 或者 F7，地图上的魔法桶就会到你的怀里去。

《巫毒垂钓》里魔法桶会成对刷在地图的某些位置。跑过去找、把一个搬到想放的地方、再回去搬另一个——为了一个传送对，路实在有点长。

这个 mod 不生成任何新桶，而是把地图上已经刷出来的桶隔空拿到手上：按 F6 拿一个，按 F7 拿它的搭档。用游戏原本的放下键随意放下，两个桶之间就通了。

用法

1. 按 F6 → 地图上已有的魔法桶之一直接到你手上
2. 抱到哪里，就按游戏原本的放下键放下
3. 按 F7 → 它的搭档到你手上
4. 走到另一处放下 —— 两个桶之间就通了

之后钻进任意一个桶，会被送到另一个桶的位置。两个按键都可以在配置里改。

安装

用 mod 管理器（Thunderstore Mod Manager / r2modman / Gale）直接装即可，BepInEx 6 (IL2CPP) 会自动作为依赖装上。

手动装：把 ILoveMagic.dll 放进 <配置目录>/BepInEx/plugins/。

启动后在 BepInEx 日志里能看到 ILoveMagic loaded (A=F6, B=F7)。

配置

BepInEx/config/voodoofishin.magicbucketsummon.cfg

按键取值是 UnityEngine.InputSystem.Key 的枚举名，如 F6、F7、H、J、Numpad1。

注意

• 已在单人模式验证。 联机未测试。
• 同时只能拿一个重物：手上已经抱着鱼箱等东西时，拾取可能被服务端拒绝（日志会提示）。
• 地图上有多个桶对时，F6 按 BucketId 最小的先拿，不保证是你心里想的那一对；但 F7 拿的一定是 F6 那个桶的搭档（读 LinkedTeleporter），所以配对自己不会错。
• mod 依赖游戏内部结构，游戏更新后可能失效，需要对应版本更新。

原理

游戏对魔法桶的拾取不校验距离，所以 RequestPickupServerRpc(bucketId, clientId) 可以把任意一个已刷出的桶拿到持有者手上。搭档信息直接读公开属性 Teleporter.LinkedTeleporter，不需要猜 ID 规律。

AI 使用说明

根据 Thunderstore 的 AI 政策，本 mod 声明其对生成式 AI 的使用：

• 代码生成：本 mod 的源码、底层的逆向分析工作以及这份 README，使用 DeepSeek API 的 deepseek-v4-flash 模型生成，通过 Claude Code 命令行工具驱动。
• 运行时不涉及 AI：mod 本身不调用任何 AI 服务，不收集或传输任何数据，也不含统计 / 分析代码。
• 相同的声明已写入程序集元数据（AI_Assisted_Creation、AI_Model_Vendor、AI_Model_Name、AI_Agent）。

发布前的构建与实测由人工完成。