VillagerLife

A Paper plugin that brings villagers to life with daily routines, dialog and a reputation system.

Features

• Routines — Villagers follow profession-based daily schedules (farmers tend crops, blacksmiths hammer at anvils, fishermen head to water, etc.) and return home in the evening.
• Dialog — Right-click a villager to start a conversation. Chat naturally to ask for resources, request an escort, get directions, trade, or just talk.
• Nicknames — Give any villager a persistent nickname that shows above their head and in chat.
• Reputation — Build trust through trading. Higher reputation unlocks more interactions like fetching rare materials, escorts and work orders.
• Bilingual — Full support for German (de-DE) and English (en-US).

Requirements

• Paper 1.21+
• Java 21+

Commands

| Command | Description |
|---|---|
| /villagerlife reload | Reload config and language files |
| /villagerlife recalculate | Recalculate village boundaries |
| /villagerlife debug | Show debug info |

Alias: /vl
Permission: villagerlife.admin (default: op)

Configuration

All settings are in plugins/VillagerLife/config.yml.

language: en-US          # de-DE or en-US

village:
  villager-radius: 8
  flood-fill-hop-radius: 64
  max-villagers-per-village: 200
  resource-extra-radius: 64
  max-resource-distance: 3

routine:
  tick-interval: 200       # Ticks between routine updates
  sound-chance: 0.3        # Ambient sound probability per tick
  move-speed: 0.6          # Movement speed (1.0 = sprint)

reputation:
  min-gossip: 0
  min-fetch: 10
  min-fetch-rare: 25
  min-escort: 25
  min-work-order: 50

Language files can be customized in plugins/VillagerLife/lang/.