Server documentation

BetterClaim

Active

Hytale • Version 1.5.1

Guía completa de configuración para propietarios de servidores: comandos, permisos jerárquicos, referencia de configuración y flujos de trabajo de administrador.

Mod overview CurseForge

Comandos, permisos, configuración y flujos de admin habituales de BetterClaim para propietarios de servidores Hytale.

Aviso: Mod inspirado en SimpleClaims.

Instalación

Descarga BetterClaim-x.x.x.jar desde la pestaña Files de CurseForge
Coloca el JAR en la carpeta mods/ de tu servidor (o en la carpeta de mods de usuario de Hytale para un jugador)
Inicia el servidor; la configuración se genera en plugins/BetterClaim/config.json
Otorga permisos a tus grupos de jugadores (consulta Permisos más abajo)
Usa /bc en el juego para abrir el hub BetterClaim (o el mapa de claims directamente si useBcHubUi es false)

Opcional: instala LuckPerms para que los nodos dinámicos (betterclaim.limit.N, betterclaim.playtime.N, betterclaim.admin.max-add-limit.N) se resuelvan con permisos de grupo heredados. Sin LuckPerms, BetterClaim usa los proveedores de permisos nativos de Hytale (igual que en 1.2.x).

Un jugador: usa /perm group add OP betterclaim.gui (y otros nodos según sea necesario) para otorgarte acceso.

Comandos de administrador

Comando principal: /bc (alias: /betterclaim)

Los comandos de jugador están listados en la página de resumen del mod.

Comando	Descripción
`/bc admin`	Abre la GUI de lista de jugadores de administrador
`/bc admin players`	Selecciona un jugador objetivo para acciones de administrador
`/bc admin chunk`	Abre el mapa de reclamaciones en modo administrador para el objetivo seleccionado
`/bc admin party`	Edita cualquier grupo como administrador
`/bc admin claim`	Reclama el chunk actual para el jugador objetivo seleccionado
`/bc admin unclaim`	Desreclama el chunk actual para el jugador objetivo seleccionado
`/bc admin override`	Activa/desactiva omitir límites de reclamación y protección completa de reclamaciones al usar herramientas de administrador
`/bc admin denyzone pos1`	Guarda la esquina 1 de un rectángulo sin reclamación (chunk actual)
`/bc admin denyzone pos2`	Guarda la esquina 2 de un rectángulo sin reclamación (chunk actual)
`/bc admin denyzone create <name>`	Crea una zona de denegación persistente desde pos1 + pos2
`/bc admin denyzone list`	Lista todas las regiones de reclamación denegada
`/bc admin denyzone remove <name>`	Elimina una región de reclamación denegada
`/bc admin set-limit <player> <limit>`	Establece una anulación persistente del límite de reclamaciones
`/bc admin add-limit <player> <amount>`	Añade chunks de reclamación extra a un jugador
`/bc admin create-party <player> [name]`	Crea un grupo para un jugador

Modo chunk de administrador: ejecuta primero /bc admin players para seleccionar un objetivo, luego usa /bc admin chunk o los comandos admin claim/unclaim.

Permisos

BetterClaim usa permisos jerárquicos. Otorgar un nodo padre también otorga todos sus hijos.

Permisos de comandos

Permiso	Otorga acceso a
`betterclaim.gui`	`/bc`: GUI del mapa de territorio
`betterclaim.claim`	`/bc claim` y clics de reclamar en la GUI
`betterclaim.unclaim`	`/bc unclaim` y clics de desreclamar en la GUI
`betterclaim.home`	`/bc sethome`, `/bc home`, `/bc delhome`, `/bc homes`
`betterclaim.party`	Todos los subcomandos de grupo (nodo padre)
`betterclaim.party.edit`	`/bc party`: GUI de grupo
`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`	Todos los subcomandos de administrador (nodo padre)
`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`

Permisos dinámicos

Cuando un jugador tiene varios nodos coincidentes, gana el valor más alto.

Permiso	Descripción
`betterclaim.limit.N`	Límite base de reclamaciones por jugador (p. ej. `betterclaim.limit.10` = 10 chunks). Gana el valor coincidente más alto.
`betterclaim.playtime.N`	Minutos de tiempo de juego por chunk extra (p. ej. `betterclaim.playtime.120`). Gana el valor coincidente más alto; anula la configuración cuando es mayor que 0.
`betterclaim.admin.max-add-limit.N`	Límite total máximo de reclamaciones alcanzable vía `/bc admin add-limit` para ese administrador.

Orden de cálculo del límite

Anulación /bc admin set-limit de administrador (base de datos): máxima prioridad
Permiso betterclaim.limit.<N> (valor más alto)
Config defaultClaimLimit
Chunks extra por tiempo de juego (si está activado)
Chunks extra de /bc admin add-limit de administrador
Limitado por config maxClaimLimit (a menos que el modo override de administrador esté activo)

Configuración rápida con Hytale /perm

