Minecraft Toolkit

Minecraft Toolkit is a Pelican Panel plugin for setting up and managing Minecraft servers directly from the server panel. It writes files through Wings, stores the selected software and installed packages per server, and blocks risky changes while the server is running.

Changelog

See CHANGELOG.md for version history and notable changes.

Current version: 1.3.5.

License and usage rights

Minecraft Toolkit is source-available, not open source. You may download and use the official plugin on your own Pelican Panel installation, but you may not redistribute it, reupload it, publish forks, publish modified versions, rename it, resell it, or release derivative versions.

Official distribution is only allowed through channels approved by Nico Egger / BlueIT, such as the official GitHub repository and the Pelican Hub. See LICENSE for the full terms.

No CurseForge API key is included in the public plugin source. CurseForge is enabled through the signed BlueIT service by default, so normal users can browse supported CurseForge packages without seeing backend API details in the panel. Administrators can override it with a private proxy, disable CurseForge, or use a private local API key.

Features

• Guided setup for Vanilla Java, Vanilla Bedrock, Paper, Folia, Purpur, Fabric, Forge, and NeoForge
• Setup templates for common presets such as Vanilla Survival, Paper Performance, Purpur Crossplay, Fabric Technical, Forge Modded, and Bedrock Survival
• Optional package profiles during setup, including Paper basics, voice chat, and Fabric performance starter sets
• Automatic Minecraft and loader version selection from official sources
• Generation of eula.txt and server.properties
• Optional plugin/mod selection during setup; selected packages from Modrinth and CurseForge can be mixed and are installed immediately after setup completes
• Installer opens with popular compatible packages before searching. The setup package browser is shown only inside the Mods/Plugins setup step and can load popular packages from the selected enabled source.
• Public Modrinth and CurseForge modpack browsing after setup, custom .mrpack/.zip uploads, combine/replace installation modes, and switching between installed modpacks with archived files
• Installer review shows project links, categories, publish/update dates, file size, source hashes, and a compatibility summary before installation.
• Package search can be narrowed by category, author, server-side metadata, minimum downloads, and result sorting.
• MOTD formatter helper for Minecraft color and style codes
• Primary server port taken from the Pelican allocation
• Optional validated 64x64 PNG server icon
• Modrinth plugin installation for Paper, Purpur, and Folia
• Modrinth mod installation for Fabric, Forge, and NeoForge
• Optional CurseForge plugin and mod installation through the signed BlueIT service, a private proxy, or an optional private local API key
• Required dependency auto-installation and optional dependency review
• Optional Geyser and Floodgate crossplay for Paper and Purpur, including Bedrock port, Floodgate auth-type, and Geyser MOTD patching
• Update checks for managed Modrinth, Geyser, and Floodgate packages
• Individual and bulk package updates
• Minecraft version changes with package compatibility checks
• File backups before setup, configuration changes, and package updates
• SHA verification when the package source provides a checksum
• Per-server overview, settings, action logs, backup inventory, and update history

All server files are accessed through Pelican's Wings API. The plugin does not require Panel and Wings to share a filesystem.

Requirements

• Pelican Panel compatible with ^1.0.0-beta34
• PHP 8.3 or newer with curl, mbstring, openssl, SimpleXML, and zip
• Reachable Wings node
• A Minecraft-compatible Egg; Java servers need a Java image, Bedrock servers need an image with unzip and Bedrock runtime support
• HTTPS access from the Panel host to Mojang, PaperMC, PurpurMC, Fabric, Forge, NeoForge, Modrinth, and GeyserMC
• A stopped server for setup, package installation, updates, or configuration changes
• Permission to edit server files
• Permission to change the startup command when installing Fabric, Forge, NeoForge, or Vanilla Bedrock

No queue worker or scheduler is required. Update checks run only when a user starts them from the Minecraft Updater page.

Installation through Plugin Upload

