Towny3D – Protección de Terreno 3D para Hytale

Un plugin de protección de terreno 3D de alto rendimiento para servidores de Hytale que incluye gestión de ciudades/naciones, reclamaciones de parcelas, control de PvP y sistemas de permisos avanzados con corutinas de Kotlin e indexación espacial.

> Estado: Alpha – Este plugin es experimental y está en desarrollo activo. Ha sido portado de la API de Spigot a la API de Hytale con un uso extensivo de Claude Code, confiando principalmente en el código fuente decompilado del servidor de Hytale.

Características Clave

Sistema de Reclamación 3D

Towny3D introduce verdaderas reclamaciones de terreno en 3D: ¡puedes tener múltiples parcelas en el mismo chunk a diferentes niveles verticales! Simplemente selecciona los puntos inferior y superior de tu área de parcela deseada utilizando el palo de reclamación, luego ejecuta el comando de reclamación.

• Granularidad vertical: Reclama rangos específicos del eje Y en lugar de chunks enteros
• Indexación espacial: Búsquedas de región rápidas con caché espacial optimizada
• Palo de Reclamación: Usa /claim gcs (obtener palo de reclamación) para establecer los límites de la parcela

Características Implementadas

Gestión de Ciudades

• /town create <townName> – Crear una nueva ciudad
• /town delete – Disolver tu ciudad
• /town info [townName] – Ver información de la ciudad
• /town list – Listar todas las ciudades
• /town join <townName> – Unirse a una ciudad abierta
• /town leave – Abandonar tu ciudad actual

Gestión de Naciones

• /nation create <nationName> – Crear una nueva nación
• /nation delete – Disolver tu nación
• /nation info [nationName] – Ver información de la nación
• /nation list – Listar todas las naciones
• /nation join <nationName> – Unirse a una nación abierta
• /nation leave – Abandonar tu nación actual
• /nation invite <townName> – Invitar a una ciudad a tu nación
• /nation kick <townName> – Expulsar a una ciudad de tu nación

Gestión de Parcelas

• /plot claim – Reclama la parcela en la que estás de pie
• /plot unclaim – Desreclama la parcela en la que estás de pie
• /plot forsale <price> (alias: /plot fs) – Poner una parcela a la venta
• /plot notforsale (alias: /plot nfs) – Retirar la parcela del mercado
• /plot info – Ver información de la parcela

Comandos de Reclamación

• /claim gcs (obtener palo de reclamación) – Obtener el ítem para establecer los puntos inferior y superior de la parcela
• /claim [chunk] – Reclamar terreno en la región 3D seleccionada
• /claim auto – Reclamar automáticamente terreno adyacente
• /claim unclaim – Desreclamar terreno de la ciudad

Conmutadores de Ciudad

• /toggle pvp [on/off] – Activar/desactivar PvP en la ciudad
• /toggle public [on/off] – Activar/desactivar estado público
• /toggle explosions [on/off] – Activar/desactivar protección contra explosiones
• /toggle open [on/off] – Activar/desactivar unirse abiertamente

Sistema de Chat

• /tc <message> (alias: /townchat) – Enviar mensaje al chat de la ciudad
• /nc <message> (alias: /nationchat) – Enviar mensaje al chat de la nación
• /g <message> (alias: /globalchat) – Enviar mensaje al chat global
• /chat town|nation|global – Cambiar el modo de chat predeterminado

Economía

• /balance (alias: /bal) – Comprobar tu saldo
• /resident balance – Comprobar el saldo del residente
• /eco give <player> <amount> – Dar dinero a un jugador
• /eco take <player> <amount> – Quitar dinero a un jugador
• /eco set <player> <amount> – Establecer el saldo de un jugador
• /eco balance <player> – Comprobar el saldo de un jugador

Invitaciones

• /accept – Aceptar invitación pendiente de ciudad/nación
• /decline – Rechazar invitación pendiente

Comandos de Administrador (/townyadmin)

• /ta reload – Recargar la configuración del plugin
• /ta save – Forzar el guardado de todos los datos
• /ta stats – Ver estadísticas del plugin
• /ta unclaim – Desreclamar forzosamente como administrador
• /ta reset – Restablecer los datos del plugin

