DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix Now×
Skip to content
World desk8 min

How to Enable and Manage a Hytale Server Whitelist

Enable a Hytale whitelist with console commands, manage players by username or UUID, use host-panel controls, and safely edit whitelist.json for bulk changes.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Enable a Hytale whitelist from the server console with whitelist enable. Then authorize people with whitelist add <username>, check the list with whitelist list, and remove access with whitelist remove <username>. To open the server again, run whitelist disable. You can also use an operator account in game or, on some managed hosts, a control-panel toggle.

This guide covers the command workflow, host panels, UUID-based entries, safe whitelist.json editing, and the recovery steps for common errors. Command syntax is documented by third-party Hytale guides rather than an identified official Hypixel Studios reference, so verify behavior against the Hytale server build you run.

As an Amazon Associate I earn from qualifying purchases.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What a Hytale whitelist does

A whitelist changes the server from open access to an allow-list: only players registered in the server’s whitelist can connect. It is useful for private survival worlds, testing servers, family or school groups, and staged community launches where you want the address to remain reachable without accepting every player.

Whitelisting is an access control layer, not authentication, moderation, or a substitute for backups. Anyone who can use an authorized account can still join, and a whitelisted player can still damage a world or break server rules. Keep operator permissions limited and maintain normal backups.

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.

The command references below are collated by HytaleCommands’ whitelist syntax guide and host documentation from GGServers, Nodecraft, ZAP-Hosting, xGamingServer, and holy.gg.

Choose where to manage it

Method Best use What you need Risk and trade-off
Server console Enabling protection and making one-off changes Console access and the exact command Lowest-risk method; changes are easy to audit
In-game operator command Adding or removing a player while you are online An account with permission to run server commands Fast, but a misconfigured operator account is a security risk
Host options page Owners who do not want to type commands A panel that exposes a whitelist setting Labels and save behavior vary by host
Manual whitelist.json edit Bulk changes or synchronization with another system File-manager or SFTP access, a backup, and a stopped server Highest risk; malformed JSON or overwritten edits can remove access

For a single player, use the console or an authorized in-game command. Reserve file editing for a deliberate maintenance window.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Enable the whitelist from the console

  1. Open the live server console. Use your host’s console window, terminal session, or local server process. Do not put console commands in a web-chat box unless the host explicitly routes that box to the server.
  2. Enable protection. Enter whitelist enable and submit it.
  3. Confirm the state. Run whitelist status. A result indicating that the whitelist is enabled means new connections must be authorized.
  4. Add at least one player before inviting anyone. Use whitelist add <username> with the player’s Hytale username. Run whitelist list to confirm the entry.
  5. Have the player reconnect. A player who was already connected may not be tested by the new access rule until they reconnect; if behavior is unclear, disconnect and reconnect that account.

The command set and its reported subcommands are also summarized in this Hytale command reference. That site is a community source, not identified official Hypixel Studios documentation, so command availability can differ by server version.

Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.

Enable a whitelist in a hosting panel

Some managed hosts expose the same setting as a switch. The documented examples are:

Open the server’s options or configuration page, locate the whitelist control, turn it on, and save or apply the change. The exact label, location, and whether a restart is requested are host-specific. After saving, use the panel console (if available) to run whitelist status and whitelist list. A panel switch does not automatically tell you which names are authorized; add those entries separately unless the host’s interface includes an explicit player-management field.

Add and remove players

Add by username

Run:

whitelist add <username>

Replace the angle-bracket placeholder with the exact account name, without the brackets. The guides report that the command accepts an online username. If capitalization, spelling, or punctuation is wrong, the intended account may not be authorized.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by

Remove by username

Run:

whitelist remove <username>

Removal prevents future access for that identity but does not ban the account or erase its world data. If the player is currently connected, disconnect them separately if you need access to end immediately.

Use an offline UUID

The same add and remove operations can use an offline UUID instead of a username, according to the command references. UUIDs are useful for bulk administration or when the player is not online. Copy the UUID exactly; a missing character or an extra space creates a different identity.

whitelist add <offline-UUID>
whitelist remove <offline-UUID>

Do not assume a username and UUID entry are interchangeable. Keep a record of which identifier you used so that later removal targets the same entry.

Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.

Inspect and clear entries

Use these read and maintenance commands:

Command Purpose
whitelist list Displays registered players.
whitelist status Shows whether the whitelist is enabled or disabled.
whitelist clear Clears the registered whitelist entries; treat it as destructive and verify the command in your build before running it.
whitelist disable Turns the whitelist off and makes the server public again.

Run whitelist list after every add or remove operation when you are administering a private event. It gives you a simple audit trail in the console.

Manage access from inside the game

