OrbisGuard | Region Management

Discord (HAZ CLIC AQUÍ)

Protección de regiones para Hytale. Define áreas, establece reglas, controla quién puede hacer qué.

Piense en WorldGuard, pero para Hytale.

Instalación

Coloca OrbisGuard-0.2.0.jar en tu carpeta mods/. Listo.

Protección Extendida con Hyxin (Opcional)

Algunas cosas en Hytale no están expuestas a través de la API normal de plugins. Los jugadores pueden eludir tu protección utilizando recogidas con la tecla F, recolectando automáticamente objetos o colocando fluidos. La API estándar simplemente no nos permite bloquear estas acciones.

Hyxin es un cargador de mixins que permite a los plugins interceptar el código interno del juego. OrbisGuard es actualmente el único plugin de protección que utiliza Hyxin para bloquear estas explotaciones.

Lo que Hyxin permite:

Protección	Bandera	Lo que bloquea
Recogida automática	item-pickup	Objetos que vuelan automáticamente al inventario del jugador
Recogida con tecla F	item-pickup	Presionar F para recoger objetos del suelo
Cambio de variante con martillo	hammer	Usar el martillo para cambiar variantes de bloques
Cosecha con tecla F	block-break	Presionar F para cosechar minerales, cultivos, etc.
Colocación de fluidos	block-place	Colocar agua/lava con cubos

Sin Hyxin, los jugadores aún pueden explotar estas mecánicas en tus regiones protegidas. Con Hyxin, no pueden.

Configuración:

Hytale/
├── earlyplugins/
│   ├── Hyxin-x.x.x.jar             <- Consíguelo de las versiones de Hyxin
│   └── OrbisGuard-Mixins-0.2.0.jar <- Protección extendida
└── mods/
    └── OrbisGuard-0.2.0.jar        <- Plugin principal

El plugin principal funciona sin Hyxin; simplemente no tendrás protección contra esas explotaciones específicas.

Inicio Rápido

/rg wand                     - Habilitar modo de selección
Clic izquierdo: establecer pos1         - Rompe un bloque para marcar la esquina 1
Clic derecho: establecer pos2        - Coloca un bloque para marcar la esquina 2
/rg define myregion          - Crear la región
/rg flag myregion build deny - Bloquear construcción

Todas las Banderas

Protección de Bloques

Bandera	Valores	Por defecto	Lo que hace
build	allow/deny	deny (no miembros)	Control maestro para toda modificación de bloques
block-break	allow/deny	deny (no miembros)	Romper bloques
block-place	allow/deny	deny (no miembros)	Colocar bloques
hammer	allow/deny	deny (no miembros)	Cambio de variantes de bloques con martillo

Interacción

Bandera	Valores	Por defecto	Lo que hace
use	allow/deny	allow	Puertas, botones, palancas, etc.
chest-access	allow/deny	deny (no miembros)	Abrir contenedores

Objetos

Bandera	Valores	Por defecto	Lo que hace
item-pickup	allow/deny	allow	Recoger objetos caídos
item-drop	allow/deny	allow	Dejar objetos
crafting	allow/deny	allow	Usar estaciones de creación

Movimiento

Bandera	Valores	Por defecto	Lo que hace
entry	allow/deny	allow	Entrar en la región
exit	allow/deny	allow	Salir de la región

Combate y Daño

Bandera	Valores	Por defecto	Lo que hace
pvp	allow/deny	allow	Daño entre jugadores
damage	allow/deny	allow	Todo daño (control maestro)
fall-damage	allow/deny	allow	Solo daño por caída

Mensajes y Títulos

Bandera	Valores	Por defecto	Lo que hace
greet-title	texto	nombre de la región	Título mostrado al entrar
greet-message	texto	ninguno	Mensaje de chat al entrar
farewell-title	texto	ninguno	Título mostrado al salir
farewell-message	texto	ninguno	Mensaje de chat al salir
notify-enter	allow/deny	allow	Mostrar título de entrada
notify-leave	allow/deny	allow	Mostrar título de salida
deny-message	texto	ninguno	Mensaje de denegación personalizado

Minimapa

