Módulos
API de puntos VIP y mantenimiento
Mueve puntos VIP, previsualiza y ejecuta compras, y controla el mantenimiento de la network desde tu plugin.
Puntos VIP
VippointsService points = api.service(VippointsService.class).orElseThrow(IllegalStateException::new);
points.addAsync(player.getUniqueId(), 100, "MyPlugin:daily-reward").whenComplete((balance, error) -> {
if (error != null) { /* ver abajo */ return; }
getLogger().info("New balance: " + balance);
});Los rechazos son IllegalArgumentException con un código de VippointsService.REASONS (por ejemplo insufficient, limit, user-not-found, purchase-pending, busy). Cualquier otro error significa que el resultado es incierto: comprueba el saldo antes de reintentar.
purchaseAsync(player, template, expectedPrice) debe ir precedido de una confirmación mostrada al jugador (previewAsync).
Mantenimiento
api.service(MaintenanceService.class).ifPresent(m -> {
if (m.enabled()) getLogger().info("Maintenance: " + m.state().reason);
});enableAsync(actor, reason, freezeRanks, bonusMillis) y disableAsync(actor, bonusMillis) rechazan con maintenance-already-on, maintenance-already-off, invalid-duration o busy.