LiveKit - 实时地图与管理员工具

💡LiveKit 是什么？

LiveKit 不仅仅是一个展示玩家动态的实时地图。它让你能从口袋中直接管理服务器：管理世界天气、玩家封禁、白名单、查看背包、传送玩家等等！轻松开始使用 LiveKit，探索我们提供的所有功能。本插件正在积极开发中，新功能会定期推出。

🎮快速开始

服务器端设置

• 下载最新版本的 LiveKit 插件，并将其放入服务器的 plugins 文件夹。
• 重载或重启你的服务器。
• 注意控制台中 LiveKit 的输出信息。它会告诉你连接 App 所需的 IP 和 端口。

应用程序端设置

• 从本页面顶部提到的应用商店下载 LiveKit App。
• 在 App 中点击 + 连接，并输入上一步获取的 IP 和 端口。
• 按照 App 内的指引操作：可以选择匿名连接，或者在游戏内使用 /livekit claim 命令获取验证码，并在 App 中输入以验证你的玩家身份。

> 注意：建议为 LiveKit 端口（默认 4123）设置端口转发。端口转发能让 App 直接连接到你的服务器。如果不设置，连接将通过我们的代理服务中转，这会影响连接速度和稳定性。

如果在开始使用时遇到问题，请加入我们的 Discord 寻求帮助！

🎮设置地图渲染

地图的渲染范围受预设边界限制，你可以控制渲染地图的大小。默认边界为矩形，大小为 1024x1024 方块（即 64x64 区块，2x2 区域）。

设置边界

使用命令 /livekit <世界名> bounds <半径> [-r|-c]。

例如，/livekit main_world bounds 4096 -c 会将渲染地图边界设置为圆形（-c），半径为 4096 方块。

开始完整渲染

使用命令 /livekit <世界名> render full。

这将开始对你用上述命令定义的边界内的世界进行完整渲染。请注意不要将边界设置得过大，完整渲染需要较长时间。

🎮权限

如果你正在使用 Vault 支持的权限插件（例如 LuckPerms），请在 LiveKit 的 config.yml 中将 useVault 选项设置为 true。请确保你的 plugins 文件夹中已安装 Vault。

玩家权限

• livekit.commands.basic - 使用 LiveKit 交互所需的基础玩家命令权限。
• livekit.module.map - 查看实时地图的权限。
• livekit.map.info - 查看特定方块信息的权限。
• livekit.module.players - 在地图上查看玩家的权限（默认只能看到自己）。
• livekit.players.other - 在地图上查看其他玩家的权限。
• livekit.module.weathertime - 查看世界当前天气和时间的权限。
• livekit.module.chat - 在 App 中查看聊天信息的权限。
• livekit.chat.write - 从 App 发送聊天信息的权限（仅限已验证身份的玩家）。
• livekit.chat.write_offline - 在未登录服务器时从 App 发送聊天信息的权限。
• livekit.module.poi - 查看地图上标记点的权限。
• livekit.poi.personalpins - 在地图上设置个人标记的权限。
• livekit.module.messaging - 通过 App 进行私信的权限。

管理员权限

• livekit.commands.admin - 管理员命令权限。
• livekit.module.admin - 管理员操作权限（封禁、白名单、踢出、警告等）。
• livekit.module.console - 通过 App 访问服务器控制台的权限。
• livekit.console.execute - 执行控制台命令的权限。
• livekit.module.tps - 查看服务器性能页面（CPU、内存、TPS）的权限。
• livekit.module.inventory - 查看和编辑玩家背包的权限。

🎮命令列表

