Enchanted Golden Apple

A local BepInEx mod for REPO: find a hidden golden apple on the map, eat it, and gain bonus shield plus a short run speed boost. Every effect runs locally — install it on your own PC and it works for you in any lobby.

Features

Golden Apples

• 8 golden apples are randomly scattered across each map (skipping the spawn point, spread across multiple height layers within a 4–25m radius).
• Eating happens automatically when you walk close to an apple (~0.8m).

Shield (50 points)

• Eating an apple grants 50 golden-orange bonus shield stacked on top of your base health.
• Monster attacks drain the shield first; damage fully absorbed by the shield does not touch your base health. Once the shield is depleted it disappears and normal health applies again.
• Shield resets to 0 when entering a new level and does not carry over between rounds.

Run Speed Boost (5 seconds / 2x)

• Eating an apple grants a 5-second, 2x run speed boost with no stamina drain during the boost (stamina stays full).
• Original speed and normal stamina consumption restore automatically when it expires.

Hotkey H

• Press H to locally refill 50 shield to full and gain the 5-second 2x speed boost at the same time (no stamina drain).
• Works for both host and clients; local only — not synced to the server or other players.

Shield HUD

• Shield is shown as golden-orange hearts in the top-left corner.
• Hearts are hidden when shield is 0; the whole HUD can be turned off in the config.

Installation

1. Install BepInExPack 5.4.x first (this mod depends on the BepInEx runtime framework).
2. Place EnchantedGoldenApple.dll into BepInEx\plugins\ inside the game directory (a dedicated EnchantedGoldenApple folder is recommended).
3. Launch the game; the config file is generated automatically on first run.

This mod does not depend on MenuLib, REPOConfig, or any other third-party library.

Hotkeys

Key	Effect
H	Local refill of 50 shield + 5s 2x speed (no stamina drain), self only
Walk into a golden apple	Auto-eat: +50 shield, 5s 2x speed (no stamina drain)

Config File

Path: BepInEx\config\lch.enchantedgoldenapple.cfg

Section	Key	Type	Default	Description
HUD	ShowShieldHearts	Boolean	true	Show the shield hearts in the top-left (master shield HUD toggle)

Multiplayer

Effect	Host	Client (non-host)
Shield absorbs damage first	Local	Local
Apple 2x speed / 5s / no stamina	Local	Local
Press H: local refill + boost	Local	Local
Apples spawn / pickup	Spawned locally on host	Not shown locally on clients (no multiplayer sync)

• Shield, speed boost, H key, and HUD are all computed locally; installing the mod yourself is enough — the host does not need it.
• These values exist only locally and are not synced to the server or other players; others cannot see your shield.

Known Limitations

• Apples currently spawn only on the host side locally; clients cannot see or pick them up (item sync not implemented yet).
• The apple is a primitive geometry approximation, not a detailed 3D model.
• Shield and boost values are local buffs, not server-authoritative data.

Version

• v0.1.0