Skip to content

VIP Groups

Jump to bottom
shmitzas edited this page Nov 10, 2026 · 2 revisions

VIP Groups

vip_groups.jsonc (in addons/swiftlys2/configs/plugins/VIPCore/) lists the groups and the features each grants. A player gets the features of their active group, the heaviest one they hold.

  • The first start writes the file with no groups.
  • A feature is granted by its key in Values. A value of 0 grants it too — delete the key to take it away.
  • 1 grants a feature with its module's defaults; an object sets them.
  • Group names and feature keys are matched ignoring case.
  • Feature settings apply on save; some modules read them when the player joins. A feature added to or removed from a group reaches a player when they next join.
  • Restart after adding, removing or renaming a group, or changing a Weight.

Default file

{
  "vip_groups": {
    "Groups": {}
  }
}

Fields

Field Default Description
Weight 0 Rank among groups. The higher wins when a player holds several
Values {} The features the group grants, by key — Modules

The Perks page lists a group's features in the order Values names them.

Example

{
  "vip_groups": {
    "Groups": {
      "VIP": {
        "Weight": 10,
        "Values": {
          "vip.health": {
            "Health": 120
          },
          "vip.armor": {
            "Armor": 100
          },
          "vip.bhop": 1
        }
      },
      "PREMIUM": {
        "Weight": 20,
        "Values": {
          "vip.health": {
            "Health": 150
          },
          "vip.armor": {
            "Armor": 100
          },
          "vip.bhop": {
            "Timer": 0,
            "MaxSpeed": 0
          },
          "vip.zeus": 1
        }
      }
    }
  }
}
Group Gets
VIP 120 HP, armor, and bhop from 5 s after spawn, up to 300 u/s
PREMIUM 150 HP, armor, bhop from spawn with no speed cap, and a Zeus

Several groups

A player can hold several groups, each a grant of its own. Only the active group's features apply; they don't add up. The active group is:

  1. the one with the highest Weight;
  2. on a tie, one granted on this server over a global one;
  3. then the first by name, A to Z.

A player holding VIP and PREMIUM above gets PREMIUM's features. When PREMIUM ends, VIP's take over.

A group that a grant names but vip_groups.jsonc doesn't define gives no features, and the console warns Group 'VIP' not found in config for user ….

Clone this wiki locally