Skip to main content

Managing VIPs

Below are the commands for managing VIP status in the system. The commands let you add, remove, view, and change the expiration of VIP status for users. All commands start with the !vips prefix.

Commands​

1. !vips add @username [duration]​

Grants VIP status to the specified user.

  • Arguments:
    • @username — the username (required).
    • [duration] — how long the VIP status lasts (optional). If no duration is specified, the VIP status is permanent.
  • Duration format:
    • Written as one string, without spaces.
    • Supported units:
      • m — minutes (e.g. 1m = 1 minute).
      • h — hours (e.g. 1h = 1 hour).
      • d — days (e.g. 1d = 1 day).
      • w — weeks (e.g. 2w = 2 weeks).
      • y — years (e.g. 2y = 2 years).
    • Combined format: e.g. 1h1d (1 hour and 1 day).
  • Examples:
    • !vips add @user123 — grants permanent VIP status to @user123.
    • !vips add @user123 2w — grants VIP status to @user123 for 2 weeks.
    • !vips add @user123 1h30m — grants VIP status to @user123 for 1 hour and 30 minutes.

vip-add.png

2. !vips remove @username​

Removes VIP status from the specified user.

  • Arguments:
    • @username — the username (required).
  • Example:
    • !vips remove @user123 — removes VIP status from @user123.

vip-remove.png

3. !vips list​

Shows a list of all users with VIP status and their expiration date (if applicable).

  • Arguments: none.
  • Example:
    • !vips list — outputs a list, for example: 
      Scheduled VIP expirations: @username (23 hours 59 minutes)

vip-list.png

4. !vips setexpire @username <duration>​

Sets or changes the VIP status expiration for the specified user.

  • Arguments:
    • @username — the username (required).
    • <duration> — how long the VIP status lasts (required, same format as the add command).
  • Examples:
    • !vips setexpire @user123 1d — sets VIP status for @user123 for 1 day.
    • !vips setexpire @user123 1h30m — sets VIP status for @user123 for 1 hour and 30 minutes.

vip-expire.png

Notes​

  • The duration in the !vips add and !vips setexpire commands must be written together (without spaces, e.g. 1h1d, not 1h 1d).
  • If no duration is specified in the !vips add command, the VIP status becomes permanent.
  • The username can be specified with or without @.
    • @username or username