Skip to Content
Haven Documentation is the shared home for product guides, plugin setup, and release docs.
PluginsRandom GamesOverview

Random Games

Random Games adds automated and command-started Discord mini-games to AthenaBot. It is built for community servers that want lightweight activity, leaderboards, XP or coin rewards, and recurring competition without staff needing to manually run every round.

The plugin can run games automatically in a configured channel, let members start games with !game, generate leaderboard cards with /game leaderboard, award economy rewards, and reset daily, weekly, and monthly leaderboards on a schedule.

What It Can Do

  • Run random games automatically in one configured game channel
  • Start a game after enough messages, on a time interval, or only when both trigger conditions are met
  • Let members run a random game or a specific game by alias
  • Lock the prefix game command behind a Discord role if needed
  • Show daily, weekly, and monthly leaderboards with generated image cards
  • Reset leaderboards on a schedule using a configured timezone
  • Announce leaderboard winners in a channel
  • Assign MVP roles to top players after weekly or monthly resets
  • Reward players with Athena economy coins, XP, or both
  • Customize round duration per game
  • Use bundled image assets for Pokemon, logos, landmarks, celebrities, movies, and other visual games

Plugin Names

Use these exact names when working with Athena:

ItemName
Plugin folderplugins/random_games
Config namerandomgames
Language config namerandomgames-lang
Main generated config fileconfiguration/randomgames.json5
Main generated language fileconfiguration/randomgames_lang.json5

Best Fit

Random Games is best for servers that want a dedicated activity channel, reward loops tied into the Athena economy system, and recurring leaderboard resets. For release setups, keep the game channel separate from high-traffic support or announcement channels so game messages do not interrupt important workflows.