Fuentes y decoraciones

Una fuente aquí no es una fuente de Minecraft. Un mensaje de chat no tiene forma de pedirle al cliente otra tipografía, así que una fuente en este plugin es una tabla de puntos de código: cada letra que escribió el jugador se cambia por un glifo que el cliente ya sabe dibujar. Welcome con SMALL CAPS puesto llega al chat como ᴡᴇʟᴄᴏᴍᴇ — caracteres normales, entregados a todo el mundo, sin ningún resource pack de por medio.

Una fuente toca el cuerpo del mensaje y nada más. La etiqueta, el nombre y el rango conservan las letras con las que fueron escritos, porque una línea en la que solo la mitad está en versalitas se lee peor que cualquiera de las dos mitades entera.

Lo que una fuente nunca reescribe

La tabla recorre la línea en crudo antes de que nada la parsee, así que todo lo que es una instrucción y no texto se copia tal cual está escrito.

Un < sin cerrar, una llave sin cerrar o un % suelto son texto, que es también como los lee MiniMessage.

La entrada

fonts:
  small:
    category: classic
    name: '{primary}&lSMALL CAPS'
    alphabet: 'ᴀʙᴄᴅᴇғɢʜɪᴊᴋʟᴍɴᴏᴘǫʀsᴛᴜᴠᴡxʏᴢ'
    safe: true
    icon: PAPER
    description: 'The Exylia look, for your own words.'
    priority: 1
  wide:
    category: classic
    name: '{primary}&lWIDE'
    alphabet: 'ａｂｃｄｅｆｇｈｉｊｋｌｍｎｏｐｑｒｓｔｕｖｗｘｙｚＡＢＣＤＥＦＧＨＩＪＫＬＭＮＯＰＱＲＳＴＵＶＷＸＹＺ'
    digits: '０１２３４５６７８９'
    safe: true
    icon: BOOKSHELF
    description: 'Twice the space between every letter.'
    priority: 5

Todo lo demás que puede declarar una entrada — category, name, icon, description, priority, permission, requirement, hidden, metadata — es igual que en cualquier otro archivo. Ver El catálogo.

La forma de cadena es como se ve un alfabeto copiado; la forma de mapa es para el carácter suelto:

    map:
      '!': '❗'

Un alphabet de cualquier otra longitud se reporta con su ruta y se salta, y lo mismo pasa con unos digits que no son diez y con una entrada de map que no es un carácter por un glifo. Una entrada que se queda sin ningún glifo se descarta con declares no glyphs, so this font changes nothing. El resto del archivo se carga igual.

Qué significa safe

safe: true dice que todos los glifos con los que dibuja la fuente están en el plano básico — la parte de Unicode para la que todos los clientes tienen hoja de caracteres. safe: false dice que al menos uno no lo está: los alfabetos matemáticos de los que salen fraktur, script, monospace y las letras de contorno viven por encima de U+FFFF, y un cliente que no los tiene dibuja un cuadro por cada letra.

Doce de las dieciocho fuentes incluidas son safe: false. En un cliente de Java actual se dibujan desde la fuente de respaldo y se ven bien. Donde se rompen es en Bedrock y en los clientes viejos.

Las dieciocho incluidas

CLASSIC

Seis fuentes cuyos glifos están todos en el plano básico, lo que significa que el cliente las dibuja con sus propias hojas de caracteres, al tamaño del chat normal.

TYPESET

MODERN

SCRIPT

Todas las entradas de TYPESET, MODERN y SCRIPT son safe: false; todas las de CLASSIC son safe: true.

Por qué CLASSIC se lee distinto

Dos cosas deciden cómo se ve de verdad una fuente en el chat, y la pestaña en la que está es la señal honesta de cuál le tocó.

CLASSIC está en el plano básico, y el cliente la dibuja con las mismas hojas que usa el juego para el griego, el cirílico y todos los idiomas con acentos. Nítida, pequeña y dibujada en todos los clientes. Todo lo demás vive en los alfabetos matemáticos, que el cliente saca de su fuente de respaldo: más anchos, más pesados y más altos que la línea que los rodea. Legibles y populares, pero nunca tan limpios como CLASSIC — las letras no encajan con el chat en el que están, porque no son de la misma fuente.

Los alfabetos que se quedaron fuera

Los alfabetos encuadrados — 🄰, 🅰 — no se incluyen. Cada glifo es un marco dibujado alrededor de una letra, y al tamaño del chat una frase entera de esos es un muro de cuadros más que una fuente. Se leen como texto roto, así que no se ofrecen como cosmético. BUBBLE, que encierra en círculos en vez de cuadros, sí se incluye y es una de las seis que están en el plano básico.

Decoraciones

modifiers.yml es el archivo más corto del conjunto: cinco decoraciones en una pestaña, y ninguna cuenta que hacer.

modifiers:
  bold:
    category: style
    name: '{primary}&lBOLD'
    decoration: bold
    icon: IRON_BLOCK
    description: 'Say it louder.'
    priority: 1

decoration es la única clave propia, y por defecto vale el id de la entrada — una entrada que se llama igual que la decoración que aplica no necesita repetirla. Cualquier cosa que no sea uno de esos cinco nombres se reporta y la entrada se salta.

Varias a la vez

Las decoraciones son el único tipo que se lleva como conjunto en vez de en una ranura única. Un jugador puede tener negrita y subrayado puestos a la vez, y hacer clic en una decoración que ya lleva puesta se la quita en vez de reemplazarla. Cualquier otro tipo — una etiqueta, una fuente, un color — guarda una sola cosa, y elegir la segunda reemplaza a la primera.

Cómo se llevan

/cc fonts y /cc modifiers abren los dos navegadores directamente. Los dos están también en el menú de mensaje, donde el clic izquierdo navega y el derecho quita lo que haya puesto de ese tipo.

La propiedad son los cuatro nodos de siempre, con font o modifier como tipo:

Las concesiones funcionan aquí igual que en el resto, caducidad incluida. Ver Concesiones.