Permission Levels¶

PermissionLevel is an ordered enum that wraps PRC permission strings so you can compare player roles in code without hardcoding string values. Player and StaffMember models expose a .permission_level property that returns a PermissionLevel — use it for ordered comparisons like >= PermissionLevel.MOD instead of comparing raw strings.

Import¶

from erlc_api import PermissionLevel

Levels¶

Enum	Display
`PermissionLevel.NORMAL`	`Normal`
`PermissionLevel.HELPER`	`Server Helper`
`PermissionLevel.MOD`	`Server Moderator`
`PermissionLevel.ADMIN`	`Server Administrator`
`PermissionLevel.CO_OWNER`	`Server Co-Owner`
`PermissionLevel.OWNER`	`Server Owner`

Model Integration¶

Player.permission and StaffMember.role stay strings. Use enum properties for comparisons:

player = (await api.players())[0]

if player.permission_level >= PermissionLevel.MOD:
    print("staff-level player")

Filters accept either strings or enum values:

from erlc_api.filter import Filter

admins = Filter(players).permission_at_least(PermissionLevel.ADMIN).all()

Common Mistakes¶

Comparing raw strings with >=.
Assuming unknown permission text raises; unknown values parse as NORMAL.
Treating this enum as PRC authorization. It is a local model helper.

Previous Page: Commands Reference | Next Page: Function List