HyFactions

⚔️ Hyfaction – Sistema Completo de Facciones para Hytale

Un mod completo de gestión de facciones para servidores de Hytale que incluye reclamaciones de territorio, alianzas, PvP estratégico y una amplia personalización. Perfecto para servidores competitivos que buscan una guerra de facciones organizada.

Versión: 1.0.320+ PATCH DE ZONA SEGURA

🌟 Resumen

Hyfaction transforma tu servidor de Hytale en un entorno dinámico basado en facciones donde los jugadores crean facciones, reclaman territorios, forjan alianzas y participan en combates PvP estratégicos. Con un sistema GUI intuitivo, integración ECS y una amplia personalización, Hyfaction proporciona todo lo necesario para un juego competitivo de facciones.

Comandos Principales: /hf | /hyfaction | /faction | /f

✨ Características Clave

🏰 Gestión Avanzada de Facciones

Crear y gestionar facciones con nombres únicos y colores aleatorios
Jerarquía de roles en tres niveles (Propietario, Oficial, Miembro) con permisos distintos
Sistema de invitación inteligente con aceptación explícita
Registros de actividad completos que rastrean las últimas 100 acciones de facción
Almacenamiento individual de facciones con archivos JSON aislados por facción
Disolución completa que elimina todas las reclamaciones y archivos de datos

🗺️ Sistema de Territorio Inteligente

Reclamación basada en chunks que protege los territorios de la facción
Integración de mapa visual que muestra los chunks reclamados en colores de facción
Minimapa integrado en la GUI para una conciencia contextual
Rejilla de chunks de 15×15 para una gestión de territorio sencilla
Limites basados en poder que garantizan una expansión equilibrada
Sistema de decadencia automática para facciones inactivas o de bajo poder
Restricciones de dimensión que impiden reclamaciones en áreas temporales o restringidas

⚡ Sistema de Poder Dinámico

Poder personal para cada jugador (límite configurable en 20)
Cálculo del poder de la facción como suma del poder de los miembros (con límite por jugador)
Regeneración automática cada intervalo configurable (+1 poder/jugador)
Pérdida estratégica de poder al morir (-1) o al matar neutrales (-1)
Recalculo en tiempo real en cambios de miembros y eventos de poder
Penalizaciones por déficit de poder que desencadenan la decadencia automática de reclamaciones

🤝 Sistema de Relaciones Diplomáticas

Alianzas – Protección mutua, acceso a tierras compartidas, sin fuego amigo
Enemigos – PvP total, hostilidad bidireccional, declaración mutua automática
Neutrales – PvP habilitado con penalizaciones de poder por agresión
Sistema de solicitud de alianza con mecánicas de aprobación/rechazo
Conversión automática de enemigos al rechazar solicitudes de alianza
Visualización codificada por colores (aliados en verde, enemigos en rojo, neutrales en blanco/gris)

🏠 Hogar y Teleportación

Hogar de facción establecido por el propietario en territorio reclamado
Teleportación exacta que preserva la posición Y ROTACIÓN (yaw/pitch) EN DESARROLLO NO FUNCIONA AHORA
Soporte entre dimensiones utilizando la teleportación nativa de Hytale EN DESARROLLO NO FUNCIONA AHORA
Acceso solo para miembros con comprobaciones de permisos

⚔️ Sistema de Combate Avanzado

Marcado de combate que previene la explotación de desconexiones (15s por defecto)
Reglas de PvP basadas en relaciones (aliados protegidos, enemigos abiertos)
Penalizaciones de poder por atacar a neutrales
Registros de combate que rastrean todas las muertes con marcas de tiempo
Zonas seguras para áreas de protección designadas por el administrador
Detección de muertes a través de ECS DeathComponent y análisis de chat

🛡️ Protección Integral

Protección de colocación/rompimiento de bloques en chunks reclamados
Protección de interacción para contenedores, puertas y mecanismos
Protección de colocación de fluidos (agua, lava, etc.)
Protección de recogida de ítems en áreas reclamadas
Acceso aliado a territorios amistosos (configurable)
Opción de omitir modo creativo para construcción (configurable)
Sistema de anulación de administrador para gestión del servidor

👑 Herramientas Profesionales para Administradores

Menú de administrador consolidado con todas las opciones de gestión
Reclamación ilimitada para configuración y eventos del servidor
Interruptor de modo de omisión para modificar cualquier territorio
Gestión de zonas seguras (agregar/eliminar/listar)
GUI de chunk de administrador con acceso sin restricciones
Sistema de anulación para permisos especiales

🎨 Interfaz de Usuario Moderna

Menú principal interactivo que muestra estadísticas de facción, miembros y acciones
GUI de gestión de chunks con minimapa integrado y rejilla de 15×15
Gestión de alianzas con manejo visual de solicitudes
Navegador de facciones que lista todas las facciones con opción de ver miembros
Wiki de múltiples páginas con documentación completa en el juego
Sistema de ayuda con referencia de comandos categorizada
Insignias codificadas por colores para roles y relaciones

📋 Referencia Completa de Comandos

Comandos Básicos de Facción

Comando
Permiso
Descripción

/hf o /hf list
–
Abre el menú interactivo de facciones (GUI)

/hf create <nombre>
hyfaction.create
Crea una nueva facción con un nombre único

/hf invite <jugador>
hyfaction.invite
Invita a un jugador a la facción (Propietario/Oficial)