• /livekit - 检查 LiveKit 是否安装并正常运行。为用户显示连接 LiveKit 的基本信息（端口、所需密码、是否允许匿名、验证访问），并提供 App 商店链接。
• /livekit claim - 生成一个用于在 App 中验证身份的 PIN 码。
• /livekit headrefresh - 刷新玩家的头颅皮肤。[livekit.commands.basic]
• /livekit pins - 列出玩家个人设置的标记点并显示其 ID（用于删除）。[livekit.poi.personalpins]
• /livekit setpin <名称> - 在玩家当前位置设置一个指定名称的标记点。[livekit.poi.personalpin]
• /livekit removepin <ID> - 移除指定的标记点。[livekit.poi.personalpin]
• /livekit info - 显示当前活跃会话和已连接客户端（App）的数量。[livekit.commands.basic]
• /livekit map - 显示当前实时地图世界和渲染状态的信息。[livekit.commands.admin]
• /livekit map cpu <百分比> - 指定一个区块渲染最多可占用多少时间（百分比）。在进行世界完整渲染时，这可以提高渲染速度，但也会导致服务器卡顿！[livekit.commands.admin]
• /livekit <世界名> - 显示指定世界的实时地图信息。[livekit.commands.admin]
• /livekit <世界名> render full [-m|-f] - 开始对指定世界进行完整渲染。-f 强制重新渲染已渲染的区块，-m 仅渲染缺失的区块。未指定时默认为 -f。[livekit.commands.admin]
• /livekit <世界名> render stop - 停止当前的渲染任务。[livekit.commands.admin]
• /livekit <世界名> bounds - 检查世界的当前边界。[livekit.commands.admin]
• /livekit <世界名> bounds <半径> [-r|-c] - 将指定世界的边界设置为给定半径（以方块为单位）。-c 设置为圆形半径，-r 设置为矩形半径。默认为 -r。[livekit.commands.admin]
• /livekit <世界名> bounds <左> <右> <上> <下> - 将边界设置为给定的边界框：左(-x)、上(-z)、右(+x)、下(+z)。单位是方块！[livekit.commands.admin]
• /livekit headrefresh <玩家名> - 刷新指定玩家的头颅皮肤（5分钟冷却）。[livekit.commands.admin]

🎮数据存储

支持的存储类型有 SQLITE、POSTGRESQL 和 MYSQL。默认使用 SQLITE，无需额外设置。

存储类型迁移

在配置文件中添加以下 migrate 条目。这是你当前要转换的活跃存储配置。

migrate:
  type: SQLITE
  sql:
    host: ‘NULL’
    user: ‘NULL’
    database: ‘NULL’
    password: ‘NULL’

然后将 storage 部分更改为你希望使用的新存储类型配置。

storage:
  type: MYSQL
  sql:
    host: ‘localhost’
    user: ‘root’
    database: ‘LiveKit’
    password: ‘asdf23h12h’

下次重载或启动服务器时，LiveKit 会将数据从 migrate 迁移到 storage。成功迁移后，migrate 条目会被移除。迁移前请务必备份你的数据！存储迁移只会在目标存储为空时进行。

✨支持与社区

加入我们在 Discord 上的 LiveKit 社区，你可以在这里寻求帮助、推荐新功能，或者只是和我们聊天！

✨插件集成

EssentialsX（推荐）

我们添加了对 EssentialsX 的集成，可以在地图上显示世界出生点（按组）、玩家家和服务器地标。通过 /pm 或 /msg 发送的私信会在 App 中显示，来自 App 的私信也会通过 Essentials 的私信系统在游戏内送达。

权限

• livekit.essentials.info - 在玩家信息面板显示 EssentialsX 玩家信息。
• livekit.essentials.homes - 在地图上显示玩家家。
• livekit.essentials.warps - 在地图上显示地标。
• livekit.essentials.spawn - 在地图上显示出生点。
• livekit.essentials.admin - 在玩家信息面板显示管理员信息（上帝模式、监禁、禁言等）。

DiscordSRV

在 App 中显示来自选定 Discord 频道的聊天信息。

配置

plugins:
  DiscordSRV:
    enabled: true
    channelIDs:
    - ‘859524672889552926’

请确保频道 ID ‘859…926’ 被引号括起来。

❓数据隐私

从 LiveKit v1.4.6 开始，LiveKit 插件会与我们的后端通信，传输不同的指标数据以便我们提供更好的服务。LiveKit 也提供通过我们后端转发的代理连接。目前收集和存储的数据包括：

• Minecraft 服务器 IP、Minecraft 端口、LiveKit 端口。
• LiveKit 连接尝试记录。

你可以随时在我们的 Discord 上要求删除与你服务器相关的数据。数据绝不会被共享，仅用于为你创造更好的体验！