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 上要求删除与你服务器相关的数据。数据绝不会被共享，仅用于为你创造更好的体验！
