AxinMenuGui

🇬🇧 English

AxinMenuGUI

Current version: v0.7.6

AxinMenuGUI is a Vintage Story mod for creating interactive chest-style GUI menus fully driven by JSON.

New in current versions:
It now supports global teleports (ATP), direct coordinate teleport actions, and safe random teleport (RTP). This allows building admin travel panels, paid travel services, event arrival points, progression-based teleports, or objective-locked destinations.

It can be used for:

• server menus
• help and info panels
• admin menus
• navigation hubs
• shops
• ranking/stat menus
• progression and unlock systems
• player data panels
• teleport panels

🌐 Visual Generator:
https://elyandrak.github.io/AxinMenuGUI/

Main features

• chest-style GUI menus matching Vintage Story
• JSON menu definitions
• multi-scene navigation
• interactive click events
• player and server commands
• item actions: give, take, buy, sell
• persistent player variables
• conditions such as item checks, privilege checks, comparisons and cooldowns
• placeholders for player stats and rankings
• vanilla items or custom icons as menu buttons
• built-in example menus

Teleport systems

Current versions include:

• teleport to fixed coordinates from JSON
• teleportSaved / ATP for named global admin-defined points
• /atp set / list / info / go / del
• randomTeleport / /artp with safe terrain validation

This makes it possible to:

• sell or reward travel access
• create event/hub destinations
• offer objective-based teleport unlocks
• separate global admin destinations from personal player destinations

Themes

Includes 14 Cairo-based themes, configurable per menu or per scene.

Player data, stats and ranking

The mod supports persistent player data plus tracked stats such as:

• playtime
• deaths
• mob kills
• hostile kills
• hostile kill points
• player kills

These values can be shown in menus and used for progression, rewards, rankings or conditions.

Example menus

The mod includes embedded example menus.

Important: official example JSON files are automatically regenerated on reload/startup, so they should be used as templates and copied before customization.

Current status

AxinMenuGUI is currently a solid real-server base with:

• multi-scene chest GUI menus
• actions and conditions
• themes
• player data and ranking
• embedded examples
• teleport, ATP and RTP systems

Some recently added systems are still under extended real-world validation.

Author

elYandrack
AXIN Project

---

🇪🇸 Español

AxinMenuGUI

Versión actual: v0.7.6

AxinMenuGUI es un mod para Vintage Story que permite crear menús GUI interactivos tipo cofre, totalmente configurables mediante JSON.

Novedades principales de las versiones actuales:
Ahora incluye teleports globales (ATP), acciones de teleport por coordenadas y random teleport seguro (RTP). Esto permite crear paneles de viaje administrativos, servicios de teleport de pago, puntos de llegada para eventos, destinos bloqueados por objetivos o progresión, y sistemas separados entre destinos globales y personales.

Se puede usar para:

• menús de servidor
• paneles de ayuda e información
• menús administrativos
• hubs de navegación
• tiendas
• menús de ranking y estadísticas
• progresión y desbloqueos
• paneles de datos de jugador
• paneles de teleport

🌐 Generador visual:
https://elyandrak.github.io/AxinMenuGUI/

Funcionalidades principales

• menús tipo cofre integrados con la estética de Vintage Story
• definición completa por JSON
• navegación multiescena
• eventos de clic interactivos
• comandos de jugador y de servidor
• acciones sobre ítems: dar, quitar, comprar, vender
• variables persistentes de jugador
• condiciones como ítems, privilegios, comparaciones y cooldowns
• placeholders para estadísticas y ranking
• uso de ítems vanilla o iconos personalizados
• menús de ejemplo integrados

Sistemas de teleport

Las versiones actuales incluyen:

• teleport a coordenadas desde JSON
• teleportSaved / ATP para puntos globales definidos por admin
• comandos /atp set / list / info / go / del
• randomTeleport / /artp con validación segura de terreno

Esto permite:

• vender o premiar acceso a teleports
• crear destinos para eventos o hubs
• desbloquear viajes por objetivos o progreso
• separar destinos globales del admin de destinos personales del jugador

Temas visuales

Incluye 14 temas basados en Cairo, configurables por menú o por escena.

Datos de jugador, estadísticas y ranking

El mod incluye datos persistentes de jugador y seguimiento de estadísticas como:

• tiempo jugado
• muertes
• mobs eliminados
• kills hostiles
• puntos por kills hostiles
• jugadores eliminados

Estos valores pueden mostrarse en menús y usarse para progresión, recompensas, ranking o condiciones.

Menús de ejemplo

El mod incluye menús de ejemplo embebidos.

Importante: los JSON oficiales de ejemplo se regeneran automáticamente al recargar o arrancar el mod, así que deben usarse como plantilla y copiarse antes de personalizarlos.

Estado actual

AxinMenuGUI ofrece actualmente una base sólida para servidores reales con:

• menús GUI tipo cofre multiescena
• acciones y condiciones
• temas visuales
• datos persistentes y ranking
• ejemplos integrados
• sistemas de teleport, ATP y RTP

Algunos sistemas añadidos recientemente siguen en validación ampliada en entornos reales.

Autor

elYandrack
Proyecto AXIN