GKSHOP
GKS Companion

Dashboard management

Manage Companion servers, cards, features, and daily resets at app.gkshop.org.

Open app.gkshop.org/companion, sign in with Discord, and select a server. The page is also under Services → Companion Collectibles.

This is the server owner's panel. Streamers configure their channel in Twitch; viewers use the Twitch overlay. Neither needs your owner dashboard access.

Account and server access

Use the Discord account that registered the server. If Companion is unavailable, check your account and the Discord roles granting access to that category. A server registered to another account cannot be claimed by registering its ID again.

Use Add server for new registrations; follow Installation for the endpoint and phone configuration.

Server name and features

The edit button beside the server selector changes the display name shown to streamers. It does not change the server ID.

The News, Social, and Collectibles toggles control the available features. Select Save features to apply changes. News and Socials content comes from FiveM; this panel does not compose posts or comments.

Companion enabled controls the whole integration. Disabling Companion or Collectibles cancels active Drops without awarding a pack.

Timezone and daily limits

Choose an IANA timezone, e.g. Europe/Istanbul, then Save timezone. Daily Pack and Drop limits follow this server-local day, not the viewer's computer clock.

  • New registrations default to UTC.
  • A server without a timezone needs one before rewards and character pairing can work.
  • Changing an existing timezone is scheduled for the next midnight in the current timezone; saving does not reset daily limits immediately.

News and Socials do not require a reward timezone.

FiveM pairing credential

In FiveM pairing credential:

  1. Select Generate credential for initial setup or credential replacement.
  2. Use Copy server config and update Config.Companion in LUA/config/config.lua.
  3. Restart the phone resource before pairing again.

A replacement invalidates the old credential immediately. The new value is shown only once. Copy it privately and update the server. This credential is not the short game code generated in Twitch Configuration.

Card pool

Select Add card, or edit an existing card:

FieldPurpose
Card nameName shown in the collection.
Base edition image URLRequired artwork.
Foil edition image URLOptional; blank reuses base artwork.
Gold edition image URLOptional; blank reuses base artwork.
Card raritycommon or ultra, separate from the Base/Foil/Gold edition.
Active in pack poolWhether this card can appear in future pack openings.

Upload artwork to an approved media host, then paste its public HTTPS image URL. Currently supported host families are subdomains of gkshop.org and fivemanage.com; arbitrary external image hosts are rejected. Do not paste a dashboard URL, local path, or private download link.

Recommended artwork size: 569 × 800 px. WebP can preserve transparent pixels outside rounded borders. White space in the source image remains visible until removed or made transparent.

Keep at least three different active cards. Editions of one card do not count as different cards. Each pack selects three distinct card IDs; too few available cards prevents opening without consuming the pack. Cards already owned can appear in later packs.

Points: Base 5, Foil 50, Gold 500, plus 5,000 for ultra rarity. Edition probabilities are controlled by the reward system, not the artwork URLs.

Deleting a card removes viewers' copies, its showcase entries, and its score contribution. To stop future draws while preserving owned copies, turn off Active in pack pool instead.

Reset leaderboard

Reset leaderboard clears scores and tie-break statistics and deletes unopened packs. It preserves owned cards, showcases, daily viewing progress, daily Drop limits, and active Drops. Cards earned before the reset remain in collections but do not carry their previous score into the new leaderboard.

Delete a server

The delete button beside the selector requires typing the server ID. It permanently removes the registration and Companion data: cards, collections, showcases, leaderboard scores, packs, and Drop history.

Use Companion enabled to pause the integration instead. Server deletion cannot be undone.

On this page