Server documentation

BetterClaim

In Development

Hytale • Version 1.1.0

Complete setup guide for server owners: commands, hierarchical permissions, configuration reference, and admin workflows.

Mod overview CurseForge

This page is the full server administration guide for BetterClaim. It covers every command, permission node, configuration option, and common setup patterns for Hytale server owners.

Disclaimer: Mod inspired by SimpleClaims.

Installation

Download BetterClaim-x.x.x.jar from the CurseForge Files tab
Place the JAR in your server’s mods/ folder (or Hytale user mods folder for singleplayer)
Start the server, config is generated at plugins/BetterClaim/config.json
Grant permissions to your player groups (see Permissions below)
Use /bc in-game to open the territory map

Singleplayer: use /perm group add OP betterclaim.gui (and other nodes as needed) to grant yourself access.

Admin Commands

Main command: /bc (alias: /betterclaim)

Player commands are listed on the mod overview page.

Command	Description
`/bc admin`	Opens the admin player list GUI
`/bc admin players`	Select a target player for admin actions
`/bc admin chunk`	Opens the claim map in admin mode for the selected target
`/bc admin party`	Edit any party as admin
`/bc admin claim`	Claims the current chunk for the selected target player
`/bc admin unclaim`	Unclaims the current chunk for the selected target player
`/bc admin override`	Toggles ignoring claim limits while using admin tools
`/bc admin set-limit <player> <limit>`	Sets a persistent claim limit override
`/bc admin add-limit <player> <amount>`	Adds bonus claim chunks to a player
`/bc admin create-party <player> [name]`	Creates a party for a player

Admin chunk mode: run /bc admin players first to select a target, then use /bc admin chunk or the admin claim/unclaim commands.

Permissions

BetterClaim uses hierarchical permissions. Granting a parent node also grants all its children.

Command Permissions

Permission	Grants access to
`betterclaim.gui`	`/bc` — territory map GUI
`betterclaim.claim`	`/bc claim` and claim clicks in GUI
`betterclaim.unclaim`	`/bc unclaim` and unclaim clicks in GUI
`betterclaim.home`	`/bc sethome`, `/bc home`, `/bc delhome`, `/bc homes`
`betterclaim.party`	All party subcommands (parent node)
`betterclaim.party.edit`	`/bc party` — party GUI
`betterclaim.party.create`	`/bc party create`
`betterclaim.party.invite`	`/bc party invite`
`betterclaim.party.accept`	`/bc party accept`
`betterclaim.party.decline`	`/bc party decline`
`betterclaim.party.leave`	`/bc party leave`
`betterclaim.party.kick`	`/bc party kick`
`betterclaim.party.transfer`	`/bc party transfer`
`betterclaim.party.disband`	`/bc party disband`
`betterclaim.admin`	All admin subcommands (parent node)
`betterclaim.admin.players`	`/bc admin`, `/bc admin players`
`betterclaim.admin.chunk`	`/bc admin chunk`
`betterclaim.admin.party`	`/bc admin party`
`betterclaim.admin.claim`	`/bc admin claim`
`betterclaim.admin.unclaim`	`/bc admin unclaim`
`betterclaim.admin.override`	`/bc admin override`
`betterclaim.admin.set-limit`	`/bc admin set-limit`
`betterclaim.admin.add-limit`	`/bc admin add-limit`
`betterclaim.admin.create-party`	`/bc admin create-party`

Dynamic Permissions

When a player has multiple matching nodes, the highest value wins.

Permission	Description
`betterclaim.limit.N`	Base claim limit (e.g. `betterclaim.limit.10` = 10 chunks). For parties, only the party owner is checked.
`betterclaim.playtime.minutes`	Minutes of playtime required to gain one bonus claim chunk. Overrides config when greater than 0.
`betterclaim.admin.max-add-limit.N`	Maximum total claim limit reachable via `/bc admin add-limit` for that admin.

Limit Calculation Order

Admin /bc admin set-limit override (database) — highest priority
Permission betterclaim.limit.<N> (highest value)
Config defaultClaimLimit
Playtime bonus chunks (if enabled)
Admin /bc admin add-limit bonus chunks
Capped by config maxClaimLimit (unless admin override mode is active)

Quick Setup with Hytale /perm

Default players (Adventure group example):

/perm group add Adventure betterclaim.gui
/perm group add Adventure betterclaim.claim
/perm group add Adventure betterclaim.unclaim
/perm group add Adventure betterclaim.home
/perm group add Adventure betterclaim.party
/perm group add Adventure betterclaim.limit.10

Staff / admins (OP group example):

/perm group add OP betterclaim.admin

LuckPerms Example

/lp group default permission set betterclaim.gui true
/lp group default permission set betterclaim.party true
/lp group default permission set betterclaim.limit.10 true
/lp group admin permission set betterclaim.admin true
/lp user <player> permission set betterclaim.playtime.120 true

Configuration

Config file: plugins/BetterClaim/config.json (auto-generated on first run)

Claim Limits

