PhantomControl

PhantomControl是一款功能强大的Minecraft服务器插件，用于管理玩家的幻翼生成，支持Folia和Spigot/Paper服务器。

开发由来

在Minecraft高版本中，幻翼是一种夜间生成的敌对生物，会攻击长时间未睡觉的玩家。但对于许多玩家来说，它们往往会带来不必要的困扰：

• 频繁的幻翼攻击会打断玩家的正常游戏体验
• 对于建筑等长时间专注任务的玩家来说，幻翼的干扰尤为明显
• 部分玩家可能不喜欢与幻翼战斗，更倾向于专注于自己喜欢的游戏内容
  然而，如果服务器直接禁用所有幻翼，又会剥夺那些需要幻翼的玩家的游戏体验。我自己服务器为了平衡这两种需求，让玩家能够自主选择是否开启幻翼，查阅相关类似功能的开源插件之后，进行了自己这插件的开发，所以诞生了这插件。
  这款插件允许玩家根据自己的喜好控制幻翼生成，同时支持管理员进行全局管理，完美解决了服务器中幻翼带来的困扰问题。
• 不过毕竟是我服务器自己想出来的需求，而且本人也是小白，所以插件的功能还有可以完善的地方。如果有什么建议或者问题，欢迎各位大佬提出。

功能特性

• ✅ 幻翼生成控制：允许玩家启用或禁用自己的幻翼生成
• ✅ 管理员命令：支持管理员管理其他玩家的幻翼设置
• ✅ 数据库支持：支持FlatFile和MySQL两种数据库存储方式
• ✅ Folia兼容：完全支持Folia服务器，自动检测环境并优化调度
• ✅ 世界白名单/黑名单：可配置指定世界是否启用幻翼控制
• ✅ 自动保存机制：定期自动保存玩家数据
• ✅ 配置重载：支持动态重载配置，无需重启服务器
• ✅ 完整的权限系统：精细的权限控制
• ✅ 多语言支持：支持中文和英文，可自动根据玩家客户端语言调整
• ✅ GUI界面：提供图形化控制界面，方便玩家操作
• ✅ bStats集成：提供插件使用情况统计，可在配置文件中控制开启或关闭

安装方法

1. 下载最新版本的PhantomControl.jar文件
2. 将jar文件放入服务器的plugins文件夹中
3. 重启服务器，插件会自动生成配置文件
4. 根据需要修改配置文件，然后使用/phantomreload命令重载配置

配置说明

插件生成的配置文件位于plugins/PhantomControl/config.yml，主要配置项如下：

数据库设置

database:
  type: "flatfile" # 数据库类型，可选值：flatfile, mysql
  auto-save-interval: 300 # 自动保存间隔（秒），0表示不启用
  mysql:
    address: "localhost:3306" # MySQL地址
    username: "username" # MySQL用户名
    password: "password" # MySQL密码
    database: "phantom_control" # 数据库名称
    prefix: "phc_" # 表前缀

世界白名单/黑名单

whitelist:
  world-whitelist-enabled: false # 是否启用世界白名单
  world-blacklist-enabled: true # 是否启用世界黑名单
  blacklist:
    world-whitelist: [] # 白名单世界列表
    world-blacklist: [] # 黑名单世界列表

多语言设置

settings:
  message:
    # 默认消息显示方式：CHAT, ACTION_BAR, TITLE
    default-type: "CHAT"
    # 是否在状态变更时显示标题消息
    show-title-on-change: false
    # 是否在状态变更时显示ActionBar消息
    show-actionbar-on-change: false
    # 语言设置
    language:
      # 语言模式: auto, chinese, english
      # auto: 自动根据玩家客户端语言选择（默认为英文，如果玩家是简体中文就用中文）
      # chinese: 强制使用中文
      # english: 强制使用英文
      mode: "auto"
      # 默认语言文件名称（不含.yml扩展名）
      default: "messages_en"
  
    # bStats统计设置
    bstats:
      # 是否启用bStats统计功能
      enabled: true

GUI设置

settings:
  gui:
    # GUI标题
    title: "幻翼控制"
    # 状态方块材质
    status-enabled-material: "GREEN_WOOL"
    status-disabled-material: "RED_WOOL"
    # 按钮材质
    enable-button-material: "LIME_DYE"
    disable-button-material: "RED_DYE"
    info-button-material: "BOOK"
    border-material: "GRAY_STAINED_GLASS_PANE"

消息配置

消息配置已移至 messages.yml 文件，支持多语言设置。

命令说明

玩家命令

管理员命令

权限说明

插件优势

PhantomControl插件具有以下显著优势：

• 模块化架构：采用清晰的Manager类划分，代码结构清晰，易于维护和扩展
• 完全Folia兼容：自动检测Folia环境并优化调度，确保在Folia服务器上高效运行
• 性能优化：使用ConcurrentHashMap缓存玩家数据，优化Folia检查逻辑，提高插件运行效率
• 灵活的数据库支持：同时支持FlatFile和MySQL两种数据库存储方式，满足不同服务器需求
• 精细的权限控制：提供完整的权限系统，支持管理员精细管理
• 世界级别的控制：支持世界白名单/黑名单，可配置指定世界是否启用幻翼控制
• 自动保存机制：定期自动保存玩家数据，确保数据安全
• 动态配置重载：支持动态重载配置，无需重启服务器

PlaceholderAPI支持

PhantomControl插件支持PlaceholderAPI，[B]温馨提示：PlaceholderAPI的2.11.7版本开始支持folia[/B]

可用占位符

常见问题

Q: 插件支持哪些服务器版本？

A: 插件支持Minecraft 1.19+版本，包括Spigot、Paper和Folia服务器。

Q: 为什么玩家禁用幻翼后仍然有幻翼生成？

A: 请检查：

1. 玩家所在世界是否在白名单/黑名单中
2. 插件是否有足够的权限
3. 服务器是否有其他插件影响幻翼生成

Q: 如何查看玩家的TIME_SINCE_REST统计值？

A: 在游戏中的ESC中，有统计信息，可以查看“上次入眠时间”

Q: 插件支持哪些语言？

A: 插件支持中文和英文，可自动根据玩家客户端语言调整，也可在配置文件中强制使用特定语言。

Q: 如何控制bStats统计功能？

A: 可以在配置文件中的 settings.bstats.enabled 选项中控制开启或关闭bStats统计功能。

开发者信息

作者

• 作者：CHL_chun
• QQ：2919089965

贡献

欢迎提交Issue和Pull Request，帮助改进插件！

bStats统计页面

统计数据每30分钟更新一次，数据来源：bStats.org

联系方式

• 如有问题或建议，请在我发的平台评论中提出
• 或通过QQ联系：2919089965

感谢使用PhantomControl插件！如有任何问题，请随时联系我。