Back to Mods
Whitelist Fix

Whitelist Fix

misckevinofky

A simple mod to fix the broken server whitelist function using PlayerDB

About Whitelist Fix

Hytale Whitelist Fix

This is a small mod to fix the whitelist implementation for Hytale servers. Currently, whitelists are handled by the HytaleWhitelistProvider. When you try to whitelist a username, it generates a fake UUID that doesn't work. This mod uses the PlayerDB API to fetch accurate player UUIDs based on username.

How to install

Drop the .jar file into your mods folder and run your server. After first run, /config/whitelistconfig.properties will be generated. Here you can customize the message users see when they attempt to join. You can also turn off the PlayerDB fetching. Save the file and restart your server.

How to use

/wl add <hytale_username> to add a user /wl remove <hytale_username> to remove a user /wl list to view whitelisted usernames

You can also use the UUID (a1234567-890b-123c-456d-12345678901e) of a player.

The rest of the whitelist commands remain the same:

/whitelist enable - Enables the whitelist /whitelist disable - Disables the whitelist /whitelist clear - Clears the whitelist /whitelist status - Displays the status of the whitelist

This is the first time I've ever tried to create a mod and the first time I've ever tried to code with Java. I expect there will be stupid mistakes. Please leave a comment with anything you find.

Downloads
71
Created
Jan 20, 2026
Updated
Jan 21, 2026
Version
Early Access

Categories

MiscellaneousQuality of LifeUtility

Download Mod

Download on CurseForge
Free download • 71 total downloads

Need a Server?

Run Whitelist Fix on a dedicated Hytale server with easy mod management.

Get Hytale Hosting

Frequently Asked Questions

What is Whitelist Fix?

A simple mod to fix the broken server whitelist function using PlayerDB

How do I download Whitelist Fix?

You can download Whitelist Fix for free from CurseForge. Click the "Download on CurseForge" button on this page to go directly to the download page.

Who created Whitelist Fix?

Whitelist Fix was created by kevinofky. The mod has been downloaded 71 times.

Is Whitelist Fix compatible with Hytale servers?

Whitelist Fix is designed for Hytale and can be used on both single-player and multiplayer servers. Check the mod page on CurseForge for specific compatibility information.

How do I install Whitelist Fix?

To install Whitelist Fix: 1) Download the mod from CurseForge, 2) Place the file in your Hytale mods folder, 3) Restart the game. The mod should load automatically.