LUCA_LanO-MCWitchMod icon

MCWitchMod

Adds a Minecraft Witch enemy that throws potions, heals herself, and drops healing potions.

Last updated a week ago
Total downloads 12642
Total rating 4 
Categories Mods Items Monsters AI Generated
Dependency string LUCA_LanO-MCWitchMod-1.2.1
Dependants 2 other packages depend on this package

This mod requires the following mods to function

Zehs-REPOLib-4.2.0 icon
Zehs-REPOLib

Library for adding content to R.E.P.O.

Preferred version: 4.2.0
BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100

README

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.

Supporting the Mod

This is a hobby, and it costs me real time and money to make these things. Witch is and always will be free — but whether I can keep making new ones mostly comes down to how much support it gets.

爱发电 (Afdian — Alipay / WeChat Pay / PayPal): afdian.com/a/LUCALanO

No obligation — a kind word or a bug report helps just as much.

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.!