Let Me Peek

Let Me Peek

一个服务端 Minecraft 模组，让你通过简单的命令观察你的朋友和其他玩家在做什么——无需实际移动你的玩家角色。

✨ 功能特性

• 玩家观察：从任意玩家的视角查看，而无需移动自己
• 状态保护：自动保存并恢复你的位置、物品和状态效果
• 灵活切换：在不同观察目标之间无缝切换
• 隐私控制：私密模式、黑名单/白名单系统以及自动接受设置
• 崩溃恢复：即使在服务器意外重启后也能恢复你的状态
• 完全可配置：所有功能、限制和行为均可通过配置自定义
• LuckPerms 集成：完整的权限节点支持，实现细粒度的访问控制
• PlaceholderAPI 支持：丰富的占位符系统，便于与其他模组和插件集成

⌨️ 命令

核心 Peek 命令

/peek player <player>              # 开始观察某位玩家
/peek accept <player>              # 接受一个收到的 peek 请求
/peek deny <player>                # 拒绝一个收到的 peek 请求
/peek stop                         # 停止当前的 peek 会话
/peek cancel [player]              # 取消你发出的请求或指定玩家的请求
/peek who                          # 显示你正在观察谁或谁正在观察你
/peek invite <player>              # 发送一个 peek 邀请
/peek stats [player (仅管理员)]    # 查看 peek 统计数据
/peek debug                        # 显示调试信息（仅管理员）

设置命令

/peek settings private <on/off>          # 启用/禁用私密模式
/peek settings auto-accept <on/off>      # 启用/禁用自动接受请求
/peek settings blacklist <add/remove/list> [player]  # 管理黑名单
/peek settings whitelist <add/remove/list> [player]  # 管理白名单

管理命令

/peek manage stats                    # 查看全局统计数据
/peek manage top [page]              # 按 peek 次数显示排名前列的玩家
/peek manage list [page] [sort]      # 列出所有玩家的统计数据
/peek manage player <player>         # 显示玩家的详细信息
/peek manage sessions                # 查看所有活跃的 peek 会话
/peek manage force-stop <player>     # 强制停止某位玩家的会话
/peek manage cleanup                 # 执行数据清理
/peek manage reload                  # 重新加载配置
/peek manage about                   # 显示模组信息

🔌 开发者 API

PlaceholdersAPI 集成

本模组提供了多个占位符，可供其他模组或显示系统使用：

%peekmod:peek_count%      - 玩家观察他人的次数
%peekmod:peeked_count%    - 玩家被观察的次数
%peekmod:total_duration%  - 观察所花费的总时间（已格式化）
%peekmod:is_peeking%      - 玩家当前是否正在观察（true/false）
%peekmod:is_private%      - 玩家是否启用了私密模式（true/false）

⚙️ 配置

主配置文件：config/peek/config.yml（YAML 格式）

🔐 权限节点

本模组使用 LuckPerms 的完整权限系统，实现细粒度的访问控制：

📖 完整的权限文档和 LuckPerms 示例：
👉 查看完整权限指南

📝 许可证

MIT License