Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Entry Fees

Budokan allows you to set entry fees for your tournaments using any supported token on Starknet. This feature lets communities leverage their own ecosystem tokens as payment for games on the platform, adding flexibility and value.

Supported Tokens

For security, Budokan currently uses a whitelist of tokens for tournament entry fees. In the future, any token supported on Ekubo will be available for use. Support for ERC721 (NFT) entry fees is also coming soon.

Entry Fee TokensFigure 1: Entry fee tokens currently supported.

Customizing Entry Fee Distribution

The entry fee form offers flexible options for setting the price of entry and how fees are split among different parties. To make things simple, values are converted to USD where possible, so both players and creators can easily compare amounts—even if they're unfamiliar with the token.

Entry Fees Figure 2: Entry Fees Form.

How Entry Fees Are Split

  • Creator Fee:
    • The percentage of each entry fee that goes to the tournament creator. This is automatically distributed to the creator's account (Entry #0) when a player enters.
  • Game Fee:
    • The percentage of each entry fee that goes to the game developer. Budokan enforces that the game creator share is greater than or equal to the fee declared by the game at deployment (via game_fee_info in the game registry). The default game fee is 5% (500 basis points). Tournament creators can set a higher share but cannot go below the game's declared fee. The game developer receives this cut via the account holding Game #0.
  • Refund Share:
    • An optional percentage of each entry fee that is refunded to each depositor. This allows tournament creators to return a portion of fees back to all participants.
  • Player Distribution (Prize Pool):
    • The remaining amount is added to the tournament's prize pool. The creator decides how the prize is split among winners, based on the leaderboard size. Use the slider to adjust distribution weights, or manually enter the splits (they must total 100%).

Tip: Use familiar tokens for your audience to encourage participation. Double-check your fee splits before confirming, as they can't be changed after creation.

Distribution Strategies

The prize pool portion of entry fees is distributed to winners using one of these strategies:

StrategyDescription
LinearLinear decay with configurable step size (e.g., 1st gets most, each position decreases by a fixed amount)
ExponentialExponential decay with configurable base (top-heavy, drops off sharply)
UniformEqual split across all winning positions
CustomSpecify exact basis point shares per position

Building on EntryFeeComponent

Budokan's entry fee system is powered by the EntryFeeComponent from the open-source game-components library. This component handles fee collection, share splitting, and payouts. If you're building your own competition platform, you can reuse or extend this component with custom distribution logic. See Component Architecture for details.

Related Guides

If you have questions or need help, check the FAQ or contact support through the app.