1. Create a ZIP whose top-level folder is named minecrafttoolkit.
2. Open the Pelican admin plugin page and import the ZIP.
3. Install and enable Minecraft Toolkit.
4. Open the plugin settings and review the security and source options.
5. Clear the Panel cache if the server navigation does not appear immediately.

The Pelican plugin installer discovers and runs the migrations in database/migrations.

Manual Installation

cd /var/www/pelican
cp -R /path/to/minecrafttoolkit plugins/minecrafttoolkit
php artisan p:plugin:install
php artisan optimize:clear

The directory name must remain minecrafttoolkit, because it must match the plugin ID in plugin.json.

First Server Setup

1. Create a Pelican server with a Minecraft-compatible Egg.
2. Assign a primary allocation.
3. Stop the server.
4. Open Minecraft Setup in the server sidebar.
5. Select the server software and Minecraft version.
6. For Fabric, Forge, or NeoForge, select a compatible loader version. Bedrock uses the current official Linux Bedrock Dedicated Server download.
7. Configure the MOTD, world name, player limit, and gameplay settings.
8. Optionally upload a 64x64 PNG server icon.
9. For Paper or Purpur, optionally enable crossplay and select a Bedrock allocation. Folia intentionally does not expose the crossplay switch because Paper plugin compatibility is not guaranteed.
10. Optionally select multiple compatible plugins or mods that should be installed directly after setup. You can switch between Modrinth and CurseForge without losing the previous selections, so mixed-provider setups are supported.
11. Review the setup and start it.

Existing target files are moved to:

/.minecraft-toolkit/backups/YYYY-MM-DD-HH-mm-ss/

Forge loader versions are resolved from both Maven metadata and Forge promotion metadata, so older Minecraft versions can still show their matching Forge builds when only recommended/latest metadata is exposed. NeoForge loader discovery includes the legacy 1.20.1 NeoForged Forge artifact and the modern NeoForge artifact, while preserving modern 26.x Minecraft version labels. Forge and NeoForge use their official --installServer flow during the first server start. Vanilla Bedrock downloads the official Linux Bedrock Dedicated Server ZIP and extracts it during the first server start. That first launch creates run.sh and the loader libraries and can take several minutes.

Supported Server Software

Software	Package type	Package directory	Notes
Vanilla Java	none	none	Official Mojang server JAR
Paper	plugins	/plugins	Supports Modrinth and crossplay; CurseForge optional when enabled
Purpur	plugins	/plugins	Supports Modrinth and crossplay; CurseForge optional when enabled
Folia	plugins	/plugins	Supports plugin installation with Folia compatibility warnings
Fabric	mods	/mods	Uses the official Fabric server launcher
Forge	mods	/mods	Runs the official installer on first start
NeoForge	mods	/mods	Runs the official installer on first start

The Java version in the server image must support the selected Minecraft version. Minecraft Toolkit does not replace the server's Docker image.

Package Installer

After setup, open Minecraft Installer:

1. Select Modrinth or CurseForge.
2. Browse the automatically loaded popular compatible package list or search for a project.
3. Optionally narrow results by category, author, server-side metadata, minimum downloads, or sorting.
4. Review the selected compatible version, project source, categories, file size, source hashes, compatibility summary, and dependencies.
5. Stop the server if it is running.
6. Install the package.

Search results are filtered by the configured Minecraft version, server loader, project type, and server-side compatibility. Client-only projects are blocked. Downloads are restricted to HTTPS and validated JAR filenames. The review screen exposes source metadata from Modrinth or CurseForge so admins can inspect the upstream project page and integrity hints before writing files.

Required dependencies reported by Modrinth or CurseForge are installed automatically before the selected package. Optional dependencies are shown for review but are not installed automatically.

CurseForge is enabled by default through the signed BlueIT service. The real CurseForge API key stays outside the plugin source. Administrators can still override the backend connection or use a private direct API key in self-hosted/private installs. If CurseForge is disabled or no valid backend/key is available, CurseForge is hidden from server users while Modrinth continues to work.

