? 愿景
忘掉那些只会说“嗯……”和面无表情村民的日子吧。Realistic Villagers 是对 Minecraft 村民的终极重制。每个村民都伪装成具有动态感知皮肤的 NPC ——底层保留了原版 AI 和交易机制,表层则赋予了面孔和生活——带来了前所未有的深度与沉浸感,涵盖谱系、婚姻、地区化性格、由玩家管理的聚落以及全新的基于全息投影的界面。无论是建立家族传承、运营村庄经济还是保卫家园,每个村民都有自己的故事。
? 可视化配置网站
不再需要挖掘原始 YAML 文件 —— 你可以直观地生成和调整 config.yml、全息投影、GUI 布局和消息,然后将结果直接放入服务器中。
⚠️ 注意: 配置编辑器仅保证在最新插件版本上正常工作 —— 为旧版本生成的配置可能会缺少选项或与新增设置不同步。
✨ 功能
? 人性化因素
- 动态身份: 每个 NPC 都有独特的性别(男/女),并通过 MineSkin 赋予基于个性的皮肤。
- 专业名称: 不再有“村民 #432”。遇见 农夫约翰 或 牧师拉奎尔 吧。
- 家族传承: 深入的谱系系统。NPC 会在代际之间记住他们的父母、子女和配偶。
- 婚姻与繁衍: 使用婚戒建立纽带,看着家庭随时间增长。儿童变体最终成长为成人。
- 性别自由: 完全禁用性别系统,或者为每个玩家单独分配自定义性别。
? 地区性系统
- 村民受其居住地的影响。沙漠生物群系会孕育出肤色较深、拥有阿拉伯名字以及对话符合沙漠居民特征的村民。
- 雪地生物群系会让村民穿上温暖的长袍,赋予他们北欧名字、口音以及抱怨寒冷的习惯。
- 该系统的各个部分 —— 皮肤、名称、对话 —— 都是完全可定制的,如果你更喜欢原版的统一风格,也可以将其禁用。
? 外观特征 (需要 1.21.4+)
- 每位村民拥有独立的体型: 身高因村民而异 —— 对于女性而言,其身材也是根据其自身皮肤颜色绘制的 —— 而不是所有人都共享同一个模型。
- 玩家也获得其一: 可选地为玩家提供相同的体型,使其随玩家转动和移动,并在第三人称视角下可见,而不仅仅是旁观者可见。
- 自托管资源包: 这些形状存在于插件本身通过 HTTP 服务的一个资源包中 —— 无需单独托管,也无需粘贴到
server.properties 中。
- 安全降级: 如果资源包无法到达玩家 —— 或者根本无法提供服务 —— 该玩家将仅保留普通原版模型,而不是损坏的占位符。无论是否加载资源包,身高仍然适用。
? 聚落
- 真实村庄: 钟声敲响即形成真正的聚落 —— 有名称、边界,并有自己的居民 —— 这些信息会实时显示在只有查看者自己可见的世界内雷达地图上。
- 市长与选举: 居民竞选公职,其选举纲领会影响建造建筑的成本和速度。玩家和村民均可投票。
- 运作中的经济: 所有 13 种原版职业都为聚落的公共仓库生产真正的商品 —— 原材料会被精炼成建筑物实际使用的材料。
- 委托建筑: 在承诺建造之前预览建筑的幽灵形态,然后观察它逐层逐渐升起,并进行清理和碰撞检测,以防止聚落相互重叠。
- 来自任何地方的蓝图: 读取原版
.nbt 结构和 WorldEdit .schem 文件,零额外依赖,并按适合它们的地区排序 —— 沙漠村庄提供沙漠建筑,绝不会是雪屋。走进任何村庄,包括这个插件从未设计过的村庄,其建筑都会成为你自己的聚落可以建造的蓝图。
- 村庄存储: 一个玩家可以存入和取出的共享库存堆,可以通过箱子 GUI 或全息菜单访问。
- 墓碑: 没有十字架陪葬的死亡村民会得到一座真正的坟墓 —— 由方块和文本显示构建,记录她的父母及其死因。
? 高级人工智能
- 战略战斗: 村民在交战前会权衡局势 —— 处于劣势的 NPC 会选择撤退而非无谓牺牲,而无武装的村民会恐慌并逃跑。
- 武装且危险: NPC 可以使用锤子和长矛,每种职业都可配置自定义近战武器。
- 呼叫支援: 当受到威胁时,村民会呼叫家庭成员寻求帮助。
- 社交互动: 交谈、开玩笑、调情或侮辱 —— 你的声誉会根据每一句话发生变化。
- 交互式需求: 饥饿、物品栏管理以及掠夺和钓鱼等日常活动。
- 氛围复活仪式: 失去心爱的村民?一道闪电击中头部附近 2 格范围内便会开始神圣的复活仪式。
? 迁徙生活
- 村民现在可以骑乘骆驼和羊驼,在世界上漫游旅行,而不再只是静止站立。
? 村民住房
- 通过在箱子上放置写有
[Villager] 的告示牌,可将任何箱子或桶变为村民的个人储物箱。
- 指定村民允许从中取出的特定物品——再也不用担心误开错误的箱子了。
? 视觉与技术卓越
- 全新全息菜单: 基于全息投影完全重新设计的交互式村民菜单——如果你更喜欢经典外观?只需通过一个配置开关即可切换回旧的箱子 GUI。
- 实时姓名标签: 随着村民提升交易等级,姓名标签实时更新。
- 模块化配置: 配置文件已拆分为专注的各个部分,使其更易于导航和自定义。
- 可选配方: 如果你只想要 NPC/行为系统,可以完全禁用插件的自定义交易配方。
- 性能优化: 基于 PacketEvents 构建,对服务器影响极小且稳定性高。
? 安装
- 依赖项: 确保已安装 PacketEvents。
- 插件: 将
RealisticVillagers.jar 放入你的 /plugins/ 文件夹中。
- 设置: 重启服务器以生成默认配置和皮肤缓存。
- 开始吧! 见证你世界中每个村庄的蜕变。
⚙️ 配置
该插件高度可定制,配置文件已拆分为多个文件(config.yml、gui.yml、holograms.yml、loot.yml、variable-text.yml 等),以便轻松查找和调整各个系统。偏好可视化方式?请查看上方的 Visual Config Website。
# procreation settings
procreation-cooldown: 6000
baby-grow-cooldown: 12000
# Social settings
villager-farm:
allow-procreation-between-family-members: false
ignore-sex-when-procreating: false
? 命令
| 命令 |
描述 |
/gender <male|female> |
设置玩家性别(除非在配置中禁用,否则为必填)。 |
/rv reload |
热重载所有配置和消息。 |
/rv skins |
管理和预览 NPC 皮肤分类。 |
/rv genderset <player> <gender> |
管理员命令,用于覆盖玩家的性别。 |
定居点没有自己的命令——右键点击村庄的铃铛或其市长以打开定居点菜单,右键点击任何村民以查看其专属的全息图或箱子 GUI。
? 兼容性
我们与其他插件和谐共处:
- PacketEvents: ✅ 必需。
- ViaVersion / ViaBackwards / ViaRewind: ✅ 全面支持从 1.18 到 1.21.11。
- Geyser-Spigot: ✅ 支持基岩版玩家。
- EliteMobs: ✅ NPC 能识别并对精英威胁做出反应——精英和首领实体被完全排除在外,不会被伪装成村民。
- MythicMobs: ✅ 同样的理念——带有 Mythic 标签的实体永远不会被误认为是本插件自带的村民。
- VillagerTradeLimiter: ✅ 尊重其自身的交易限制,而非与其竞争——本插件会退让给它,而不是在其之上打开自己的菜单。
- ValhallaMMO (付费版,如果已安装):✅ 村民菜单中的“交易”按钮将打开 Valhalla 自己的自定义商人界面,而非原版交易;首次使用时会将村民转换。对于 Valhalla 未配置的任何村民,则回退到普通交易。
- ProtocolLib / ProtocolSupport: ✅ 增强的数据包处理,实现流畅的皮肤过渡。
Realistic Villagers — Because every village deserves a soul.
GPL-3.0 License
? The Vision
Forget the days of "Hmmmm" and blank stares. Realistic Villagers is the ultimate overhaul for Minecraft villagers. Every villager is disguised as a dynamic, skin-aware NPC — same vanilla AI and trading underneath, a face and a life on top — bringing a level of depth and immersion previously unseen, from genealogy and marriage to region-aware personalities, whole player-run settlements, and a brand-new hologram-based interface. Whether it's building a family legacy, running a village's economy, or defending your home, every villager has a story.
? Visual Config Website
No more digging through raw YAML — generate and tweak your config.yml, holograms, GUI layout and messages visually, then drop the result straight into your server.
⚠️ Heads up: The config editor is only guaranteed to work with the latest plugin version — configs generated for older releases may be missing options or out of sync with newly added settings.
✨ Features
? The Human Factor
- Dynamic Identity: Every NPC is uniquely gendered (Male/Female) with a personality-driven skin via MineSkin.
- Professional Names: No more "Villager #432". Meet John the Farmer or Raquel the Cleric.
- Family Legacies: A deep genealogy system. NPCs remember their parents, children, and spouses across generations.
- Marriage & Procreation: Use Wedding Rings to form bonds and watch families grow over time. Child variants grow into adults.
- Gender Freedom: Disable the gender system entirely, or assign a custom gender to each player individually.
? Regionality System
- Villagers are shaped by where they live. A desert biome breeds villagers with darker skin tones, Arabic names, and conversations typical of desert dwellers.
- Snowy biomes dress villagers in warm robes, give them Nordic names, an accent, and a habit of complaining about the cold.
- Every part of this system — skins, names, dialogue — is fully customizable or can be disabled if you prefer vanilla-style consistency.
? Appearance Traits (requires 1.21.4+)
- Every Villager Her Own Body: Height varies per villager — and, for women, so does a figure drawn from the colours of her own skin — rather than everyone sharing one model.
- Players Get One Too: Optionally gives players the same figure, worn so it turns and moves with them and is visible in third person, not just to onlookers.
- Self-Hosted Resource Pack: The shapes live in a pack the plugin writes and serves over HTTP itself as players join — nothing to host separately, nothing to paste into
server.properties.
- Fails Safe: If the pack can't reach a player — or can't be served at all — that player simply keeps the plain vanilla model instead of a broken placeholder. Heights still apply regardless, since they need no pack at all.
? Settlements
- Real Villages: A bell makes a genuine settlement — named, bordered, with its own residents — drawn live on an in-world radar map that's private to whoever is looking at it.
- Mayors & Elections: Residents stand for office with electoral programmes that change what commissioning a building costs and how fast it goes up. Players and villagers both vote.
- A Working Economy: All 13 vanilla professions produce real goods for the settlement's shared stores — raw materials get refined into whatever its buildings are actually made of.
- Commission Buildings: Preview a building as a ghost before committing, then watch it rise gradually, course by course, with clearance and collision checks so settlements don't overlap themselves.
- Blueprints From Anywhere: Reads vanilla
.nbt structures and WorldEdit .schem files with zero added dependencies, sorted by the region they suit — a desert village is offered desert architecture, never a snow cabin. Walk into any village, including ones this plugin never designed, and its buildings become blueprints your own settlements can raise.
- Village Storage: A shared stockpile players can deposit into and withdraw from, either from the chest GUI or the hologram menu.
- Graves: A villager who dies without a cross on hand gets a real grave — built from block and text displays, recording her parents and how she died.
? Advanced Artificial Intelligence
- Strategic Combat: Villagers weigh the odds before engaging — outnumbered NPCs retreat instead of dying pointlessly, and unarmed villagers panic and flee.
- Armed & Dangerous: NPCs can wield maces and spears, with custom melee weapons configurable per profession.
- Calls for Backup: Villagers call family members for help when threatened.
- Social Interaction: Talk, joke, flirt, or insult — your reputation changes based on every word.
- Interactive Needs: Hunger, inventory management, and daily activities like looting and fishing.
- Atmospheric Revive Ritual: Lose a beloved villager? A lightning bolt striking within 2 blocks of the head begins the sacred revival ritual.
? Life on the Move
- Villagers can now ride camels and llamas, wandering and traveling the world instead of standing still.
? Villager Housing
- Turn any chest or barrel into a villager's personal storage by placing a sign with
[Villager] on it.
- Assign specific items the villager is allowed to take from it — no more raiding the wrong chest.
? Visual & Technical Excellence
- All-New Hologram Menu: A completely redesigned interactive villager menu built on holograms — prefer the classic look? Switch back to the old chest GUI with a single config toggle.
- Real-Time Nametags: Live updates as your villagers level up their trades.
- Modular Configuration: The configuration file has been split into focused parts, making it far easier to navigate and customize.
- Optional Recipes: Disable the plugin's custom trade recipes entirely if you only want the NPC/behavior systems.
- Optimized Performance: Built on PacketEvents for minimal server impact and high stability.
? Installation
- Dependencies: Ensure you have PacketEvents installed.
- Plugin: Drop
RealisticVillagers.jar into your /plugins/ folder.
- Setup: Restart the server to generate the default configuration and skin cache.
- Go! Witness the transformation of every village in your world.
⚙️ Configuration
The plugin is highly customizable, and the config has been split into multiple files (config.yml, gui.yml, holograms.yml, loot.yml, variable-text.yml, and more) so each system is easy to find and tweak. Prefer a visual approach? Check out the Visual Config Website above.
# procreation settings
procreation-cooldown: 6000
baby-grow-cooldown: 12000
# Social settings
villager-farm:
allow-procreation-between-family-members: false
ignore-sex-when-procreating: false
? Commands
| Command |
Description |
/gender <male|female> |
Set your player gender (mandatory unless disabled in config). |
/rv reload |
Hot-reload all configurations and messages. |
/rv skins |
Manage and preview NPC skin categories. |
/rv genderset <player> <gender> |
Admin command to override a player's gender. |
Settlements have no commands of their own — right-click a village's bell or its mayor to open the settlement menu, and right-click any villager for its own hologram or chest GUI.
? Compatibility
We play nice with others:
- PacketEvents: ✅ Required.
- ViaVersion / ViaBackwards / ViaRewind: ✅ Full support from 1.18 to 1.21.11.
- Geyser-Spigot: ✅ Bedrock players supported.
- EliteMobs: ✅ NPCs recognize and react to elite threats — elite and boss entities are left alone entirely rather than disguised as villagers.
- MythicMobs: ✅ Same idea — a Mythic-tagged entity is never mistaken for one of this plugin's own villagers.
- VillagerTradeLimiter: ✅ Its own trade limits are respected instead of raced against — this plugin defers to it rather than opening its menu on top of it.
- ValhallaMMO (premium, if installed): ✅ The villager menu's "Trade" button opens Valhalla's own custom-merchant interface instead of vanilla trading, converting the villager the first time it's used. Falls back to ordinary trading for any villager Valhalla has nothing configured for.
- ProtocolLib / ProtocolSupport: ✅ Enhanced packet handling for smooth skin transitions.
Realistic Villagers — Because every village deserves a soul.
GPL-3.0 License
评论 0
登录后参与评分
还没有评论,来抢沙发吧