Saltar al contenido

Funciones

Puntos VIP y tienda de rangos

Un saldo global de puntos VIP y una tienda que vende rangos con confirmación, reglas de compra seguras, auditoría y recuperación ante caídas.

El módulo vippoints guarda un saldo entero global por jugador (nunca negativo, el mismo en todos los servidores) y una tienda de plantillas que compran rangos del módulo de rangos.

Requisitos

Activa modules.vippoints.enabled. Vender rangos necesita el módulo de rangos en READY; sin él los saldos funcionan, pero la tienda responde que los rangos no están disponibles.

Reglas de compra

El nivel de un rango es su peso. Solo cuentan los grants activos y sin condiciones de rangos que se venden en la tienda:

  • Mismo rango: se suma el tiempo al grant actual (una plantilla permanente lo vuelve permanente). Si ya es permanente, la compra se bloquea.
  • Rango de tienda superior, o distinto con el mismo peso: bloqueado.
  • Rangos de tienda inferiores: se retiran después de dar el nuevo.
  • No se pueden vender rangos staff, hidden, owner ni default.

La confirmación guarda el precio mostrado: si un admin lo cambia entre buy y confirm, la compra se rechaza.

Seguridad

  • Cada cambio lee el registro y lo escribe con compare-and-set sobre su revisión, igual en MongoDB, MySQL, MariaDB y SQLite.
  • Una compra es una secuencia recuperable: se descuenta el precio y se guarda la compra como pendiente en la misma escritura; después se da el rango con el motivo vipshop:<id-operación>; después se borra la marca de pendiente. Si el rango se rechaza, se devuelven los puntos.
  • Si un servidor cae a mitad de una compra, la compra pendiente se resuelve en la siguiente entrada del jugador, en su siguiente compra o con /vpadmin recover: se completa si el grant existe y se reembolsa si no.

Configuración

vippoints.yml solo afecta al comportamiento local: language, confirm-seconds (5–300), recovery-delay-seconds (60–86400), refresh-seconds (30–3600) y el nombre y alias de cada comando. El saldo máximo global (1000000 por defecto, hasta 1000000000) se guarda en la base de datos y se cambia con /vptemplate max.

Placeholder

%sofycore_vippoints% muestra el saldo del jugador conectado desde memoria; está vacío mientras carga.