Руководство

Как сделать плагин скорборда для Minecraft

Обновлено: 18 октября 2026 г.

Боковая панель справа на экране это самая заметная часть многих серверов: название сервера, ранг игрока, деньги, убийства, игроки онлайн. Плагин рисует её через Scoreboard API Bukkit. Самое сложное здесь дать каждому игроку свои строки и плавно их обновлять.

Подстройте строки под свой сервер.

Сгенерировать это в Codexe

Шаг за шагом

  1. 1.Напишите строки

    Заголовок и каждую строку сверху вниз с показываемыми значениями: «Ранг: Admin», «Монеты: 1 250», «Онлайн: 34». Боковая панель показывает не больше 15 строк.

  2. 2.Дайте каждому игроку свой скорборд

    Для строк, которые отличаются у разных игроков, нужен скорборд на каждого игрока из Bukkit.getScoreboardManager().getNewScoreboard(), который назначается через player.setScoreboard(...) при входе.

  3. 3.Создайте objective для боковой панели

    Зарегистрируйте objective типа dummy и задайте ему слот отображения DisplaySlot.SIDEBAR. Каждая строка это запись со счётом, который определяет её позицию.

  4. 4.Обновляйте значения

    Повторяющаяся задача, например раз в секунду, обновляет только изменившиеся строки. Для текста используйте префиксы и суффиксы команд (teams), чтобы строки не мерцали.

  5. 5.Добавьте плейсхолдеры

    С PlaceholderAPI строки вроде %vault_eco_balance% показывают значения из других плагинов без лишнего кода.

  6. 6.Соберите плагин и посмотрите на панель в игре

    Дождитесь, пока Codexe скомпилирует плагин, зайдите на тестовый сервер и проверьте каждую строку, затем измените значение и посмотрите, как оно обновится.

Как работает боковая панель

  • В боковой панели одновременно показывается один objective на скорборд. Его отображаемое имя служит заголовком.
  • Строки сортируются по счёту, от большего к меньшему, так что счёт это просто номер строки в обратном порядке.
  • Каждая строка должна быть отдельной записью: двум одинаковым строкам нужно невидимое различие, например разные цветовые коды.
  • Красные числа справа можно скрыть начиная с Minecraft 1.20.3, где появились форматы чисел для счёта. В старых версиях они видны всегда.
  • Игрок видит один скорборд: если другой плагин назначает свой, побеждает последний. Используйте один плагин для боковой панели или укажите, какие ещё плагины используют скорборд.

Обновление без мерцания

Если удалить строку и добавить новую, она мигнёт. Обычное решение: дать каждой строке постоянную невидимую запись, а видимый текст поместить в префикс и суффикс команды (team), в которой состоит эта запись; при обновлении команды текст меняется на месте. Попросите в запросе «без мерцания», и плагин будет написан именно так.

Плагин, Skript или датапак?

ВариантЧто умеетОграничение
ПлагинСтроки для каждого игрока, любые значения, анимации, плейсхолдерыНужен Spigot, Paper или форк
Skript с SkBeeБоковые панели для каждого игрока из скриптаНужны Skript и дополнение
ДатапакПоказывать в боковой панели один objective, например смерти или убийстваОдинаковые числа для всех, нет произвольного текста для каждого игрока

Пример описания

«Плагин для 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
Как сделать плагин скорборда для Minecraft (боковая панель) | Codexe