PhantomPlayers

插件

· 作者 Sparklee_dev

一个简单但功能强大的批量假玩家插件,专为 Minecraft 最新版本打造。

0 本站下载 0 关注 更新于 4 周前

最新 1.0.0 · 26.3 · Bukkit / Folia

一键开服(送7天)
PhantomPlayers Infographic
详细信息

PhantomPlayers

PhantomPlayers 是一款基于配置的 Paper 和 Folia 虚假玩家人口插件。它提供基于数据包的虚拟玩家、全局 TAB 列表条目、模拟对话、皮肤配置以及可配置的服务器浏览器玩家数量显示。

注意:虚假玩家是虚拟配置文件,并非真实的 Minecraft 客户端连接。它们不计入真实的 Bukkit 玩家,也不会触发真实的玩家加入/离开事件。

兼容性

平台| 版本| 状态 Paper| 1.21.11| 编译验证通过 Folia| 1.21.11| 编译验证通过 Paper| 26.3| 编译验证通过;运行时未验证 Folia| 26.3| 编译验证通过;运行时未验证

  • 最低目标版本:Minecraft 1.21.11。
  • Java 21 字节码;Minecraft 26.3 在运行时需要 Java 25。
  • 客户端可见行为及 Folia 运行时兼容性尚未完全验证。

安装

  1. 下载 "PhantomPlayers-1.0.0.jar"。
  2. 将其放入服务器的 "plugins/" 目录中。
  3. 启动服务器。
  4. 编辑生成的配置文件。
  5. 运行 "/fp spawnall"。

重启后,插件默认处于零个活跃虚假玩家的状态。

命令

命令| 描述| 权限 "/fp spawn <name>"| 生成一个虚假玩家| "phantomplayers.spawn" "/fp spawnall"| 生成达到配置上限的虚假玩家| "phantomplayers.spawn" "/fp despawn <name>"| 移除一个虚假玩家| "phantomplayers.despawn" "/fp despawnall"| 移除所有活跃的虚假玩家| "phantomplayers.despawnall" "/fp list [page]"| 查看虚假玩家及人口统计信息| "phantomplayers.list" "/fp reload"| 重新加载配置、名称和聊天模板| "phantomplayers.reload"

"phantomplayers.admin" 权限授予上述所有列出的权限。权限默认仅对操作员开放。

配置文件

所有文件均位于 "plugins/PhantomPlayers/" 目录下。

文件| 用途 "config.yml"| 人口上限、生成、TAB 列表、延迟(Ping)、皮肤、服务器列表设置、兼容性 "names.txt"| 用户名池;每行一个名称 "chat.yml"| 共享对话模板及时间间隔 "players.yml"| 可选的禁用身份及 UUID 覆盖 "cache/profiles.yml"| 持久化的皮肤配置缓存

重要设置

在 "config.yml" 中:

  • "population.max-active" — 最大活跃虚假玩家数;默认值为 "100"。
  • "population.spawn-batch-size" — 每批次生成的玩家数量。
  • "population.spawn-batch-delay-ticks" — 批次之间的延迟(以刻为单位)。
  • "presentation.tab-list" — 启用虚假 TAB 列表条目。
  • "presentation.entity-view-distance" — 同世界实体可见距离。
  • "profiles.enabled" — 启用基于用户名的 Mojang 个人资料和皮肤查询。
  • "ping.enabled" — 启用随机化的虚假玩家延迟值。
  • "ping.minimum-ms" / "ping.maximum-ms" — 延迟范围。
  • "server-list.count-mode" — "active"(活跃)、"configured"(已配置)或 "disabled"(禁用)。
  • "server-list.include-fake-count" — 在显示的在线人数中包含虚假玩家。
  • "server-list.include-fake-sample-names" — 在服务器浏览器示例中包含虚假名称。

请参阅生成的 "config.yml" 以获取所有支持的设置及默认值。

"names.txt"

捆绑文件中包含 600 个虚构用户名。每行添加一个用户名。空行和以 "#" 开头的行将被忽略。无效和重复的名称将被跳过并给出警告。

"chat.yml"

使用加权模板和说话者占位符配置共享的多行对话:

  • "{player1}", "{player2}", "{player3}" 等。
  • "min-delay-seconds" / "max-delay-seconds"
  • "conversation-cooldown-seconds"
  • "max-concurrent-conversations"
  • "max-lines-per-conversation"

聊天将向所有世界中连接的现实玩家全局广播。当没有现实观众在线时,对话会暂停。

"players.yml"

可选覆盖:

disabled:

  • SomeName

uuids: SomeName: 00000000-0000-0000-0000-000000000000

被禁用的身份不会出现在 "/fp spawnall" 的结果中。UUID 覆盖允许自定义稳定的身份标识。

PlaceholderAPI

PlaceholderAPI 为可选组件。如果已安装,PhantomPlayers 会自动注册其扩展。

占位符| 描述 "%phantomplayers_fake_online%"| 活跃虚假玩家数 "%phantomplayers_real_online%"| 真实在线玩家数 "%phantomplayers_total_online%"| 真实 + 活跃虚假玩家总数 "%phantomplayers_fake_max%"| 配置的最大值 "%phantomplayers_configured%"| 已启用的保存身份数 "%phantomplayers_spawned%"| 已完全生成的虚假玩家数 "%phantomplayers_unspawned%"| 当前未激活的配置身份数

示例:

Online: %phantomplayers_total_online% Fake: %phantomplayers_fake_online%

重要行为说明

  • 仅数据包玩家:虚假玩家不是真实连接,不会出现在 "/list" 中,也不会触发真实的加入/离开事件。
  • TAB 可见性:虚假条目会全局发送;物理实体的可见性仅限于同一世界中附近的观察者。
  • 加入/离开消息:PhantomPlayers 不会生成单独的加入/离开公告。现有的服务器插件无法自动将虚拟配置文件视为真实连接。
  • 皮肤:当启用时,用户名查询使用 Mojang 的公共 API。结果会被缓存;不可用的个人资料会使用配置的后备方案。
  • 延迟(Ping):虚假延迟仅为视觉效果。服务器浏览器示例不支持按玩家显示的延迟值。
  • 服务器状态:虚假数量和示例名称与游戏内 TAB 列表分开处理。
  • 重启行为:活跃的虚假玩家不会自动恢复。重启后请运行 "/fp spawnall"。
  • Folia:在所有列出的版本上,运行时行为尚未完全验证。

网络访问

当 "profiles.enabled: true" 时,PhantomPlayers 会联系 Mojang 的公共 API 来解析用户名和皮肤配置。禁用此设置可阻止这些出站请求。

支持与兼容性

报告问题时请提供 Minecraft 版本、服务器平台、相关配置和错误日志。有关详细的构建验证和已知限制,请参阅 "DELIVERY.md"。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源