Primeros pasos
Inicializar la API
Carga SofyCoreApi desde el ServicesManager de Bukkit, espera StorageReadyEvent sin bloquear y pide los servicios de forma segura.
Cargar el punto de entrada
import net.sofycore.api.SofyCoreApi;
import org.bukkit.Bukkit;
import org.bukkit.plugin.java.JavaPlugin;
public final class MyPlugin extends JavaPlugin {
private SofyCoreApi sofy;
@Override
public void onEnable() {
sofy = Bukkit.getServicesManager().load(SofyCoreApi.class);
if (sofy == null) {
getLogger().severe("sofyCore is not available");
getServer().getPluginManager().disablePlugin(this);
return;
}
}
}Esperar al almacenamiento sin bloquear
Los servicios con persistencia se registran cuando el arranque asíncrono termina con éxito. Suscríbete a StorageReadyEvent (publicado en el hilo de Minecraft) y comprueba también si el core ya está listo. Nunca bloquees onEnable esperando el evento.
import net.sofycore.api.storage.PersistenceService;
import net.sofycore.api.storage.StorageReadyEvent;
AutoCloseable readySub = sofy.events().subscribe(StorageReadyEvent.class, event -> start(event.api()));
if (sofy.service(PersistenceService.class).isPresent()) {
start(sofy); // el almacenamiento ya estaba listo
}
private void start(SofyCoreApi api) {
// pide aquí los servicios
}Pedir servicios
api.service(RankService.class).ifPresent(ranks -> {
// el módulo de rangos está en marcha
});service() devuelve Optional.empty() si el módulo está apagado, falló o no está listo. No guardes un servicio para siempre: una recarga del módulo retira y vuelve a registrar su servicio.