EasyClaims

¡Protege tus construcciones en los servidores de Hytale! Reclama terreno, visualízalo en tu mapa y compártelo con amigos.

Construido para el servidor de supervivencia europeo de Hytale en play.hyfyve.net

Inicio Rápido

• Instalar: Descarga la última versión y coloca el JAR en la carpeta mods/ de tu servidor
• Reinicia tu servidor
• Reclama terreno: Colócate donde quieras proteger y escribe /easyclaims claim
• Ve tus reclamos: Abre tu mapa (M) – ¡los fragmentos reclamados se mostrarán en color!

¡Eso es todo! Tus construcciones están ahora protegidas.

Características

• Integración Visual del Mapa – Los fragmentos reclamados aparecen coloreados en el mapa del mundo
• Recompensas por Tiempo de Juego – Juega más tiempo, reclama más terreno
• Comparte con Amigos – Confía en jugadores con diferentes niveles de permiso
• Protección Completa – Bloquea la rotura, colocación e interacciones de extraños

Comandos

Todos los comandos utilizan /easyclaims.

Comandos Esenciales

Comando	Qué hace
/easyclaims claim	Reclama el fragmento en el que estás
/easyclaims unclaim	Elimina tu reclamación en el fragmento actual
/easyclaims list	Lista todos tus fragmentos reclamados
/easyclaims help	Muestra todos los comandos disponibles

Compartiendo con Amigos

Comando	Qué hace
/easyclaims trust PlayerName	Otorga acceso completo a un jugador
/easyclaims trust PlayerName use	Permite que usen puertas/botones únicamente
/easyclaims trust PlayerName container	Permite que abran cofres también
/easyclaims untrust PlayerName	Elimina el acceso de un jugador
/easyclaims trustlist	Ve a quién has confiado

Otros Comandos

Comando	Qué hace
/easyclaims unclaimall	Elimina TODAS tus reclamaciones (¡cuidado!)
/easyclaims playtime	Consulta tu tiempo de juego y espacios de reclamación

Comandos de Administrador

Comando	Qué hace
/easyclaims admin config	Muestra la configuración actual
/easyclaims admin set <key> <value>	Cambia una configuración (se guarda inmediatamente)
/easyclaims admin reload	Recarga la configuración desde el archivo

Ejemplo:

/easyclaims admin set max 100
/easyclaims admin set starting 6
/easyclaims admin set perhour 3

Niveles de Confianza Explicados

Cuando confías en alguien, puedes elegir cuánto acceso le das:

Nivel	Ejemplo de Comando	Lo que pueden hacer
use	/easyclaims trust Steve use	Abrir puertas, presionar botones, accionar palancas
container	/easyclaims trust Steve container	Lo anterior + abrir cofres, barriles
workstation	/easyclaims trust Steve workstation	Lo anterior + usar hornos, mesas de trabajo
build	/easyclaims trust Steve build	Acceso completo – puede romper y colocar bloques

Nota: Si no especificas un nivel, los jugadores obtienen acceso completo build.

Consejo: Usa /easyclaims trust PlayerName use para visitantes que solo necesitan pasar por las puertas.

Cómo Funcionan las Reclamaciones

• Cada reclamación protege un área de 32×32 bloques (un fragmento)
• Las reclamaciones se extienden desde la roca madre hasta el cielo – protección vertical completa
• Comienzas con 4 espacios de reclamación y ganas más jugando
• Abre tu mapa del mundo (M) para ver las reclamaciones resaltadas en color
• Tus reclamaciones se muestran en tu color único, las de otros en el suyo

Ganando Más Reclamaciones

Cuanto más juegues, más terreno puedes reclamar:

Tiempo de Juego	Espacios de Reclamación Totales
Nuevo jugador	4 fragmentos
1 hora	6 fragmentos
5 horas	14 fragmentos
10 horas	24 fragmentos

¡Usa /easyclaims playtime para comprobar tu progreso!

Instalación

Para Propietarios de Servidores

• Descarga el último JAR desde Releases
• Colócalo en la carpeta mods/ de tu servidor
• Reinicia el servidor
• Los archivos de configuración aparecerán en mods/Community_EasyClaims/

Configurando Permisos

Otorga estos permisos para permitir que los jugadores usen el plugin:

perm group add Adventure easyclaims.use
perm group add admin easyclaims.admin

El permiso easyclaims.use otorga acceso a todos los comandos de jugador (reclamar, desreclamar, confiar, etc.). El permiso easyclaims.admin otorga acceso a los comandos /easyclaims admin (configuración, establecer, recargar).

Configuración

Los archivos de configuración están en mods/Community_EasyClaims/.

config.json – Configuración Principal

{
  "startingClaims": 4,
  "claimsPerHour": 2,
  "maxClaims": 50,
  "playtimeSaveInterval": 60
}

Configuración	Por Defecto	Descripción
startingClaims	4	Reclamaciones disponibles para nuevos jugadores
claimsPerHour	2	Reclamaciones extra ganadas por hora jugada
maxClaims	50	Máximo de reclamaciones que cualquiera puede tener

Fórmula: startingClaims + (hoursPlayed × claimsPerHour), máximo maxClaims

Consejo: Usa /easyclaims admin set para cambiar configuraciones en el juego sin editar archivos.

block_groups.json – Permisos de Bloques

Controla qué bloques requieren qué nivel de confianza. Utiliza coincidencias de patrones:

{
  "usePatterns": ["door", "button", "lever", "gate", "trapdoor"],
  "containerPatterns": ["chest", "barrel", "storage", "hopper"],
  "workstationPatterns": ["crafting", "furnace", "anvil", "brewing"]
}

¡Añade los IDs de bloques de Hytale a medida que los descubras!

Almacenamiento de Datos

Todos los datos del plugin se almacenan en mods/Community_EasyClaims/:

mods/Community_EasyClaims/
├── config.json          # Configuración principal
├── block_groups.json    # Reglas de permisos de bloques
├── claims/
│   ├── index.json       # Búsqueda rápida de todas las reclamaciones
│   └── <uuid>.json      # Reclamaciones y jugadores de confianza de cada jugador
└── playtime/
    └── <uuid>.json      # Tiempo de juego de cada jugador

Resolución de Problemas

“No tienes permiso”

Pide a tu administrador del servidor que te otorgue el permiso easyclaims.use.

¿Las reclamaciones no aparecen en el mapa?

Intenta cerrar y volver a abrir tu mapa, o reconéctate al servidor.

¿No puedes reclamar?

• Verifica si tienes espacios disponibles: /easyclaims playtime
• Asegúrate de que el fragmento no esté ya reclamado por otra persona

¿La protección no funciona?

Revisa la consola del servidor para mensajes de [EasyClaims] para depurar eventos de bloques.

Construyendo desde la Fuente

Requiere Java 25+ y Maven:

mvn clean package

Salida: target/EasyClaims-*.jar