Dashboard & automation platform for Artifacts MMO - control, automate, and analyze your characters through a beautiful web interface
4d8974bc66
Filter live status responses so callers only see automations, workflows, and pipelines associated with the current user's characters. Backend: use get_user_character_names in automations.get_all_statuses, workflows.get_all_workflow_statuses, and pipelines.get_all_pipeline_statuses (pipeline filtering checks character_states). Frontend: clear React Query cache when a token is set or removed (import useQueryClient and add it to callback deps) so cached data is refreshed after auth changes. |
||
|---|---|---|
| .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.