AstraDeploy/docs/USAGE.ru.md

Руководство по использованию AstraDeploy

Мини-гайды по каждому поддерживаемому ядру.

Общие правила

• Для интерактива удобно:

  sudo bash install.sh --easy --core <core>
  

• Для автоматизации/бота обязательно добавляйте:

  --yes --accept-license yes
  

• Для Java-ядер ещё:

  --accept-eula yes
  

• Рекомендуется явно задавать режим сервиса:

  • tmux-systemd (рекомендованный UX)
  • systemd
  • screen
  • none (только подготовка)

Java-ядерные

Paper (--core paper)

• Easy:

  sudo bash install.sh --easy --core paper --service tmux-systemd
  

• Non-interactive:

  sudo bash install.sh \
    --yes \
    --core paper \
    --dir /opt/minecraft/paper \
    --service systemd \
    --ram 4G \
    --port 25565 \
    --accept-eula yes \
    --accept-license yes \
    --firewall yes \
    --locale ru
  

Purpur (--core purpur)

• Easy:

  sudo bash install.sh --easy --core purpur --service tmux-systemd
  

• Non-interactive:

  sudo bash install.sh \
    --yes \
    --core purpur \
    --dir /opt/minecraft/purpur \
    --service tmux-systemd \
    --ram 4G \
    --port 25565 \
    --accept-eula yes \
    --accept-license yes \
    --firewall yes \
    --locale ru
  

Velocity (--core velocity)

• Easy:

  sudo bash install.sh --easy --core velocity --service tmux-systemd
  

• Non-interactive:

  sudo bash install.sh \
    --yes \
    --core velocity \
    --dir /opt/minecraft/velocity \
    --service tmux-systemd \
    --ram 2G \
    --port 25577 \
    --accept-eula yes \
    --accept-license yes \
    --firewall yes \
    --locale ru
  

PowerNukkitX (--core powernukkitx)

• Easy:

  sudo bash install.sh --easy --core powernukkitx --service tmux-systemd
  

• Non-interactive:

  sudo bash install.sh \
    --yes \
    --core powernukkitx \
    --dir /opt/minecraft/powernukkitx \
    --service systemd \
    --ram 2G \
    --port 19132 \
    --accept-eula yes \
    --accept-license yes \
    --firewall yes \
    --locale ru
  

Bedrock PHP-ядра

PMMP (--core pmmp)

• Easy:

  sudo bash install.sh --easy --core pmmp --service tmux-systemd
  

• Non-interactive:

  sudo bash install.sh \
    --yes \
    --core pmmp \
    --dir /opt/minecraft/pmmp \
    --service tmux-systemd \
    --port 19132 \
    --accept-license yes \
    --firewall yes \
    --locale ru
  

NetherGamesMC (--core nethergamesmc)

Доп. опции:

• --build — тег PHP-билда (latest или конкретный).

• --mc-version — версия/тег PocketMine-MCPE (latest или конкретный).

• Easy:

  sudo bash install.sh --easy --core nethergamesmc --service tmux-systemd
  

• Non-interactive:

  sudo bash install.sh \
    --yes \
    --core nethergamesmc \
    --dir /opt/minecraft/nethergamesmc \
    --service screen \
    --build latest \
    --mc-version latest \
    --accept-license yes \
    --firewall yes \
    --locale ru
  

Рекомендуемый порядок статусов для бота

Удобно отправлять пользователю:

1. "preflight"
2. "package install"
3. "core download/build"
4. "service configured"
5. "finished"

Или использовать callback:

• started
• step
• success
• failed

BDS (--core bds)

• Easy:

  sudo bash install.sh --easy --core bds --service tmux-systemd
  

• Non-interactive:

  sudo bash install.sh \
    --yes \
    --core bds \
    --dir /opt/minecraft/bds \
    --service systemd \
    --mc-version latest \
    --accept-license yes \
    --firewall yes \
    --locale ru
  

Комментарии:

• --mc-version для bds — это версия Bedrock сервера (latest или конкретный номер версии, например 1.21.3.01).

Режим обновления

Для обновления уже установленного каталога:

sudo bash install.sh \
  --update \
  --core <core> \
  --dir /opt/minecraft/<core> \
  --yes \
  --accept-license yes

Для Java-ядер добавляйте --accept-eula yes.