Comandos de Residentes

• /res (alias: /resident) – Comando raíz de residente
• /res info [player] – Ver información del residente
• /res list – Listar todos los residentes
• /balance – Comprobar saldo

Sistemas de Protección

• Protección de Entidades: Controlar el surgimiento e interacciones de entidades
• Protección contra Explosiones: Prevenir daños por explosiones
• Interacciones de Jugadores: Controlar la colocación, destrucción de bloques y uso de ítems
• Control de PvP: Activar/desactivar PvP de forma granular por región
• Notificaciones de Entrada a Chunks: Mostrar información de la ciudad/región al entrar

Características Planeadas (No Implementadas Aún)

Comandos de Ciudad

• /town mayor – Submenú de gestión de alcalde
• /town addAssistant <playerName> – Añadir asistente de ciudad
• /town removeAssistant <playerName> – Eliminar asistente de ciudad
• /town setHome – Establecer el punto de aparición de la ciudad
• /town spawn – Teletransportarse al punto de aparición de la ciudad
• /town online – Listar residentes en línea
• /town here – Mostrar información de la ciudad en la que estás
• /town kick <playerName> – Expulsar residente de la ciudad
• /town deposit <amount> – Depositar en el banco de la ciudad
• /town withdraw <amount> – Retirar del banco de la ciudad
• /town set perm <permGroup> <permType> <value> – Establecer permisos de la ciudad

Comandos de Parcelas

• /plot set perm <permGroup> <permType> <value> – Establecer permisos de la parcela
• /plot set embassy – Marcar la parcela como embajada
• /plot toggle <flag> – Activar/desactivar banderas de la parcela
• /plot name <name> – Nombrar tu parcela
• /plot showBorders (alias: /plot sb) – Mostrar los límites de la parcela
• /plot hideBorders (alias: /plot hb) – Ocultar los límites de la parcela
• /plot reset – Restablecer la parcela a la configuración predeterminada

Sistema de Permisos y Banderas

El sistema detallado de permisos y banderas está planeado pero aún no implementado completamente:

Banderas:

• fire – Propagación y daño por fuego
• explosion – Daño por explosiones
• friendly_mobs_spawn – Surgimiento de mobs amistosos
• hostile_mobs_spawn – Surgimiento de mobs hostiles

Permisos (para grupos: res/ally/gen):

• pvp – Combate jugador contra jugador
• inventory – Acceso al inventario
• interact – Interacción con bloques
• build – Colocar bloques
• destroy – Romper bloques
• drop – Soltar ítems
• pick – Recoger ítems
• move – Movimiento

Características de Administrador

• /townyadmin chat spy – Espiar chats de ciudad/nación

Arquitectura

Optimización de Rendimiento

• Corutinas de Kotlin: Operaciones asíncronas para I/O de base de datos y llamadas de red
• Caché de Caffeine: Caché de alto rendimiento para ciudades, naciones, residentes y regiones
• Indexación Espacial: Búsquedas eficientes en 3D con caché espacial
• Almacenamiento por Lotes: Escrituras periódicas por lotes para reducir operaciones de I/O

Almacenamiento

• Backend de almacenamiento basado en JSON
• Guardado automático con intervalos configurables
• Escritor por lotes para escrituras eficientes

Estado del Desarrollo

Esta es una versión alpha. Muchas características principales funcionan, pero espera errores y funcionalidades faltantes. El plugin se está desarrollando sin documentación oficial de Hytale, confiando en el código de servidor decompilado.

Limitaciones Conocidas

• La API puede cambiar significativamente a medida que se actualiza el servidor de Hytale
• Algunas características del Towny original aún no han sido portadas
• Las pruebas están limitadas por las versiones de servidor disponibles

Contribuyendo

Este es un proyecto personal desarrollado para llevar funcionalidades similares a Towny a Hytale. Se aceptan contribuciones una vez que el plugin se estabilice.

Licencia

[Especifica tu licencia aquí]

Créditos

• Inspirado por Towny3D para Minecraft/Spigot del cual soy el autor
• Portado a la API de Hytale a través de ingeniería inversa