Загрузка данных


                     ____  _          ____            _           _
                    / ___|| | ___   _|  _ \ _ __ ___ (_) ___  ___| |_
                    \___ \| |/ / | | | |_) | '__/ _ \| |/ _ \/ __| __|
                     ___) |   <| |_| |  __/| | | (_) | |  __/ (__| |_
                    |____/|_|\_\\__, |_|   |_|  \___// |\___|\___|\__|
                                |___/              |__/

                 -------------------------------------------------------
                         FAQ И ИНСТРУКЦИЯ ПО СБОРКЕ
                 -------------------------------------------------------

Версия Minecraft: Paper 1.21.11
Версия Java: 21
Название сборки: SkyProject


==========================================================================
                              УСТАНОВКА
==========================================================================

ПАНЕЛЬНЫЙ ХОСТИНГ

1. Полностью остановите сервер через панель.
2. Сделайте резервную копию текущего сервера.
3. Установите в панели Paper 1.21.11 и выберите Java 21.
4. Распакуйте купленный архив на свой компьютер.
5. Подключитесь к файловому менеджеру панели либо к SFTP через FileZilla/WinSCP.
6. Перенесите папку plugins из архива в КОРЕНЬ сервера с объединением папок.
7. Папку spawn также перенесите в корень сервера, рядом с plugins.
8. Не создавайте путь plugins/plugins — это неправильная установка.
9. Запустите сервер и дождитесь сообщения Done в консоли.
10. Зайдите на сервер и проверьте /menu, /shop, /help, /ticket и /pvp.

Данные SFTP обычно находятся в панели хостинга. Общий принцип работы с FileZilla:
слева расположены файлы вашего компьютера, справа — файлы сервера.


VDS ИЛИ ДОМАШНИЙ ПК НА WINDOWS

1. Установите 64-битную Java 21.
2. Создайте отдельную папку сервера и поместите туда Paper 1.21.11.
3. Один раз запустите ядро, затем укажите eula=true в eula.txt.
4. Остановите сервер и перенесите plugins и spawn из архива в корень сервера.
5. Пример содержимого start.bat:

   @echo off
   java -Xms2G -Xmx4G -jar paper-1.21.11.jar nogui
   pause

6. Если имя JAR отличается, замените paper-1.21.11.jar на настоящее имя файла.
7. Если команда java не найдена, установите Java 21 или укажите полный путь к java.exe.


VDS НА LINUX / UBUNTU

1. Установите Java 21 и подключитесь к серверу через SSH/SFTP.
2. Подготовьте отдельный каталог Minecraft-сервера.
3. Загрузите Paper 1.21.11, примите EULA и перенесите папки plugins и spawn.
4. Пример запуска:

   java -Xms2G -Xmx4G -jar paper-1.21.11.jar nogui

5. Wine не требуется: Paper является Java-приложением.
6. Для постоянной работы используйте screen, tmux либо службу systemd.


==========================================================================
                       ПЕРВАЯ НАСТРОЙКА СЕРВЕРА
==========================================================================

1. На первом запуске плагины создадут новые пустые базы и служебные файлы.
   Это нормально: данные прежних игроков из продаваемой сборки удалены.

2. Создайте или загрузите основной мир выживания. По умолчанию используется world.
   Связанные измерения называются world_nether и world_the_end.

3. Выдайте себе права только через консоль хостинга:

   op ВАШ_НИК
   lp user ВАШ_НИК parent set operator

   Группа operator уже существует в LuckPerms. Не выдавайте OP незнакомым людям.

4. Замените ссылки и данные проекта на свои. В первую очередь проверьте:

   plugins/TAB/config.yml
   plugins/DeluxeMenus/gui_menus/
   plugins/MOTD/
   конфиги голограмм и социальных сетей


5. После изменений перезапустите сервер. Встроенную Bukkit-команду /reload использовать не стоит.


==========================================================================
                    САМОПИСНЫЕ ПЛАГИНЫ СЕРИИ sr (Sky/Redline)
==========================================================================

В комплект входят четыре собственных плагина:

• srAFK — продвинутая система автоматического AFK.
• srHandleMine — восстанавливаемая автошахта с зарплатой.
• srPVP — персональное включение и отключение PvP.
• srTicket — обращения игроков и GUI для администрации.

Все сообщения и основные параметры редактируются в config.yml соответствующего
плагина. Перед редактированием остановите сервер или используйте предусмотренную
команду перезагрузки после сохранения файла.


--------------------------------------------------------------------------
srAFK — АВТОМАТИЧЕСКИЙ AFK
--------------------------------------------------------------------------

Путь к настройкам: plugins/srAFK/config.yml

Как работает:

• После периода бездействия игрок автоматически получает статус AFK.
• По умолчанию таймер равен 360 секундам, то есть 6 минутам.
• Всем игрокам отправляется сообщение о переходе в AFK и возвращении.
• AFK-игрок видит постоянный title и action bar.
• Мобы перестают выбирать его целью, прямой урон мобов отменяется.
• AFK-игроки не учитываются при расчёте игроков для пропуска ночи.
• Любая настоящая активность снимает AFK автоматически.

Команды:

/srafk                  — показать свой статус.
/srafk status           — показать свой статус.
/srafk status <ник>     — посмотреть статус другого игрока с правом администратора.
/srafk toggle           — вручную включить или отключить AFK.
/srafk reload           — перезагрузить конфигурацию.
/afkstatus              — псевдоним команды /srafk.

Права:

srafk.use               — просмотр собственного статуса.
srafk.toggle            — ручное переключение AFK.
srafk.admin             — чужой статус и перезагрузка конфигурации.
srafk.bypass            — игрок никогда не переводится в AFK автоматически.

В текущей версии эти права по умолчанию выданы OP, кроме обычного автоматического
определения AFK. Если игрокам нужна команда /srafk, выдайте нужные права через LuckPerms.

PlaceholderAPI:

%srafk_afk%             — yes или no.
%srafk_status%          — AFK либо пустая строка.
%srafk_duration%        — продолжительность текущего AFK.

TAB уже использует %srafk_afk% и заменяет yes на красивую синюю отметку AFK.

Основные настройки:

afk.timeout-seconds                     — таймер бездействия.
sleep.ignore-afk-players                 — исключать AFK из сна.
protection.cancel-mob-targeting          — отменять выбор цели мобом.
protection.cancel-mob-damage             — отменять урон мобов.
protection.cancel-player-damage          — отменять урон других игроков.
protection.cancel-other-damage           — отменять огонь, падение и другой урон.
broadcast.enabled                        — сообщения для всего сервера.


--------------------------------------------------------------------------
srHandleMine — АВТОШАХТА
--------------------------------------------------------------------------

Путь к настройкам: plugins/srHandleMine/config.yml
Путь к накопленным зарплатам: plugins/srHandleMine/data.yml
Зависимости: Vault, WorldGuard и любой работающий провайдер экономики Vault.

Как работает:

• Плагин работает только внутри заданного региона WorldGuard.
• После добычи руда временно превращается в булыжник.
• Через указанное время исходная руда восстанавливается.
• Деньги сначала копятся во внутренней зарплате игрока.
• После достижения лимита игрок должен забрать зарплату.
• При ошибке экономики зарплата не теряется и остаётся в data.yml.

Подготовка новой шахты:

1. Выделите территорию инструментом WorldEdit //wand.
2. Создайте регион WorldGuard:

   /rg define mine

3. Находясь в нужном мире, выполните:

   /pmine setmine mine

4. Проверьте настройку:

   /pmine info

В готовой конфигурации используется регион mine_test в мире world. Сам служебный
регион сохранён. При переносе шахты в другое место задайте новый регион командой выше.

Команды:

/pminesalary            — получить накопленную зарплату.
/minesalary             — псевдоним /pminesalary.
/pmine info             — информация о шахте и накоплениях.
/pmine setmine <регион> — привязать шахту к региону WorldGuard.
/pmine reload           — перезагрузить конфигурацию.

Права:

pmine.salary            — получение зарплаты; доступно игрокам по умолчанию.
pmine.admin             — настройка шахты, информация и перезагрузка; только OP.

Настройка руд находится в разделе ores:

reward                   — сумма за один добытый блок.
restore-seconds          — время восстановления руды в секундах.
replacement-block        — временный блок, по умолчанию COBBLESTONE.
max-blocks-before-claim  — лимит блоков до обязательного получения зарплаты.

Если руда не восстанавливается, проверьте точное имя мира, существование региона,
границы региона и наличие материала в разделе ores.


--------------------------------------------------------------------------
srPVP — ПЕРСОНАЛЬНОЕ ОТКЛЮЧЕНИЕ PvP
--------------------------------------------------------------------------

Путь к настройкам: plugins/srPVP/config.yml
Путь к состояниям игроков: plugins/srPVP/data.yml

Как работает:

• Игрок вводит /pvp и переключает свой режим.
• При отключённом PvP он не может ударить другого игрока.
• Другие игроки также не могут нанести ему PvP-урон.
• Между успешными переключениями действует задержка 300 секунд.
• Состояние сохраняется после перезапуска.

Команды:

/pvp             — включить или отключить PvP.
/pvp status      — показать текущее состояние.
/pvp reload      — перезагрузить конфигурацию.

Права:

srpvp.use                 — использование /pvp; доступно всем по умолчанию.
srpvp.admin               — перезагрузка конфигурации; только OP.
srpvp.cooldown.bypass     — переключение без задержки.

Задержка меняется параметром settings.cooldown-seconds.


--------------------------------------------------------------------------
srTicket — ТИКЕТЫ И ОБРАЩЕНИЯ
--------------------------------------------------------------------------

Путь к настройкам: plugins/srTicket/config.yml
Путь к обращениям: plugins/srTicket/tickets.yml

Для игрока:

/ticket <сообщение>       — отправить обращение администрации.

Пример:

/ticket Не могу открыть меню магазина

Для администрации:

/tickets                  — открыть GUI со списком тикетов.
/tickets <страница>       — открыть конкретную страницу.
/tickets reload           — перезагрузить конфигурацию.

Управление GUI:

ЛКМ по тикету             — прочитать обращение и перейти к ответу.
После ЛКМ                 — написать ответ обычным сообщением в чат.
Сообщение «отмена»        — отменить подготовку ответа.
Shift + ПКМ               — закрыть тикет без ответа.

Права:

srticket.use              — создание тикетов; доступно всем по умолчанию.
srticket.staff            — просмотр GUI, ответы и закрытие тикетов.
srticket.admin            — перезагрузка плагина; включает srticket.staff.

Настройки по умолчанию:

• Не более 3 открытых тикетов на одного игрока.
• Задержка создания — 30 секунд.
• Максимальная длина обращения — 300 символов.
• Максимальная длина ответа — 500 символов.
• Срок хранения обработанных обращений — 30 дней.

Чтобы сотрудник без OP видел тикеты, выдайте ему право:

lp user НИК permission set srticket.staff true


==========================================================================
                    РЕШЕНИЕ ЧАСТЫХ ПРОБЛЕМ
==========================================================================

РТП НА СПАВНЕ РАБОТАЕТ МЕДЛЕННО ИЛИ ПОДВИСАЕТ

Предварительно сгенерируйте основной мир через Chunky. Для мира world:

/chunky world world
/chunky radius 10000
/chunky start

Радиус Chunky желательно делать не меньше MaxRadius из BetterRTP. В текущем
plugins/BetterRTP/config.yml максимальный радиус равен 10000 блоков.
Прогресс отображается в консоли и через команды Chunky.


МИР НЕ ЗАГРУЖАЕТСЯ ПОСЛЕ ПЕРЕЗАПУСКА

Включите автоматическую загрузку через MultiWorld:

/mw flag world LOAD_AUTO true

Вместо world укажите настоящее имя нужного мира. Мир spawn уже настроен на автозагрузку.


НЕ МОГУ ЗАЙТИ НА ЛОКАЛЬНЫЙ СЕРВЕР

Используйте адрес localhost:25565. Если порт изменён в server.properties,
укажите его после двоеточия. Убедитесь, что в консоли появилось сообщение Done.


НЕ МОГУ УДАЛИТЬ МИР

1. Телепортируйте игроков в другой мир.
2. Выгрузите мир командой MultiWorld либо полностью остановите сервер.
3. Сделайте резервную копию.
4. Удалите папку мира.
5. При необходимости удалите запись мира из plugins/MultiWorld/world.json.

Никогда не удаляйте активный мир во время работы сервера.


ПЛЕЙСХОЛДЕРЫ ПОКАЗЫВАЮТСЯ КАК %vault_...% ИЛИ %statistic_...%

Убедитесь, что PlaceholderAPI загружен. Установите нужные расширения:

/papi ecloud download Player
/papi ecloud download Vault
/papi ecloud download Statistic
/papi ecloud download Server
/papi reload

Затем выполните /tab reload либо перезапустите сервер. Плейсхолдеры srAFK
регистрируются самим плагином и не требуют загрузки через eCloud.


МЕНЮ НЕ ОТКРЫВАЕТСЯ ИЛИ ИЗМЕНЕНИЯ НЕ ПОЯВИЛИСЬ

1. Проверьте отступы YAML: используйте пробелы, не таб.
2. Проверьте, зарегистрирован ли файл в plugins/DeluxeMenus/config.yml.
3. Выполните /dm reload.
4. Посмотрите консоль на сообщения DeluxeMenus с именем проблемного файла.


ВМЕСТО ЦВЕТА ВИДЕН ТЕКСТ <gradient> ИЛИ &#0e6dff

Не все плагины используют одинаковый формат:

• MiniMessage: <#0e6dff>Текст</#0e6dff> и <gradient:#00baff:#1643ff>Текст</gradient>
• Legacy/HEX: &#0e6dffТекст и стандартные коды &f, &7, &l.

Используйте тот формат, который уже применяется в конкретном конфиге.


ПЛАГИН НЕ СОЗДАЁТ БАЗУ ИЛИ НЕ СОХРАНЯЕТ ДАННЫЕ

1. Проверьте права на запись в папку сервера.
2. Убедитесь, что сервер был корректно остановлен, а не аварийно завершён.
3. Проверьте latest.log на ошибки SQLite/H2 и сообщения конкретного плагина.
4. Не создавайте пустой файл .db вручную — удалите сломанный файл только после бекапа
   и позвольте плагину создать базу самостоятельно.


ВОЗНИКЛА ОШИБКА ПОСЛЕ ОБНОВЛЕНИЯ ПЛАГИНА

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


НЕ ПОЛУЧАЕТСЯ ПЕРЕНЕСТИ ФАЙЛЫ НА ХОСТИНГ

Полностью распакуйте архив на компьютер перед загрузкой. Проверьте свободное место,
ограничение размера файлов и данные SFTP. Загружайте папки в корень сервера,
сохраняя исходную структуру каталогов.


ВООБЩЕ НИЧЕГО НЕ ЗАГРУЖАЕТСЯ

1. Проверьте Java: требуется версия 21.
2. Проверьте ядро: требуется Paper 1.21.11.
3. Убедитесь, что JAR-файлы находятся непосредственно в plugins, а не plugins/plugins.
4. Откройте папку logs и найдите latest.log.
5. Найдите первое сообщение ERROR или Caused by — последующие ошибки могут быть следствием.
6. Если решить проблему не удалось, отправьте мне latest.log и подробно напишите:
   какую команду использовали, что ожидали и что произошло на самом деле.



Если ответа на вопрос нет в этом файле, приложите latest.log и обратитесь
к продавцу в чате FunPay. Чем точнее описана проблема, тем быстрее её можно решить.