WoW Character Manager

⚠️ Needs Attention

Loading...

Blizzard API

Checking...

Database

Local SQLite

Filter ▼

Your Characters

Loading characters...

WoW News

Loading news...

Recent Activity

API Status

⚔️
➕
🎯
📋
🏠
🎵
⚖️
👥
↻
📝

Admin Panel

User Management

Media Library

Categories

Media Items

Application Settings

Blizzard API

OpenAI API (optional)

Off by default. With the admin key, the admin default model is always used.

OpenRouter API (optional)

Model list and prices from openrouter.ai
Off by default. With the admin key, the admin default model is always used.

Registration

Character Update Settings

How often the application checks for character updates in the background.

Database Maintenance

Check and repair database schema to ensure all required columns exist.

Documentation

👋 Welcome, Administrator!

This guide will help you manage users and explain the application's features to new users.

➕ Adding New Users

  1. Go to the Users tab in the Admin Panel
  2. Click the Add User button
  3. Enter a username (must be unique)
  4. Create a password (minimum 6 characters)
  5. Optionally add an email address
  6. Check Admin privileges if the user should have admin access
  7. Click Create User to finish
💡 Tip: Share the login credentials with the new user securely. They can change their password in Settings.

📱 Application Features

🧙 Characters

Add WoW characters from retail or classic. Data syncs automatically with Blizzard API.

📋 Dailies & Weeklies

Track recurring tasks. Set daily or weekly reset schedules.

🎯 Goals

Set and track goals for gold, item level, reputation, and more.

📝 Notes

Add notes to characters for reminders and important info.

🤖 AI Assistant

Get personalized help from an AI assistant (requires API key setup).

🔌 Addon API

Sync data with WoW addons using bearer token authentication.

🚀 First Steps for New Users

Recommend these steps to new users:

  1. Log in with the provided credentials
  2. Change password in Settings (gear icon)
  3. Add first character using the "Add Character" button
  4. Set up daily/weekly tasks for routine activities
  5. Optional: Configure AI assistant with personal API key
  6. Optional: Generate addon API token for in-game sync

⚙️ Admin Settings Overview

Setting Description
Blizzard API Required for character data. Get credentials from developer.blizzard.com
OpenAI API Optional. Users without their own key can use it only if the admin shares it.
OpenRouter API Optional. Same rules as OpenAI: users use it only if the admin shares it.
Registration Enable/disable public user registration.
Update Interval How often character data syncs with Blizzard.

🔌 Addon API Overview

The Addon API allows external applications (like WoW addons) to read and update character data using bearer token authentication.

🔐 Authentication

All API requests require a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_TOKEN

Users can generate tokens in Settings → WoW Addon API → Generate Token

⏱️ Rate Limiting

API requests are limited to 60 requests per minute per user.

📡 API Endpoints

GET /api/addon/characters

List all characters for the authenticated user.

GET /api/addon/characters/:id

Get detailed character info including professions, notes, and reputations.

PUT /api/addon/characters/:id/tasks

Update character main tasks (max 50 chars each).

{ "main_task1": "Farm gold", "main_task2": "Do M+", "main_task3": null }
GET /api/addon/characters/:id/notes

Get all notes for a character.

POST /api/addon/characters/:id/notes

Add a note to a character.

{ "noteText": "Remember to check vault" }
GET /api/addon/tasks

Get all daily/weekly tasks.

POST /api/addon/tasks/:id/toggle

Toggle task completion status.

💻 Example Request

curl -X GET \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://your-server.com/api/addon/characters

❌ Error Codes

Code Meaning
400 Bad Request - Invalid input
401 Unauthorized - Invalid or missing token
404 Not Found - Resource doesn't exist
429 Too Many Requests - Rate limit exceeded
500 Server Error

📖 Full Documentation

For complete API documentation with all endpoints and response formats, see:

📄 API.md