Really Fake Players - 虚拟玩家插件

简介

TitanBox Project Really Fake Players 是一款为您的服务器增添“虚假玩家”的插件。当服务器在线人数稀少时，它可以自动或手动添加这些被服务器识别为真实玩家的“假人”，营造活跃的社区氛围，并可以设置欢迎消息。本插件由服务器主开发并分享。

💡功能特性

• 添加被服务器识别为真实玩家的虚假玩家。
• 支持自动模式：在服务器启动后，在配置的最小和最大数量范围内随机生成假人。
• 支持手动模式：通过命令精确添加或移除特定假人。
• 假人可以发送欢迎消息，对新加入或再次加入的玩家表示问候。
• 假人支持通过 Vault 插件随机分配权限组。
• 可配置假人的自动登录、退出时间以及各种交互规则。

🎮安装与设置

快速安装

• 停止您的服务器。
• 将插件文件 ReallyFakePlayers.jar 放入服务器的 plugins 文件夹。
• 启动服务器。
• 首次生成配置文件后，再次停止服务器。
• 根据需求编辑配置文件，然后重新启动服务器即可。

前置需求与依赖

• 必需：Spigot 或 Paper 服务端。
• 可选：安装 Vault 插件，以便为假人随机分配权限组。
• 注意：如果同时使用 ProtocolLib，请将其配置中的 safeLogging 设置为 true。

🔧命令列表

所有命令均以 /rfp 开头。

• /rfp help - 显示帮助信息。
• /rfp add <#> - 添加指定数量的随机假人。
• /rfp add <name> - 添加一个指定名称的假人。
• /rfp remove <name> - 移除一个指定名称的假人。
• /rfp remove all - 移除所有假人。
• /rfp list - 列出所有当前在线的假人。
• /rfp reload - 重载插件配置。

✨权限节点

• titanbox.admin 或 titanbox.rfp.admin - 拥有使用所有插件命令的权限。
• titanbox.rfp.show - 允许玩家看到假人发送的聊天消息。

⭐配置说明

以下为默认配置文件 config.yml 的核心结构说明：

settings:
  maximum: 60 # 允许添加的假人最大数量（不建议超过60）
  block_interaction: true # 阻止包含假人名字的命令执行
  message: "This player is on DND (Do Not Disturb)!" # 命令被阻止时显示的提示
  ops_fake_tag: true # OP是否能看到假人名字旁的[I‘m Fake]和[Fake Player]标签
  groups: # 假人将被随机分配到的权限组列表（需要Vault）
    - default
    - Helper
    - Admin

auto:
  enable: true # 是否启用自动模式
  join_messages: true # 假人是否发送欢迎消息
  firstJoinMessages: # 对新玩家发送的随机欢迎语，<name>会被替换为玩家名
    - "Welcome!"
    - "Welcome <name>!"
  reJoinMessages: # 对老玩家重新加入时发送的随机问候语
    - "WB"
    - "Welcome back <name>!"
  minimum: 3 # 自动创建假人的最小数量
  maximum: 7 # 自动创建假人的最大数量

logging:
  seconds_delay_join: 3 # 服务器启动后，延迟多少秒登录所有假人
  minimum_minutes: 5 # 假人自动登录/退出的最短时间间隔（分钟）
  maximum_minutes: 60 # 假人自动登录/退出的最长时间间隔（分钟）
  join: true # 是否启用自动登录
  quit: true # 是否启用自动退出

重要说明

• 假人名库存储在 NameList.yml 文件中，您可以编辑此文件来修改可随机的名字列表。
• 如果有一个真实玩家使用了与假人相同的名字登录，该假人会被自动移除。
• 假人名称前的 [I‘m Fake] 和 [Fake Player] 标签默认仅对 OP 可见。

❓常见问题与提示

• 可以添加超过60个假人吗？

虽然配置允许设置更高上限，但出于性能考虑，不建议添加超过60个假人。

• 假人会执行命令或影响游戏吗？

假人本质上是“隐形”的，不会移动或执行游戏操作。默认设置下，任何尝试以假人名字为目标或包含假人名字的命令都会被阻止。

• 如何获得支持或查看更新？
• 支持 Discord: https://discord.gg/aPNfNchM （请允许24-72小时的响应时间）
• 开发者服务器: play.firesoftitan.com
• 开发者网站: www.firesoftitan.com

• 关于源代码

您可以自由复制或复用本插件的代码，源代码将很快公布。

🔧计划更新

• 在玩家列表（Tab List）中支持显示假人。
• 增强对权限组（Group）和权限（Permissions）的支持。
• 未来可能考虑添加 NPC 功能。