- 欢迎来到Minecraft插件百科！
- 对百科编辑一脸懵逼？帮助:快速入门带您快速熟悉百科编辑！
- 因近日遭受攻击，百科现已限制编辑，有意编辑请加入插件百科企鹅群：223812289
LuckPerms：修订间差异
（→安装） |
（→选择存储类型） |
||
| 第191行： | 第191行： | ||
===选择存储类型=== | ===选择存储类型=== | ||
LuckPerms 插件带有很多存储数据的方式，你可以从中选择。 | |||
存储类型选项可以在 `config.yml` 或 `luckperms.conf` 文件中修改。 | |||
<pre> | |||
# Which storage method the plugin should use. | |||
# Currently supported: mysql, postgresql, sqlite, h2, json, yaml, mongodb | |||
# Fill out connection info below if you're using MySQL, PostgreSQL or MongoDB | |||
storage-method: h2 | |||
</pre> | |||
请记住如果你想改变存储类型的话，你的数据不会自动转移到新的存储库中。 | |||
要想手动在数据存储方式间转移数据的话，请查看[https://github.com/PluginsCDTribe/LuckPerms/wiki/Switching-storage-types 这里]来获得更多信息。 | |||
可用的选项都列在了下面。 | |||
'''H2 / SQLite''' | |||
默认的存储类型是 '''H2'''。 | |||
这两种文件类型都是以SQL数据库为基础的。 | |||
所有的数据都会存储在LuckPerms插件目录下的一个文件之中。 | |||
和YAML和JSON方式的不同之处在于，这个文件不能用文本编辑器打开。 | |||
你必须使用插件提供的命令才能编辑或查看数据。 | |||
如果你选择使用 H2 数据库的话（默认设置），所有的数据都会储存在 `luckperms-h2.mv.db` 文件中。 | |||
SQLite 类型所提供的存储文件是 `luckperms-sqlite.db`。 | |||
要想使用这两种类型中的一种，请将配置设置为： | |||
<pre> | |||
storage-method: h2 | |||
# or | |||
storage-method: sqlite | |||
</pre> | |||
'''JSON / YAML''' | |||
JSON 和 YAML 存储类型会将数据存储在可读可编辑的文本文件中。YAML 类型所提供的文件扩展名为 `.yml` ，JSON类型所提供的文件扩展名为 `.json`。 | |||
这两种类型的存储格式很相似，只是在一些句法上不同。 | |||
'''''示例 YAML 文件''''' | |||
<pre> | |||
uuid: c1d60c50-70b5-4722-8057-87767557e50d | |||
name: Luck | |||
primary-group: default | |||
permissions: | |||
- group.default: | |||
value: true | |||
- test.permission: | |||
value: true | |||
server: factions | |||
- other.test.permission: | |||
value: false | |||
</pre> | |||
'''''示例 JSON 文件''''' | |||
<pre> | |||
{ | |||
"uuid": "c1d60c50-70b5-4722-8057-87767557e50d", | |||
"name": "Luck", | |||
"primaryGroup": "default", | |||
"permissions": [ | |||
{ | |||
"group.default": { | |||
"value": true | |||
} | |||
}, | |||
{ | |||
"test.permission": { | |||
"value": true, | |||
"server": "factions" | |||
} | |||
}, | |||
{ | |||
"other.test.permission": { | |||
"value": false, | |||
"server": "test" | |||
} | |||
} | |||
] | |||
} | |||
</pre> | |||
要想使用这两种类型中的一种，请将配置设置为： | |||
<pre> | |||
storage-method: yaml | |||
# or | |||
storage-method: json | |||
</pre> | |||
'''MySQL / PostgreSQL''' | |||
储存在 MySQL 类型和 PostgreSQL 类型中的数据格式上与上文提及的 H2/SQLite 类型相同，但是数据是储存在远程服务器上的。 | |||
这意味着你可以跨服分享相同的数据。 | |||
你需要在配置文件中输入你数据库服务器的地址，端口，数据库名，用户名和密码。 | |||
这种类型推荐要存储大量数据的用户，或是想要搭建群组服务器的用户所使用。 | |||
如果你已经在运行群组服务器，并且想要在子服务器之间同步数据的话，你就必须选择这种类型了。 | |||
格式布局示例在[https://github.com/PluginsCDTribe/LuckPerms/tree/master/common/src/main/resources 这里]。 | |||
要想使用这两种选项中的一种，请将配置设置为： | |||
<pre> | |||
storage-method: mysql | |||
# or | |||
storage-method: postgresql | |||
</pre> | |||
'''MongoDB''' | |||
LuckPerms 也支持 MongoDB 类型的存储，它也是一种远程数据库，在有些方面上和 MySQL 相似。 | |||
这种类型也只会被一小部分的用户所使用。 | |||
要想使用这种类型的存储，请将配置设置为： | |||
<pre> | |||
storage-method: mongodb | |||
</pre> | |||
===使用教程=== | |||
2017年8月7日 (一) 06:22的版本
欢迎来到 LuckPerms wiki。这里你将会找到本插件的完整的使用文档，包括了安装、设置、配置和如何高效的使用 LuckPerms。
从何开始?
如果您从未使用过任意权限插件，我推荐你从头开始看。
基础都在[使用教程]页面。
完整的命令使用在[命令使用]页面。
什么也没找到?
如果你有更多的问题是这篇Wiki没有解决的，你可以通过以下几种方式联系我。
- [Discord 服务器] (就算我不在，也有很多人帮助你!)
- 在 irc.esper.net 我是 "Luck"，我也在 irc.spi.gt 和 chat.freenode.net
- 在 SpigotMC 和 Sponge 论坛我是 "Luck"
- 在[GitHub]提交一个 issue (如果你要提交一个BUG，这是最好的方式)
一些有用的链接
为什么选择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]。
他可以实时监视并检测其他插件所需的权限，就像下面示例的动态图那样：【图片过大 请去wiki页面查看】
你也可以把录像上传到网上，方便查看、分析和阅读：
权限树系统
LuckPerm允许你在服务器所有已知权限上建立编写"权限树"。
权限树上的数据是由你所有的插件在服务器注册的权限构成的。
随着你服务器运营时间的增长，因为服务器添加了许多插件，它们都会注册权限，这些数据都会被纳入权限树中。
这是个清真的例子 [https://git.io/vQiti]。 你看到的权限树的颜色，代表了你的玩家是否拥有对应的权限，这一机制很方便的让你查阅到服务器的相应权限。
这还是那个清真的例子 [[1]]
指令界面&TAB补全
LuckPerm的指令系统被我设计的尽可能便捷、易用、人性化，
这样一来，你除了查阅LuckPerm的[大量相关帮助文档]，还可以在游戏中查看指令用法、以及指令列表。
LuckPerm的所有指令皆可使用TAB补全功能，这就意味着，你可以通过输入更少的指令来完成你的工作！
这是不是在一定程度极大地提高了你的工作效率呢？就像下面那样：
网站编辑器
除了使用指令来编辑服务器权限相关，LuckPerm还提供了更加便捷的编辑方式，
你可以使用Web网站编辑器来对服务器的权限数据进行快速更改，
任何人都能够使用网站编辑器，不论你使用了哪种存储方式！
网站编辑功能非常容易使用，且易于上手
【图片过大 请去wiki页面查看】
行为记录仪
为了防止服务器中出现心存不轨的管理员，想要私自给自己添加权限，
LuckPerm详细的记录了服务器各类权限的微小变化，
你可以通过行为记录仪来搜索每个人的详细操作。
你也可以查看所有东西的详细历史。
安装
安装
初始设置
1. 下载适合你平台的 `LuckPerms-???-x.x.x.jar` 文件。你可以点这里查看最新的版本。
2. 打开你的 Mod 或插件所在路径，这路径通常要么是 `/server/plugins/` ，要么是 `/server/mods/`。
然后把 LuckPerms 的 jar 文件放入文件夹中。
3. 请完全关闭你的服务器，然后再打开，这会生成默认配置。
4. 完全关闭你的服务器，打开配置文件。配置文件的位置在 `/plugins/LuckPerms/config.yml` 或 `/config/luckperms/luckperms.conf`。
5. 请浏览配置文件，然后根据你的服务器修改设置，尤其是请注意存储相关设置。
6. 再次开启你的服务器。
你可以更改配置文件中的很多内容，文件有很细节化的注释，每个设置的作用注释中都解释的很清楚。
需求
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` 文件中的配置选项就好了。
更多相关于存储类型的有关信息请阅读[下一节]
选择存储类型
LuckPerms 插件带有很多存储数据的方式，你可以从中选择。
存储类型选项可以在 `config.yml` 或 `luckperms.conf` 文件中修改。
# Which storage method the plugin should use. # Currently supported: mysql, postgresql, sqlite, h2, json, yaml, mongodb # Fill out connection info below if you're using MySQL, PostgreSQL or MongoDB storage-method: h2
请记住如果你想改变存储类型的话，你的数据不会自动转移到新的存储库中。
要想手动在数据存储方式间转移数据的话，请查看这里来获得更多信息。
可用的选项都列在了下面。
H2 / SQLite
默认的存储类型是 H2。
这两种文件类型都是以SQL数据库为基础的。
所有的数据都会存储在LuckPerms插件目录下的一个文件之中。
和YAML和JSON方式的不同之处在于，这个文件不能用文本编辑器打开。
你必须使用插件提供的命令才能编辑或查看数据。
如果你选择使用 H2 数据库的话（默认设置），所有的数据都会储存在 `luckperms-h2.mv.db` 文件中。
SQLite 类型所提供的存储文件是 `luckperms-sqlite.db`。
要想使用这两种类型中的一种，请将配置设置为：
storage-method: h2 # or storage-method: sqlite
JSON / YAML
JSON 和 YAML 存储类型会将数据存储在可读可编辑的文本文件中。YAML 类型所提供的文件扩展名为 `.yml` ，JSON类型所提供的文件扩展名为 `.json`。
这两种类型的存储格式很相似，只是在一些句法上不同。
示例 YAML 文件
uuid: c1d60c50-70b5-4722-8057-87767557e50d
name: Luck
primary-group: default
permissions:
- group.default:
value: true
- test.permission:
value: true
server: factions
- other.test.permission:
value: false
示例 JSON 文件
{
"uuid": "c1d60c50-70b5-4722-8057-87767557e50d",
"name": "Luck",
"primaryGroup": "default",
"permissions": [
{
"group.default": {
"value": true
}
},
{
"test.permission": {
"value": true,
"server": "factions"
}
},
{
"other.test.permission": {
"value": false,
"server": "test"
}
}
]
}
要想使用这两种类型中的一种，请将配置设置为：
storage-method: yaml # or storage-method: json
MySQL / PostgreSQL
储存在 MySQL 类型和 PostgreSQL 类型中的数据格式上与上文提及的 H2/SQLite 类型相同，但是数据是储存在远程服务器上的。
这意味着你可以跨服分享相同的数据。
你需要在配置文件中输入你数据库服务器的地址，端口，数据库名，用户名和密码。
这种类型推荐要存储大量数据的用户，或是想要搭建群组服务器的用户所使用。
如果你已经在运行群组服务器，并且想要在子服务器之间同步数据的话，你就必须选择这种类型了。
格式布局示例在这里。
要想使用这两种选项中的一种，请将配置设置为：
storage-method: mysql # or storage-method: postgresql
MongoDB
LuckPerms 也支持 MongoDB 类型的存储，它也是一种远程数据库，在有些方面上和 MySQL 相似。
这种类型也只会被一小部分的用户所使用。
要想使用这种类型的存储，请将配置设置为：
storage-method: mongodb