ControlPlayer - 玩家操控插件

ControlPlayer 是一款能让管理员实时操控其他玩家的 Minecraft 插件。你可以完全接管目标的移动、背包、游戏模式、宠物等一切行为，非常适合用来进行有趣的互动或管理。操作简单直接，只需一个命令即可开始或结束控制。

💡核心功能

• 实时完全控制：操控目标玩家的移动、视角、背包交互、游戏模式等所有行为。
• 伪装聊天：控制时，你在聊天栏输入的内容会以目标玩家的身份发出。
• 静默侦察模式：使用 /scp 命令可以先观察目标，再决定是否接管控制。
• 强制控制管理：管理员可以强制指定某玩家控制另一玩家，或强制其停止控制。
• 完整的返还机制：停止控制后，你的背包、经验、生命值、位置等状态将自动恢复。
• 多语言支持：内置包括中文在内的多种语言消息文件。
• API 支持：提供 API 供其他开发者集成，监听控制事件或自定义控制逻辑。

🎮命令与权限

基础控制命令

• /cp [player]
• 开始或停止控制一名玩家。
• 所需权限：controlplayer.use

静默侦察/控制命令

• /scp [player]
• 进入侦察模式观察玩家，之后可通过点击进行控制。
• 所需权限：controlplayer.silent.use

管理员强制命令

• /cpo [controller] [victim]
• 强制指定一名玩家（controller）去控制另一名玩家（victim）。
• 所需权限：controlplayer.other
• /cps [controller]
• 强制指定玩家（controller）停止控制他人。
• 所需权限：controlplayer.stop

实用命令

• /cpr
• 重载插件配置文件。
• 所需权限：controlplayer.reload
• /cpf
• 修复玩家碰撞箱（当玩家因控制出现 bug 时使用）。
• 所需权限：controlplayer.fix

豁免权限

• controlplayer.bypass
• 拥有此权限的玩家无法被他人控制。

🔧使用指南

如何开始与停止控制

• 执行命令 /cp [玩家名] 开始控制。
• 控制期间，你在聊天栏输入的任何内容都会以目标玩家的身份发出。
• 要停止控制，只需再次执行相同的命令 /cp [玩家名]。
• 停止后，你将自动恢复控制前的背包、等级、生命值、位置等状态。

如何在控制时使用自己的聊天

• 控制时，若想以自己的身份发言，请在消息前加上绕过前缀。
• 默认的绕过前缀是 -b （注意包含空格）。
• 例如：输入 -b 大家好！，这条消息将以你（控制者）的身份发出。

静默侦察模式 (`/scp`) 用法

• 执行 /scp [玩家名]。
• 你将进入观察视角，屏幕上方会显示提示。
• 根据提示（如“左键点击3次”）来切换为完全控制模式。
• 要释放玩家，可按住潜行键并执行相同的点击操作，或再次输入 /scp [玩家名]。

✨配置文件说明

主要配置文件 config.yml 允许你自定义插件行为：

命令别名

你可以为命令设置简写或别名，方便记忆和使用。

系统设置

• asyncchat: 控制聊天事件是否异步处理。
• ignorebypass: 是否忽略拥有 controlplayer.bypass 权限的玩家。

控制行为设置

可以同步或控制以下项目

• 饥饿值 (foodlevel)
• 强制聊天 (forcechat) 及其绕过前缀 (bypassmessage)
• 是否显示动作栏提示 (actionbar)
• 是否取消被控玩家的聊天 (cancelchat)
• 是否监听被控玩家的聊天 (spychat)
• 是否允许丢弃物品 (dropitems)
• 是否取消被控玩家的命令 (cancelcommands)
• 是否同步传送 (syncteleport)

停止控制后的返还设置

可以设置停止控制后，是否将以下状态返还给控制者

• 背包 (inventory)
• 位置 (location)
• 经验等级 (level)
• 生命值 (health)
• 饥饿值 (foodlevel)
• 游戏模式 (gamemode)
• 飞行状态 (flight)
• 药水效果 (effect)

❓API 与开发者

插件提供了 API，允许其他插件监听控制事件或集成控制功能。

事件类型

• START: 控制开始时触发。
• RUNNING: 控制持续期间触发。
• STOP: 控制停止时触发。

使用示例

ControlPlayerEventManager.register(new ControlPlayerEvent() {
    @Override
    public ControlPlayerEventType type() {
        return ControlPlayerEventType.RUNNING; // 事件类型
    }
    @Override
    public void execute(Player controller, Player victim) {
        // 在这里编写你的逻辑
    }
});

API 模式警告

在 config.yml 中可以将 apimode 设置为 true。这将禁用插件所有默认的同步控制逻辑，仅执行你通过 API 注册的代码。请仅在明确知晓后果的情况下启用此模式。

⭐翻译与本地化

插件支持多语言，感谢社区贡献者提供了以下翻译

• 土耳其语 (Turkish)
• 西班牙语 (Spanish)
• 中文 (Chinese)
• 希伯来语 (Hebrew)
• 俄语 (Russian)
• 法语 (French)
• 德语 (German)
• 英语 (English) - 默认

请注意：由于插件更新，部分翻译文件可能不是最新版本，可能存在未翻译的条目。你可以编辑 messages.yml 文件来自定义所有提示消息。

---

立即下载 ControlPlayer，为你的服务器增添有趣的互动和管理方式吧！