TalkingVillagers v1.6

TalkingVillagers
Villagers with personality. Dialogs that react to your world.

14 Professions ◆ 200+ Dialogs ◆ 12 World Events ◆ PlaceholderAPI ◆ Paper 1.21

[ATTACH type="full" width="603px" alt="1775469493174.png"]1277934[/ATTACH]

What TalkingVillagers Does

Villagers are the most common mob players meet. But vanilla gives them nothing to say. They stand in silence, trade, and get ignored. TalkingVillagers gives every villager a voice tied to their profession, their world, and what is actually happening around them.

Each profession has its own dialog pool. Cartographers call out Mending trades. Farmers talk about crops and weather. Clerics offer blessings. Blacksmiths discuss weapons. Fishermen tell sea stories. Baby villagers babble. Nitwits are confused.

World events trigger village-wide reactions. A dragon dies - villagers celebrate. A raid starts - they panic. A player dies nearby - they mourn. The weather shifts - they comment. A bell rings - they get annoyed. Someone holds an emerald - they get excited and follow.

Nearby villagers react to what they see. One villager trades, and others nearby comment with jealousy and competition. The village feels like a community, not a set of silent NPCs.

No conflicts with NPC plugins. Citizens, FancyNPCs, ShopKeepers, and zNPCs are detected and skipped automatically. You do not need to configure anything for it to work.

Each profession has 10 dialogs drawn from a random pool. No two villagers sound the same.

Villagers do not just repeat random lines. They react to what happens in the world around them via a priority-based event system. High-priority events override lower ones, and each event has its own config, cooldown, and dialog pool.

◆ NPC Plugin Compatibility

• Detects Citizens, FancyNPCs, ShopKeepers, and zNPCs via metadata, disabled AI, invulnerability flags, and PersistentDataContainer
• Each detection method is individually toggleable in config
• No manual configuration required for common NPC plugins

◆ Emerald Attraction

• Hold an emerald and nearby villagers show special reaction dialogs
• The villager follows the player for 10 seconds with pathfinding
• Toggleable per world in config

◆ Social Reactions

• When a villager trades, nearby villagers react with jealousy or competition
• Configurable reaction radius, chance, max reactors, and cooldown
• 12 unique jealousy dialogs per language

◆ Mending Auto-Detection

• Cartographers automatically scan their trades for Mending enchanted books
• 70% chance to show a Mending-specific dialog instead of the default cartographer line
• 5 unique Mending announcement dialogs

◆ TextDisplay Holograms

• Modern TextDisplay API with passenger attachment to villagers
• Hex color support via &#RRGGBB format in all dialogs
• Configurable display duration, height offset, and max concurrent holograms
• Orphan cleanup removes leftover holograms after reloads or crashes

◆ PlaceholderAPI Support

• All dialogs support PlaceholderAPI placeholders using a nearby player as context
• Use %player_name%, %player_level%, Vault economy, and any other PAPI expansion in villager speech
• Fully optional soft dependency

◆ Performance

• Proximity-based detection with per-world enable/disable
• Configurable check interval and max players per tick
• ConcurrentHashMap for all tracking maps
• 1-second event priority cache to avoid repeated computation
• Scheduled cleanup tasks for stale pairs and orphaned holograms