Посібник
Як створити плагін табло для Minecraft
Оновлено 18 жовтня 2026 р.
Бічна панель праворуч на екрані - найпомітніша частина багатьох серверів: назва сервера, ранг гравця, гроші, вбивства, гравці онлайн. Плагін малює її через Scoreboard API з Bukkit. Найскладніше - дати кожному гравцеві власні рядки й плавно їх оновлювати.
Змініть рядки під свій сервер.
Згенерувати це в CodexeКрок за кроком
1.Запишіть рядки
Заголовок і кожен рядок згори донизу зі значеннями, які вони показують: «Ранг: Admin», «Монети: 1,250», «Онлайн: 34». Бічна панель показує щонайбільше 15 рядків.
2.Дайте кожному гравцеві табло
Для рядків, що відрізняються в кожного гравця, потрібне окреме табло для кожного з
Bukkit.getScoreboardManager().getNewScoreboard(), яке встановлюється черезplayer.setScoreboard(...)під час входу.3.Створіть ціль для бічної панелі
Зареєструйте ціль dummy і встановіть їй слот відображення
DisplaySlot.SIDEBAR. Кожен рядок - це запис із рахунком, який задає його позицію.4.Оновлюйте значення
Повторюване завдання, наприклад щосекунди, оновлює лише рядки, що змінилися. Використовуйте префікси й суфікси команд для тексту, щоб рядки не мерехтіли.
5.Додайте плейсхолдери
З PlaceholderAPI рядки на кшталт
%vault_eco_balance%показують значення з інших плагінів без додаткового коду.6.Зберіть плагін і подивіться на нього в грі
Дайте Codexe скомпілювати плагін, зайдіть на тестовий сервер і перевірте кожен рядок, потім змініть значення й подивіться, як воно оновлюється.
Як працює бічна панель
- На кожному табло в бічній панелі одночасно показується одна ціль. Її відображувана назва - це заголовок.
- Рядки сортуються за рахунком, від найбільшого, тож рахунок - це просто номер рядка у зворотному порядку.
- Кожен рядок має бути окремим записом: двом однаковим рядкам потрібна невидима відмінність, наприклад різні коди кольорів.
- Червоні числа праворуч можна приховати починаючи з Minecraft 1.20.3, де з'явилися формати чисел для рахунків. У старіших версіях вони показуються завжди.
- Гравець бачить одне табло: якщо інший плагін встановлює власне, перемагає останнє. Використовуйте один плагін для бічної панелі або вкажіть, які інші плагіни ділять табло.
Оновлення без мерехтіння
Якщо видалити рядок і додати новий, він блимає. Звичайне рішення - дати кожному рядку фіксований невидимий запис, а видимий текст помістити в префікс і суфікс команди, що містить цей запис; оновлення команди змінює текст на місці. Попросіть у запиті «без мерехтіння», і плагін буде написано саме так.
Плагін, Skript чи датапак?
| Варіант | Що вміє | Обмеження |
|---|---|---|
| Плагін | Рядки для кожного гравця, будь-які значення, анімації, плейсхолдери | Потрібен Spigot, Paper або форк |
| Skript із SkBee | Бічні панелі для кожного гравця зі скрипта | Потрібні Skript і доповнення |
| Датапак | Показ однієї цілі, як-от смерті чи вбивства, у бічній панелі | Однакові числа для всіх, без довільного тексту для кожного гравця |
Приклад опису
«Плагін для Paper 1.21.4 під назвою Board. Бічна панель для кожного гравця із заголовком золотого кольору, далі ранг (з LuckPerms), монети (з Vault), вбивства, смерті, гравці онлайн і адреса сервера. Оновлюється щосекунди без мерехтіння, червоні числа приховано. Рядки, заголовок та інтервал оновлення в config.yml, у будь-якому рядку дозволено плейсхолдери PlaceholderAPI. /board toggle приховує її для окремого гравця, і вибір зберігається.»
Запитання
Скільки рядків може мати бічна панель?
Показується 15 рядків. Для довшого вмісту потрібне інше місце, наприклад список гравців, панель дій або панель боса.
Чи працює це на 1.8?
Так, Scoreboard API є в 1.8, але довжина тексту в рядку там обмеженіша. Вкажіть версію, щоб плагін написали під неї.
Чому моє табло зникає?
Зазвичай інший плагін встановлює гравцеві власне табло після вашого. Приберіть іншу бічну панель або зробіть так, щоб усе показував один плагін.
Створіть свою бічну панель
Цей запит відкривається готовим до надсилання:
“Плагін бічного табло для Paper 1.21.4 під назвою Board: бічна панель для кожного гравця із золотим заголовком, ранг з LuckPerms, монети з Vault, вбивства, смерті, гравці онлайн і адреса сервера, оновлення щосекунди без мерехтіння, червоні числа приховано, рядки й інтервал у config.yml з підтримкою PlaceholderAPI, /board toggle зберігається для кожного гравця.”
Згенерувати це в Codexe