Skip to main content

Welcome to Project Stardust

Project Stardust is a Discord bot that brings anime character collection and battles to your server. Pull your favorite characters from AniList’s vast database, build powerful teams, and compete in strategic battles and raids.

Gacha system

Pull characters with rarity tiers (SSR/SR/R) based on AniList popularity rankings. Features pity system and rate-up banners.

Team battles

Build teams of up to 5 characters with unique abilities and power calculations. Battle NPCs or challenge other players.

Raid bosses

Team up to defeat powerful bosses with special mechanics. Earn exclusive rewards and track your victories.

Progression systems

Level up your team, increase character bonds, complete daily tasks, and unlock achievements as you play.

Key features

Character collection

  • Pull anime characters from AniList’s database
  • Three rarity tiers: SSR (top 250), SR (251-1500), R (1501-10000)
  • Dupe system: Collect up to 10 copies for +5% power per dupe
  • Auto-scrap system converts excess dupes into gems and coins

Battle mechanics

  • 5-slot team composition system
  • Dynamic power calculation including dupes, team level, and bond levels
  • Ability tags system for strategic gameplay
  • Save and load team presets for different scenarios

Economy & rewards

  • Gacha Gems: Primary currency for character pulls
  • Coins: Secondary currency for shop purchases
  • Bounty Keys: Complete challenging bounties for rewards
  • Daily tasks, expeditions, and check-in streaks

Social features

  • Compete on the leaderboard
  • Share your collection with inventory commands
  • Join forces in raid battles
  • Achievement tracking system

Technology stack

Project Stardust is built with:
  • discord.py - Discord bot framework
  • asyncpg - PostgreSQL database driver
  • AniList API - Character data source
  • Pillow - Image generation for pulls and battles
  • aiohttp - Async HTTP requests

Get started

Ready to set up your own instance? Check out the quickstart guide for a fast setup, or dive into the detailed setup instructions for full configuration options.

Build docs developers (and LLMs) love