Docs & Setup Guide

Everything you need to get CreeperAuth working — from account creation to online play.

⚡ QUICK START
1
Register on this websiteCreate a CreeperAuth account at creeperauth.netlify.app. Choose a username, email, and password. Optionally upload a skin.
2
Download CreeperLauncherGrab the latest .exe from the GitHub releases page. No installer needed — just run it.
3
Log in to the launcherOpen the launcher → Accounts tab → CreeperAuth tab. Enter the auth URL, your username, and password. Hit Login.
4
Install required modsDownload CustomSkinLoader and OfflineSkins (Fabric 1.21.1) and put them in your mods folder via the launcher's Mods tab.
5
Launch and play!Select your version, hit Play. Your skin will show in-game and on cracked multiplayer servers.
⬇ DOWNLOAD LAUNCHER
🚀
CreeperLauncher
A custom Minecraft launcher built for CreeperAuth. Supports offline accounts, CreeperAuth login, mod manager, skin gallery, and per-profile game directories.
Windows 10/11 · .NET 6+ required · No install needed
⬇ Download .zip GitHub →
💡 TIP If Windows shows a SmartScreen warning, click "More info" → "Run anyway". This happens because the exe is not signed with a paid certificate.

SYSTEM REQUIREMENTS

  • Windows 10 or Windows 11 (64-bit)
  • .NET 6.0 Runtime or higher — .NET download page
  • Java 17 or Java 21 (Java 26 works for singleplayer only)
  • At least 2GB RAM allocated to Minecraft
⚔ REGISTER ACCOUNT

USERNAME RULES

  • 3 to 16 characters
  • Letters, numbers, and underscores only (no spaces or special chars)
  • Usernames are unique — first come, first served
  • Usernames cannot be changed (yet)

SKIN REQUIREMENTS

  • PNG file only
  • Must be exactly 64×64 pixels (modern format) or 64×32 pixels (legacy format)
  • You can upload or change your skin any time from the Dashboard
  • Skins are stored securely — no public URL unless you share your UUID
💡 TIP — Finding Skins Download free Minecraft skins from NameMC or MinecraftSkins.com. Make sure to download the full 64×64 texture file.
⚙ LAUNCHER SETUP
1
Run CreeperLauncher.exeDouble-click the downloaded .exe. No installation wizard — it opens directly.
2
Browse VersionsClick "Browse Versions" to download Minecraft. Pick your version (1.21.1 recommended for mod support). Wait for the download to complete.
3
Install Fabric (for mods)After downloading a version, select it and click "Install Fabric". This installs the Fabric mod loader required for CustomSkinLoader and OfflineSkins.
4
Go to Accounts tabClick the Accounts tab on the left. You'll see two sub-tabs: Offline and CreeperAuth.
🔑 LOGGING IN

CREEPERAUTH LOGIN

1
Go to Accounts → CreeperAuth tab
2
In the Auth Server URL field, enter:
https://creeperauth.cyberlifegamingyt15.workers.dev
3
Enter your CreeperAuth username and password
4
Click Login. Your account appears in the accounts list.

OFFLINE LOGIN

For singleplayer or LAN play without a CreeperAuth account, go to Accounts → Offline tab. Enter any username and click Add. Offline accounts cannot join online-mode servers.

🎨 UPLOADING SKINS

VIA THE WEBSITE (RECOMMENDED)

Log in at creeperauth.netlify.app → Dashboard → Skin card → Upload New Skin. Your skin is instantly saved and served via the auth API.

SKIN WARDROBE

The Wardrobe lets you save multiple skins and switch between them with one click. Add skins with "+ Add Skin", name them, and click "▶ Equip" to make one active. The active skin is what other players see.

💡 HOW SKINS WORK IN MULTIPLAYER CreeperAuth uses CustomSkinLoader to serve your skin to other players. Both you and the other player need CustomSkinLoader installed for skins to appear. Without it, you'll see the default Steve/Alex skin.
🧩 REQUIRED MODS

These mods are needed for skin support in multiplayer. Both require Fabric mod loader.

🎨
CustomSkinLoader REQUIRED
Loads player skins from custom auth servers including CreeperAuth. Replaces Mojang's skin system so your skin and other players' skins show correctly.
▶ Download from Modrinth  ·  CurseForge
Version: Fabric 1.21.1
👤
OfflineSkins RECOMMENDED
Shows skins for players who are in offline/cracked mode. Without this, offline-mode players appear as Steve/Alex even if they have a custom skin.
▶ Download from Modrinth
Version: Fabric 1.21.1
⚡
Fabric API REQUIRED
Base dependency for all Fabric mods. Required for CustomSkinLoader and OfflineSkins to work.
▶ Download from Modrinth
⚠ JAVA VERSION WARNING Do NOT use Java 26 for multiplayer. Use Java 17 or Java 21. Java 26 causes crashes with Fabric mods due to bytecode incompatibilities. Set Java path in launcher Settings tab.

