Note from the author:

This was my first plugin, built for use on the survival server I run for a few friends. It's far from the robust village infrastructure I originally envisioned, mainly because I didn't want to completely rewrite all of the core minecraft village code and villager behavior... but I think it accomplishes enough. Since it reached a point that I'm fairly happy with several months ago, most of the time the only updates I do are to address major bugs or bukkit upgrades.

This was also my first foray into Java. As such, the code can be a bit of a mess in places. If you want to poke around to see how I did what I did, or fork it and add functionality (or fix bugs!) check out the git repository on GitHub. You might have to poke me extra hard with pull requests merging functionality back in unless I'm expecting them. And hey, if you've looked at the code and aren't completely turned off by it, a co-maintainer would be welcomed to the project. I'm sure some of my users would appreciate your contributions! ;)

- James

The Goal

To make NPC Villages (and the expansion and defense thereof) a more integral part of the game.

Installation and Documentation

https://github.com/jcornwellshiel/uvvillagers/wiki - Lots of details here, and it's almost up to date! Go go go!

Important note on bukkit versions:

This plugin hits core minecraft classes, and thus can be only run on the appropriate bukkit versions. You can't use UVVillagers for CB1.6.4 on a 1.7.2 server, or vice versa. Starting January 2014, if there is not a recommended build for the latest minor bukkit version (for example, at the time of this writing, 1.7 only has dev, alpha, and beta builds available) I will publish two copies of this plugin for each update I do:

  • One for the current Recommended Build (Currently 1.6.4-R2.0)
  • One for the most stable recent build (currently Beta 1.7.2-R0.2).

If you need more than this, feel free to contact me.

Basic Features

  • Player popularity tracking with villages.
  • Greeting displayed on entering villages.
  • Receive daily tributes from villages that you maintain and defend, based on population and popularity.
  • Extra-awesome zombie sieges.
  • Rewards for defending villagers from zombie sieges.


  • Villages: Villages expand the core minecraft NPC Village functionality to include:
    • Villages are named after the first player to discover them (after installing the plugin), and can be renamed by whomever is most popular with the village.
    • Per-village-per-player reputation, broken down into configurable tiers.
    • Information about physical size, population, etc is reported to users.
    • Notifications are displayed upon entering a village, a village being abandoned, etc.
    • Commands to get information about villages are accessible via /uvv
    • Villages will pay nearby players a configurable daily tribute every day at dawn based on the players' reputation and the village's population.
  • Sieges: Zombie Sieges expand on the core minecraft Zombie Siege functionality, and are strongly enhanced and configurable.
    • Any mob can potentially spawn. Yes, including withers and ender dragons.
    • Siege statistics are tracked, and killing mobs that are part of a siege grants reputation with the village under siege.

Currently working: (version 1.3.8)

  • Citizens support
  • Configuration files! (All values and % chances can be changed!)
  • Configurable messages!
  • Village population and reputation announced upon nearing a village.
  • Zombie Sieges can spawn all sorts of crazy stuff.
  • Override core Zombie Siege mechanic in favor of ours.
  • Spawn a siege on-demand.
  • Village-Player reputation tracking
  • Villager tributes! (Player receiving tribute must be near the village at exactly dawn)
    • 0-3 emerald tribute per 20 villagers in nearby villages every day at dawn.
    • 1 emerald tribute bonus per 20 villagers.
    • 1-2 emerald tribute bonus per zombie siege kill during the previous night.
    • multiplier based on current reputation
  • Dynmap support is now integrated
  • Multiworld support
  • Some prevention of typical zombie siege avoidance tactics (like using floating platforms) by spreading spawns out over a radius.
  • Can now select items other than emeralds for tribute!
  • Collecting tribute from a mayor instead of it magically appearing (requires CB 1.5.1)
  • Set whether tribute is collected from the Mayor or appears directly in your inventory
  • Configurable minimum village size
  • Preventing villager purchases if your reputation is too low
  • Iron Golem aggro on extremely low reputation
  • Overriding core popularity effects (cancel iron golem attack if it's caused by your reputation being too low)
  • Chest tribute
  • Better mayor retention
  • Server-owned villages with /uvv setserver

Known Bugs

  • Null exception thrown for some people using dynmap (properly caught since 1.2.5, still not sure of root cause... for some people dynmap is returning null when creating new markers, even though the marker is created)
  • Mayors sometimes teleport into occupied blocks, suffocating them. This might be addressed now.

Enjoy! Post your bugs, exploitable aspects, and suggestions in comments here or at the GitHub repo !


  • To post a comment, please or register a new account.
Posts Quoted:
Clear All Quotes

About This Project