Skip to content

About

Modern PHP 8.3+ Geometry Dash private server core (GDPS) with cloud saves, levels, scores, accounts, social features, moderation, JSON API v2, migrations, rate limiting, tests and production-ready security tooling. Built as a modern alternative to legacy GDPS cores.

Topics

Resources

Stars

10 stars

Watchers

0 watching

Forks

Latest commit

 

History

3,782 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MuchoCore

Create your own Geometry Dash private server: accounts, levels, music, Cloud Save and a web admin panel.

С чего начать — по-русски · Download · Website · Report a problem

Install

Use PHP 8.2+ for a new server. Choose the row that matches your hosting:

What you have Where to start
Hosting with PHP 8.2+ and MySQL Download the shared-hosting ZIP from Releases, upload its contents and open /install.php. Step-by-step guide
A Linux VPS and a domain Point the domain to the VPS IP, then run the command below. PHP and the database are installed automatically. VPS guide
A 5v.pl site with PHP 7 Use the separate PHP7 native preview. The PHP 8 archive will not run there. 5v.pl guide

VPS installation:

curl -fsSL https://raw.githubusercontent.com/IZKGMD/GMDmucho-core/main/install-remote.sh | sudo bash

The installer selects a published stable release. Enter your administrator login and password, server name and domain when asked. Sign in at https://YOUR-DOMAIN/admin/ with the credentials you chose.

Direct VPS HTTPS remains the default. No Cloudflare API token, Global API Key, Cloudflare Tunnel or Cloudflare Proxy is required for this path.

For shared hosting, download MuchoCore-vX.Y.Z-shared-hosting.zip, not GitHub's source-code ZIP. The shared package includes the required dependencies. Create an empty database in your hosting panel before opening the installer.

Start playing

  1. Open the admin panel.
  2. Open More tools → Clients & extensions → Web Client Patcher to create a client for your server. Keep your original game file. Windows and Android guide
  3. Launch the patched game, create a game account, then upload and download a test level. Your website administrator login is separate from your game account.
  4. Set up player downloads under More tools → Clients & extensions → Client Downloads before inviting friends. Publish only files you have permission to distribute.

Use the admin panel for players, levels, music and server settings. Additional technical tools are under More tools.

Update an existing server

Use the updater, not first-time installation. Keep a backup of your database, settings and Cloud Save key before updating.

On a VPS:

sudo mucho update
sudo mucho doctor

For other hosting: PHP 8 shared updates · 5v.pl updates.

Need help?

Problem First step
Installation cannot continue Fix the failed hosting checks shown by the installer.
The website opens, but the game cannot connect Check the client address and hosting routing using the client guide. A working website alone does not confirm game connectivity.
Login or level downloads fail Include the client version and failing action in an issue. Never include passwords.
Moving an existing GDPS Install into a fresh database, then use Migration Center.

GD 2.209 support is still under verification; complete real-client acceptance is not certified. The PHP7 build is a development preview. Compatibility status

The source version is recorded in VERSION. A source version is not proof of a published stable release. Use Releases for published builds; main contains ongoing development.

More information

Changelog · Local patchers · Plugins · Advanced networking · API · Go edition (in development)

Source code is in src/, HTTP entry points in public/, and checks in tests/. See tests/README.md for development validation.

MuchoCore and MuchoProtect are developed by IZK © 2026, with contributor and third-party rights respected. Source code: MIT. Geometry Dash and its assets belong to their respective owners. Website terms do not override the source-code license.

About

Modern PHP 8.3+ Geometry Dash private server core (GDPS) with cloud saves, levels, scores, accounts, social features, moderation, JSON API v2, migrations, rate limiting, tests and production-ready security tooling. Built as a modern alternative to legacy GDPS cores.

Topics

Resources

Stars

10 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages