Skip to content

README_es.md

Latest commit

 

History

History
281 lines (203 loc) · 16.9 KB

README_es.md

File metadata and controls

281 lines (203 loc) · 16.9 KB
Raw

ShapeBoard

Read this in English.

Scoreboards para zonas de CUALQUIER forma, no solo cajas. Delimita tu excavación, perímetro o zona de construcción con una línea de bloques en el cielo, corre un comando, y ShapeBoard cuenta cada bloque roto y colocado dentro de esa forma exacta. Cuando alguien entra, le aparece un sidebar con el leaderboard solo a él. Cuando sale, desaparece.

100% server-side. Los jugadores no instalan nada.

Demo

Al salir de la zona el sidebar se quita, al volver a entrar vuelve, con los scores en vivo

Video en calidad completa con sonido: shapeboard-demo.mp4

Por qué

Herramientas como buildevents solo soportan cajas rectangulares. Los proyectos reales no son rectángulos: los perímetros tienen esquinas redondeadas, ríos que quieres excluir, bultos raros. Si trackeas una caja alrededor de un perímetro redondo, la gente que pica fuera del proyecto también sube en tu leaderboard. ShapeBoard sigue el contorno exacto que dibujaste, así que el conteo es justo.

El sidebar además es por jugador de verdad. Se manda con paquetes de scoreboard dirigidos, así que solo lo ve la gente que está dentro de la forma. No se tocan teams, no se cambian colores de team, y dos jugadores que compartan color de team no se filtran el board entre sí. Lo que sea que tu server haga con teams y colores queda intacto.

Instalación

  1. Server Fabric con Fabric API, en cualquier Minecraft de 1.21 a 26.2.
  2. Suelta en mods/ el jar de tu versión de Minecraft (la tabla de abajo dice cuál).
  3. Reinicia. Listo: no hay config que editar.

Qué jar

Cada versión tiene su propio jar, compilado contra esa versión. El nombre siempre termina en la versión de Minecraft para la que es.

Minecraft Jar Java
1.21, 1.21.1 shapeboard-x.y.z+1.21.jar 21
1.21.2 shapeboard-x.y.z+1.21.2.jar 21
1.21.3 shapeboard-x.y.z+1.21.3.jar 21
1.21.4 shapeboard-x.y.z+1.21.4.jar 21
1.21.5 shapeboard-x.y.z+1.21.5.jar 21
1.21.6 shapeboard-x.y.z+1.21.6.jar 21
1.21.7 shapeboard-x.y.z+1.21.7.jar 21
1.21.8 shapeboard-x.y.z+1.21.8.jar 21
1.21.9 shapeboard-x.y.z+1.21.9.jar 21
1.21.10 shapeboard-x.y.z+1.21.10.jar 21
1.21.11 shapeboard-x.y.z+1.21.11.jar 21
26.1, 26.1.1, 26.1.2 shapeboard-x.y.z+26.1.2.jar 25
26.2 shapeboard-x.y.z+26.2.jar 25

Minecraft 26.1 en adelante pide Java 25: es requisito del juego, no del mod. El jar de una versión se niega a cargar en otra en vez de funcionar a medias.

Inicio rápido

Digamos que TVTvirus es admin y quiere trackear la excavación del perímetro de su server:

  1. Dibuja el contorno. Vuela a una Y por encima de la obra (por ejemplo y150) y dibuja una línea continua de un bloque marcador (por ejemplo black concrete) siguiendo la forma del proyecto, hasta que cierre sobre sí misma. Vale cualquier forma: círculos, manchas, agujeros de dona, esquinas cortadas. Los huecos de hasta 6 bloques se puentean solos; los más grandes hacen fallar el escaneo y te dice las coordenadas exactas de los extremos abiertos para que vayas a parcharlos.

  2. Crea la shape. Párate a menos de 64 bloques de la línea (o pasa coordenadas explícitas desde la consola) y corre:

    /shapeboard create bigculo minecraft:black_concrete 150

    ShapeBoard camina toda la línea, cierra la forma y reporta el área:

    [ShapeBoard] Shape 'bigculo' created in 45 ms: 797,680 columns inside,
