Status Role
Get started with status roles.
Introduction
You are able to specify time requirements (hours/minutes) for time-based roles, choose whether roles persist after status changes, and configure multiple roles per status string. The system also supports archiving configurations to temporarily disable them without deletion.
Parameters Table
status-string
The status text to allow the app to check for.
type
The type of assignment for roles whether instant (instant addition of roles) or time-based (users are required to have the status for a set amount of time to receive roles).
type (2)
Opt for 'Inactive configurations' to remove setups that haven't been used for a specified period, keeping your active rules streamlined. Select 'Archived configurations only' to permanently delete settings you've previously marked for archived. For a complete reset, choose 'All configurations', which will wipe every custom status role setup from your server.
roles
The roles to assign (can be more than 1).
match-type
Whether to check for an exact match of the status string or to look for the status string in a user's status.
hours
The amount of hours required for time-based roles.
minutes
The amount of minutes required for time-based roles.
keep-roles
Whether to keep the roles when a user receives it after they have removed a custom status.
remove-roles
Whether to remove the roles of users who have the currently configured status string when a status role configuration is being removed.
inactive-days
Days the status string has been inactive for.
Status Role Setup
You may use /status setup
for a quick and easy configuration.
/status create (status-string) (type) (roles) [match-type] [hours] [minutes] [keep-roles]
Example Usage


Checking Status Role Configurations
/settings
Example Usage

/status list
Example Usage

Editing Status Role Configurations
/status edit (status-string) [type] [roles] [match-type] [hours] [minutes] [keep-roles]
Example Usage

Synchronizing Status Roles
Confirmation is required for this action.
/status sync-roles [status-string]
Example Usage


Removal of Status Role Configurations
Confirmation is required for this action.
/status remove-status (status-string) (remove-roles)
Example Usage


Status Role Configurations Cleanup
Confirmation is required for this action.
/status cleanup (type2) [inactive-days] [remove-roles]
Example Usage


Advanced Configurations
You can temporarily disable your configurations without deleting them, using the archiving feature. This works hand-in-hand with robust permission management, allowing you to precisely control who can access status-based features.
With whitelist and blacklist management, you can easily define specific users or roles permitted to access these functionalities.
ArchivePermission ModesLast updated