LuckPerms Mirai
View Plugin Site: https://mirai.mamoe.net/topic/68/
不支持在 Android 系统上运行
Snapshot
Install
Way 1. By MCL: mcl --update-package io.github.karlatemp:luckperms --channel nightly --type plugin
Way 2. Download release from Releases. Then put it into plugins
Usages
LuckPerms-Mirai 基于 LuckPerms 开发, 详细用法请百度/谷歌/阅读 LuckPerms wiki
LuckPerms-Mirai 的身份上下文使用 context 实现, 可以在聊天中使用
/lp user <****> info 查看上下文
下面是一些示例命令
// 授予群聊管理员(包含群主)一项权限
/lp group default permission set AdminPermission admin=true
// 授予群主一条权限
/lp group default permission set OwnerPermission level=owner
// 授予管理员(不含群主)一条权限
/lp group default permission set OwnerPermission level=admin
// 授予在某个群的所有人一条权限
/lp group default permission set PermissionInGroup group=1234567890
// 授予某个群的群聊管理员一条权限
/lp group default permission set PermissionInGroup group=1234567890 admin=true
// 创建系统管理组
/lp creategroup root
/lp group root permission set *
/lp user 1234567890 parent set root
// 开启权限调试模式 (debug(verbose) mode)
// WARNING: Dont run this command in chatting
/lp verbose on
// 开启权限调试模式 (debug(verbose) mode), 并在 Web 查看
/lp verbose record
//WAIT.....
/lp verbose upload
实现细节
对于 Mirai-Console Permission System. Permission有以下内容
- Permission本身
- Permission的父Permission
对于 Mirai-Console Built-In PermissionSystem. 他会有以下行为
- 如果可以拥有权限的对象(
Permittee) 拥有Permission或者Permission的任何一级parent, 那么代表此Permittee拥有这个权限
对于 LuckPerms-Mirai, 会有以下行为
- 获取当前权限节点状态
- 如果权限节点是已设置的, 返回该权限节点的状态
- 如果当前节点已经是 Root 权限节点, 中断, 判断为没有权限
- 重新检查该权限节点的parent
- 特别的,
Console拥有全部权限
LuckPerms 采用拦截式的权限判断.
- 设: 当前需要判断的权限对象拥有的权限为
*=true,deny=false - 那么该对象拥有除了
deny之外的全部权限
Dev
特别权限节点
LuckPerms Mirai 提供了一些特别的权限节点(权限ID), namespace:id 在对应代码中为 PermissionId(namespace, id)
- 对于
*:*, LuckPerms-Mirai会直接识别成*, 代表 ROOT - 对于
<lp>:%, LuckPerms-Mirai 会直接返回true, 代表没有权限检查<lp>.<void>与<lp>.%拥有相同效果
- 对于
namespace:(PermissionId(namespace, "")), LuckPerms-Mirai 会识别成namespace而不是namespace. - 对于
<lp>.<console>, 只有控制台拥有该权限, 将执行权限设置成<lp>.<console>可确保只有 Console 可执行 - PermissionService#register
- 对于 parentId为
<lp>:#的权限, LuckPerms-Mirai 将直接提供权限节点并不进行任何注册检查, 父权限指定
- 对于 parentId为
如何使用
- 正常接入Mirai-Console Permission System即可