Skip to content

CosmosAPI v1.0.3

Pre-release
Pre-release

Choose a tag to compare

@SrJayYT SrJayYT released this 04 Sep 04:04
· 2 commits to main since this release

Novedades y correcciones

Los cambios están ordenados desde lo añadido más recientemente hasta lo anterior.

Tiendas Cosmos por archivos

  • Añadidas tiendas independientes de EconomyShopGUI en sections/, shops/ e inventory/.
  • Las tiendas admiten moneda por cosmo, permisos, mundos deshabilitados, páginas, decoración, compra y venta con clic.
  • /cosmo reload ahora cierra las tiendas abiertas para impedir transacciones con una configuración ya reemplazada.
  • Corregida la validación de secciones enlazadas a una tienda inexistente y la carga de archivos .yml con extensión en mayúsculas.
  • Los objetos que no caben al comprar o restaurar una venta se dejan de forma segura en el suelo del jugador.

Empaquetado

  • XSeries se incluye en el JAR final mediante Maven para evitar errores de clase faltante al iniciar.
  • El proyecto continúa compilándose exclusivamente con Maven mediante pom.xml; no usa Gradle.

Saldos y formato numérico

  • Los saldos de cosmos ahora pueden ser negativos.
  • /cosmo give y /cosmo set aceptan ajustes negativos para administradores.
  • Los saldos se muestran abreviados, incluidos los negativos: 1,334 → 1,33k, -2,435,464 → -2,43M.
  • El formato dispone de sufijos hasta decillón (Dc) y no modifica el valor real almacenado.

Protección anti-multicuenta

  • Nueva protección opcional para recompensas y condiciones PLAYER_KILL.
  • Al activar anti-alt.same-ip-player-kill: true, matar a un jugador con la misma IP no entrega ni retira cosmos.
  • La protección está desactivada por defecto.

Recompensas globales

  • Nuevo comando administrativo: /cosmo giveall <cosmo> <cantidad>.
  • Entrega el cosmo indicado a todos los jugadores conectados.
  • Incluye anuncio global y una melodía para los jugadores en línea.

Menús y hologramas

  • Nuevas opciones globales en config.yml:
menus:
  enabled: false

holograms:
  enabled: true
  • Los menús pueden desactivarse completamente.
  • Los hologramas se pueden desactivar y se eliminan los hologramas activos al recargar la configuración.

Control individual de menús

  • Nuevo control administrativo por menú: /cosmo menu enabled <menu> y /cosmo menu disabled <menu>.
  • Cada menú guarda su estado enabled: true/false en menus.yml.
  • Los menús desactivados no aparecen en el directorio, no pueden abrirse y no registran su comando público.
  • Los nuevos menús se crean activados por defecto.

Consultas sin menús

  • Nuevo comando /cosmos balance <cosmo> para consultar tu saldo sin abrir un menú.
  • Nuevo comando /cosmos baltop <cosmo> para mostrar los 15 jugadores con mayor saldo.
  • Ambos comandos continúan disponibles aunque el menú correspondiente esté desactivado.

Placeholders simplificados

  • Nuevo formato principal de PlaceholderAPI:
%cosmos_<cosmo>%
%cosmos_<cosmo>_displayname%
%cosmos_cosmos%

Ejemplos:

%cosmos_pichula%
%cosmos_pichula_displayname%
  • En menus.yml, usa %cosmos_<cosmo>% para mostrar el saldo y {cosmo-name} exclusivamente para el nombre visible.
  • Se conserva compatibilidad con los placeholders heredados %cosmosapi_<cosmo>%.

Correcciones de PlaceholderAPI

  • Los nombres y lore de los ítems, botones y decoraciones de todos los menús ahora procesan placeholders de PlaceholderAPI.
  • Se corrigió el reemplazo de los saldos de Cosmos dentro de los menús, incluidos %cosmos_<cosmo>%, %cosmos_cosmo% y {balance}.
  • Se añadió el alias explícito %cosmos_balance_<cosmo>% para consultar el saldo de una economía.

Ejemplo:

%cosmos_gemas%
%cosmos_balance_gemas%

EconomyShopGUI: compras y ventas

  • La integración usa economías externas con el formato EXTERNAL:CosmosAPI_<id>.
  • Ejemplo para un cosmo con ID gemas:
economy: EXTERNAL:CosmosAPI_gemas
  • Se corrigió el manejo de importes decimales: como los Cosmos son monedas enteras, las compras y ventas con precios decimales se rechazan en lugar de redondearse y cobrar o pagar un importe incorrecto.
  • Las operaciones validan que la economía Cosmos exista, que el importe sea válido y que el jugador tenga saldo suficiente antes de ejecutarse.

Notas

  • Ejecuta /cosmo reload después de modificar config.yml.
  • Después de crear o eliminar Cosmos usados por EconomyShopGUI, ejecuta /sreload tras /cosmo reload para que EconomyShopGUI vuelva a registrar las economías externas.
  • EconomyShopGUI y PlaceholderAPI continúan siendo integraciones opcionales.
  • Consulta README.md para la documentación completa de comandos, permisos, configuración y placeholders.