# Healing Clerics
**Villager clerics finally look after their neighbours.**
## What is it?
Every evening villagers walk to the village bell for their daily gathering. With Healing Clerics, that is when the clerics get to work: they look around for wounded villagers (or check themselves) and throw a splash potion to heal them. Novice clerics throw Regeneration, experienced clerics throw Instant Health.
No new blocks, items or entities. It only changes what clerics do.
## Features
- 🧪 **Splash potions, thrown like a witch.** The cleric turns to the target, swings its arm, plays the throw sound and leads moving targets.
- ❤️ **Heals the most wounded first.** Any villager below 50% health in range is a target, and the one with the lowest health gets the potion.
- 🪞 **Heals itself.** A wounded cleric throws a potion at its own feet.
- ⭐ **Potion depends on the cleric's level.** Low levels throw Regeneration, high levels throw Instant Health (see table below).
- 🔔 **Evening gathering only.** Clerics only look for wounded villagers during the gathering, so nothing is scanned the rest of the day. You can turn this off.
- ⏱️ **Cooldown.** Each cleric waits 10 seconds between potions.
- 👀 **Line of sight.** The cleric needs to see its target (configurable).
- 🧠 **No wasted potions.** Regeneration is not thrown at villagers that already have it.
- ⚙️ **Fully configurable.** Radius, health threshold, cooldown, level cut-offs, self-healing and more.
## Potion by cleric level
| Level | Rank | Potion |
|---|---|---|
| 1 | Novice | Regeneration |
| 2 | Apprentice | Regeneration |
| 3 | Journeyman | Regeneration |
| 4 | Expert | Instant Health |
| 5 | Master | Instant Health II |
Level cut-offs are the defaults and can be changed in the config.
## Configuration
The file `config/clerigo_curandeiro.json` is created the first time you start the game.
| Option | Default | Meaning |
|---|---|---|
| `onlyDuringMeeting` | `true` | Only heal during the evening gathering. Set to `false` to heal all day |
| `scanIntervalTicks` | `20` | How often clerics are checked (20 ticks = 1 second) |
| `searchRadius` | `10.0` | Maximum distance in blocks to the villager being healed |
| `healthThreshold` | `0.5` | Heal villagers below this fraction of their max health |
| `cooldownTicks` | `200` | Minimum ticks between two potions from the same cleric |
| `instantHealingMinLevel` | `4` | Cleric level that starts using Instant Health |
| `strongHealingMinLevel` | `5` | Cleric level that uses Instant Health II (set to 6 to never use it) |
| `healSelf` | `true` | The cleric also heals itself |
| `requireLineOfSight` | `true` | The cleric needs a clear line of sight to the target |
## Requirements
- Minecraft Java Edition 26.3
- [Fabric Loader](https://fabricmc.net/) 0.19.5 or newer
- [Fabric API](https://modrinth.com/mod/fabric-api)
- Java 25
## Installation
1. Install Fabric Loader for Minecraft 26.3.
2. Put Fabric API and `healing-clerics-1.0.0.jar` in your `mods` folder.
3. Start the game. Find a village with a cleric and wait for the evening gathering.
## FAQ
**Does it work in existing worlds?**
Yes. It adds no blocks, items or entities, so existing villages and clerics are picked up as they are.
**Do players need it on a multiplayer server?**
No. Only the server (or your single-player game) needs the mod, because clients have nothing new to load.
**My cleric is not healing anyone.**
Check that it is the evening gathering, that the cleric is an adult and awake, that the target is within range and below the health threshold, and that the cleric can see it. To test during the day, set `onlyDuringMeeting` to `false`.
**Does the potion affect other mobs and players?**
Yes, it follows normal splash potion rules. Anything inside the splash area is affected, so players nearby are healed too, and undead mobs are hurt by Instant Health.
**Do other professions heal too?**
No, only clerics.
## Known issues
- Not yet verified in-game on Minecraft 26.3. If something looks wrong, please report it with a screenshot and your `logs/latest.log`.
- A cleric healing itself throws the potion at its own feet, so the effect is slightly reduced by the splash distance.
## Credits & License
Made by **ERRE Mods and Textures**.
Copyright (c) 2026 ERRE Mods and Textures. All Rights Reserved.
You may play with this mod, use it on servers you run and show it in videos and streams. You may not re-upload, redistribute, sell or modify and republish it, or include it in a modpack, without written permission from the author.