Modpacks

Open Minecraft Modpacks after setup to browse public Modrinth or CurseForge modpacks, upload your own .mrpack or .zip, and install the selected pack while the server is stopped.

Two installation modes are available:

• Combine: writes the modpack files into the current server files without archiving unrelated existing files.
• Replace: moves existing /mods files into /.minecraft-toolkit/modpacks/replaced/... before installing the new pack.

Installed modpacks are tracked and can be activated later. When switching, Minecraft Toolkit archives the currently active tracked modpack files under /.minecraft-toolkit/modpacks/archives/... and restores the selected modpack files where possible.

CurseForge does not consistently expose whether a mod is client-only or server-compatible. The Toolkit shows a warning for ambiguous CurseForge mods and requires the user to verify the project description before installation.

Crossplay

Crossplay is available only for Paper and Purpur.

When enabled, Minecraft Toolkit:

• Downloads Geyser-Spigot and Floodgate-Spigot from GeyserMC
• Verifies their SHA-256 checksums
• Installs them as protected managed system packages
• Stores the selected Bedrock allocation
• Patches Geyser to use the Bedrock port and Floodgate authentication

Geyser normally creates its configuration after the first server start. If plugins/Geyser-Spigot/config.yml did not exist during setup:

1. Start the server once.
2. Stop the server again.
3. Open Minecraft Settings.
4. Click Crossplay-Konfiguration anwenden.

The existing Geyser configuration is backed up and only the relevant YAML values are changed.

Package Updates

Open Minecraft Updater and click Updates prüfen. Checks are available while the server is running because they do not modify files.

Before installing an update:

1. Stop the server.
2. Update one package or click Alle verfügbaren Updates installieren.
3. Start the server and verify its console and plugin or mod list.

Before each update check, Minecraft Toolkit compares its database with the actual loaded plugin versions from logs/latest.log where available. If the real installed version differs from the database, the database is synchronized first and the package is not falsely marked as current. For each real update, the old server file or package JAR is moved into the Toolkit backup directory before the new file is downloaded. If the download or checksum validation fails, the plugin attempts to restore the old file and leaves the database on the previous version.

The updater currently supports:

• Managed Modrinth plugins
• Managed Modrinth mods
• Managed CurseForge plugins and mods
• Geyser
• Floodgate
• Managed server artifacts for supported server software, including Vanilla Java, Vanilla Bedrock, Paper, Purpur, Folia, Fabric, Forge, and NeoForge

Managed packages and server artifacts can be pinned from the updater. Pinned entries are skipped by update checks, individual updates, bulk updates, and automatic version-change package updates. The updater also provides bulk actions to pin all entries, unpin all entries, or verify every managed entry. During a Minecraft version change, a pinned package that would need a compatible replacement is shown as a blocking package until it is unpinned, removed with backup, or the user explicitly accepts the risk.

The updater can also verify an installed managed file in place. JAR verification reads the current file through Wings, checks the stored SHA-512 or SHA-1 where available, validates the JAR archive structure, extracts plugin metadata, and applies the Java class-version safety check. Non-JAR server artifacts are verified as present without JAR metadata extraction.

Each managed package also shows a lightweight health score based on source trust, stored hash strength, pinning, verification status, update availability, and the latest updater error state. Updater cards include operational details such as file path, source version ID, Minecraft/loader target, hash availability, dependency count, and install age so administrators can audit managed entries without opening the database.

The updater also reports recent plugin load failures detected in logs/latest.log, including missing plugin dependencies and Java class-version incompatibilities. Manually uploaded files are not updated automatically.

Changing the Minecraft Version

Open Minecraft-Version ändern after the initial setup:

1. Select a new Minecraft version.
2. For Fabric, Forge, or NeoForge, select a compatible loader version. Bedrock uses the current official Linux Bedrock Dedicated Server download.
3. Run the compatibility check.
4. Review every managed plugin, mod, dependency, and crossplay package.
5. Stop the server.
6. Choose the available change strategy.

