VillageAI

插件

· 作者 Duong2012G

智能村庄防御系统。以钟为核心的村庄会自动检测附近的村民。友好玩家通过交易获得声望,敌对玩家攻击村民会降低声望。当敌对玩家靠近时,声望会下降至

0 本站下载 0 关注 更新于 5 个月前

最新 3.3.2 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

VillageAI 插件

版本: 3.3.2
API: Paper 1.21 / Java 21
作者: Duong2012G

VillageAI 将原版 Minecraft 村庄转变为鲜活、具有反应能力的社区。 村庄能够自我防御、管理自身的供需经济、发布任务, 并根据玩家声望动态做出反应——无需任何外部依赖。


功能

系统 描述
状态机 村庄在 SAFE(安全)→ ALERT(警戒)→ DEFENDING(防御中)→ NIGHT / RAID(夜间/袭击)之间自动循环
空间铃索引 通过 ChunkCoord 索引实现 O(1) 复杂度的村庄查找——区块事件触发时无需全量扫描
经济系统 基于供需的定价机制,并带有按玩家声望计算的乘数(−50% 至 +50%)
袭击 可配置的多波次袭击,包含多种怪物和绿宝石奖励
升级 WALL(城墙)· WATCHTOWER(瞭望塔)· GRANARY(粮仓)· FORGE(铁匠铺)——每项升级都带来实质性的游戏性影响
任务 24 小时 DeliveryQuest(配送任务)周期,设有截止时间;通过与村民交互获得奖励
交易 GUI 54 格箱子界面,实时显示价格以及折扣/加价指示器
村民命名 每个村民拥有自定义名称标签,显示其职业和生命值
异步存储 原子文件保存(写入临时文件 → 重命名),并自动备份

安装

  1. 确保你正在运行 Paper 1.21(或兼容分支)并使用 Java 21。
  2. 将 VillageAI-3.3.2.jar 放入服务器的 plugins/ 文件夹中。
  3. 启动(或重启)服务器——请勿使用 /reload 命令。
  4. 首次运行时,配置文件将在 plugins/VillageAI/ 目录下生成。

注意: 官方不支持 PlugMan 热重载。更新插件时请务必完全重启服务器。


从源码构建

# 克隆/解压源码,然后执行:
mvn clean package -DskipTests

# 阴影 Jar 包将位于:
target/VillageAI-3.3.2.jar

要求:Java 21,Maven 3.8+。


命令

命令 权限 描述
/villageai info villageai.info 显示最近村庄的状态
/villageai list villageai.admin 列出所有已加载的村庄
/villageai reload villageai.admin 重新加载配置(热重载)
/villageai debug villageai.admin 切换调试输出
/villageai raid start villageai.admin 强制开始一次袭击
/villageai raid stop villageai.admin 强制停止一次袭击
/vtrade villageai.trade 打开最近村庄的交易 GUI
/vtrade buy <item> [qty] villageai.trade 通过命令直接购买
/vtrade sell <item> [qty] villageai.trade 通过命令直接出售
/vquest list villageai.quest 查看当前活跃的任务
/vquest accept <id> villageai.quest 接受一个任务

权限

villageai.info:    true       # 所有玩家
villageai.trade:   true       # 所有玩家
villageai.quest:   true       # 所有玩家
villageai.admin:   op         # 仅限管理员

配置概览

config.yml 中的关键设置:

village:
  check_radius: 64            # 敌对玩家检测半径(方块)
  door_radius: 8              # 夜间/警戒状态的房门扫描半径
  tick_interval: 40           # 村庄刻率(刻,默认 2 秒)

defense:
  max_golems: 2               # 每村最大铁傀儡数量
  alert_to_defense_delay: 10000  # 生成铁傀儡前的延迟(毫秒)
  bell_sound_cooldown: 15000  # 摇铃间隔(毫秒)

reputation:
  hostile_threshold: -30      # 低于此值将触发铁傀儡攻击
  interact_reward: 2          # 右键点击村民获得的声望点数
  damage_penalty: -25         # 攻击村民损失的声望点数

raid:
  max_waves: 5
  wave_interval_seconds: 60
  reward_per_wave: 64         # 完成每波袭击获得的绿宝石数量

night:
  enabled: true
  close_doors_at_night: true

3.3.2 版本修复

本次发布解决了六个 Bug——完整详情请参阅 CHANGELOG.md:

  • [严重] TradeService.executeTrade() 验证了交易但未转移物品
  • [严重] 在交易 GUI 中快速双击可能导致重复消费(Double-spend)
  • [中等] 在多世界服务器上 getNearestVillage() 会因 IllegalArgumentException 崩溃
  • [中等] tradeHistory 列表无限增长——在长期运行的服务器上导致内存泄漏
  • [中等] 当 24 小时计时器触发且存在相同任务时,会生成重复任务
  • [性能] 用 O(1) 反向查找映射替换了 onEntityDeath 中的 O(n) 村庄扫描
  • [性能] 用缓存的门列表替换了 closeAllDoors() 中的区块扫描

数据存储

村庄数据以 YAML 格式保存至 plugins/VillageAI/villages/ 目录,每个村庄对应一个文件。 保存操作使用异步原子写入模式(写入 .tmp → 重命名为最终文件)进行,以防止崩溃导致的数据损坏。 每个文件旁都会保留前一次保存的 .bak 备份。


许可证

本插件按“原样”提供,仅供教育和服务器运营商使用。 未经作者许可,禁止重新分发或转售。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源