Release / release (push) Has been cancelled

Details

v0.2.0: Rich interactive map, automation gallery, auth & UX improvements

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

2026-03-01 20:18:29 +01:00

4.1 KiB

Raw Permalink Blame History

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.

4.1 KiB Raw Permalink Blame History