Compatibility results are cached briefly per server, target software/version/loader, and installed package fingerprint. Package updates, removals, pins, or a different target automatically produce a fresh check.

Package statuses:

• Compatible: the installed package version supports the target.
• Update required: a compatible Modrinth version will be installed.
• System package update: Geyser or Floodgate will be refreshed.
• Incompatible: no compatible version was found.
• Unknown: the source is unavailable or has no reliable compatibility data.

When all packages are compatible, the safe change action is available. If blocking packages exist, the user can either back up and disable those packages or explicitly accept the risk and keep them installed.

The server software stays the same during this operation. For example, the page can change Paper 1.21.4 to another Paper version, but it does not convert Paper to Fabric.

The current server artifact and affected package files are backed up before replacement. server.properties is preserved. Forge and NeoForge generate their new loader runtime on the next server start.

Server Settings

The Minecraft Settings page includes quick fields, paged fields for the standard Java server.properties keys, and a full raw server.properties editor. This allows all normal Minecraft properties to be changed while preserving unknown or newer settings. The server must be stopped before saving.

Available settings include:

• MOTD
• Maximum players
• View distance
• Simulation distance
• Online mode
• Whitelist
• PVP
• Flight
• Bedrock allocation and crossplay configuration for Paper/Purpur

Plugin Configuration

Administrators can configure Minecraft Toolkit from the Pelican plugin settings page.

