Studios
Queuehouse-3.jpg

Installation

SoonQueueStandalone
PAGE 02 OF 06  ·  OVERVIEW → INSTALLATION → CONFIGURATIONdocs.glitchstudios.dev
Browse docs

Requirements#

The server

Framework qbx_core (Qbox) is what the resource is built for, and it was tested with qbx_core 1.24.0. The queue also runs without qbx_core.
Server A FiveM artifact with OneSync.
server.cfg set qbx:enableQueue "false" when you run qbx_core. Its own queue would otherwise run next to this one.
Database None.

Optional

glitch-admin Discord role lookup by role name, and an admin panel for the staff exports.
glitch-photos A CDN for the card pictures, so each card carries short links.
Discord bot Only for the built-in discord role provider. The bot must be in your guild with the Server Members intent.
Python 3 with Pillow Only to redraw the card pictures after you change roles, labels or colours.

Installation steps#

  1. Put the glitch-queue folder in your resources folder. The folder name is case-sensitive.

  2. There are no items and no SQL to install. The card pictures are already in images/pass.

  3. Add to server.cfg, and start the queue before players can connect:

    set qbx:enableQueue "false"
    ensure glitch-queue
    
  4. Open config/main.lua. Set Config.Card.Title, Config.Card.Destination and Config.Card.Buttons, and replace the example entries in Config.Priority.

  5. Choose where Discord roles come from with Config.RoleProvider (see Configuration).

  6. Replace images/banner.png with your own logo, under 50 KB, then restart the resource.

If you use the discord provider, also add your guild id and bot token to server.cfg:

set glitchqueue_discord_guild "YOUR_GUILD_ID"
set glitchqueue_discord_token "YOUR_BOT_TOKEN"

Keep that token out of any file you share.

Permissions#

Founders are matched by ace. Give the ace to the people who should skip the line:

add_ace group.founder founder allow
add_principal identifier.discord:YOUR_DISCORD_ID group.founder

The ace name is whatever Config.SkipAce is set to (founder by default).

Updating#

Replace everything except config/main.lua, config/local.lua and any pictures you changed in images/, then compare your config with the new one for added keys. Restart the resource when the server is quiet, because a restart makes the queue forget who is still loading in.