{"id":29719,"date":"2026-06-01T15:20:44","date_gmt":"2026-06-01T12:20:44","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/better-whitelist\/"},"modified":"2026-06-01T15:20:44","modified_gmt":"2026-06-01T12:20:44","slug":"better-whitelist","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/better-whitelist\/","title":{"rendered":"Better Whitelist"},"content":{"rendered":"

Better-Whitelist provides a basic whitelist system for your server that you can adapt to your use case.<\/p>\n

The mod is required both on the server and any clients connecting to the server.<\/p>\n

The whitelist is configured using \u03bcScript, but you don’t have to be good at programming to use this mod.<\/p>\n

A config file with some additional details will be created when you first start your server with the mod.<\/p>\n

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):
\n“`
\n\/\/ convert a mod to a simpler representation to save bandwidth
\nsimplify = { mod -> { id = mod.id, version = mod.version } }<\/p>\n

\/\/ all non-serverside mods present on the server
\nsharedMods = mods::values()
\n ::filter({ v -> v.environment != ‘server’ & v.id != ‘java’ })
\n ::map(simplify)<\/p>\n

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

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

\/\/ filter resource packs for X-Ray packs
\nbannedWords = listOf(‘xray’, ‘x-ray’, ‘cheat’)
\nassert(!challenge({ ->
\n resourcePacks::map({ pack -> pack.name || ‘ ‘ || pack.displayName || ‘ ‘ || pack.description })
\n})::anyMatch({ v -> bannedWords::anyMatch({ word -> v::toLower()::contains(word) }) }), “Please don’t cheat, ” || user.name)
\n“`<\/p>\n

The following things are available to your scripts:
\n– All methods from the \u03bcScript standard library (including date\/time, meaning you can temporarily whitelist or blacklist users or create countdowns)
\n– `resourcePacks` (client only): a list of resource packs, each of which has a `name`, `displayName` and `description`
\n– `println(‘message’)` (both): a function for debugging
\n– `mods` (both): a list of loaded mods with the same fields as the result of `mod()`
\n– `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)
\n– `assert(bool)` (server): assert that something is true and kick the player if it’s not (optionally, add a message as the second parameter)
\n– `challenge({->closure}, additional arguments…)` (server): send a closure to the client to be executed there. The arguments may contain other closures.
\n– `user` (server): information about the user trying to log in, namely their `id` and `name`
\n

<\/p>\n

\"Suggestions<\/p>\n

<\/center><\/p>\n","protected":false},"excerpt":{"rendered":"

A configurable whitelist system for Minecraft<\/p>\n","protected":false},"featured_media":29720,"template":"","meta":{"_minecraft_slug":"better-whitelist","_minecraft_project_id":"FXyXxB6A","_minecraft_author":"JFronny","_minecraft_license":"MIT","_minecraft_downloads":2449,"_minecraft_follows":12,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"better-whitelist.zip","_minecraft_size_bytes":6141052,"_minecraft_version_count":17,"_minecraft_updated_at":"2026-05-15T19:56:14.317606Z","_minecraft_date_created":"2023-03-14T23:34:28.820170Z","_minecraft_date_modified":"2026-03-28T22:48:01.917082Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/better-whitelist","_minecraft_icon_attachment_id":29720,"_minecraft_imported_at":"2026-06-01T12:20:45+00:00","_minecraft_import_hash":"3d351b97d0380d65856686d65b23eee1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,126],"mod_loader":[99],"minecraft_version":[58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-29719","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-management","mod_loader-fabric","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\nBetter Whitelist - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/better-whitelist\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Better Whitelist - Minecraft\" \/>\n<meta property=\"og:description\" content=\"A configurable whitelist system for Minecraft\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/better-whitelist\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta property=\"og:image\" content=\"https:\/\/img.shields.io\/badge\/Suggestions%20and%20Support-red?style=for-the-badge&logo=matrix\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/better-whitelist\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/better-whitelist\\\/\",\"name\":\"Better Whitelist - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/better-whitelist\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/better-whitelist\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/better-whitelist-icon-230bac478c0629ac65e4308d06e642753d791fe9_96.webp\",\"datePublished\":\"2026-06-01T12:20:44+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/better-whitelist\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/better-whitelist\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/better-whitelist\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/better-whitelist-icon-230bac478c0629ac65e4308d06e642753d791fe9_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/better-whitelist-icon-230bac478c0629ac65e4308d06e642753d791fe9_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/better-whitelist\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Better Whitelist\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Better Whitelist - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/better-whitelist\/","og_locale":"en_US","og_type":"article","og_title":"Better Whitelist - Minecraft","og_description":"A configurable whitelist system for Minecraft","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/better-whitelist\/","og_site_name":"Minecraft","og_image":[{"url":"https:\/\/img.shields.io\/badge\/Suggestions%20and%20Support-red?style=for-the-badge&logo=matrix","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/better-whitelist\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/better-whitelist\/","name":"Better Whitelist - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/better-whitelist\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/better-whitelist\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/better-whitelist-icon-230bac478c0629ac65e4308d06e642753d791fe9_96.webp","datePublished":"2026-06-01T12:20:44+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/better-whitelist\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/better-whitelist\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/better-whitelist\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/better-whitelist-icon-230bac478c0629ac65e4308d06e642753d791fe9_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/better-whitelist-icon-230bac478c0629ac65e4308d06e642753d791fe9_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/better-whitelist\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"Better Whitelist"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/29719","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/29720"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=29719"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=29719"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=29719"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=29719"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}