Variable	Default	Description
MINECRAFT_TOOLKIT_ENABLED	true	Enables the plugin
MINECRAFT_TOOLKIT_ADMINS_ONLY	false	Restricts modifying Toolkit actions to administrators
MINECRAFT_TOOLKIT_BACKUP_BEFORE_OVERWRITE	true	Backs up setup target files before replacement
MINECRAFT_TOOLKIT_MODRINTH_ENABLED	true	Enables Modrinth search and installation
MINECRAFT_TOOLKIT_CURSEFORGE_ENABLED	true	Enables CurseForge package browsing and installation
MINECRAFT_TOOLKIT_CURSEFORGE_PROXY_URL	internal default	Optional override for a private CurseForge bridge. Leave empty to use the built-in default.
MINECRAFT_TOOLKIT_CURSEFORGE_PROXY_SECRET	internal default	Optional override for a private bridge secret. The value is not shown in the panel. Public builds internally match the BlueIT default proxy secret.
MINECRAFT_TOOLKIT_CURSEFORGE_PROXY_CLIENT_ID	minecraft-toolkit	Client identifier sent to the Toolkit proxy
MINECRAFT_TOOLKIT_CURSEFORGE_PROXY_SIGNED_REQUESTS	true	Sends timestamped HMAC headers to the Toolkit proxy
MINECRAFT_TOOLKIT_CURSEFORGE_API_KEY	empty	Optional private direct CurseForge API key sent through the x-api-key request header
MINECRAFT_TOOLKIT_UPDATER_ENABLED	true	Enables the package updater page
MINECRAFT_TOOLKIT_VERSION_CHANGE_ENABLED	true	Enables compatibility checks and Minecraft version changes
MINECRAFT_TOOLKIT_VERSION_CHANGE_USERS_ENABLED	true	Allows non-admin server owners and permitted subusers to change versions
MINECRAFT_TOOLKIT_CROSSPLAY_ENABLED	true	Enables Geyser/Floodgate support
MINECRAFT_TOOLKIT_BEDROCK_PORT_REQUIRED	true	Requires a separate Bedrock allocation
MINECRAFT_TOOLKIT_SECURITY_AUDIT_LOG_ENABLED	true	Writes security audit entries for gated risky actions
MINECRAFT_TOOLKIT_RISK_GATE_STARTUP_EDITS_ADMIN_ONLY	false	Requires root admin for Toolkit startup command changes
MINECRAFT_TOOLKIT_RISK_GATE_VERSION_RISK_ADMIN_ONLY	false	Requires root admin for risky version changes
MINECRAFT_TOOLKIT_RISK_GATE_PACKAGE_REMOVAL_ADMIN_ONLY	false	Requires root admin for managed package removal or remove-and-change workflows
MINECRAFT_TOOLKIT_RISK_GATE_CURSEFORGE_USAGE_ADMIN_ONLY	false	Requires root admin for CurseForge browsing and installation
MINECRAFT_TOOLKIT_RISK_GATE_CROSSPLAY_SETUP_ADMIN_ONLY	false	Requires root admin for Crossplay installation and config patching
MINECRAFT_TOOLKIT_RISK_GATE_RAW_PROPERTIES_ADMIN_ONLY	false	Requires root admin for raw server.properties editing
MINECRAFT_TOOLKIT_BEDROCK_DOWNLOAD_URL	empty	Optional direct Linux Bedrock server ZIP URL override when the official download page cannot be parsed
MINECRAFT_TOOLKIT_BEDROCK_DOWNLOAD_VERSION	empty	Version label for the direct Bedrock download URL if it cannot be extracted from the file name
MINECRAFT_TOOLKIT_BEDROCK_FALLBACK_VERSIONS	latest	Fallback Bedrock setup versions shown when live lookup fails. Use comma-separated explicit versions for direct version URLs.
MINECRAFT_TOOLKIT_HTTP_TIMEOUT	20	Metadata API timeout in seconds
MINECRAFT_TOOLKIT_DOWNLOAD_TIMEOUT	300	Package download timeout in seconds
MINECRAFT_TOOLKIT_COMPATIBILITY_CACHE_MINUTES	30	Cache duration for repeated version-change compatibility checks. Set to 0 to disable
MINECRAFT_TOOLKIT_BLOCK_PRIVATE_DOWNLOAD_IPS	true	Blocks downloads that resolve to private, loopback, link-local, or reserved addresses
MINECRAFT_TOOLKIT_HASH_REQUIRED	false	Requires SHA-256 or SHA-512 for package downloads when enabled
MINECRAFT_TOOLKIT_MAX_ICON_BYTES	2097152	Maximum server icon size
MINECRAFT_TOOLKIT_MAX_PACKAGE_BYTES	104857600	Maximum package size
MINECRAFT_TOOLKIT_MAX_JAR_ENTRIES	20000	Maximum number of entries accepted inside a downloaded JAR
MINECRAFT_TOOLKIT_MAX_JAR_ENTRY_BYTES	52428800	Maximum uncompressed size for a single JAR entry
MINECRAFT_TOOLKIT_USER_AGENT	BlueIT-MinecraftToolkit/1.3.5	User-Agent for external requests

After changing environment values manually, clear cached configuration:

cd /var/www/pelican
php artisan optimize:clear

Permissions

Root administrators and server owners can use the Toolkit. Subusers need permission to view the server and both create and update files.

Fabric, Forge, and NeoForge setup additionally requires the Pelican startup-update permission because the plugin installs a loader-specific startup command.

Users without the required permissions do not see the corresponding Toolkit pages or receive a permission error instead of a raw exception.

Security

• Server-changing actions require the server to be offline.
• Download URLs must use HTTPS and an allowlisted official domain.
• Direct Panel downloads validate each redirect target and block private, loopback, link-local, and reserved addresses.
• Path traversal and unsafe JAR filenames are rejected.
• Package size limits are enforced.
• Downloaded JARs must have ZIP/JAR magic bytes and safe archive entry paths.
• JARs are rejected when an entry count or single-entry size exceeds configured limits.
• SHA-512, SHA-256, or SHA-1 is verified when supplied by the source.
• Administrators can require SHA-256 or SHA-512 for package downloads with MINECRAFT_TOOLKIT_HASH_REQUIRED=true.
• Administrators can require root admin approval for startup edits, risky version changes, package removal, CurseForge usage, Crossplay setup, and raw server.properties editing.
• Gated risky actions write security audit entries to the Toolkit log when MINECRAFT_TOOLKIT_SECURITY_AUDIT_LOG_ENABLED=true.
• Existing files are backed up before replacement.
• Technical exceptions are written to the Laravel log while the UI receives a short error message.