Jugadores por defecto (ejemplo grupo Adventure):

/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 / administradores (ejemplo grupo OP):

/perm group add OP betterclaim.admin

LuckPerms

BetterClaim declara LuckPerms como dependencia opcional. Las comprobaciones de comandos siguen pasando por el PermissionsModule de Hytale (LuckPerms se registra como proveedor). Los nodos numéricos dinámicos (betterclaim.limit.N, betterclaim.playtime.N, betterclaim.admin.max-add-limit.N) usan permisos heredados de LuckPerms cuando LuckPerms está activo, así que los grupos VIP y la herencia funcionan como se espera.

Ejemplo de configuración:

/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 vip permission set betterclaim.limit.20 true
/lp group admin permission set betterclaim.admin true
/lp user <player> permission set betterclaim.playtime.120 true

Tras cambiar datos de LuckPerms, ejecuta /lp sync (o tu recarga habitual) y vuelve a comprobar los límites en /bc.

Configuración

Archivo de configuración: plugins/BetterClaim/config.json (generado automáticamente en la primera ejecución)

Límites de reclamación

Opción	Predeterminado	Descripción
`defaultClaimLimit`	`5`	Límite inicial de reclamaciones por jugador
`maxClaimLimit`	`50`	Límite máximo total de reclamaciones (salvo override de administrador)
`enablePlaytimeClaimGain`	`true`	Activar chunks extra por tiempo de juego
`claimGainMinutes`	`600`	Minutos de tiempo de juego por chunk extra
`enableAdjacentClaims`	`false`	Exigir que las nuevas reclamaciones toquen una reclamación existente (la primera es gratis)
`creativeBypassProtection`	`true`	Los jugadores en modo Creativo ignoran la protección de reclamaciones
`worldNameBlacklistForClaiming`	`[]`	Nombres de mundo donde los jugadores no pueden reclamar (coincidencia exacta)
`scaleClaimLimitByPartyMembers`	`false`	(sin usar) Flag de configuración heredado
`showPartyTotalClaims`	`false`	Mostrar total del grupo en lugar del conteo personal en la GUI

Grupo

Opción	Predeterminado	Descripción
`maxPartyMembers`	`10`	Máximo de miembros por grupo
`maxPartyAllies`	`-1`	Máximo de aliados (-1 = ilimitado)
`enableAllySystem`	`true`	Activar aliados de jugador/grupo
`enablePartyInactivityDisband`	`false`	Disolver grupos cuando el propietario supera el umbral de inactividad
`partyInactivityDisbandDays`	`30`	Días de inactividad del propietario antes de disolución automática
`partyInactivityCheckIntervalMinutes`	`60`	Con qué frecuencia el servidor ejecuta la comprobación de inactividad (mínimo 5)

Títulos de zona y sonidos

Opción	Predeterminado	Descripción
`wildernessName`	`Wilderness`	Nombre mostrado para áreas no reclamadas
`titleTopText`	(vacío)	Texto opcional mostrado encima de los títulos de zona
`personalClaimSubtitle`	`Personal Claim`	Subtítulo para reclamaciones personales
`enableZoneTitles`	`true`	Mostrar título de zona al entrar
`showWildernessZoneTitle`	`true`	Mostrar título al entrar en zona salvaje
`enableClaimEntrySound`	`true`	Reproducir sonido al entrar en reclamación
`claimEntrySoundOncePerZone`	`true`	Solo una vez por visita a la zona
`claimEntrySoundId`	`SFX_Discovery_Z1_Short`	ID de sonido

Mapa y visuales

Opción	Predeterminado	Descripción
`enableCustomMap`	`true`	Mapa de terreno en la GUI /bc
`mapOverlayAlpha`	`0.5`	Opacidad de la superposición de reclamaciones en el mapa del mundo
`guiMapResolutionScale`	`0.75`	Resolución del mapa en la GUI (0.1–1.0)
`guiMapCacheTtlSeconds`	`120`	TTL de caché de imagen del mapa en segundos
`enableParticleBorders`	`true`	Bordes con partículas en los bordes de chunks
`useBcHubUi`	`true`	`/bc` abre el hub (mapa / party / crear) en lugar de solo el mapa de claims

Hogares

Opción	Predeterminado	Descripción
`maxHomes`	`5`	Máximo de hogares por jugador
`homeCooldownSeconds`	`5`	Tiempo de espera de teletransporte

Protección global

Opción	Predeterminado	Descripción
`protectBuckets`	`true`	Bloquear colocación de fluidos y relleno de contenedores de forasteros en reclamaciones protegidas
`protectBenches`	`true`	Proteger mesas de crafteo
`isolateCraftBenchMaterials`	`true`	Los crafts en banco solo usan inventario del jugador y cofres cercanos permitidos
`protectTamedEntities`	`true`	Bloquear daño de forasteros a roles NPC domesticados dentro de reclamaciones (aplica flag de grupo)
`tamedEntityRoleIdentifiers`	`Tamed_`	Prefijos de nombre de rol NPC tratados como compañeros domesticados
`blocksThatIgnoreInteractRestrictions`	`gravestone, tombstone, corpse, loot_chest`	Bloques siempre interactuables

