InfiniTeaInfiniTea Docs
Setup and Configuration

Giveaways

Giveaways lets you run prize events with configurable entry modes, eligibility requirements, and reward types. Members enter through the giveaway panel, and winners are drawn automatically or manually when the giveaway ends.

How It Works

Each giveaway moves through three stages: Draft (configuration), Active (accepting entries), and Ended (winners drawn). During the active phase, eligible members can enter. When the giveaway ends (manually or via auto-end), winners are randomly drawn from the entry pool.

Configuration

Setup

  • Name: Display name for the giveaway.
  • Status: Draft, Active, or Ended.
  • Auto End: Automatically end the giveaway and draw winners at the scheduled end time.
  • Starts At / Ends At: UTC timestamps for the giveaway window.

Entry Rules

  • Entry Mode: Free (no cost) or Embers (members spend currency to enter).
  • Entry Cost: Amount of embers required per entry (when using ember mode).
  • Winners to Draw: Number of winners selected when the giveaway ends.
  • Max Entries Per User: Limit how many times one member can enter (0 = unlimited).
  • Max Total Entries: Cap on total entries across all members (0 = unlimited).

Eligibility Filters

Restrict who can enter based on:

  • Required Roles: Members must have any or all of specified roles.
  • Excluded Roles: Members with these roles cannot enter.
  • Minimum Account Age (Days): Accounts must be at least this old.
  • Minimum XP: Members must have earned at least this much XP.
  • Minimum Embers: Members must have at least this ember balance.

Rewards

Two reward types:

  • Custom Rewards: Define a title, description, and instructions list for the winner (e.g., "DM staff to claim your prize").
  • Ember Items: Award items from your server's Emberworks store.

Messages

  • Entry Panel: Message Builder template for the giveaway entry panel that members interact with.
  • Winner Announcement: Message Builder template for announcing winners.

Slash Commands

  • /giveaway (Administrator) — Open the giveaway management hub. Lists current giveaways by status with management controls.

Use Cases

  • Community milestones: Run a free giveaway when your server hits a member count goal.
  • Ember sinks: Use ember-entry giveaways to create economy demand and reduce inflation.
  • Engagement incentives: Require minimum XP to enter, rewarding active members.
  • Nitro giveaways: Use custom rewards with redemption instructions for external prizes.

Tips

  • Set reasonable eligibility filters to prevent alt-account abuse.
  • Use auto-end for time-boxed events so you don't forget to draw winners.
  • Test your entry panel and winner announcement messages before going live.
  • Ember-entry giveaways work well as an Emberworks economy balancer.