outline of 4,350 blocks. Objectives: bigculo_break / bigculo_place.

    ¿Solo quieres un rectángulo? Sáltate el dibujo por completo: dale dos esquinas opuestas y la Y techo:

    /shapeboard createbox spawnzone 30640 4768 31631 6079 150

  3. Ponle un nombre bonito. Es lo que los jugadores ven en el sidebar:

    /shapeboard rename bigculo Big Culo

  4. Elige por qué ordena la tabla. Este es el paso que se salta todo el mundo: el sidebar ordena por bloques picados salvo que digas otra cosa. Las roturas y las colocaciones siempre se cuentan, pero solo una de las dos manda en la tabla.

    /shapeboard metric bigculo break    # picar (por defecto)
/shapeboard metric bigculo place    # construcción y decoración
/shapeboard metric bigculo both     # la suma

    ¿Estás construyendo en vez de picando? Pon la línea de place o la tabla se va a quedar a cero mientras todos trabajan.

    ¿Un sitio que primero se cava y luego se construye? Deja metric en break durante la fase de picado y pásalo a place el día que empiece la construcción. Los dos contadores han estado corriendo desde el principio, así que no se pierde nada, y cualquiera puede mirar el otro cuando quiera con /shapeboard view (ver Dos tablas, una zona).

  5. Ya está. Desde ese momento, todo lo que se pique o coloque dentro de la forma y por debajo de la línea marcadora cuenta en los objetivos vanilla de scoreboard bigculo_break y bigculo_place. A quien entre le sale:

    [ShapeBoard] You entered Big Culo. Blocks you mine or place here count toward the leaderboard.
[ShapeBoard] Run /shapeboard hide to hide the sidebar, /shapeboard quiet to mute these messages.

    con un sidebar top 15 en vivo. Si no están en el top 15 pero tienen score, su propia línea se muestra en el último hueco para que siempre sepan por dónde van.

    Esas dos líneas salen una vez, no cada vez que cruzas el borde: la misma zona se calla durante 15 minutos después, y /shapeboard quiet las silencia para siempre.

Comandos

Comando Quién Qué hace
/shapeboard create <id> <bloque> <y> [x z] OP Escanea la línea marcadora y crea la shape. x z punto de partida opcional (obligatorio desde consola)
/shapeboard createbox <id> <x1> <z1> <x2> <z2> <y> OP Zona rectangular sin dibujar nada: dos esquinas opuestas + la Y techo (solo cuenta lo de abajo)
/shapeboard rename <id> <nombre...> OP Cambia el nombre que se muestra en el sidebar
/shapeboard metric <id> <break|place|both> OP Por qué rankea el leaderboard: bloques rotos (default), colocados, o la suma. Perfecto para zonas de construcción/decoración
/shapeboard total <id> <on|off> OP Muestra una línea Total arriba del sidebar con el conteo combinado de todos (activada por defecto)
/shapeboard delete <id> OP Borra la shape (los objetivos de scoreboard se conservan)
/shapeboard list todos Lista las shapes con área e info del marcador
/shapeboard info <id> todos Detalles de una shape
/shapeboard top [id] todos Top 10 + totales en el chat
/shapeboard hide / show todos Toggle del sidebar por jugador, se recuerda entre sesiones
/shapeboard view <break|place|both|reset> todos Por qué ordena tu sidebar, sin importar lo que tenga la zona. reset vuelve a seguir a la zona
/shapeboard quiet [on|off] todos Silencia los mensajes de entrada/salida. El sidebar sigue funcionando. Sin argumento hace toggle
/shapeboard suffix <id> <palabra|auto|off> OP Palabra detrás del nombre en el título del sidebar. auto se convierte en Dig / Build / Both según lo que se esté rankeando
/shapeboard prefix <id> <palabra|off> OP Palabra delante del nombre
/shapeboard contains <id> <x> <z> OP Debug: ¿esta columna está dentro de la forma?
/shapeboard scan <id> OP Cuenta los bloques que siguen en pie dentro de la forma (ver Progreso de excavación)
/shapeboard progress [id] todos Barra de progreso y bloques restantes del último escaneo
/shapeboard layer [y] [id] todos Una capa de Y, medida contra lo que esa capa tenía al principio
/shapeboard down <y> [id] todos Todo lo que sigue en pie desde el techo del escaneo hasta esa Y: cuánto falta para dejar la forma limpia hasta y
/shapeboard blocks [id] todos Cada tipo de bloque que sigue en pie, de mayor a menor (lo que vas a tener que sacar)
/shapeboard range <id> <ymin> <ymax> OP Franja de Y que cubre el escaneo (por defecto: del fondo del mundo hasta la Y del contorno)
/shapeboard baseline <id> <bloques>|fromscan OP Cuántos bloques había antes de empezar a picar. fromscan congela el último escaneo, 0 = usar el volumen bruto
/shapeboard untracked <id> <nombre> OP Guarda bajo un nombre falso los picados que no se le acreditaron a nadie (lo picado antes de crear la shape, explosiones, world edits); se resincroniza tras cada escaneo. off lo quita

