这是一个可选插件,为 Allay 的 PlaceholderAPI 提供了 LuckPerms 的变量支持。
- 从 Release 下载 .jar 文件。
- 将其放入 plugins 文件夹中。
- 重启服务器即可!
对于带有 参数 (argument) 的变量,必须在变量末尾添加参数,并用下划线 (_) 分隔。
示例:
变量 {luckperms|meta} 需要一个 <meta key> 参数。假设键名为 home,完整的变量应为:{luckperms|meta_home}。
基础信息:
- {luckperms|prefix} - 返回玩家的前缀
- {luckperms|suffix} - 返回玩家的后缀
- {luckperms|primary_group_name} - 返回玩家的主组名称
Meta 元数据与 Context 上下文:
- {luckperms|meta_<key>} - 返回指定键的单个元数据值
- {luckperms|meta_all_<key>} - 返回指定键的所有分配值
- {luckperms|context} - 返回玩家当前所有的上下文(若提供键名则返回对应值)
权限检查:
- {luckperms|has_permission_<permission>} - 检查玩家是否直接拥有该权限
- {luckperms|inherits_permission_<permission>} - 检查玩家是否继承了该权限
- {luckperms|check_permission_<permission>} - 执行完整的权限检查并返回结果
分组与权重:
- {luckperms|groups} - 返回玩家直接继承的分组列表
- {luckperms|inherited_groups} - 返回玩家所有继承的分组列表(含间接继承)
- {luckperms|in_group_<group>} - 玩家是否直接属于该组
- {luckperms|inherits_group_<group>} - 玩家是否属于该组(含间接)
- {luckperms|highest_group_by_weight} - 玩家权重最高的直接分组
- {luckperms|highest_inherited_group_by_weight} - 玩家权重最高的继承分组
轨道 (Track) 相关:
- {luckperms|current_group_on_track_<track>} - 玩家在指定轨道上的当前组
- {luckperms|next_group_on_track_<track>} - 玩家在指定轨道上的下一组(晋升目标)
- {luckperms|previous_group_on_track_<track>} - 玩家在指定轨道上的前一组(降级目标)
过期时间:
- {luckperms|expiry_time_<permission>} - 直接分配给玩家的临时权限剩余时间
- {luckperms|group_expiry_time_<group>} - 直接分配给玩家的临时分组剩余时间
有关前缀堆叠等高级配置,请参考 LuckPerms Wiki。