Guía
Cómo crear un plugin de marcador para Minecraft
Actualizado el 18 de octubre de 2026
La barra lateral a la derecha de la pantalla es la parte más visible de muchos servidores: el nombre del servidor, el rango del jugador, el dinero, las muertes, los jugadores conectados. Un plugin la dibuja con la Scoreboard API de Bukkit. Lo difícil es dar a cada jugador sus propias líneas y actualizarlas con fluidez.
Adapta las líneas a tu servidor.
Genera esto con CodexePaso a paso
1.Escribe las líneas
El título y cada línea de arriba abajo, con los valores que muestran: «Rango: Admin», «Monedas: 1.250», «Conectados: 34». La barra lateral muestra como máximo 15 líneas.
2.Da a cada jugador un marcador
Las líneas que cambian según el jugador necesitan un marcador por jugador, creado con
Bukkit.getScoreboardManager().getNewScoreboard()y asignado conplayer.setScoreboard(...)al entrar.3.Crea el objetivo de la barra lateral
Registra un objetivo dummy y pon su posición de visualización en
DisplaySlot.SIDEBAR. Cada línea es una entrada con una puntuación que fija su posición.4.Actualiza los valores
Una tarea repetida, por ejemplo cada segundo, actualiza solo las líneas que cambiaron. Usa prefijos y sufijos de equipo para el texto, así las líneas no parpadean.
5.Añade placeholders
Con PlaceholderAPI, líneas como
%vault_eco_balance%muestran valores de otros plugins sin código extra.6.Compílalo y míralo en el juego
Deja que Codexe lo compile, entra al servidor de prueba y revisa cada línea; luego cambia un valor y mira cómo se actualiza.
Cómo funciona la barra lateral
- Cada marcador muestra un solo objetivo a la vez en la barra lateral. Su nombre visible es el título.
- Las líneas se ordenan por su puntuación, de mayor a menor, así que la puntuación es simplemente el número de línea al revés.
- Cada línea debe ser una entrada distinta: dos líneas idénticas necesitan una diferencia invisible, como códigos de color distintos.
- Los números rojos de la derecha se pueden ocultar desde Minecraft 1.20.3, que añadió formatos numéricos para las puntuaciones. Las versiones anteriores siempre los muestran.
- Un jugador ve un solo marcador: si otro plugin pone el suyo, gana el último. Usa un solo plugin para la barra lateral o indica qué otros plugins comparten el marcador.
Actualizar sin parpadeo
Quitar una línea y añadir una nueva la hace parpadear. La solución habitual es dar a cada línea una entrada fija e invisible y poner el texto visible en el prefijo y el sufijo de un equipo que contiene esa entrada; al actualizar el equipo, el texto cambia en su sitio. Pide «sin parpadeo» en la petición y el plugin se escribe así.
¿Plugin, Skript o datapack?
| Opción | Qué puede hacer | Límite |
|---|---|---|
| Plugin | Líneas por jugador, cualquier valor, animaciones, placeholders | Necesita Spigot, Paper o un fork |
| Skript con SkBee | Barras laterales por jugador desde un script | Necesita Skript y el complemento |
| Datapack | Mostrar un objetivo, como muertes o bajas, en la barra lateral | Los mismos números para todos, sin texto libre por jugador |
Descripción de ejemplo
«Un plugin para Paper 1.21.4 llamado Board. Una barra lateral para cada jugador con el título en dorado y, debajo, el rango (de LuckPerms), las monedas (de Vault), las bajas, las muertes, los jugadores conectados y la dirección del servidor. Actualizada cada segundo sin parpadeo, con los números rojos ocultos. Líneas, título e intervalo de actualización en config.yml, con placeholders de PlaceholderAPI permitidos en cualquier línea. /board toggle la oculta para cada jugador y la elección se guarda.»
Preguntas
¿Cuántas líneas puede tener una barra lateral?
Se muestran 15 líneas. Si hay más contenido, necesita otro sitio, como la lista de tabulación, la barra de acción o una barra de jefe.
¿Funciona en la 1.8?
Sí, la Scoreboard API existe en la 1.8, pero allí la longitud del texto de cada línea está más limitada. Indica la versión para que el plugin se escriba para ella.
¿Por qué desaparece mi marcador?
Normalmente otro plugin pone su propio marcador al jugador después del tuyo. Quita la otra barra lateral o haz que un solo plugin lo muestre todo.
Crea tu barra lateral
Este prompt se abre listo para enviar:
“Un plugin de marcador lateral para Paper 1.21.4 llamado Board: barra lateral por jugador con título dorado, rango de LuckPerms, monedas de Vault, bajas, muertes, jugadores conectados y la dirección del servidor, actualizada cada segundo sin parpadeo, números rojos ocultos, líneas e intervalo en config.yml con soporte para PlaceholderAPI, /board toggle guardado por jugador.”
Genera esto con Codexe