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
111 lines
4.1 KiB
Markdown
111 lines
4.1 KiB
Markdown
# Artifacts MMO Dashboard
|
|
|
|
> Dashboard & automation platform for [Artifacts MMO](https://artifactsmmo.com) — control, automate, and analyze your characters through a beautiful web interface.
|
|
|
|
**[Live Demo — artifacts.gtf.ovh](https://artifacts.gtf.ovh)** | **[GitHub](https://github.com/pawelorzech/artifacts-dashboard)**
|
|
|
|
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](https://artifactsmmo.com) account and API token
|
|
|
|
### Setup
|
|
|
|
1. Clone the repository:
|
|
```bash
|
|
git clone https://github.com/pawelorzech/artifacts-dashboard.git
|
|
cd artifacts-dashboard
|
|
```
|
|
|
|
2. Copy the environment file and add your API token:
|
|
```bash
|
|
cp .env.example .env
|
|
# Edit .env and set ARTIFACTS_TOKEN
|
|
```
|
|
|
|
3. Start the stack:
|
|
```bash
|
|
docker compose up
|
|
```
|
|
|
|
4. 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](docs/ARCHITECTURE.md) — system design and patterns
|
|
- [Automation](docs/AUTOMATION.md) — strategy configuration guide
|
|
- [Deployment](docs/DEPLOYMENT.md) — production deployment with Coolify
|
|
- [API Reference](docs/API.md) — backend REST API
|
|
|
|
## Contributing
|
|
|
|
Contributions are welcome! Please read the following before submitting:
|
|
|
|
1. Fork the repository
|
|
2. Create a feature branch: `git checkout -b feature/my-feature`
|
|
3. Commit your changes: `git commit -m "Add my feature"`
|
|
4. Push to the branch: `git push origin feature/my-feature`
|
|
5. Open a Pull Request
|
|
|
|
Please use the provided issue and PR templates.
|
|
|
|
## License
|
|
|
|
This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.
|