ProtectionStones Custom

Fork personalizado de ProtectionStones con mejoras enfocadas en administracion visual, configuracion mas amigable y traduccion al español.

Cambios principales

1. Migracion de configuracion a YAML

• La configuracion principal fue migrada de TOML a YAML.
• Ahora se usan:
  • config.yml
  • gui.yml
  • flags.yml
  • messages.yml
  • blocks/*.yml
• Se agrego migracion automatica desde config.toml y blocks/*.toml a archivos YAML.

2. Soporte de colores HEX

• Se mejoro el sistema de colores para soportar:
  • &#RRGGBB
  • tokens visuales como %primary% y %secondary%
• Se integro Adventure para renderizado de mensajes.
• Los colores base usados en esta personalizacion son:
  • Primario: #BFE6EC
  • Secundario: #FA7A79

3. GUI principal de gestion

• Se agrego el comando:
  • /ps gui
• El GUI principal permite:
  • ver tus protecciones
  • abrir la proteccion actual
  • acceder rapidamente a regiones desde un menu visual

4. Apertura del GUI con clic derecho

• Al hacer clic derecho sobre una protection stone, se abre el menu de gestion de esa proteccion.
• El acceso se valida para:
  • owner
  • coowner / owner adicional
  • miembro
  • admin / superowner

5. Menu de gestion configurable por gui.yml

• El menu de gestion de cada proteccion ahora es configurable desde gui.yml.
• Se pueden configurar:
  • titulo
  • tamaño
  • slots
  • materiales
  • nombres
  • lore

6. Sistema de miembros con cabezas

• Se agrego GUI para gestionar miembros y owners.
• Se agrego selector de jugadores online con cabezas/skins.
• Permite:
  • agregar miembros
  • agregar owners
  • remover miembros
  • remover owners

7. Nuevo sistema de flags visuales

• Se agrego flags.yml para personalizar el GUI de flags.
• Cada flag puede definir su propio item visual.
• Si una flag no esta definida en flags.yml, usa un item por defecto.
• El GUI soporta mejor:
  • StateFlag
  • BooleanFlag
  • EnumFlag
  • flags con valor manual

8. Edicion manual de flags por chat

• Cuando una flag requiere texto o un valor manual:
  • el menu se cierra
  • el jugador escribe el valor por chat
  • puede escribir cancelar para abortar
  • el GUI vuelve a abrirse automaticamente

9. Simplificacion del manejo de grupos en flags

• Se removio la edicion de grupos desde el GUI de flags.
• Esto se hizo para simplificar la experiencia del usuario final.
• El GUI ahora solo se enfoca en editar el valor principal de la flag.

10. Traduccion al español

• messages.yml fue traducido al español.
• gui.yml fue preparado en español.
• flags.yml fue preparado en español.
• Muchos textos visibles del sistema GUI y de flags fueron adaptados a la nueva paleta visual.

11. Tienda configurable con shop.yml

• Se agrego un shop GUI editable para comprar protection stones de forma interactiva.
• El shop usa el alias del bloque como identificador principal.
• Cada item del shop puede personalizar:
  • slot
  • nombre
  • lore
  • material visual del icono
  • cantidad mostrada
• /ps get ahora abre el shop cuando se usa sin argumentos.
• La compra sigue usando la lógica económica existente del plugin.

Archivos nuevos o importantes

Configuracion

• src/main/resources/config.yml
• src/main/resources/gui.yml
• src/main/resources/flags.yml
• src/main/resources/shop.yml
• src/main/resources/messages.yml
• src/main/resources/block1.yml

Codigo

• src/main/java/dev/espi/protectionstones/gui/GUIConfig.java
• src/main/java/dev/espi/protectionstones/gui/FlagsGUIConfig.java
• src/main/java/dev/espi/protectionstones/gui/GUIManager.java
• src/main/java/dev/espi/protectionstones/gui/GUIScreen.java
• src/main/java/dev/espi/protectionstones/gui/MainGUI.java
• src/main/java/dev/espi/protectionstones/gui/RegionListGUI.java
• src/main/java/dev/espi/protectionstones/gui/RegionManageGUI.java
• src/main/java/dev/espi/protectionstones/gui/RegionMembersGUI.java
• src/main/java/dev/espi/protectionstones/gui/PlayerSelectorGUI.java
• src/main/java/dev/espi/protectionstones/gui/RegionFlagsGUI.java
• src/main/java/dev/espi/protectionstones/gui/ShopGUI.java
• src/main/java/dev/espi/protectionstones/gui/ShopGUIConfig.java
• src/main/java/dev/espi/protectionstones/commands/ArgGUI.java

Uso rapido

Abrir menu principal

/ps gui

Abrir tienda

/ps get

Abrir menu de una proteccion

• Haz clic derecho sobre una protection stone que te pertenezca o donde seas miembro.

Editar flags

• Abre el menu de gestion
• Entra en Flags
• Haz clic sobre la flag que quieras cambiar
• Si la flag requiere texto, escribe el valor en el chat
• Escribe cancelar para volver sin guardar

Comprar protecciones desde el shop

• Abre /ps get
• Haz clic sobre la protection stone del shop
• Si tienes dinero suficiente, se te entrega el item

Notas

• Si ya existe messages.yml, gui.yml o flags.yml en la carpeta del plugin, el plugin no los sobreescribe automaticamente.
• Para aplicar nuevas versiones por defecto de esos archivos:
  • renombrarlos o borrarlos
  • reiniciar el servidor
  • o copiar manualmente el contenido nuevo

Recomendacion de despliegue

Despues de actualizar este fork:

1. Revisa gui.yml
2. Revisa flags.yml
3. Revisa shop.yml
4. Revisa messages.yml
5. Revisa tus blocks/*.yml, especialmente allowed_flags

Licencia

Este proyecto mantiene la licencia original GPLv3 de ProtectionStones.