MOTD formatting

The setup page includes a small MOTD formatter. Users can choose a color and basic styles such as bold, italic, and underline. The generated Minecraft formatting-code MOTD is written into server.properties. Advanced users can still type Minecraft formatting codes manually, for example §aGreen §lBold §rNormal.

For Paper/Purpur crossplay, applying the Crossplay configuration also patches Geyser to use Floodgate authentication and writes the selected MOTD into Geyser's Bedrock MOTD fields where possible.

Troubleshooting

• Minecraft pages are missing: verify the plugin is enabled, migrations completed, and run php artisan optimize:clear.
• Setup says no allocation exists: assign a primary allocation to the Pelican server.
• Action says the server must be stopped: stop it completely and wait until Wings reports offline, exited, dead, or created.
• Fabric, Forge, or NeoForge setup is denied: grant startup-update permission or run the setup as the server owner or an administrator.
• Forge or NeoForge does not start: inspect the first-start console, verify the container has the correct Java version, and confirm /run.sh was created.
• No Modrinth results: verify the selected Minecraft version and loader are supported by the project and that the Panel host can reach api.modrinth.com.
• CurseForge is missing: Verify MINECRAFT_TOOLKIT_CURSEFORGE_ENABLED=true and that either the BlueIT service or a private direct API key is configured. Public plugin builds do not ship with a CurseForge API key. If the BlueIT proxy returns 401, verify that CURSEFORGE_PROXY_SECRET on Vercel matches the Toolkit default or is listed in CURSEFORGE_PROXY_SECRETS.
• CurseForge has no download URL: the project author disabled third-party API downloads; that file cannot be installed automatically.
• Crossplay config is missing: start Paper/Purpur once, stop it, and apply the config from Minecraft Settings.
• Vanilla Bedrock says no versions are available: clear Laravel/plugin caches. If the official Minecraft page is temporarily blocked or changed, the wizard falls back to Latest official Bedrock server. For locked-down hosts, set MINECRAFT_TOOLKIT_BEDROCK_DOWNLOAD_URL to the direct Linux Bedrock ZIP URL.
• Bedrock players cannot connect: verify the selected allocation permits UDP traffic and the node firewall exposes that port.
• Update failed: inspect /.minecraft-toolkit/backups/ and the Laravel log. The updater attempts to restore the previous file automatically.
• Version change is blocked: review incompatible and unknown packages, then either secure and disable them or explicitly use the risk option.
• Server does not start after a risky change: stop it, restore the relevant files from /.minecraft-toolkit/backups/, and return to the previous Minecraft version.
• Wings is unreachable: verify node connectivity and credentials; Toolkit file actions intentionally stop instead of writing directly to node volumes.

Logs for setup, installs, crossplay, checks, and updates are stored per server and shown on the Minecraft Overview page. The overview also lists source status cards for Modrinth, CurseForge, and Crossplay, an admin checklist for security-sensitive configuration, plus recent Toolkit backup folders from /.minecraft-toolkit/backups so administrators can quickly find files created before setup, updates, removals, or version changes. Known backup files can be restored from the overview while the server is stopped; the current target file is backed up before the restore is written.

CurseForge backend handling

CurseForge uses the BlueIT service by default. The panel settings intentionally keep service URL and secret fields empty, because the stored defaults are used internally unless an administrator explicitly enters private override values.

Manual browser navigation to the BlueIT backend returns to the website start page. Non-Toolkit HTTP clients are rejected before any CurseForge request is forwarded. Toolkit requests include a dedicated client marker, client id, timestamp, nonce, custom user agent, and HMAC signature. This keeps casual/manual access away from the backend while the real CurseForge API key remains server-side.

