ProgressionNPCWork
-
ProgressionNPCWork 是一个单一的、合并的 Paper 插件,将四个系统整合到一个清晰的工作流中:
-
ProgressionNPC → 具有管理员工具、皮肤和装备的持久化 NPC
-
ProgressionQuest → 基于 YAML 驱动的任务,包含 NPC 对话 + 可点击的聊天操作
-
ProgressionShop → 绑定到 NPC 的买卖商店,带有 GUI
-
ProgressionNPCCompanion → 任务同伴(跟随者),可选战斗功能 + 护送目标 + 装备转移
所有内容都存储在 plugins/ProgressionNPCWork/ 下的简单文件中,因此你可以使用命令、游戏内编辑器或原始 YAML 来管理内容。
亮点
-
一个插件,四个核心 RPG 系统(NPC、任务、商店、同伴)
-
NPC 对话 + 任务直接显示在聊天中(带有可点击的接受 / 交付按钮)
-
任务安全规则:只有在与正确的 NPC 交谈后才能接受/交付任务
-
主线任务链(Hauptquest)+ 独立的支线任务(Nebenquest)
-
战利品交付解析(支持多种物品 + 可选 cmd=...)
-
同伴系统:
-
平滑的跟随行为(不会因为玩家旋转而重新定位)
-
可选的战斗辅助(从不攻击玩家)
-
护送目标支持(到达目标后自动消失)
-
Shift + 右键点击同伴以打开装备 GUI
-
任务结束/失败时自动归还同伴装备(如果有任何遗留,下次加入时也恢复)
-
-
商店系统:
-
基于文件的商店(shops/*.yml)
-
买入 + 卖出条目
-
支持 ProgressionAPI 物品规格(如果可用)
-
使用 ProgressionEconomy 进行实际货币处理(如果已安装)
-
你会喜欢它的原因
-
你可以快速构建一个真正的 MMO 风格任务中心:创建 NPC → 添加对话 → 创建任务 → 激活 → 完成。
-
玩家获得清晰的流程:交谈 → 接受 → 交付物品 → 提交,只需极少命令。
-
它是为服务器迭代设计的:编辑 YAML,运行重载命令,继续推进。
-
你可以创建护送 / 同伴任务,无需自定义脚本。
功能
-
NPC 系统 (ProgressionNPC)
-
NPC 创建/删除/列表
-
“看向玩家”切换
-
“动画 / AI”切换 + 锚点控制(保持 NPC 在其位置)
-
传送 NPC 到你身边
-
NPC 装备 GUI(护甲 + 主手/副手)
皮肤系统:
-
按玩家名称保存 Mojang 皮肤
-
将保存的皮肤分配给 NPC
保护:
-
NPC 无法受到伤害
-
交互受控(没有原版村民交易)
任务系统 (ProgressionQuest)
-
任务定义存储为 YAML(quests/<id>.yml)
-
NPC 对话行按 NPC 存储(npcs/<id>.yml)
-
聊天中对话框下方的可点击任务操作:
-
[Accept] → 运行 /pv quest accept <id>
-
[Turn-in] → 运行 /pv quest turnin <id>
-
-
通过 requires_completed 实现任务前置条件(任务链)
交付规则:
-
必须与正确的 NPC 交谈(上下文系统)
-
可选“交付前访问 NPC”要求
奖励:
-
XP 奖励(授予真实经验值)
-
物品奖励(授予真实物品)
-
金币奖励目前仅显示(此处未实现任务经济支付)
任务书:
-
配置可变的 questbook.yml(标题/作者/CMD/页面/布局)
- /pv give questbook
商店系统 (ProgressionShop)
-
从 shops/*.yml 加载商店
-
每个商店都关联一个 npcId
-
基于 GUI 的买卖
-
买入支持物品规格(ProgressionAPI)或原版材质定义
-
卖出支持匹配规则(例如基于材质)
-
可选的背景填充物 + 导航/返回按钮设置
-
经济集成:
- 需要 ProgressionEconomy 才能实际进行买卖
同伴系统 (ProgressionNPCCompanion)
-
可以为每个任务启用同伴(companion.enabled)
-
可选战斗支持(companion.combat)
-
可选护送系统:
-
设置目标位置 + 半径
-
当玩家和同伴到达时,标记为已到达并消失同伴
模板 NPC 支持:
- 同伴可以从选择的 NPC 模板复制名称/皮肤/装备(companion.templateNpcId)
装备转移:
-
Shift + 右键点击你的同伴 → 打开装备 GUI
-
按玩家/任务保存
-
任务结束/失败时自动归还(如果有遗留,加入时恢复)
-
设置
-
安装
-
将 jar 文件放入服务器的 plugins/ 文件夹。
-
必需的依赖项
-
ProgressionAPI(硬依赖)
-
可选依赖项(推荐)
-
LibsDisguises + ProtocolLib(用于 NPC/同伴上的玩家皮肤伪装所需)
-
ProgressionEconomy(用于商店买卖正常工作所需)
-
首次启动
-
插件生成文件到以下位置:
-
plugins/ProgressionNPCWork/config.yml
-
plugins/ProgressionNPCWork/settings.yml
-
plugins/ProgressionNPCWork/ui.yml
-
plugins/ProgressionNPCWork/messages.yml
-
plugins/ProgressionNPCWork/colors.yml
-
plugins/ProgressionNPCWork/questbook.yml
-
plugins/ProgressionNPCWork/tool_prices.yml
-
plugins/ProgressionNPCWork/shops/ (如果为空则创建一个示例商店)
-
plugins/ProgressionNPCWork/templates/ (任务 + NPC 模板)
-
兼容性
-
平台:Paper(使用 Paper Brigadier 命令注册)
-
Minecraft:api-version: 1.21(基于 Paper 1.21.11 API 构建)
-
Java:21
-
依赖:ProgressionAPI
-
软依赖:ProtocolLib, LibsDisguises, ProgressionEconomy
基本工作流
-
创建 NPC
-
/pnpc npc create <name>
-
(可选)为其赋予皮肤
-
/pnpc skin save <skinId> <playerName>
-
/pnpc skin set <npcId> <skinId>
-
为该 NPC 添加对话行
-
选择 NPC(管理员,在游戏中):Shift-右键点击 NPC(或使用选择工具)
-
-
添加对话:
-
/pv chat create <text...> [npcId]
-
创建任务
-
-
主线任务链:
- /pv hauptquest create <name...> [npcId]
-
支线任务:
- /pv nebenquest create <name...> [npcId]
-
编辑任务内容
-
/pv quest edit <questId> (打开可点击编辑器)
-
设置任务文本、战利品要求、访问的 NPC 要求、奖励、同伴设置
-
-
激活任务
- /pv quest end <questId> (将任务设置为激活状态)
-
玩家游戏循环
-
玩家右键点击 NPC → 显示对话 → 出现带有可点击按钮的任务
-
接受任务 → 完成任务 → 交还任务
-
(可选)为某个 NPC 添加商店
-
创建或编辑 shops/<shopKey>.yml
-
-
将商店绑定到 NPC:
- /pshop bind <shopKey> <npcId>
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