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

1. Ensure the above dependencies are installed in your game.
2. Download the mod and place it in your BepInEx/plugins folder.
3. 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: [email protected] or [email protected]). 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.!