原创 - 开源 - SpectatePlugin — 无人挂载直播旁观插件

版权类型: 原创

插件中文名称: 好用的直播旁观

插件英文名称: SpectatePlugin

原帖地址: https://github.com/y1123494529/-SpectatePlugin

支持的核心（服务端）

Paper
Purpur

语言支持: 中文（简体）

前置组件: 无

适配版本（Java）

1.21

================================================================

SpectatePlugin —— 无人挂载直播旁观插件

================================================================

一个为 Minecraft Paper 服务器设计的第一人称旁观插件。
管理员进入旁观者模式，自动轮流锁定在线玩家的视角，
适用于直播、录屏、活动监控等场景。

版本: 1.8.0

兼容: 理论支持 1.20.1+，已测试版本 1.21.4

协议: Paper API License

作者: yzmtcd

================================================================

核心功能

================================================================

[1] 第一人称锁定旁观
----------------------------------------------------------------

第一人称锁定旁观，自动轮流切换在线玩家

支持自动定时切换，无需手动操作

切换时锁定视角，确保直播画面稳定

[2] 多插件完美兼容
----------------------------------------------------------------

完全兼容 Multiverse-Core
（多世界传送、区块加载、模式守护）

完全兼容 ItemsAdder
（等待资源包加载完成后再切旁观模式，零干扰）

完全兼容 PlaceholderAPI
（显示世界别名）

[3] 丰富的视觉反馈
----------------------------------------------------------------

BossBar 倒计时条（可自定义颜色/样式）

ActionBar 实时信息（玩家血量、坐标、世界、手持物品）

Title 切换动画 +

音效 +

粒子特效

[4] 旁观黑名单与统计
----------------------------------------------------------------

旁观黑名单（跳过指定玩家）

运行统计（切换次数、观看人数、运行时长）

[5] 三层绑定防护
----------------------------------------------------------------

主动绑定 +

重试兜底 +

心跳守护

区块加载轮询等待
（跨世界/大距离绑定时确保区块就绪）

资源包按需监听
（旁观不运行时插件零监听器，不干扰 IA）

================================================================

指令与权限
================================================================

[MD] | 指令 | 权限 | 说明 | |------|------|------| | `/spectate start` | `spectate.admin` | 启动旁观模式 | | `/spectate stop` | `spectate.admin` | 停止旁观模式 | | `/spectate next` | `spectate.admin` | 跳过当前，立即切到下一个玩家 | | `/spectate skip <玩家>` | `spectate.admin` | 添加/移除旁观黑名单 | | `/spectate skiplist` | `spectate.admin` | 查看旁观黑名单 | | `/spectate stats` | `spectate.admin` | 查看运行统计 | | `/spectate info` | `spectate.admin` | 查看当前状态 | | `/spectate reload` | `spectate.admin` | 重新加载配置 | [/MD]

================================================================

配置文件说明
================================================================

配置文件路径：plugins/SpectatePlugin/config.yml

配置项说明如下：

[MD] ```yaml # 切换玩家间隔（秒） switch-interval: 30 # 启动延迟（tick，1秒=20tick），用于等待 IA 资源包 start-delay-ticks: 100 # 切换缓冲（tick） switch-delay-ticks: 10 # BossBar 创建延迟（tick） bossbar-delay-ticks: 20 # 传送后绑定延迟（tick），同世界大距离/跨世界都走这个延迟 # 区块加载轮询超时 = 此值 × 3 cross-world-bind-delay-ticks: 60 # BossBar 颜色：BLUE GREEN PINK PURPLE RED WHITE YELLOW bossbar-color: BLUE # BossBar 样式：SOLID SEGMENTED_6 SEGMENTED_10 SEGMENTED_12 SEGMENTED_20 bossbar-style: SOLID # Multiverse-Core 多世界兼容 multiverse-compat: true # PlaceholderAPI 世界别名 papi-world-name: true # 功能开关 actionbar-enabled: true actionbar-update-ticks: 10 title-enabled: true sound-enabled: true particle-enabled: true ``` [/MD]

================================================================

绑定逻辑（三层防护）
================================================================

第一层：safeSpectate（启动/切换/找回）
----------------------------------------------------------------

流程：ensureSpectatorMode → tp → waitForChunk
→ 绑定 → 二次确认

适用场景：正常启动、定时切换、视角找回

第二层：scheduleRetryBind（复活/切世界/加入，3 次重试）
----------------------------------------------------------------

流程：ensureSpectatorMode → tp → waitForChunk
→ 绑定 → 二次确认 → 失败重试

适用场景：玩家复活、跨世界传送、重新加入服务器

最多重试 3 次，每次失败后重新走完整流程

第三层：heartbeatTask（每秒心跳守护）
----------------------------------------------------------------

流程：检查绑定是否丢失 → 丢失则自动重绑

适用场景：全天候守护，每秒检测一次绑定状态

绑定一旦丢失立即自动恢复，玩家无感知

================================================================

兼容性
================================================================

[MD] | 插件 | 状态 | 说明 | |------|------|------| | Paper 1.21+ | ✅ 完全支持 | 核心运行环境 | | Multiverse-Core | ✅ 完全支持 | 模式守护 + 拦截 + 恢复 | | ItemsAdder | ✅ 完全支持 | 按需监听 + 零干扰 | | PlaceholderAPI | ✅ 完全支持 | 世界别名显示 | [/MD]