Standalone Installation

warning

We do not recommend standalone installation. It's highly recommended to use the Blueprint framework instead! However, if you proceed, we provide support for any issues through our Discord server.

Prerequisites

Before proceeding, make sure you have completed the Pterodactyl panel customization prerequisites:

View Prerequisites

Backend Routes

Add the following imports to routes/api-client.php:

use Pterodactyl\MythicalSystems\McUtils\PlayerList\MinecraftPlayerListController;
use Pterodactyl\MythicalSystems\McUtils\ServerIcon\MinecraftServerIconController;

Then add these routes after the activity log route:

Route::get('/icon', [MinecraftServerIconController::class, 'index']);
Route::patch('/icon', [MinecraftServerIconController::class, 'update']);
Route::get('/playerlist', [MinecraftPlayerListController::class, 'index']);

Frontend Routes

Add the following import to resources/scripts/routers/routes.ts:

import MinecraftUtils from '@/components/server/mcutils/McUtilsContainer';

Then add the route configuration:

{
    path: '/mc-utils',
    permission: null,
    name: 'Minecraft Utils',
    component: MinecraftUtils,
}

Server Icon Changer

Add these modifications to resources/scripts/components/server/settings/SettingsContainer.tsx:

import McIconButton from '@/components/server/mcutils/McIconButton';

Add the component before the closing ServerContentBlock:

<McIconButton />

Set Permissions

Set the correct file permissions:

chmod -R 755 storage/* bootstrap/cache/
chown -R www-data:www-data /var/www/pterodactyl/*

Build Panel

Finally, build the panel with these commands:

yarn
export NODE_OPTIONS=--openssl-legacy-provider # for NodeJS v17+
yarn lint --fix
yarn build:production # Build panel