Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!

CustomVillage

detect and control custom villages

Compatibility

Tested on Spigot-1.14, 1.15, 1.16, 1.19, 1.20, 1.20.6, 1.21.

Introduction

Detect and control custom villages. This plugin takes care of the pain I experienced when I created my own village. I created a big enough village, and its population took out of control. Villagers seemed to grow infinitely. Cats were leaving the village and were limited in count in villages only. Golems were obedient and followed the documented rules, but my god, they anyway followed the infinity of villagers. I ended up with a mess of hundreds of illegal entities on the map. Fortunately, here I could fix the issue.

Features

Detect villages based on locations of villagers
Calculate a number of beds in the villages and limit villagers population considering the beds
Limit population of cats (not tamed) and iron golems (non-player created) strongly according to the documentation

Limit mechanics.

All village-decisive entities: beds, golems, cats, villagers - are clustered in clusters of 32x12x32 size for X, Y, and Z coordinates.

All clusters in a square radius of 1 form one village.

For example, if there are four villagers in the following X, Y, and Z coordinates:

Villager #1: 100, 50, 100 (cluster coordinates 3, 4, 3)
Villager #2: 150, 50, 150 (cluster coordinates 4, 4, 4)
Villager #3: 200, 50, 200 (cluster coordinates 6, 4, 6)
Villager #4: 250, 50, 250 (cluster coordinates 7, 4, 7)

The #1 and #2 villagers are considered as the villagers of the same village. The #3 and #4 villagers belong to another village.

Then, each village as a set of clusters enforces its own limit of entities.

Commands

customvillage reload - reload config from disk
customvillage info info [@type : villagers(default) | golems | cats | beds] [@loaded : fully | partially(default) | no] [@scale; default=8] - show information
customvillage optimize - removes excessive villagers, iron golems and cats