AcidBot

A maimai DX (international ver.) bot.

Any issue please raise in the issues page

Features

• Best 50
• Level Score (All songs for a specific level)
• Skill Radar
• More features in development and will mostly be developed in cooperation with the AcidBot discord bot

Technical Stack

• Next.js + Typescript frontend
• Styled with Tailwind CSS and daisyUI
• REST-ish API built with Next.js
• User and song data stored with MongoDB
• OAuth provided by Auth.js
• ESLint and Prettier for code quality and consistency
• pnpm used for a high-speed, low-disk-space package management

Local Installation

Prerequisites

• Node.js v24.3.0+
• Next.js v16.1.6+
• pnpm package manager
• MongoDB cluster

Installation

1. Clone the repository

   git clone https://github.com/KXCVZNMX/AcidBot.git
   cd AcidBot

2. Install dependencies

   pnpm install

3. Setup Environment Variables

   create a .env.local file in the root of the project

   # The root of your site, without an trailing slash.
   # e.g. http://localhost:3000, https://acid.kvznmx.com
   SITE_LINK={your_site_root}
   
   # Generated by 'npm exec auth secret'
   AUTH_SECRET={your_auth_secret}
   
   # Github OAuth
   AUTH_GITHUB_ID={client_id}
   AUTH_GITHUB_SECRET={client_secret}
   
   # Google OAuth
   AUTH_GOOGLE_ID={client_id}
   AUTH_GOOGLE_SECRET={client_secret}
   
   # MongoDB connection string
   MONGODB_URI={mongodb_connection_string}

4. Start Development Server

   pnpm dev # --turbopack (if you wish)

Credits

• Thanks to zvuc otoge-db for song data and constant collection
• Thanks to GalvinGao DXRating.net for tags collection