Dashboard & automation platform for Artifacts MMO - control, automate, and analyze your characters through a beautiful web interface
6a6b49c290
- Fix bank deposit/withdraw paths: /bank/deposit → /bank/deposit/item (and withdraw) - Fix cooldown error handling: 498 is "character not found" (raise immediately), 499 is "character in cooldown" (wait and retry) — was previously swapped - Fix events endpoint: use /events/active instead of /events for active game events - Fix action rate limiter: 7/2s → 20/2s to match actual API limits - Use page_size=10000 for static data pagination (items/monsters/resources/maps) to minimize API round-trips during cache refresh - Add missing character fields from API: wisdom, prospecting, initiative, threat, dmg, layer, map_id, effects, rune_slot, bag_slot, and *_max_xp for all skills - Fix skill bars to use actual max_xp from API instead of xp % 100 - Add rune_slot and bag_slot to equipment constants https://claude.ai/code/session_015BJtuNcKqcdqSJETj5xRjX |
||
|---|---|---|
| .github | ||
| backend | ||
| docs | ||
| frontend | ||
| .env.example | ||
| .gitignore | ||
| docker-compose.prod.yml | ||
| docker-compose.yml | ||
| LICENSE | ||
| README.md | ||
Artifacts MMO Dashboard
Dashboard & automation platform for Artifacts MMO — control, automate, and analyze your characters through a beautiful web interface.
Live Demo — artifacts.gtf.ovh | GitHub
Free to use — just log in with your Artifacts MMO token and start automating.
Features
- Live Character Dashboard — real-time view of all 5 characters with HP, stats, equipment, inventory, skills, and cooldowns
- Automation Engine — combat, gathering, crafting, trading, and task automation with configurable strategies
- Interactive Map — world map with character positions, monsters, resources, and event overlays
- Bank Management — searchable bank inventory with item details and estimated values
- Grand Exchange — market browsing, order management, and price history charts
- Event Tracking — live game events with notifications
- Analytics — XP gain, gold tracking, actions/hour, and level progression charts
- Multi-Character Coordination — resource pipelines, boss fights, and task distribution
- WebSocket Updates — real-time dashboard updates via game WebSocket relay
Tech Stack
| Layer | Technology |
|---|---|
| Frontend | Next.js 15, React 19, TypeScript, Tailwind CSS 4, shadcn/ui, TanStack Query, Recharts |
| Backend | Python 3.12, FastAPI, SQLAlchemy (async), httpx, Pydantic v2 |
| Database | PostgreSQL 17 |
| Deployment | Docker Compose, Coolify |
Quickstart
Prerequisites
- Docker & Docker Compose
- An Artifacts MMO account and API token
Setup
-
Clone the repository:
git clone https://github.com/pawelorzech/artifacts-dashboard.git cd artifacts-dashboard -
Copy the environment file and add your API token:
cp .env.example .env # Edit .env and set ARTIFACTS_TOKEN -
Start the stack:
docker compose up -
Open your browser:
- Dashboard: http://localhost:3000
- API docs: http://localhost:8000/docs
Project Structure
artifacts-dashboard/
├── backend/ # FastAPI application
│ ├── app/
│ │ ├── api/ # REST endpoints
│ │ ├── models/ # SQLAlchemy models
│ │ ├── schemas/ # Pydantic schemas
│ │ ├── services/ # Business logic
│ │ ├── engine/ # Automation engine
│ │ └── websocket/# WebSocket client & relay
│ └── tests/
├── frontend/ # Next.js application
│ └── src/
│ ├── app/ # Pages (App Router)
│ ├── components/
│ ├── hooks/
│ └── lib/
├── docs/ # Documentation
└── docker-compose.yml
Documentation
- Architecture — system design and patterns
- Automation — strategy configuration guide
- Deployment — production deployment with Coolify
- API Reference — backend REST API
Contributing
Contributions are welcome! Please read the following before submitting:
- Fork the repository
- Create a feature branch:
git checkout -b feature/my-feature - Commit your changes:
git commit -m "Add my feature" - Push to the branch:
git push origin feature/my-feature - Open a Pull Request
Please use the provided issue and PR templates.
License
This project is licensed under the MIT License — see the LICENSE file for details.