#Class: Permission

Defined in: sapi/runtime/permission.ts:16

权限等级（与 Minecraft 原生 PlayerPermissionLevel 对齐）：

• Guest = -1：访客以下（仅作内部占位，不参与常规比较）
• Any = 0：任意玩家 / 访客（Visitor）
• Member = 1：普通成员（Member）
• OP = 2：管理员（Operator）
• Admin = 3：自定义 / 脚本高级管理员（Custom）

#Constructors

#Constructor

new Permission(): Permission;

#Returns

Permission

#Methods

#register()

static register(name: string, level: number): void;

Defined in: sapi/runtime/permission.ts:38

注册命名权限及其满足所需的最低等级。

#Parameters

#Returns

void

#clearRegistry()

static clearRegistry(): void;

Defined in: sapi/runtime/permission.ts:43

清空命名权限表（仅供测试沙箱环境清理使用）。

#Returns

void

#entries()

static entries(): {
  name: string;
  level: number;
}[];

Defined in: sapi/runtime/permission.ts:52

获取已注册命名权限的只读快照列表（沙箱装载清单及管理界面使用）。

#Returns

{ name: string; level: number; }[]

按权限名称字母序排列的权限项列表。

#check()

static check(player: string | Player, permissionName: string): boolean;

Defined in: sapi/runtime/permission.ts:65

检查玩家是否满足指定的命名权限；未注册的权限默认拒绝。

#Parameters

#Returns

boolean

若玩家权限等级大于或等于所需等级则返回 true，否则返回 false。

#getPermission()

static getPermission(player: Player): number;

Defined in: sapi/runtime/permission.ts:82

计算玩家的当前有效权限等级。优先读取平台配置文件中的覆盖项，否则映射原生 PlayerPermissionLevel。

#Parameters

#Returns

number

玩家当前的有效权限等级数值。

#formatRegistry()

static formatRegistry(): string;

Defined in: sapi/runtime/permission.ts:91

按等级分组格式化已注册权限，供 /c:help permissions 展示。

#Returns

string

#Properties