Concesiones

Sobre cada cosmético se hacen tres preguntas distintas, y conviene no mezclarlas:

Poseído y puesto están separados a propósito, y esa separación es la razón de que el plugin se comporte como se comporta cuando se acaba un rango o el plugin de permisos va lento.

Nunca se quita nada porque un permiso dijera que no

Lo que un jugador se puso se queda en su fila. La propiedad se vuelve a preguntar allí donde se dibuja una línea, así que un cosmético que ya no posee simplemente deja de dibujarse — y vuelve el día que vuelva a ser suyo, todavía en la fila, todavía donde lo dejó.

Hay exactamente una eliminación que sí se escribe: la de un cosmético que dejó de existir. Cuando un jugador borra una etiqueta o un color propios, o se los borra un admin, se le quitan de la fila al irse. Ya nada podrá responder "sí" por ellos, así que dejarlos ahí solo produciría una línea que no dibuja nada.

De dónde viene la propiedad

El permiso se pregunta en vivo y no se guarda nunca, porque cambia mientras el jugador está desconectado. Las concesiones se leen de donde las tenga quien pregunta — el perfil en memoria si está conectado, la tabla si no — y se filtran en el momento de preguntar, así que una fila caducada sencillamente no es una concesión.

Un --source que no se reconozca se lee como EXTERNAL en vez de rechazarse, y --ref deja anotado qué plugin o qué transacción fue.

Nodos de permiso

Una entrada escrita con permission: false no se posee nunca por un nodo, tenga el jugador el que tenga de los cuatro. La lista completa está en Permisos.

La caducidad es de la concesión

No del cosmético. Una concesión es una fila, y la fila lleva su propio reloj:

Una fila inactiva sencillamente no es una concesión. No hace falta que corra nada para que la concesión de un jugador desconectado deje de contar — la siguiente lectura la descarta. Lo que hacen los temporizadores es avisar y ordenar:

• Barrido en línea, cada 30 segundos. Un solo temporizador recorre los perfiles de quienes están aquí, porque una concesión que se acabó solo merece anunciarse a alguien presente. Cada concesión recién caducada dispara EntitlementExpiredEvent, envía el mensaje expired, y el cosmético deja de dibujarse.
• Al entrar. Con expiry.notify-on-join encendido, el jugador recibe una línea expiring-soon por cada concesión temporal que lleve puesta, con el tiempo que le queda, y una línea expired-on-join con la cuenta de las que llevaba puestas y se acabaron mientras no estaba.
• Retención, una vez al día. Las filas caducadas o revocadas hace más de expiry.retention-days se borran. Hasta entonces se quedan, para que /cca list y una auditoría todavía vean qué se dio.

Las duraciones son las de ExyliaLib: 30m, 2h, 14d, 1w, con decimales.

Varias concesiones del mismo cosmético

Un jugador puede tener más de una concesión del mismo cosmético a la vez — una permanente de un rango, una de admin de 14 días, una compra de 30. Que haya una fila por concesión, y no una fecha de caducidad por cosmético, es lo que hace que eso funcione: quitar una nunca toca las otras.

/cca remove <player> <type:id> [source] revoca todas las concesiones activas de ese cosmético, o solo las de un origen. /cca revoke <id> revoca exactamente una, por el número que imprime /cca list.

Lo que todo el mundo lee es la única respuesta que da Ownership:

Eso es también lo que decide cómo se dibuja una fila en un menú: no poseído es bloqueado, poseído y puesto es seleccionado, poseído y permanente es la plantilla normal, y poseído con reloj es caducando. Ver Menús.

La base de datos

El módulo de base de datos de ExyliaLib, configurado en plugins/ExyliaChatCosmetics/database.yml — H2 por defecto, con MySQL, MariaDB, PostgreSQL y MongoDB soportados. Las tablas se crean y se amplían solas; no hay que importar nada a mano. La referencia completa está en Base de datos.

* indexada.

El perfil se lee una sola vez al entrar — la fila, las concesiones, las filas propias, los loadouts y los saldos de tokens, todo de una — y se guarda en memoria mientras el jugador esté conectado. Dos entradas simultáneas comparten una sola lectura, así que una reconexión rápida no puede hacer que una segunda lectura termine antes y escriba datos más viejos.

Las escrituras se agrupan. Un clic en un menú marca la fila como sucia y un temporizador la vuelca cada 5 segundos, al salir y al apagar. Un jugador rebuscando en un navegador produce una escritura, no treinta.