nnpc

插件

· 作者 nehatsu.

一款轻量且灵活的 Paper NPC 管理插件,支持玩家与生物 NPC、皮肤、全息图、动作、对话、路径及自定义功能。

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

最新 0.1.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)

NehaNPCs (NNPC)

NehaNPCs 是一个轻量且灵活的 Paper NPC 管理插件。

它提供持久的 Minecraft 实体 NPC 和基于数据包的 PLAYER NPC,支持皮肤、全息图、点击动作、对话、移动路径、装备、外观定制、本地化以及代理服务器传输。

NehaNPCs 的目标是在不需要大型 NPC 框架的情况下,为服务器 NPC 提供所需的基础功能。


功能

NPC 类型

NehaNPCs 支持两种不同类型的 NPC:

  • 常规 Minecraft 实体 NPC
  • 基于数据包的 PLAYER NPC

常规实体 NPC 是真实存在的 Bukkit 实体,其 AI 已被禁用,并可通过支持的实体属性进行自定义。

PLAYER NPC 使用 ProtocolLib 数据包显示,不会创建真实的在线玩家。


PLAYER NPCs

PLAYER NPC 支持以下功能:

  • 基于数据包的生成与消失
  • 自定义玩家皮肤
  • 按观察者镜像皮肤
  • Tab 列表处理
  • 点击检测
  • 自定义名称
  • 全息图
  • 动作
  • 对话
  • 移动路径

示例:

/npc create 1 player Guide
/npc skin 1 Notch
/npc toggle 1 mirror

mirror(镜像)选项会使 NPC 显示每个单独观察者的皮肤。


实体 NPC

普通的 Minecraft 实体也可以用作 NPC。

示例:

/npc create 2 villager Shopkeeper
/npc create 3 zombie Guardian

实体 NPC 可以具备以下特性:

  • 禁用 AI
  • 禁用重力
  • 无敌状态
  • 装备
  • 碰撞设置
  • 发光效果
  • 自定义显示名称
  • 全息图
  • 特定实体的外观设置

实体定制

/npc customize 命令可修改特定实体类型的支持属性。

/npc customize <id> <key> <value>

目前支持的定制选项包括:

盔甲架

setSmall
setArms
setBasePlate
setInvisible

苦力怕

setPowered

僵尸及幼年型实体

setBaby

史莱姆 / 岩浆怪

setSize

羊

setColor
setSheared

村民

setProfession
setVillagerType

狼

setSitting
setTamed
setAngry
setCollarColor

狐狸

setSitting
setFoxType
setSleeping
setCrouching

美西螈

setVariant

NPC 开关

NPC 的行为和显示选项可以通过以下方式更改:

/npc toggle <id> <look|holo|glow|mirror|collision> [color]

可用的开关包括:

  • look — 使 NPC 面向附近的玩家
  • holo — 启用或禁用全息图
  • glow — 启用或禁用发光
  • mirror — 在 PLAYER NPC 上显示观察者的皮肤
  • collision — 启用或禁用实体碰撞

全息图

NPC 可以在头顶显示自定义文本。

/npc lines <id> <text...>
/npc height <id> <height>

可以为每个 NPC 单独调整全息图的高度。


装备

活体实体 NPC 可以使用装备。

/npc equip <id> <HAND|OFFHAND|HELMET|CHESTPLATE|LEGGINGS|BOOTS>

支持的插槽:

HAND
OFFHAND
HELMET
CHESTPLATE
LEGGINGS
BOOTS

动作

NPC 在被点击时可以执行一个或多个动作。

/npc action add <id> <CMD|CONSOLE|CHAT|MESSAGE|SERVER> <content...>
/npc action list <id>
/npc action remove <id> <actionId>
/npc action cooldown <id> <actionId> <seconds>

支持的动作类型:

  • CMD — 以点击玩家的权限执行命令
  • CONSOLE — 从服务器控制台执行命令
  • CHAT — 作为玩家发送聊天输入
  • MESSAGE — 向玩家发送消息
  • SERVER — 将玩家传输到另一个代理服务器

每个动作都可以拥有独立的冷却时间。

占位符

动作支持以下占位符:

%player%
%uuid%
%world%
%x%
%y%
%z%
%npc_id%
%npc_name%

示例:

/npc action add 1 MESSAGE Hello %player%!
/npc action add 1 CONSOLE give %player% diamond 1

Velocity / 代理服务器传输

玩家可以使用以下方式被传输到另一个后端服务器:

/npc action add 1 SERVER lobby

也支持以下 CMD 形式:

/npc action add 1 CMD server lobby

使用 Velocity 时,请在 velocity.toml 中启用:

bungee-plugin-message-channel = true

后端服务器使用配置的 BungeeCord 插件消息通道。


对话

NPC 可以拥有可配置的对话系统。

/npc conversation create <name>
/npc conversation remove <name>
/npc conversation set <id> <name> <CLICK|RADIUS>
/npc conversation cooldown <name> <seconds>
/npc conversation radius <name> <radius>
/npc conversation text add <name> <delayTicks> <text...>
/npc conversation text remove <name> <index>
/npc conversation text list <name>
/npc conversation list

支持两种对话触发方式:

CLICK
RADIUS

CLICK 在点击 NPC 时开始对话。

RADIUS 允许玩家在进入配置范围时激活对话。

对话行可以拥有独立的延迟,从而让对话随时间逐步出现,而不是一次性全部显示。


移动路径

NPC 可以沿着可配置的路径移动。

