Skip to content

安装

第一步:下载 LuckPerms 的 jar 文件

你需要做的第一件事就是下载 LuckPerms。你可以在我们的下载页找到为各种平台准备的最新版 LuckPerms。

只需点击下载按钮,将文件保存在适当的位置即可。

  • 若你正在运行的是 Minecraft JE 版的非模组服,我们推荐你使用 Paper 核心。
  • 若你正在运行的是 Minecraft JE 版的模组服,我们推荐你使用 FabricNeoForge 核心。
  • 若你正在运行的是 Minecraft BE 版的服务器,我们推荐你使用 Nukkit 核心。
  • 若你正在运行的是群组服,我们推荐你使用 VelocityWaterfall(BungeeCord)或 Velocity 核心。
  • 若你正在运行的是 Hytale——很抱歉你(至少是现在的)选择不多!不过原版服务器已经足够使用了!

如果你还没有地方托管你的服务器,来看看我们的合作伙伴 BisectHosting 吧,这家提供商会为 LuckPerms 的用户在托管游戏服务器的套餐中提供 25% 的折扣。

第二步:将 LuckPerms 的 jar 文件放入服务器的 pluginsmods 文件夹下

接下来,我们需要将 LuckPerms 安装至服务器。在此之前请先确认你安装了对应的服务器核心,且已至少成功启动过一次(这是为了确保对应的文件夹能正确出现)。

找到控制面板的“文件管理器”,并打开 plugins 文件夹(Bukkit 和 Paper 系服务端等)或 mods 文件夹(Forge、Fabric、Sponge 或 Hytale 服务端等)


在你进入 plugins 或 mods 文件夹后,点击“上传”按钮,等待界面出现后选择你在第一步下载的 LuckPerms jar 文件。最后点击“上传”。


若你先前已经安装了旧版本的 LuckPerms,请先删除旧版本的 jar 文件。

第三步:完全重启你的服务器

返回你的服务器控制台并通过点击“重启”按钮或输入 stop 等方式重新启动服务器。

在服务器开始备份的时候,LuckPerms 会启用并创建默认的配置文件。你可以通过检查控制台来确保 LuckPerms 正常启用。

现在,LuckPerms 已被安装并在你的服务器上启用了!你可以接着阅读本维基的“快速开始”章节来获悉下一步该做的事!

第四步:配置 LuckPerms

若要个性化 LuckPerms 的配置,你需要对其的配置文件进行修改。

返回“文件管理器”,打开 plugins/mods 文件夹或 config 文件夹(对于 Sponge、Fabric 或 Forge 服务端而言)。之后,打开其中的 LuckPerms 文件夹。


在这里你会找到一些文件。其中比较重要的是:

  • config.ymlluckperms.conf - 此为 LuckPerms 的配置文件
  • luckprems-h2-v2.mv.db - 此为 LuckPerms 用于存储权限数据的数据库文件(勿删!) 你可点击 config.ymlluckperms.conf 对其进行浏览或编辑。

第五步(可选):配置 LuckPerms 的 MySQL 数据库或存储数据的 .yml 文件

默认情况下,LuckPerms 会将数据存储在名为“H2”的文件数据库。这可以在保持效率的同时还能让用户无需额外配置即可开始使用本插件。

如果你想要 LuckPerms 的数据存储在可读、可编辑的 .yml 文件中的话,打开 config.ymlluckperms.conf,下拉并找到“存储设置(Storage Settings)”部分并将 storage-method 项设置为 yaml,之后保存并重启服务器。

若你在一台服务器中运行多个服务端(或是计划在未来这么做),你就需要设置一个诸如 MySQL 的远程数据库来存储数据。

大多数服务器托管商都会免费提供这些![1]找到“数据库”菜单,再点击“创建数据库”。若弹出输入窗口,只需选择“MySQL”为数据库类型并输入名称即可。

创建数据库后,弹出的窗口会显示数据库域名、名称、用户名及密码。

获取这些内容后,记住这些内容(或复制你的表格)并返回文件管理器 LuckPerms 的 config.yml/luckperms.conf 下并将其打开。

下拉至“存储设定(Storage Settings)” 并将 storage-method 设置为 mysql,然后再在 data: 下将刚才设置的内容填入此处。


点击保存之后,重启你的服务器。

你可以观察控制台日志来确认 MySQL 数据库是否正确安装。若你在(载入数据提供者... [MYSQL])Loading storage provider... [MYSQL] 之后没有看见报错信息,说明你已经正确搭建了 MySQL 数据库!


记住,群组服下的每一个子服都需要如此配置连接至同一个数据库(但无需重复安装 MySQL)。

常见问题

我应该把 LuckPerms 装在哪?

  • 若你正在运行的是群组服,你需要把 LuckPerms 安装至每个子服。
  • 若你也想要在 Velocity/BungeeCord 群组上使用 LuckPerms,你应该将 LuckPerms-Velocity.jar 或 LuckPerms-Bungee.jar 放入你的群组核心的插件文件夹。
  • 若你选择只在群组服核心上安装 LuckPerms,不会对后端的其他子服造成任何影响。若你想要使用这些功能,你应当也在这些子服上安装 LuckPerms。

我可以只把 LuckPerms 装在 BungeeCord 上吗?

  • 在 Velocity/Bungeecord 上使用的权限系统完全独立于后端子服。
  • 可以只将插件装在群组服上,但这会导致由 Bukkit/Sponge 插件或 Fabric/Forge 模组处理的权限检查不会被 LuckPerms 处理。

要求

LuckPerms 对安装环境有一些要求。不过大多数服务器都可以达到这些条件。

  • Java 11 或更高版本
  • 首次载入 LuckPerms 时需要联网

Java 11

你的服务器使用的 Java 版本必须不小于 11。LuckPerms 不能在更旧版本的 Java 环境中运行。

部分核心或新版本可能要求更高的 Java 版本(如 Java 21),LuckPerms 同样支持。

网络连接

LuckPerms 使用了一系列外部库,其中部分内容会在运行时自动下载

若你的服务器网络不佳或尚未联网,你可以(在有网的地方先)本地安装 LP,然后将 /LuckPerms/libs/ 下的文件复制到服务器中。

兼容性

下面会展示部分已知问题。大部分情况都超出了我们的控制——所以我们无法通过 LuckPerms 本身的代码解决。

部分已在最新版的插件中修复——不过旧版本仍然存在。

其他权限插件

若要 LuckPerms 完全运行且处理所有的权限检查,你的服务器中应该只留下它一个权限插件(除非你需要用插件进行数据迁移)!

低版本 Minecraft

目前 LuckPerms 的发布版与低于 1.8.8 的版本不兼容。

支持 1.7.10 且面向 Bukkit 的 LuckPerms 可以在我们的下载页找到。

贡献者

页面历史


  1. 可惜的是,国内服务商并不会主动提供这些。若你需要相似的教程,请访问Runoob:MySQL安装及搭建教程↩︎