https://github.com/aurickk/mcap
A lightweight and simple self-hosted Minecraft account pool manager.
https://github.com/aurickk/mcap
account-pool dashboard java login microsoft minecraft self-hosted webapp
Last synced: 19 days ago
JSON representation
A lightweight and simple self-hosted Minecraft account pool manager.
- Host: GitHub
- URL: https://github.com/aurickk/mcap
- Owner: aurickk
- Created: 2026-04-04T04:27:51.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-04T04:58:52.000Z (3 months ago)
- Last Synced: 2026-04-04T06:30:17.450Z (3 months ago)
- Topics: account-pool, dashboard, java, login, microsoft, minecraft, self-hosted, webapp
- Language: Java
- Homepage:
- Size: 61.5 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
MCAP - Minecraft Account Pooler
A lightweight and simple self-hosted Minecraft account pool manager. Sign in with Microsoft accounts, store tokens, and keep them fresh automatically. All accessible from a web interface.
> [!IMPORTANT]
> This is designed for single-user, local use. There is no authentication or input sanitization. Do not expose this to the public internet.
## Features
- Microsoft device code login flow
- Import accounts via refresh tokens (single or bulk)
- Automatically refresh expired tokens every 30 minutes
- Copy session and refresh tokens per account
- Export selected accounts as `sessiontoken:refreshtoken` per line
- 3D skin viewer with live preview
- Skin uploading (classic/slim)
- Cape management (equip, hide, preview on hover)
- Username changing with availability check
- REST API for programmatic access
- Dark-themed web interface
## Tech Stack
- **Backend:** Java 25, [Javalin](https://javalin.io/), [MinecraftAuth](https://github.com/RaphiMC/MinecraftAuth)
- **Frontend:** Vanilla HTML/CSS/JS, [skinview3d](https://github.com/bs-community/skinview3d)
- **Database:** SQLite
- **Build:** Gradle
## Installation
### Docker (recommended)
1. Create a `docker-compose.yml`:
```yaml
services:
mcap:
image: ghcr.io/aurickk/mcap:latest
ports:
- "7070:7070"
volumes:
- ./data:/app/data
```
2. Start the container:
```
docker compose up -d
```
3. Open http://localhost:7070
To stop: `docker compose down`
### JAR
Requires [Java 25](https://adoptium.net/) or later.
1. Download `mcap-.jar` from the [latest release](https://github.com/Aurickk/mcap/releases/latest)
2. Run:
```
java -jar mcap-.jar
```
3. Open http://localhost:7070
### Build and run from source
1. Clone the repository:
```
git clone https://github.com/Aurickk/MCAP.git
cd MCAP
```
2. Build and run:
```
./gradlew run
```
## Configuration
Set in `docker-compose.yml`:
- **Port**: Change the left side of `ports` (e.g. `"8080:7070"` to expose on port 8080)
- **Environment variables**:
| Variable | Default | Description |
|----------|---------|-------------|
| `MCAP_DB` | `/app/data/mcap.db` | SQLite database path |
| `MCAP_REFRESH_MINUTES` | `30` | Token auto-refresh interval |
## API
| Method | Path | Description |
|--------|------|-------------|
| `GET` | `/api/accounts` | List all accounts |
| `GET (SSE)` | `/api/accounts/login` | Start device code login |
| `POST` | `/api/accounts/login/token` | Import via refresh token |
| `POST` | `/api/accounts/{id}/refresh` | Refresh account tokens |
| `DELETE` | `/api/accounts/{id}` | Remove account |
| `GET` | `/api/accounts/{id}/profile` | Fetch skin/cape data |
| `POST` | `/api/accounts/{id}/skin` | Upload skin |
| `PUT` | `/api/accounts/{id}/cape` | Equip cape |
| `DELETE` | `/api/accounts/{id}/cape` | Hide cape |
| `GET` | `/api/accounts/name/{name}/available` | Check username availability |
| `PUT` | `/api/accounts/{id}/name` | Change username |