Protección predeterminada del grupo (grupos nuevos)

Opción	Predeterminado	Descripción
`defaultPartyBlockPlaceEnabled`	`false`	Permitir a no miembros colocar bloques
`defaultPartyBlockBreakEnabled`	`false`	Permitir a no miembros romper bloques
`defaultPartyBlockInteractEnabled`	`false`	Permitir a no miembros interactuar con bloques
`defaultPartyPVPEnabled`	`false`	Permitir PVP en reclamaciones del grupo
`defaultPartyFriendlyFireEnabled`	`false`	Permitir fuego amigo entre miembros
`defaultPartyInteractChest`	`false`	Permitir a no miembros abrir cofres
`defaultPartyInteractDoor`	`false`	Permitir a no miembros usar puertas
`defaultPartyInteractBench`	`false`	Permitir a no miembros usar mesas
`defaultPartyInteractChair`	`false`	Permitir a no miembros usar sillas
`defaultPartyInteractPortal`	`false`	Permitir a no miembros usar portales
`defaultPartyTamedDamageEnabled`	`false`	Permitir a no miembros dañar entidades domesticadas

Interruptores del propietario del grupo

Opción	Predeterminado	Descripción
`allowPartyPlaceBlockSetting`	`true`	El propietario puede activar colocación de bloques para no miembros
`allowPartyBreakBlockSetting`	`true`	El propietario puede activar rotura de bloques para no miembros
`allowPartyInteractBlockSetting`	`true`	El propietario puede activar interacción con bloques para no miembros
`allowPartyPVPSetting`	`true`	El propietario puede activar PVP
`allowPartyFriendlyFireSetting`	`true`	El propietario puede activar fuego amigo
`allowPartyInteractChestSetting`	`true`	El propietario puede activar acceso a cofres
`allowPartyInteractDoorSetting`	`true`	El propietario puede activar acceso a puertas
`allowPartyInteractBenchSetting`	`true`	El propietario puede activar acceso a mesas
`allowPartyInteractChairSetting`	`true`	El propietario puede activar acceso a sillas
`allowPartyInteractPortalSetting`	`true`	El propietario puede activar acceso a portales
`allowPartyTamedDamageSetting`	`true`	El propietario puede activar daño a entidades domesticadas

Ejemplo config.json

{
  "configVersion": 28,
  "useBcHubUi": true,
  "worldNameBlacklistForClaiming": [],
  "tamedEntityRoleIdentifiers": ["Tamed_"],
  "defaultClaimLimit": 5,
  "maxClaimLimit": 50,
  "enablePlaytimeClaimGain": true,
  "claimGainMinutes": 600,
  "enableAdjacentClaims": false,
  "creativeBypassProtection": true,
  "enablePartyInactivityDisband": false,
  "partyInactivityDisbandDays": 30,
  "partyInactivityCheckIntervalMinutes": 60,
  "maxPartyMembers": 10,
  "maxPartyAllies": -1,
  "enableAllySystem": true,
  "enableCustomMap": true,
  "enableParticleBorders": true,
  "maxHomes": 5,
  "homeCooldownSeconds": 5
}

Consulta la configuración predeterminada completa dentro de plugins/BetterClaim/config.json tras el primer arranque.

Notas

Reclamar/desreclamar en la GUI requiere betterclaim.claim / betterclaim.unclaim. Los miembros del grupo siempre reclaman chunks personales: no hay permiso de reclamación de grupo separado.
El modo chunk de administrador requiere seleccionar primero un objetivo con /bc admin players.
El override de administrador requiere betterclaim.admin.override y omite límites y protección.
Las regiones de reclamación denegada se almacenan en SQLite y bloquean reclamaciones de jugadores en el rectángulo marcado.
Las zonas denegadas no bloquean el paso de jugadores; solo impiden nuevos claims en el área.
Establece useBcHubUi en false si prefieres que /bc abra el mapa de claims directamente (comportamiento heredado).
Las zonas denegadas guardadas aparecen solo en el mapa de claims, no en el mapa normal (M) tras guardar.
Los mundos listados en worldNameBlacklistForClaiming rechazan nuevas reclamaciones con un mensaje en el juego.
Con LuckPerms instalado, comprueba el log del servidor por LuckPerms detected al iniciar cuando los límites dinámicos deben usar herencia de grupo.
Disolver un grupo conserva las reclamaciones. Siguen siendo propiedad de jugadores individuales (incluida la disolución automática por inactividad del propietario).
La disolución por inactividad del grupo está desactivada por defecto; activa enablePartyInactivityDisband y establece partyInactivityDisbandDays para activarla.
Ubicación de la base de datos: universe/BetterClaim/BetterClaim.db (dentro de tu guardado del mundo)