INSTALLING MODS

In CreeperLauncher, go to the Mods tab. Click the folder icon or drag .jar files in. The launcher syncs these mods to your game profile automatically when you launch.

🖥 SERVER SETUP

FOR SERVER OWNERS — ONLINE MODE

To allow CreeperAuth players on an online-mode server, add authlib-injector to your server startup:

java -javaagent:authlib-injector.jar=https://creeperauth.cyberlifegamingyt15.workers.dev -jar server.jar nogui

Download authlib-injector.jar from github.com/yushijinhun/authlib-injector/releases

FOR SERVER OWNERS — OFFLINE MODE (CRACKED)

Set online-mode=false in server.properties. CreeperAuth players can connect without authlib-injector. Skins require CustomSkinLoader on both client and server (Paper/Spigot plugin or Fabric mod).

online-mode=false
💡 RECOMMENDED: OFFLINE MODE Most cracked server communities use offline-mode=false. CreeperAuth is designed to work seamlessly with cracked servers. Authlib-injector is only needed if you want Mojang-style server authentication.
🌐 CRACKED SERVERS

CONNECTING TO CRACKED SERVERS

Cracked (offline-mode) servers like ExtremeCraft, MineHeroes, and similar networks accept CreeperAuth accounts directly. Just log in with CreeperAuth in the launcher and connect as normal. No extra setup needed.

SKIN VISIBILITY

  • Your skin to you — Always visible (resource pack injection)
  • Your skin to others — Requires CustomSkinLoader on their client
  • Others' skins to you — Requires OfflineSkins + CustomSkinLoader
🔧 TROUBLESHOOTING

GAME CRASHES ON LAUNCH

  • Check your Java version — use Java 17 or 21, not Java 26
  • Make sure Fabric API is installed alongside your other mods
  • Check the crash log in %AppData%\MCLauncher\profiles\{id}\crash-reports\
  • Try removing mods one by one to find the conflict

SKIN NOT SHOWING IN MULTIPLAYER

  • Make sure CustomSkinLoader is installed (not just OfflineSkins)
  • Confirm your skin is uploaded on the CreeperAuth website dashboard
  • Check that the launcher wrote CustomSkinLoader/Config.json in your profile folder — it should point to the CreeperAuth worker URL
  • Restart the game after uploading a new skin

LOGIN FAILS IN LAUNCHER

  • Double-check the Auth URL is exactly: https://creeperauth.cyberlifegamingyt15.workers.dev
  • Make sure you're entering your CreeperAuth username, not your email
  • Try logging in on the website first to confirm your credentials work
  • Check your internet connection — the auth server is hosted on Cloudflare

CANNOT CONNECT TO SERVER

  • If the server is online-mode, it needs authlib-injector pointing to CreeperAuth
  • If the server is offline-mode, CreeperAuth accounts connect normally
  • "Not authenticated with minecraft.net" = the server is online-mode and doesn't have authlib-injector

SMARTSCREEN / ANTIVIRUS BLOCKING LAUNCHER

Windows SmartScreen may block unsigned executables. Click "More info" → "Run anyway". Add the .exe to your antivirus whitelist if needed. The source code is open on GitHub for inspection.

❓ FAQ
Is CreeperAuth free? +
Yes, completely free. The auth server runs on Cloudflare Workers (free tier) and Firebase Firestore (free tier). There are no plans to charge for it.
Do I need a real Minecraft account? +
No. CreeperAuth is a completely separate authentication system. You only need a CreeperAuth account (registered on this website) and CreeperLauncher. No Mojang or Microsoft account needed.
Can I play on official Minecraft servers? +
No. Official servers (Hypixel, Mineplex, etc.) require a genuine Mojang/Microsoft account. CreeperAuth only works on cracked/offline servers and servers running authlib-injector with our URL.
What Minecraft versions are supported? +
Any version that CmlLib.Core supports (1.5+). For mod support (skins in multiplayer), Fabric 1.21.1 is recommended as that's what the required mods target. The auth system itself is version-independent.
Can I change my username? +
Username changing is not currently supported on the website. This is planned for a future update. Your UUID is tied to your account permanently.
Why does the launcher need .NET 6? +
CreeperLauncher is built with WPF (Windows Presentation Foundation) which requires .NET 6 or higher. Download it free from Microsoft's website.
Is my password stored securely? +
Yes. Passwords are hashed and managed entirely by Firebase Authentication — they are never stored in plaintext. The CreeperAuth server never sees your raw password.
Can I use CreeperAuth on multiple devices? +
Yes. Log in with your username and password on any device running CreeperLauncher. Your skin, UUID, and settings are stored in the cloud.
How do I delete my account? +
Account deletion is not yet available via the website UI. Contact the server admin via the GitHub issues page to request deletion.