Dos tablas, una zona

Una zona que primero se excava y luego se construye necesita dos tablas en el mismo sitio. Ya las tiene: las roturas y las colocaciones siempre se cuentan en dos objetivos separados, <id>_break y <id>_place. El metric solo elige cuál enseña el sidebar, así que no hay que duplicar nada ni crear una segunda shape (dos shapes solapadas no funcionarían de todos modos: una columna pertenece a la primera shape que la contiene).

/shapeboard metric virusia break     # fase de picado, todos ven los digs
/shapeboard metric virusia place     # día de construir, un comando, misma zona

/shapeboard view place               # cualquier jugador, cuando quiera, solo para él
/shapeboard view reset               # de vuelta a lo que muestre la zona

view es por jugador y se recuerda entre sesiones, así que quien construye puede mirar las colocaciones mientras los que pican mantienen su tabla. Para que se vea de un vistazo cuál estás mirando, ponle a la shape un sufijo automático:

/shapeboard rename virusia Virusia
/shapeboard suffix virusia auto

El título del sidebar pasa a ser Virusia Dig, Virusia Build o Virusia Both, según lo que esté rankeando quien lo mira. También vale una palabra fija (/shapeboard suffix virusia Build), y /shapeboard prefix pone una delante.

Progreso de excavación

Los contadores de picado responden "quién picó más", pero no "cuánto falta": la TNT y las ediciones de mundo no se le acreditan a nadie. /shapeboard scan responde eso directamente contando los bloques que siguen en pie dentro de la forma.

/shapeboard scan bigculo
/shapeboard progress bigculo

— Big Culo progress —
████████░░░░░░░░░░░░ 41.74%
Progress: 280,374 / 671,744 blocks cleared, 391,370 remaining
Left to dig: deepslate 202,334, stone 115,216, tuff 15,297, diorite 12,677

Un bloque cuenta como "por picar" si es sólido, tiene colisión y se puede romper. Quedan fuera el aire, el agua, la lava, las hojas, la hierba y demás decoración, y la bedrock, así que la barra llega al 100% cuando el agujero está terminado de verdad.

El denominador. Por defecto es el volumen bruto de la franja de Y (columnas x altura). Es exacto y no necesita preparación, pero las cuevas naturales y el aire sobre el terreno cuentan como "ya picado", así que la barra arranca por encima de cero. Para una lectura fiel, medí cuántos bloques había antes de empezar y fijalo:

/shapeboard baseline bigculo 148300000

Ese número sale de escanear la misma zona en una copia del mundo anterior a la excavación, o en un mundo recién generado con la misma seed.

Que el board cuadre. Los contadores por jugador solo ven lo que se le acredita a alguien. Lo picado antes de que existiera la shape, las explosiones y las world edits les son invisibles, asi que el total del leaderboard puede quedarse muy por debajo de lo que midio el escaneo. Apunta un nombre falso a esa diferencia y deja de perderse:

/shapeboard untracked bigculo Untracked

Se recalcula tras cada escaneo, asi que el board siempre suma el agujero real. /shapeboard untracked <id> off lo quita.

Picar hasta una Y objetivo. Capa por capa es /shapeboard layer, y todo lo que hay por encima de una profundidad de golpe es /shapeboard down. Suma cada bloque que sigue en pie desde el techo del escaneo hasta esa Y, que es la pregunta que se hace de verdad ("¿cuánto falta para dejarlo limpio hasta y-20?"):

/shapeboard down -20 bigculo

— Big Culo · down to y-20 —
███████░░░░░░░░░░░░░ 38.60%
Down to y-20: 210,455 / 545,180 blocks cleared, 334,725 remaining
Layers: 43 of 96 cleared from y99 down to y-20, highest one left is y41.

Los dos leen del último escaneo, así que responden al instante y no cuestan nada.

