MCWitchMod

Witch

What's This Mod About?

Adds a Minecraft-style Witch to R.E.P.O.! She throws potions at players, can heal herself when hurt, and sometimes drops a healing potion when defeated.

Features

• A new enemy that chases you and throws potions from a distance
• Damage Potion — red, deals a burst of 50 instant damage right where it lands
• Poison Potion — green, applies a poison debuff that deals 4 damage per second for 20 seconds (stops damaging you once your health drops to 4 or less!)
• A colored circle marks where a potion is about to land — half a second to get out of the way
• Potions damage other enemies too — a damage potion deals 25 to them (players still take 50), and poison potions affect them exactly as they do players
• Poison screen effect — while poisoned, the edges of your screen glow green
• Poison particles — green particles float around a poisoned player until the effect wears off
• Self-heal — when her health is low, she drinks and restores 60 HP every 8 seconds (interrupted if she's stunned)
• Heal Potion drop — on death there's a chance she drops a healing potion that restores 60 HP when used
• Full set of custom sounds: notice, ambient, hurt, death, drink, and throw

Installation Requirements

Dependencies

• Zehs-REPOLib (4.2.0)
• BepInEx-BepInExPack (5.4.x)

Installing the Mod

• Ensure the above dependencies are installed in your game.
• Download the mod and place it in your BepInEx/plugins folder.
• Launch the game once to generate the config file (located at BepInEx/config/com.luca.witch.cfg).

Config Options

| Option | Default | What it does |

|--------|---------|--------------|

| MaxHealth | 250 | Witch max health |

| AttackRange | 8 | Attack / sight range (meters) |

| AttackCooldown | 4 | Attack cooldown (seconds) |

| ThrowSpeed | 8 | Potion throw speed (m/s) |

| HealAmount | 60 | Self-heal amount per tick |

| HealCooldown | 8 | Self-heal interval (seconds) |

| HealthPackDropChance | 0.3 | Chance she drops a Heal Potion on death (0.3 = 30%, 1 = 100%) |

| PoisonChance | 0.5 | Chance she throws a poison potion (0.5 = 1:1, 0 = always damage, 1 = always poison) |

| ShowLandingCircle | true | Show or hide the landing indicator circle (visual only — doesn't change how she fights) |

Playing Tips

• Watch for the colored ring on the ground — that's where the potion will land. Don't stand on it!
• Poison hurts over time but won't kill you outright. Still, get out of range before the next throw.
• If she's low on health she'll stop to heal — a window to strike, but only if she's not busy throwing.
• Her potions hurt other enemies too, so getting swarmed can work in your favour — let her splash her own neighbours.

Credits

Special Thanks

Thanks to bilibili creator @喫呱的瓜 (UID: 1148653702) for testing the mod and providing extensive bug reports.

Thanks to player FLson for testing the mod and reporting a critical bug that severely impacted gameplay.

3D Models

• Minecraft - Witch (the enemy model) by Vincent Yanez — Sketchfab, licensed under CC BY 4.0.
• Minecraft Potion (the potion models) by smakologg — Sketchfab, licensed under CC BY 4.0.
• Minecraft Bat (the bats in her death and vanish effect) by None_Yaroslav — Sketchfab, licensed under CC BY 4.0.

Audio & Particles

Some of the sound effects and particle textures are original Minecraft assets, used here for fan-modding purposes only.

Notes

• Multiplayer Notice: For the mod to work properly in co-op, every player must have it installed. Otherwise, desyncs and unexpected issues may occur.
• Multiplayer-friendly: potions, drops, sounds, and visual effects are synced in co-op.
• If you encounter any issues or bugs, feel free to reach out (Contact: SLUCALanO@gmail.com or SLanOmega@163.com). When reporting, please include a precise description of what happened and your log file — a screen recording helps but is optional.

Enjoy the blocky magic of the Minecraft Witch in R.E.P.O.!