Option	Default	Description
`defaultClaimLimit`	`5`	Starting claim limit per player
`maxClaimLimit`	`50`	Hard cap on total claims (unless admin override)
`enablePlaytimeClaimGain`	`true`	Enable bonus chunks from playtime
`claimGainMinutes`	`600`	Minutes of playtime per bonus chunk
`scaleClaimLimitByPartyMembers`	`false`	Scale limit by party size
`showPartyTotalClaims`	`false`	Show party total instead of personal count in GUI

Party

Option	Default	Description
`maxPartyMembers`	`10`	Maximum members per party
`maxPartyAllies`	`-1`	Maximum allies (-1 = unlimited)
`enableAllySystem`	`true`	Enable player/party allies

Zone Titles & Sounds

Option	Default	Description
`wildernessName`	`Wilderness`	Name shown for unclaimed areas
`titleTopText`	(empty)	Optional text shown above zone titles
`personalClaimSubtitle`	`Personal Claim`	Subtitle for personal claims
`enableZoneTitles`	`true`	Show zone title on entry
`showWildernessZoneTitle`	`true`	Show title when entering wilderness
`enableClaimEntrySound`	`true`	Play sound on claim entry
`claimEntrySoundOncePerZone`	`true`	Only once per zone visit
`claimEntrySoundId`	`SFX_Discovery_Z1_Short`	Sound ID

Map & Visuals

Option	Default	Description
`enableCustomMap`	`true`	Terrain map in /bc GUI
`mapOverlayAlpha`	`0.4`	World map claim overlay opacity
`guiMapResolutionScale`	`0.75`	GUI map resolution (0.1–1.0)
`guiMapCacheTtlSeconds`	`120`	Map image cache TTL in seconds
`enableParticleBorders`	`true`	Particle borders at chunk edges
`useLegacyViewUi`	`false`	Use legacy territory GUI layout
`useLegacyPartyUi`	`false`	Use legacy party GUI layout

Homes

Option	Default	Description
`maxHomes`	`5`	Maximum homes per player
`homeCooldownSeconds`	`5`	Teleport cooldown

Global Protection

Option	Default	Description
`protectBuckets`	`true`	Protect against bucket use in claims
`protectBenches`	`true`	Protect crafting benches
`protectTamedEntities`	`true`	Protect tamed entities
`blocksThatIgnoreInteractRestrictions`	`gravestone, tombstone, corpse, loot_chest`	Blocks always interactable

Default Party Protection (new parties)

Option	Default	Description
`defaultPartyBlockPlaceEnabled`	`false`	Allow non-members to place blocks
`defaultPartyBlockBreakEnabled`	`false`	Allow non-members to break blocks
`defaultPartyBlockInteractEnabled`	`false`	Allow non-members to interact with blocks
`defaultPartyPVPEnabled`	`false`	Allow PVP in party claims
`defaultPartyFriendlyFireEnabled`	`false`	Allow friendly fire between members
`defaultPartyInteractChest`	`false`	Allow non-members to open chests
`defaultPartyInteractDoor`	`false`	Allow non-members to use doors
`defaultPartyInteractBench`	`false`	Allow non-members to use benches
`defaultPartyInteractChair`	`false`	Allow non-members to use chairs
`defaultPartyInteractPortal`	`false`	Allow non-members to use portals
`defaultPartyTamedDamageEnabled`	`false`	Allow non-members to damage tamed entities

Party Owner Toggles

Option	Default	Description
`allowPartyPlaceBlockSetting`	`true`	Owner can toggle block placing for non-members
`allowPartyBreakBlockSetting`	`true`	Owner can toggle block breaking for non-members
`allowPartyInteractBlockSetting`	`true`	Owner can toggle block interaction for non-members
`allowPartyPVPSetting`	`true`	Owner can toggle PVP
`allowPartyFriendlyFireSetting`	`true`	Owner can toggle friendly fire
`allowPartyInteractChestSetting`	`true`	Owner can toggle chest access
`allowPartyInteractDoorSetting`	`true`	Owner can toggle door access
`allowPartyInteractBenchSetting`	`true`	Owner can toggle bench access
`allowPartyInteractChairSetting`	`true`	Owner can toggle chair access
`allowPartyInteractPortalSetting`	`true`	Owner can toggle portal access
`allowPartyTamedDamageSetting`	`true`	Owner can toggle tamed entity damage

Example config.json

{
  "configVersion": 21,
  "defaultClaimLimit": 5,
  "maxClaimLimit": 50,
  "enablePlaytimeClaimGain": true,
  "claimGainMinutes": 600,
  "maxPartyMembers": 10,
  "maxPartyAllies": -1,
  "enableAllySystem": true,
  "enableCustomMap": true,
  "enableParticleBorders": true,
  "maxHomes": 5,
  "homeCooldownSeconds": 5
}

See the full default config inside plugins/BetterClaim/config.json after first launch.

Notes

GUI claim/unclaim requires betterclaim.claim / betterclaim.unclaim in addition to any party-internal permission.
Admin chunk mode requires selecting a target first with /bc admin players.
Admin override only works for players with betterclaim.admin.override.
Disbanding a party keeps claims — they remain owned by individual players.
Database location: universe/BetterClaim/BetterClaim.db (inside your world save)