Coste. El escaneo corre en un hilo aparte y lee los chunks directamente del almacenamiento, así que el servidor sigue tickeando. Una zona de 4.096 columnas tarda ~50 ms; un perímetro de 800.000 columnas, unos segundos. Guarda el mundo antes, así que los chunks recién picados siempre entran. Corrélo desde un cron (cada hora o cada día) y /shapeboard progress responde al instante desde el snapshot guardado.

Cómo funciona

  • Escaneo: partiendo de un bloque semilla, ShapeBoard camina la línea conectada de bloques marcadores a esa Y exacta (cargando solo los chunks por los que pasa la línea), puentea huecos de hasta 6 bloques, y corre un flood fill desde afuera. Todo lo que el flood no alcanza está dentro. Una línea diagonal bloquea el fill correctamente, así que los contornos con esquinas a 45 grados van bien.
  • Máscara: el resultado se guarda como intervalos de z por columna de x en world/shapeboard/shapes.json. Un lookup son un par de comparaciones de enteros, así que el tracking no cuesta nada ni con docenas de jugadores picando.
  • Conteo: los bloques rotos se cuentan con el evento de Fabric, los colocados con un mixin chiquito. Solo cuentan las columnas dentro de la forma y por debajo de la Y del marcador. Los scores van a objetivos vanilla de scoreboard, así que todo lo demás de tu server (comandos, datapacks, otros mods) puede leerlos.
  • Sidebar: cada espectador recibe un objetivo falso solo-cliente por paquetes dirigidos (shapeboard_view), refrescado solo cuando los números cambian. Al salir de la zona se elimina y se restaura el objetivo de sidebar que el server tuviera puesto. Los nombres en el board conservan sus colores de team.

Preguntas frecuentes

¿Necesita algo en el cliente? No. Los jugadores vanilla ven todo.

¿Y el TNT? Los bloques rotos por explosiones no se acreditan a nadie (el juego no los atribuye a un jugador). Picar a mano y con herramientas cuenta normal.

¿Cuentan los bots de carpet? Sus breaks y placements cuentan bajo el nombre del propio bot, así que una excavación llena de bots igual muestra quién corrió qué. Los bots nunca reciben sidebars ni mensajes.

¿Varias shapes? Sí, crea las que quieras. Un jugador parado dentro de una ve el board de esa.

¿Y si mi contorno tiene un agujero? El escaneo falla e imprime las coordenadas de los extremos abiertos de la línea. Párchalos (o deja hasta 6 bloques, que se puentean solos) y vuelve a correr create.

¿Puedo trackear una zona de construcción o decoración que no tiene contorno? Sí, de dos maneras. Si con un rectángulo te vale, /shapeboard createbox <id> <x1> <z1> <x2> <z2> <y> no necesita ni un bloque. Para una forma custom, la línea marcadora solo hace falta durante el escaneo: dibuja un contorno temporal con cualquier bloque barato a una Y por encima de la obra, corre create, y borra los bloques; la shape sigue funcionando para siempre (la máscara queda guardada en world/shapeboard/). En ambos casos, pon /shapeboard metric <id> place para que el leaderboard rankee por bloques colocados en vez de picados (o both para la suma).

¿Puedo trackear una zona donde ya se picó antes? Los objetivos arrancan en cero al crear la shape. Si tienes números previos en otro objetivo, cópialos con /scoreboard players operation.

¿El escaneo lagea el server? Solo carga los chunks que toca el contorno, una vez, al crear. Un contorno de 4,000 bloques tarda bastante menos de un segundo en un mundo cargado.

Compilar desde el código

./gradlew build

El jar cae en build/libs/. Java 21+, Gradle descarga todo lo demás. Eso compila para 1.21, que es la versión contra la que está escrito el código.

Para el resto de versiones de Minecraft:

python3 tools/multiversion.py            # todas, a build/multiversion/
python3 tools/multiversion.py 26.2       # solo una
python3 tools/multiversion.py 26.2 --errors   # solo compilar y listar todos los errores

Un solo código, sin una rama por versión: las diferencias entre releases de Minecraft son renombrados, y viven en una tabla de sustituciones al principio de tools/multiversion.py. La serie 26 además necesita otra toolchain, porque Minecraft dejó de publicarse ofuscado en 26.1 y ya no hay mappings que pedir, y ese build script se deriva de este en vez de vivir al lado. Compilar los jars de 26 en local pide un JDK 25 además del 21.

Licencia

MIT