Kyv Claims

KyvClaims – Sistema de Protección de Terreno

Un plugin completo de protección de terrenos para servidores de Hytale que permite a los jugadores reclamar y proteger sus territorios con una interfaz gráfica y permisos granulares por área. Cada reclamación tiene control independiente sobre la construcción, la eliminación de bloques y el uso de cubos.

Características

Protección Básica

• Sistema de Reclamación: Define áreas rectangulares usando coordenadas (GUI o comandos)
• Interfaz Dual: Usa interfaz gráfica o comandos tradicionales
• Jugadores de Confianza: Agrega amigos para construir colaborativamente en tus reclamaciones
• Zona de Búfer de 5 Bloques: Protección automática alrededor de las reclamaciones para prevenir el griefing
• Protección de Cubo Triple: Sistema avanzado para prevenir el griefing con agua/lava

Permisos y Control

• Permisos Granulares: 15 permisos individuales con soporte de comodines
• Control por Reclamación: Cada área tiene configuraciones de acceso independientes
• Herramientas de Administrador: Control administrativo completo sobre todas las reclamaciones

Retroalimentación Visual

• Visualización del Lado del Cliente: Visualización de bordes solo para el cliente
  • Amarillo: Área válida para nuevas reclamaciones
  • Azul: Visualizando área ya reclamada
  • Rosa: Conflicto con reclamaciones existentes

Características Adicionales

• Multilingüe: Soporte en inglés y portugués (Brasil)
• Almacenamiento Persistente: Reclamaciones guardadas automáticamente en formato JSON
• API Pública: Integración con tiendas, sistemas VIP y plugins de economía

Cómo Funciona

Dos Maneras de Usar

1. Interfaz Gráfica

• Abre con el comando /claim
• Haz clic en los botones POS1 y POS2 para seleccionar las esquinas del área
• La retroalimentación visual con bordes coloreados muestra el estado de la selección
• Usa /claim nuevamente para abrir la pantalla de confirmación
• Haz clic en Crear Reclamación para finalizar

2. Comandos Tradicionales

• Usa /claim pos1 y /claim pos2 para seleccionar el área
• Ejecuta /claim create para reclamar
• Administra con comandos como /claim trust, /claim list, etc.

Sistema de Retroalimentación Visual

El plugin muestra bordes coloreados para ayudarte a entender el estado de la reclamación:

• Bordes Amarillos: Área válida – puedes reclamar este espacio

• Bordes Azules: Reclamación existente – visualizando tu área reclamada

• Bordes Rosas: Conflicto – el área se superpone con otra reclamación

Flujo de Protección

Seleccionar Área: Usa botones de GUI o comandos (/claim pos1, /claim pos2)

Retroalimentación Visual: Ve bordes coloreados que indican el estado

Crear Reclamación: Confirma en GUI o usa /claim create

Administrar: Agrega jugadores de confianza, renombra o elimina reclamaciones

Protección Activa: Solo el propietario y los jugadores de confianza pueden construir/romper/usar cubos

Zona de Búfer

Una zona de búfer de 5 bloques alrededor de cada reclamación previene la construcción demasiado cerca de los territorios de otros. Solo el propietario de la reclamación y los jugadores de confianza pueden construir dentro de su propia zona de búfer.

Comandos

Comandos de Usuario

• /claim – Abrir interfaz de reclamaciones
• /claim pos1 – Definir posición de la primera esquina
• /claim pos2 – Definir posición de la segunda esquina
• /claim create – Crear reclamación con el área seleccionada
• /claim cancel – Cancelar selección actual
• /claim list – Listar tus reclamaciones
• /claim info – Ver información de la reclamación en tu ubicación
• /claim trust <jugador> – Agregar jugador de confianza a la reclamación actual
• /claim untrust <jugador> – Eliminar jugador de confianza de la reclamación actual
• /claim abandon <nombre> – Eliminar una reclamación por nombre

Comandos de Administrador

• /claim admin list – Listar todas las reclamaciones del servidor
• /claim admin remove <nombre> – Eliminar cualquier reclamación
• /claim admin remove <jugador> <nombre> – Eliminar la reclamación de un jugador específico
• /claim admin setlimit <jugador> <bloques> – Establecer el límite de bloques de un jugador
• /claim admin addblocks <jugador> <bloques> – Agregar bloques al límite de un jugador
• /claim admin info <jugador> – Ver información de la reclamación de un jugador
• /claim admin reload – Recargar la configuración del plugin
• /claim admin bypass – Alternar modo de bypass (ignorar todas las protecciones)

Configuración

El plugin crea dos archivos en mods/kyvclaims/:

config.json

Configura los ajustes predeterminados:

• defaultBlockLimit: Número predeterminado de bloques que cada jugador puede reclamar (predeterminado: 10000)
• language: Idioma de la interfaz – en_US (inglés) o pt_BR (portugués)

claims.json

Todas las reclamaciones se guardan automáticamente aquí en formato JSON. Este archivo es gestionado por el plugin y no debe ser editado manualmente.

Permisos

Gestión de Permisos

Puedes gestionar permisos de dos maneras:

