ProgressionNPCWork

插件

· 作者 Thurindir

ProgressionNPCWork 目前是一个合并的 Paper 插件,将 NPC、任务、商店和伙伴系统整合在 /pnw 命令下,并已经包含对话书 UI、重载/配置功能、基岩版支持以及伙伴逻辑。

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

最新 1.0.5 · 1.21.11 · Paper

一键开服(送7天)

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>

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源