SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedAdmin & protection

Better Whitelist

by JFronny · for Minecraft

A configurable whitelist system for Minecraft

3.4KDownloads
2 mo agoLast updated
MITLicense
FabricLoaders

About Better Whitelist

From Modrinth

A configurable whitelist system for Minecraft

Better-Whitelist provides a basic whitelist system for your server that you can adapt to your use case.

The mod is required both on the server and any clients connecting to the server.

The whitelist is configured using μScript, but you don't have to be good at programming to use this mod.

A config file with some additional details will be created when you first start your server with the mod.

A simple config for Better-Whitelist could look as follows (please note that you'd probably have to add exceptions for client-side mods with optional server-side components when using this):

// convert a mod to a simpler representation to save bandwidth
simplify = { mod -> { id = mod.id, version = mod.version } }

// all non-serverside mods present on the server
sharedMods = mods::values()
  ::filter({ v -> v.environment != 'server' & v.id != 'java' })
  ::map(simplify)

// ensure the client has the correct version of every non-serverside mod on the server
clientMissing = challenge({ arg ->
  arg::filter({ v -> !mods::values()::anyMatch({ m -> v.id == m.id & v.version == m.version }) })
}, sharedMods)
assert(clientMissing::isEmpty(), 'You lack required mods: ' || clientMissing)

// ensure the client has no additional mods that would be required on the server
clientAdditional = challenge({ arg, fn ->
  clientSideMods = mods::values()::filter({ v -> v.environment != 'client' & v.id != 'java' })
  clientSideMods::filter({ v -> !arg::anyMatch({ m -> v.id == m.id & v.version == m.version }) })::map(fn)
}, sharedMods, simplify)
assert(clientAdditional::isEmpty(), 'You have unsupported mods: ' || clientAdditional)

// filter resource packs for X-Ray packs
bannedWords = listOf('xray', 'x-ray', 'cheat')
assert(!challenge({ ->
  resourcePacks::map({ pack -> pack.name || ' ' || pack.displayName || ' ' || pack.description })
})::anyMatch({ v -> bannedWords::anyMatch({ word -> v::toLower()::contains(word) }) }), "Please don't cheat, " || user.name)

The following things are available to your scripts:

  • All methods from the μScript standard library (including date/time, meaning you can temporarily whitelist or blacklist users or create countdowns)
  • resourcePacks (client only): a list of resource packs, each of which has a name, displayName and description
  • println('message') (both): a function for debugging
  • mods (both): a list of loaded mods with the same fields as the result of mod()
  • mod('id') (both): information about a specific mod (or null): id, name, description, authors (list of strings), contributors (list of strings), version, environment (either client, server or *), license, contact (same as FMJ), depends (list of strings)
  • assert(bool) (server): assert that something is true and kick the player if it's not (optionally, add a message as the second parameter)
  • challenge({->closure}, additional arguments...) (server): send a closure to the client to be executed there. The arguments may contain other closures.
  • user (server): information about the user trying to log in, namely their id and name

Highlights

From source data

Game versions

Supports 25 Minecraft versions, the newest being 26.3.

Loaders

Runs on Fabric.

Footprint

Rated a light load on a server.

Better Whitelist on Nxeon

From our catalogue
One-click install
Supported on Nxeon Minecraft servers. We download it from Modrinth, place it, and restart the server.
Server side
Required on the server
Server type needed
Fabric
Server load
light
Smallest plan we suggest
Minecraft — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
26.3.0, released 2026-09-15

Game versions by loader

LoaderGame versionsNewest
Fabric1.21.10 to 26.3 (7 versions)26.3

From 5 recorded builds of Better Whitelist.

Recent builds

BuildReleasedGame versionsLoaders
26.3.02026-09-1526.3Fabric
26.2.02026-06-1726.2Fabric
26.1.02026-03-2826.1 to 26.1.2 (3 versions)Fabric
1.0.152025-12-101.21.11Fabric
1.0.142025-10-091.21.10Fabric

Dependencies

  • Required: modrinth project P7dR8mSH (modrinth, not in our catalogue)
  • Required: modrinth project WKwQAwke (modrinth, not in our catalogue)

Declared by the newest build that lists any. Required ones are installed with it on one-click installs.

Run Better Whitelist on a Minecraft server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Modrinth as “Mods”

Admin & protection

Permissions, moderation, anti-cheat and land protection for the people running the server.

Runs on your server

From source side support

Modrinth lists Better Whitelist as required on the server. Check its Modrinth page to see whether players need it too.

Compatibility

Game
Minecraft
Loaders
Fabric
Runs on
Serverrequired on the server
Game versions
26.3 and 24 earlier

Verified at the source

  • ✓ModrinthOfficial listing, checked 2026-10-17Open ↗
  • ✓AuthorJFronny, as published on Modrinth
  • ✓LicenseMITFree

Better Whitelist, answered

Generated from the mod’s own source data.

Do my players need to install Better Whitelist?

Modrinth lists Better Whitelist as required on the server. Check its Modrinth page to see whether players need it too.

Which loaders does it support?

Fabric.

Is it free?

Yes. Better Whitelist is free to download from Modrinth. Its license is MIT.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Better Whitelist on a Minecraft server.

Deploy in about a minute from $4.20 a month, then add Better Whitelist in one click.