详细信息
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 运行时兼容性尚未完全验证。
安装
- 下载 "PhantomPlayers-1.0.0.jar"。
- 将其放入服务器的 "plugins/" 目录中。
- 启动服务器。
- 编辑生成的配置文件。
- 运行 "/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:
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"。
Detailed info
PhantomPlayers
PhantomPlayers is a configuration-driven fake-player population plugin for Paper and Folia. It provides packet-based virtual players, global TAB entries, simulated conversations, skin profiles, and configurable server-browser player counts.
Note: Fake players are virtual profiles, not genuine connected Minecraft clients. They do not count as real Bukkit players or trigger genuine player connection events.
Compatibility
Platform| Version| Status
Paper| 1.21.11| Compile-verified
Folia| 1.21.11| Compile-verified
Paper| 26.3| Compile-verified; runtime unverified
Folia| 26.3| Compile-verified; runtime unverified
- Minimum target: Minecraft 1.21.11.
- Java 21 bytecode; Minecraft 26.3 requires Java 25 at runtime.
- Client-visible behavior and Folia runtime compatibility have not been fully verified.
Installation
- Download "PhantomPlayers-1.0.0.jar".
- Place it in your server's "plugins/" directory.
- Start the server.
- Edit the generated configuration files.
- Run "/fp spawnall".
The plugin starts with zero active fake players after a restart.
Commands
Command| Description| Permission
"/fp spawn <name>"| Spawn one fake player| "phantomplayers.spawn"
"/fp spawnall"| Spawn fake players up to the configured limit| "phantomplayers.spawn"
"/fp despawn <name>"| Despawn one fake player| "phantomplayers.despawn"
"/fp despawnall"| Despawn all active fake players| "phantomplayers.despawnall"
"/fp list [page]"| View fake-player and population statistics| "phantomplayers.list"
"/fp reload"| Reload configuration, names, and chat templates| "phantomplayers.reload"
"phantomplayers.admin" grants all listed permissions. Permissions default to operators.
Configuration Files
All files are located in "plugins/PhantomPlayers/".
File| Purpose
"config.yml"| Population limits, spawning, TAB, ping, skins, server-list settings, compatibility
"names.txt"| Username pool; one name per line
"chat.yml"| Shared conversation templates and timing
"players.yml"| Optional disabled identities and UUID overrides
"cache/profiles.yml"| Persistent skin-profile cache
Important settings
In "config.yml":
- "population.max-active" — maximum active fake players; default "100".
- "population.spawn-batch-size" — players spawned per batch.
- "population.spawn-batch-delay-ticks" — delay between batches.
- "presentation.tab-list" — enable fake TAB entries.
- "presentation.entity-view-distance" — same-world entity visibility distance.
- "profiles.enabled" — enable username-based Mojang profile and skin lookups.
- "ping.enabled" — enable randomized fake-player ping values.
- "ping.minimum-ms" / "ping.maximum-ms" — ping range.
- "server-list.count-mode" — "active", "configured", or "disabled".
- "server-list.include-fake-count" — include fake players in the displayed online count.
- "server-list.include-fake-sample-names" — include fake names in the server-browser sample.
See the generated "config.yml" for all supported settings and defaults.
"names.txt"
The bundled file contains 600 fictional usernames. Add one username per line. Blank lines and lines beginning with "#" are ignored. Invalid and duplicate names are skipped with a warning.
"chat.yml"
Configure shared multi-line conversations using weighted templates and speaker placeholders:
- "{player1}", "{player2}", "{player3}", etc.
- "min-delay-seconds" / "max-delay-seconds"
- "conversation-cooldown-seconds"
- "max-concurrent-conversations"
- "max-lines-per-conversation"
Chat is broadcast globally to connected players in all worlds. Conversations pause when no real audience is online.
"players.yml"
Optional overrides:
disabled:
uuids:
SomeName: 00000000-0000-0000-0000-000000000000
Disabled identities are excluded from "/fp spawnall". UUID overrides allow custom stable identities.
PlaceholderAPI
PlaceholderAPI is optional. If installed, PhantomPlayers automatically registers its expansion.
Placeholder| Description
"%phantomplayers_fake_online%"| Active fake players
"%phantomplayers_real_online%"| Real online players
"%phantomplayers_total_online%"| Real + active fake players
"%phantomplayers_fake_max%"| Configured maximum
"%phantomplayers_configured%"| Enabled saved identities
"%phantomplayers_spawned%"| Fully spawned fake players
"%phantomplayers_unspawned%"| Configured identities not currently active
Example:
Online: %phantomplayers_total_online%
Fake: %phantomplayers_fake_online%
Important Behavior
- Packet-only players: Fake players are not real connections and do not appear in "/list" or trigger genuine join/quit events.
- TAB visibility: Fake entries are sent globally; physical entity visibility is limited to nearby viewers in the same world.
- Join/quit messages: PhantomPlayers does not generate separate join/quit announcements. Existing server plugins cannot automatically treat virtual profiles as genuine connections.
- Skins: Username lookups use Mojang's public APIs when enabled. Results are cached; unavailable profiles use the configured fallback.
- Ping: Fake latency is cosmetic. Server-browser samples do not support per-player ping values.
- Server status: Fake counts and sample names are handled separately from the in-game TAB list.
- Restart behavior: Active fake players are not restored automatically. Run "/fp spawnall" after restarting.
- Folia: Runtime behavior has not been fully verified on all listed versions.
Network Access
When "profiles.enabled: true", PhantomPlayers contacts Mojang's public APIs to resolve usernames and skin profiles. Disable this setting to prevent those outbound requests.
Support and Compatibility
Report issues with the Minecraft version, server platform, relevant configuration, and error logs. See "DELIVERY.md" for detailed build verification and known limitations.
评论 0
登录后参与评分
还没有评论,来抢沙发吧