Dashboard & automation platform for Artifacts MMO - control, automate, and analyze your characters through a beautiful web interface
75313b83c0
Add multi-user automation features and per-user error tracking. - Database migrations: add workflow_configs/workflow_runs (004), app_errors (005), pipeline_configs/pipeline_runs (006), and add user_token_hash to app_errors (007). - Backend: introduce per-request token handling (X-API-Token) via app.api.deps and update many API routes (auth, automations, bank, characters, dashboard, events, exchange, logs) to use user-scoped Artifacts client and character scoping. Auth endpoints no longer store tokens server-side (validate-only); clear is a no-op on server. - New Errors API and services: endpoint to list, filter, resolve, and report errors scoped to the requesting user; add error models, schemas, middleware/error handler and error_service for recording/hashing tokens. - Pipelines & Workflows: add API routers, models, schemas and engine modules (pipeline/worker/coordinator, workflow runner/conditions) and action_executor updates to support workflow/pipeline execution. - Logs: logs endpoint now prefers fetching recent action logs from the game API (with fallback to local DB), supports paging and filtering, and scopes results to the user. - Frontend: add pipeline/workflow builders, lists, progress components and hooks (use-errors, use-pipelines, use-workflows), sentry client config, and updates to API client/constants/types. - Misc: add middleware error handler, various engine strategy tweaks, tests adjusted. Overall this change enables per-user API tokens, scopes DB queries to each user, introduces pipelines/workflows runtime support, and centralizes application error tracking. |
||
|---|---|---|
| .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.