Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
EnchantedGoldenApple
Eat a golden apple hidden somewhere on the map to gain 50 bonus shield HP and a 5-second run speed boost with no stamina drain. Enemy attacks drain the shield first before your base health.
By QWQhhhhhhh
| Last updated | 2 hours ago |
| Total downloads | 7 |
| Total rating | 1 |
| Categories | Mods Tools Items Client-side Quality Of Life |
| Dependency string | QWQhhhhhhh-EnchantedGoldenApple-0.1.0 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
BepInEx-BepInExPack
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2100README
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
- Install BepInExPack 5.4.x first (this mod depends on the BepInEx runtime framework).
- Place
EnchantedGoldenApple.dllintoBepInEx\plugins\inside the game directory (a dedicatedEnchantedGoldenApplefolder is recommended). - 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
