Skip to content

QING — Venues

One-line pitch: A QING is a venue — part chatroom, part marketplace, part members-only club. Every QING wraps a token and gives it a location.

What this is

A QING is the game's unit of place. Every QING:

  • Wraps a real underlying token (DAI, an NFT project's token, a meme coin, another QING — anything). Holders of that token get special status here.
  • Lives at a unique coordinate (Waat) on the MAP.
  • Has an entry fee (CoverCharge), a guest list with 1-day passes, and bouncers who control access.
  • Supports chat — members speak via Chat(myLAU, "msg"), and those messages are logged through VOID for everyone to see.
  • Lets big holders of its underlying token become moderators automatically.

If you've been to a Discord server with role-gated channels, you already understand a QING.

If you've played a web3 game before

  • Closest analogy: a token-gated Discord channel — hold the token, walk in; don't, get bounced.
  • Or: a Uniswap LP as a social space — wrapped around an underlying asset, with activity generating value.
  • Or: a Club Penguin room with a cover charge.
Dysnomia term What it maps to
Waat This venue's map coordinates
Asset The token this QING wraps
Cover Charge Entry fee paid in Asset
Guest List (_list) 1-day passes — expires 24h after you Join
Bouncer A moderator who can configure the venue
Staff Addresses explicitly marked as staff (always authorized)
CROWS Holding 25+ CROWS auto-qualifies you as a bouncer
GWAT A flag indicating this QING is a derivative / personal fork

What you actually do with it

  • Join — QING.Join(myLAU). Pays the cover if required, writes you to the guest list for 24h.
  • Chat — QING.Chat(myLAU, "hello"). Must be admitted. Earns MAI if you hold the venue's asset.
  • Stay — once joined, you're admitted for 24h. Re-pay cover after that.
  • Bouncer actions (if you qualify) — setCoverCharge, setBouncerDivisor, setStaff, setGuestlist, removeGuest, AllowCROWS.

Rewards / costs

  • Join cost: CoverCharge amount of the venue's underlying asset (can be zero). Paid from your wallet (not YUE) via transferFrom.
  • Chat reward: up to 1 of the venue's token per message via MAI, if you hold any.
  • Bouncer actions: gas only.

Requirements & gating

To be admitted (i.e., able to Chat), you need one of:

  • An entry on the guest list that hasn't expired (you Joined within the last 24h).
  • Ownership of the venue's asset (you qualify via asset-owner logic).
  • A paid-up cover charge.

To be a bouncer, you need one of:

  • Being on the staff list (always authorized).
  • Holding 25+ CROWS (if the venue allows CROWS).
  • Holding enough of the underlying asset (specifically totalSupply / BouncerDivisor).
  • Being the asset's owner (via MAP ownership lookup).

The venue will refuse to let you Chat if:

  • Its underlying asset is on MAP's forbidden list (Forbidden).
  • You're not admitted (NotAdmitted).
  • Your guest-list entry has expired and you haven't re-paid (PayCover).

Where it connects

QINGs are deployed by MAP (original QINGs) and GWAT (personal derivatives). They check player identity with CHO, log chat through the chat pipeline (VOID and friends), and plug into the power chain via MAI. Battles at a venue are handled by WAR.

Quick FAQ

Q: How long does a Join last? A: 24 hours. After that, you need to re-Join (and pay cover again if there is one).

Q: Can the cover charge change? A: Yes — bouncers can set it. Changes take effect immediately for new Joins. Already-joined players are safe until their 24h runs out.

Q: What's the deal with CROWS? A: CROWS is a "VIP" token. Holding 25+ of it usually gives you bouncer privileges at a venue. But each QING can disable CROWS-auth via AllowCROWS(false) if the venue owner prefers stricter control.

Q: What's a GWAT? A: Venues come in two flavors: originals (registered on MAP) and derivatives (GWATs — your personal forks). The GWAT boolean on each QING tells you which it is. The flag is derived from the Luo value at construction time.

Q: Can I host a QING without holding the underlying token? A: To register a QING on MAP, MAP requires you to own the underlying token. To create a GWAT (personal derivative), different rules apply — see the GWAT docs.

Q: What if the underlying token gets forbidden later? A: The QING still exists, but Chat and similar actions will revert Forbidden(asset). Effectively the venue goes cold.

Want the Solidity? The contract reference lives at technical/docs/domain/dan/QING.md.