Private proxy backend example:

MINECRAFT_TOOLKIT_CURSEFORGE_ENABLED=true
MINECRAFT_TOOLKIT_CURSEFORGE_PROXY_URL=https://your-vercel-domain.vercel.app/api/curseforge/proxy
MINECRAFT_TOOLKIT_CURSEFORGE_PROXY_SECRET=your_proxy_secret
MINECRAFT_TOOLKIT_CURSEFORGE_PROXY_CLIENT_ID=minecraft-toolkit
MINECRAFT_TOOLKIT_CURSEFORGE_PROXY_SIGNED_REQUESTS=true

Advanced private installs can skip the default service and set their own private direct API key:

MINECRAFT_TOOLKIT_CURSEFORGE_ENABLED=true
MINECRAFT_TOOLKIT_CURSEFORGE_API_KEY=your_private_key

Do not ship CurseForge API keys inside public plugin builds. If CurseForge is disabled or no backend/key is configured, CurseForge disables itself safely and Modrinth continues to work.

Languages

Minecraft Toolkit includes English and German plugin translations.

The plugin automatically uses German when the current Pelican/user locale starts with de such as de, de_AT, or de_DE. For every other locale, the plugin injects English strings as the fallback so users do not see untranslated German UI text.

Run php tests/lang-keys.php from the plugin directory before releases to confirm English and German translation keys stay aligned and to catch common mojibake artifacts.

Updater Dependency Repair and Package Removal

The updater can install missing required dependencies after setup. If a managed package fails because a required dependency is missing, the updater offers a dependency install action. Known incomplete metadata cases such as ViaRewind requiring ViaBackwards are handled as required dependencies.

Managed plugins and mods can also be removed from the updater. Removal requires the server to be stopped, backs up the file into .minecraft-toolkit/backups, and then disables the package record so the toolkit no longer treats it as installed. System packages such as Geyser and Floodgate are protected from this generic delete action.

Update checks now avoid trusting stale logs/latest.log entries after a package update. The toolkit verifies that the new file exists, keeps build metadata for Geyser/Floodgate, and only synchronizes database versions from runtime logs when those logs are newer than the last package install/update.

Java compatibility safety check

Minecraft Toolkit checks downloaded plugin/mod JARs before writing them to the server. Public builds default to Java 21 compatibility with MINECRAFT_TOOLKIT_JAVA_CLASS_VERSION_MAX=65. If a package requires a newer Java runtime, installation is aborted instead of leaving a broken JAR in /plugins or /mods. Private installations can set this value to their actual runtime class-file limit or 0 to disable the check.

Crossplay configuration note

The Geyser configuration patcher updates the modern Geyser config layout, including bedrock.port, java.auth-type, motd.primary-motd, motd.secondary-motd, and motd.passthrough-motd.

Bedrock Dedicated Server fallback

The Toolkit uses the official Minecraft Bedrock Dedicated Server Linux download URL. If the public Minecraft download page changes its HTML or blocks server-side scraping, the plugin now falls back to the built-in official URL and can also be overridden through .env:

MINECRAFT_TOOLKIT_BEDROCK_DOWNLOAD_URL=https://www.minecraft.net/bedrockdedicatedserver/bin-linux/bedrock-server-1.26.23.1.zip
MINECRAFT_TOOLKIT_BEDROCK_DOWNLOAD_VERSION=1.26.23.1
MINECRAFT_TOOLKIT_BEDROCK_FALLBACK_VERSIONS=latest,1.26.23.1

Selecting latest uses the configured official URL. Selecting a concrete Bedrock version builds the official Mojang download URL for that exact version.

Bedrock ZIP downloads

Vanilla Bedrock ZIP files are downloaded by the Panel first and then written into the server files. This avoids daemon-side pull failures when minecraft.net rejects or errors on Wings' background download request.