Saltar al contenido

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

Java
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

Java
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.