An in-game route is convenient when you are already playing, but it requires an account with permission to execute server commands. Open the server’s command interface, enter the same syntax used by the console, and check the result:

  1. Run whitelist add <username>.
  2. Run whitelist list and verify the name.
  3. Ask the player to reconnect and test access.

If the command is rejected as unknown or unauthorized, use the server console instead. Do not grant operator access broadly just to avoid opening the console; operator permissions can affect the whole world.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Safely edit whitelist.json

For a large roster or an external access-management workflow, the whitelist is reported as a plain JSON array containing authorized players’ UUIDs. The exact directory was not confirmed by the available references, so use your host’s file manager or inspect the server directory rather than assuming a universal path. The Hytale file and folder structure guide can help you identify the server’s data layout, but treat its details as community documentation.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Safe procedure

  1. Stop the server cleanly. Do not edit the file while the process is running.
  2. Make a dated backup. Download or copy the existing whitelist.json before changing anything.
  3. Open the file as text. Preserve valid JSON syntax: brackets, quotation marks, commas, and UUID strings.
  4. Make the smallest change possible. Add or remove only the UUID entries you intend to change. Do not paste a username where the file expects a UUID.
  5. Save as plain JSON. Avoid rich-text editors that can add formatting or a hidden extension.
  6. Start the server. Watch the startup log for JSON or permission errors.
  7. Verify in the console. Run whitelist status and whitelist list, then test with an authorized account.

Manual edits made while the server is running may be overwritten when the server saves its current state. A restart after a file edit is therefore the safe procedure. The available material does not establish a universal file path or guarantee identical reload behavior for every Hytale build.

Example JSON shape

The file is described as an array of UUIDs, not a command script. The following illustrates the shape only; use real UUIDs from your server and do not copy the example value:

[
  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
]

If your server’s file contains a different structure, preserve that structure and rely on the command interface instead of forcing it into this example.

Disable the whitelist temporarily or permanently

To make the server public again, run:

whitelist disable

Check with whitelist status. Disabling the feature normally leaves the saved entries in place, so re-enabling it can restore the previous list; verify that behavior on your build before relying on it for an event. If you need a completely new roster, review the list and change entries explicitly rather than using whitelist clear as a shortcut.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Troubleshoot a Hytale whitelist that does not work

“Unknown command” or syntax error

  • Confirm that you are connected to the Hytale server console, not a host shell or operating-system terminal.
  • Enter the command without a leading slash in the server console. In an in-game command box, use the interface’s normal command format.
  • Check spelling: the documented root is whitelist, followed by enable, disable, add, remove, list, status, or clear.
  • Compare the server build’s command help with the third-party syntax references. There is no identified official command manual in the material available for this guide.

The player is still refused after being added

  • Run whitelist list and confirm the exact account appears.
  • Check for a spelling or capitalization mismatch and try the player’s UUID if username matching is uncertain.
  • Have the player disconnect and reconnect.
  • If you edited the JSON file, stop the server, restore the backup if necessary, and repeat the edit with valid JSON.
  • Check the startup and console log for a malformed file or a failed save.

The server is still public

  • Run whitelist status; adding names does not enable the feature by itself.
  • If you used a host panel, confirm that the setting was saved on the correct server instance.
  • Look for a second proxy, fallback server, or test instance that players may be joining instead.

Everyone was locked out after a file edit

Stop the server, restore the dated backup, start it, and verify the list. If no backup exists, reconstruct the array with the correct UUIDs, validate the JSON syntax, and test one account before inviting the rest. Avoid editing the live file again until the cause is understood.

Operational checklist for private servers

  • Record the server address and the exact Hytale build used when you create the whitelist.
  • Enable the whitelist before publishing the address.
  • Add a test account, verify it can join, and verify an unlisted account is refused.
  • Keep a dated backup of whitelist.json before every manual edit.
  • Use the console for routine one-player changes; use UUIDs and a stopped server for bulk maintenance.
  • Review the list periodically and remove former members with whitelist remove.
  • Limit operator permissions and keep ordinary world backups; a whitelist does not prevent an authorized player from damaging the world.
  • When opening the server publicly, run whitelist disable and confirm the state rather than deleting the file.

Command reference

Goal Command Result to verify
Turn access control on whitelist enable whitelist status reports enabled.
Authorize a username whitelist add <username> Name appears in whitelist list.
Authorize an offline UUID whitelist add <offline-UUID> UUID appears in the list or is accepted by the server.
Revoke a username whitelist remove <username> Name no longer appears in the list.
Revoke an offline UUID whitelist remove <offline-UUID> UUID is removed.
View entries whitelist list Current registered players are displayed.
Check state whitelist status Enabled or disabled state is displayed.
Remove all entries whitelist clear Use only after confirming the command in your server build and retaining a backup.
Make the server public whitelist disable whitelist status reports disabled.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.