Usando un plugin de permisos (recomendado para configuraciones complejas)

Directamente en permissions.json del servidor (configuración simple)

Agrega permisos a grupos en el archivo permissions.json de tu servidor ubicado en el directorio raíz del servidor.

Comodines

• kyvclaims.* – Todos los permisos
• kyvclaims.use.* – Todos los permisos de usuario
• kyvclaims.admin.* – Todos los permisos de administrador

Permisos de Usuario

• kyvclaims.use.create – Crear reclamaciones
• kyvclaims.use.remove – Eliminar propias reclamaciones
• kyvclaims.use.trust – Agregar jugadores de confianza
• kyvclaims.use.untrust – Eliminar jugadores de confianza
• kyvclaims.use.info – Ver información de la reclamación
• kyvclaims.use.list – Listar propias reclamaciones
• kyvclaims.use.rename – Renombrar reclamaciones

Permisos de Administrador

• kyvclaims.admin – Bloques de reclamación ilimitados
• kyvclaims.admin.create – Crear reclamaciones para otros
• kyvclaims.admin.remove – Eliminar cualquier reclamación
• kyvclaims.admin.bypass – Ignorar todas las protecciones
• kyvclaims.admin.setlimit – Establecer límites de bloques para jugadores
• kyvclaims.admin.reload – Recargar configuración
• kyvclaims.admin.teleport – Teletransportarse a reclamaciones

Nota: Los jugadores con estado de OP o permiso kyvclaims.admin tienen bloques de reclamación ilimitados y acceso completo automáticamente.

Instalación

Descarga la última versión

Coloca kyv-claims-x.x.x.jar en la carpeta mods de tu servidor

Reinicia el servidor

Configura permisos en el permissions.json de tu servidor

Edita mods/kyvclaims/config.json si es necesario (opcional)

Soporte Multilingüe

El plugin carga automáticamente mensajes según tu configuración:

• Inglés: Establece “language”: “en_US” en config.json
• Portugués: Establece “language”: “pt_BR” en config.json

Todos los elementos de la interfaz, comandos y mensajes están completamente traducidos.

API del Desarrollador

KyvClaims proporciona una API pública para integración con tiendas, sistemas VIP y plugins de economía. Consulta la sección de API a continuación para más detalles.

Soporte

Para problemas, sugerencias o contribuciones:

• Reporta errores en el rastreador de problemas

– Únete a nuestra comunidad de Discord

Desarrollado por ItaloSixx — KYV Verdant Realm |

Documentación de la API

KyvClaims proporciona una API pública para integración con tiendas, sistemas VIP y plugins de economía.

Configuración

Agrega “kyvclaims” a las dependencias de tu plugin en manifest.json, luego importa com.claims.ClaimAPI en tu código.

Métodos Principales

Gestión de Bloques:

• addClaimBlocks(UUID, int) – Agregar bloques al límite de un jugador
• removeClaimBlocks(UUID, int) – Eliminar bloques del límite de un jugador
• setClaimBlocks(UUID, int) – Establecer límite total de bloques
• resetToDefault(UUID) – Restablecer al límite predeterminado

Métodos de Consulta:

• getAvailableBlocks(UUID) – Obtener bloques disponibles (total – usados)
• getUsedBlocks(UUID) – Obtener bloques usados en reclamaciones
• getTotalBlocks(UUID) – Obtener límite total de bloques
• canClaim(UUID, int) – Verificar si el jugador puede reclamar área

Información de Reclamación:

• getPlayerClaims(UUID) – Obtener lista de reclamaciones del jugador
• canBuild(UUID, Location) – Verificar si el jugador puede construir en la ubicación

Casos de Uso Comunes

• Plugins de Tienda: Vender bloques de reclamación usando addClaimBlocks()
• Sistemas VIP: Otorgar bloques extra con setClaimBlocks()
• Integración Económica: Verificar bloques disponibles antes de compras
• Sistemas de Rango: Diferentes límites de bloques por rango
• Recompensas de Eventos: Dar bloques de reclamación como recompensas

Nota: Los jugadores con estado de OP o permiso kyvclaims.admin tienen bloques ilimitados automáticamente.

Métodos de Consulta

getAvailableBlocks(UUID playerUUID)

Devuelve cuántos bloques el jugador puede seguir usando.

• Devuelve: int – Bloques disponibles (total – usados)

getUsedBlocks(UUID playerUUID)

Devuelve cuántos bloques el jugador ha usado en reclamaciones.

• Devuelve: int – Bloques usados

getTotalBlocks(UUID playerUUID)

Devuelve el límite total de bloques del jugador.

• Devuelve: int – Límite total

canClaim(UUID playerUUID, int blockCount)

Verifica si el jugador tiene suficientes bloques para reclamar un área.

• Devuelve: boolean – true si puede reclamar

Información de Reclamación

getPlayerClaims(UUID playerUUID)

Devuelve la lista de todas las reclamaciones propiedad del jugador.

• Devuelve: List<Claim> – Reclamaciones del jugador

canBuild(UUID playerUUID, Location location)

Verifica si el jugador puede construir en una ubicación específica.

• Devuelve: boolean – true si puede construir