Configuration
- File:
nutecclans-synced.toml, a synced config.- The global copy is in the game's
configfolder. A copy in the world's synced-config folder overrides it . - The server loads it on start and sends it to clients when they connect.
- The global copy is in the game's
- Scope: every option is a server setting. There are no client or common configs.
- In game: the options can also be edited in the in-game mod config screen ("NuTec Clans server settings").
| Section | Name | Default | Range | What it changes |
| terminology | groupName | Clan | one word, letters only, 1–24 chars | The word used in all text, menus and the command |
| terminology | groupNamePlural | empty | one word or empty | Plural; empty builds it automatically (Clan → Clans, Army → Armies) |
| terminology | commandRootOverride | empty | lowercase letters, digits, _ | Use this command name instead of the automatic one |
| terminology | commandAliases | empty list | names as above, up to 32 chars | Extra command names |
| groups | oneGroupPerPlayer | true | — | One clan per player |
| groups | nameMinLength | 3 | 1–64 | Shortest clan name |
| groups | nameMaxLength | 24 | 1–64 | Longest clan name |
| groups | disbandConfirmSeconds | 30 | 5–600 | Time to confirm a disband |
| groups | inviteExpireMinutes | 10 | 1–1440 | How long invites last |
| groups | motdMaxLength | 200 | 10–1000 | Longest message of the day |
| groups | descriptionMaxLength | 500 | 10–2000 | Longest members-only description |
| groups | statementMaxLength | 300 | 10–2000 | Longest public statement |
| groups | textMaxLines | 12 | 1–50 | Most lines in MOTD, description, statement and board posts |
| groups | maxRanks | 10 | 2–64 | Most ranks per clan, top rank included |
| groups | joinRequestExpireDays | 7 | 1–365 | When unanswered join requests are removed |
| groups | maxPendingRequests | 5 | 1–50 | Open join requests per player |
| groups | maxMembers | 0 | 0–10000 | Most members per clan (0 = no limit) |
| claims | baseClaims | 9 | 0–100000 | Chunks every clan may claim |
| claims | claimsPerMember | 3 | 0–100000 | Extra chunks per member |
| claims | maxClaims | 100 | 0–1000000 | Claim cap (0 = none) |
| claims | overLimitAction | KEEP | KEEP, UNCLAIM, GRACE | What happens when a clan is over its limit |
| claims | overLimitGraceHours | 48 | 1–8760 | Hours of server time for GRACE |
| claims | requireAdjacent | false | — | New claims must touch existing ones |
| claims | requireConnectedToHome | false | — | All claims must connect to the home chunk |
| claims | maxClaimDistance | 0 | 0–100000 | Max distance (chunks) from the player for map claims (0 = any) |
| claims | spawnProtectionRadius | 100 | 0–100000 | No claiming within this many blocks of world spawn (0 = off) |
| claims | bufferChunks | 0 | 0–16 | Minimum gap between different clans' land |
| claims | dimensionsAreAllowList | false | — | false = dimensions is a deny list; true = allow list |
| claims | dimensions | empty | dimension ids | Dimensions for the list above |
| claims | mapRadius | 8 | 2–32 | Starting zoom of the claim map (chunks each way) |
| protection | building | true | — | Building, using and pickup protection on claims |
| protection | noFriendlyFire | true | — | Members and allies can't hurt each other |
| protection | explosions | true | — | Explosion protection |
| protection | fire | true | — | Fire protection |
| protection | fluids | true | — | Outside fluid protection |
| protection | pistons | true | — | Outside piston protection |
| protection | mobGriefing | true | — | Mob griefing protection |
| protection | allowedLandOptions | all 12 ids | land option ids | Land options clans may use |
| protection | deniedMessage | true | — | Show "blocked" messages above the hotbar |
| containers | logSize | 100 | 10–1000 | Log entries per container |
| containers | logMaxDays | 30 | 1–365 | Days container log entries are kept |
| containers | auditLogSize | 500 | 50–10000 | Entries in each clan's history |
| containers | auditLogMaxDays | 60 | 1–3650 | Days history entries are kept |
| board | maxPostLength | 500 | 10–4000 | Longest post |
| board | maxPosts | 100 | 5–1000 | Posts kept per board |
| board | chatNotice | true | — | Chat notice for new posts |
| board | loginNotice | true | — | Unread notice on login |
| extras | chatTag | true | — | [Clan] tag in public chat |
| extras | homeWarmupSeconds | 5 | 0–120 | Standing still before teleporting home |
| extras | homeCooldownSeconds | 60 | 0–86400 | Time between home teleports |
| extras | homeAcrossDimensions | true | — | Allow going home from another dimension |
| extras | territoryMessages | TITLE | TITLE, ACTIONBAR, OFF | Messages when entering land |
| display | showRankAboveName | true | — | Rank above member name tags |
| display | showMemberLocation | true | — | Members' dimension in the roster |
| display | showPlayersOnMap | true | — | Own and allied members on the claim map |
Last updated November 12, 2026