Dashboard & automation platform for Artifacts MMO - control, automate, and analyze your characters through a beautiful web interface
10781c7987
Some checks failed
Release / release (push) Has been cancelled
Map overhaul: - Replace colored boxes with actual game tile images (skin textures from CDN) - Overlay content icons (monsters, resources, NPCs) on tiles - Add layer switching (Overworld/Underground/Interior) - Fix API schema to parse interactions.content and layer fields - Add hover tooltips, tile search with coordinate parsing, keyboard shortcuts - Add minimap with viewport rectangle, zoom-toward-cursor, loading progress - Show tile/content images in side panel, coordinate labels at high zoom Automation gallery: - 27+ pre-built automation templates (combat, gathering, crafting, trading, utility) - Multi-character selection for batch automation creation - Gallery component with activate dialog Auth & settings: - API key gate with auth provider for token management - Enhanced settings page with token configuration UI improvements: - Game icon component for item/monster/resource images - Character automations panel on character detail page - Equipment grid and inventory grid enhancements - Automations page layout refresh - Bank, exchange page minor fixes - README update with live demo link |
||
|---|---|---|
| .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.