/npc path create <name>
/npc path point <name>
/npc path set <id> <name>
/npc path speed <name> <speed>
/npc path loop <name> <true|false>
/npc path delete <name>
/npc path list

路径点是从玩家当前位置创建的。

路径支持:

  • 多个路径点
  • 可配置移动速度
  • 循环播放
  • 分配给各个 NPC

语言

NehaNPCs 内置了英文和日文本地化。

默认情况下,新安装会自动使用每位玩家的 Minecraft 语言设置:

settings:
  language: auto
  fallback-language: en

捆绑的语言包:

English  -> messages_en.yml
Japanese -> messages.yml

命令名称和子命令在所有语言中保持不变,而命令反馈、错误提示、用法消息及其他插件消息则会被本地化。

你可以为所有玩家强制指定一种语言:

settings:
  language: en

或者:

settings:
  language: ja

还支持类似 Locale 的值,例如:

en_US
ja_JP

可以通过创建语言文件来添加其他语言,例如:

plugins/NehaNPCs/messages_de_DE.yml

如果缺少翻译,NehaNPCs 会回退到配置的默认回退语言。

更改语言设置后,请运行:

/npc reload

存储

NehaNPCs 将其配置和持久化数据存储在 YAML 文件中。

plugins/NehaNPCs/config.yml
plugins/NehaNPCs/messages.yml
plugins/NehaNPCs/messages_en.yml
plugins/NehaNPCs/npcs.yml
plugins/NehaNPCs/conversations.yml
plugins/NehaNPCs/paths.yml

以下数据会在服务器重启后保留:

  • NPC
  • 位置
  • 实体类型
  • 皮肤
  • 装备
  • 全息图设置
  • 外观设置
  • 动作
  • 动作冷却时间
  • 对话
  • 对话设置
  • 移动路径

默认配置

NehaNPCs 包含可配置的 NPC 行为默认值。

settings:
  language: auto
  fallback-language: en
  autosave-interval-seconds: 60

  hologram:
    default-height: 0.3

  look-at-player:
    update-interval-ticks: 10
    radius: 8.0

  path:
    update-interval-ticks: 2
    default-speed: 0.2

  debug: false

server-transfer:
  enabled: true
  intercept-server-command: true
  channel: BungeeCord

默认情况下,NPC 数据每 60 秒自动保存一次。


命令

/npc create <id> <type> <name...>
/npc delete <id>
/npc list
/npc teleport <id>
/npc move <id>
/npc skin <id> <username>
/npc lines <id> <text...>
/npc height <id> <height>
/npc equip <id> <HAND|OFFHAND|HELMET|CHESTPLATE|LEGGINGS|BOOTS>
/npc type <id> <type>
/npc customize <id> <key> <value>
/npc toggle <id> <look|holo|glow|mirror|collision> [color]

/npc action <add|list|remove|cooldown> ...
/npc conversation <create|remove|set|cooldown|radius|text|list> ...
/npc path <create|point|set|speed|loop|delete|list> ...

/npc save
/npc reload

/znpcs 可作为 /npc 的别名使用。


权限

主要管理员权限是:

nehanpcs.admin

它授予对所有 NehaNPCs 命令的访问权限。

对于需要更细粒度权限控制的服务器,还提供单个命令的权限。


要求

  • Paper 1.21.x
  • ProtocolLib
  • 你的 Paper 构建所需的 Java 版本

Paper 1.21.11 需要兼容的 ProtocolLib 开发版才能支持 PLAYER NPC 功能。ProtocolLib 5.4.0 在该服务器版本上不支持所需的 PLAYER NPC 数据包。


日本語

NehaNPCsは、Paper向けの軽量で柔軟なNPC管理プラグインです。

通常のMinecraftエンティティを利用したNPCと、ProtocolLibのパケットを利用したPLAYER NPCの両方に対応しています。

スキン、ホログラム、クリックアクション、会話、パス移動、装備、エンティティごとの見た目設定などをゲーム内コマンドから管理できます。

主な機能

  • 通常エンティティNPC
  • PLAYER NPC
  • PLAYER NPCのスキン設定
  • プレイヤーごとのミラースキン
  • ホログラム
  • 装備設定
  • エンティティ固有の見た目設定
  • NPCクリックアクション
  • アクションごとのクールダウン
  • NPC会話
  • CLICK / RADIUSによる会話開始
  • 行ごとの会話表示遅延
  • NPCパス移動
  • 移動速度設定
  • パスのループ
  • NPCの視線追従
  • Glow設定
  • Collision設定
  • Velocityサーバー移動
  • YAMLによるデータ永続化
  • 自動保存
  • 日本語 / 英語対応
  • プレイヤーのMinecraft言語を利用した自動言語切替

基本例

/npc create 1 zombie &a案内人
/npc create 2 player Guide
/npc skin 2 Notch
/npc toggle 2 mirror
/npc list
/npc teleport 1
/npc move 1
/npc save
/npc reload

言語

初期設定ではプレイヤーがMinecraftで使用している言語を自動的に使用します。

settings:
  language: auto
  fallback-language: en

英語と日本語が標準で含まれています。

English  -> messages_en.yml
Japanese -> messages.yml

全員を日本語に固定する場合:

settings:
  language: ja

全員を英語に固定する場合:

settings:
  language: en

独自翻訳も追加できます。

plugins/NehaNPCs/messages_de_DE.yml

設定変更後は以下を実行してください。

/npc reload

NPC、アクション、会話、パス、スキン、ホログラム設定、位置などはYAMLへ保存され、サーバー再起動後にも復元されます。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源