Minecraft Whitelist Generator
✅ Minecraft Whitelist Generator – Instantly Create Mojang-Compatible Whitelist Files
The Minecraft Whitelist Generator by GalaxyTool is a powerful, modern, and fully automated web tool designed to help Minecraft server owners and developers quickly generate accurate, Mojang-compatible whitelist.json
files. Whether you’re managing a private SMP, setting up a whitelist-only minigame server, or just organizing a premium player community, this tool makes the process seamless, efficient, and error-free.
With full support for both usernames and UUIDs, live Mojang API validation, JSON formatting, and one-click copy/download functionality, the Whitelist Generator removes all the manual work and makes it easier than ever to manage your player whitelist.
🎮 What Is a Whitelist in Minecraft?
A whitelist is a JSON file (whitelist.json
) used by Minecraft servers to control which players are allowed to join. When whitelist mode is enabled, only players listed in this file will be able to connect to the server. This is ideal for:
- Private SMPs
- Early-access beta servers
- VIP-only builds or events
- Protecting your world from unknown players
Each player entry must include both a valid UUID (unique player identifier) and username in a strict JSON structure. Creating this file manually can be time-consuming — and one typo can break everything. The GalaxyTool Whitelist Generator handles all of this automatically.
✨ Key Features Overview
✅ Easy-to-Use Interface
Just paste or type one username or UUID per line in the text box. No formatting needed — the tool parses everything for you.
🌐 Mojang API Integration
The generator uses the official Mojang API via a reliable endpoint (ashcon.app
) to:
- Validate usernames
- Retrieve accurate UUIDs
- Format UUIDs with dashes (
8-4-4-4-12
) - Return structured data
This ensures that every entry in your whitelist is 100% valid and server-compatible.
🧠 Smart Input Handling
You can enter:
- Player usernames
- Full or short UUIDs
- Mixed input (some usernames, some UUIDs)
Blank lines are ignored, and all usernames are cleaned and validated automatically.
📜 Output Preview (JSON Format)
After clicking “Generate Whitelist,” the tool outputs a fully formatted JSON array in a read-only text area. It uses:
- Proper indentation
- Quotes and commas in the correct places
- Clean UUID formatting
Example output:
[
{
"uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
"name": "Notch"
},
{
"uuid": "ec561538-f3fd-461d-aff5-086b22154bce",
"name": "jeb_"
}
]
📋 Copy and Download Options
Once the list is generated, you can:
- Copy JSON to your clipboard with one click
- Download a ready-to-use
whitelist.json
file directly
The file is formatted and named with the current date (e.g., whitelist-2025-07-24.json
), ready to drop into your Minecraft server root folder.
📱 Fully Responsive Design
The tool is built with a mobile-first layout that adapts to all screen sizes:
- Two-column desktop layout
- Vertical stacking on tablets and phones
- Touch-friendly buttons
Works on Chrome, Firefox, Safari, Edge, and mobile browsers.
💡 How To Use
Step 1: Enter Usernames or UUIDs
Paste or type one username or UUID per line into the top input field.
Example:
Notch
jeb_
069a79f4-44e9-4726-a5be-fca90e38aaf5
Step 2: Click “Generate Whitelist”
The tool will:
- Validate each username using the Mojang API
- Fetch and format UUIDs
- Assemble the final JSON file
A status message will appear showing:
- ✅ How many entries were successfully generated
- ❌ Errors if any entries are invalid
Step 3: Preview or Copy JSON
Review the full JSON output in the preview area. Then:
- Click “Copy JSON” to copy the entire content
- Or click “Download” to save it as a file
Step 4: Upload to Your Server
Place the downloaded whitelist.json
into your server’s root directory, then:
- Set
white-list=true
inserver.properties
- Restart your server
Done! Your whitelist is now active and fully working.
🧩 Plugin & Server Compatibility
The generated whitelist is fully compatible with:
- Vanilla Minecraft servers
- Spigot, Paper, Purpur
- Hosting panels like Aternos, ScalaCube, PebbleHost, Shockbyte
- Any server that uses Mojang UUID-based player authentication
The JSON format adheres to Mojang’s whitelist spec and works from Minecraft 1.7.6+ (when UUIDs were introduced).
📌 Use Cases
The Whitelist Generator is ideal for:
🧑🤝🧑 Private SMPs
Allow only trusted friends or community members to join — protect your world from griefers.
🎮 Event Servers
Temporarily restrict access during special events or beta launches.
🌐 Server Networks
Manage large player bases with unique whitelists for each sub-server (e.g., Skyblock, Minigames, Survival).
🛡️ Security & Control
Use alongside online-mode=true
and white-list=true
for premium-only, fully authenticated player access.
🔐 Error Handling and Status Feedback
The tool provides clear visual feedback throughout:
- ⏳ Processing status while fetching Mojang data
- ✅ Success message with total valid entries
- ❌ Error message if nothing valid was entered
- 📋 Copy success confirmation
Even in case of API failures or slow connections, the user is kept informed with a smooth UI.
🧠 Developer Notes
- Uses
fetch()
with async/await for fast Mojang lookups - UUIDs are formatted into the required dashed format
- Lightweight, no external libraries
- JavaScript handles input sanitization and export logic
- Clean and animated design built with modern CSS variables
🚀 Benefits
- Saves you hours of manual typing and formatting
- Reduces the chance of invalid UUIDs or misconfigured files
- Allows non-technical staff or server admins to manage whitelists easily
- Works on any device
- Secure, fast, and always up-to-date with Mojang UUIDs
🔗 Start Using It Now
Just scroll up, paste your list, and generate a valid whitelist.json
file in seconds.
📦 Don’t forget to enable
white-list=true
in yourserver.properties
file after uploading!
🎮 Build safer, more secure Minecraft communities — powered by GalaxyTool.