# ============================================================ # MojangWhitelist.sk # Fetches UUIDs from Mojang API and writes to whitelist.json # Place in: plugins/Skript/scripts/ # Reload with: /sk reload MojangWhitelist # ============================================================ # # REQUIREMENTS: # - Skript # - SkBee (for JSON/file writing) # - Skellett OR Skript-http (for HTTP requests) # # SETUP: # 1. Make sure white-list=true is in server.properties # 2. Make sure enforce-whitelist=true is in server.properties # 3. The whitelist.json must already exist in server root # (start the server once vanilla to generate it) # # COMMANDS: # /wl add - Whitelist a player by name # /wl remove - Remove a player from the whitelist # /wl list - List all whitelisted players # /wl reload - Reload the vanilla whitelist in-memory # # PERMISSIONS: # mojangwl.use - Access to all /wl commands (default: op) # ============================================================ options: # Path to whitelist.json relative to server root whitelist_path: whitelist.json # Mojang UUID lookup API endpoint mojang_api: https://api.mojang.com/users/profiles/minecraft/ # Prefix for all messages prefix: &8[&bWhitelist&8]&r # Colors c_success: &a c_error: &c c_info: &e c_name: &b c_muted: &7 # ============================================================ # SCRIPT LOAD # ============================================================ on script load: send "{@prefix} &aMojangWhitelist loaded." to console send "{@prefix} &7Whitelist file: &f{@whitelist_path}" to console # ============================================================ # MAIN COMMAND # ============================================================ command /wl []: permission: mojangwl.use permission message: {@prefix} {@c_error}You don't have permission to use this command. trigger: # --- /wl list --- if arg-1 is "list": execute console command "whitelist list" set {_raw} to file contents of "{@whitelist_path}" if {_raw} is not set: send "{@prefix} {@c_error}Could not read whitelist.json." to player stop # Count entries by counting "uuid" occurrences set {_count} to 0 loop (split {_raw} by "\"uuid\""): add 1 to {_count} # subtract 1 for the part before the first entry subtract 1 from {_count} send "{@prefix} {@c_info}There are {@c_name}%{_count}%{@c_info} player(s) on the whitelist." to player send "{@prefix} {@c_muted}Use &f/whitelist list &7to see all names." to player stop # --- /wl reload --- if arg-1 is "reload": execute console command "whitelist reload" send "{@prefix} {@c_success}Vanilla whitelist reloaded." to player stop # --- /wl add --- if arg-1 is "add": if arg-2 is not set: send "{@prefix} {@c_error}Usage: /wl add " to player stop set {_name} to arg-2 send "{@prefix} {@c_info}Looking up UUID for {@c_name}%{_name}%{@c_info}..." to player set {MojangWL.pending::%player%} to {_name} make console execute command "wl-lookup %{_name}% %player%" stop # --- /wl remove --- if arg-1 is "remove": if arg-2 is not set: send "{@prefix} {@c_error}Usage: /wl remove " to player stop set {_name} to arg-2 set {_removed} to wl_remove({_name}) if {_removed} is true: send "{@prefix} {@c_success}Removed {@c_name}%{_name}%{@c_success} from the whitelist." to player execute console command "whitelist reload" else: send "{@prefix} {@c_error}Player {@c_name}%{_name}%{@c_error} was not found on the whitelist." to player stop # --- Unknown subcommand --- send "{@prefix} {@c_error}Unknown subcommand. Use: add, remove, list, reload" to player # ============================================================ # INTERNAL LOOKUP COMMAND (console-only, hidden) # Triggers the async HTTP fetch then calls the write function # ============================================================ command /wl-lookup : executable by: console trigger: set {_name} to arg-1 set {_requester} to arg-2 # Fetch UUID from Mojang API # SkBee's HTTP request syntax: fetch "{@mojang_api}%{_name}%" with headers {} and store result in {_response} if {_response} is not set: send "{@prefix} {@c_error}Mojang API did not respond. Is the name correct?" to {_requester} parsed as player stop # Parse UUID and canonical name from JSON response # Response format: {"id":"","name":""} set {_uuid_raw} to {_response} parsed as json set {_uuid_nd} to json value "id" of {_uuid_raw} set {_exact} to json value "name" of {_uuid_raw} if {_uuid_nd} is not set: send "{@prefix} {@c_error}Player {@c_name}%{_name}%{@c_error} not found on Mojang. Check the spelling." to {_requester} parsed as player stop # Convert raw UUID (no dashes) to standard dashed format # xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx set {_u1} to first 8 characters of {_uuid_nd} set {_u2} to substring of {_uuid_nd} from character 9 to 12 set {_u3} to substring of {_uuid_nd} from character 13 to 16 set {_u4} to substring of {_uuid_nd} from character 17 to 20 set {_u5} to last 12 characters of {_uuid_nd} set {_uuid} to "%{_u1}%-%{_u2}%-%{_u3}%-%{_u4}%-%{_u5}%" # Write to whitelist.json set {_written} to wl_add({_uuid}, {_exact}) if {_written} is true: send "{@prefix} {@c_success}Added {@c_name}%{_exact}%{@c_success} (%{_uuid}%) to the whitelist." to {_requester} parsed as player execute console command "whitelist reload" send "{@prefix} {@c_success}Vanilla whitelist reloaded." to {_requester} parsed as player else if {_written} is "exists": send "{@prefix} {@c_info}Player {@c_name}%{_exact}%{@c_info} is already on the whitelist." to {_requester} parsed as player else: send "{@prefix} {@c_error}Failed to write to whitelist.json. Check console for details." to {_requester} parsed as player # ============================================================ # FUNCTION: wl_add # Adds a UUID + name entry to whitelist.json # Returns: true (added), "exists" (already listed), false (error) # ============================================================ function wl_add(uuid: text, name: text) :: object: set {_path} to "{@whitelist_path}" set {_raw} to file contents of {_path} if {_raw} is not set: send "[MojangWhitelist] ERROR: Cannot read %{_path}%" to console return false # Check if UUID already present (avoid duplicates) if {_raw} contains {_uuid}: return "exists" # Build the new entry JSON set {_entry} to "{""uuid"":""%{_uuid}%"",""name"":""%{_name}%""}" # Inject into the JSON array # whitelist.json is a flat array: [ {...}, {...} ] # Strategy: strip trailing ] and whitespace, append new entry, close array set {_trimmed} to {_raw} # Remove trailing whitespace / newlines then strip closing bracket replace all " " in {_trimmed} with "" replace all " " in {_trimmed} with "" # Find if the array is empty if {_trimmed} is "[]": set {_new} to "[%nl%%{_entry}%%nl%]" else: # Remove last ] and append comma + new entry set {_len} to length of {_trimmed} set {_base} to first ({_len} - 1) characters of {_trimmed} set {_new} to "%{_base}%,%nl%%{_entry}%%nl%]" write {_new} to file {_path} if last error is set: send "[MojangWhitelist] ERROR writing whitelist: %last error%" to console return false return true # ============================================================ # FUNCTION: wl_remove # Removes a player by name from whitelist.json # Returns: true (removed), false (not found / error) # ============================================================ function wl_remove(name: text) :: boolean: set {_path} to "{@whitelist_path}" set {_raw} to file contents of {_path} if {_raw} is not set: send "[MojangWhitelist] ERROR: Cannot read %{_path}%" to console return false # Check if name is present (case-sensitive as Mojang returns it) if {_raw} does not contain """name"":""%{_name}%""": return false # Split lines and rebuild array excluding the matched entry block. # whitelist.json is typically formatted as one entry per line group. # We rebuild by filtering out the object containing this name. set {_lines::*} to {_raw} split by nl set {_out::*} to {} set {_skip} to false set {_found} to false loop {_lines::*}: set {_line} to loop-value # Detect start of an entry block if {_line} contains "{": if {_line} contains """name"":""%{_name}%""": set {_skip} to true set {_found} to true if {_skip} is false: add {_line} to {_out::*} # Detect end of entry block if {_line} contains "}": if {_skip} is true: set {_skip} to false if {_found} is false: return false # Clean up double commas that may appear after removal set {_joined} to join {_out::*} with nl replace all ",," in {_joined} with "," replace all ",%nl%]" in {_joined} with "%nl%]" replace all "[%nl%," in {_joined} with "[%nl%" write {_joined} to file {_path} if last error is set: send "[MojangWhitelist] ERROR writing whitelist: %last error%" to console return false return true # ============================================================ # OPTIONAL: Block non-whitelisted players at join # (Handles the in-memory gap before /whitelist reload fires) # ============================================================ on player login: set {_raw} to file contents of "{@whitelist_path}" if {_raw} is not set: stop set {_uuid} to uuid of player if {_raw} does not contain "%{_uuid}%": cancel event set join message to "" kick player due to "&cYou are not whitelisted on this server."