Skip to content

Module GunMenu

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

VIP_GunMenu

A free loadout each round — a primary, a pistol or both — from the Gun menu page of !vip. Kind: feature — key vip.gun_menu. Requires VIPCore 1.2.0+.

Commands

Command Aliases Permission Description
!gunmenu !guns, !gm None Open the Gun menu

Also under !vip → Gun menu. Not in warmup. Opening the page is free; each loadout given is one use. See Menus.

The page

Row Shows
Primary The primaries on offer. Pick one, or pick it again to clear
Pistol The pistols on offer
Loadout What is picked, and whether it replaces or adds to the guns held
Give loadout Gives the picked guns. Off when nothing is picked, the player is dead, no uses are left or the window has closed
Closes in Time left until the window closes

The last loadout taken on the map is picked in advance.

Configuration

addons/swiftlys2/configs/plugins/VIP_GunMenu/config.jsonc. Restart after editing.

{
  "GunMenu": {
    "CommandAliases": [
      "guns",
      "gm"
    ],
    "DisableCommandAfterRoundStarts": true,
    "CommandDisableDelayAfterRoundStarts": 20
  }
}
Setting Default Description
CommandAliases ["guns", "gm"] Other names for !gunmenu. [] = none. The first is named on Perks
DisableCommandAfterRoundStarts true Close the window a while after the round starts. false = open all round
CommandDisableDelayAfterRoundStarts 20 Seconds after the round starts until the window closes

Group settings

In a group's Values in vip_groups.jsonc. These apply on save.

{
  "vip_groups": {
    "Groups": {
      "PREMIUM": {
        "Values": {
          "vip.gun_menu": {
            "MaxUsesPerPlayerPerRound": 5,
            "GivePrimariesOnPistolRound": true,
            "AvailablePrimaryGuns": [
              {
                "DisplayName": "AWP",
                "WeaponName": "weapon_awp",
                "Category": "Sniper"
              },
              {
                "DisplayName": "AK-47",
                "WeaponName": "weapon_ak47",
                "Category": "Rifle"
              }
            ]
          }
        }
      }
    }
  }
}
Setting Default Description
GivePrimariesOnPistolRound false Offer primaries on pistol rounds
GiveSecondariesAfterPrimaries true Offer pistols beside primaries. false = pistols only when no primaries are offered
ReplaceCurrentWeapons true A gun replaces the one in its slot. false = added
MaxUsesPerPlayerPerRound 3 Loadouts per round. 0 = none
AvailablePrimaryGuns 6 guns The primaries on offer. Missing or [] = AWP, AK-47, M4A4, M4A1-S, SSG 08 and P90
AvailableSecondaryGuns 9 pistols The pistols on offer. Missing or [] = every pistol but the Dual Berettas

A pistol round is the first round of each half and of each overtime half.

Gun fields

Field Default Description
DisplayName "AK-47" Name on the page
WeaponName "weapon_ak47" Weapon classname
Category "Rifle" Rifle, Sniper, SMG, Heavy or Shotgun for a primary, Pistol for a pistol

Troubleshooting

Problem Cause Solution
!gunmenu does nothing Warmup, or the player isn't VIP or has the perk off Expected
Wait for next round for gun menu to be available No uses left, or the window has closed Expected
No primaries on the page A pistol round, with GivePrimariesOnPistolRound off Expected, or set it true
A gun is added next to the old one instead of replacing it Its Category isn't one of the listed values Fix the Category
A changed alias doesn't work Aliases are read only at start Restart

Clone this wiki locally