LuckPerms 各种信息堆

作者: cc7w

日期: 2017-08-04 14:26:00 版块: PluginsCDTribe

本帖最后由 mimimis 于 2017-9-10 13:44 编辑

GitHub 地址 https://github.com/PluginsCDTribe/LuckPerms/wiki
划去的内容是已经搞完的（汉字数/字节数）

~~Home~~(187/892, by 754)
~~LuckPerms~~(1495/3927 ,By Art1900)

~~Why LuckPerms?~~(1495/3927)
$ J8 x/ g. W' u6 z7 K

Setup(3878/11877 ,By c7w || 9224/73272 ,By 754 || 575/7025,By Art1900)

~~Installation~~(553/1663,c7w)
~~Choosing a Storage type~~(680/2907,c7w)
~~Usage~~(2645/7307,c7w)
~~Configuration~~(3231/29901, by 754)
~~Command Usage~~(4582/30931,by 754)
~~Migration from other plugins~~(798/6920, by 754)
~~Command Equivalents~~(575/7025, by art)
~~FAQ~~(613/5520, by 754)
! ?1 S% ^" r, D$ [

~~Features~~(3824/12661,By c7w || 1899/11277,By 754 || 1513/5367,By Art)

~~Verbose~~(629/1963,c7w)
~~Bulk Editing~~(785/3261, by 754)
~~Instant Updates~~(808/2452,c7w)
~~Switching Storage Types & Backups~~(241/1658, by 754)
~~Tracks~~(258/942,c7w)
~~Prefixes, Suffixes & Meta~~(1537/4979,c7w)
~~Prefix & Suffix Stacking~~(592/2325,c7w)
~~Advanced Setup~~(1513/5367,Art)
~~Default Groups~~(873/6358, by 754)( p3 Y s I R& p* C

~~Developers~~(1198/19751, by 754)

~~Developer API~~
: a% v8 t# \, \( k) u

~~Other~~(By c7w,1025/4067)

~~Locale and Translations~~(196/939)
~~PlaceholderAPI~~(829/3128)
1 X1 m' [. `6 s. h

Summary
754 —— 12508/105192
c7w —— 8727/28605
Art —— 3583/16319

回复:

海螺螺

本帖最后由 754503921 于 2017-8-6 13:02 编辑

Developers

Developer API
7 j. W% ], l3 X2 [

Features

Verbose
Bulk Editing
Instant Updates
Switching Storage Types & Backups
Tracks
Prefixes, Suffixes & Meta
Prefix & Suffix Stacking
Advanced Setup
Default Groups/ c% @5 G' Q/ d5 ]; G* A, r" C0 e

Developer API

## 简介
## Intro
LuckPerms API 允许你更改大量的插件内部编程，并且能够轻松地将 LuckPerms 深度集成到你的插件和系统里。
LuckPerms API allows you to change a huge amount of the plugins internals programmatically, and easily integrate LuckPerms deeply into your existing plugins and systems.

大多数的其他的权限要么没有 API，要么有很差的 API，或者是有很差的文档的 API，而且里面的方法和类可能随机在不同版本里消失或是移动。Vault 项目就是一个很好的接口，并且是将大量插件一次性集成的很好的方法，可惜他的功能实在是太少了。
Most other permissions plugins either don't have APIs, have bad APIs, or have APIs with poor documentation and methods and classes that disappear or move randomly between versions. The Vault project is a great interface and a great way to integrate with lots of plugins at once, but its functionality is very limited.

LuckPerms 遵循 Semantic 版本控制，也就是意味着一个不向后兼容的新的 API 出现时，主版本会增加这个 API，你可以放心你的集成不会因为版本的不同而崩溃，主要的版本是保持不变的。
LuckPerms follows Semantic Versioning, meaning whenever a non-backwards compatible API change is made, the major version will increment. You can rest assured knowing your integration will not break between versions, providing the major version remains the same.

## 如何在项目里使用 API
## How to use the API in your project
LuckPerms 的 API 包是 https://github.com/lucko/LuckPer ... /me/lucko/luckperms
The API package in LuckPerms is [`me.lucko.luckperms.api`](https://github.com/lucko/LuckPer ... /me/lucko/luckperms).

我的 Nexus 服务器可以在这里找到 https://nexus.lucko.me/](https://nexus.lucko.me/，你在你的构建脚本里需要的仓库在 https://repo.lucko.me/](https://repo.lucko.me/
My Nexus Server can be found at [https://nexus.lucko.me/](https://nexus.lucko.me/). The repository you need for your build scripts is [https://repo.lucko.me/](https://repo.lucko.me/).

#### 其他有用的链接
#### Other useful links
* [JavaDocs](https://luckperms.lucko.me/javadocs/)
* [CI Server](https://ci.lucko.me/job/LuckPerms/)

### Maven
````xml
<repositories>
<repository>
      <id>luck-repo</id>
      <url>https://repo.lucko.me/</url>
</repository>
</repositories>

<dependencies>
<dependency>
      <groupId>me.lucko.luckperms</groupId>
      <artifactId>luckperms-api</artifactId>
      <version>3.2</version>
      <scope>provided</scope>
</dependency>
</dependencies>
````

### Gradle
```gradle
repositories {
maven {
      name "luck-repo"
      url "https://repo.lucko.me/"
}
}

dependencies {
compile ("me.lucko.luckperms:luckperms-api:3.2")
}
```

## 使用指南
## Usage Instructions
使用 API，你需要获得 LuckPermsApi 接口的实例，这可以通过几个方法完成。
To use the API, you need to obtain an instance of the `LuckPermsApi` interface. This can be done in a number of ways.

```java
// 所有平台 (抛出 IllegalStateException 如果 API 没有被加载)
final LuckPermsApi api = LuckPerms.getApi();

// 或者可选的
Optional<LuckPermsApi> provider = LuckPerms.getApiSafe();
if (provider.isPresent()) {
final LuckPermsApi api = provider.get();
}

// Bukkit/Spigot
ServicesManager manager = Bukkit.getServicesManager();
if (manager.isProvidedFor(LuckPermsApi.class)) {
final LuckPermsApi api = manager.getRegistration(LuckPermsApi.class).getProvider();
}

// Sponge
Optional<LuckPermsApi> provider = Sponge.getServiceManager().provide(LuckPermsApi.class);
if (provider.isPresent()) {
final LuckPermsApi api = provider.get();
}
```

### 线程安全的警告
### A warning about thread safety
所有 LuckPerms 内部，包括 API 都是线程安全的，你可以在异步线程任意调用 API 而不用担心发生错误。
All LuckPerms internals are thread-safe, including the API. You can call API methods from async threads without incurring issues.

但是，请注意一些操作，（尤其是存储类）是阻塞的。[CompletableFuture](https://docs.oracle.com/javase/8 ... pletableFuture.html) 就是用于这种情况：防止由于较差的处理导致的增加的错误，当出现 IO 时主线程等待处理完成。注意在添加 Callback 时指定正确的处理器。
However, please be aware that some operations, (especially in the Storage class) are blocking. [CompletableFuture](https://docs.oracle.com/javase/8 ... pletableFuture.html)s are used in these situations to prevent accidental issues whereby through poor handling, the main server thread waits for I/O to execute. Care should be taken to specify the correct executor when adding callbacks to these futures.

### 我想将 LuckPerms 作为依赖项
### I want to depend on LuckPerms
在 Bukkit/Bungee，你需要在你的 plugin.yml 添加以下信息
On Bukkit/Bungee, you need to add the following to your plugins `plugin.yml`.
```yml
depend: [LuckPerms]
```

在 Sponge, 在你的插件声明添加这些。
```java
@Plugin(
      id = "myplugin",
      dependencies = {
            @Dependency(id = "luckperms")
      }
)
public class MyPlugin {
...
}
```

### 事件
### Events
LuckPerms 有一个完整的读写API，也有一个事件监听系统。由于插件的多平台的原因，我们使用了内部的事件系统，而不是每个平台已经使用的事件系统（举个例子，Bukkit Event API）。这意味着简单的注册你的平台的监听器将不会生效。
LuckPerms exposes a full read/write API, as well as an event listening system. Due to the multi-platform nature of the project, an internal Event system is used, as opposed to the systems already in place on each platform. (the Bukkit Event API, for example). This means that simply registering your listener with the platform will not work.

所有的事件都是异步触发的。这意味着不应该在监听器里交互或者调用任何不是线程安全的方法。
All events are **fired asynchronously**. This means you should not interact with or call any non-thread safe method from within listeners.

值得注意的是，大多数的 Bukkit/Sponge 都不是线程安全的，并且只应该使用主服务器线程来交互。你应该使用调度器来访问 LuckPerms 的监听器。
It is important to note that most of Bukkit/Sponge are **not** thread safe, and should only be interacted with using the main server thread. You should use the scheduler if you need to access these methods fron LuckPerms listeners.

### 我怎样才能监听一个事件
### How do I listen to an event
所有的事件接口都可以在 [me.lucko.luckperms.api.event](https://github.com/lucko/LuckPer ... luckperms/api/event) 包里找到，它们都继承了 [LuckPermsEvent](https://github.com/lucko/LuckPer ... LuckPermsEvent.java) 类。
All event interfaces can be found in the [me.lucko.luckperms.api.event](https://github.com/lucko/LuckPer ... luckperms/api/event) package. They all extend [`LuckPermsEvent`](https://github.com/lucko/LuckPer ... LuckPermsEvent.java).

监听事件应该获得 [EventBus](https://github.com/lucko/LuckPer ... event/EventBus.java) 实例，使用 [LuckPermsApi#getEventBus](https://github.com/lucko/LuckPer ... ckPermsApi.java#L68)即可。
To listen to events, you need to obtain the [`EventBus`](https://github.com/lucko/LuckPer ... event/EventBus.java) instance, using [`LuckPermsApi#getEventBus`](https://github.com/lucko/LuckPer ... ckPermsApi.java#L68).

为你的监听器创建另一个类常常是个好想法，这是一个你可以用来参考的类。
It's usually a good idea to create a separate class for your listeners. Here's a short example class you can reference.

```java
package me.lucko.test;

import me.lucko.luckperms.api.event.EventBus;
import me.lucko.luckperms.api.event.log.LogPublishEvent;
import me.lucko.luckperms.api.event.user.UserLoadEvent;
import me.lucko.luckperms.api.event.user.track.UserPromoteEvent;

public class TestListener {
private final MyPlugin plugin;

public TestListener(MyPlugin plugin, LuckPermsApi api) {
      this.plugin = plugin;

      EventBus eventBus = api.getEventBus();

      // use a lambda
      eventBus.subscribe(LogPublishEvent.class, e -> e.getCancellationState().set(true));
      eventBus.subscribe(UserLoadEvent.class, e -> {
         System.out.println("User " + e.getUser().getName() + " was loaded!");
         if (e.getUser().hasPermission("some.perm", true)) {
            // Do something
         }
      });

      // use a method reference
      eventBus.subscribe(UserPromoteEvent.class, this::onUserPromote);
}

private void onUserPromote(UserPromoteEvent event) {
      Bukkit.getScheduler().runTask(plugin, () -> {
         Bukkit.broadcastMessage(event.getUser().getName() + " was promoted to" + event.getGroupTo().get() + "!");

         Player player = Bukkit.getPlayer(event.getUser().getUuid());
         if (player != null) {
            player.sendMessage("Congrats!");
         }
      });
}

}
```

[EventBus#subscribe](https://github.com/lucko/LuckPer ... t/EventBus.java#L43) 返回一个 [EventHander](https://github.com/lucko/LuckPer ... t/EventHandler.java) 实例，可以用来在插件停止的时候取消注册监听器。
[`EventBus#subscribe`](https://github.com/lucko/LuckPer ... t/EventBus.java#L43) returns an [`EventHander`](https://github.com/lucko/LuckPer ... t/EventHandler.java) instance, which can be used to unregister the listener when your plugin disables.

## 示例用法
## Example Usage
下面就是一些简短的实例，使用了一些基本的 API 功能。
Below are some short examples which illustrate some basic API functions.

### 获得玩家的组
### Finding a players group
如果你只是想找到一个玩家的组，我非常建议你使用以下的方法（你甚至不需要使用 API）。
If you just want to find out which group a player is in, I **highly** recommend the following method. (you don't even need to use the API!)

```java
public static String getPlayerGroup(Player player, List<String> possibleGroups) {
for (String group : possibleGroups) {
      if (player.hasPermission("group." + group)) {
         return group;
      }
}
return null;
}
```
记住将你的组排列为优先级的顺序（比如组长在前，成员在后）。
Remember to order your group list in order of priority. e.g. Owner first, member last.

### 为一个玩家添加权限
### Adding a permission to a user
```java
LuckPermsApi api = null; // See above for how to get the API instance.

Optional<User> user = api.getUserSafe(uuid);
if (!user.isPresent()) {
return false; // The user isn't loaded in memory.
}

// Build the permission node we want to set
Node node = api.getNodeFactory().newBuilder(permission).setValue(true).build();

// Set the permission, and return true if the user didn't already have it set.
try {
user.get().setPermission(node);

// Now we need to save the user back to the storage
api.getStorage().saveUser(u);

return true;
} catch (ObjectAlreadyHasException e) {
return false;
}
```

### 为（可能的）离线玩家添加权限
### Adding a permission to a (potentially) offline user
CompletionStage API 可以用来轻松交互插件的存储，查看[这里](https://docs.oracle.com/javase/8 ... ompletionStage.html) 和 [这里](https://docs.oracle.com/javase/8 ... pletableFuture.html) 来查看这两个类的详细信息。
The CompletionStage API can be used to easily interact with the plugins Storage backing. See [here](https://docs.oracle.com/javase/8 ... ompletionStage.html) and [here](https://docs.oracle.com/javase/8 ... pletableFuture.html) for more details about these classes.

```java
LuckPermsApi api = null; // See above for how to get the API instance.

// load the user in from storage. we can specify "null" for their username,
// since it's unknown to us.
api.getStorage().loadUser(uuid, "null").thenComposeAsync(success -> {
// loading the user failed, return straight away
if (!success) {
      return CompletableFuture.completedFuture(false);
}

// get the user instance, they're now loaded in memory.
User user = api.getUser(uuid);

// Build the permission node we want to set
Node node = api.getNodeFactory().newBuilder(permission).setValue(true).build();

// Set the permission, and return true if the user didn't already have it set.
try {
      user.setPermission(node);

      // now we've set the permission, but still need to save the user data
      // back to the storage.

      // first save the user
      return api.getStorage().saveUser(user)
            .thenCompose(b -> {
                  // then cleanup their user instance so we don't create
                  // a memory leak.
                  api.cleanupUser(user);
                  return CompletableFuture.completedFuture(b);
            });

} catch (ObjectAlreadyHasException e) {
      return CompletableFuture.completedFuture(false);
}

}, api.getStorage().getAsyncExecutor());
```

### 获得玩家的前缀
### Getting a players
LuckPerms 有一个（复杂的）缓存系统，用于非常快速的权限/信息查询。这些类都在 API 里，并且可以在可能的地方使用。
LuckPerms has a (somewhat complex) caching system which is used for super fast permission / meta lookups. These classes are exposed in the API, and should be used where possible.

```java
LuckPermsApi api = null; // See above for how to get the API instance.

// Get the user, or null if they're not loaded.
User user = api.getUserSafe(uuid).orElse(null);
if (user == null) {
return Optional.empty(); // The user isn't loaded. :(
}

// Now get the users "Contexts". This is basically just data about the players current state.
// Don't worry about it too much, just know we need it to get their cached data.
Contexts contexts = api.getContextForUser(user).orElse(null);
if (contexts == null) {
return Optional.empty();
}

// Ah, now we're making progress. We can use the Contexts to get the users "MetaData". This is their cached meta data.
MetaData metaData = user.getCachedData().getMetaData(contexts);

// MetaData#getPrefix returns null if they have no prefix.
return metaData.getPrefix();
```

### 获得玩家请求的权限
### Getting a players applied permissions
我们也可以使用这个缓存系统来获得一个包含用户权限的 Map 实例，包含了基础的权限查询。
We can also use this caching system to get a Map containing the users permissions. This map contains the data which backs their permission lookups.
```java
// All retrieved in the same way as shown above.
User user;
Contexts contexts;

PermissionData permissionData = user.getCachedData().getPermissionData(contexts);
Map<String, Boolean> data = permissionData.getImmutableBacking();
```

### 寻找权限
### Searching for a permission
你可以使用 Java 8 的流轻松过滤并返回一个用户请求的权限
You can use Java 8 streams to easily filter and return permissions applied to a user.
```java
public boolean hasPermissionStartingWith(UUID uuid, String startingWith) {
// Get the user, if they're online.
Optional<User> user = api.getUserSafe(uuid);

// If they're online, perform the check, otherwise, return false.
return user.map(u -> u.getPermissions().stream()
         .filter(Node::getValue)
         .filter(Node::isPermanent)
         .filter(n -> !n.isServerSpecific())
         .filter(n -> !n.isWorldSpecific())
         .anyMatch(n -> n.getPermission().startsWith(startingWith))
).orElse(false);
}
```

### 创建新的组并分配权限
### Creating a new group and assigning a permission
这个方法不是阻塞的，所以可以安全的在主线程调用，一旦操作完成，回调会异步运行。
This method is not blocking, so can be safely called on the main server thread. The callback will be ran async too, once the operation has finished.
```java
api.getStorage().createAndLoadGroup("my-new-group").thenAcceptAsync(success -> {
if (!success) {
      return;
}

Group group = api.getGroup("my-new-group");
if (group == null) {
      return;
}

Node permission = api.buildNode("test.permission").build();

try {
      group.setPermission(permission);
} catch (ObjectAlreadyHasException ignored) {}

// Now save the group back to storage
api.getStorage().saveGroup(group);
}, api.getStorage().getAsyncExecutor());
```

## 版本控制
## Versioning
在 2.0 版本里，LuckPerms 遵循了 Semantic 版本控制。
As of version 2.0, LuckPerms roughly follows the standards set out in Semantic Versioning.

唯一不同的是 patch 号不包含在任何地方，除了 pom，并且每次构建都会计算，基于上次提交后的提交数量。（每个新的小版本都会创建新的标签）
The only difference is that the patch number is not included anywhere within the pom, and is calculated each build, based upon how may commits have been made since the last tag. (A new tag is made every minor version)

这意味着 API 版本不再有 patch 号（在 patch 里没有 API 的变化），API 版本会是 x.y，每个不同的 LuckPerms 构建都会遵循 x.y.z。
This means that API versions do not have a patch number (as no API changes are made in patches). API versions will be x.y, and each individual build of LuckPerms will follow x.y.z.

### 变更日志
### Changelog
* 版本 2.x 保持了几个月的稳定，没有任何向后不兼容的变更，但是在之后的版本里很多的方法变为弃用状态，并且事件 API 的确应该重写一遍。
* Version 2.x remained stable for a number of months, without any backwards incompatible changes. However, a number of methods became deprecated in the later versions, and the event API really needed a rewrite.
* 版本 3.x 包含了以下的向后不兼容的变化。
* Version 3.x introduced the following backwards incompatible changes.
https://gist.github.com/lucko/fdf6ae4b2d9e466d8103dd9c68e5db9e

FAQ

# 常见问题
# Frequently Asked Questions
这些是我经常被问到的问题，我很高兴你在直接问我之前看了这些问题。
These are some of the questions I get asked quite frequently. I'd appreciate it if you check to see if your question has already been answered here before asking me directly.

### 我在用 EssentialsChat 然后它不工作了
### I'm using EssentialsChat and it's not working
请确保你在使用最新版的 [EssentialsX](https://ci.drtshock.net/job/essentialsx/) 并且你安装了 [Vault](https://dev.bukkit.org/bukkit-plugins/vault/)。EssentialsX 的 X 是很重要的，老的版本不会工作。
Please make sure you are using the latest version of [EssentialsX](https://ci.drtshock.net/job/essentialsx/) and you have [Vault](https://dev.bukkit.org/bukkit-plugins/vault/) installed on your server. The "**X**" part of Essentials**X** is important - the older versions of Essentials do not work.

### 我在哪里安装 LuckPerms 呢？
### Where do I install LuckPerms?
如果你在运行很多的服务器，你应该将 LuckPerms 放入每个服务器的 plugins 文件夹。
If you run a network of servers, you should install LuckPerms into the plugin folder of every server you want to use LuckPerms on.
如果你想使用 BungeeCord 来应用权限，你需要将 LuckPermsBungee.jar 放入 BungeeCord 插件文件夹。
If you also want to use LuckPerms to apply permissions on your BungeeCord proxy, you should place LuckPermsBungee.jar into your BungeeCord plugins folder.
如果你选择只在 BungeeCord 安装 LuckPerms，他将不会影响任何 Spigot/Sponge 服务器的权限检查，如果你想要使用 LuckPerms，你必须将 LuckPerms 安装在这些服务器。
If you choose to only install LuckPerms on your BungeeCord proxy, it will have no impact on any permission checks performed by plugins on any backend Spigot/Sponge servers. If you want that functionality, you need to install LuckPerms on those servers too.

### 我可以只在 BungeeCord 安装 LuckPerms 吗？
### Can I just install LuckPerms on BungeeCord?
在 BungeeCord 上的权限系统是完全独立于 Spigot/Sponge 服务器的。
The permissions system used on BungeeCord is completely separate from the systems used on the backend Spigot/Sponge server.
如果你想让 Spigot/Sponge 的权限检查被 LuckPerms 处理的话，在每个 Spigot/Sponge 服务器都安装 LuckPerms。
If you want the permission checks performed by Spigot/Sponge plugins to be handled by LuckPerms, install LuckPerms on your Spigot/Sponge server.
如果你想让 BungeeCord 服务器的权限检查被 LuckPerms 处理，在 BungeeCord 服务器安装 LuckPerms。
If you want the permission checks performed by BungeeCord plugins to be handled by LuckPerms, install LuckPerms on your proxy.
你可以只在 BungeeCord 安装 LuckPerms，但是 Spigot/Sponge 服务器的权限检查将不会被 LuckPerms 处理。
You **can** just install it on the proxy, but any checks which are performed by Spigot/Sponge plugins will not be handled by LuckPerms.

### 我应该怎样在多个服务器中同步权限呢？
### How do I get permissions to sync across multiple servers
将每个 LuckPerms 连接到同一个 MySQL/MongoDB 服务器，你可以使用 /luckperms sync 来从数据库获得最后的权限更新。你也可以 [建立一个通讯服务](https://github.com/lucko/LuckPer ... #messaging-services) 来立刻在你的服务器之间同步更改。
Connect each LuckPerms installation to the same MySQL/MongoDB server. You can use `/luckperms sync` to pull the latest changes from the database. You can also [setup a Messaging Service](https://github.com/lucko/LuckPer ... #messaging-services) to have your changes sync instantly between servers.

### LuckPerms 不能连接到我的 Redis 服务器
### LuckPerms cannot connect to my Redis server
检查以下是否正常：
Check that the following is correct:

* 你正阿紫使用正确的地址和端口
* You are using the correct address and port
* 你的密码是正确的
* Your password is correct
* 没有防火墙规则阻拦了连接
* There are no firewall rules blocking the connection
* Redis 服务器正在运行
* The Redis server is actually running

### LuckPerms 不能连接到我的 MySQL 服务器
### LuckPerms cannot connect to my MySQL server
检查以下是否正常：
Check that the following is correct:

* 你正在使用正确的地址和端口
* You are using the correct address and port
* 你使用了正确的用户名 / 密码
* You are using the correct username / password
* 数据库存在并且用户可以访问
* That the database exists and is accessible by the user
* 该服务器在线并且接受连接
* That the server is online & accepting connections
* 没有防火墙规则阻拦了连接
* There are no firewall rules blocking the connection
* MySQL 正确绑定了端口，并且安装 LuckPerms 的服务器可以访问
* MySQL is bound to the correct port, and is accessible from the server where LuckPerms is installed
* 检查 MySQL 的连接限制没有超过，默认 LuckPerms 会使用 10 个连接，如果你有过多的插件连接了同一个服务器，你需要增加这个限制。
* Check that your MySQL max connections limit is not being exceeded. By default, LuckPerms will use 10 connections per server. If you have lots of plugins connecting to the same server, you will need to increase this limit.

如果你得到了 `Communications link failure` 的错误，或者由于超时导致的错误，那么上面的有一条是不正常的。
If you are getting `Communications link failure` errors, or errors relating to a timeout, then something from the list above is incorrect.

给玩家 LuckPerms 表的权限，使用
To give the user access to the LuckPerms tables, execute:
```sql
GRANT ALL PRIVILEGES ON [databasename].* TO '[username]'@'[ipaddress]';
```
记得替换 [ ] 里的东西。

比如：
```sql
GRANT ALL PRIVILEGES ON luckperms.* TO 'luck'@'%';
```

接着当你完成这个更改后，使用
```sql
FLUSH PRIVILEGES;
```

Migration from other plugins

LuckPerms 有内置的支持其他的权限插件轻松迁移到 LuckPerms 的功能。
LuckPerms has built in support to allow easy migration of permissions data from existing permissions plugins to LuckPerms.

## 开始之前
## Before we get started
需要注意的是这个系统还不是那么的完美，在绝大多数情况下，它在转变数据时相当不错，但是不是所有的数据都是相同的，并且有时我可能没有考虑这么多。
It should be noted that this system is not perfect. It will do a pretty decent job at converting all of your existing data, and works perfectly in *most cases*. However, not all data is the same, and there are sometimes things I haven't accounted for.

LuckPerms 有和其他权限插件相同的地方，但是有些部分从根本上不同，有些迁移运用了一些技巧。
LuckPerms has some similarities with other permission plugins, however, some parts are fundamentally different, and therefore sometimes automatic migration is tricky.

另外，让插件迁移你的所有的数据意味着你没有机会学习任何一个 LuckPerms 命令，这可能会是一个麻烦的地方，如果你是从 PermissionsEx 或者 GroupManager 迁移来的数据，你应该看看 [GM PEX 的等同命令](https://github.com/lucko/LuckPer ... Command-Equivalents)
Additionally, letting the plugin migrate all of your data for you means you will not have a chance to learn any of the LuckPerms commands. This may become an issue later on. If you're migrating from PermissionsEx or GroupManager, you might [find this page useful](https://github.com/lucko/LuckPer ... Command-Equivalents).

如果你使用了老版本的权限插件，或者你根本不喜欢的，现在可能是一个机会来重新构建清理，顺便学习 LuckPerms 的命令！
If you have an old permissions setup, or a setup you're not completely happy with, now might be a great time to have a restructure and cleanup, and a chance to learn LuckPerms commands in the process!

不？！就喜欢你现在的权限插件？让我们来迁移。
Nope?! Happy with what you have? Let's migrate.

## 目前支持的插件
## Currently supported plugins
| Bukkit / Spigot    | BungeeCord          | Sponge             |
|-----------------------|-----------------------|-----------------------|
| GroupManager       | BungeePerms          | PermissionsEx       |
| PermissionsEx       |                      | PermissionManager    |
| zPermissions       |                      |                      |
| PowerfulPerms       |                      |                      |
| bPermissions       |                      |                      |

# 如何
# How to
迁移的处理很简单，但是每个平台可能有不同。
The migration process is fairly simple, however it varies slightly for each platform.

1. 将 LuckPerms jar 文件放入你的服务器文件夹。
1. Place the LuckPerms jar file in your servers plugin folder. ([How to?](https://github.com/lucko/LuckPerms/wiki/Setup))
2. 保证两个权限插件的文件夹在同一个文件夹里（现在还不要卸载）
2. Ensure that the jar of the plugin you are migrating from is **also** in the plugins folder. (don't uninstall it just yet!)
3. 开启服务器，你可以在活跃的服务器来进行这个操作，但是我建议在没有人的服务器上进行。
3. Start your server up. You can technically carry out the process on a live production server, however I advise that if possible, you do it on a server with no players.

**运行一下命令: `lp migration <插件名>`**
**Run the following command: `/lp migration <plugin name>`**

有些插件需要你填写额外的选项/标签，如果需要，你会在迁移之前被通知。
Some plugins also require you to specify extra options/flags. If any are needed, you will be notified in chat before the migration begins.

接着只需要让 LuckPerms 处理剩下的事了！你将会被提示迁移进度，完成时也会被提示。
Then, just let LuckPerms handle the rest! You will be notified of the migration progress, and then notified again once it has finished.

当处理完成，停止服务器，移除其他权限插件的 jar，再次开启你的服务器。
When the process has finished, stop the server, remove the other jar file, and start your server again.

控制台的输出一定是冗长繁杂的，以 "(LP) LOG" 开头的命令都可以忽略，但是栈堆信息不应该忽略（一般表示出现了什么问题）。如果你的迁移输出含有栈堆信息，请反馈给我，更多的信息在这一个页面的底部。
The console output during the migration process is purposely verbose and spammy. Messages starting with "(LP) LOG" can be ignored, however stack traces shouldn't be (they usually mention some sort of exception). If your migration output contains stack traces, please report them to me. More info at the bottom of this page.

## PowerfulPerms
处理 PowerfulPerms 的过程更加复杂。
The process for PowerfulPerms is more complicated.

玩家的信息只有在加入服务器时才被加载，插件 API 没有方法一次性获得所有的玩家的数据。
Users are only loaded into the plugin when they join the server, and the plugins API does not expose a way to get all players from its backend.

这意味着我们在导入数据时，我们必须得查询 PowerfulPerms MySQL 表来获得所有玩家的信息。
This means that during the import process, we have to query the PowerfulPerms MySQL tables to get a list of all users.

命令使用将会不同。
The command usage is therefore different.

`/luckperms migration powerfulperms [address] [database] [username] [password] [db table]`

解释：
Where:
* address = MySQL 服务器的 IP 地址，比如 127.0.0.1:3306
* address = the address and port of your MySQL server e.g. 127.0.0.1:3306
* database = PowerfulPerms 插件使用的数据库的名称
* database = the name of the database where your PowerfulPerms data is stored
* username = SQL 服务器登入需要的用户名
* username = the username to login to the SQL server
* password = SQL 服务器登入需要的密码
* password = the password to login to the SQL server
* db table = 存储玩家数据的表名（尽管我们只关注 UUID 列表）
* db table = the name of the table where player data is stored (although we're only concerned about a list of uuids).

默认的表名，据我所知，是 "players"，但是如果你添加了表名的前缀，你需要添加他们。
The default db table, as far as I know, is "players", however if you have an added table prefix, you will need to include that too.

比如如果我的表的前缀是 "pp_"，那么 db table = "pp_players"（不需要引号）
e.g. if my table prefix is "pp_", the db table should = "pp_players". (without the quotes)

比如: `/luckperms migration powerfulperms 127.0.0.1:3306 minecraft root passw0rd players`
For example: `/luckperms migration powerfulperms 127.0.0.1:3306 minecraft root passw0rd players`

# 错误
# Errors
如果这个命令不存在，请检查这个插件是否正确加载。
If it seems that the command does not exist, check your server's startup log to check if the plugin you are importing from loaded correctly.

如果处理没有完成，并且打印了错误消息，请在 GitHub 提交 issue 或者 [在这里联系我](https://github.com/lucko/LuckPerms/wiki#cant-find-something)，我将尽力尽可能快的回复你。
If the process doesn't complete and prints an error message, please submit an Issue on GitHub or [contact me here](https://github.com/lucko/LuckPerms/wiki#cant-find-something). I'll try to reply to you ASAP.

Switching Storage Types & Backups

## 如何
## How to
切换存储是很简单的。
Switching datastores is easy.

1. 第一，运行 `/luckperms export <file>`
1. Firstly, run `/luckperms export <file>`
2. 接着，完全停止你的服务器
2. Then, stop your server completely.
3. 编辑你的配置文件，更改存储类型
3. Edit your config file and change the storage type.
4. 开启你的服务器，等待数据存储的初始化
4. Now, start your server again. Let the new datastore initialise.
5. 接着，使用 `/luckperms import <file>`
5. Then, run `/luckperms import <file>`
6. 所有的数据已经迁移到新的数据存储中了
6. All of your data should have been moved to the new datastore.

<file> 是你想用来存储/加载的文件的名称，文件位于 LuckPerms 的数据文件夹里。你可以任意命名，只要在 import 命令中正确填写。
\<file\> is the name of the file which you want to save to/load from. The file is located in the LuckPerms data folder. You can name it whatever you like in the import command.

## 备份
## Backups
你可以使用这个特性来备份所有你的 LuckPerms 的数据，只需要运行 export 命令，将文件保存到一个安全的地方。
You can also use this feature to backup all of your LuckPerms data. Just run the export command, and save the file output in a safe place.

## 这是怎么工作的？
## How does it work?
export 命令将所有的数据转换为一串命令，处理后将会重建你的安装，import 命令只是将每个命令运行一遍，这意味着你可以只导出/导入一小部分数据，你删掉不需要的一部分就可以了。
The export command converts all of your data into a list of commands, than when executed, will recreate your existing setup. The import command just runs each command sequentially. This means that you can export/import small parts of your data, by deleting the parts you don't need.

Default Group

我在 LuckPerms 里处理默认和默认组的方法可能是整个插件里最不受喜爱的特性了。最新我做了一些添加/调整，做了一些替代的特性，允许最大程度的控制像其他权限插件的方法，希望这会成为插件最好的方面，而不是最差的方面。
The way I handle defaults and default groups in LuckPerms is probably the most disliked feature in the whole plugin. Recently I've been adding some additional / alternative features to the plugin to allow a greater degree of control compared with what's seen in any of the other permission plugins out there, and hopefully making my approach people's favourite part of the plugin, not their least favourite.

# 从何开始
# Where to start
这是我的想法。
So, here's my thinking.

你的服务器的用户可以分为两种。
Users on your server are likely to be split into two types.

1. 基础玩家
1. The standard player.
2. 加入不同的组的玩家，或者有他们特别权限的玩家。
2. Players who have been added to a different group, or given their own special permissions.

你不希望浪费宝贵的硬盘空间来存储第一种玩家，你只希望存储你的职员，或者有特殊等级的玩家。平凡的"成员"就只是平凡，没有必要存储他们的信息。
You don't want to waste precious disk space storing data about Player Type #1. You only want to store data about your staff members, and people with special ranks. Regular "members" are just that, regular. There's no need to store any data about them.

下一个问题是如何确定一个用户是"平凡的"或不是，想象一下情景。
The next issue I face is how to decide if a user is "regular" or not. Imagine the following situation.

1. 默认的组设置为"默认"，当玩家加入，他们被设置为"默认"，并被保存。
1. The default group is set to "default". When players join, they're given "default", and then get saved.
2. 过了一会儿，你想将默认的组更改为"成员"。
2. A little while down the line, you decide you want to change the default group to "member".
3. 接着你的老的成员全部在"默认"组里，剩下的人都在"成员"，这不好。
3. You then have all of your old players in the "default" group, and everyone else in "member". Not good.

甚至我们没有"平凡"的用户，这个问题依然会出现。
Even if we don't save "regular" users, this issue can still happen.

1. 默认组设置为"默认"
1. The default group is set to "default".
2. 你想给 "Notch" 一个特殊的 "essentials.fly" 权限，Notch 的权限被保存，标记为"默认组"的成员，有特殊的飞行权限。
2. You want to give "Notch" a special "essentials.fly" permission. Notch's permissions are saved, indicating he's a member of the "default" group, and has the special fly permission.
3. 接着你编辑了默认的组，所有的"平凡的"成员全部进入了新的组，但是 Notch 还是默认组的。
3. You then edit the default group. All of your "regular" members get the new default group, but Notch still has default!

因为这个原因，我让默认的组不可配置，这让所有对我的事情都简单了 10 倍，这意味着我可以写有效率的存储系统，并且不用担心一些稀有的情况下服务器的管理员更改了默认组，但是，我知道这对一些人很反感。
For this reason, I made it so that the default group is **not** configurable. It makes things 10x easier for me. It means I can write efficient storage systems, with no chance of nasty race conditions occurring when a server admin decides to change the default group. However, I understand this is annoying for some people.

这对一些等级插件也有问题，如果你想要一个"主"组，并且分离"升级"组，你需要多于一个的默认组。
There's also issues with rankup plugins. If you want a "main" group, and then separate "level" ranks, you need to be able to grant more than one group by default.

这里是你的选项。
Here are your options.

## 继续使用默认组，但是只是更改"显示名"
## Keep using the default group, but just modify the "display name"
我非常推荐这个做法，因为你继续使用默认组。
I strongly recommend for the reasons above that you keep using the default group.

如果你只是想简单的更改默认组的显示名，（比如在 Vault），我推荐你配置一个 `group-name-rewrite` 规则，通过添加这些到你的 `config.yml`/`luckperms.conf` 来实现。
If you want to simply change the visible name of the default group, (in Vault for example), I suggest you configure a `group-name-rewrite` rule, by adding the following to your `config.yml`/`luckperms.conf` file.

```yml
# Rewrites group names. The underlying name of the group does not change, just the output in commands / placeholders / Vault.
group-name-rewrite:
  default: Member
```

你也可以使用这个：https://github.com/lucko/LuckPerms/wiki/Primary-Groups
You can also use this approach: https://github.com/lucko/LuckPerms/wiki/Primary-Groups

## 配置继承
## Configure inheritance
这个选项意味着所有的用户都还在"默认"的组里，但是这个默认组作为父组，这样他就可以将配置继承给不同的组。
This option would mean that all users are still in the "default" group. However, a parent group is configured for default, so it can inherit permissions from a group with a different name.

```
/luckperms creategroup member
/luckperms group default parents add member
```

## 配置默认分配
## Configure default assignments
如果你有更多的特殊需要，你可以使用这个选项，但是，这将否定我们在这个页面的第一节讨论的存储空间规划，所有的用户都会被存储，无论是"平凡的"成员还是不是。
If you have more specific needs, then you can use this option. However, be aware that it will negate the storage space optimisations discussed in the first section of this page. All users will be explicitly saved, whether they are a "regular" user or not.

##### 注意：查看 "Default Assignments" 章节
##### Note: see the "Default Assignments" section of the config for more detail on this.

接下来的规则将会创建一个不同的默认的组。
The following rule will configure a different default group.
```yml
default-assignments:
  my-defaults-rule:
if:
   has-true: <group.default>
take:
   - group.default
give:
   - group.member
set-primary-group: member
```

放入以后，每次玩家登入时，插件会检测这个玩家是不是"默认"组的成员，如果是，插件将会把玩家从"默认"组移除，将他们添加至"成员"组，将他们的主组也设置为"成员"组。
Simply put, every time a user logs in, the plugin will check if they are a member of the "default" group. If they are, it will remove them from "default", add them to "member", and set their primary group to "member".

这个系统非常强力，允许你配置按你自己的需求而定的默认组，记住你可以将玩家添加至不止一个的"默认"组。
This system is very powerful, and allows you to configure defaults to your exact needs. Remember you _could_ add users to more than one "default" group.

Configuration

不同平台的 LuckPerms 的配置文件可以在这里找到。
The main configuration file for LuckPerms can be found at these locations.

| 平台       | 位置                                                                                                                   |
|---------------|-------------------------------------------------------------------------------------------------------------------------------|
| Bukkit/Spigot | [`/plugins/LuckPerms/config.yml`](https://github.com/lucko/LuckPer ... esources/config.yml)       |
| BungeeCord | [`/plugins/LuckPerms/config.yml`](https://github.com/lucko/LuckPer ... esources/config.yml)       |
| Sponge       | [`/config/luckperms/luckperms.conf`](https://github.com/lucko/LuckPer ... rces/luckperms.conf) |

请注意配置文件不能在有新配置的时候自动添加，如果文件中没有找到任何东西，我们将使用默认选项。
Links to the default file for each platform are above. Please note that the configuration does not automatically update when new options are added. The default options are used if nothing is found in the file.

## 索引
### 基础
* [`server`](#server)
* [`include-global`](#include-global)
* [`include-global-world`](#include-global-world)
* [`apply-global-groups`](#apply-global-groups)
* [`apply-global-world-groups`](#apply-global-world-groups)
* [`use-server-uuids`](#use-server-uuids)
* [`log-notify`](#log-notify)
* [`world-rewrite`](#world-rewrite)
* [`group-name-rewrite`](#group-name-rewrite)
* [`temporary-add-behaviour`](#temporary-add-behaviour)
* [`primary-group-calculation`](#primary-group-calculation)
### 权限计算
* [`apply-wildcards`](#apply-wildcards)
* [`apply-regex`](#apply-regex)
* [`apply-shorthand`](#apply-shorthand)
##### Bukkit
* [`apply-bukkit-child-permissions`](#apply-bukkit-child-permissions)
* [`apply-bukkit-default-permissions`](#apply-bukkit-default-permissions)
* [`apply-bukkit-attachment-permissions`](#apply-bukkit-attachment-permissions)
##### Bungee
* [`apply-bungee-config-permissions`](#apply-bungee-config-permissions)
##### Sponge
* [`apply-sponge-implicit-wildcards`](#apply-sponge-implicit-wildcards)
* [`apply-sponge-default-subjects`](#apply-sponge-default-subjects)
### 服务器管理员 / Vault (仅 Bukkit 版本)
* [`enable-ops`](#enable-ops)
* [`auto-op`](#auto-op)
* [`commands-allow-op`](#commands-allow-op)
* [`use-vault-server`](#use-vault-server)
* [`vault-server`](#vault-server)
* [`vault-include-global`](#vault-include-global)
* [`vault-ignore-world`](#vault-ignore-world)
* [`vault-debug`](#vault-debug)
### 存储
* [`storage-method`](#storage-method)
* [`watch-files`](#watch-files)
* [`split-storage`](#split-storage)
* [`data`](#data)
* [`pool-size`](#pool-size)
* [`table-prefix`](#table-prefix)
* [`sync-minutes`](#sync-minutes)
* [`messaging-service`](#messaging-service)
* [`auto-push-updates`](#auto-push-updates)
* [`redis`](#redis)

## 基础
___
### `server`
服务器的名称，用于制定服务器的权限。
The name of the server, used for server specific permissions.
如果设置为 "global" 这个设置将会被忽略，更多关于服务器指定的权限可以在[这里](https://github.com/lucko/LuckPerms/wiki/Advanced-Setup)找到。
If set to "global" this setting is ignored. More details about how server specific permissions are groups work can be found [here](https://github.com/lucko/LuckPerms/wiki/Advanced-Setup).

##### 示例
```yaml
server: global
```

___
### `include-global`
这个服务器的玩家是否应该应用他们的全局权限。（没有指定服务器的权限）
If players on this server should have their global permissions applied. (permissions that were not set with a specific server).
如果这个选项被设置为 false，只有指定在此服务器的权限才会被应用。如果上方的 "server" 选项设置为 global，请不要将其设置为 false。更多的有关服务器指定的权限可以在[这里](https://github.com/lucko/LuckPerms/wiki/Advanced-Setup)找到。
If this option is set to false, only permissions that were specifically set to apply on this server will apply. Do not set to false if the "server" option above is set to global. More details about how server specific permissions are groups work can be found [here](https://github.com/lucko/LuckPerms/wiki/Advanced-Setup).

##### 示例
```yaml
include-global: true
```

___
### `include-global-world`
与上方的选项相似，只是这个选项用于世界的设定。如果设置为 false，只有指定了世界的权限才会被应用至玩家。任何没有指定世界的权限都不会被应用。
Similar to the option above, except this works with worlds. If set to false, only permissions that are set in specific worlds will be given to users. Any permissions set without a specific world context will not be applied.

##### 示例
```yaml
include-global-world: true
```

___
### `apply-global-groups`
这个选项与 "include-global" 选项类似，但是此选项更改了组的继承设定。
This option operates in the same manner as "include-global", except changes the setting for group inheritance.
当计算玩家的权限时，插件将会给继承树设定范围，递归解析组成员关系。如果这个设置设置为 false，如果一个组没有被应用，那么它的父组都不会被计算，继承查询将会在此终止。
When calculating a players permissions, the plugin will scale the inheritance tree, resolving group memberships recursively. If this setting is set to false, and as a result, a group is not "applied", then none of that groups parents will be considered, and the inheritance lookup will stop at that point.
这意味着就算一个玩家没有在一个特定服务器直接继承一个组，如果这个组通过了一个没有指定服务器的组继承，这个组将不会被应用。
This means that even if a player indirectly inherits a group on a specific server, the group will not be applied if it is inherited through a non-server specific group.

举个例子，当设置为 false，使用以下设置：
For example, with this setting false, and the following setup:

```
User "Luck" inherits from group "admin" globally, and admin inherits from "default" on a specific server.
```

尽管 Luck 在指定服务器上继承了默认组，它将不会被应用，因为继承查询在 admin 停止。admin 的父组将不被考虑。
Even though Luck inherits default on the specific server, it will not be applied, because the inheritance lookup stops at admin. The parent groups of admin are therefore never even considered.

##### 示例
```yaml
apply-global-groups: true
```

___
### `apply-global-world-groups`
与上面的选项相似，但是这个选项用于世界的设定。如果设置为 false，只有指定了世界的组才会被分配，给用户解析。任何没有指定世界的组都不会被应用。
Similar to the option above, except this works with worlds. If set to false, only groups that are set in specific worlds will be assigned and resolved for users. Any groups set without a specific world context will not be applied.

##### 示例
```yaml
apply-global-world-groups: true
```

___
### `use-server-uuids`
如果使用服务器的UUID，或者根据之前的连接的用户名来查询，那么这个设定应该使用 true，除非你很确定你在做什么。
If UUIDs should be pulled from the server, or looked up by username based upon previous connections. This setting should be kept set to true, unless you're sure you know what you're doing.
一般的，当这个选项设置为 true 时，当玩家登入时，LuckPerms 将会使用服务器提供的用户名/UUID来标识玩家。这个在大多数的服务器都是适用的。
Normally, when this is set to true: when a player logs in, LuckPerms will use the username / uuid provided by the server to identify the player. This is fine for the majority of servers.
当设置为 false，LuckPerms 将会检查玩家是否曾经在服务器登录过，如果找到了一个玩家，那么之前映射的UUID将会被使用，否则将会回到默认的使用服务器的UUID的方法。
When set to false, LuckPerms will first check to see if someone has joined previously with the same username. If a player is found, then the previous UUID mapped to that username will be used. Otherwise, it will fallback to the standard method of retrieving uuids from the server.
在离线模式（破解版）的服务器，玩家的UUID基于他们的用户名创建。
On offline mode (cracked) servers, a players UUID is generated based upon their username.
**重要**
**Important:**
如果你在运行一个 BungeeCord 服务器，你必须开启 IP forward 设置，这将让服务器使用正确的UUID。
If you are running a BungeeCord proxy, you *must* have IP forwarding setup, in order for the backend server to use the correct uuid for players.
[Spigot](https://www.spigotmc.org/wiki/bungeecord-ip-forwarding/) [Sponge](https://docs.spongepowered.org/s ... ted/bungeecord.html). SpongeForge 推荐使用 [HexaCord](https://github.com/HexagonMC/BungeeCord), 这是一个 BungeeCord 分支，支持 Forge 的 IP forwarding。
Guides for this can be found [here for Spigot](https://www.spigotmc.org/wiki/bungeecord-ip-forwarding/), and [here for Sponge](https://docs.spongepowered.org/s ... ted/bungeecord.html). SpongeForge users are advised to use [HexaCord](https://github.com/HexagonMC/BungeeCord), a BungeeCord fork, which supports IP forwaring for Forge.
如果你的 BungeeCord 代理运行于离线模式并且你使用了 Spigot，你也应该像下方一样开启 IP forwarding，但是推荐你安装 [Paper](https://ci.destroystokyo.com/job/PaperSpigot/) 并设置 paper.yml 中的 `bungee-online-mode: false`。
If your BungeeCord proxy is running in offline mode & you are running Spigot, you should still be setting up ip forwarding as described above. However, it is reccomended that you install [Paper](https://ci.destroystokyo.com/job/PaperSpigot/) and set `bungee-online-mode: false` in paper.yml.
如果还有什么原因导致了你无法设置 Ip forwarding，你可能需要将其设置为 false，请确保这样做之前你知道这样做的后果。
If for whatever reason you are unable to setup IP forwarding, you may need to set this option to false. Make sure you are aware of the consequences before you do this.

##### 示例
```yaml
use-server-uuids: true
```

___
### `log-notify`
当任何权限被修改后是否向玩家发送长的提醒。提醒将只发送给拥有正确权限的用户。
If the plugin should send log notifications to users whenever permissions are modified. Notifications are only sent to those with the appropriate permission to recieve the notification.
提醒可以在游戏中使用 `/lp log notify off` 临时关闭。
Notifications can also be disabled temporarily in-game using `/lp log notify off`

##### 示例
```yaml
log-notify: true
```

___
### `world-rewrite`
允许你给发送的世界设置别名，别名附加于真正的世界名，递归应用。
Allows you to set "aliases" for the worlds sent forward for context calculation. These aliases are provided in addittion to the real world name. Applied recursively.

##### 示例
```yaml
world-rewrite:
  world_nether: world
  world_the_end: world
```

___
### `group-name-rewrite`
允许你设置组名的别名。它们是纯粹的显示名称，实际上的名称不会改变，只有命令/信息的输出会改变。
Allows you to set "aliases" for group names. These are purely display names, the actual underlying name of the group does not change. Only the output in commands/messages are affected.

##### 示例
```yaml
group-name-rewrite:
  default: Member
```

___
### `temporary-add-behaviour`
控制临时的权限/父类/元数据，默认是 `deny`
Controls how temporary permissions/parents/meta should be accumulated. The default behaviour is `deny`.
* accumulate - 任何添加的节点将被添加
* **`accumulate`** - the duration of any existing nodes will just be added to the new duration
* replace - 临时的节点持续的最长的时间，其他的节点将被忽略
* **`replace`** - the longest duration will be kept, any others nodes will be forgotten
* deny - 如果你试图添加一个重复的临时节点命令将被拒绝
* **`deny`** - the command will just fail if you try to add a duplicate temporary node

##### 示例
```yaml
temporary-add-behaviour: deny
```

___
### `primary-group-calculation`
LuckPerms 如何决定用户的主组，Bukkit/Bungee 默认的是 `stored`，Sponge 默认的是 `parents-by-weight`。
How should LuckPerms determine a users "primary" group. The default behaviour for Bukkit/Bungee is `stored`, and the default for Sponge is `parents-by-weight`.
* stored - 使用存储的记录在文件/数据库的数据
* **`stored`** - use the value stored against the users record in the file/database
* parents-by-weight - 使用用户权重最高的父组
* **`parents-by-weight`** - use the users most highly weighted parent
* all-parents-by-weight - 像上面的一样，但是计算所有的继承，包括直接继承和间接继承
* **`all-parents-by-weight`** - same as above, but calculates based upon all parents inherited from both directly and indirectly

##### 示例
```yaml
primary-group-calculation: stored
```

___

## Permission Calculation
___
### `apply-wildcards`
插件是否应用带有通配符的权限。
If the plugin should apply wildcard permissions.
如果插件的作者没有提供他们自己的通配符权限，那么开启这个选项将会让 LuckPerms 转换它们。Bukkit 尤其不认同这种做法，但是它们在管理员中间适用的相当普遍。在 Sponge，这个选项控制 "node.part.*" 类型的通配符是否生效。
If plugin authors do not provide their own wildcard permissions, then enabling this option will allow LuckPerms to parse them instead. Bukkit especially did not endorse this practice, however it has become common among server administrators. On Sponge, this setting control whether "node.part.*" style wildcards will function.

##### 示例
```yaml
apply-wildcards: true
```

___
### `apply-regex`
插件是否转换正则表达式权限。
If the plugin should parse regex permissions.
如果设置为 true，LuckPerms 将会检测任何正则表达式权限，正则表达式权限节点以 "r=" 开头，返回所有匹配这个节点的请求。如果你没有任何正则表达式权限的设置，开启这个将没有任何性能的影响。这个特点的更多信息可以在[这里](https://github.com/lucko/LuckPerms/wiki/Advanced-Setup#regex)找到。
If set to true, LuckPerms will detect any regex permissions, marked with "r=" at the start of the node, and return all requests matching the node. If you do not have any regex permissions setup, enabling this option will have no impact on performance. More info on this feature can be found [here](https://github.com/lucko/LuckPerms/wiki/Advanced-Setup#regex).

##### 示例
```yaml
apply-regex: true
```

___
### `apply-shorthand`
是否允许GLOB风格的速记权限。
If the plugin should resolve and apply any shorthand (GLOB style) permissions.
更多这个特性的信息可以在[这里](https://github.com/lucko/LuckPer ... orthand-permissions)找到。
More info on this feature can be found [here](https://github.com/lucko/LuckPer ... orthand-permissions).

##### 示例
```yaml
apply-shorthand: true
```

___
### `apply-bukkit-child-permissions`
插件是否应用Bukkit子权限。
If the plugin should apply Bukkit child permissions.
插件的作者可以给他们的插件定义自定义权限结构，如果设置为 true，LuckPerms 将会使用他们。
Plugin authors can define custom permissions structures for their plugin, which will be resolved and used by LuckPerms if this setting is enabled.
这个选项是默认启用的，因为这是一个基础的Bukkit特性，大多数的服务器管理员都需要，但是如果你不希望使用这个系统，它将可以被安全关闭。
This is enabled by default, as it is a standard Bukkit feature, which most server admins expect to work. However, if you'd prefer not to use this system, it can be safely disabled.

##### 示例
```yaml
apply-bukkit-child-permissions: true
```

___
### `apply-bukkit-default-permissions`
插件是否应该应用Bukkit的默认权限。
If the plugin should apply Bukkit default permissions.
插件作者可以给所有的用户默认权限，或者设置应该/不应该给OP玩家。如果这个设置为 false，LuckPerms将会忽略这些默认权限。
Plugin authors can define permissions which should be given to all users by default, or setup permissions which should/shouldn't be given to opped players. If this option is set to false, LuckPerms will ignore these defaults.
这个选项是默认启用的，因为这是一个基础的Bukkit特性，大多数的服务器管理员都需要，但是如果你不希望使用这个系统，它将可以被安全关闭。
This is enabled by default, as it is a standard Bukkit feature, which most server admins expect to work. However, if you'd prefer not to use this system, it can be safely disabled.

##### 示例
```yaml
apply-bukkit-default-permissions: true
```

___
### `apply-bukkit-attachment-permissions`
插件是否应该应用Bukkit的附加权限。
If the plugin should apply Bukkit attachment permissions.
服务器的其他插件可以添加它们自身的"权限附加"到玩家，这允许大量的玩家附加权限持续到回话结束，或者被移除。如果这个设置被设置为 false，LuckPerms 在考虑玩家是否有某一特定的权限时，将不会包括这些附加的权限。
Other plugins on the server are able to add their own "permission attachments" to players. This allows them to grant players additional permissions which last until the end of the session, or until they're removed. If this option is set to false, LuckPerms will not include these attachment permissions when considering if a player should have access to a certain permission.
你在开启这个选项后可能会见到一个小的性能提升，关闭 OP 系统后，这个系统可以非常有效的阻止恶意插件给玩家任意权限的尝试。
You may also see a slight performance improvement by enabling this feature. Combined with disabling the OP system, this system can be quite effective at disabling malicious attempts by plugins to grant arbitrary permissions to players.
这个选项是默认启用的，因为这是一个基础的Bukkit特性，大多数的服务器管理员都需要，但是如果你不希望使用这个系统，它将可以被安全关闭。
This is enabled by default, as it is a standard Bukkit feature, which most server admins expect to work. However, if you'd prefer not to use this system, it can be safely disabled.

##### 示例
```yaml
apply-bukkit-attachment-permissions: true
```

___
### `apply-bungee-config-permissions`
插件是否应用 BungeeCord config.yml 里设置的权限和组。
If the plugin should apply the permissions & groups defined in the BungeeCord config.yml
如果设置为 false，LuckPerms 将会忽略这些值。
If set to false, LuckPerms will ignore these values.
这个是默认关闭的，因为所有的权限都应该通过 LuckPerms 来设置，这样他们可以在游戏中查看和编辑。
This is disabled by default, as permissions should really be defined within LuckPerms, so they can be viewed and edited in-game alongside everything else.

##### 示例
```yaml
apply-bungee-config-permissions: false
```

___
### `apply-sponge-implicit-wildcards`
插件是否解析并应用Sponge的通配符集成系统的权限。
If the plugin should resolve and apply permissions according to Sponge's implicit wildcard inheritance system.
如果一个玩家获得了 `example`，那么他将自动获得 `example.function` 权限，`example.another`，`example.deeper.nesting` 等。
That being: If a user has been granted `example`, then the player should have also be automatically granted `example.function`, `example.another`, `example.deeper.nesting`, and so on.
如果这个选项被设置为 false，系统将不会被应用。
If this option is set to false, this system will not be applied.
这个选项是默认启用的，因为这是一个基础的Sponge特性，大多数的服务器管理员都需要，但是如果你不希望使用这个系统，它将可以被安全关闭。
This is enabled by default, as it is a standard Sponge feature, which most server admins / plugin authors expect to work. However, if you'd prefer not to use this system, it can be disabled.

##### 示例
```hocon
apply-sponge-implicit-wildcards=true
```

___
### `apply-sponge-default-subjects`
插件是否应用Sponge的默认权限。
If the plugin should apply Sponge default subject permissions.
插件将会授予玩家一组默认权限，如果设置为 false，那么插件将在考虑玩家是否拥有某权限时忽略这一组权限。
Plugins can manipulate a set of default permissions granted to all users. If this option is set to false, the plugin will ignore this data when considering if a player has a permission.
这个选项是默认启用的，因为这是一个基础的Sponge特性，大多数的服务器管理员都需要，但是如果你不希望使用这个系统，它将可以被安全关闭。
This is enabled by default, as it is a standard Sponge feature, which most server admins / plugin authors expect to work. However, if you'd prefer not to use this system, it can be disabled.

##### 示例
```hocon
apply-sponge-default-subjects=true
```

## Server Operator / Vault (Bukkit version only)
___
### `enable-ops`
是否使用原版的OP系统。
If the vanilla OP system should be used.
如果设置为 false，所有玩家都不是 op，op/deop 命令将被禁止。
If set to false, all users will be de-opped, and the op/deop commands will be disabled.

##### 示例
```yaml
enable-ops: true
```

___
### `auto-op`
如果设置为 true，任何拥有 "luckperms.autoop" 权限的玩家将会自动设置为服务器OP。
If set to true, any user with the permission "luckperms.autoop" will automatically be granted server operator status.
这个权限可以被继承，或者设置在特定的服务器/世界，临时的等等。另外，设置此选项为 true 将会强制上方的选项 "enable-ops" 为 false。所有的用户都将被 deop 直到他们有了这个权限节点，并且 op/deop 命令将被禁止。
This permission can be inherited, or set on specific servers/worlds, temporarily, etc. Additionally, setting this to true will force the "enable-ops" option above to false. All users will be de-opped unless they have the permission node, and the op/deop commands will be disabled.
有一点需要注意的是，自动OP检测只有在玩家进入服务器和切换世界时生效，这意味着，简单的移除他们的权限并不会自动去除玩家的OP，玩家必须重新登陆才能使其生效。
It is important to note that this setting is only checked when a player first joins the server, and when they switch worlds. Therefore, simply removing this permission from a user will not automatically de-op them. A player may need to relog to have the change take effect.
推荐使用这个选项而不是简单的分配一个 "*" 权限。
It is recommended that you use this option instead of assigning a single '*' permission.

##### 示例
```yaml
auto-op: false
```

___
### `commands-allow-op`
OP玩家是否有权限使用 LuckPerms 指令。
If opped players should be allowed to use LuckPerms commands.
设置为 false 将只允许有命令指定的权限的玩家使用。
Set to false to only allow users who have the permissions access to the commands

##### 示例
```yaml
commands-allow-op: true
```

___
### `use-vault-server`
下方的 `vault-server` 选项是否应该使用。
If the `vault-server` option below should be used.
当这个选项设置为 false 时，"server" 值用于 Vault 操作。
When this option is set to false, the server value defined above under "server" is used for Vault operations.

##### 示例
```yaml
use-vault-server: false
```

___
### `vault-server`
Vault 操作中使用的服务器名称。
The name of the server used within Vault operations.
如果你不想让 Vault 操作为特定服务器，将其设置为 "global"。
If you don't want Vault operations to be server specific, set this to "global".
只有当 `use-vault-server` 设置为 true 时生效。
Will only take effect if `use-vault-server` is set to true above.

##### 示例
```yaml
vault-server: global
```

___
### `vault-include-global`
玩家组接受元数据时是否考虑全局权限。
If global permissions should be considered when retrieving meta or player groups.

##### 示例
```yaml
vault-include-global: true
```

___
### `vault-ignore-world`
Vault 操作是否应该忽略提供的世界参数。
If Vault operations should ignore any world arguments if supplied.
默认情况下，如果没有提供世界参数，权限将会设置在玩家当前的世界。（Vault 的设计给满分）。设置为 true 来更改这项操作的结果。
By default, if a world argument is not supplied, permissions will be set on the players current world. (Vault design is just 10/10). Set this to true to change this behaviour.

##### 示例
```yaml
vault-ignore-world: false
```

___
### `vault-debug`
LuckPerms 是否应当在一个插件使用了 Vault 的功能后打印 debug 信息。
If LuckPerms should print debugging info to console when a plugin uses a Vault function

##### 示例
```yaml
vault-debug: false
```

## Storage
___
### `storage-method`
插件应该使用哪个存储方法。
Which storage method the plugin should use.
查看[这里](https://github.com/lucko/LuckPerms/wiki/Choosing-a-Storage-type)查看支持的所有类型。
See [here](https://github.com/lucko/LuckPerms/wiki/Choosing-a-Storage-type) for a full list of supported types.
接受： `mysql`, `mariadb`, `postgresql`, `sqlite`, `h2`, `json`, `yaml`, `mongodb`
**Accepts:** `mysql`, `mariadb`, `postgresql`, `sqlite`, `h2`, `json`, `yaml`, `mongodb`
如果你的 MySQL 支持，那么 `mariadb` 选项比 `mysql` 更好，`h2` 当然也比 `sqlite` 更好。
If your MySQL server supports it, the `mariadb` option is preferred over `mysql`. `h2` is also generally preferred over `sqlite`.

##### 示例
```yaml
storage-method: h2
```

___
### `watch-files`
当使用基于文件的存储系统，LuckPerms将会监视数据文件的变化，并在文件变化被检测到的时候自动规划更新数据、
When using a file-based storage type, LuckPerms will monitor the data files for changes, and then schedule automatic updates when changes are detected.
如果不想让这个发生，那么将此选项设置为 false。
If you don't want this to happen, set this option to false.

##### 示例
```yaml
watch-files: true
```

___
### `split-storage`
分离存储允许你为不用的数据类型使用不同的存储选项。
The split storage section allows you to use multiple storage options for different types of data.
不同类型的数据有：
**The different types of data are:**
* user - 关于用户的数据，包含权限、父组和元数据
* **`user`** - data about users, including their permissions, parents and meta
* group - 关于组的数据，包括了组权限、继承组和元数据
* **`group`** - data about groups, including their permissions, parents and meta
* track - 关于轨道的数据（或者说是梯子）
* **`track`** - data about tracks (or so called "ladders")
* uuid - LuckPerms 适用的 `uuid <-- --> username` 缓存，当 `/lp user` 使用的是用户名而不是 UUID
* **`uuid`** - a cache of `uuid <-- --> username` used by LuckPerms when usernames are used in the `/lp user` command instead of uuids.
* log - LuckPerms 存储的日志
* **`log`** - the action log stored by LuckPerms
允许的数据类型在上方列出
The allowed storage types are detailed above.

##### 示例
```yaml
split-storage:
  enabled: true
  methods:
user: mariadb
group: yaml
track: yaml
uuid: mariadb
log: mariadb
```

___
### `data`
此选项用于指定数据库的存储凭据。
This section is used for specifying credentials used for storage methods.

* address - 数据库的地址，如果使用默认的端口可以不填写，如果使用了特定端口，请使用 `host:port`
* **`address`** - the host to be used for the database. Uses the standard DB engine port by default. If you have a non-default port, specify it here using `host:port`.
* database - LuckPerms 应该使用的数据库
* **`database`** - the database which should be used by LuckPerms
* username - 使用的用户名
* **`username`** - the username to be used
* password - 使用的密码，留空则不使用验证
* **`password`** - the password to be used. Leave empty to use no authentication.

##### 示例
```yaml
data:
  address: localhost
  database: minecraft
  username: root
  password: ''
```

___
### `pool-size`
MySQL 连接池大小。
The size of the MySQL connection pool.
默认为 `10`，应该适合大部分服务器。只有你清楚你在干什么再更改这项设置。
By default this option is set to `10`, which should be fine for most servers. Only change this option if you know what you're doing.
查看[这里](https://github.com/brettwooldrid ... i/About-Pool-Sizing)了解更多关于连接池大小的信息。
See [here](https://github.com/brettwooldrid ... i/About-Pool-Sizing) for more details about pool sizing.

##### 示例
```yaml
data:
  pool-size: 10 # The size of the MySQL connection pool.
```

___
### `sync-minutes`
此选项控制 LuckPerms 多长时间进行一次同步任务。
This option controls how frequently LuckPerms will perform a sync task.
同步任务将会刷新存储中的所有信息，保证插件使用的是最新的数据。
A sync task will refresh all data from the storage, and ensure that the most up-to-date data is being used by the plugin.
这个选项默认关闭，因为大多数的用户都是不需要这个功能的，但是如果你使用远程存储，又没有设置信息服务，那么你可能将其设置为像 3 这样的数值。
This is disabled by default, as most users will not need it. However, if you're using a remote storage type without a messaging service setup, you may wish to set this value to something like 3.
设置为 -1 来完全停用这个任务。
Set to -1 to disable the task completely.

##### 示例
```yaml
data:
  sync-minutes: 3
```

___
### `messaging-service`
设置信息服务。
Settings for the messaging service.
如果开启并且正确配置了，LuckPerms 可以使用消息系统来通知其他连接的服务器更改。使用命令 `/luckperms networksync` 来推送更改，使用这个服务不会存储数据，只是用于消息平台。
If enabled and configured, LuckPerms will use the messaging system to inform other connected servers of changes. Use the command "/luckperms networksync" to push changes. Data is NOT stored using this service. It is only used as a messaging platform.
如果你决定开启这个功能，你应该设置 "sync-minutes" 为 -1，因为没有必要将数据推至数据库。
If you decide to enable this feature, you should set "sync-minutes" to -1, as there is no need for LuckPerms to poll the database for changes.
可用的选项
**Available options:**

* bungee - 使用插件的 messaging channel。必须在所有的子服务器开启才能使用，并且要在 Bungee 安装 LuckPerms。
* **`bungee`** - uses the plugin messaging channels. Must be enabled on all connected servers to work, and you need to have LP installed on your proxy.
* lilypad - 使用 LilyPad 的 pub sub 来推送更改。你需要安装 LilyPad-Connect 插件。
* **`lilypad`** - uses LilyPad's pub sub to push changes. You need to have the LilyPad-Connect plugin installed.
* redis - 使用 Redis 的 pub sub 来推送更改。
* **`redis`** - uses Redis pub sub to push changes.
* none - 啥都没有！
* **`none`** - nothing!

##### 示例
```yaml
messaging-service: none
```

___
### `auto-push-updates`
LuckPerms 是否应该在命令执行后自动推送更改。
If LuckPerms should automatically push updates after a change has been made with a command.

##### 示例
```yaml
auto-push-updates: true
```

___
### `redis`
Redis的设定。
Settings for Redis.

* address - redis 使用的地址，默认使用默认端口（6379），如果你有特定的端口，请使用 `host:port`。
* **`address`** - the host to be used for redis. Uses the standard port by default (6379). If you have a non-default port, specify it here using `host:port`.
* password - 使用 Redis 需要的密码。留空则不使用验证。
* **`password`** - the password to be used. Leave empty to use no authentication.

##### 示例
```yaml
redis:
  enabled: true
  address: localhost
  password: 'passw0rd'
```

Home

2017-08-04 14:28:00

cc7w

杂项
本地化与语言文件
LuckPerms 插件中所有的消息（包括颜色和格式代码）都能够修改。（似乎合情合理）

将下面的文件之一下载然后存储到LuckPerms的文件夹中，然后命名为 "lang.yml"。

将文件中的消息文本改成你喜欢的样子，然后重启你的服务器就好了。

语言文件

en_US - 英语
es_ES - 西班牙语
ru_RU - 俄语
zh-CN - 简体中文
pl_PL - 波兰语
1 g# z# L$ h) _0 H$ k2 ]- o- k' \

为翻译做贡献

如果你翻译了语言文件，然后提交回工程的话，我（和其他使用本插件的人）会很高兴的，因为其他使用者会受益。

上面的 "en_US" 语言文件应作为翻译的标准，你只能修改文本消息的值，关键字应保留原样。

2017-08-04 14:40:00

cc7w

PlaceholderAPI

在 extended_clip 的 PlaceholderAPI 插件中，LuckPerms 也注册了一些变量（Placeholders）。

LuckPerms 插件所使用的标识符是 "luckperms"。

使用

要想使用变量的话，你需要运行下列命令。

这些命令的作用就是安装 LuckPerms 的变量扩展，安装后你就可以使用下面列举出的变量了。

/papi ecloud download LuckPerms. S# `- V* e. h. `$ W+ `
/papi reload) n7 s3 r; s2 A( R

复制代码

请记住使用这些指令你需要OP权限（或者你也可以选择在控制台中运行这些指令）

同时请注意，如果你想得到玩家的前缀或后缀数据，——如果你在服务器上安装了Vault插件和Vault的变量扩展的话，你也可以使用 Vault 插件所提供的变量。

变量列表

%luckperms_group_name%

使用说明：返回玩家当前所在组的名字
使用示例：暂无示例

%luckperms_context_<context key>%

使用说明：返回给定内容关键字的值，如果内容没有值的话会返回空
使用示例： %luckperms_context_server%

%luckperms_groups%

使用说明：返回服务器上的权限组列表，用逗号分割
使用示例：暂无示例

%luckperms_has_permission_<permission>%

使用说明：检查玩家是否直接拥有该权限，不会检查通配符或继承的权限
使用示例： %luckperms_has_permission_essentials.ban%

%luckperms_check_permission_<permission>%

使用说明：检查玩家是否拥有指定权限，这个变量工作的方式和正常插件的检查方式没有区别
使用示例： %luckperms_check_permission_some.cool.permission%

%luckperms_in_group_<group>%

使用说明：返回玩家是否为给定组的成员，不包括继承组
使用示例： %luckperms_in_group_admin%

%luckperms_inherits_group_<group>%

使用说明：返回玩家是否在给定组或继承给定组
使用示例： %luckperms_inherits_group_vip%

%luckperms_on_track_<track>%

使用说明：返回玩家的权限组是否在给定权限组树上
使用示例： %luckperms_on_track_staff%

%luckperms_has_groups_on_track_<track>%

使用说明：检查玩家是否继承给定权限组树中的任何一个组
使用示例： %luckperms_on_track_donor%

%luckperms_highest_group_by_weight%

使用说明：返回玩家所在权限组树种的最高级权限组
使用示例：暂无示例

%luckperms_lowest_group_by_weight%

使用说明：返回玩家所在权限组树种的最低级权限组
使用示例：暂无示例

%luckperms_first_group_on_tracks_<tracks>%

使用说明：返回玩家在给定权限组树上所在的第一个组，权限组树会返回一组用逗号分隔的权限组名，权限组树中的每一个权限组都正序排列。使用示例： %luckperms_first_group_on_tracks_staff,donor%

%luckperms_last_group_on_tracks_<tracks>%

使用说明：返回玩家在给定权限组树上所在的最后一个组，权限组树会返回一组用逗号分隔的权限组名，权限组树中的每一个权限组都倒序排列。
使用示例： %luckperms_last_group_on_tracks_staff,donor%

%luckperms_expiry_time_<permission>%

使用说明：获得玩家拥有的临时权限剩余的时间，如果玩家没有该权限的话会返回空
使用示例： %luckperms_expiry_time_essentials.fly%

%luckperms_group_expiry_time_<group name>%

使用说明：获得玩家拥有的临时权限组所剩余的时间，如果玩家不在该权限组的话会返回空
使用示例： %luckperms_group_expiry_time_vip%

%luckperms_prefix%
使用说明：返回玩家的前缀，使用Vault所提供的变量所输出的结果可能会更精确，这一项不会被Vault的配置设置影响
使用示例：暂无示例

%luckperms_suffix%

使用说明：返回玩家的后缀，使用Vault所提供的变量所输出的结果可能会更精确，这一项不会被Vault的配置设置影响
使用示例：暂无示例

%luckperms_meta_<meta key>%

使用说明：返回与指定Meta关键字联系的值
使用示例： %luckperms_meta_some-key%

2017-08-04 15:01:00

cc7w

安装
初始设置

下载适合你平台的 LuckPerms-???-x.x.x.jar 文件。你可以点这里查看最新的版本。
打开你的 Mod 或插件所在路径，这路径通常要么是 /server/plugins/ ，要么是 /server/mods/。
然后把 LuckPerms 的 jar 文件放入文件夹中。

请完全关闭你的服务器，然后再打开，这会生成默认配置。
完全关闭你的服务器，打开配置文件。配置文件的位置在 /plugins/LuckPerms/config.yml 或 /config/luckperms/luckperms.conf。
请浏览配置文件，然后根据你的服务器修改设置，尤其是请注意存储相关设置。
再次开启你的服务器。

你可以更改配置文件中的很多内容，文件有很细节化的注释，每个设置的作用注释中都解释的很清楚。

需求

LuckPerms 插件只有一个环境需求。
Java 8

没错，唯一需求就是你必须使用 Java 8，LuckPerms 插件在旧版本的Java上不会工作。
到目前为止很多服务器提供商都已经升级到Java 8了，但是如果你的服务器提供商没有升级的话，请温和地和他们谈谈，让他们去升级。
如果你是自己租主机开服的话，你应该对你还没有升级Java感到羞愧！
升级的过程是很简单的，如果你想升级的话网上也有大量的教程。
使用过期的软件肯定不是好的:)

Bukkit版本过旧

如果你收到了类似于 "NoSuchMethod" 或 "ClassNotFound" 这类错误的话，十有八九就是你在使用较旧的Bukkit版本。
在将它作为错误报告给我之前，请尝试使用"Development Builds"（构建版本）下载页面的"Bukkit-Legacy"（Bukkit-旧版）版本。

切换存储类型

LuckPerms 插件所使用的默认数据存储类型是 H2 数据库。
所有的数据都会储存在LuckPerms插件目录下的 luckperms.db.mv.db 文件之中。
（插件目录为 /plugins/LuckPerms/ 或 /luckperms/）

这个数据格式普通的文本编辑器是不能读取的。
如果你想要手动阅读/编辑LuckPerms插件的数据的话，你就需要切换到YAML或JSON存储格式，更改 config.yml 文件中的配置选项就好了。

更多相关于存储类型的有关信息请阅读下一节

2017-08-04 15:31:00

INKDRRAK

本帖最后由 1345979462 于 2017-8-4 16:00 编辑

Why is LuckPerm部分翻译
LuckPerms是什么？

这是另外一款全新的权限插件？
是的，我认为LuckPerm相比其他权限插件还有很大的发展空间
LuckPerm是一款先进、高等的权限插件，仅仅以快速、稳定可靠、灵活多变的特点
便可以替代现有的许多权限插件，例如PermissionsEX、GroupManagerX、z/bPermissions、BungeePerms等主流权限插件
LuckPerms这个插件的计划，本来是围绕着两个主要特点来制作的：高性能、强大且广泛的功能
填补其他同类插件的功能缺陷、并且建立在同类现有功能上更进一步的优化功能
LuckPerms还包括了非常广泛的API支持，这是为开发人员的添加的
并且，luckperms还兼容各式各类Minecraft服务器软件&支持多种数据存储的选择
我已经使用某插件很长一段时间了，它对我的帮助很大，我也很熟悉它了，为什么我要更换它而选择LuckPerm呢？
现在主流的权限插件大多数都是老牌插件了，并且都是在Bukkit早期就被创造出来了
虽然，这可能意味着它们非常的稳定可靠，但通常也意味着它们被原作者抛弃，并且一般不会再有任何更新、修复
但LuckPerm却任然是一个需要成长、需要磨砺的插件！
我会尽力及时查看并回复所有的bug报告、问题，以及可实现的新功能建议
你说的不错，但是我更加偏爱某插件，因为仅凭它就完成了我需要的一切
这没关系，我完全理解你的这种心态，我并不是想要说你必须用LuckPerm来作为你服务器的权限插件
当然还有更多适合你服务器权限插件，但是LuckPerm确实是个很棒的选择，不是么？
来吧兄弟，告诉我，我为什么要使用LuckPerm？
LuckPerm能做很多事情，至少单在技术层面，LuckPerm就胜过大部分同类插件
我认为这不取决于我制作插件的水平，而是取决于我在LuckPerm上面花费的精力与时间
LuckPerm是我在2016年开始准备编写的插件，但因为Bukkit变得流行起来，许多同一时期的插件都变成了老牌稳定插件
不过，这也为我编写LuckPerm提供的很好的参考帮助，因为我可以避免其它同类插件的缺陷
并且明白它们哪些地方做的特别出色，我可以在其基础之上进一步优化，使那部分功能变得更加引人瞩目
记着，如果你对LuckPerm技术性方面的内容感兴趣，我推荐你从命令使用部分开始阅读
或者看看wiki列出的其他部分内容，在本节的其余部分，我会将阅读重点放到LuckPerm一些全新的特色功能上面
这些内容是你不太可能从其他插件中找到的，专属luckPerm的特色功能！
Verbose（权限查看系统）
LuckPerm有一套完整的权限查看系统，是的，它叫做Verbose
他可以实时监视并检测其他插件所需的权限，就像下面示例的动态图那样

你也可以把录像上传到网上，方便查看、分析和阅读：https://git.io/vQitM
权限树系统
LuckPerm允许你在服务器所有已知权限上建立编写"权限树"
权限树上的数据是由你所有的插件在服务器注册的权限构成的
随着你服务器运营时间的增长，因为服务器添加了许多插件，它们都会注册权限，这些数据都会被纳入权限树中
这是个清真的例子（https://git.io/vQiti）
你看到的权限树的颜色，代表了你的玩家是否拥有对应的权限，这一机制很方便的让你查阅到服务器的相应权限
这还是那个清真的例子（https://git.io/vQit1）
指令界面&TAB补全
LuckPerm的指令系统被我设计的尽可能便捷、易用、人性化
这样一来，你除了查阅LuckPerm的大量相关帮助文档，还可以在游戏中查看指令用法、以及指令列表

LuckPerm的所有指令皆可使用TAB补全功能，这就意味着，你可以通过输入更少的指令来完成你的工作！
这是不是在一定程度极大地提高了你的工作效率呢？就像下面那样

网站编辑
除了使用指令来编辑服务器权限相关，LuckPerm还提供了更加便捷的编辑方式
你可以使用Web网站编辑器来对服务器的权限数据进行快速更改
任何人都能够使用网站编辑器，不论你使用了哪种存储方式！
网站编辑功能非常容易使用，且易于上手

行为记录仪
为了防止服务器中出现心存不轨的管理员，想要私自给自己添加权限
LuckPerm详细的记录了服务器各类权限的微小变化
你可以通过行为记录仪来搜索每个人的详细操作

2017-08-04 15:58:00

cc7w

选择存储类型

LuckPerms 插件带有很多存储数据的方式，你可以从中选择。
存储类型选项可以在 config.yml 或 luckperms.conf 文件中修改。

# Which storage method the plugin should use.
( N; x: X! F) ?8 t4 t
# Currently supported: mysql, postgresql, sqlite, h2, json, yaml, mongodb
3 P5 I% s8 h/ N! {
# Fill out connection info below if you're using MySQL, PostgreSQL or MongoDB
% U% r6 J7 O" p2 x
storage-method: h2
4 f; c2 t) Q& [& a3 I

复制代码

请记住如果你想改变存储类型的话，你的数据不会自动转移到新的存储库中。
要想手动在数据存储方式间转移数据的话，请查看这里来获得更多信息。

可用的选项都列在了下面。

H2 / SQLite
默认的存储类型是 H2 。
这两种文件类型都是以SQL数据库为基础的。
所有的数据都会存储在LuckPerms插件目录下的一个文件之中。
和YAML和JSON方式的不同之处在于，这个文件不能用文本编辑器打开。
你必须使用插件提供的命令才能编辑或查看数据。

如果你选择使用 H2 数据库的话（默认设置），所有的数据都会储存在 luckperms-h2.mv.db 文件中。
SQLite 类型所提供的存储文件是 luckperms-sqlite.db。

要想使用这两种类型中的一种，请将配置设置为：

storage-method: h2
) z: l" }, e8 ^" i0 V
# or
# Z. d3 b* h6 P4 p
storage-method: sqlite
- X6 u2 s8 Y* I5 p! b

复制代码

JSON / YAML

JSON 和 YAML 存储类型会将数据存储在可读可编辑的文本文件中。YAML 类型所提供的文件扩展名为 .yml ，JSON类型所提供的文件扩展名为 .json。

这两种类型的存储格式很相似，只是在一些句法上不同。

示例YAML文件

uuid: c1d60c50-70b5-4722-8057-87767557e50d- C# F, o" ^$ A2 q: ^% @4 c' |4 Y9 K
name: Luck# a8 d( x+ ~' o% G' k9 b, S, [7 z, \
primary-group: default t! [1 B# U0 D2 w
permissions:" V* Q k7 G& c: A9 \( G( L9 |
- group.default:) V" h( a, e, G
value: true
7 k" e& `9 x8 v0 ~8 S/ N
- test.permission:0 {% P; e4 A& c# d
value: true
7 [$ y- A" r+ Q# u/ |; W8 A) n
server: factions, x# h( s' l2 d. F" { h, }
- other.test.permission:
8 N7 H& ^5 a/ A
value: false

复制代码

示例JSON文件

{% B7 d( M7 |3 l0 ^
"uuid": "c1d60c50-70b5-4722-8057-87767557e50d",
* T# l. [1 ^* e& l6 ^$ ]
"name": "Luck",
7 R% G9 p q, y- }
"primaryGroup": "default",
5 `) \1 O+ E* e: N& S7 C7 i7 }
"permissions": [% H$ R, R! t; n4 F0 O) \" l
{
/ E9 @& |& y* e3 a4 j3 ?) L
"group.default": {
( m! B+ z1 s* {" J
"value": true: D; R( X1 X9 |: w4 J& L# f
}
. ~, Y* J% a* f% \
},8 p% a" ~. K. t& K9 B' d& J
{
4 ^6 p+ L0 |1 j
"test.permission": {6 Z' \# F0 l& z6 i! G' S
"value": true,
9 s3 | i" v6 R) Y& s
"server": "factions"" c2 p' Z, ~: Y X) z
}
# e+ [& Y0 o: r$ r( Z
},
8 g [. @' l+ h. x2 T2 N) h
{7 d6 a1 A! e! n: }) S0 M
"other.test.permission": {* p! j0 M, S/ D1 v
"value": false,
1 f: s8 w3 w/ k
"server": "test"& C/ d/ c1 E$ E
}
6 o5 V/ @9 t/ N
}+ i& _8 O0 P2 B) o: p# z% Q
]
" `) w/ k' f8 y9 B2 \1 O- r L9 h
}

复制代码

要想使用这两种类型中的一种，请将配置设置为：

storage-method: yaml( ^' E ? c; x5 p! ^) y. Y! O
# or
+ _. j& I. |3 I+ T3 p q
storage-method: json: c$ S$ M- l) d: a* d

复制代码

MySQL / PostgreSQL

储存在 MySQL 类型和 PostgreSQL 类型中的数据格式上与上文提及的 H2/SQLite 类型相同，但是数据是储存在远程服务器上的。
这意味着你可以跨服分享相同的数据。
你需要在配置文件中输入你数据库服务器的地址，端口，数据库名，用户名和密码。
这种类型推荐要存储大量数据的用户，或是想要搭建群组服务器的用户所使用。
如果你已经在运行群组服务器，并且想要在子服务器之间同步数据的话，你就必须选择这种类型了。

格式布局示例在这里。

要想使用这两种选项中的一种，请将配置设置为：

storage-method: mysql
9 N K& f4 [9 k( R+ ]( ~
# or
% d" B J$ k% Q @$ ], J" L
storage-method: postgresql

复制代码

MongoDB

LuckPerms 也支持 MongoDB 类型的存储，它也是一种远程数据库，在有些方面上和 MySQL 相似。
这种类型也只会被一小部分的用户所使用。
要想使用这种类型的存储，请将配置设置为：

storage-method: mongodb

复制代码

2017-08-04 16:22:00

cc7w

使用教程

这篇教程是为之前从来没有使用过权限管理插件的人所准备的。
如果你已经很熟悉权限管理等相关概念了的话，我认为你应该就能够理解命令中的东西了。
这样我就推荐你去阅读命令和权限页面，这样更加“直奔主题”，你也能够更容易理解插件的工作方法。

如果你正在努力想弄明白权限管理相关概念的话，这篇教程就是你起步的最佳地方:)

关键术语

权限
在你的服务器上会有大量的特性，命令和一些新功能。
这其中的一些特性是服务器自带的，另一些是由“插件”所添加的。
与这些特性相联系的大多数行为都是由权限所控制的，因此你可以控制哪些用户可以使用你指定的特性或权限。

权限仅仅是个字符串，并且使用英文的句号（半角 → . ←）分成几部分。
举个例子， “minecraft.command.ban” 就是原版 /ban 命令所使用的权限。
显然我们不想让所有用户都能执行这个命令，所以我们只给我们信任的玩家这个权限。

代表特定行为的使用许可的字符串，我们就称之为权限，它又名“权限节点”，简称“权限”。

权限组
代替单独为每个用户设置权限，我们可以将权限捆绑为一组，然后直接将这一组给予玩家。
举个例子，在我设置的“admin”权限组中，我可能会添加使用ban和unban指令的权限，然后将玩家加入admin权限组中。
这意味着他们能够获得“admin”权限组所设置的所有权限和他们自身被设置的权限。

继承
用户和权限组能够互相继承权限。
举个例子，默认地，所有的用户都会从“default”权限组继承权限。
你可以为你自己的服务器设置你自己的权限组与继承方式，或是制作你自己独特的系统。

举个例子，我设置了三个权限组， “default”， “moderator” 和 “admin”。
我想让“moderator”权限组从“default”权限组继承所有权限，“admin”权限组从“moderator”权限组继承所有权限。

起步
如果你还没有将LuckPerms插件安装在你的服务器上的话，我们推荐你先阅读安装有关的教程。
然后，请确保你在继续之前已经阅读了选择数据存储类型的有关章节。
虽然你在后期也能实现数据之间的转移，但第一次就将他们弄对位置是更好的。

给予修改权限的全部权限
你想做的第一件事情就是给你本插件的所有权限。
当本插件首次安装后，没有人能够使用LuckPerms插件的有关命令。

要想做到这个的话，你需要在服务器控制台输入 /luckperms user Luck permission set luckperms.* true 。
当然，请把我的名字换成你自己的（不用担心，这条命令的使用方法之后会详细讲解）
这应该就是运行的结果：

实际上，这条命令起的效果，就是给了 Luck 用户 luckperms.* 权限。（或者说，为用户设置权限为 true）

你可能已经注意到了我们刚才在权限字符串的末端使用的 * 字符了。
这个字符叫做通配符，它会给玩家所有以 "luckperms" 为开头的权限。

创建第一个权限组
我们可以使用创建权限组命令来创建一个新的权限组。
让我们创建一个叫做“admin”的权限组，然后给它附加一条权限吧。
首先，运行 /luckperms creategroup admin 命令。
这会创建一个叫做“admin”的空权限组。

接下来，我们想为“admin”权限组增加一条权限。
用来修改权限组的命令是 /luckperms group <group>。
如果你执行这条命令的话，它会为你显示所有可用的子命令。

你可能注意到了第一个子命令是“info”命令。它只会列举出一些权限组相关的信息。
我们可以运行 /luckperms group admin info 来查看新建立的“admin”权限组的一些信息。

接下来就是“permission”命令。这能够帮助你修改权限组的权限。
再一次，使用 /luckperms group admin permission 命令会列出所有可用的子命令。

再一次，我们看到了更多我们可以执行的命令。
第一个就是另一个 "info" 子命令。
因为它是“permission”子命令下的又一子命令，它就会显示某一权限组所拥有的所有权限。
下面的命令是“set”子命令。

你还记得吗，之前我们使用相似的指令来给玩家 "luckperms.*" 权限。这里它也相同
只需要不加参数运行该命令就可以返回该命令的使用方法。举个例子：

举个例子，我想给我的“admin”用户组 "minecraft.command.ban" 权限。
因此我可以输入 /luckperms group admin permission set minecraft.command.ban true 。

这条命令就会给予“admin”用户组 “minecraft.command.ban permission” 权限。
末端的true控制我们设置的权限的启用与否。
你可以将权限的启用与否设置为 true 或 false 。
为用户或权限组将权限设置为 true 能够让他们拥有该权限，设置为 false 即该权限无效。（指定他们没有该权限）

如果晚些时候我决定不再让“admin”用户组拥有这个权限了，我可以使用 unset 命令来移除该权限的设定。
输入 /luckperms group admin permission unset minecraft.command.ban 。

将玩家加入到权限组中
将用户加入到权限组中需要使用 "parent" 命令。（在我们的命令使用页我们经常用“permission”替换“parent”）
举个例子，把我自己加入“admin”权限组中，我需要使用 /luckperms user Luck parent add admin 。

这条命令会将用户 Luck 加入到“admin”权限组中。
这意味着任何“admin”权限组所拥有的权限我现在也继承下来了。

让一个权限组继承另一个权限组
就像用户能够继承一样，权限组也能够继承另一个权限组。
举个例子，想想下面这种情况的设置方法。（有些权限仅仅是为了演示而编造出来的）

Admin	Mod	Default
minecraft.command.ban	minecraft.command.mute	minecraft.command.say
minecraft.command.pardon	minecraft.command.unmute	minecraft.command.me
some.cool.admin.perm	some.cool.mod.perm
someplugin.vanish	chatcolor.bold

我想让“admin”权限组中的用户拥有“mod”和“default”权限组的权限，同时“mod”权限组中的用户拥有“default”权限组中的权限。要想实现这个的话，我可以设置用户组之间的相互继承。

/luckperms group admin parent add mod 命令会让“admin”权限组继承所有“mod”权限组中的权限。
然后要想让“mod”继承“default”，同样的道理，我可以输入 /luckperms group mod parent add default。

继承是可递归的，所以这样以后“admin”权限组就不仅仅继承了“mod”权限组，还继承了“default”权限组。
这意味着“admin”权限组中的玩家拥有“mod”和“default”两权限组中的权限了。

在“admin”组的一位用户因此拥有 minecraft.command.ban，minecraft.command.mute 和 minecraft.command.say 权限。

移除继承权限组
要想移除权限组间的继承关系只需要输入一个类似的命令就好了。
要想让我自己不再继承“admin”权限组，我只要输入 /luckperms user Luck parent remove admin 就好了。

2017-08-04 17:01:00

INKDRRAK

GM&PEX对应等效指令*
我编写这部分WIKI内容的目的是为了帮助用户们适应从GM/PEX到LuckPerm的转变
这里我制作了一份对应等效指令的表格，方便用户随时查阅
*对应等效指令：在LuckPerm中与其他权限插件效果相同的指令
GroupManager与LuckPerm的对应等效指令：

GroupManager 指令	LuckPerms 对应等效指令
manuadd <玩家> <组>	lp user <玩家> parent set <组>
manudel <玩家>	lp user <玩家> clear
manuaddsub <玩家> <组>	lp user <玩家> parent add <组>
manudelsub <玩家> <组>	lp user <玩家> parent remove <组>
manpromote <玩家> <组>	lp user <玩家> promote <权限系>
mandemote <玩家> <组>	lp user <玩家> demote <权限系>
manwhois <玩家>	lp user <玩家> info
manuaddp <玩家> <权限>	lp user <玩家> permission set <权限> true
manudelp <玩家> <权限>	lp user <玩家> permission unset <权限>
manulistp <玩家>	lp user <玩家> permission info
manucheckp <玩家> <权限>	lp user <玩家> haspermission <权限>
manuaddv <玩家> prefix <值>	lp user <玩家> meta addprefix <优先级> <值>
manuaddv <玩家> suffix <值>	lp user <玩家> meta addsuffix <优先级> <值>
manuaddv <玩家> <变量> <值>	lp user <玩家> meta set <变量> <值>
manudelv <玩家> <变量>	lp user <玩家> meta unset <变量>
manulistv <玩家>	lp user <玩家> meta info

mangadd <组>	lp creategroup <组>
mangdel <组>	lp deletegroup <组>
mangaddi <甲组> <乙组>	lp group <甲组> parent add <乙组>
mangdeli <甲组> <乙组>	lp group <甲组> parent remove <乙组>
listgroups	lp listgroups
mangaddp <组> <权限>	lp group <组> permission set <权限> true
mangdelp <组> <权限>	lp group <组> permission unset <权限>
manglistp <组>	lp group <组> permission info
mangcheckp <组> <权限>	lp group <组> haspermission <权限>
mangaddv <玩家> prefix <值>	lp group <组> meta addprefix <优先级> <值>
mangaddv <玩家> suffix <值>	lp group <组> meta addsuffix <优先级> <值>
mangaddv <玩家> <变量> <值>	lp group <组> meta set <变量> <值>
mangdelv <玩家> <变量>	lp group <组> meta unset <变量>
manglistv <玩家>	lp group <组> meta info

mansave	lp sync
manload	lp sync

PermissionsEx与LuckPerm的对应等效指令

PermissionsEx 指令	LuckPerms 对应等效指令
pex	lp
pex reload	lp sync
pex toggle debug	lp verbose true
pex user <玩家> check <权限>	lp user <玩家> haspermission <权限>
pex backend	lp info
pex import <终端>	lp export <file> / lp import <file>
pex set default group <组>	(in the config file)

pex user <玩家> list	lp user <玩家> permission info
pex user <玩家> prefix	lp user <玩家> meta info
pex user <玩家> prefix <前缀>	lp user <玩家> meta addprefix <优先级> <前缀>
pex user <玩家> suffix	lp user <玩家> meta info
pex user <玩家> suffix <后缀>	lp user <玩家> meta addsuffix <优先级> <后缀>
pex user <玩家> delete	lp user <玩家> clear
pex user <玩家> add <权限> <世界>	lp user <玩家> permission set <权限> true global <世界>
pex user <玩家> remove <权限> <世界>	lp user <玩家> permission unset <权限> global <世界>
pex user <玩家> timed add <权限> <时间> <世界>	lp user <玩家> permission settemp <权限> true <时间> global <世界>
pex user <玩家> timed remove <权限> <时间> <世界>	lp user <玩家> permission settemp <权限> true <时间> global <世界>
pex user <玩家> set <选项> <值> <世界>	lp user <玩家> meta set <选项> <值> global <世界>

pex user <玩家> group list	lp user <玩家> parent info
pex user <玩家> group add <组> <世界>	lp user <玩家> parent add <组> global <世界>
pex user <玩家> group add <组> <世界> <时间>	lp user <玩家> parent addtemp <组> <时间> global <世界>
pex user <玩家> group set <组>	lp user <玩家> parent set <组>
pex user <玩家> group remove <组> <世界>	lp user <玩家> parent remove <组> global <世界>
pex groups list	lp listgroups
pex group <组> list	lp group <组> permission info
pex group <组> prefix	lp group <组> meta info
pex group <组> prefix <前缀>	lp group <组> meta addprefix <优先级> <前缀>
pex group <组> suffix	lp group <组> meta info
pex group <组> suffix <后缀>	lp group <组> meta addsuffix <优先级> <后缀>
pex group <组> create	lp creategroup <组>
pex group <组> delete	lp deletegroup <组>
pex group <组> parents list	lp group <组> parent info
pex group <组> parents set <parents>	lp group <组> parent add <parent>
pex group <组> add <权限> <世界>	lp group <组> permission set <权限> true global <世界>
pex group <组> remove <权限> <世界>	lp group <组> permission unset <权限> global <世界>
pex group <组> timed add <权限> <时间> <世界>	lp group <组> permission settemp <权限> true <时间> global <世界>
pex group <组> timed remove <权限> <时间> <世界>	lp group <组> permission settemp <权限> true <时间> global <世界>
pex group <组> set <选项> <值> <世界>	lp group <组> meta set <选项> <值> global <世界>

pex group <组> user add <玩家>	lp user <玩家> parent add <组>
pex group <组> user remove <玩家>	lp user <玩家> parent remove <组>
pex promote <玩家> <梯>	lp user <玩家> promote <梯>
pex demote <玩家> <梯>	lp user <玩家> demote <梯>

2017-08-05 14:12:00

INKDRRAK

Advanced Setup部分翻译
高级设置

简介：
LuckPerm总体来说虽然是相对简单的..
你可以利用插件的一些特点与内部规则来制定一个适合你服务器情况的高等权限系统！
分服务器权限&分世界权限：
LuckPerm本来是针对群组服的情况来工作的
但是你可以自定义一些只在特定子服/特定世界才生效的权限
* _$ O; ~6 i3 X5 `. ~% [9 k
配置中一些重要的选项说明：

# 服务器名称，用于上面讲到的分服务器的特定权限，该项设置为global即为禁用! b( z" m/ g* m
server: global

复制代码

该项为设置服务器的名称，如果要想设置特定服务器的权限，则需要通过修改server项来命名服务器
如果你愿意，同一个群组服是可以一起使用相同的服务器名的

# 玩家在此服务器上是否应该应用他们的全局组/权限 r' U9 D2 N" i" k3 W
include-global: true

复制代码

include-global选项也是非常重要的。
LuckPerm有两种体现方式，一是特定服务器的权限，二则是直接应用全局权限设置
如果这个选项被设置为 false，只有指定在此服务器的权限才会被应用。
如果上方的 "server" 选项设置为 global，请不要将其设置为 false。更多的有关服务器指定的权限可以在这里找到。
通过编辑更改这两个选项，你可以灵活的为每个服务器的权限组/权限做出意想不到的配合效果
示例
例子一：

server: global8 w8 y: P |8 C& S7 V" @
include-global: true

复制代码

/luckperms user Luck set minecraft.command.gamemode true 将应用
/luckperms user Luck set minecraft.command.gamemode true factions 不应用- t) e! ~. p1 M9 M% j: H

例子二：

server: lobby; z& s) ^/ R" J1 [
include-global: true

复制代码

/luckperms user Luck set minecraft.command.gamemode true 将应用
/luckperms user Luck set minecraft.command.gamemode true lobby 将应用; x4 }2 \( i4 }) F" ]

例子三：

server: bungeecord/ ]0 E/ Y L% \! m$ j# }
include-global: false

复制代码

/luckperms user Luck set minecraft.command.gamemode true 不应用
/luckperms user Luck set bungeecord.command.alert true bungeecord 将应用, l8 T; h7 {) c4 y

例子四

server: global
; V" E$ [1 ]6 ]- o2 C; u) b( D3 T' d
include-global: false

复制代码

没有任何权限将会应用！
如果没有设置服务器名字（server项设置为global）且全局设置未开启（include-global项设置为flase）
将不会有任何权限可以应用到服务器上！
权限计算

权限是根据优先级进行计算的，如下所示

服务器特定的权限是会覆盖通用/全局权限设置的
' N9 X. L: O" o5 K: e$ k0 O. }# ~

例如：有一个玩家，我们姑且叫他海螺，他拥有一个全局的“fly.use”（允许飞行）权限
然后在“factions”这个服务器上，取消了“fly.use”权限，服务器的特定权限设置将会覆盖全局设置
即，这个海螺在“factions”服务器上是无法使用“fly.use”权限的，他就不能够上天了
前提是海螺现在正在“factions”服务器上。

世界特定的权限也是会覆盖通用/全局权限设置的: {7 T) r0 E, H0 [9 b

例如：上文我们说的玩家“海螺”，他现在任然有一个全局的“fly.use”权限
然后在“world_nether”（地狱）世界，取消了“fly.use”权限，世界的特定权限设置将会覆盖全局设置
即，这个海螺在地狱就无法上天了（只要海螺在地狱世界）

临时权限将会覆盖非临时权限
' {. e/ G( e+ m" i0 g

例如：如果玩家海螺本来关闭了一个权限“test.node”
以此为基础，服务器给海螺设置新的临时权限“test.node”
海螺的临时权限则会覆盖本身关闭的权限，即海螺会在特定时间（临时权限）获得“test.node”权限

如果同时有两个节点相同、但时长不同的临时权限，时间较长的会覆盖时间较短的
更加具体的通配符权限将覆盖不具体的通配符权限
1 o0 |! q. J* O' M# h3 h

例如：一个用户拥有权限“luckperms.*”并且设置为true，但是“luckperms.user.*”权限却设置为false
那么所有玩家的权限都将被设置为false！
因为尽管“luckperm.*”有更加通用的通配符，但是他没有“luckperms.user.*”具体

继承权限将由对象自己的权限来重写" y- ], j% f. G& C I3 [# L/ r5 r

例如：一个玩家是默认权限组的成员，默认权限组有“some.thing.perm”权限
但是这个玩家又被以用户形式给予了权限“some.thing.perm”
继承而来的权限将会被玩家自己的权限给覆盖
临时权限

临时权限每间隔3s会检查一遍，检查临时权限的时限是否到期
不论同步间隔设置的怎么样，这个检查都会照常工作，这意味着你可以安全的设置临时权限在几秒后过期
他们将会在时限到期时被删除
速记权限
LuckPerms有他自己的速记权限系统，在这一点上，它非常类似PermissionsEx
它允许你使用速记格式来设置权限
例子：
例子一
使用LuckPerm的允许节点来作为例子，比如说，你想让一个用户组与用户权限设置/取消允许节点
如果没有速记，你就必须键入下面四个节点

luckperms.user.setpermission/ j, A2 N3 z, Z2 ^3 i
luckperms.user.unsetpermission
0 S. v6 Q" B1 P$ J$ e% q9 T, m
luckperms.group.setpermission* |- c6 [' \; K }
luckperms.group.unsetpermission

复制代码

但是，你要是使用速记，你就可以应用以下节点
luckperms.(user|group).(setpermission|unsetpermission)
你可以使用括号来让一个节点成为一个速记的权限组，然后用“|”来分隔他们
例子二
你可以使用“-”来创建字符范围，如果没有使用速记，则必须键入以下四个节点：

coolkits.kit.a/ D' t- [! }! u- @# p
coolkits.kit.b
( h7 O" `, H% p* \2 u
coolkits.kit.c
4 d; ]) Q# S; ~$ ^' ^8 k
coolkits.kit.d

复制代码

然而，使用了速记方法，你只需应用下面的节点：
coolkits.kit.(a-d)
例子三
你可以使用“-”来创建字符范围，如果没有使用速记，则必须键入以下四个节点：

prisonmines.teleport.1
' x, \" @3 u1 F
prisonmines.teleport.2
! s' t- M7 `( B
prisonmines.teleport.3- y( Y- Y: ]- k
prisonmines.teleport.4

复制代码

不过，你只要使用速记方法，这一切都会变得简单许多！你只需要应用下面的节点：
prisonmines.teleport.(1-4)
正则表达式

LuckPerms支持使用正则表达式来定义权限节点与服务器/世界的名字
当使用正则表达式的时候，必须添加前缀“R=”
所以LuckPerm才会知道将它是作为正则表达式来输出，而不是作为普通的字符串来输出
例如：你希望玩家可以创建两个组与权限系（tracks），通常只需要添加两个权限节点
然而使用正则表达式，你只需要添加一个权限节点 luckperms\.create.*
记住，转为任何字符，例如一个点，都将作为一个节点被系统解析

2017-08-06 15:56:00