Saltar al contenido

Documentación para desarrolladores de sofyCore

Usa la API Java pública de sofyCore para leer rangos, emitir sanciones, congelar, activar vanish, abrir menús, mover puntos VIP y escuchar eventos.

sofyCore expone una API independiente de la plataforma en el paquete net.sofycore.api (módulo sofycore-api). Tu plugin compila contra ella con alcance provided y obtiene la implementación del ServicesManager de Bukkit en tiempo de ejecución.

Principios de diseño

  • Servicios tipados, sin ejecutor genérico. Las acciones se exponen mediante servicios tipados. No existe una API para "ejecutar cualquier cosa" sin permisos.
  • I/O asíncrono. Los métodos que tocan la base de datos o Redis devuelven CompletableFuture y se ejecutan en hilos de trabajo acotados.
  • Las mismas reglas que los comandos. Los servicios que actúan sobre jugadores aplican los mismos permisos y jerarquía que los comandos del juego.
  • Sin tipos de plataforma en la API. sofycore-api no importa clases de Bukkit, NMS ni drivers de bases de datos.