Bandera	Valores	Por defecto	Lo que hace
show-on-minimap	true/false	true	Mostrar región en el minimapa
minimap-color	color hex	auto	Color de la región (#FF5500 o 0xFF5500)
minimap-opacity	0-100	75	Opacidad de relleno
minimap-border-opacity	0-100	90	Opacidad del borde
minimap-label	texto	nombre de la región	Etiqueta del marcador (vacío = oculto)
minimap-icon	nombre de archivo	Spawn.png	Icono del marcador

Especial

Bandera	Valores	Por defecto	Lo que hace
passthrough	allow/deny	deny	Eludir la protección de CONSTRUCCIÓN

Integración con LuckPerms

OrbisGuard funciona con LuckPerms para permisos basados en grupos. Añade grupos de permisos completos como miembros o propietarios de la región en lugar de jugadores individuales.

/rg addmember spawn g:vip        <- Todos los jugadores en el grupo "vip" pueden construir
/rg addowner arena g:staff       <- Todos los miembros del personal son propietarios
/rg addmember shop g:premium     <- Los jugadores premium obtienen acceso

El acceso a la región se verifica automáticamente contra los grupos de LuckPerms del jugador. Cuando un jugador se une a un grupo, obtiene acceso instantáneamente a las regiones de las que ese grupo es miembro.

Comandos

Comando	Lo que hace
/rg wand	Alternar modo de varita de selección
/rg pos1 [x y z]	Establecer posición 1 (sin argumentos = tu posición)
/rg pos2 [x y z]	Establecer posición 2 (sin argumentos = tu posición)
/rg define <nombre>	Crear región a partir de la selección
/rg remove <nombre>	Eliminar una región
/rg redefine <nombre>	Actualizar límites de la región
/rg flag <región> <bandera> <valor>	Establecer una bandera
/rg flag <región> <bandera> clear	Eliminar una bandera
/rg setpriority <región> <número>	Establecer prioridad de la región
/rg addowner <región> <jugador>	Añadir propietario
/rg removeowner <región> <jugador>	Eliminar propietario
/rg addmember <región> <jugador>	Añadir miembro
/rg removemember <región> <jugador>	Eliminar miembro
/rg info [región]	Mostrar detalles de la región
/rg list	Listar todas las regiones
/rg regions	Listar regiones en tu ubicación
/rg select <región>	Cargar límites de la región en la selección
/rg bypass	Alternar modo de elusión de administrador
/rg save	Forzar guardar todas las regiones
/rg load	Recargar regiones desde el disco
/rg reload	Recargar configuración

Tipos de Regiones

• Cuboid – Forma de caja, definida por dos esquinas
• Poligonal – Forma 2D personalizada con límites Y min/max
• Global – Cubre todo el mundo (fallback de prioridad más baja)

Sistema de Prioridad

Número más alto = mayor prioridad. Cuando las regiones se superponen, la de mayor prioridad gana.

/rg setpriority wilderness 0
/rg setpriority spawn 100

Spawn (100) anula wilderness (0) donde se superponen.

Almacenamiento

Las regiones y los jugadores se almacenan como archivos JSON individuales:

mods/OrbisGuard/data/
├── regions/
│   └── world_name/
│       ├── spawn.json
│       ├── arena.json
│       └── shop.json
└── players/
    ├── uuid1.json
    └── uuid2.json

Un archivo por región, un archivo por jugador. Fácil de respaldar, editar o transferir regiones individuales entre servidores.

¿Actualizando desde 0.1.0? El antiguo formato de archivo único se migra automáticamente en el primer inicio. Tus datos están a salvo.

Para Desarrolladores

OrbisGuard tiene una API pública. Añade orbisguard-api como dependencia:

OrbisGuardAPI api = OrbisGuardAPI.getInstance();
if (api != null) {
    IRegionContainer container = api.getRegionContainer();
    Set<IRegion> regions = container.getRegionManager("world").getRegionsAt(x, y, z);
}

Eventos disponibles:

• RegionCreatedEvent
• RegionDeletedEvent
• RegionRedefinedEvent
• FlagChangedEvent
• MembershipChangedEvent

Soporte

¿Problemas o solicitudes de características? Contacta con w1fl0w en Discord.