How pushitcake/beacon-panel works
Beacon Panel is a Pterodactyl-derived game-server management panel with Beacon-specific catalog and content-management features. Users access server administration and operations through web and API endpoints; Beacon clients can search provider content, inspect installations, and request asynchronous mutations, while catalog provisioning creates servers. The tree also shows account/authentication, scheduling, backups, and server-management subsystems. Sampled source confirms route registration, content search/provider use, and parts of the mutation workflow; other legacy subsystem wiring is represented at a coarse level because its implementation was not sampled.
Main entry points: RouteServiceProvider.php Web routes · BeaconContentController.php Content endpoints · Server.php Server state · Beacon Beacon endpoints
Components 27
Access and APIs
- Web routes
app/Providers/RouteServiceProvider.php - Authentication
app/Http/Controllers/Auth - Admin endpoints
app/Http/Controllers/Admin - Client endpoints
app/Http/Controllers/Api/Client - Application API
app/Http/Controllers/Api/Application - Remote API
app/Http/Controllers/Api/Remote
Server Management
- Server administration
app/Http/Controllers/Admin/ServersController.php - Server provisioning
- Server state
app/Models/Server.php - Server operations
- Scheduled tasks
app/Jobs/Schedule/RunTaskJob.php - Backup storage
app/Extensions/Backups/BackupManager.php
Beacon Features
- Beacon endpoints
app/Http/Controllers/Api/Beacon - Server catalog
app/Models/BeaconCatalogApplication.php - Catalog creation job
app/Jobs/Beacon/CreateCatalogServerJob.php - Content endpoints
app/Http/Controllers/Api/Client/Servers/BeaconContentController.php - Modrinth provider
app/Beacon/Content/Providers/ModrinthProvider.php - Dependency planning
app/Beacon/Content/DependencyPlanner.php - Mutation preparation
app/Beacon/Content/PrepareContentMutationService.php - Content operations
- Content install job
app/Jobs/Beacon/InstallContentJob.php - Installation state
app/Models/BeaconContentInstallation.php - Content provider service
app/Beacon/Content/ContentServiceProvider.php
Runtime Services
- Minecraft properties
- Panel database
app/Models/Model.php
Other components
- Panel user
- Wings daemon
Connections 27
- Panel user → Web routes: sends requests
- Web routes → Authentication: routes auth
- Web routes → Admin endpoints: routes admin
- Web routes → Client endpoints: routes client
- Web routes → Application API: routes application
- Web routes → Beacon endpoints: routes Beacon
- Web routes → Remote API: routes remote
- Admin endpoints → Server administration: manages servers
- Server administration → Server state: updates state
- Beacon endpoints → Server catalog: serves catalog
- Beacon endpoints → Catalog creation job: queues creation
- Catalog creation job → Server provisioning: creates server
- Server provisioning → Server state: persists server
- Content endpoints → Modrinth provider: searches versions
- Content endpoints → Dependency planning: plans dependencies
- Content endpoints → Mutation preparation: prepares mutation
- Content endpoints → Installation state: reads installations
- Content endpoints → Content operations: starts operation
- Content operations → Content install job: dispatches job
- Content provider service → Modrinth provider: registers provider
- Remote API → Wings daemon: serves daemon requests
- Server operations → Wings daemon: controls server
- Scheduled tasks → Wings daemon: runs task
- Backup storage → Panel database: stores metadata
- Server state → Panel database: persists state
- Installation state → Panel database: persists installs
- Minecraft properties → Server state: uses server data