Mineuniverse
Plugins
Custom Village

Custom Village

PLUGIN
Detect and control custom villages.
by rial73
Download Claim this project
15,782 downloads
0 likes
0 followers
Updated Oct 14, 2026
0 hypes
Follow0
Fun Mechanics
Advertisement Remove ads with Premium →

Compatibility

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

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

a Minecraft picture: the village with villagers, iron golems and cats with a sign about population limit without numbers, everybody are surprised

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

Permissions

  • Access to 'reload' command: customvillage.reload (default: op)

  • Access to 'info' command: customdamage.info (default: op)

  • Access to 'optimize' command: customdamage.optimize (default: op)

Configuration

Default configuration file

Author

I will be happy to add some features or fix bugs. My mail: [email protected].

Useful links

Related projects

CustomVillage-0.1.13
MC 1.20.6, 1.21.2, 1.21, 1.21.3, 1.16, 1.19.3, 1.20.2, 1.21.8, 1.18.1, 1.20, 1.20.4, 1.20.3-Snapshot, 1.21.4, 1.19.2, 1.20.5, 1.21.5, 1.20.1, 1.21.5-Snapshot, 1.20.3, 1.21.7, 1.17
Release 2025-08-13 Get
CustomVillage-0.1.12
MC 1.20.6, 1.21.2, 1.21, 1.21.3, 1.16, 1.19.3, 1.20.2, 1.18.1, 1.20, 1.20.4, 1.20.3-Snapshot, 1.21.4, 1.19.2, 1.20.5, 1.21.5, 1.20.1, 1.21.5-Snapshot, 1.20.3, 1.21.7, 1.17, 1.14
Release 2025-07-27 Get
CustomVillage-0.1.11
MC 1.20.6, 1.21.2, 1.20.4, 1.21, 1.21.3, 1.19.2, 1.20.5, 1.21.5, 1.19.3, 1.20.2, 1.20.3-Snapshot, 1.21.4, 1.20, 1.20.3, 1.21.1, 1.20.1, 1.21.5-Snapshot, 1.19.1, 1.20.5-Snapshot
Release 2025-04-22 Get
CustomVillage-0.1.10
MC 1.20.6, 1.21.2, 1.20.4, 1.21, 1.21.3, 1.19.2, 1.20.5, 1.21.5, 1.19.3, 1.20.2, 1.20.3-Snapshot, 1.21.4, 1.20, 1.20.3, 1.21.1, 1.20.1, 1.21.5-Snapshot, 1.19.1, 1.20.5-Snapshot
Release 2025-04-10 Get
CustomVillage-0.1.9
MC 1.20.6, 1.20.4, 1.21, 1.19.2, 1.20.5, 1.19.3, 1.20.2, 1.20.3-Snapshot, 1.20, 1.20.3, 1.20.1, 1.19.1, 1.20.5-Snapshot, 1.19.4, 1.19
Release 2024-12-08 Get
CustomVillage-0.1.7
MC 1.19.1, 1.19
Release 2022-08-04 Get
CustomVillage-0.1.8
MC 1.19.1, 1.19
Release 2022-08-04 Get
CustomVillage-0.1.6
MC 1.19.1, 1.19
Release 2022-08-03 Get
CustomVillage-0.1.5
MC 1.19.1, 1.19
Release 2022-08-02 Get
CustomVillage-0.1.4
MC 1.16, 1.18.1, 1.17, 1.14, 1.18, 1.15, 1.19, 1.18.2, 1.19.1
Release 2021-03-18 Get
CustomVillage-0.1.3
MC 1.14
Release 2020-07-24 Get
CustomVillage-0.1.2
MC 1.14
Release 2019-07-30 Get
CustomVillage-0.1.1
MC 1.14
Release 2019-07-21 Get
CustomVillage-0.1.0
MC 1.14
Beta 2019-07-08 Get

More from rial73

Advertisement Remove ads with Premium →

You Might Also Like