PhantomControl

插件

· 作者 CHL_chun

PhantomControl 是一款轻量级的幻翼管理插件,适用于 Minecraft Paper 和 Folia 服务器。

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

最新 v2.1.1 · 26.3 · Folia / Paper

一键开服(送7天)

PhantomControl

PhantomControl 是一款适用于 Minecraft Paper 和 Folia 服务器的轻量级幻翼管理插件。它允许玩家自行选择是否为自己生成幻翼,同时为管理员提供了针对单个玩家、批量操作以及世界规则的集中控制功能。

语言: 中文说明

功能特性

  • 个人幻翼控制 – 玩家可以启用、禁用或查看自己的幻翼生成状态。
  • 管理员管理 – 管理其他玩家的状态,执行批量操作,并查看服务器统计数据。
  • 支持 Paper 和 Folia – 基于 Paper API 构建,具备 Folia 感知调度和环境检测功能。
  • FlatFile 与 MySQL 存储 – 可选择本地文件存储或远程 MySQL 数据库。
  • 世界白名单与黑名单 – 将幻翼控制限制在选定的世界中,或排除选定的世界。
  • 自动保存与缓存清理 – 定期保存玩家数据并清理过期的缓存条目。
  • 热重载配置 – 无需重启即可重载消息、GUI 设置、世界规则和数据库设置。命令名称和别名需要重启才能生效。
  • GUI 控制界面 – 为玩家提供简单的物品栏界面以更改其状态。
  • 中英文支持 – 自动跟随玩家的客户端语言,或在配置中强制指定语言。
  • PlaceholderAPI 支持 – 将幻翼状态暴露给记分板、标签页列表和其他集成工具。
  • 开发者 API 与事件 – 允许其他插件读取或更改状态,并监听状态变更或生成被阻止的事件。
  • bStats 与调试工具 – 可选的匿名使用统计信息、详细的调试日志记录以及配置验证功能。

依赖要求

  • Minecraft 1.20.1 或更高版本
  • Paper 或 Folia 服务器

不支持 Spigot 和 Bukkit 服务器。

安装步骤

  1. 从最新版本发布页面下载 PhantomControl-2.1.1.jar。
  2. 将该 JAR 文件放入服务器的 plugins 文件夹中。
  3. 重启服务器。PhantomControl 将创建其默认配置文件。
  4. 根据需要编辑配置文件,并运行 /phantomcontrolreload(或 /pcr)以应用可重载的设置。

Paper 和 Folia 通过服务器的库系统加载 HikariCP 和 MySQL 驱动程序;无需单独安装依赖项。

配置

主配置文件位于 plugins/PhantomControl/config.yml。消息内容分别存储在 plugins/PhantomControl/messages.yml 和 messages_en.yml 中。

数据库

database:
  type: "flatfile" # flatfile 或 mysql
  auto-save-interval: 300 # 秒数;设为 0 则禁用自动保存
  cache-timeout-minutes: 60
  mysql:
    address: "localhost:3306"
    username: "username"
    password: "password"
    database: "phantom_control"
    prefix: "phc_"

世界规则

whitelist:
  world-whitelist-enabled: false
  world-whitelist: []
  world-blacklist-enabled: true
  world-blacklist: []

当启用白名单时,仅对列出的世界进行控制。当启用黑名单时,将忽略列出的世界。

消息、语言、GUI 和调试

settings:
  message:
    default-type: "CHAT" # CHAT, ACTION_BAR, 或 TITLE
    show-title-on-change: false
    show-actionbar-on-change: false
    language:
      mode: "auto" # auto, chinese, 或 english
      default: "messages_en"
  bstats:
    enabled: true
  debug:
    enabled: false

GUI 材质和命令名称也可以在 settings.gui 和 settings.commands 下进行自定义。命令名称和别名为启动时注册,因此更改它们需要重启服务器。

示例 GUI 材质设置:

settings:
  gui:
    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"

命令

主要命令别名:/phantomcontrol、/pc、/phantom。

玩家命令

