Web Apps and APIs

Portal

The portal uses ASP.NET Core Identity with cookies. It provides:

• registration and login
• password change
• character listing, creation, deletion
• a play-token generator

API endpoints

Method	Path	Auth	Description
GET	/api/account/me	cookie	Current user profile and characters
GET	/api/account/characters	cookie	User's characters
POST	/api/account/playtoken	cookie	Issue JWT for a character

Play token response:

{
  "token": "<jwt>",
  "host": "127.0.0.1",
  "port": 7777
}

Configuration

Important environment variables:

• ConnectionStrings__Default
• Jwt__Secret
• Jwt__Issuer
• Jwt__Audience
• GameServer__Host
• GameServer__Port
• Seed__AdminEmail
• Seed__AdminPassword

Admin panel

The admin app shares the same database and Identity configuration. Admin pages require the Admin role.

Features:

• dashboard with server heartbeat and counts
• player search and ban
• server controls:
  • broadcast
  • kick
  • state change
  • graceful shutdown request
• audit log view