Da y quita cosméticos
Da un cosmético a un jugador para siempre o por un tiempo, quítaselo, o deja que un rango lo posea por permiso, y mira qué pasa cuando caduca.
Un jugador posee un cosmético por un permiso o por una concesión tuya. Una concesión puede ser permanente o caducar, y puedes retirarla cuando quieras.
Antes de empezar#
Una entrada con permission: false solo la poseen las concesiones, tenga el jugador el permiso que tenga. Para el resto, valen las dos vías y se pueden mezclar.
Da un cosmético#
Ejecuta el comando
/cca give <jugador> <tipo:id> [duración], por ejemplo /cca give Notch tag:heart (permanente) o /cca give Notch chat_color:aurora 30d (30 días). Las duraciones son 30m, 2h, 14d, 1w; se admiten decimales.
Anota de dónde viene (opcional)
Añade --source <nombre>, --ref <id> y --note <texto> para distinguir luego una compra de un premio, por ejemplo --source PURCHASE --ref pedido-1042. Una fuente desconocida se guarda como EXTERNAL.
Comprueba
/cca check <jugador> <tipo:id> dice si lo posee, y /cca list <jugador> lista sus concesiones con un número cada una.
O dalo por permiso: exyliachatcosmetics.<tipo>.<id> desbloquea uno y los comodines de abajo desbloquean más. Usa tu plugin de permisos, por ejemplo LuckPerms, y mira Permisos.
| Permiso | Concede |
|---|---|
exyliachatcosmetics.tag.heart | un cosmético |
exyliachatcosmetics.tag.category.premium | todos los cosméticos de una pestaña de un tipo |
exyliachatcosmetics.tag.* | todos los cosméticos de un tipo |
exyliachatcosmetics.* | todo |
Comprueba que funciona#
El jugador ejecuta /cc tags (o el menú de ese tipo). El cosmético ya no está bloqueado y puede hacer clic para llevarlo.
Ir más lejos#
Quítalo#
/cca remove <jugador> <tipo:id> [fuente] confirmrevoca todas las concesiones activas de ese cosmético, o solo las de una fuente./cca revoke <id>revoca exactamente una, por el número que imprime/cca list./cca unequip <jugador> <tipo>y/cca equip <jugador> <tipo:id>cambian lo que lleva./cca clear <jugador> confirmle quita todo a un jugador conectado.
Un jugador puede tener varias concesiones del mismo cosmético (una permanente por un rango, una compra de 30 días). Quitar una nunca toca las demás.
Cuando caduca una concesión#
El cosmético deja de dibujarse, el jugador recibe un mensaje expired y un barrido de jugadores conectados corre cada 30 segundos. Con expiry.notify-on-join activo (por defecto), al entrar se avisa de las concesiones temporales que se acaban y de las puestas que caducaron mientras no estaba. Las filas caducadas o revocadas se guardan expiry.retention-days días (por defecto 30) para que /cca list siga mostrando qué se dio, y luego se borran.
Concesiones en una red#
Cada concesión recuerda el ámbito de servidor con el que se dio, definido por ownership.scope en config.yml (ver Configuración). Con un ámbito distinto de global, una concesión solo cuenta en los servidores de ese ámbito. Un cosmético comprado con una de las ownership.global-currencies, y toda concesión hecha antes de la 1.4.0, cuenta en todos los servidores. Nuevo en v1.4.0
Por qué un cosmético sigue "puesto" al perder el rango#
Lo que lleva un jugador se guarda en su fila y la posesión se vuelve a preguntar cada vez que se dibuja una línea. Un cosmético que ya no posee simplemente no se dibuja, y vuelve el día que sea suyo otra vez, donde lo dejó. No se quita nada porque un permiso dijera que no: un plugin de permisos que aún está cargando al entrar nunca debe quitarle a nadie sus cosméticos para siempre. La única baja que se escribe es la de un cosmético propio que se borró.
Detalles técnicos
Tres preguntas separadas: disponible (existe, no es hidden), poseído (un permiso o concesión válidos) y puesto (se lleva). Orígenes de la posesión:
| Origen | Se guarda | Viene de |
|---|---|---|
PERMISSION | no, se pregunta en vivo | exyliachatcosmetics.<tipo>.<id> y los comodines; se ignora con permission: false |
ADMIN | sí | /cca give sin --source |
PURCHASE, REWARD, EVENT, ACHIEVEMENT, EXTERNAL | sí | /cca give --source <nombre>, o la API |
| el autor de un cosmético propio | implícito | su fila, permanente |
| un grupo nombrado por un color de rango | implícito | la lista groups de rank-colors.yml |
Una fila de concesión lleva expires_at (0 es permanente) y revoked_at; una fila inactiva simplemente no es una concesión, así que la de un jugador desconectado deja de contar sin que corra nada.
Tablas (H2 por defecto, otras como en Base de datos): chatcosmetics_profiles, chatcosmetics_entitlements, chatcosmetics_custom, chatcosmetics_loadouts, chatcosmetics_tokens. Un perfil se lee una vez al entrar y se mantiene en memoria, así que el chat no añade consultas. Las escrituras se agrupan y se vuelcan cada 5 segundos, al salir y al apagar.
¿Falta algo en esta página? Dínoslo en Discord