命令 描述 权限
/pc enable 或 /pc on 为你自己启用幻翼生成 phantomcontrol.use
/pc disable 或 /pc off 为你自己禁用幻翼生成 phantomcontrol.use
/pc toggle 或 /pc switch 切换你的幻翼生成状态 phantomcontrol.use
/pc status 或 /pc check 检查你当前的状态 phantomcontrol.use
/pc gui 或 /pc menu 打开图形控制菜单 phantomcontrol.use
/pc help 显示命令帮助 phantomcontrol.use

管理员命令

命令 描述 权限
/pc admin enable <player> 为某玩家启用幻翼 phantomcontrol.admin
/pc admin disable <player> 为某玩家禁用幻翼 phantomcontrol.admin
/pc admin status <player> 检查某玩家的状态 phantomcontrol.admin
/pc admin batch enable <player1> <player2> ... 为多名玩家启用幻翼 phantomcontrol.admin
/pc admin batch disable <player1> <player2> ... 为多名玩家禁用幻翼 phantomcontrol.admin
/pc admin server 查看在线玩家状态统计 phantomcontrol.admin
/phantomcontrolreload, /pcr, /phreload 重载插件配置 phantomcontrol.reload

权限

权限 描述 默认值
phantomcontrol.use 使用玩家控制命令 所有人
phantomcontrol.admin 使用管理员命令 操作员 (OP)
phantomcontrol.reload 重载插件配置 操作员 (OP)

没有 phantomcontrol.use 权限的玩家会被插件的权限强制机制自动保持启用状态。

PlaceholderAPI

PlaceholderAPI 为可选依赖。在 Folia 环境下推荐使用 2.11.7 或更高版本。

占位符 描述 示例
%phantomcontrol_enabled% 玩家幻翼是否已启用 true / false
%phantomcontrol_status% 本地化状态文本 Enabled / Disabled

Developer API

PhantomControl 通过 Bukkit 的 ServicesManager 注册了 PhantomControlAPI。

import org.bukkit.Bukkit;
import yyz.chl.phantomcontrol.api.PhantomControlAPI;

PhantomControlAPI api = Bukkit.getServicesManager().load(PhantomControlAPI.class);
if (api == null) return;

boolean enabled = api.arePhantomsEnabled(player);
api.setPhantomsEnabled(player, false);

对于离线 UUID 操作,请使用异步重载方法:

api.arePhantomsEnabled(playerId).thenAccept(enabled -> {
    Bukkit.getLogger().info("Phantoms enabled: " + enabled);
});

api.setPhantomsEnabled(playerId, false).thenAccept(success -> {
    Bukkit.getLogger().info("Saved: " + success);
});

可用的事件:

  • PhantomStatusPreChangeEvent – 在状态变更前触发,可被取消。
  • PhantomStatusChangeEvent – 在变更成功后触发;包含旧状态、新状态以及 PhantomStatusChangeSource。
  • PhantomSpawnBlockedEvent – 当 PhantomControl 阻止幻翼生成时触发。

事件监听器示例:

import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;
import yyz.chl.phantomcontrol.event.PhantomStatusPreChangeEvent;

public class PhantomListener implements Listener {
    @EventHandler
    public void onPreChange(PhantomStatusPreChangeEvent event) {
        if (!event.willBeEnabled()
                && event.getPlayer().hasPermission("server.need.phantom")) {
            event.setCancelled(true);
        }
    }
}

FAQ

为什么幻翼仍在生成?

请检查世界的白名单/黑名单规则,确认 PhantomControl 已无错误加载,并排查是否有其他插件改变了幻翼的生成行为。

PhantomControl 会更改玩家的睡眠统计数据吗?

不会。该插件通过 Paper 事件阻止幻翼生成,并不会修改玩家的 TIME_SINCE_REST 统计值。

如何禁用 bStats?

将 settings.bstats.enabled 设置为 false,然后重新加载配置。

如何启用调试日志?

将 settings.debug.enabled 设置为 true,然后重新加载配置。详细的诊断信息将写入控制台。

bStats

PhantomControl 使用 bStats 收集匿名的服务器和插件使用统计数据。可以通过设置 settings.bstats.enabled: false 来禁用数据收集。

链接与联系方式

如果 PhantomControl 对你的服务器有所帮助,欢迎在 GitHub 上留下星标,或通过问题追踪器提交建议和问题。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源