?️ SpySpectator
SpySpectator 是一款现代、高性能的旁观模式、管理以及小游戏实用插件,专为运行 Paper、Purpur 和 Folia (1.21.1+) 的 Minecraft 服务器打造。
通过结合定制的无碰撞 Adventure Flight Engine(冒险飞行引擎)、原生的 第一人称视角锁定 功能以及 Minecraft 目标操作符 (@s, @p, @a, @r),SpySpectator 提供了极致的旁观体验,且不会出现原版穿墙导致的区块加载卡顿。
✨ v3.0.1 新增内容
- ? 目标操作符支持:在
/spectate和/spectator switch命令中全面支持@s、@p、@a和@r。 - ? 第一人称视角旁观:在旁观模式下右键点击任意玩家,即可直接锁定至其视野;潜行(Shift)可脱离并回到自由飞行状态!
- ? 无损重启库存持久化:背包和护甲以 Base64 序列化存储——服务器重启不会丢失物品。
- ⚡ 零区块加载延迟:使用非阻塞的已加载区块验证替代了同步区块加载。
- ? 分页传送 GUI:支持跨多页浏览无限数量的玩家,并显示生命值、世界和游戏规则模式指示器。
- ? 副手物品保护:旁观快捷栏中的实用工具无法再通过 'F' 键移动或绕过。
- ⚙️ 完整的
config.yml配置:自定义所有消息、物品槽位、标题、描述文本和飞行速度。
?️ 交互式快捷栏工具
进入旁观模式时,玩家将收到 4 个锁定的实用工具物品(槽位和描述文本可在 config.yml 中配置):
- ? 指南针 (槽位 4):打开一个交互式的分页 GUI,显示在线玩家的头像,实现一键瞬间传送。
- ? 纸张 (槽位 2):左键点击切换旁观聊天;右键点击打开按玩家屏蔽菜单。
- ?️ 末影之眼 (槽位 6):左键点击切换旁观可见性;右键点击隐藏特定的旁观者。
- ?️ 红床 (槽位 8):右键点击退出旁观模式并安全恢复你的生存模式背包。
? 命令与权限
| 命令 | 描述 | 权限节点 | 默认值 |
|---|---|---|---|
/spectator |
切换自己的旁观模式 | spyspectator.use |
所有人 |
/spectator leave [player|@selector] |
退出旁观模式并恢复背包 | spyspectator.use |
所有人 |
/spectator switch <player|@selector> |
切换目标玩家(们)的旁观模式 | spyspectator.admin.switch |
OP |
/spectator reload |
重载配置设置和消息 | spyspectator.admin |
OP |
/spectator lobby [set|remove] |
管理服务器退出旁观模式的大厅位置 | spyspectator.admin |
OP |
/spectate [player|@selector] |
进入旁观模式并旁观目标 | spyspectator.use |
旁观他人需 OP |
? 安装
- 下载最新的
SpySpectator-3.0.1.jar发布版本。 - 确保你的服务器在 Minecraft 1.21.1+ 上运行 Paper、Purpur 或 Folia,并使用 Java 21。
- 将
SpySpectator-3.0.1.jar放入服务器的plugins/目录中。 - 重启服务器。
- (可选)运行
/spectator lobby set定义退出大厅的出生点。
? 开发者 API
import com.spygamingog.spyspectator.api.SpySpectatorAPI;
import org.bukkit.entity.Player;
// 检查玩家是否处于旁观模式
boolean spectating = SpySpectatorAPI.isSpectator(player);
// 编程方式启用或禁用旁观模式
SpySpectatorAPI.enableSpectator(player);
SpySpectatorAPI.disableSpectator(player, false, true);
监听可取消的事件 PlayerSpectateEvent 和 PlayerUnspectateEvent 以控制小游戏和竞技场中的状态转换。
? 文档与链接
- ? 完整文档: DOCUMENTATION.md
- ? API 文档: apidoc.md
- ? 更新日志: changelog.md
? 许可证
本项目基于 MIT License 授权。
?️ SpySpectator
SpySpectator is a modern, high-performance spectator mode, moderation, and minigame utility plugin tailored for Minecraft servers running Paper, Purpur, and Folia (1.21.1+).
By combining a customized, collision-free Adventure Flight Engine with native First-Person Camera Locking and Minecraft Target Operators (@s, @p, @a, @r), SpySpectator delivers the ultimate spectator experience without vanilla noclip chunk lag.
✨ What's New in v3.0.1
- ? Target Operator Support: Full support for
@s,@p,@a, and@rin/spectateand/spectator switch. - ? First-Person Camera Spectating: Right-click any player while in spectator mode to lock directly into their view; sneak (Shift) to detach back into free-flight!
- ? Lossless Inventory Reboot Persistence: Inventories and armor are serialized in Base64—no item loss across server reboots.
- ⚡ Zero Chunk-Loading Lag: Replaced synchronous chunk loading with non-blocking loaded chunk verification.
- ? Paginated Teleporter GUI: Browse unlimited players across multiple pages with health, world, and gamemode indicators.
- ? Off-Hand Item Protection: Spectator hotbar utility tools can no longer be moved or bypassed using the 'F' key.
- ⚙️ Fully Wired
config.yml: Customize all messages, item slots, titles, lores, and flight speeds.
?️ Interactive Hotbar Tools
When entering spectator mode, players receive 4 locked utility items (slots and lores are configurable in config.yml):
- ? Compass (Slot 4): Opens an interactive, paginated GUI displaying online player heads for instant 1-click teleportation.
- ? Paper (Slot 2): Left-click to toggle spectator chat; right-click to open a player-by-player ignore menu.
- ?️ Ender Eye (Slot 6): Left-click to toggle spectator visibility; right-click to hide specific spectators.
- ?️ Red Bed (Slot 8): Right-click to exit spectator mode and safely restore your survival inventory.
? Commands & Permissions
| Command | Description | Permission | Default |
|---|---|---|---|
/spectator |
Toggle spectator mode for yourself | spyspectator.use |
Everyone |
/spectator leave [player|@selector] |
Exit spectator mode and restore inventory | spyspectator.use |
Everyone |
/spectator switch <player|@selector> |
Toggle spectator mode for target player(s) | spyspectator.admin.switch |
OP |
/spectator reload |
Reload configuration settings and messages | spyspectator.admin |
OP |
/spectator lobby [set|remove] |
Manage the server exit spectator lobby | spyspectator.admin |
OP |
/spectate [player|@selector] |
Enter spectator mode and spectate a target | spyspectator.use |
OP for others |
? Installation
- Download the latest
SpySpectator-3.0.1.jarrelease. - Ensure your server runs Paper, Purpur, or Folia on Minecraft 1.21.1+ with Java 21.
- Place
SpySpectator-3.0.1.jarinto your server'splugins/directory. - Restart your server.
- (Optional) Run
/spectator lobby setto define an exit spawn point.
? Developer API
import com.spygamingog.spyspectator.api.SpySpectatorAPI;
import org.bukkit.entity.Player;
// Check if player is spectating
boolean spectating = SpySpectatorAPI.isSpectator(player);
// Programmatically enable or disable spectator mode
SpySpectatorAPI.enableSpectator(player);
SpySpectatorAPI.disableSpectator(player, false, true);
Listen to cancelable events PlayerSpectateEvent and PlayerUnspectateEvent to control transitions in minigames and arenas.
? Documentation & Links
- ? Full Documentation: DOCUMENTATION.md
- ? API Documentation: apidoc.md
- ? Release Changelog: changelog.md
? License
This project is licensed under the MIT License.
下载 SpySpectator
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpySpectator
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpySpectator
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpySpectator
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpySpectator
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpySpectator
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpySpectator
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpySpectator
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpySpectator
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SpySpectator
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
更新日志
[3.0.1] - 2026-09-04
新增
/spectate和/spectator switch命令现支持原生的 Minecraft 目标选择器(@s、@p、@a、@r、@e)。- 通过右键点击玩家进行第一人称视角旁观,潜行以退出。
- 为目标选择器、玩家名称和子命令提供 Tab 补全功能。
- 控制台命令支持
/spectator reload、/spectator switch和/spectator leave。 - 传送器 GUI 支持多页分页。
- 新增
/spectator reload命令以热重载config.yml。 SpySpectatorAPI中新增第一人称视角和大厅管理方法。
修复
- 通过将背包和盔甲序列化到
spectators.yml,修复了服务器重启时严重的物品丢失漏洞。 - 修复了
/spectate命令未注册的问题。 - 修复了权限问题导致普通玩家无法切换旁观模式的情况。
- 修复了旁观实用工具与副手交换相关的利用漏洞。
- 通过使用
PersistentDataContainerUUID,修复了在彩色名称下点击头颅处理失败的问题。 - 修复了旁观者死亡的边缘情况,以防止掉落实用道具。
- 从
plugin.yml中移除了幻影般的SpyInventories依赖项。
更改与性能
- 使用
isChunkLoaded()替换同步区块加载,消除了跨区块的卡顿峰值。 - 将 Paper 和 Folia 线程安全的传送操作切换为
player.teleportAsync()。 - 将所有消息、速度、物品栏位和标题完全配置到
config.yml中。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