FancyNpcMovementsAddon 是一款轻量且稳健的扩展插件,专为使用 FancyNpcs 的服务端所有者打造。由于基于数据包的 NPC 不具备标准的 Minecraft AI 或寻路引擎,该插件介入以处理平滑、协调的移动,同时不会给服务器的 CPU 带来沉重负担。
通过此插件,你可以将静态的 NPC 转化为有血有肉的小镇守卫、流浪商人或在地下城中巡逻的怪物,它们会沿着你完全在游戏内设计好的路线来回踱步。
✨ 核心特性
?️ 动态游戏内路径点:走到某个位置,输入命令,即可瞬间绘制出 NPC 的移动路径。无需复杂的文本坐标配置。
? 往返路由:NPC 会在你自定义的路径点之间平滑过渡。一旦到达路径终点,它们会自动反向并沿原路走回起点,无限循环。
? 智能点击暂停:如果玩家右键点击正在巡逻的 NPC,NPC 会暂停移动 10 秒与玩家互动,随后无缝恢复其路线。
⚡ 双重数据包防抖保护:旨在拦截双击客户端数据包。当玩家右键点击你的 NPC 时,其配置的交互动作(如打开 GUI 或执行命令)仅触发一次——不会出现重复打开菜单或刷屏消息的情况。
? 完整自动补全 / Tab 补全:包含一个智能 Tab 补全器,可自动填充命令并动态获取所有已注册的 FancyNpcs 的名称。
? 持久化保存:所有巡逻路径和全局速度设置都会自动即时保存到 config.yml 中,并在服务器重启或重载时立即重新加载。
⚙️ 平台兼容性
由于此插件直接依赖 FancyNpcs 使用的先进数据包注入系统,因此需要一个现代、高性能的服务端环境。
支持 ✅:Paper, Folia.
不支持 ❌:Vanilla Spigot 或 CraftBukkit(FancyNpcs 原生不支持 Spigot)。
要求:Minecraft 1.21 - 1.21.x 以及 Java 21 或更高版本。
?️ 安装与设置
确保你在 Paper 服务器上安装了最新版的 FancyNpcs(Java 21 移植版)。
将 FancyNpcMovementsAddon.jar 放入服务器的 plugins 文件夹。
重启服务器。
(可选) 若要完全消除 NPC 移动时的手臂摆动/攻击动画,请打开 plugins/FancyNpcs/config.yml 文件并将 swing_arm_on_update 设置为 false。
站在你想要路线开始的位置,使用 /npcpatrol addpoint <YourNPCName> 开始构建你的巡逻路径!
FancyNpcMovementsAddon is a lightweight, robust expansion plugin built specifically for server owners using FancyNpcs. Because packet-based NPCs do not have standard Minecraft AI or pathfinding engines, this addon steps in to handle smooth, coordinated movement without putting a heavy strain on your server's CPU.
With this addon, you can transform your static NPCs into living, breathing town guards, wandering merchants, or roaming dungeon mobs that pace back and forth along routes that you design completely in-game.
✨ Core Features
?️ Dynamic In-Game Waypoints: Walk to a location, type a command, and instantly map out your NPC’s walking path. No complex text coordinate configuration required.
? Ping-Pong Routing: NPCs smoothly transition through your custom waypoints. Once they reach the end of their path, they automatically reverse order and walk backward to the start point, looping infinitely.
? Intelligent Click-to-Pause: If a player right-clicks a patrolling NPC, the NPC will pause its movement for 10 seconds to interact with the player before seamlessly resuming its route.
⚡ Double-Packet Debounce Shield: Built to intercept double-interaction client packets. When a player right-clicks your NPC, its configured actions (like opening a GUI or running a command) trigger exactly once—no duplicate menu openings or spammed messages.
? Full Autocomplete / Tab-Completion: Includes an intelligent tab-completer that auto-fills commands and dynamically grabs the names of all your registered FancyNpcs.
? Persistent Saving: All patrol paths and global speed settings automatically save directly to a config.yml on the fly and reload instantly whenever the server reboots or reloads.
⚙️ Platform Compatibility
Because this plugin relies directly on the advanced packet injection system used by FancyNpcs, it requires a modern, high-performance server environment.
Supported ✅: Paper, Folia.
Unsupported ❌: Vanilla Spigot or CraftBukkit (FancyNpcs does not support Spigot natively).
Requirements: Minecraft 1.21 - 1.21.x and Java 21 or higher.
?️ Installation & Setup
Ensure you have the latest FancyNpcs (Java 21 Backport version) installed on your Paper server.
Drop FancyNpcMovementsAddon.jar into your server’s plugins folder.
Restart your server.
(Optional) To completely eliminate the arm-swing/punching animation when the NPC moves, open your plugins/FancyNpcs/config.yml file and set swing_arm_on_update to false.
Stand where you want a route to begin, and use /npcpatrol addpoint <YourNPCName> to start building your patrol path!
评论 0
登录后参与评分
还没有评论,来抢沙发吧