Manual

Introduction

This small bukkit plug-ins aims at giving some life to our beloved villagers. The player is now able to specify jobs. Currently available jobs are farmer, butcher, blacksmith and librarian.

Disclaimer : I've chose to only use the bukkit API, not override the server implementation. The actual result is a "passive behaviour", or some sort of villager mind parasite. Their movement procedures aren't affected, nor their basic reactions.

Jobs

Farmer

(Note : More complete description/usage at the farmer page).

This kind of villager harvests earth productions, cut trees and put the result in encountered chests.

Blacksmith

(Note : More complete description/usage at the blacksmith page).

This kind of villager smelts everything that can be smelt. It will only use coal/charcoal for this purpose.

Librarian

(note : More complete description/usage at the librarian page).

This kind of villager gets sugar cane from chests and produce books if there's a workbench near. Some kind of mechanism should provide a slow experience aura to nearby players.

Butcher

(note : More complete description/usage at the butcher page).

This kind of villager uses shear to collect wool from sheep. Future implementation will include breeding.

Priest

Work in Progress

This kind of villager provides experience through player donation of precious items. Other ideas include healing device, crops growing aura, monsters damaging aura when provided with glowstone dust.

Iron Golem

Just give torches to an Iron golem, and every N seconds, it will evaluate if its current position needs to be enlighten and places the torch.

Configuration

The plugin can be tuned using a config.yml file placed in the plugin dedicated directory. The configuration consists in the following keys:

• scanning : Concerning villager block scanning range.
  • horizontalrange : Number of blocks scanned around the villager.
  • verticalbelow : Number of blocks scanned below the villager.
  • verticalabove : Number of blocks scanned above villager's ground position.
• librarian : Librarian specific configuration.
  • bookproduction : Time (in miliseconds) to make a book from sugar canes.
• butcher : Butcher specific configuration.
  • radius : Living entity checking radius in block number.
  • shear : Time in ms between two usage of its shears.
• timing : Timing related configuration. Important for performances issues.
  • listupdate : Number of ticks between two entity list update.
  • entity : Entity related timing.
    • period : Number of server ticks between two entity management attempt.
    • payload : Time (in nanoseconds) allowed to entity management per attempt.

Every villagers will be managed, but not necessarily in the same server tick. The job can be sliced to several server ticks.

Permissions

• usefulvillagers.jobassign : Give access to villager job selection.
• usefulvillagers.give : Give access to player donation to villagers.