Skip to content
 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,160 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CentralCorp Minecraft Launcher logo

CentralCorp Launcher

CentralCorp Launcher is a customizable Minecraft launcher designed to work with the self-hosted CentralCorp web panel and the Azuriom ecosystem. It retrieves launcher configuration and game files from the panel, authenticates players through Azuriom, and starts the configured Minecraft version with loaders such as Forge or Fabric.

Latest release Launcher build License: CC BY-NC 4.0 Documentation

Documentation · Panel · Installer · Preview

CentralCorp Minecraft Launcher home screen

✨ Features

  • Azuriom authentication, including two-factor authentication handling;
  • Minecraft server status and player count;
  • configurable Minecraft version, game directory and minimum/maximum memory;
  • Forge, Fabric, LegacyFabric, NeoForge and Quilt loader values supplied by the panel;
  • file verification and synchronization from a self-hosted panel or Azuriom plugin endpoint;
  • optional mods that players can enable or disable;
  • maintenance mode and access lists based on Azuriom users or roles;
  • news feed, alert message, video content and configurable interface color;
  • player role, currency and skin display when the required Azuriom data and skin services are configured;
  • Discord Rich Presence, Electron release updates and five interface languages.

🖼️ Preview

Account management Launcher settings
Account management in CentralCorp Minecraft Launcher Skin settings in CentralCorp Minecraft Launcher
Optional mods Launcher interface
Optional mod selection in CentralCorp Minecraft Launcher CentralCorp Minecraft Launcher interface preview

More product views and explanations are available in the launcher showcase and on the preview page.

Minecraft Launcher

The player application combines the configured Minecraft version, loader, game files and memory settings into a launch profile. Routine server-side changes are retrieved from the panel, while the repository controls the desktop application identity and build configuration.

🖥️ Minecraft Launcher Panel

The launcher consumes configuration from either CentralCorp Panel or the CentralCorp Azuriom plugin, according to the env value in package.json. The web panel manages the Minecraft version, loader, server, files, mods, maintenance, access controls and interface settings without requiring a launcher rebuild for those routine changes.

CentralCorp Minecraft Launcher Panel configuration dashboard

Read the Minecraft Launcher Panel documentation for the complete data flow and hosting requirements.

Azuriom integration

Player authentication uses the Azuriom authentication API. In standalone panel mode, the panel stores the Azuriom URL and API key and exposes the launcher configuration. In direct Azuriom mode, the launcher reads the CentralCorp plugin endpoints from the configured site.

This launcher targets offline-mode Minecraft server setups connected to Azuriom. Microsoft online-mode servers are not supported.

⚙️ Forge and Fabric

The selected Minecraft version and loader are returned by the panel and passed to the launch engine. Forge and Fabric are supported by the current panel configuration, alongside LegacyFabric, NeoForge and Quilt. Test every modpack against its exact Minecraft, loader and mod versions before distribution.

Optional mods

The panel can describe mods that players may enable or disable before launch. Recommendation labels and mod images are also exposed by the current optional-mod configuration.

Updates

The launcher checks its configured release repository through the Electron update mechanism. Game files are handled separately: the panel manifest lets the launcher verify and synchronize the files required by the selected configuration.

Installation

Follow the CentralCorp installation guide to prepare the project, install the panel and configure the launcher. For a local launcher checkout:

npm install
npm run dev

Configuration

The repository-level values in package.json define the launcher identity, version, environment, panel or Azuriom URL, and publishing repository. The build script currently reads the existing preductname key for the product name; keep that spelling unless the build script and configuration are migrated together.

Panel-managed settings are documented in the panel configuration guide.

Build

Available scripts include:

npm start
npm run dev
npm run build

The GitHub workflow creates a release and builds packages for Windows (.exe), Linux (.AppImage) and macOS (.dmg and .zip). Update the launcher version before publishing a release.

CentralCorp ecosystem

License

CentralCorp Launcher is distributed under Creative Commons Attribution-NonCommercial 4.0 International. Its source code is available, but the non-commercial restriction means the project should not be described as open source in the standard OSI sense. Preserve attribution, identify changes and review the license before commercial use.

Releases

Packages

Used by

Contributors

Languages