Game systems

VIP and premium passes in your game

How the ready-made iDos Games VIP system works - premium passes with benefits, a free trial, discounts and bonus rewards across the game - and how to set it up in the dashboard.

Updated: Русский

Premium is a ready-made VIP system: passes with benefits that the player buys for game currency, with a timer and a one-time free trial. The server applies the benefits everywhere by itself: discounts in the store, bonus rewards, VIP prizes in events and the season.

What the player sees

  • Every pass, lowest tier first: name, benefits and duration.
  • A free trial once per pass, with a badge on the tab while it waits.
  • A timer of the active pass and "Extend".
  • Buying for currency or items; a pass for real money is sold through the platform checkout.
VIP
12 450
320
VIP Bronze
7 days

-10% in the shop · +20% rewards · daily gems

Free trial
300
VIP Gold
Active · 12d 04:10

-25% in the shop · x2 rewards · VIP prizes in events

Extend · 900
Every pass with its benefits and duration; a one-time free trial.
An active pass shows its timer and is extended for currency.
Example. The VIP screen: passes, a free trial and an active pass with its timer.

How it works

  • A pass has a tier: the higher tier wins when the player holds several.
  • Benefits are applied by the server: discounts and bonuses in the store, a second prize on milestones of events and tiers of the season.
  • Events and the season send the player to the VIP screen with the right pass marked.

Step 01Add the system to your project

Ask the AI coder: "Add a VIP pass". It installs the ready system; the tab appears for players once a pass is set up.

Step 02Set it up in the dashboard

Open the dashboard, pick your project and go to Live Operations → v2 → Premium.

  • Create a pass: name, tier, duration, benefits and price options.
  • Turn on the free trial if you want one.

The AI button on the page opens an assistant: describe what you need, it proposes changes, and you review them and press Save.

Step 03Test and release

Check the system in the test version of your app. Settings go to the live app as a separate action - see publishing and links.

For developers

VIP works through client.premium in @idosgames/core. Discounts and bonuses need no code: the server applies them in every purchase and claim.

TypeScript
// Passes of the title (config) and the player's VIP state
const defs = await client.premium.getDefinitions()
await client.premium.getUserState()
const vip = client.data.user.state?.Premium
vip?.MaxActiveTier // the best active tier, 0 without VIP
vip?.Subscriptions?.['vip_gold']?.ExpirationDate // check the date, not just the key
  • A used trial stays used: the trial list is in ActivatedTrialIDs, do not offer it again.
  • What was actually charged and granted is in the response of a purchase, not in the base price.

Every field is described in the premium-system skill, served by the SDK MCP server.

Frequently asked questions

Can VIP be sold for real money?

Yes, through the platform checkout. The VIP screen itself sells passes for game currency and items.

Do I have to code the discounts?

No. The server applies premium discounts and bonuses in the store and in rewards by itself.

See also

Make your own game

Describe the idea in a sentence - the AI coder builds it, and it goes live at its own link.