HyGuild

Únete a nuestro Discord para soporte, actualizaciones y documentación.

HyGuild es un plugin de gremios completo para servidores de Hytale, diseñado para entornos multijugador y de rol.
Proporciona un sistema de gremios completo con roles, permisos, economía, reclamaciones de territorio, marcadores de posición y un filtro de visibilidad de mapa inteligente que solo muestra a los miembros del gremio.

El plugin es ligero, eficiente y totalmente configurable.

✨ Características Principales

Creación y gestión de gremios

Jerarquía de roles de 4 niveles (Líder, Oficial, Miembro, Recluta)

Soporte para permisos de LuckPerms

API de Marcadores de Posición Interna (utilizable por otros plugins)

Chat privado de gremio (/g)

Notificaciones en pantalla para eventos de gremio

Filtro de visibilidad de mapa inteligente

Reclamaciones de territorio del gremio

Sistema de dinero personal y banco del gremio

Persistencia de datos en JSON

Soporte multilingüe (Italiano e Inglés)

🧩 Sistema de Gremios

Nombres de gremios personalizados

Máximo de miembros por gremio configurable

Membresía basada en invitaciones

Almacenamiento persistente utilizando JSON

Roles y Permisos

Líder: Control total (invitar, expulsar, promover, degradar, disolver)

Oficial: Invitar y expulsar miembros

Miembro: Miembro estándar

Recluta: Nuevo miembro

💬 Sistema de Chat

Chat privado de gremio: /g <mensaje>

Prefijo de color [CHAT-GREMIO]

El chat público muestra: [NombreDelGremio] NombreDelJugador: mensaje

🗺️ Filtro de Mapa Inteligente

Jugadores en un gremio:

Se ven a sí mismos

Ven SOLO a los miembros del gremio

No ven otros jugadores

Jugadores sin gremio:

Solo se ven a sí mismos

📢 Notificaciones en Pantalla

Los miembros del gremio reciben notificaciones por:

Ingreso / salida de miembros

Eventos de expulsión

Promociones / degradaciones

Disolución del gremio

Los jugadores invitados o afectados reciben notificaciones personales.

🛠️ Comandos

/gremio crear <nombre>

/gremio invitar <jugador>

/gremio aceptar

/gremio salir

/gremio expulsar <jugador>

/gremio disolver

/gremio promover <jugador>

/gremio degradar

/gremio lista

/gremio info

/g


🔐 Permisos (LuckPerms)

HyGuild es totalmente compatible con LuckPerms, con permisos granulares para:

Gestión de gremios

Reclamaciones

Chat

Economía

Sobrescritura de administrador (hyguild.admin, hyguild.*)

🔗 API de Marcadores de Posición

HyGuild incluye una API de Marcadores de Posición integrada que se puede usar en:

Mensajes

Formatos de chat

Archivos de configuración

Otros plugins

Los marcadores de posición disponibles incluyen:

%hyguild_player%

%hyguild_uuid%

%hyguild_guild%

%hyguild_role%

%hyguild_members%

%hyguild_maxmembers%

%hyguild_claims%

%hyguild_money%

%hyguild_bank%

%hyguild_has_guild%

%hyguild_is_leader%


🖥️ GUI (En Desarrollo)

/gremio lista abrirá una GUI en lugar de la salida de chat

/gremio info abrirá una GUI con toda la información del gremio

Las GUIs reutilizarán la lógica de comandos existente (sin lógica duplicada)

⚙️ Configuración

Ruta: mods/com.hytale_GuildPlugin/config.json

Idiomas:

it – Italiano (predeterminado)

en – Inglés

⚠️ Se requiere reinicio del servidor después del cambio de idioma.

📦 Detalles Técnicos

Persistencia en JSON

Estructuras de datos seguras para hilos

Cache de jugadores para mejorar el rendimiento

Filtrado dinámico de mapas

Registro mínimo (solo errores)

📌 Versión y Compatibilidad

Versión: 1.2.0

Compatible con: Servidor Hytale 2026.01.13+

Idiomas: Italiano 🇮🇹, Inglés 🇬🇧

El equipo de HyGuild