- Что такое Spigot и как он связан с CraftBukkit
- BuildTools — ваш лучший друг для сборки Spigot и CraftBukkit
- Java и системные требования
- Как собрать spigot.jar с помощью BuildTools
- Организация файлов сервера
- Настройка запуска сервера на Windows
- Запуск сервера на Linux
- Использование screen для управления сервером на Linux
- Запуск на macOS
- Настройка Multicraft для Spigot
- Что происходит после первого запуска spigot.jar
- Порты и доступность сервера
- Плагины — расширяем возможности сервера
- Частые проблемы с плагинами и их решения
- Как проверить логи и диагностировать ошибки
- Резервное копирование и обновления
- Параметры запуска Java — что означают?
- Пример таблицы рекомендуемой памяти для сервера
- Ошибки на первых шагах и как их избежать
- Итоговая структура папок сервера
- Полезные ссылки
Если вы хотите запустить свой собственный Minecraft сервер на базе Bukkit или Spigot, но не знаете, с чего начать — вы попали по адресу! В этом посте мы разберём, что такое Spigot и CraftBukkit, как правильно собрать серверный jar, настроить скрипты запуска на Windows, Linux и macOS, а также как установить и проверить плагины. Всё просто, понятно и с примерами — даже если вы впервые держите в руках серверный файл.
Что такое Spigot и как он связан с CraftBukkit
Spigot — это форк CraftBukkit, то есть его улучшенная версия с дополнительными оптимизациями и фичами. Представьте CraftBukkit как классический автомобиль, а Spigot — как его спортивный тюнинг с турбонаддувом и крутыми фарами. При этом Spigot полностью совместим с плагинами Bukkit и может заменить jar-файл CraftBukkit без лишних танцев.
Важно: Не скачивайте spigot.jar с непроверенных сайтов! Это как брать ключи от машины у незнакомца — можно получить вирусы или устаревшую версию с уязвимостями. Вместо этого используйте официальный способ — сборку через BuildTools.
BuildTools — ваш лучший друг для сборки Spigot и CraftBukkit
BuildTools — это специальный инструмент, который скачивает исходники и компилирует актуальный spigot.jar или craftbukkit.jar под вашу версию Minecraft. Почему это важно? Потому что Minecraft постоянно обновляется, и старые jar-файлы могут не работать или быть небезопасными.
Как проверить последнюю инструкцию по сборке?
Заходите на официальный BuildTools wiki — там всегда свежие инструкции и требования.
Java и системные требования
Перед сборкой убедитесь, что у вас установлена подходящая версия Java, совместимая с вашей версией Minecraft. Например, для последних версий Minecraft рекомендуется Java 17 или новее. Проверить версию Java можно командой:
java -version
Если версия не подходит, скачайте и установите нужную с официального сайта Oracle или OpenJDK.
Как собрать spigot.jar с помощью BuildTools
- Скачайте BuildTools.jar с официального сайта Spigot.
- Создайте отдельную папку для сборки (например,
buildtools/). - Запустите сборку командой:
java -jar BuildTools.jar --rev 1.20.1
где --rev — версия Minecraft, под которую вы хотите собрать сервер.
- После завершения в той же папке появятся файлы
spigot.jarиcraftbukkit.jar.
Организация файлов сервера
Очень важно не хранить spigot.jar в той же папке, что и BuildTools. Создайте отдельную папку для сервера, например minecraft_server/, и скопируйте туда spigot.jar. Это поможет избежать путаницы и случайного удаления важных файлов.
Настройка запуска сервера на Windows
Создайте в папке с spigot.jar файл start.bat с таким содержимым:
@echo off
java -Xms1024M -Xmx2048M -XX:+UseG1GC -jar spigot.jar nogui
pause
-Xms1024M— минимальный объём памяти (1 ГБ)-Xmx2048M— максимальный объём памяти (2 ГБ)nogui— запуск без графического интерфейса (экономит ресурсы)
Двойной клик по start.bat запустит сервер. Чтобы остановить — введите в консоль stop.
Запуск сервера на Linux
Создайте файл start.sh в папке сервера:
#!/bin/sh
java -Xms1024M -Xmx2048M -XX:+UseG1GC -jar spigot.jar nogui
Сделайте его исполняемым:
chmod +x start.sh
Запускайте сервер командой:
./start.sh
Использование screen для управления сервером на Linux
Чтобы сервер работал в отдельной сессии и поддерживал команду /restart, используйте такой скрипт:
#!/bin/sh
screen -dmS minecraft java -Xms1024M -Xmx2048M -XX:+UseG1GC -jar spigot.jar nogui
screen -dmS minecraft— запускает сервер в фоне с именем сессииminecraft.- Чтобы подключиться к сессии:
screen -r minecraft - Чтобы отсоединиться: нажмите
Ctrl+A, затемD
Запуск на macOS
Создайте файл start.command с содержимым:
#!/bin/sh
cd "$( dirname "$0" )"
java -Xms1024M -Xmx2048M -XX:+UseG1GC -jar spigot.jar nogui
Сделайте его исполняемым:
chmod a+x start.command
Двойной клик по start.command запустит сервер.
Настройка Multicraft для Spigot
Если вы используете Multicraft:
- Если в меню выбора jar есть Spigot — просто выберите и перезапустите сервер.
- Если нет — загрузите свой spigot.jar через FTP, переименуйте (например, в
custom.jar) и укажите имя в панели. - Для серверов с root-доступом положите
spigot.jar.confв папку демона и обновите jar через админку.
Что происходит после первого запуска spigot.jar
При первом запуске создаются папки world, plugins, а также конфигурационные файлы server.properties, spigot.yml и другие. Обязательно проверьте и настройте:
server-ipвserver.properties— если у вас не многосетевая машина, оставьте пустым.- Порты — по умолчанию 25565, убедитесь, что они открыты и проброшены на роутере.
- Параметры памяти и JVM.
Порты и доступность сервера
Для работы сервера нужно настроить проброс портов (port forwarding) на вашем роутере. Проверьте доступность сервера снаружи с помощью сайтов типа canyouseeme.org.
Плагины — расширяем возможности сервера
Плагины — это как специи в вашем супе: делают сервер вкуснее и интереснее. Для Spigot подходят почти все Bukkit-плагины, если они не используют внутренние нестабильные API.
Как установить плагин
- Найдите плагин на SpigotMC, BukkitDev, PaperMC или GitHub.
- Скачайте файл с расширением
.jar. Если это.zip, распакуйте и найдите.jar. - Поместите
.jarв папкуpluginsвашего сервера. - Перезапустите сервер.
- Проверьте список плагинов командой
/plugins— плагин должен быть зелёным.
Частые проблемы с плагинами и их решения
| Симптом | Причина | Решение |
|---|---|---|
Плагин красный в /plugins |
Плагин не загрузился | Проверьте логи logs/latest.log на ошибки |
Ошибка Missing dependency |
Отсутствует зависимый плагин | Установите указанный плагин-зависимость |
Invalid plugin.yml |
Плагин не настоящий или повреждён | Скачайте плагин с официального источника |
| Два плагина с одинаковым именем | Конфликт версий | Удалите дубликаты, оставьте одну версию |
| Плагин не загружается и нет логов | Плагин не в корне папки plugins или не .jar |
Поместите .jar в корень папки plugins |
Как проверить логи и диагностировать ошибки
Откройте файл logs/latest.log и найдите строки, связанные с загрузкой плагинов. Ошибки и предупреждения помогут понять, что не так.
Резервное копирование и обновления
- Регулярно делайте бэкапы папки
worldи конфигураций. - Обновляйте сервер и плагины хотя бы раз в неделю.
- Перед обновлением плагинов удаляйте старые версии, чтобы избежать конфликтов.
Параметры запуска Java — что означают?
| Параметр | Значение и назначение |
|---|---|
-Xms |
Минимальный объём памяти, выделяемый JVM (например, 1024M = 1 ГБ) |
-Xmx |
Максимальный объём памяти JVM |
-jar |
Запуск jar-файла |
-o true |
Опция CraftBukkit для оптимизации работы сервера |
nogui |
Запуск без графического интерфейса |
Пример таблицы рекомендуемой памяти для сервера
| Количество игроков | Рекомендуемая память (МБ) | Пример параметров запуска |
|---|---|---|
| 1-5 | 512-1024 | -Xms512M -Xmx1024M |
| 5-20 | 1536-2560 | -Xms1536M -Xmx2560M |
| 20-50 | 3072-5120 | -Xms3072M -Xmx5120M |
Ошибки на первых шагах и как их избежать
- Ошибка: "java не является внутренней или внешней командой" — значит Java не добавлена в PATH. Добавьте путь к java.exe в системные переменные.
- Ошибка при запуске jar — проверьте, что файл называется именно
spigot.jarилиcraftbukkit.jar, и что вы запускаете из правильной папки. - Плагин не загружается — убедитесь, что плагин
.jarлежит в папкеplugins, а не в подпапках.
Итоговая структура папок сервера
minecraft_server/
├── spigot.jar
├── start.bat (Windows) / start.sh (Linux) / start.command (macOS)
├── plugins/
│ ├── plugin1.jar
│ └── plugin2.jar
├── world/
├── server.properties
└── logs/
Полезные ссылки
- Официальный гайд Spigot Installation
- BuildTools wiki
- Bukkit Server Setup (русский)
- PaperMC Plugins Guide
Теперь вы вооружены знаниями, чтобы собрать, запустить и настроить свой Minecraft сервер на базе Bukkit/Spigot! Не бойтесь экспериментировать, а если что-то пойдёт не так — логи и форумы всегда помогут. Вперёд, создавайте свой уникальный мир и управляйте им с удовольствием!