QSMenu - Wiki Oficial
QSMenu es un potente motor de interfaces (GUI) para Minecraft que permite crear menús dinámicos con lógica inteligente, soporte HEX, compatibilidad con
Java + Bedrock, y comandos automáticos.
1. Instalación
Requisitos obligatorios
* Servidor
Paper 1.21.1+ (o compatible)
Compatibilidad con Bedrock (Opcional)
Para habilitar menús para jugadores de Bedrock necesitas:
*
Geyser
*
Floodgate
Si no instalas estos plugins, QSMenu seguirá funcionando normalmente para jugadores Java.
Pasos de instalación
1. Descarga
QsMenu.jar
2. Colócalo en:
3. Reinicia el servidor o usa:
Code (Text):
/qsmenu reload
Generación de archivos
Code (Text):
/plugins/QsMenu/
├── menus/
└── config.yml
Notas importantes
* No requiere dependencias obligatorias
* Bedrock es opcional
* Compatible con PlaceholderAPI (recomendado)
2. Estructura Principal
Code (Text):
title: "Título"
bedrock-title: "Título Bedrock"
size: 27
command: menu
aliases:
- alias1
*
title: Título Java (HEX permitido)
*
bedrock-title: Título Bedrock
*
size: 9–54
*
command: Comando automático
*
aliases: Comandos alternativos
3. Compatibilidad Automática
Code (Text):
Java -> items
Bedrock -> bedrock-items
4. Sistema Java (Inventario)
Code (Text):
items:
ejemplo:
slot: 10
material: DIAMOND
name: "&bEjemplo"
lore:
- "&7Descripción"
5. Sistema Bedrock (Forms Modernos)
Debes definir:
Code (Text):
bedrock:
type: simple | modal | custom
5.1 Simple Form
Menú con botones.
Code (Text):
bedrock:
type: simple
bedrock-content: |
&8Menú principal
&7Selecciona una opción
bedrock-items:
opcion1:
text: "&aOpción 1"
commands:
- "[player] say Hola"
cerrar:
text: "&cCerrar"
close: true
5.2 Modal Form
Confirmación Sí / No.
Code (Text):
bedrock:
type: modal
bedrock-content: |
&7¿Confirmar acción?
bedrock-items:
accept:
text: "§aSí"
commands:
- "[console] eco take %player_name% 100"
deny:
text: "§cCancelar"
commands:
- "[player] say Cancelado"
5.3 Custom Form
Inputs avanzados.
Code (Text):
bedrock:
type: custom
fields:
nombre:
type: input
text: "Tu nombre"
placeholder: "Escribe..."
commands:
- "[player] say Nombre: {value}"
pvp:
type: toggle
text: "Activar PvP"
default: true
commands:
- "[player] say PvP: {value}"
rango:
type: dropdown
text: "Rango"
options:
- "VIP"
- "MVP"
- "ELITE"
commands:
- "[console] lp user %player_name% parent set {value}"
5.4 Tipos de Fields
* input → texto
* toggle → true/false
* dropdown → lista
5.5 Variables
* {value} → valor ingresado
6. Sistema ELSE (Estados Dinámicos)
Code (Text):
conditions:
- "%vault_eco_balance% >= 500"
else:
material: BARRIER
7. Condiciones Avanzadas
Comparación
Code (Text):
== != > < >= <=
Texto
Code (Text):
contains
!contains
Lógica
Code (Text):
&& (AND)
|| (OR)
! (NOT)
Ejemplo
Code (Text):
- "(%vault_eco_balance% >= 500 && %player_level% >= 10) || %player_is_op% == true"
Errores comunes
Incorrecto:
Code (Text):
"%vault_eco_balance%>=500"
Correcto:
Code (Text):
"%vault_eco_balance% >= 500"
8. Acciones
Comandos
* player-commands
* console-commands
Navegación
* open-menu
* back
* close
Extras
* message
* sound
* title
9. Ejemplos Reales
Perfil (Simple)
Code (Text):
bedrock:
type: simple
bedrock-content: |
&8Perfil de &e%player_name%
&7Nivel: &f%player_level%
bedrock-items:
info:
text: "Ver info"
commands:
- "[player] say Hola %player_name%"
Confirmación (Modal)
Code (Text):
bedrock:
type: modal
bedrock-items:
accept:
text: "§aConfirmar"
commands:
- "[console] eco take %player_name% 100"
deny:
text: "§cCancelar"
Configuración (Custom)
Code (Text):
bedrock:
type: custom
fields:
nombre:
type: input
text: "Nombre"
commands:
- "[player] say {value}"
10. Colores
Java (HEX)
Bedrock
Code (Text):
&a Verde
&c Rojo
&e Amarillo
11. Comandos
Code (Text):
/menu <id>
/menu open <id> <jugador>
/qsmenu reload
Comandos dinámicos
Code (Text):
command: rangos
aliases:
- rank
12. Buenas Prácticas
* Usa HEX solo en Java
* Usa & en Bedrock
* Evita lógica innecesaria
* Usa múltiples condiciones
13. FAQ
Comando en rojo
→ Usa /qsmenu reload
Placeholders no funcionan
→ Instala PlaceholderAPI
Bedrock no funciona
→ Instala Geyser + Floodgate
Ítem no aparece
→ Revisar conditions / slot / material
Discord:
Click aquí para unirte