▌ Xplayername — Overview
Price (20€)
[ Name Control ]
• Enforces rules during character creation
• Rejects invalid names (no kick, returns to creation)
• Max length limit (e.g.
[ Character Filters ]
• Control allowed: Letters / Numbers / Spaces / Symbols / Unicode
• Includes English + Spanish letters (
• Optional Unicode support for other languages
• Blocks control chars (tabs/newlines always denied)
[ Formatting Rules ]
• Toggle numbers (e.g.
• Toggle spaces (
• Toggle keyboard symbols (
[ Reserved Names ]
• Case-insensitive protected names
→ Blocks:
• SteamID whitelist for allowed users
[ Banned Names ]
• External file:
• Match modes:
→
→
[ Player Feedback ]
• Custom messages for:
→ too long / invalid chars / reserved / banned
[ System Tools ]
• Live config reload (re-reads banned names file)
---
▌ Commands (Ingame + RCON)
---
[ Notes ]
• Use reasonable max length for clean names
• Allow letters/numbers/spaces for normal servers
• Disable symbols for stricter naming
• Use reserved + banned lists for moderation
Price (20€)
[ Name Control ]
• Enforces rules during character creation
• Rejects invalid names (no kick, returns to creation)
• Max length limit (e.g.
16) with {max_length} message[ Character Filters ]
• Control allowed: Letters / Numbers / Spaces / Symbols / Unicode
• Includes English + Spanish letters (
A-Z, Ñ, Á, Ü, etc.)• Optional Unicode support for other languages
• Blocks control chars (tabs/newlines always denied)
[ Formatting Rules ]
• Toggle numbers (e.g.
player123)• Toggle spaces (
Juan Carlos)• Toggle keyboard symbols (
!@#$...)[ Reserved Names ]
• Case-insensitive protected names
→ Blocks:
pepe, PEPE, PePe• SteamID whitelist for allowed users
[ Banned Names ]
• External file:
banned_names.txt• Match modes:
→
Contains (partial match)→
Exact (full match only)[ Player Feedback ]
• Custom messages for:
→ too long / invalid chars / reserved / banned
[ System Tools ]
• Live config reload (re-reads banned names file)
---
▌ Commands (Ingame + RCON)
xplayername.reload → reload config---
[ Notes ]
• Use reasonable max length for clean names
• Allow letters/numbers/spaces for normal servers
• Disable symbols for stricter naming
• Use reserved + banned lists for moderation
{
"NameLimit": { // Survivor creation name length limit.
"Enabled": true, // true = block names longer than MaxLength. false = allow all names.
"MaxLength": 16, // Maximum character count allowed for the survivor name.
"RejectMessage": "Your survivor name is too long. Maximum allowed length: {max_length}.", // Message shown when creation is rejected. Placeholder: {max_length}.
"NotificationScale": 1.4, // On-screen notification text size.
"NotificationSeconds": 8.0, // How long the warning is shown.
"Debug": false // true = log accepted/rejected names for testing.
},
"AllowedCharacters": { // Character whitelist for survivor names.
"Enabled": true, // true = validate each character. false = only length/reserved-name checks apply.
"AllowLetters": true, // Allows English and Spanish letters: A-Z, a-z, Ñ, ñ, ÁÉÍÓÚ, áéíóú, Ü, ü.
"AllowUnicodeLetters": false, // true = allow letters from all languages. false = only English/Spanish letters above.
"AllowNumbers": true, // Allows 0-9.
"AllowSpaces": true, // Allows normal spaces. Tabs/newlines/control characters are always blocked.
"AllowKeyboardSymbols": false, // Allows normal ASCII keyboard symbols: !\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~
"RejectMessage": "Your survivor name contains characters that are not allowed." // Message shown for blocked characters.
},
"ReservedNames": { // Exact reserved survivor names.
"Enabled": true, // true = block names in Names unless SteamID is in AllowSteamIDs.
"AllowSteamIDs": [ // SteamIDs allowed to use reserved names. They still must pass length/character checks.
7678632846832234,
785263483284876
],
"Names": [ // Reserved names are checked case-insensitively. Put numbers inside quotes for valid JSON.
"123",
"pepe",
"roro"
],
"RejectMessage": "This survivor name is reserved. Please pick a different name." // Message shown for reserved names.
},
"BannedNames": { // Text-file driven banned name/word list. Loaded once when the plugin loads.
"Enabled": true, // true = check survivor names against the banned_names.txt list.
"File": "banned_names.txt", // File path inside ArkApi/Plugins/Xplayername. Absolute paths are also supported.
"MatchMode": "Contains", // Contains = block if the survivor name contains any listed text. Exact = full-name match only.
"RejectMessage": "This survivor name is not allowed. Please pick a different name." // Message shown for banned names.
}
}
"NameLimit": { // Survivor creation name length limit.
"Enabled": true, // true = block names longer than MaxLength. false = allow all names.
"MaxLength": 16, // Maximum character count allowed for the survivor name.
"RejectMessage": "Your survivor name is too long. Maximum allowed length: {max_length}.", // Message shown when creation is rejected. Placeholder: {max_length}.
"NotificationScale": 1.4, // On-screen notification text size.
"NotificationSeconds": 8.0, // How long the warning is shown.
"Debug": false // true = log accepted/rejected names for testing.
},
"AllowedCharacters": { // Character whitelist for survivor names.
"Enabled": true, // true = validate each character. false = only length/reserved-name checks apply.
"AllowLetters": true, // Allows English and Spanish letters: A-Z, a-z, Ñ, ñ, ÁÉÍÓÚ, áéíóú, Ü, ü.
"AllowUnicodeLetters": false, // true = allow letters from all languages. false = only English/Spanish letters above.
"AllowNumbers": true, // Allows 0-9.
"AllowSpaces": true, // Allows normal spaces. Tabs/newlines/control characters are always blocked.
"AllowKeyboardSymbols": false, // Allows normal ASCII keyboard symbols: !\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~
"RejectMessage": "Your survivor name contains characters that are not allowed." // Message shown for blocked characters.
},
"ReservedNames": { // Exact reserved survivor names.
"Enabled": true, // true = block names in Names unless SteamID is in AllowSteamIDs.
"AllowSteamIDs": [ // SteamIDs allowed to use reserved names. They still must pass length/character checks.
7678632846832234,
785263483284876
],
"Names": [ // Reserved names are checked case-insensitively. Put numbers inside quotes for valid JSON.
"123",
"pepe",
"roro"
],
"RejectMessage": "This survivor name is reserved. Please pick a different name." // Message shown for reserved names.
},
"BannedNames": { // Text-file driven banned name/word list. Loaded once when the plugin loads.
"Enabled": true, // true = check survivor names against the banned_names.txt list.
"File": "banned_names.txt", // File path inside ArkApi/Plugins/Xplayername. Absolute paths are also supported.
"MatchMode": "Contains", // Contains = block if the survivor name contains any listed text. Exact = full-name match only.
"RejectMessage": "This survivor name is not allowed. Please pick a different name." // Message shown for banned names.
}
}