/hf accept
–
Acepta la invitación pendiente a la facción

/hf leave
–
Deja la facción actual (no para el Propietario)

/hf kick <jugador>
hyfaction.kick
Elimina a un jugador de la facción

/hf disband
hyfaction.disband
Disuelve completamente la facción (solo Propietario)

Hogar y Teleportación

Comando
Permiso
Descripción

/hf sethome
hyfaction.sethome
Establece el hogar de la facción en la posición actual (solo Propietario)

/hf home
hyfaction.home
Teleportarse al hogar de la facción con rotación exacta

Gestión de Miembros

Comando
Permiso
Descripción

/hf promote <jugador>
hyfaction.promote
Promover a un miembro a Oficial (solo Propietario)

/hf demote <jugador>
hyfaction.demote
Degradar a un Oficial a Miembro (solo Propietario)

Gestión de Territorio

Comando
Permiso
Descripción

/hf chunk
hyfaction.claim/hyfaction.unclaim
Abre la GUI de gestión de chunks con minimapa

Nota: Los comandos directos /hf claim y /hf unclaim están obsoletos. Toda la gestión de territorio ahora utiliza la GUI /hf chunk.

Relaciones Diplomáticas

Comando
Permiso
Descripción

/hf ally <facción>
hyfaction.ally
Enviar solicitud de alianza (auto-aceptar si es mutua)

/hf enemy <facción>
hyfaction.enemy
Declarar a la facción como enemiga (bidireccional)

/hf neutral <facción>
hyfaction.enemy
Establecer relación neutral (unilateral)

/hf faction
–
Ver todas las facciones con relaciones y estadísticas

Información y Ayuda

Comando
Permiso
Descripción

/hf logs
–
Mostrar las últimas 100 entradas de actividad de facción

/hf help
–
Abrir menú de ayuda interactivo con todos los comandos

/hf wiki
–
Acceder a la documentación en el juego de múltiples páginas

Comandos Administrativos

Comando
Permiso
Descripción

/hf admin
hyfaction.admin
Abrir menú administrativo consolidado

/hf admin-chunk
hyfaction.admin
Abrir GUI de chunk de administrador (ilimitado)

/hf admin-claim
hyfaction.admin
Reclamar el chunk actual (sin restricciones)

/hf admin-unclaim
hyfaction.admin
Desreclamar el chunk actual (cualquier propietario)

/hf admin safezone add
hyfaction.admin
Agregar el chunk actual como zona segura

/hf admin safezone remove
hyfaction.admin
Eliminar la zona segura del chunk actual

/hf admin safezone list
hyfaction.admin
Listar todas las zonas seguras con coordenadas

🔑 Sistema de Permisos

Hyfaction se integra a la perfección con LuckPerms y https://www.hyperperms.com/wiki/integrations/hyfactions para un control granular de permisos. Sin LuckPerms, todos los permisos se otorgan por defecto (modo permisivo).

Permisos Básicos

Permiso
Función
Notas

hyfaction.create
Crear facciones
Requerido para /hf create

hyfaction.invite
Invitar jugadores
También requiere rol de Oficial+

hyfaction.claim
Reclamar chunks
Utilizado en la GUI de chunks

hyfaction.unclaim
Desreclamar chunks
Utilizado en la GUI de chunks

hyfaction.home
Usar hogar de facción
Teleportarse a casa

hyfaction.sethome
Establecer hogar de facción
Solo Propietario + permiso

hyfaction.kick
Expulsar miembros
Propietario/Oficial + permiso

hyfaction.promote
Promover a Oficial
Solo Propietario + permiso

hyfaction.demote
Degradar a Miembro
Solo Propietario + permiso

hyfaction.ally
Gestionar alianzas
Relaciones de aliado/enemigo/neutro

hyfaction.enemy
Gestionar relaciones
Igual que permiso de aliado

hyfaction.disband
Disolver facción
Solo Propietario + permiso

hyfaction.admin
Acceso de administrador
Todos los comandos de administrador + omitir

Jerarquía de Permisos

Propietario: Omitir automáticamente todos los permisos de facción
Oficial: Permisos limitados basados en el rol + LuckPerms
Miembro: Permisos básicos solo a través de LuckPerms
Administrador: Anulación total con permiso hyfaction.admin

Ejemplos de Configuración de LuckPerms

# Otorgar todos los permisos básicos al grupo predeterminado
/lp group default permission set hyfaction.create true
/lp group default permission set hyfaction.invite true
/lp group default permission set hyfaction.claim true
/lp group default permission set hyfaction.unclaim true
/lp group default permission set hyfaction.home true
/lp group default permission set hyfaction.sethome true

# Restringir desreclamaciones (prevenir griefing)
/lp group default permission set hyfaction.unclaim false

# Otorgar permisos de administrador a moderadores
/lp group moderator permission set hyfaction.admin true

# Otorgar todos los permisos al grupo VIP
/lp group vip permission set hyfaction.* true

Notas sobre Permisos

Verificación dual: Se verifica tanto LuckPerms COMO el rol de facción
Omisión de propietario: Los propietarios ignoran LuckPerms para acciones de facción
Por defecto permisivo: Sin LuckPerms, todos los permisos se otorgan
Basado en roles: Los oficiales heredan ciertos permisos automáticamente

⚙️ Configuración

C… [Truncado]