Files
EpicNext-Cms/update-Nitrov3.sh
T
openhands cf89681576
CI / check (push) Successful in 29s
CI / release (push) Skipped
CI / deploy (push) Successful in 1m0s
fix: root-safe www-data chown after builds and config sync
2026-08-03 19:12:22 +02:00

2240 lines
101 KiB
Bash
Executable File

#!/bin/bash
set -Eeo pipefail
# ╔══════════════════════════════════════════════════════════════════════════════╗
# ║ SMaRT — Emulator / Nitro-V3 / Nitro-V3-Render ║
# ║ Updater & Manager by Remco ║
# ╚══════════════════════════════════════════════════════════════════════════════╝
# =============================================================================
# CONSTANTS
# =============================================================================
readonly SCRIPT_VERSION="8.0.2"
readonly SCRIPT_BUILD="20260803"
readonly SCRIPT_NAME="$(basename "$0")"
readonly SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
readonly START_TIME=$(date +%s)
readonly LOCK_FILE="/tmp/${SCRIPT_NAME%.sh}.lock"
# =============================================================================
# COLORS
# =============================================================================
if [ -t 1 ] && command -v tput &>/dev/null && [ "$(tput colors 2>/dev/null || echo 0)" -ge 8 ]; then
C_RESET="\033[0m" C_BOLD="\033[1m" C_DIM="\033[2m"
C_RED="\033[1;31m" C_GREEN="\033[1;32m" C_YELLOW="\033[1;33m"
C_BLUE="\033[1;34m" C_MAGENTA="\033[1;35m" C_CYAN="\033[1;36m"
C_WHITE="\033[1;37m" C_GOLD="\033[38;5;220m"
C_BG_RED="\033[41m" C_BG_GREEN="\033[42m"
C_BG_BLUE="\033[44m" C_BG_MAGENTA="\033[45m" C_BG_CYAN="\033[46m"
else
C_RESET="" C_BOLD="" C_DIM=""
C_RED="" C_GREEN="" C_YELLOW="" C_BLUE="" C_MAGENTA="" C_CYAN="" C_WHITE="" C_GOLD=""
C_BG_RED="" C_BG_GREEN="" C_BG_BLUE="" C_BG_MAGENTA="" C_BG_CYAN=""
fi
# =============================================================================
# EMOJIS
# =============================================================================
if locale charmap 2>/dev/null | grep -qi utf; then
E_OK="✔" E_FAIL="✘" E_WARN="⚠" E_ARROW="➜" E_DOT="●"
E_GEAR="⚙" E_ROCKET="🚀" E_SHIELD="🛡" E_DB="🗄" E_GIT="🔀"
E_WRENCH="🔧" E_CHART="📊" E_BOLT="⚡" E_BROOM="🧹" E_EYE="👁"
E_LOCK="🔒" E_HEART="♥" E_CLOUD="☁" E_FIRE="🔥" E_GLOBE="🌐"
E_CONSOLE="🖥" E_CLOCK="⏱" E_DOCKER="🐳" E_CHECK="🔍"
else
E_OK="[OK]" E_FAIL="[!]" E_WARN="[!]" E_ARROW="->" E_DOT="*"
E_GEAR="[G]" E_ROCKET="[R]" E_SHIELD="[S]" E_DB="[DB]" E_GIT="[G]"
E_WRENCH="[W]" E_CHART="[C]" E_BOLT="[!]" E_BROOM="[C]" E_EYE="[E]"
E_LOCK="[L]" E_HEART="[H]" E_CLOUD="[C]" E_FIRE="[F]" E_GLOBE="[W]"
E_CONSOLE="[M]" E_CLOCK="[T]" E_DOCKER="[D]" E_CHECK="[C]"
fi
# =============================================================================
# STATE
# =============================================================================
SELECTIVE_UPDATE=""
DRY_RUN=false
HAD_UPDATES=false
NITRO_BUILT=false
ERRORS=0
WARNINGS=0
UPDATED_REPOS=()
LAST_BACKUP=""
ROLLBACK_NEEDED=false
BINARY_BACKUP_DIR=""
NOTIFY_FAILED=false
CONFIG_BACKUP_DIR=""
MAVEN_OPTS="${MAVEN_OPTS:--Xmx2G}"
# =============================================================================
# LOAD .ENV
# =============================================================================
if [ -f "$SCRIPT_DIR/.env" ]; then set -a; . "$SCRIPT_DIR/.env"; set +a; fi
if [ -z "${NITRO_DB_NAME:-}" ] && [ -n "${DATABASE_URL:-}" ]; then
eval "$(
python3 -c "
import os, urllib.parse
url = os.environ['DATABASE_URL']
parsed = urllib.parse.urlparse(url)
auth = parsed.netloc.rsplit('@', 1)[0] if '@' in parsed.netloc else ''
user, pw = (auth.split(':', 1) + ['', ''])[:2]
host = parsed.hostname or '127.0.0.1'
port = parsed.port or 3306
name = parsed.path.lstrip('/').split('?')[0]
print(f'DB_USER={user!r}')
print(f'DB_PASS={urllib.parse.unquote(pw)!r}')
print(f'DB_HOST={host!r}')
print(f'DB_PORT={port!r}')
print(f'DB_NAME={name!r}')
" 2>/dev/null || true
)"
fi
# =============================================================================
# CONFIG
# =============================================================================
LOG_DIR="${NITRO_LOG_DIR:-$SCRIPT_DIR/storage/logs}"
mkdir -p "$LOG_DIR" 2>/dev/null || true
LOG_FILE="$LOG_DIR/update-$(date +%Y%m%d-%H%M%S).log"
NOTIFY_URL="${NITRO_NOTIFY_URL:-}"
DB_NAME="${NITRO_DB_NAME:-${DB_NAME:-habbo}}"
DB_HOST="${NITRO_DB_HOST:-${DB_HOST:-127.0.0.1}}"
DB_PORT="${NITRO_DB_PORT:-${DB_PORT:-3306}}"
DB_USER="${NITRO_DB_USER:-${DB_USER:-root}}"
DB_PASS="${NITRO_DB_PASS:-${DB_PASS:-}}"
EMULATOR_SERVICE="${NITRO_EMULATOR_SERVICE:-emulator}"
EMULATOR_DIR="${NITRO_EMULATOR_PATH:-/var/www/emulator}"
# Polaris-Emulator: the git repository root is $EMULATOR_DIR itself, while the
# Maven project (pom.xml + target/) lives in the $EMULATOR_DIR/Emulator submodule.
EMULATOR_REPO="${NITRO_EMULATOR_REPO:-$EMULATOR_DIR}"
EMULATOR_MODULE="${NITRO_EMULATOR_MODULE:-$EMULATOR_DIR/Emulator}"
SQL_DIR="${NITRO_SQL_DIR:-$EMULATOR_DIR/Database/Database Updates}"
GAMEDATA_CONF_DIR="${NITRO_GAMEDATA_DIR:-/var/www/Gamedata/config}"
NITRO_SRC_DIR="${NITRO_CLIENT_DIR:-/var/www/Nitro-V3/public/configuration}"
BACKUP_DIR="${NITRO_BACKUP_DIR:-$EMULATOR_DIR/Database/Database Updates/backups}"
NITRO_CLIENT="${NITRO_CLIENT_SRC:-/var/www/Nitro-V3}"
NITRO_RENDERER="${NITRO_RENDERER_SRC:-/var/www/Nitro_Render_V3}"
NITRO_BRANCH="${NITRO_BRANCH:-}"
MIN_DISK_GB="${NITRO_MIN_DISK_GB:-5}"
HEALTH_RETRIES="${NITRO_HEALTH_RETRIES:-12}"
HEALTH_INTERVAL="${NITRO_HEALTH_INTERVAL:-5}"
NITRO_SSL_VERIFY="${NITRO_SSL_VERIFY:-OFF}"
CONFIG_BACKUP_DIR="${SCRIPT_DIR}/storage/config-backups"
mkdir -p "$CONFIG_BACKUP_DIR" 2>/dev/null || true
mkdir -p "$BACKUP_DIR" 2>/dev/null || true
NITRO_LANG="${NITRO_LANG:-en}"
MYSQL_CRED="-h $DB_HOST -P $DB_PORT -u $DB_USER --ssl-verify-server-cert=${NITRO_SSL_VERIFY}"
[ -n "$DB_PASS" ] && MYSQL_CRED="$MYSQL_CRED --password=$DB_PASS"
if command -v mariadb &>/dev/null; then
MYSQL_CLIENT="mariadb"; MYSQL_DUMP="mariadb-dump"
elif command -v mysql &>/dev/null; then
MYSQL_CLIENT="mysql"; MYSQL_DUMP="mysqldump"
else
MYSQL_CLIENT="mariadb"; MYSQL_DUMP="mariadb-dump"
fi
# =============================================================================
# LANGUAGE / INTERNATIONALIZATION
# =============================================================================
declare -A _T
_t() {
local key="$1"; shift
local text="${_T[$key]:-$key}"
for arg in "$@"; do
text="${text/\%s/$arg}"
done
echo "$text"
}
load_language() {
local lang="${NITRO_LANG:-en}"
case "${lang,,}" in
nl) _T=(
# ── MENU ──────────────────────────────────────────────
["UPDATE"]="UPDATE"
["TOOLS"]="TOOLS"
["ADVANCED"]="ADVANCED"
["Quick Update — current branch"]="Snelle Update — huidige branch"
["Full Update (choose branch)"]="Volledige Update (kies branch)"
["Emulator Only"]="Alleen Emulator"
["Nitro-V3 Client Only"]="Alleen Nitro-V3 Client"
["Renderer Only"]="Alleen Renderer"
["Configs Only"]="Alleen Configuraties"
["Dev Mode (skip builds, only configs)"]="Dev Modus (skip builds, alleen configs)"
["Switch Branch"]="Wissel Branch"
["Database"]="Database"
["Backup / Restore"]="Backup / Herstel"
["Services"]="Services"
["Status"]="Status"
["Health Check"]="Gezondheidscheck"
["Clean"]="Opschonen"
["Logs"]="Logboeken"
["Config"]="Configuratie"
["Git Log"]="Git Logboek"
["Compare Branches"]="Vergelijk Branches"
["Cron Scheduler"]="Cron Planner"
["View Git Stashes"]="Bekijk Git Stashes"
["Exit"]="Afsluiten"
["Flyaway Repair"]="Vliegende Reparatie"
["Rebuild Frontend"]="Frontend Herbouwen"
["Rebuild Emulator"]="Emulator Herbouwen"
["Select [0-20]"]="Selecteer [0-21]"
["Press Enter to continue..."]="Druk op Enter om door te gaan..."
["Goodbye!"]="Tot ziens!"
# ── HELP ──────────────────────────────────────────────
["SMaRT — Emulator / Nitro-V3 / Nitro-V3-Render Updater & Manager"]="SMaRT — Emulator / Nitro-V3 / Nitro-V3-Render Updater & Beheerder"
["USAGE:"]="GEBRUIK:"
["COMMANDS:"]="COMMANDO'S:"
["Open menu (default)"]="Open menu (standaard)"
["Run update"]="Voer update uit"
["Create database backup"]="Maak databasebackup"
["Restore from backup"]="Herstel vanuit backup"
["List backups"]="Toon backups"
["System dashboard"]="Systeemdashboard"
["Health check"]="Gezondheidscheck"
["Service manager"]="Servicebeheerder"
["Database tools"]="Database tools"
["Show config"]="Toon configuratie"
["View logs"]="Bekijk logboeken"
["Cache cleanup"]="Cache opschonen"
["Git history"]="Git geschiedenis"
["Branch diff"]="Branch vergelijking"
["Cron setup"]="Cron instellen"
["View git stashes"]="Bekijk git stashes"
["Branch (auto-detects)"]="Branch (auto-detectie)"
["Site URL"]="Site URL"
["emulator|client|renderer|configs|dev"]="emulator|client|renderer|configs|dev"
["Preview only (no changes)"]="Alleen voorbeeld (geen wijzigingen)"
["Show this help"]="Toon deze hulp"
["Show version"]="Toon versie"
["OPTIONS:"]="OPTIES:"
["Unknown:"]="Onbekend:"
# ── STEP HEADERS ──────────────────────────────────────
["Update & Build Emulator"]="Update & Bouw Emulator"
["Update Nitro_Render_V3"]="Update Nitro_Render_V3"
["Update & Build Nitro-V3"]="Update & Bouw Nitro-V3"
["Sync Configurations"]="Synchroniseer Configuraties"
["Cleanup"]="Opschonen"
["Set Permissions"]="Stel Permissies in"
["Restart Services"]="Herstart Services"
["System Diagnostics"]="Systeemdiagnose"
["Database Backup"]="Databasebackup"
["Database Restore"]="Database Herstel"
["Backup Inventory"]="Backup Inventaris"
["System Status"]="Systeemstatus"
["Health Check"]="Gezondheidscheck"
["Service Manager"]="Servicebeheer"
["Database Tools"]="Database Tools"
["Configuration"]="Configuratie"
["Log Viewer"]="Logboekweergave"
["Cache Cleanup"]="Cache Opschonen"
["Git Commit History"]="Git Commit Geschiedenis"
["Branch Comparison"]="Branch Vergelijking"
["Cron Scheduler"]="Cron Planner"
["Git Stashes"]="Git Stashes"
# ── PROMPTS / CONFIRM ─────────────────────────────────
["Start update?"]="Update starten?"
["Continue?"]="Doorgaan?"
["Restore %s? OVERWRITES database!"]="Herstel %s? OVERSCHRIJFT database!"
["Select [1-%s]"]="Selecteer [1-%s]"
["Branch [1-%s]"]="Branch [1-%s]"
["Name:"]="Naam:"
["Custom"]="Aangepast"
["Select:"]="Selecteer:"
["SQL:"]="SQL:"
["Minute [0-59]:"]="Minuut [0-59]:"
["Hour [0-23]:"]="Uur [0-23]:"
["Branch A:"]="Branch A:"
["Branch B:"]="Branch B:"
["(current)"]="(huidig)"
# ── INFO / OK / WARN / FAIL ──────────────────────────
["All commands available"]="Alle commando's beschikbaar"
["All directories exist"]="Alle mappen bestaan"
["Database connected"]="Database verbonden"
["Emulator: already up to date"]="Emulator: al up-to-date"
["Renderer: already up to date"]="Renderer: al up-to-date"
["Nitro-V3: already up to date"]="Nitro-V3: al up-to-date"
["Emulator JAR backed up"]="Emulator JAR geback-upt"
["Nitro-V3 dist backed up"]="Nitro-V3 dist geback-upt"
["Emulator JAR restored"]="Emulator JAR hersteld"
["Nitro-V3 dist restored"]="Nitro-V3 dist hersteld"
["Renderer dependencies installed"]="Renderer afhankelijkheden geïnstalleerd"
["No repo updates; skipping parallel builds"]="Geen repo-updates; parallel bouwen overgeslagen"
["Dev mode: skipping builds, syncing configs only"]="Dev modus: builds overgeslagen, alleen configs synchroniseren"
["Config back-up: %s"]="Config-backup: %s"
["%s config file(s) synced"]="%s configuratiebestand(en) gesynchroniseerd"
["All config files valid"]="Alle configuratiebestanden geldig"
["%s config(s) invalid"]="%s configuratie(s) ongeldig"
["All config URLs synced"]="Alle config-URL's gesynchroniseerd"
["Redis cache flushed"]="Redis cache geleegd"
["Permissions set"]="Permissies ingesteld"
["Jar: %s"]="Jar: %s"
["Launch script updated"]="Startscript bijgewerkt"
["%s restarted"]="%s herstart"
["Emulator health check passed (service up + port listening)"]="Emulator gezondheidscheck geslaagd (service actief + poort luistert)"
["Emulator not healthy after %s retries"]="Emulator niet gezond na %s pogingen"
["Nginx reloaded"]="Nginx herladen"
["Redis flushed"]="Redis geleegd"
["Cleanup done (%s logs removed)"]="Opschonen voltooid (%s logs verwijderd)"
["Old config backups pruned"]="Oude config-backups opgeruimd"
["Dry-run: would update repos, run DB backups, build, sync configs, cleanup, restart services"]="Proefrun: zou repos updaten, DB-backups maken, bouwen, configs synchroniseren, opschonen, services herstarten"
["Backup: %s — %s"]="Backup: %s — %s"
["Restored"]="Hersteld"
["Cancelled"]="Geannuleerd"
["Started"]="Gestart"
["Stopped"]="Gestopt"
["Restarted"]="Herstart"
["Yarn cleaned"]="Yarn opgeschoond"
["Next.js cache cleared"]="Next.js cache gewist"
["Logs cleaned"]="Logs opgeschoond"
["Full cleanup"]="Volledig opgeschoond"
["Docker pruned"]="Docker opgeruimd"
["Optimized"]="Geoptimaliseerd"
["Old Maven artifacts cleaned"]="Oude Maven artefacten opgeruimd"
["Scheduled daily 03:00"]="Ingesteld dagelijks 03:00"
["Scheduled daily 04:00"]="Ingesteld dagelijks 04:00"
["Scheduled weekly"]="Ingesteld wekelijks"
["Scheduled %s"]="Ingesteld %s"
["Removed"]="Verwijderd"
["Branch: %s"]="Branch: %s"
["No backup dir"]="Geen backup-map"
["No backups"]="Geen backups"
["No logs"]="Geen logboeken"
["No log dir"]="Geen logboek-map"
["No stashes found"]="Geen stashes gevonden"
["Not a git repo"]="Geen git-repository"
["Invalid"]="Ongeldig"
["Invalid selection"]="Ongeldige selectie"
["%s updates, %s warnings"]="%s updates, %s waarschuwingen"
["Update had errors"]="Update had fouten"
["Dev mode had errors"]="Dev modus had fouten"
["Invalid, using: %s"]="Ongeldig, gebruik: %s"
["Backup: %s — %s"]="Backup: %s — %s"
["Script:"]="Script:"
["Bash syntax"]="Bash syntax"
["Configs:"]="Configuraties:"
["Config dir"]="Config map"
["All JSON valid"]="Alle JSON geldig"
["JSON errors:"]="JSON fouten:"
["Gamedata config"]="Gamedata config"
["Backup dir"]="Backup map"
["Network:"]="Netwerk:"
["Nginx config"]="Nginx configuratie"
["Redis PING"]="Redis PING"
["Site reachable"]="Site bereikbaar"
["Emulator port open"]="Emulator poort open"
["Emulator port closed"]="Emulator poort gesloten"
["Databases:"]="Databases:"
["MySQL connect"]="MySQL verbinding"
["Disk:"]="Schijf:"
["Memory:"]="Geheugen:"
["Load:"]="Belasting:"
["Commands:"]="Commando's:"
["Bashisms"]="Bashisms"
["Tables:"]="Tabellen:"
# ── DIE MESSAGES ──────────────────────────────────────
["Another instance is already running (lock: %s)"]="Er draait al een andere instantie (lock: %s)"
["Required commands missing"]="Vereiste commando's ontbreken"
["Missing: %s"]="Ontbreekt: %s"
["Missing dir: %s"]="Map ontbreekt: %s"
["Only %sGB free (min %sGB)"]="Slechts %sGB vrij (min %sGB)"
["Low disk: %sGB free"]="Weinig schijfruimte: %sGB vrij"
["%sGB disk available"]="%sGB schijf beschikbaar"
["DB connection failed"]="Databaseverbinding mislukt"
["Maven build failed (see: %s)"]="Maven build mislukt (zie: %s)"
["No jar found"]="Geen jar gevonden"
["yarn install failed"]="yarn install mislukt"
["yarn build failed (see: %s)"]="yarn build mislukt (zie: %s)"
["Build failure in: %s"]="Buildfout in: %s"
["Backup failed"]="Backup mislukt"
["Restore failed"]="Herstel mislukt"
# ── SECTIONS ──────────────────────────────────────────
[" UPDATE "]=" UPDATE "
[" TOOLS "]=" TOOLS "
[" ADVANCED "]=" GEAVANCEERD "
# ── SUBMENUS ──────────────────────────────────────────
["Start Emulator"]="Start Emulator"
["Stop Emulator"]="Stop Emulator"
["Restart Emulator"]="Herstart Emulator"
["Start Nginx"]="Start Nginx"
["Restart Nginx"]="Herstart Nginx"
["Status All"]="Status Alles"
["Emulator Logs"]="Emulator Logs"
["Emulator Journal"]="Emulator Journal"
["Return"]="Terug"
["DB Info"]="DB Info"
["List Tables"]="Toon Tabellen"
["Table Sizes"]="Tabelgroottes"
["Optimize"]="Optimaliseer"
["Custom Query"]="Eigen Query"
["Active Users"]="Actieve Gebruikers"
["Processlist"]="Proceslijst"
["Yarn"]="Yarn"
["Next.js"]="Next.js"
["Redis"]="Redis"
["Everything"]="Alles"
["Docker"]="Docker"
["Maven"]="Maven"
["Daily 03:00"]="Dagelijks 03:00"
["Daily 04:00"]="Dagelijks 04:00"
["Weekly Sun 03:00"]="Wekelijks Zo 03:00"
["Custom time"]="Eigen tijd"
["Remove"]="Verwijderen"
["Last 20 commits on %s (ahead: %s):"]="Laatste 20 commits op %s (vooruit: %s):"
["%s is %s ahead, %s behind %s"]="%s is %s voor, %s achter op %s"
["Current:"]="Huidig:"
["none"]="geen"
# ── BOX LABELS ────────────────────────────────────────
["SERVER"]="SERVER"
["RESOURCES"]="BRONNEN"
["SERVICES"]="SERVICES"
["GIT REPOS"]="GIT REPOS"
["SCORE"]="SCORE"
["DB INFO"]="DB INFO"
["CONFIGURATION"]="CONFIGURATIE"
["Host:"]="Host:"
["OS:"]="Besturingssysteem:"
["Uptime:"]="Uptime:"
["CPU:"]="CPU:"
["Memory:"]="Geheugen:"
["Disk:"]="Schijf:"
["Database:"]="Database:"
["Passed:"]="Geslaagd:"
["Failed:"]="Mislukt:"
["Warnings:"]="Waarschuwingen:"
["Name:"]="Naam:"
["Size:"]="Grootte:"
["Tables:"]="Tabellen:"
["Site:"]="Site:"
["Branch:"]="Branch:"
["Emulator:"]="Emulator:"
["Nitro-V3:"]="Nitro-V3:"
["Renderer:"]="Renderer:"
["Service:"]="Service:"
["Socket:"]="Socket:"
["API:"]="API:"
["Gamedata:"]="Gamedata:"
["Min Disk:"]="Min Schijf:"
# ── SPINNER ───────────────────────────────────────────
["Building emulator (parallel)..."]="Emulator aan het bouwen (parallel)..."
["Installing deps..."]="Afhankelijkheden installeren..."
["Building frontend..."]="Frontend aan het bouwen..."
["Backing up..."]="Backup aan het maken..."
["Restoring..."]="Aan het herstellen..."
["Optimizing..."]="Aan het optimaliseren..."
# ── NOTIFY ──────────────────────────────────────────
["SUCCESS"]="GELUKT"
["FAILED"]="MISLUKT"
["Completed in %s (%s warnings)"]="Voltooid in %s (%s waarschuwingen)"
# ── OTHER ───────────────────────────────────────────
["Total: %s backups — %s"]="Totaal: %s backups — %s"
["FILENAME"]="BESTANDSNAAM"
["SIZE"]="GROOTTE"
["All config files valid"]="Alle configuratiebestanden geldig"
# ── SUMMARY ──────────────────────────────────────────
["UPDATE COMPLETED SUCCESSFULLY"]="UPDATE SUCCESVOL VOLTOOID"
["COMPLETED WITH %s ERROR(S)"]="VOLTOOID MET %s FOUT(EN)"
["Duration:"]="Duur:"
["Updates:"]="Updates:"
["Nitro build:"]="Nitro build:"
["Warnings:"]="Waarschuwingen:"
["Repos:"]="Repos:"
["Yes"]="Ja"
["No"]="Nee"
) ;;
fr) _T=(
# ── MENU ──────────────────────────────────────────────
["UPDATE"]="MISE À JOUR"
["TOOLS"]="OUTILS"
["ADVANCED"]="AVANCÉ"
["Quick Update — current branch"]="Mise à jour rapide — branche actuelle"
["Full Update (choose branch)"]="Mise à jour complète (choisir branche)"
["Emulator Only"]="Émulateur uniquement"
["Nitro-V3 Client Only"]="Client Nitro-V3 uniquement"
["Renderer Only"]="Rendu uniquement"
["Configs Only"]="Configs uniquement"
["Dev Mode (skip builds, only configs)"]="Mode Dev (sans builds, configs seulement)"
["Switch Branch"]="Changer de branche"
["Database"]="Base de données"
["Backup / Restore"]="Sauvegarde / Restauration"
["Services"]="Services"
["Status"]="Statut"
["Health Check"]="Vérification de santé"
["Clean"]="Nettoyer"
["Logs"]="Journaux"
["Config"]="Configuration"
["Git Log"]="Journal Git"
["Compare Branches"]="Comparer les branches"
["Cron Scheduler"]="Planificateur Cron"
["View Git Stashes"]="Voir les stashs Git"
["Exit"]="Quitter"
["Flyaway Repair"]="Réparation Flyaway"
["Rebuild Frontend"]="Reconstruire le Frontend"
["Rebuild Emulator"]="Reconstruire l'Emulateur"
["Select [0-20]"]="Sélectionner [0-21]"
["Press Enter to continue..."]="Appuyez sur Entrée pour continuer..."
["Goodbye!"]="Au revoir !"
["Start update?"]="Lancer la mise à jour ?"
["Continue?"]="Continuer ?"
# ── HELP ──────────────────────────────────────────────
["USAGE:"]="UTILISATION :"
["COMMANDS:"]="COMMANDES :"
["OPTIONS:"]="OPTIONS :"
# ── STEP HEADERS ──────────────────────────────────────
["Update & Build Emulator"]="Mise à jour & Construction Émulateur"
["Update Nitro_Render_V3"]="Mise à jour Nitro_Render_V3"
["Update & Build Nitro-V3"]="Mise à jour & Construction Nitro-V3"
["Sync Configurations"]="Synchroniser les configurations"
["Cleanup"]="Nettoyage"
["Set Permissions"]="Définir les permissions"
["Restart Services"]="Redémarrer les services"
["System Diagnostics"]="Diagnostics système"
["Database Backup"]="Sauvegarde base de données"
["Database Restore"]="Restauration base de données"
["Backup Inventory"]="Inventaire des sauvegardes"
["System Status"]="Statut du système"
["Health Check"]="Vérification de santé"
["Service Manager"]="Gestionnaire de services"
["Database Tools"]="Outils base de données"
["Configuration"]="Configuration"
["Log Viewer"]="Visualisateur de journaux"
["Cache Cleanup"]="Nettoyage du cache"
["Git Commit History"]="Historique des commits Git"
["Branch Comparison"]="Comparaison de branches"
["Cron Scheduler"]="Planificateur Cron"
["Git Stashes"]="Stashs Git"
["Missing: %s"]="Manquant : %s"
["Missing dir: %s"]="Répertoire manquant : %s"
["All commands available"]="Toutes les commandes disponibles"
["All directories exist"]="Tous les répertoires existent"
["Database connected"]="Base de données connectée"
["Maven build failed (see: %s)"]="Build Maven échoué (voir : %s)"
["yarn install failed"]="yarn install échoué"
["yarn build failed (see: %s)"]="yarn build échoué (voir : %s)"
["Jar: %s"]="Jar : %s"
["Backup: %s — %s"]="Sauvegarde : %s — %s"
["Restored"]="Restauré"
["Cancelled"]="Annulé"
["Invalid"]="Invalide"
["Invalid selection"]="Sélection invalide"
["Scheduled daily 03:00"]="Planifié quotidien 03:00"
["Scheduled daily 04:00"]="Planifié quotidien 04:00"
["Scheduled weekly"]="Planifié hebdomadaire"
["Removed"]="Supprimé"
["Return"]="Retour"
["none"]="aucun"
["Yes"]="Oui"
["No"]="Non"
["Goodbye!"]="Au revoir !"
) ;;
es) _T=(
# ── MENU ──────────────────────────────────────────────
["UPDATE"]="ACTUALIZAR"
["TOOLS"]="HERRAMIENTAS"
["ADVANCED"]="AVANZADO"
["Quick Update — current branch"]="Actualización rápida — rama actual"
["Full Update (choose branch)"]="Actualización completa (elegir rama)"
["Emulator Only"]="Solo Emulador"
["Nitro-V3 Client Only"]="Solo Cliente Nitro-V3"
["Renderer Only"]="Solo Renderizador"
["Configs Only"]="Solo Configuraciones"
["Dev Mode (skip builds, only configs)"]="Modo Dev (sin builds, solo configs)"
["Switch Branch"]="Cambiar Rama"
["Database"]="Base de Datos"
["Backup / Restore"]="Respaldo / Restaurar"
["Services"]="Servicios"
["Status"]="Estado"
["Health Check"]="Verificación de Salud"
["Clean"]="Limpiar"
["Logs"]="Registros"
["Config"]="Configuración"
["Git Log"]="Registro Git"
["Compare Branches"]="Comparar Ramas"
["Cron Scheduler"]="Programador Cron"
["View Git Stashes"]="Ver Stashes Git"
["Exit"]="Salir"
["Flyaway Repair"]="Reparación Flyaway"
["Rebuild Frontend"]="Reconstruir Frontend"
["Rebuild Emulator"]="Reconstruir Emulador"
["Select [0-20]"]="Seleccionar [0-21]"
["Press Enter to continue..."]="Presione Enter para continuar..."
["Goodbye!"]="¡Hasta luego!"
["Start update?"]="¿Iniciar actualización?"
["Continue?"]="¿Continuar?"
["Missing: %s"]="Falta: %s"
["Missing dir: %s"]="Directorio faltante: %s"
["All commands available"]="Todos los comandos disponibles"
["All directories exist"]="Todos los directorios existen"
["Database connected"]="Base de datos conectada"
["Maven build failed (see: %s)"]="Build Maven falló (ver: %s)"
["yarn install failed"]="yarn install falló"
["yarn build failed (see: %s)"]="yarn build falló (ver: %s)"
["Goodbye!"]="¡Hasta luego!"
["Return"]="Volver"
["none"]="ninguno"
["Yes"]="Sí"
["No"]="No"
) ;;
de) _T=(
# ── MENU ──────────────────────────────────────────────
["UPDATE"]="AKTUALISIEREN"
["TOOLS"]="WERKZEUGE"
["ADVANCED"]="ERWEITERT"
["Quick Update — current branch"]="Schnellupdate — aktueller Branch"
["Full Update (choose branch)"]="Vollständiges Update (Branch wählen)"
["Emulator Only"]="Nur Emulator"
["Nitro-V3 Client Only"]="Nur Nitro-V3 Client"
["Renderer Only"]="Nur Renderer"
["Configs Only"]="Nur Konfigurationen"
["Dev Mode (skip builds, only configs)"]="Dev-Modus (ohne Builds, nur Konfigs)"
["Switch Branch"]="Branch wechseln"
["Database"]="Datenbank"
["Backup / Restore"]="Sicherung / Wiederherstellung"
["Services"]="Dienste"
["Status"]="Status"
["Health Check"]="Gesundheitsprüfung"
["Clean"]="Bereinigen"
["Logs"]="Protokolle"
["Config"]="Konfiguration"
["Git Log"]="Git-Verlauf"
["Compare Branches"]="Branches vergleichen"
["Cron Scheduler"]="Cron-Planer"
["View Git Stashes"]="Git-Stashes anzeigen"
["Exit"]="Beenden"
["Flyaway Repair"]="Flyaway-Reparatur"
["Rebuild Frontend"]="Frontend neu bauen"
["Rebuild Emulator"]="Emulator neu bauen"
["Select [0-20]"]="Auswählen [0-21]"
["Press Enter to continue..."]="Drücken Sie Enter zum Fortfahren..."
["Goodbye!"]="Auf Wiedersehen!"
["Start update?"]="Update starten?"
["Continue?"]="Fortfahren?"
["Missing: %s"]="Fehlt: %s"
["Missing dir: %s"]="Verzeichnis fehlt: %s"
["All commands available"]="Alle Befehle verfügbar"
["All directories exist"]="Alle Verzeichnisse vorhanden"
["Database connected"]="Datenbank verbunden"
["Maven build failed (see: %s)"]="Maven-Build fehlgeschlagen (siehe: %s)"
["yarn install failed"]="yarn install fehlgeschlagen"
["yarn build failed (see: %s)"]="yarn build fehlgeschlagen (siehe: %s)"
["Goodbye!"]="Auf Wiedersehen!"
["Return"]="Zurück"
["none"]="keine"
["Yes"]="Ja"
["No"]="Nein"
) ;;
it) _T=(
# ── MENU ──────────────────────────────────────────────
["UPDATE"]="AGGIORNA"
["TOOLS"]="STRUMENTI"
["ADVANCED"]="AVANZATE"
["Quick Update — current branch"]="Aggiornamento rapido — ramo attuale"
["Full Update (choose branch)"]="Aggiornamento completo (scegli ramo)"
["Emulator Only"]="Solo Emulatore"
["Nitro-V3 Client Only"]="Solo Client Nitro-V3"
["Renderer Only"]="Solo Renderer"
["Configs Only"]="Solo Configurazioni"
["Dev Mode (skip builds, only configs)"]="Modalità Dev (senza build, solo configs)"
["Switch Branch"]="Cambia Ramo"
["Database"]="Database"
["Backup / Restore"]="Backup / Ripristino"
["Services"]="Servizi"
["Status"]="Stato"
["Health Check"]="Controllo Salute"
["Clean"]="Pulisci"
["Logs"]="Registri"
["Config"]="Configurazione"
["Git Log"]="Registro Git"
["Compare Branches"]="Confronta Rami"
["Cron Scheduler"]="Pianificatore Cron"
["View Git Stashes"]="Vedi Stash Git"
["Exit"]="Esci"
["Flyaway Repair"]="Riparazione Flyaway"
["Rebuild Frontend"]="Ricostruisci Frontend"
["Rebuild Emulator"]="Ricostruisci Emulatore"
["Select [0-20]"]="Seleziona [0-21]"
["Press Enter to continue..."]="Premi Invio per continuare..."
["Goodbye!"]="Arrivederci!"
["Start update?"]="Avviare aggiornamento?"
["Continue?"]="Continuare?"
["Missing: %s"]="Mancante: %s"
["Missing dir: %s"]="Directory mancante: %s"
["All commands available"]="Tutti i comandi disponibili"
["All directories exist"]="Tutte le directory esistono"
["Database connected"]="Database connesso"
["Maven build failed (see: %s)"]="Build Maven fallita (vedi: %s)"
["yarn install failed"]="yarn install fallito"
["yarn build failed (see: %s)"]="yarn build fallito (vedi: %s)"
["Goodbye!"]="Arrivederci!"
["Return"]="Indietro"
["none"]="nessuno"
["Yes"]="Sì"
["No"]="No"
) ;;
esac
}
# =============================================================================
# LOCKFILE
# =============================================================================
acquire_lock() {
exec 9>"$LOCK_FILE"
if ! flock -n 9; then
die "Another instance is already running (lock: %s)" "$LOCK_FILE"
fi
}
release_lock() {
flock -u 9 2>/dev/null || true
rm -f "$LOCK_FILE" 2>/dev/null || true
}
# =============================================================================
# UI HELPERS
# =============================================================================
log_write() { printf "[%s] [%s] %s\n" "$(date '+%Y-%m-%d %H:%M:%S')" "$1" "$2" >> "$LOG_FILE" 2>/dev/null || true; }
info() { local m; m=$(_t "$1" "${@:2}"); echo -e " ${C_BLUE}${E_ARROW}${C_RESET} $m"; log_write "INFO" "$m"; }
ok() { local m; m=$(_t "$1" "${@:2}"); echo -e " ${C_GREEN}${E_OK}${C_RESET} $m"; log_write "OK" "$m"; }
warn() { local m; m=$(_t "$1" "${@:2}"); echo -e " ${C_YELLOW}${E_WARN}${C_RESET} $m"; WARNINGS=$((WARNINGS + 1)); log_write "WARN" "$m"; }
fail() { local m; m=$(_t "$1" "${@:2}"); echo -e " ${C_RED}${E_FAIL}${C_RESET} $m"; log_write "FAIL" "$m"; }
die() {
local m; m=$(_t "$1" "${@:2}")
echo ""
echo -e " ${C_BG_RED}${C_WHITE}${C_BOLD} $(_t "ERROR") ${C_RESET} ${C_RED}$m${C_RESET}"
log_write "FATAL" "$m"
cleanup_notify_failure "$m"
release_lock
cursor_show
exit 1
}
cursor_hide() { tput civis 2>/dev/null || true; }
cursor_show() { tput cnorm 2>/dev/null || true; }
clear_line() { printf "\r\033[K"; }
repeat() { local ch="${1:-=}" n="${2:-1}"; printf '%*s' "$n" '' | tr ' ' "$ch"; }
list_sorted() { local d="$1" p="$2" m="${3:-20}"; find "$d" -name "$p" -printf '%T@ %p\n' 2>/dev/null | sort -rn | head -n "$m" | sed 's/^[0-9.]* //'; }
service_active() {
local svc="$1"
if command -v systemctl &>/dev/null; then
systemctl is-active "$svc" &>/dev/null
elif command -v service &>/dev/null; then
service "$svc" status &>/dev/null
else
pgrep -x "$svc" &>/dev/null
fi
}
format_size() {
local bytes="${1:-0}"
if command -v numfmt &>/dev/null; then
numfmt --to=iec "$bytes" 2>/dev/null || echo "${bytes}B"
else
echo "${bytes}B"
fi
}
SPINNER_PID=""
spinner_start() {
local msg="${1:-Working...}"
local frames=("⠋" "⠙" "⠹" "⠸" "⠼" "⠴" "⠦" "⠧" "⠇" "⠏")
cursor_hide
(
local i=0
while true; do
printf "\r ${C_CYAN}${frames[$i]}${C_RESET} %s " "$(_t "$msg")"
i=$(( (i + 1) % ${#frames[@]} ))
sleep 0.1
done
) &
SPINNER_PID=$!
}
spinner_stop() {
local st="${1:-ok}"
if [ -n "$SPINNER_PID" ]; then
kill "$SPINNER_PID" 2>/dev/null || true
wait "$SPINNER_PID" 2>/dev/null || true
SPINNER_PID=""
fi
clear_line; cursor_show
case "$st" in ok) printf "\r ${C_GREEN}${E_OK}${C_RESET} Done\n" ;; warn) printf "\r ${C_YELLOW}${E_WARN}${C_RESET} Done\n" ;; fail) printf "\r ${C_RED}${E_FAIL}${C_RESET} Failed\n" ;; esac
}
step() {
local num="${1}" total="${2}" title="${3}"
echo ""
echo -e " ${C_BG_CYAN}${C_WHITE}${C_BOLD} Step ${num}/${total} — $(_t "$title") ${C_RESET}"
echo ""
}
confirm() {
local msg="${1:-Continue?}" default="${2:-y}"
local hint="[Y/n]"; [ "$default" = "n" ] && hint="[y/N]"
echo -en " ${C_YELLOW}${E_ARROW}${C_RESET} ${C_BOLD}$(_t "$msg")${C_RESET} $hint "
local reply; read -rt 30 reply; reply="${reply:-$default}"
[[ "$reply" =~ ^[Yy] ]]
}
dry_run() {
if [ "$DRY_RUN" = true ]; then
echo -e " ${C_DIM}[DRY-RUN]${C_RESET} $*"
return 0
fi
return 1
}
box_top() {
local title="${1:-}" width="${2:-60}"
if [ -n "$title" ]; then
local tt; tt=$(_t "$title")
local pad=$((width - ${#tt} - 6)); [ $pad -lt 0 ] && pad=0
printf "${C_CYAN}╔═══ ${C_BOLD}%s${C_RESET}${C_CYAN}" "$tt"
repeat '═' "$pad"
echo -e "╗${C_RESET}"
else
printf "${C_CYAN}╔"; repeat '═' "$width"; echo -e "╗${C_RESET}"
fi
}
box_kv() {
local key="${1}" val="${2}" width="${3:-60}"
local kk; kk=$(_t "$key")
local ck=$(echo -e "$kk" | sed 's/\x1b\[[0-9;]*m//g')
local cv=$(echo -e "$val" | sed 's/\x1b\[[0-9;]*m//g')
local pad=$((width - ${#ck} - ${#cv} - 6)); [ $pad -lt 0 ] && pad=0
printf "${C_CYAN}║${C_RESET} %s%*s%s ${C_CYAN}║${C_RESET}\n" "$kk" $pad "" "$val"
}
box_line() {
local text="${1:-}" width="${2:-60}"
local ct=$(echo -e "$text" | sed 's/\x1b\[[0-9;]*m//g')
local pad=$((width - ${#ct} - 4)); [ $pad -lt 0 ] && pad=0
printf "${C_CYAN}║${C_RESET} %s%*s${C_CYAN}║${C_RESET}\n" "$text" $pad ""
}
box_bottom() { local w="${1:-60}"; printf "${C_CYAN}╚"; repeat '═' "$w"; echo -e "╝${C_RESET}"; }
# =============================================================================
# NOTIFICATIONS
# =============================================================================
notify() {
local status="$1" message="$2"
[ -z "$NOTIFY_URL" ] && return 0
local elapsed=$(($(date +%s) - START_TIME))
local ef; ef=$(printf '%dm %ds' $((elapsed / 60)) $((elapsed % 60)))
N_STATUS="$status" N_MESSAGE="$message" N_DURATION="$ef" \
python3 -c "
import json, os
payload = {
'text': '[Nitro Update] ' + os.environ['N_STATUS'],
'attachments': [{
'color': 'good' if os.environ['N_STATUS'] == 'SUCCESS' else 'danger',
'fields': [
{'title': 'Status', 'value': os.environ['N_MESSAGE'], 'short': True},
{'title': 'Duration', 'value': os.environ['N_DURATION'], 'short': True}
]
}]
}
print(json.dumps(payload))
" | curl -s -o /dev/null -X POST "$NOTIFY_URL" -H "Content-Type: application/json" -d @- 2>/dev/null || true
}
cleanup_notify_failure() { $NOTIFY_FAILED && return; NOTIFY_FAILED=true; notify "FAILED" "$1"; }
cleanup_on_exit() {
local ec=$?; cursor_show; release_lock
if [ $ec -ne 0 ] && [ "$ROLLBACK_NEEDED" = true ]; then
echo -e "\n ${C_BG_RED}${C_WHITE}${C_BOLD} $(_t "ROLLBACK") ${C_RESET}"
echo -e " $(_t "Restoring config back-ups from") $CONFIG_BACKUP_DIR/rollback..."
if [ -d "$CONFIG_BACKUP_DIR/rollback" ]; then
cp -r "$CONFIG_BACKUP_DIR/rollback/"* "$NITRO_SRC_DIR/" 2>/dev/null || true
ok "Config files restored from rollback"
fi
restore_binaries
fi
[ $ec -ne 0 ] && cleanup_notify_failure "Exit code $ec"
}
trap cleanup_on_exit EXIT
trap 'release_lock; cursor_show; exit 1' SIGINT SIGTERM
# =============================================================================
# GIT HELPERS
# =============================================================================
detect_branches() {
local repos=("$EMULATOR_REPO" "$NITRO_CLIENT" "$NITRO_RENDERER")
for repo in "${repos[@]}"; do
[ -d "$repo/.git" ] || continue
(
cd "$repo" 2>/dev/null || exit
git branch -r 2>/dev/null | grep -v '\->' | sed 's/^[[:space:]]*//; s/^origin\///' | grep -v '^HEAD$'
)
done | sort -u
}
load_branches() {
local -n _arr="$1"
readarray -t _arr < <(detect_branches)
}
detect_best_branch() {
local repo="$1" preferred="$2"
(
cd "$repo" 2>/dev/null || { echo "main"; exit 0; }
local cur; cur=$(git branch --show-current 2>/dev/null || echo "")
for v in "$preferred" "${preferred^}" "$cur" "main" "master"; do
[ -n "$v" ] && git rev-parse --verify "$v" &>/dev/null && { echo "$v"; exit 0; }
done
echo "${cur:-main}"
)
}
git_update() {
local repo="$1" branch="$2"
(
cd "$repo" || { warn "Cannot access $repo"; exit 1; }
# Only stash when the working tree is dirty, to avoid losing nothing
# and to keep the pull fast-forwardable.
if ! git diff --quiet 2>/dev/null || ! git diff --cached --quiet 2>/dev/null; then
git stash --include-untracked 2>/dev/null || true
fi
local old_head; old_head=$(git rev-parse HEAD 2>/dev/null || echo "")
local rb; rb=$(detect_best_branch "$repo" "$branch")
[ "$rb" != "$branch" ] && info "Branch '$branch' not in $(basename "$repo"), using '$rb'"
git checkout "$rb" 2>/dev/null || { warn "Cannot checkout '$rb' in $(basename "$repo")"; exit 1; }
local pulled=1
for attempt in 1 2 3; do
if git pull --ff-only origin "$rb" 2>/dev/null; then
pulled=0; break
elif git pull --ff-only 2>/dev/null; then
pulled=0; break
fi
warn "Pull attempt %s failed in %s, retrying..." "$attempt" "$(basename "$repo")" >&2
sleep 2
done
[ "$pulled" -ne 0 ] && { warn "Pull failed in $(basename "$repo")"; exit 1; }
[ "$(git rev-parse HEAD 2>/dev/null)" != "$old_head" ]
)
}
clean_node_modules() {
if [ ! -f "package.json" ]; then
warn "clean_node_modules: no package.json found, skipping"
return
fi
rm -rf "node_modules" 2>/dev/null || sudo rm -rf "$(pwd)/node_modules" 2>/dev/null || true
}
# =============================================================================
# PARALLEL HELPERS
# =============================================================================
PARALLEL_PIDS=()
PARALLEL_NAMES=()
PARALLEL_FAILED=()
PARALLEL_RESULTS=()
parallel_run() {
local name="$1"; shift
PARALLEL_NAMES+=("$name")
(
"$@" >/dev/null 2>&1
) &
PARALLEL_PIDS+=($!)
}
parallel_wait() {
# Collect per-job pass/fail based on the real exit status of each job.
PARALLEL_RESULTS=()
PARALLEL_FAILED=()
local i=0
for pid in "${PARALLEL_PIDS[@]}"; do
local name="${PARALLEL_NAMES[$i]}"
if wait "$pid" 2>/dev/null; then
PARALLEL_RESULTS+=("__PARALLEL_OK__${name}")
else
PARALLEL_RESULTS+=("__PARALLEL_FAIL__${name}")
PARALLEL_FAILED+=("$name")
fi
i=$((i+1))
done
PARALLEL_PIDS=()
PARALLEL_NAMES=()
}
parallel_failed() {
# Returns 0 (success) when no backgrounded job failed.
[ ${#PARALLEL_FAILED[@]} -eq 0 ]
}
# =============================================================================
# CONFIG BACKUP & VALIDATION
# =============================================================================
backup_configs() {
local ts=$(date +%Y%m%d-%H%M%S)
local bdir="$CONFIG_BACKUP_DIR/$ts"
mkdir -p "$bdir"
if [ -d "$NITRO_SRC_DIR" ]; then
cp -r "$NITRO_SRC_DIR"/*.json "$bdir/" 2>/dev/null || true
fi
# Keep a rolling 'rollback' pointer
rm -rf "$CONFIG_BACKUP_DIR/rollback"
cp -r "$bdir" "$CONFIG_BACKUP_DIR/rollback" 2>/dev/null || true
echo "$bdir"
}
validate_json() {
local file="$1"
if ! python3 -m json.tool "$file" >/dev/null 2>&1; then
return 1
fi
return 0
}
validate_configs() {
local dir="$1"
local errors=0
for f in "$dir"/*.json; do
[ -f "$f" ] || continue
case "$(basename "$f")" in
*jsonc*|*.example*) continue ;;
esac
if ! validate_json "$f"; then
warn "Invalid JSON: %s" "$(basename "$f")"
errors=$((errors + 1))
fi
done
[ "$errors" -eq 0 ] && ok "All config files valid" || warn "$errors config(s) invalid"
}
# =============================================================================
# BINARY BACKUP & ROLLBACK
# =============================================================================
backup_binaries() {
[ -n "$BINARY_BACKUP_DIR" ] && return
BINARY_BACKUP_DIR="$CONFIG_BACKUP_DIR/binaries-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$BINARY_BACKUP_DIR"
local jar_dir="$EMULATOR_MODULE/target"
if [ -d "$jar_dir" ] && ls "$jar_dir"/Polaris-*-jar-with-dependencies.jar &>/dev/null 2>&1; then
cp "$jar_dir"/Polaris-*-jar-with-dependencies.jar "$BINARY_BACKUP_DIR/" 2>/dev/null || true
ok "Emulator JAR backed up"
fi
local client_dist="$NITRO_CLIENT/dist"
if [ -d "$client_dist" ]; then
cp -r "$client_dist" "$BINARY_BACKUP_DIR/client-dist" 2>/dev/null || true
ok "Nitro-V3 dist backed up"
fi
}
restore_binaries() {
[ -z "$BINARY_BACKUP_DIR" ] && return
[ ! -d "$BINARY_BACKUP_DIR" ] && return
echo ""
echo -e " ${C_BG_RED}${C_WHITE}${C_BOLD} $(_t "RESTORE BINARIES") ${C_RESET}"
if ls "$BINARY_BACKUP_DIR"/Polaris-*-jar-with-dependencies.jar &>/dev/null 2>&1; then
local jar_dir="$EMULATOR_MODULE/target"
mkdir -p "$jar_dir"
cp "$BINARY_BACKUP_DIR"/Polaris-*-jar-with-dependencies.jar "$jar_dir/" 2>/dev/null || true
ok "Emulator JAR restored"
fi
if [ -d "$BINARY_BACKUP_DIR/client-dist" ]; then
local client_dist="$NITRO_CLIENT/dist"
rm -rf "$client_dist" 2>/dev/null || true
cp -r "$BINARY_BACKUP_DIR/client-dist" "$client_dist" 2>/dev/null || true
ok "Nitro-V3 dist restored"
fi
}
# =============================================================================
# PRE-FLIGHT CHECKS
# =============================================================================
preflight_check() {
local fatal=false
for cmd in git mvn node python3 yarn; do
command -v "$cmd" &>/dev/null || { fail "Missing: $cmd"; fatal=true; }
done
command -v "$MYSQL_CLIENT" &>/dev/null || { fail "Missing: $MYSQL_CLIENT"; fatal=true; }
command -v "$MYSQL_DUMP" &>/dev/null || { fail "Missing: $MYSQL_DUMP"; fatal=true; }
$fatal && die "Required commands missing"
ok "All commands available"
for d in "$EMULATOR_REPO" "$EMULATOR_MODULE" "$NITRO_RENDERER" "$NITRO_CLIENT" "$NITRO_SRC_DIR"; do
[ -d "$d" ] || die "Missing dir: $d"
done
ok "All directories exist"
local total_kb=$(df --output=avail "$EMULATOR_DIR" 2>/dev/null | tail -1)
local total_gb=$((total_kb / 1024 / 1024))
[ "$total_gb" -lt "$MIN_DISK_GB" ] && die "Only ${total_gb}GB free (min ${MIN_DISK_GB}GB)"
if [ "$total_gb" -lt $((MIN_DISK_GB * 2)) ]; then
warn "Low disk: %sGB free" "$total_gb"
else
ok "%sGB disk available" "$total_gb"
fi
$MYSQL_CLIENT $MYSQL_CRED -e "SELECT 1" "$DB_NAME" &>/dev/null || die "DB connection failed"
ok "Database connected"
}
# =============================================================================
# UPDATE FUNCTIONS
# =============================================================================
update_emulator() {
step 2 8 "Update & Build Emulator"
if git_update "$EMULATOR_REPO" "$NITRO_BRANCH"; then
HAD_UPDATES=true; UPDATED_REPOS+=("Emulator")
cd "$EMULATOR_MODULE"
backup_binaries
ROLLBACK_NEEDED=true
spinner_start "Building emulator (parallel)..."
# Prefer offline mode when the local Maven repo is warm; fall back to
# online if offline resolution fails. ccache speeds up repeated JNI/C++
# native compiles if present.
command -v ccache >/dev/null 2>&1 && export CC="ccache gcc" CXX="ccache g++"
if mvn package -q -T 1C -o -Dmaven.test.skip=true >> "$LOG_FILE" 2>&1 || \
mvn package -q -T 1C -Dmaven.test.skip=true >> "$LOG_FILE" 2>&1; then
spinner_stop ok
else
spinner_stop fail
tail -30 "$LOG_FILE" | grep -E '(ERROR|FAILURE|BUILD)' || true
die "Maven build failed (see: %s)" "$LOG_FILE"
fi
local jar=$(find target -maxdepth 1 -name 'Polaris-*-jar-with-dependencies.jar' -printf '%T@ %p\n' 2>/dev/null | sort -rn | sed -n '1s/^[0-9.]* //p' | xargs -r basename 2>/dev/null || echo "")
[ -z "$jar" ] && die "No jar found"
ok "Jar: %s" "$jar"
cd target/
cat > emulator << EOJ
#!/bin/sh
file_name_emulator=emulator.log
current_time=\$(date "+%H%M_%d-%m-%Y")
file_name=\$file_name_emulator.\$current_time
mv /var/log/emu/emulator.log /var/log/emu/\$file_name
java -Dfile.encoding=UTF8 -Xmx4G -jar $jar
EOJ
chmod +x emulator; ok "Launch script updated"
cd "$SCRIPT_DIR"
else
info "Emulator: already up to date"
fi
}
update_renderer() {
step 3 8 "Update Nitro_Render_V3"
if git_update "$NITRO_RENDERER" "$NITRO_BRANCH"; then
HAD_UPDATES=true; UPDATED_REPOS+=("Nitro_Render_V3")
cd "$NITRO_RENDERER"
spinner_start "Installing deps..."
if ! yarn install --frozen-lockfile --prefer-offline >> "$LOG_FILE" 2>&1; then
warn "Renderer: yarn install failed — cleaning node_modules and retrying"
clean_node_modules
yarn install >> "$LOG_FILE" 2>&1 || { spinner_stop fail; die "yarn install failed (see: %s)" "$LOG_FILE"; }
fi
if [ ! -d node_modules/pixi.js ]; then
warn "Renderer: node_modules incomplete — cleaning and doing full install"
clean_node_modules
yarn install >> "$LOG_FILE" 2>&1 || { spinner_stop fail; die "yarn install failed (see: %s)" "$LOG_FILE"; }
fi
spinner_stop ok; ok "Renderer dependencies installed"
else
info "Renderer: already up to date"
fi
fix_perms
return 0
}
update_client() {
step 4 8 "Update & Build Nitro-V3"
if git_update "$NITRO_CLIENT" "$NITRO_BRANCH"; then
HAD_UPDATES=true; NITRO_BUILT=true; UPDATED_REPOS+=("Nitro-V3")
cd "$NITRO_CLIENT"
backup_binaries
ROLLBACK_NEEDED=true
spinner_start "Installing deps..."
# yarn 1 can "succeed" while leaving node_modules incomplete, so verify
# that the vite build binary actually exists before attempting a build.
if ! yarn install --frozen-lockfile --prefer-offline >> "$LOG_FILE" 2>&1; then
warn "Nitro-V3: yarn install failed — cleaning node_modules and retrying"
clean_node_modules
yarn install >> "$LOG_FILE" 2>&1 || { spinner_stop fail; die "yarn install failed (see: %s)" "$LOG_FILE"; }
fi
if [ ! -x node_modules/.bin/vite ]; then
warn "Nitro-V3: vite missing after install — cleaning node_modules and doing full install"
clean_node_modules
yarn install >> "$LOG_FILE" 2>&1 || { spinner_stop fail; die "yarn install failed (see: %s)" "$LOG_FILE"; }
fi
spinner_stop ok
spinner_start "Building frontend..."
if yarn build >> "$LOG_FILE" 2>&1; then
spinner_stop ok
else
spinner_stop fail
tail -30 "$LOG_FILE" || true
die "yarn build failed (see: %s)" "$LOG_FILE"
fi
else
info "Nitro-V3: already up to date"
fi
mkdir -p "$NITRO_CLIENT/dist/custom-themes"
[ ! -f "$NITRO_CLIENT/dist/custom-themes/index.json" ] && echo '{"themes":[]}' > "$NITRO_CLIENT/dist/custom-themes/index.json"
fix_perms
return 0
}
sync_configs() {
step 5 8 "Sync Configurations"
mkdir -p "$GAMEDATA_CONF_DIR"
# Backup current configs before overwriting
local cb=$(backup_configs)
info "Config back-up: %s" "$(basename "$cb")"
local ms="$SCRIPT_DIR/scripts/merge-config.cjs"
local dcd="$NITRO_CLIENT/dist/configuration"
for d in "$NITRO_SRC_DIR" "$GAMEDATA_CONF_DIR"; do
[ -d "$d" ] && [ ! -w "$d" ] && sudo chown -R "$(whoami)":"$(whoami)" "$d" 2>/dev/null || true
done
local ec=0
for ef in "$NITRO_SRC_DIR"/*.example; do
[ -f "$ef" ] || continue
local b=$(basename "$ef"); local tn="${b%.example}"
case "$tn" in *.*) ;; *) tn="$tn.json" ;; esac
node "$ms" "$ef" "$NITRO_SRC_DIR/$tn" 2>/dev/null
node "$ms" "$ef" "$GAMEDATA_CONF_DIR/$tn" 2>/dev/null
[ -d "$dcd" ] && cp "$NITRO_SRC_DIR/$tn" "$dcd/$tn" 2>/dev/null || true
ec=$((ec+1))
done
ok "%s config file(s) synced" "$ec"
# Validate the generated configs
validate_configs "$NITRO_SRC_DIR"
# Remove legacy .json5 leftovers — the client only supports JSON/JSONC
for d in "$NITRO_SRC_DIR" "$dcd" "$GAMEDATA_CONF_DIR"; do
[ -d "$d" ] && find "$d" -maxdepth 1 -name '*.json5' -type f -delete 2>/dev/null || true
done
ok "Legacy .json5 files removed"
# Pre-flight: warn if NITRO_IMAGE_LIBRARY_URL looks wrong before applying configs
if [ -n "$NITRO_IMAGE_LIBRARY_URL" ]; then
case "$NITRO_IMAGE_LIBRARY_URL" in
*://*/nitro-client*|*://*/nitro-client/)
fail "NITRO_IMAGE_LIBRARY_URL points to the Nitro client path instead of /gamedata/c_images/ — images will 404"
;;
esac
case "$NITRO_IMAGE_LIBRARY_URL" in
*/c_images/) ;;
*://*) warn "NITRO_IMAGE_LIBRARY_URL does not contain /c_images/ — verify it points to the c_images directory" ;;
esac
fi
info "Applying critical config URLs..."
NITRO_SRC_DIR="$NITRO_SRC_DIR" NITRO_DIST_CONFIG_DIR="$dcd" \
NITRO_IMAGE_LIBRARY_URL="$NITRO_IMAGE_LIBRARY_URL" NITRO_HOF_FURNITURE_URL="$NITRO_HOF_FURNITURE_URL" \
NITRO_API_URL="$NITRO_API_URL" NITRO_SOCKET_URL="$NITRO_SOCKET_URL" \
NITRO_GAMEDATA_URL="$NITRO_GAMEDATA_URL" NITRO_ASSET_URL="$NITRO_ASSET_URL" \
NITRO_FURNI_ASSET_ICON_URL="$NITRO_FURNI_ASSET_ICON_URL" \
python3 -c '
import json, os
def to_jsonc(value):
if isinstance(value, dict): return {k: to_jsonc(v) for k, v in value.items()}
if isinstance(value, list): return [to_jsonc(v) for v in value]
if isinstance(value, str): return value.replace(".json5", ".jsonc")
return value
paths = [
os.path.join(os.environ.get("NITRO_SRC_DIR", ""), "renderer-config.json"),
os.path.join(os.environ.get("NITRO_DIST_CONFIG_DIR", ""), "renderer-config.json"),
os.path.join(os.environ.get("NITRO_SRC_DIR", ""), "ui-config.json"),
os.path.join(os.environ.get("NITRO_DIST_CONFIG_DIR", ""), "ui-config.json"),
]
for path in paths:
if not os.path.exists(path): continue
with open(path, "r") as f: data = json.load(f)
data = to_jsonc(data)
for key in ["image.library.url", "hof.furni.url", "gamedata.url", "asset.url"]:
env_val = os.environ.get(f"NITRO_{key.upper().replace(chr(46), chr(95))}")
if env_val: data[key] = env_val
for key in ["api.url", "socket.url", "furni.asset.icon.url"]:
if key in data:
env_val = os.environ.get(f"NITRO_{key.upper().replace(chr(46), chr(95))}")
if env_val: data[key] = env_val
if "gamedata.url" in data:
data["radio.url"] = data["gamedata.url"] + "/config/radio-stations.jsonc?t=%timestamp%"
data["soundboard.url"] = data["gamedata.url"] + "/config/soundboard-sounds.jsonc?t=%timestamp%"
if "show.google.ads" in data: data["show.google.ads"] = False
with open(path, "w") as f: json.dump(data, f, indent=(4 if "dist" not in path else None), separators=(",", ":") if "dist" in path else (",", ": "))
print(f" [OK] Fixed: {os.path.basename(path)}")
' && ok "All config URLs synced"
# Flush Redis so new config is picked up immediately
if command -v redis-cli &>/dev/null; then
redis-cli FLUSHALL 2>/dev/null && ok "Redis cache flushed" || true
fi
fix_perms
}
do_cleanup() {
step 6 8 "Cleanup"
local lc=$(find "$EMULATOR_DIR" -name "*.log" -mtime +14 2>/dev/null | wc -l)
find "$EMULATOR_DIR" -name "*.log" -mtime +14 -exec rm -f {} \; 2>/dev/null || true
# Clean old config backups (keep 10 most recent)
local cb_count=$(find "$CONFIG_BACKUP_DIR" -maxdepth 1 -type d ! -name 'rollback' 2>/dev/null | wc -l)
if [ "$cb_count" -gt 10 ]; then
find "$CONFIG_BACKUP_DIR" -maxdepth 1 -type d ! -name 'rollback' -printf '%T@ %p\n' 2>/dev/null | sort -rn | tail -n +11 | sed 's/^[0-9.]* //' | xargs -r rm -rf || true
ok "Old config backups pruned"
fi
[ -d "$BACKUP_DIR" ] && find "$BACKUP_DIR" -maxdepth 1 -name '*.sql' -printf '%T@ %p\n' 2>/dev/null | sort -rn | tail -n +6 | sed 's/^[0-9.]* //' | xargs -r rm -f || true
yarn cache clean 2>/dev/null || true
rm -rf /tmp/nitro-* /tmp/epicnext-* 2>/dev/null || true
# Clean old Maven build artifacts (older than 7 days)
find "$EMULATOR_MODULE" -maxdepth 3 -name '*.jar' -mtime +7 2>/dev/null -exec rm -f {} \; || true
ok "Cleanup done (%s logs removed)" "$lc"
}
fix_perms() {
# Make build output web-servable no matter which user ran the build.
# Running as root we chown directly; otherwise use `sudo -n` (no TTY, so it
# also works from cron). Never silently swallow failures.
local runner=""
[ "$(id -u)" -eq 0 ] || runner="sudo -n"
local changed=false
for d in "$NITRO_CLIENT" "$NITRO_RENDERER" "$GAMEDATA_CONF_DIR"; do
[ -d "$d" ] || continue
if $runner chown -R www-data:www-data "$d" 2>/dev/null; then
changed=true
else
warn "Could not chown %s to www-data:www-data" "$d"
fi
done
[ "$changed" = true ] && ok "Permissions set"
}
do_permissions() {
step 7 8 "Set Permissions"
fix_perms
}
do_restart() {
step 8 8 "Restart Services"
if systemctl cat "$EMULATOR_SERVICE" &>/dev/null; then
sudo systemctl restart "$EMULATOR_SERVICE" 2>/dev/null && ok "$EMULATOR_SERVICE restarted" || warn "Restart failed"
local hc=0
while [ "$hc" -lt "$HEALTH_RETRIES" ]; do
if service_active "$EMULATOR_SERVICE" && emulator_port_open; then
ok "Emulator health check passed (service up + port listening)"
break
fi
hc=$((hc+1))
[ "$hc" -lt "$HEALTH_RETRIES" ] && sleep "$HEALTH_INTERVAL"
done
if [ "$hc" -eq "$HEALTH_RETRIES" ]; then
warn "Emulator not healthy after %s retries" "$HEALTH_RETRIES"
sudo journalctl -u "$EMULATOR_SERVICE" --no-pager -n 20 2>/dev/null || true
ERRORS=$((ERRORS + 1))
ROLLBACK_NEEDED=true
fi
elif command -v pm2 &>/dev/null; then
pm2 restart all 2>/dev/null && ok "PM2 restarted" || warn "PM2 restart failed"
else
warn "No service manager found"
fi
command -v nginx &>/dev/null && sudo nginx -t 2>/dev/null && sudo systemctl reload nginx 2>/dev/null && ok "Nginx reloaded"
command -v redis-cli &>/dev/null && redis-cli FLUSHALL 2>/dev/null && ok "Redis flushed"
}
# Probe the emulator's configured TCP port to confirm it is actually serving,
# not merely that systemd reports the unit as active.
emulator_port_open() {
local port="${NITRO_EMULATOR_PORT:-}"
if [ -z "$port" ]; then
port=$(grep -m1 '^game\.port=' "$EMULATOR_MODULE/target/config.ini" 2>/dev/null | cut -d= -f2)
fi
if [ -z "$port" ]; then
port=30000
fi
if command -v redis-cli >/dev/null 2>&1; then
local p; p=$(redis-cli GET nitro:emulator:port 2>/dev/null)
[ -n "$p" ] && port="$p"
fi
if command -v nc >/dev/null 2>&1; then
nc -z 127.0.0.1 "$port" -w 3 2>/dev/null && return 0
fi
if command -v ss >/dev/null 2>&1; then
ss -ltn 2>/dev/null | grep -q ":$port " && return 0
fi
timeout 3 bash -c "exec 3<>/dev/tcp/127.0.0.1/$port" 2>/dev/null && return 0
return 1
}
show_summary() {
local el=$(($(date +%s) - START_TIME)); local ef; ef=$(printf '%dm %ds' $((el/60)) $((el%60)))
echo ""
echo -e " ${C_CYAN}╔══════════════════════════════════════════════════════════════════╗${C_RESET}"
if [ "$ERRORS" -eq 0 ]; then
echo -e " ${C_CYAN}║${C_RESET} ${C_GREEN}${C_BOLD}✔ $(_t "UPDATE COMPLETED SUCCESSFULLY")${C_RESET} ${C_CYAN}║${C_RESET}"
else
echo -e " ${C_CYAN}║${C_RESET} ${C_YELLOW}${C_BOLD}⚠ $(_t "COMPLETED WITH") $ERRORS $(_t "ERROR(S)")${C_RESET} ${C_CYAN}║${C_RESET}"
fi
echo -e " ${C_CYAN}╠══════════════════════════════════════════════════════════════════╣${C_RESET}"
printf " ${C_CYAN}║${C_RESET} $(_t "Duration:") %-46s${C_CYAN}║${C_RESET}\n" "$ef"
printf " ${C_CYAN}║${C_RESET} $(_t "Updates:") %-46s${C_CYAN}║${C_RESET}\n" "$([ "$HAD_UPDATES" = true ] && echo "$(_t "Yes")" || echo "$(_t "No")")"
printf " ${C_CYAN}║${C_RESET} $(_t "Nitro build:") %-46s${C_CYAN}║${C_RESET}\n" "$([ "$NITRO_BUILT" = true ] && echo "$(_t "Yes")" || echo "$(_t "No")")"
printf " ${C_CYAN}║${C_RESET} $(_t "Warnings:") %-46s${C_CYAN}║${C_RESET}\n" "$WARNINGS"
[ ${#UPDATED_REPOS[@]} -gt 0 ] && printf " ${C_CYAN}║${C_RESET} $(_t "Repos:") %-46s${C_CYAN}║${C_RESET}\n" "${UPDATED_REPOS[*]}"
echo -e " ${C_CYAN}╚══════════════════════════════════════════════════════════════════╝${C_RESET}"
echo ""
notify "SUCCESS" "Completed in $ef (${WARNINGS} warnings)"
}
# =============================================================================
# FULL UPDATE
# =============================================================================
cmd_update() {
echo ""
acquire_lock
DRY_RUN=${DRY_RUN:-false}
info "Site: %s | Branch: %s | Mode: %s" "${NITRO_SITE_URL:-?}" "$NITRO_BRANCH" "${SELECTIVE_UPDATE:-full}${DRY_RUN:+ [DRY-RUN]}"
info "Log: %s" "$LOG_FILE"
if [ "$DRY_RUN" = true ]; then
info "Dry-run: would update repos, run DB backups, build, sync configs, cleanup, restart services"
show_summary
release_lock
return
fi
step 1 8 "System Diagnostics"
preflight_check
case "${SELECTIVE_UPDATE:-full}" in
emulator) update_emulator ;;
renderer) update_renderer ;;
client) update_client ;;
configs) sync_configs ;;
dev)
# Quick dev mode: skip builds, just sync configs and reload
info "Dev mode: skipping builds, syncing configs only"
sync_configs
do_restart
;;
*)
RUN_ROLLBACK=true
update_emulator
if [ "$HAD_UPDATES" = true ]; then
parallel_run "renderer" update_renderer
parallel_run "client" update_client
parallel_wait
if ! parallel_failed; then
warn "Parallel build(s) failed: %s — aborting before restart" "${PARALLEL_FAILED[*]}"
ROLLBACK_NEEDED=true
die "Build failure in: %s" "${PARALLEL_FAILED[*]}"
fi
else
info "No repo updates; skipping parallel builds"
fi
sync_configs
do_cleanup
do_permissions
do_restart
RUN_ROLLBACK=false
[ -n "$BINARY_BACKUP_DIR" ] && rm -rf "$BINARY_BACKUP_DIR" 2>/dev/null || true
;;
esac
show_summary
fix_perms
release_lock
}
# =============================================================================
# BACKUP / RESTORE
# =============================================================================
cmd_backup() {
step 1 1 "Database Backup"
mkdir -p "$BACKUP_DIR"
local bf="$BACKUP_DIR/manual_$(date +%Y%m%d_%H%M%S).sql"
spinner_start "Backing up..."
if $MYSQL_DUMP $MYSQL_CRED --force --skip-lock-tables --routines --events --triggers "$DB_NAME" > "$bf" 2>/dev/null; then
local sz=$(stat -c%s "$bf" 2>/dev/null || echo 0); spinner_stop ok
ok "Backup: %s — %s" "$(format_size "$sz")" "$(basename "$bf")"
else
spinner_stop fail; die "Backup failed"
fi
}
cmd_restore() {
step 1 1 "Database Restore"
[ ! -d "$BACKUP_DIR" ] && die "No backup dir"
local backups=()
while IFS= read -r line; do backups+=("$line"); done < <(list_sorted "$BACKUP_DIR" '*.sql')
[ ${#backups[@]} -eq 0 ] && die "No backups"
echo ""
echo -e " ${C_BOLD}${C_CYAN}$(_t "Backups:")${C_RESET}"
local i=1
for bk in "${backups[@]}"; do
local sz=$(format_size "$(stat -c%s "$bk" 2>/dev/null || echo 0)")
printf " ${C_GREEN}${C_BOLD}%2d)${C_RESET} %-40s ${C_DIM}%s${C_RESET}\n" "$i" "$(basename "$bk")" "$sz"
i=$((i+1))
done
echo -en "\n $(_t "Select") [1-$((i-1))]: "
local c; read -rt 30 c
[[ "$c" =~ ^[0-9]+$ ]] && [ "$c" -ge 1 ] && [ "$c" -le ${#backups[@]} ] || die "$(_t "Invalid")"
local sel="${backups[$((c-1))]}"
if ! confirm "Restore $(basename "$sel")? OVERWRITES database!"; then info "Cancelled"; return; fi
spinner_start "Restoring..."
$MYSQL_CLIENT $MYSQL_CRED "$DB_NAME" < "$sel" 2>/dev/null && spinner_stop ok && ok "Restored" || { spinner_stop fail; die "Restore failed"; }
}
cmd_backups() {
step 1 1 "Backup Inventory"
[ ! -d "$BACKUP_DIR" ] && { warn "No backup dir"; return; }
echo ""
printf " ${C_DIM}%-4s %-38s %-10s${C_RESET}\n" "#" "FILENAME" "SIZE"
printf " ${C_DIM}%s${C_RESET}\n" "$(repeat '─' 56)"
local t=0 ts=0
while IFS= read -r l; do
t=$((t+1)); local n=$(basename "$l"); local s=$(stat -c%s "$l" 2>/dev/null || echo 0); ts=$((ts+s))
printf " ${C_GREEN}%2d${C_RESET} %-38s ${C_CYAN}%s${C_RESET}\n" "$t" "$n" "$(format_size "$s")"
done < <(list_sorted "$BACKUP_DIR" '*.sql')
printf " ${C_DIM}%s${C_RESET}\n" "$(repeat '─' 56)"
echo -e " ${C_BOLD}$(_t "Total:") $t $(_t "backups") — $(format_size "$ts")${C_RESET}\n"
}
# =============================================================================
# STATUS
# =============================================================================
cmd_status() {
step 1 1 "System Status"
echo ""
box_top "SERVER" 56; box_kv "Host:" "$(hostname)" 56
box_kv "OS:" "$(cat /etc/os-release 2>/dev/null | grep PRETTY_NAME | cut -d= -f2 | tr -d '"' || uname -s)" 56
box_kv "Uptime:" "$(uptime -p 2>/dev/null || uptime)" 56; box_bottom 56
echo ""
box_top "RESOURCES" 56
box_kv "CPU:" "$(awk '{printf "%.1f", $1}' /proc/loadavg 2>/dev/null || echo "?") / $(nproc 2>/dev/null || echo '?') cores" 56
box_kv "Memory:" "$(free -m 2>/dev/null | awk '/^Mem:/{printf "%dMB / %dMB", $3, $2}')" 56
box_kv "Disk:" "$(df -h "$SCRIPT_DIR" 2>/dev/null | tail -1 | awk '{printf "%s / %s (%s)", $3, $2, $5}')" 56
local dbs=$($MYSQL_CLIENT $MYSQL_CRED -N -e "SELECT ROUND(SUM(data_length+index_length)/1024/1024,1) FROM information_schema.tables WHERE table_schema='$DB_NAME'" "$DB_NAME" 2>/dev/null || echo "?")
local dbt=$($MYSQL_CLIENT $MYSQL_CRED -N -e "SELECT COUNT(*) FROM information_schema.tables WHERE table_schema='$DB_NAME'" "$DB_NAME" 2>/dev/null || echo "?")
box_kv "Database:" "${dbs}MB / ${dbt} tables" 56; box_bottom 56
echo ""
box_top "SERVICES" 56
for svc in nginx mariadb redis-server "$EMULATOR_SERVICE" php-fpm cron; do
local st="${C_DIM}N/A${C_RESET}"
service_active "$svc" && st="${C_GREEN}ACTIVE${C_RESET}"
printf " ${C_CYAN}║${C_RESET} %-20s %b${C_CYAN} ║${C_RESET}\n" "$svc" "$st"
done; box_bottom 56
echo ""
box_top "GIT REPOS" 56
for re in "Emulator:$EMULATOR_REPO" "Nitro-V3:$NITRO_CLIENT" "Render:$NITRO_RENDERER"; do
local nm="${re%%:*}" pa="${re##*:}"
[ -d "$pa/.git" ] || continue
local br=$(cd "$pa" && git branch --show-current 2>/dev/null || echo "?")
local cm=$(cd "$pa" && git log --oneline -1 2>/dev/null | cut -c1-30 || echo "?")
local ah=$(cd "$pa" && git rev-list --count "origin/$(git branch --show-current 2>/dev/null)"..HEAD 2>/dev/null || echo "0")
local bh=$(cd "$pa" && git rev-list --count HEAD.."origin/$(git branch --show-current 2>/dev/null)" 2>/dev/null || echo "0")
printf " ${C_CYAN}║${C_RESET} %-12s ${C_CYAN}%-8s${C_RESET} %s" "$nm" "$br" "$cm"
[ "$ah" -gt 0 ] && printf " ${C_RED}+${ah}${C_RESET}" || printf " "
[ "$bh" -gt 0 ] && printf " ${C_YELLOW}-${bh}${C_RESET}" || printf " "
printf " ${C_CYAN}║${C_RESET}\n"
done; box_bottom 56
echo ""
}
# =============================================================================
# HEALTH CHECK
# =============================================================================
cmd_health() {
step 1 1 "Health Check"
local t=0 p=0 f=0 w=0
check() { t=$((t+1)); local lbl="$1"; shift; "$@" &>/dev/null && { p=$((p+1)); ok "$(_t "$lbl")"; } || { f=$((f+1)); fail "$(_t "$lbl")"; }; }
checkw() { t=$((t+1)); local lbl="$1"; shift; "$@" &>/dev/null && { p=$((p+1)); ok "$(_t "$lbl")"; } || { w=$((w+1)); warn "$(_t "$lbl")"; }; }
echo ""
echo -e " ${C_BOLD}$(_t "Commands:")${C_RESET}"
checkw "Git" command -v git; checkw "Node.js" command -v node; checkw "Yarn" command -v yarn
checkw "Python3" command -v python3; checkw "Java" command -v java; checkw "Maven" command -v mvn
checkw "MariaDB" command -v "$MYSQL_CLIENT"
echo -e "\n ${C_BOLD}$(_t "Script:")${C_RESET}"
checkw "$(_t "Bash syntax")" bash -n "$SCRIPT_DIR/$SCRIPT_NAME"
if command -v shellcheck &>/dev/null; then checkw "ShellCheck" shellcheck --quiet "$SCRIPT_DIR/$SCRIPT_NAME"; fi
if command -v checkbashisms &>/dev/null; then checkw "$(_t "Bashisms")" checkbashisms "$SCRIPT_DIR/$SCRIPT_NAME"; fi
echo -e "\n ${C_BOLD}$(_t "Configs:")${C_RESET}"
checkw "$(_t "Config dir")" test -d "$NITRO_SRC_DIR"
local cerr=0
for cf in "$NITRO_SRC_DIR"/*.json; do
[ -f "$cf" ] || continue
case "$(basename "$cf")" in
*jsonc*|*.example*) continue ;;
esac
python3 -m json.tool "$cf" >/dev/null 2>&1 || cerr=$((cerr+1))
done
[ "$cerr" -eq 0 ] && ok "$(_t "All JSON valid")" || warn "$(_t "JSON errors:") $cerr"
echo -e "\n ${C_BOLD}$(_t "Config URLs:")${C_RESET}"
for key in NITRO_SITE_URL NITRO_API_URL NITRO_SOCKET_URL NITRO_GAMEDATA_URL NITRO_IMAGE_LIBRARY_URL; do
local val="${!key}"
if [ -z "$val" ]; then
warn "$key"
else
case "$key" in
NITRO_IMAGE_LIBRARY_URL)
case "$val" in
*/c_images/) ok "$key" ;;
*) warn "$key missing /c_images/ in path: $val" ;;
esac ;;
NITRO_SITE_URL)
case "$val" in
*/nitro-client*|*/nitro-client) warn "$key should be the site URL, not the Nitro client path" ;;
*) ok "$key" ;;
esac ;;
*) ok "$key" ;;
esac
fi
done
echo -e "\n ${C_BOLD}$(_t "Directories:")${C_RESET}"
checkw "Emulator" test -d "$EMULATOR_MODULE"; checkw "Nitro-V3" test -d "$NITRO_CLIENT"; checkw "Renderer" test -d "$NITRO_RENDERER"
checkw "$(_t "Gamedata config")" test -d "$GAMEDATA_CONF_DIR"; checkw "$(_t "Backup dir")" test -d "$BACKUP_DIR"
echo -e "\n ${C_BOLD}$(_t "Services:")${C_RESET}"
checkw "MariaDB" service_active mariadb; checkw "Nginx" service_active nginx; checkw "Redis" service_active redis-server
checkw "$EMULATOR_SERVICE" service_active "$EMULATOR_SERVICE"
echo -e "\n ${C_BOLD}$(_t "Network:")${C_RESET}"
checkw "$(_t "Nginx config")" nginx -t 2>/dev/null
if command -v redis-cli &>/dev/null; then checkw "Redis PING" redis-cli PING 2>/dev/null; fi
checkw "$(_t "Site reachable")" timeout 5 curl -sf "${NITRO_SITE_URL:-}" 2>/dev/null
if emulator_port_open; then ok "$(_t "Emulator port open")"; else warn "$(_t "Emulator port closed")"; fi
echo -e "\n ${C_BOLD}$(_t "Databases:")${C_RESET}"
checkw "$(_t "MySQL connect")" $MYSQL_CLIENT $MYSQL_CRED -e "SELECT 1" "$DB_NAME" 2>/dev/null
local dbt=$($MYSQL_CLIENT $MYSQL_CRED -N -e "SELECT COUNT(*) FROM information_schema.tables WHERE table_schema='$DB_NAME'" "$DB_NAME" 2>/dev/null || echo "?")
t=$((t+1)); [ "$dbt" != "?" ] && { p=$((p+1)); ok "$(_t "Tables:") $dbt"; } || { f=$((f+1)); fail "$(_t "Tables:") ?"; }
echo -e "\n ${C_BOLD}$(_t "Resources:")${C_RESET}"
local ak=$(df --output=avail "$EMULATOR_DIR" 2>/dev/null | tail -1); local ag=$((ak/1024/1024))
t=$((t+1)); [ "$ag" -ge "$MIN_DISK_GB" ] && { p=$((p+1)); ok "$(_t "Disk:") ${ag}GB"; } || { f=$((f+1)); fail "$(_t "Disk:") ${ag}GB"; }
local mem=$(free -m 2>/dev/null | awk '/^Mem:/{printf "%dMB / %dMB", $3, $2}')
t=$((t+1)); ok "$(_t "Memory:") $mem"
local load=$(awk '{printf "%.1f", $1}' /proc/loadavg 2>/dev/null || echo "?")
local cores=$(nproc 2>/dev/null || echo "?")
t=$((t+1)); ok "$(_t "Load:") $load / $cores cores"
echo ""
local sc=$((p*100/t))
box_top "SCORE" 50
box_kv "Passed:" "$p / $t" 50
box_kv "Failed:" "$f" 50; box_kv "Warnings:" "$w" 50
if [ "$sc" -ge 90 ]; then box_line "${C_GREEN}${C_BOLD}${sc}% — $(_t "EXCELLENT")${C_RESET}" 50
elif [ "$sc" -ge 70 ]; then box_line "${C_YELLOW}${C_BOLD}${sc}% — $(_t "GOOD")${C_RESET}" 50
else box_line "${C_RED}${C_BOLD}${sc}% — $(_t "NEEDS ATTENTION")${C_RESET}" 50; fi
box_bottom 50; echo ""
}
# =============================================================================
# FLYAWAY REPAIR
# =============================================================================
cmd_flyaway_repair() {
echo ""
acquire_lock
DRY_RUN=${DRY_RUN:-false}
info "Site: %s | Branch: %s | Mode: %s" "${NITRO_SITE_URL:-?}" "$NITRO_BRANCH" "flyaway-repair"
info "Log: %s" "$LOG_FILE"
if [ "$DRY_RUN" = true ]; then
info "Dry-run: would check repos, reinstall deps, fix permissions, sync configs, restart services"
show_summary
release_lock
return
fi
step 1 6 "System Diagnostics"
preflight_check
step 2 6 "$(_t "Flyaway Repair")"
local repaired=0
for repo in "$EMULATOR_REPO" "$NITRO_CLIENT" "$NITRO_RENDERER"; do
[ -d "$repo/.git" ] || continue
local name; name=$(basename "$repo")
info "Checking %s..." "$name"
# Reset any dirty/uncommitted changes that may cause issues
cd "$repo"
if ! git diff --quiet 2>/dev/null || ! git diff --cached --quiet 2>/dev/null; then
warn "Dirty working tree in %s — stashing changes" "$name"
git stash --include-untracked 2>/dev/null || true
fi
# Reset to clean latest of the current branch
local branch; branch=$(git branch --show-current 2>/dev/null || echo "main")
if git checkout "$branch" 2>/dev/null; then
git checkout . 2>/dev/null || true
git clean -fd 2>/dev/null || true
ok "Cleaned %s working tree" "$name"
fi
cd "$SCRIPT_DIR"
# Reinstall dependencies if package.json exists
if [ -f "$repo/package.json" ]; then
spinner_start "Installing deps for %s..." "$name"
if yarn install --frozen-lockfile --prefer-offline 2>/dev/null; then
spinner_stop ok
ok "Deps reinstalled for %s" "$name"
else
spinner_stop fail
warn "yarn install failed for %s — cleaning node_modules and retrying" "$name"
rm -rf "$repo/node_modules" 2>/dev/null || true
yarn install --frozen-lockfile --prefer-offline 2>/dev/null || warn "yarn install still failed for %s" "$name"
fi
fi
repaired=$((repaired + 1))
done
# Fix permissions
step 3 6 "$(_t "Set Permissions")"
fix_perms
ok "Permissions fixed"
# Sync / validate configs
step 4 6 "$(_t "Sync Configurations")"
sync_configs
# Rebuild frontend if dist is missing or empty
if [ ! -d "$NITRO_CLIENT/dist" ] || [ -z "$(ls -A "$NITRO_CLIENT/dist" 2>/dev/null)" ]; then
step 5 6 "$(_t "Rebuild Frontend")"
spinner_start "$(_t "Building frontend...")"
cd "$NITRO_CLIENT"
if yarn build >> "$LOG_FILE" 2>&1; then
spinner_stop ok
ok "Frontend rebuilt"
else
spinner_stop fail
fail "Frontend rebuild failed"
fi
cd "$SCRIPT_DIR"
else
ok "Frontend dist intact — skip rebuild"
fi
# Rebuild emulator if jar is missing
if [ ! -d "$EMULATOR_MODULE/target" ] || ! ls "$EMULATOR_MODULE"/target/Polaris-*-jar-with-dependencies.jar &>/dev/null 2>&1; then
step 6 6 "$(_t "Rebuild Emulator")"
cd "$EMULATOR_MODULE"
backup_binaries
ROLLBACK_NEEDED=true
spinner_start "$(_t "Building emulator (parallel)...")"
command -v ccache >/dev/null 2>&1 && export CC="ccache gcc" CXX="ccache g++"
if mvn package -q -T 1C -Dmaven.test.skip=true >> "$LOG_FILE" 2>&1; then
spinner_stop ok
ok "Emulator rebuilt"
else
spinner_stop fail
fail "Emulator rebuild failed"
fi
cd "$SCRIPT_DIR"
else
ok "Emulator jar intact — skip rebuild"
fi
# Restart services
do_restart
show_summary
fix_perms
release_lock
}
# =============================================================================
# SERVICES
# =============================================================================
cmd_services() {
step 1 1 "Service Manager"
echo ""
echo -e " ${C_BOLD}1)${C_RESET} $(_t "Start Emulator") ${C_BOLD}2)${C_RESET} $(_t "Stop Emulator") ${C_BOLD}3)${C_RESET} $(_t "Restart Emulator")"
echo -e " ${C_BOLD}4)${C_RESET} $(_t "Start Nginx") ${C_BOLD}5)${C_RESET} $(_t "Restart Nginx") ${C_BOLD}6)${C_RESET} $(_t "Status All")"
echo -e " ${C_BOLD}7)${C_RESET} $(_t "Emulator Logs") ${C_BOLD}8)${C_RESET} $(_t "Emulator Journal") ${C_BOLD}0)${C_RESET} $(_t "Return")"
echo -en "\n $(_t "Select:") "; local c; read -rt 30 c
case "$c" in
1) sudo systemctl start "$EMULATOR_SERVICE" && ok "Started" || fail "Failed" ;;
2) sudo systemctl stop "$EMULATOR_SERVICE" && ok "Stopped" || fail "Failed" ;;
3) sudo systemctl restart "$EMULATOR_SERVICE" && ok "Restarted" || fail "Failed" ;;
4) sudo systemctl start nginx && ok "Started" || fail "Failed" ;;
5) sudo systemctl restart nginx && ok "Restarted" || fail "Failed" ;;
6) for s in nginx mariadb redis-server "$EMULATOR_SERVICE" php-fpm cron; do
local st="${C_RED}$(_t "DOWN")${C_RESET}"; service_active "$s" && st="${C_GREEN}$(_t "UP")${C_RESET}"
printf " %-25s %b\n" "$s" "$st"
done ;;
7) sudo journalctl -u "$EMULATOR_SERVICE" --no-pager -n 30 ;;
8) sudo journalctl -u "$EMULATOR_SERVICE" --no-pager -n 100 --output=short-full ;;
esac
}
# =============================================================================
# DATABASE
# =============================================================================
cmd_database() {
step 1 1 "Database Tools"
echo ""
echo -e " ${C_BOLD}1)${C_RESET} $(_t "DB Info") ${C_BOLD}2)${C_RESET} $(_t "List Tables") ${C_BOLD}3)${C_RESET} $(_t "Table Sizes")"
echo -e " ${C_BOLD}4)${C_RESET} $(_t "Optimize") ${C_BOLD}5)${C_RESET} $(_t "Custom Query") ${C_BOLD}6)${C_RESET} $(_t "Active Users")"
echo -e " ${C_BOLD}7)${C_RESET} $(_t "Processlist") ${C_BOLD}0)${C_RESET} $(_t "Return")"
echo -en "\n $(_t "Select:") "; local c; read -rt 30 c
case "$c" in
1) box_top "DB INFO" 50
local dbs=$($MYSQL_CLIENT $MYSQL_CRED -N -e "SELECT ROUND(SUM(data_length+index_length)/1024/1024,1) FROM information_schema.tables WHERE table_schema='$DB_NAME'" "$DB_NAME" 2>/dev/null || echo "?")
box_kv "Name:" "$DB_NAME" 50; box_kv "Host:" "$DB_HOST:$DB_PORT" 50; box_kv "Size:" "${dbs}MB" 50
box_kv "Tables:" "$($MYSQL_CLIENT $MYSQL_CRED -N -e "SELECT COUNT(*) FROM information_schema.tables WHERE table_schema='$DB_NAME'" "$DB_NAME" 2>/dev/null || echo '?')" 50
box_bottom 50 ;;
2) $MYSQL_CLIENT $MYSQL_CRED -e "SHOW TABLES FROM $DB_NAME" 2>/dev/null ;;
3) $MYSQL_CLIENT $MYSQL_CRED -e "SELECT table_name AS 'Table', ROUND(data_length/1024/1024,2) AS 'Data MB', ROUND(index_length/1024/1024,2) AS 'Index MB' FROM information_schema.tables WHERE table_schema='$DB_NAME' ORDER BY (data_length+index_length) DESC" 2>/dev/null ;;
4) spinner_start "Optimizing..."
for tbl in $($MYSQL_CLIENT $MYSQL_CRED -N -e "SELECT table_name FROM information_schema.tables WHERE table_schema='$DB_NAME' AND engine='InnoDB'" "$DB_NAME" 2>/dev/null); do
$MYSQL_CLIENT $MYSQL_CRED -e "OPTIMIZE TABLE $DB_NAME.\`$tbl\`" "$DB_NAME" &>/dev/null || true
done; spinner_stop ok; ok "Optimized" ;;
5) echo -en " SQL: "; local q; read -rt 30 q; [ -n "$q" ] && $MYSQL_CLIENT $MYSQL_CRED "$DB_NAME" -e "$q" 2>/dev/null ;;
6) $MYSQL_CLIENT $MYSQL_CRED -e "SELECT name, motto FROM $DB_NAME.users WHERE online='1'" 2>/dev/null || warn "Could not query" ;;
7) $MYSQL_CLIENT $MYSQL_CRED -e "SHOW FULL PROCESSLIST" 2>/dev/null || warn "Could not query" ;;
esac
}
# =============================================================================
# CONFIG
# =============================================================================
cmd_config() {
step 1 1 "Configuration"
echo ""
box_top "CONFIGURATION" 56
box_kv "Site:" "${NITRO_SITE_URL:-?}" 56
box_kv "Branch:" "$NITRO_BRANCH" 56
box_kv "Emulator:" "$EMULATOR_DIR" 56
box_kv "Nitro-V3:" "$NITRO_CLIENT" 56
box_kv "Renderer:" "$NITRO_RENDERER" 56
box_kv "Database:" "$DB_NAME @ $DB_HOST:$DB_PORT" 56
box_kv "Service:" "$EMULATOR_SERVICE" 56
box_kv "Socket:" "${NITRO_SOCKET_URL:-?}" 56
box_kv "API:" "${NITRO_API_URL:-?}" 56
box_kv "Gamedata:" "${NITRO_GAMEDATA_URL:-?}" 56
box_kv "Min Disk:" "${MIN_DISK_GB}GB" 56
box_bottom 56; echo ""
}
# =============================================================================
# LOGS
# =============================================================================
cmd_logs() {
step 1 1 "Log Viewer"
[ ! -d "$LOG_DIR" ] && { warn "No log dir"; return; }
local logs=()
while IFS= read -r l; do logs+=("$l"); done < <(list_sorted "$LOG_DIR" 'update-*.log')
[ ${#logs[@]} -eq 0 ] && { warn "No logs"; return; }
echo ""
local i=1
for l in "${logs[@]}"; do
local sz=$(format_size "$(stat -c%s "$l" 2>/dev/null || echo 0)")
printf " ${C_GREEN}${C_BOLD}%2d)${C_RESET} %-35s ${C_DIM}%s${C_RESET}\n" "$i" "$(basename "$l")" "$sz"
i=$((i+1))
done
echo -en "\n $(_t "Select") [1-$((i-1))]: "; local c; read -rt 30 c
if [[ "$c" =~ ^[0-9]+$ ]] && [ "$c" -ge 1 ] && [ "$c" -le ${#logs[@]} ]; then
less -R "${logs[$((c-1))]}" 2>/dev/null || cat "${logs[$((c-1))]}"
fi
}
# =============================================================================
# CLEAN
# =============================================================================
cmd_clean() {
step 1 1 "Cache Cleanup"
echo ""
echo -e " ${C_BOLD}1)${C_RESET} $(_t "Yarn") ${C_BOLD}2)${C_RESET} $(_t "Next.js") ${C_BOLD}3)${C_RESET} $(_t "Redis")"
echo -e " ${C_BOLD}4)${C_RESET} $(_t "Logs") ${C_BOLD}5)${C_RESET} $(_t "Everything") ${C_BOLD}6)${C_RESET} $(_t "Docker")"
echo -e " ${C_BOLD}7)${C_RESET} $(_t "Maven") ${C_BOLD}0)${C_RESET} $(_t "Return")"
echo -en "\n $(_t "Select:") "; local c; read -rt 30 c
case "$c" in
1) yarn cache clean 2>/dev/null && ok "Yarn cleaned" ;;
2) cd "$SCRIPT_DIR" && rm -rf .next 2>/dev/null && ok "Next.js cache cleared" ;;
3) redis-cli FLUSHALL 2>/dev/null && ok "Redis flushed" || warn "Redis N/A" ;;
4) find "$EMULATOR_DIR" -name "*.log" -mtime +14 -exec rm -f {} \; 2>/dev/null; ok "Logs cleaned" ;;
5) yarn cache clean 2>/dev/null; find "$EMULATOR_DIR" -name "*.log" -mtime +14 -exec rm -f {} \; 2>/dev/null; rm -rf /tmp/nitro-* /tmp/epicnext-* 2>/dev/null; ok "Full cleanup" ;;
6) command -v docker &>/dev/null && docker system prune -f 2>/dev/null && ok "Docker pruned" || warn "Docker N/A" ;;
7) find "$EMULATOR_MODULE" -maxdepth 3 -name '*.jar' -mtime +7 -exec rm -f {} \; 2>/dev/null; ok "Old Maven artifacts cleaned" ;;
esac
}
# =============================================================================
# GIT LOG
# =============================================================================
cmd_gitlog() {
step 1 1 "Git Commit History"
echo ""
echo -e " ${C_BOLD}1)${C_RESET} $(_t "Emulator") ${C_BOLD}2)${C_RESET} $(_t "Nitro-V3") ${C_BOLD}3)${C_RESET} $(_t "Renderer")"
echo -en "\n $(_t "Select:") "; local c; read -rt 30 c
local repo=""
case "$c" in 1) repo="$EMULATOR_REPO" ;; 2) repo="$NITRO_CLIENT" ;; 3) repo="$NITRO_RENDERER" ;; *) return ;; esac
[ ! -d "$repo/.git" ] && { warn "Not a git repo"; return; }
echo ""
local branch
branch=$(cd "$repo" && git branch --show-current 2>/dev/null || echo "?")
local ahead
ahead=$(cd "$repo" && git rev-list --count "origin/${branch}"..HEAD 2>/dev/null || echo "0")
echo -e " ${C_BOLD}$(_t "Last 20 commits on") ${C_CYAN}${branch}${C_RESET} ($(_t "ahead:") ${C_RED}${ahead}${C_RESET}):"
echo ""
cd "$repo" && git log --pretty=format:" ${C_CYAN}%h${C_RESET} %C(yellow)%cr${C_RESET} %s" -20 2>/dev/null
echo -e "\n"
}
# =============================================================================
# BRANCH COMPARE
# =============================================================================
cmd_compare() {
step 1 1 "Branch Comparison"
echo ""
local branches=()
load_branches branches
[ ${#branches[@]} -lt 2 ] && { warn "Need 2+ branches (found ${#branches[@]})"; return; }
echo -e " ${C_BOLD}$(_t "Branches:")${C_RESET}"
local i=1
for b in "${branches[@]}"; do echo -e " ${C_GREEN}${C_BOLD}$i)${C_RESET} $b"; i=$((i+1)); done
echo -en "\n $(_t "Branch A:") "; local ba; read -rt 30 ba
echo -en " $(_t "Branch B:") "; local bb; read -rt 30 bb
[[ "$ba" =~ ^[0-9]+$ ]] && [[ "$bb" =~ ^[0-9]+$ ]] && [ "$ba" -ge 1 ] && [ "$bb" -ge 1 ] && [ "$ba" -le ${#branches[@]} ] && [ "$bb" -le ${#branches[@]} ] || { warn "Invalid"; return; }
local bA="${branches[$((ba-1))]}" bB="${branches[$((bb-1))]}"
echo ""
for repo in "$EMULATOR_REPO" "$NITRO_CLIENT" "$NITRO_RENDERER"; do
[ -d "$repo/.git" ] || continue
echo -e " ${C_BOLD}$(basename "$repo"):${C_RESET}"
cd "$repo" 2>/dev/null || continue
if git rev-parse --verify "$bA" &>/dev/null && git rev-parse --verify "$bB" &>/dev/null; then
local ahead=$(git rev-list --count "$bB".."$bA" 2>/dev/null || echo "0")
local behind=$(git rev-list --count "$bA".."$bB" 2>/dev/null || echo "0")
echo -e " $bA $(_t "is") ${C_GREEN}$ahead${C_RESET} $(_t "ahead,") ${C_YELLOW}$behind${C_RESET} $(_t "behind") $bB"
fi
done; echo ""
}
# =============================================================================
# CRON SCHEDULER
# =============================================================================
cmd_schedule() {
step 1 1 "Cron Scheduler"
echo ""
local cc=$(crontab -l 2>/dev/null | grep -F "$SCRIPT_NAME" || echo "")
echo -e " ${C_BOLD}$(_t "Current:")${C_RESET} ${cc:-${C_DIM}$(_t "none")${C_RESET}}"
echo ""
echo -e " ${C_BOLD}1)${C_RESET} $(_t "Daily 03:00") ${C_BOLD}2)${C_RESET} $(_t "Daily 04:00") ${C_BOLD}3)${C_RESET} $(_t "Weekly Sun 03:00")"
echo -e " ${C_BOLD}4)${C_RESET} $(_t "Custom time") ${C_BOLD}5)${C_RESET} $(_t "Remove") ${C_BOLD}0)${C_RESET} $(_t "Return")"
echo -en "\n $(_t "Select:") "; local c; read -rt 30 c
case "$c" in
1) (crontab -l 2>/dev/null | grep -vF "$SCRIPT_NAME"; echo "0 3 * * * cd $SCRIPT_DIR && ./$SCRIPT_NAME update --branch $NITRO_BRANCH >> /var/log/nitro-cron.log 2>&1") | crontab - && ok "Scheduled daily 03:00" ;;
2) (crontab -l 2>/dev/null | grep -vF "$SCRIPT_NAME"; echo "0 4 * * * cd $SCRIPT_DIR && ./$SCRIPT_NAME update --branch $NITRO_BRANCH >> /var/log/nitro-cron.log 2>&1") | crontab - && ok "Scheduled daily 04:00" ;;
3) (crontab -l 2>/dev/null | grep -vF "$SCRIPT_NAME"; echo "0 3 * * 0 cd $SCRIPT_DIR && ./$SCRIPT_NAME update --branch $NITRO_BRANCH >> /var/log/nitro-cron.log 2>&1") | crontab - && ok "Scheduled weekly" ;;
4) echo -en " $(_t "Minute") [0-59]: "; local m; read -rt 30 m
echo -en " $(_t "Hour") [0-23]: "; local h; read -rt 30 h
(crontab -l 2>/dev/null | grep -vF "$SCRIPT_NAME"; echo "$m $h * * * cd $SCRIPT_DIR && ./$SCRIPT_NAME update --branch $NITRO_BRANCH >> /var/log/nitro-cron.log 2>&1") | crontab - && ok "Scheduled $m $h * * *" ;;
5) crontab -l 2>/dev/null | grep -vF "$SCRIPT_NAME" | crontab - && ok "Removed" ;;
esac
}
# =============================================================================
# GIT STASH VIEWER
# =============================================================================
cmd_stash() {
step 1 1 "Git Stashes"
local found=false
for repo in "$EMULATOR_REPO" "$NITRO_CLIENT" "$NITRO_RENDERER"; do
[ -d "$repo/.git" ] || continue
local list
list=$(cd "$repo" && git stash list 2>/dev/null)
if [ -n "$list" ]; then
found=true
echo ""
echo -e " ${C_BOLD}$(basename "$repo"):${C_RESET}"
echo "$list" | while IFS= read -r line; do echo -e " ${C_CYAN}→${C_RESET} $line"; done
fi
done
$found || warn "No stashes found"
echo ""
}
# =============================================================================
# MAIN MENU
# =============================================================================
pick_branch_and_update() {
local mode_label="Full"
case "${SELECTIVE_UPDATE:-full}" in
emulator) mode_label="Emulator Only" ;; client) mode_label="Client Only" ;;
renderer) mode_label="Renderer Only" ;; configs) mode_label="Configs Only" ;;
dev) mode_label="Dev Mode" ;;
esac
local branches=()
load_branches branches
echo ""
echo -e " ${C_BOLD}${C_CYAN}$(_t "Update:") ${C_GREEN}$mode_label${C_RESET}"
echo ""
local i=1
for b in "${branches[@]}"; do
local m=""; [ "$b" = "$NITRO_BRANCH" ] && m=" ${C_GREEN}(current)${C_RESET}"
echo -e " ${C_GREEN}${C_BOLD}$i)${C_RESET} ${C_CYAN}$b${C_RESET}$m"
i=$((i+1))
done
echo -e " ${C_GREEN}${C_BOLD}$i)${C_RESET} $(_t "Custom")"
echo -en "\n $(_t "Branch") [1-$i]: "
local bc; read -rt 30 bc
if [[ "$bc" =~ ^[0-9]+$ ]] && [ "$bc" -ge 1 ] && [ "$bc" -lt "$i" ]; then
NITRO_BRANCH="${branches[$((bc-1))]}"
elif [ "$bc" = "$i" ]; then
echo -en " $(_t "Name:") "; read -rt 30 NITRO_BRANCH; [ -z "$NITRO_BRANCH" ] && NITRO_BRANCH="main"
else
warn "Invalid, using: %s" "$NITRO_BRANCH"
fi
echo -e "\n $(_t "Branch:") ${C_CYAN}${C_BOLD}$NITRO_BRANCH${C_RESET} $(_t "Mode:") ${C_GREEN}$mode_label${C_RESET}"
if ! confirm "Start update?"; then info "Cancelled"; return; fi
cmd_update
}
cmd_interactive() {
local branches=()
load_branches branches
while true; do
clear
echo -e "${C_CYAN}"
echo ""
echo " ╔═══════════════════════════════════════════════════════════════════════════╗"
echo " ║ ║"
echo " ║ ███████╗███╗ ███╗ █████╗ ██████╗ ████████╗ ║"
echo " ║ ██╔════╝████╗ ████║██╔══██╗██╔══██╗╚══██╔══╝ ║"
echo " ║ █████╗ ██╔████╔██║███████║██████╔╝ ██║ ║"
echo " ║ ██╔══╝ ██║╚██╔╝██║██╔══██║██╔══██╗ ██║ ║"
echo " ║ ███████╗██║ ╚═╝ ██║██║ ██║██║ ██║ ██║ ║"
echo " ║ ╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝ ║"
echo " ║ ║"
echo " ╠═══════════════════════════════════════════════════════════════════════════╣"
echo -e " ║ ${C_GOLD}${C_BOLD} SMaRT v${SCRIPT_VERSION} — Emulator / Nitro-V3 / Nitro-V3-Render${C_CYAN} ║"
echo -e " ║ ${C_WHITE}${C_BOLD} Updater & Manager by Remco — epicnabbo.nl${C_CYAN} ║"
echo " ╠═══════════════════════════════════════════════════════════════════════════╣"
echo -e " ║ ${C_DIM}$(_t "Branch:") ${C_CYAN}${NITRO_BRANCH}${C_DIM} (${#branches[@]} $(_t "branches")) │ $(date '+%H:%M')${C_CYAN} ║"
echo " ╚═══════════════════════════════════════════════════════════════════════════╝"
echo -e "${C_RESET}"
echo -e " ${C_BG_GREEN}${C_WHITE}${C_BOLD} $(_t "UPDATE") ${C_RESET}"
echo -e " ${C_GREEN}${C_BOLD}1)${C_RESET} ${E_ROCKET} $(_t "Quick Update — current branch")"
echo -e " ${C_GREEN}${C_BOLD}2)${C_RESET} ${E_BOLT} $(_t "Full Update (choose branch)")"
echo -e " ${C_GREEN}${C_BOLD}3)${C_RESET} ${E_GEAR} $(_t "Emulator Only")"
echo -e " ${C_GREEN}${C_BOLD}4)${C_RESET} ${E_GEAR} $(_t "Nitro-V3 Client Only")"
echo -e " ${C_GREEN}${C_BOLD}5)${C_RESET} ${E_GEAR} $(_t "Renderer Only")"
echo -e " ${C_GREEN}${C_BOLD}6)${C_RESET} ${E_GEAR} $(_t "Configs Only")"
echo -e " ${C_GREEN}${C_BOLD}19)${C_RESET} ${E_BOLT} $(_t "Dev Mode (skip builds, only configs)")"
echo ""
echo -e " ${C_BG_MAGENTA}${C_WHITE}${C_BOLD} $(_t "TOOLS") ${C_RESET}"
echo -e " ${C_MAGENTA}${C_BOLD}7)${C_RESET} ${E_GIT} $(_t "Switch Branch")"
echo -e " ${C_YELLOW}${C_BOLD}8)${C_RESET} ${E_DB} $(_t "Database")"
echo -e " ${C_YELLOW}${C_BOLD}9)${C_RESET} ${E_SHIELD} $(_t "Backup / Restore")"
echo -e " ${C_YELLOW}${C_BOLD}10)${C_RESET} ${E_WRENCH} $(_t "Services")"
echo -e " ${C_YELLOW}${C_BOLD}11)${C_RESET} ${E_CHART} $(_t "Status")"
echo -e " ${C_YELLOW}${C_BOLD}12)${C_RESET} ${E_HEART} $(_t "Health Check")"
echo -e " ${C_YELLOW}${C_BOLD}13)${C_RESET} ${E_BROOM} $(_t "Clean")"
echo -e " ${C_YELLOW}${C_BOLD}14)${C_RESET} ${E_EYE} $(_t "Logs")"
echo -e " ${C_YELLOW}${C_BOLD}15)${C_RESET} ${E_GEAR} $(_t "Config")"
echo ""
echo -e " ${C_BG_BLUE}${C_WHITE}${C_BOLD} $(_t "ADVANCED") ${C_RESET}"
echo -e " ${C_BLUE}${C_BOLD}16)${C_RESET} ${E_CONSOLE} $(_t "Git Log")"
echo -e " ${C_BLUE}${C_BOLD}17)${C_RESET} ${E_GLOBE} $(_t "Compare Branches")"
echo -e " ${C_BLUE}${C_BOLD}18)${C_RESET} ${E_CLOCK} $(_t "Cron Scheduler")"
echo -e " ${C_BLUE}${C_BOLD}20)${C_RESET} ${E_GIT} $(_t "View Git Stashes")"
echo -e " ${C_RED}${C_BOLD}21)${C_RESET} ${E_WRENCH} $(_t "Flyaway Repair")"
echo ""
echo -e " ${C_RED}${C_BOLD}0)${C_RESET} $(_t "Exit")"
echo ""
echo -en " ${C_CYAN}${C_BOLD}$(_t "Select [0-21]")${C_RESET}: "
local choice; read -rt 30 choice
case "$choice" in
1) SELECTIVE_UPDATE=""; (cmd_update) || warn "Update had errors" ;;
2) SELECTIVE_UPDATE=""; (pick_branch_and_update) || warn "Update had errors" ;;
3) SELECTIVE_UPDATE="emulator"; (pick_branch_and_update) || warn "Update had errors" ;;
4) SELECTIVE_UPDATE="client"; (pick_branch_and_update) || warn "Update had errors" ;;
5) SELECTIVE_UPDATE="renderer"; (pick_branch_and_update) || warn "Update had errors" ;;
6) SELECTIVE_UPDATE="configs"; (pick_branch_and_update) || warn "Update had errors" ;;
7)
echo ""
local i=1
for b in "${branches[@]}"; do
local m=""; [ "$b" = "$NITRO_BRANCH" ] && m=" ${C_GREEN}*${C_RESET}"
echo -e " ${C_GREEN}${C_BOLD}$i)${C_RESET} $b$m"; i=$((i+1))
done
echo -e " ${C_GREEN}${C_BOLD}$i)${C_RESET} $(_t "Custom")"
echo -en "\n $(_t "Branch") [1-$i]: "; local bc; read -rt 30 bc
if [[ "$bc" =~ ^[0-9]+$ ]] && [ "$bc" -ge 1 ] && [ "$bc" -lt "$i" ]; then
NITRO_BRANCH="${branches[$((bc-1))]}"
elif [ "$bc" = "$i" ]; then echo -en " $(_t "Name:") "; read -rt 30 NITRO_BRANCH
fi
load_branches branches
ok "Branch: %s" "$NITRO_BRANCH" ;;
8) (cmd_database) ;;
9) (cmd_backup); echo ""; (cmd_backups) ;;
10) (cmd_services) ;;
11) (cmd_status) ;;
12) (cmd_health) ;;
13) (cmd_clean) ;;
14) (cmd_logs) ;;
15) (cmd_config) ;;
16) (cmd_gitlog) ;;
17) (cmd_compare) ;;
18) (cmd_schedule) ;;
19) SELECTIVE_UPDATE="dev"; (pick_branch_and_update) || warn "Dev mode had errors" ;;
20) (cmd_stash) ;;
21) (cmd_flyaway_repair) ;;
0|q|Q) echo -e "\n ${C_GREEN}$(_t "Goodbye!")${C_RESET}"; cursor_show; exit 0 ;;
*) warn "Invalid selection" ;;
esac
echo ""
echo -en " ${C_DIM}$(_t "Press Enter to continue...")${C_RESET}"
read -rt 30
done
}
# =============================================================================
# HELP
# =============================================================================
show_help() {
echo ""
echo -e " ${C_GOLD}${C_BOLD}$(_t "SMaRT — Emulator / Nitro-V3 / Nitro-V3-Render Updater & Manager")${C_RESET}"
echo -e " ${C_DIM}by Remco — epicnabbo.nl v${SCRIPT_VERSION} (build ${SCRIPT_BUILD})${C_RESET}"
echo ""
echo -e " ${C_BOLD}$(_t "USAGE:")${C_RESET} $SCRIPT_NAME <command> [options]"
echo ""
echo -e " ${C_BOLD}$(_t "COMMANDS:")${C_RESET}"
echo -e " ${C_GREEN}interactive${C_RESET} $(_t "Open menu (default)")"
echo -e " ${C_GREEN}update${C_RESET} $(_t "Run update")"
echo -e " ${C_GREEN}backup${C_RESET} $(_t "Create database backup")"
echo -e " ${C_GREEN}restore${C_RESET} $(_t "Restore from backup")"
echo -e " ${C_GREEN}backups${C_RESET} $(_t "List backups")"
echo -e " ${C_GREEN}status${C_RESET} $(_t "System dashboard")"
echo -e " ${C_GREEN}health${C_RESET} $(_t "Health check")"
echo -e " ${C_GREEN}services${C_RESET} $(_t "Service manager")"
echo -e " ${C_GREEN}database${C_RESET} $(_t "Database tools")"
echo -e " ${C_GREEN}config${C_RESET} $(_t "Show config")"
echo -e " ${C_GREEN}logs${C_RESET} $(_t "View logs")"
echo -e " ${C_GREEN}clean${C_RESET} $(_t "Cache cleanup")"
echo -e " ${C_GREEN}gitlog${C_RESET} $(_t "Git history")"
echo -e " ${C_GREEN}compare${C_RESET} $(_t "Branch diff")"
echo -e " ${C_GREEN}schedule${C_RESET} $(_t "Cron setup")"
echo -e " ${C_GREEN}stash${C_RESET} $(_t "View git stashes")"
echo -e " ${C_GREEN}repair${C_RESET} $(_t "Flyaway Repair")"
echo ""
echo -e " ${C_BOLD}$(_t "OPTIONS:")${C_RESET}"
echo -e " ${C_CYAN}--branch, -b${C_RESET} $(_t "Branch (auto-detects)")"
echo -e " ${C_CYAN}--url, -u${C_RESET} $(_t "Site URL")"
echo -e " ${C_CYAN}--only=${C_RESET} $(_t "emulator|client|renderer|configs|dev")"
echo -e " ${C_CYAN}--dry-run, -n${C_RESET} $(_t "Preview only (no changes)")"
echo -e " ${C_CYAN}--help, -h${C_RESET} $(_t "Show this help")"
echo -e " ${C_CYAN}--version, -V${C_RESET} $(_t "Show version")"
echo ""
}
# =============================================================================
# MAIN
# =============================================================================
main() {
load_language
local cmd=""
while [ $# -gt 0 ]; do
case "$1" in
update|up) cmd="update" ;;
interactive|menu|ui) cmd="interactive" ;;
status|st) cmd="status" ;;
health|check) cmd="health" ;;
backup|bk) cmd="backup" ;;
restore|rs) cmd="restore" ;;
backups|bl) cmd="backups" ;;
gitlog|gl) cmd="gitlog" ;;
compare|diff) cmd="compare" ;;
schedule|cron) cmd="schedule" ;;
services|svc) cmd="services" ;;
database|db) cmd="database" ;;
config|cfg) cmd="config" ;;
logs|log) cmd="logs" ;;
clean|cl) cmd="clean" ;;
stash|stashes) cmd="stash" ;;
repair|flyaway) cmd="repair" ;;
help|-h|--help) cmd="help" ;;
version|-V|--version) echo "v${SCRIPT_VERSION} (build ${SCRIPT_BUILD})"; exit 0 ;;
--branch|-b) shift; NITRO_BRANCH="$1" ;;
--url|-u) shift; NITRO_SITE_URL="$1" ;;
--only=*) SELECTIVE_UPDATE="${1#*=}" ;;
--dry-run|-n) DRY_RUN=true ;;
-*) echo "$(_t "Unknown:") $1"; exit 1 ;;
*) [ -z "$cmd" ] && cmd="interactive" ;;
esac
shift
done
[ -z "$cmd" ] && cmd="interactive"
# Auto-detect the branch from the emulator repo when none was configured,
# so "Quick Update — current branch" actually updates the current branch.
if [ -z "${NITRO_BRANCH:-}" ]; then
NITRO_BRANCH="$(cd "$EMULATOR_REPO" 2>/dev/null && git branch --show-current 2>/dev/null || echo "main")"
[ -z "$NITRO_BRANCH" ] && NITRO_BRANCH="main"
info "Auto-detected branch: %s" "$NITRO_BRANCH"
fi
if [ -z "${NITRO_SITE_URL:-}" ] && [ -n "${APP_URL:-}" ]; then NITRO_SITE_URL="$APP_URL"; fi
case "${NITRO_SITE_URL:-}" in
https://*) NITRO_WS_PROTO="wss://" ; NITRO_DOMAIN="${NITRO_SITE_URL#https://}" ;;
http://*) NITRO_WS_PROTO="ws://" ; NITRO_DOMAIN="${NITRO_SITE_URL#http://}" ;;
*) NITRO_WS_PROTO="wss://" ; NITRO_DOMAIN="${NITRO_SITE_URL:-}" ;;
esac
NITRO_IMAGE_LIBRARY_URL="${NITRO_IMAGE_LIBRARY_URL:-${NITRO_SITE_URL:-}/gamedata/c_images/}"
NITRO_HOF_FURNITURE_URL="${NITRO_HOF_FURNITURE_URL:-${NITRO_SITE_URL:-}/gamedata/icons}"
NITRO_API_URL="${NITRO_API_URL:-${NITRO_SITE_URL:-}}"
NITRO_SOCKET_URL="${NITRO_SOCKET_URL:-${NITRO_WS_PROTO}ws.${NITRO_DOMAIN}}"
NITRO_GAMEDATA_URL="${NITRO_GAMEDATA_URL:-${NITRO_SITE_URL:-}/gamedata}"
NITRO_ASSET_URL="${NITRO_ASSET_URL:-${NITRO_SITE_URL:-}/gamedata/bundled}"
NITRO_FURNI_ASSET_ICON_URL="${NITRO_FURNI_ASSET_ICON_URL:-${NITRO_SITE_URL:-}/gamedata/icons/%libname%%param%_icon.png}"
# Validate computed URLs for common misconfigurations.
_nitro_url_warn() {
local _key="$1" _val="$2" _hint="$3"
case "$_val" in
"") warn "$_key not set ($_hint)" ;;
*/nitro-client/*|*/nitro-client) fail "$_key points at the Nitro client path. It must point to the gamedata/c_images directory." ;;
*://*/nitro-client/) fail "$_key points at the Nitro client URL. Set NITRO_IMAGE_LIBRARY_URL=/gamedata/c_images/ or correct NITRO_SITE_URL." ;;
esac
case "$_key" in
NITRO_IMAGE_LIBRARY_URL)
case "$_val" in
*/c_images/) ok "$_key correctly includes /c_images/" ;;
*://*) warn "$_key does not end with /c_images/ — current: $_val" ;;
esac ;;
esac
}
_nitro_url_warn "NITRO_SITE_URL" "$NITRO_SITE_URL" "site URL"
_nitro_url_warn "NITRO_IMAGE_LIBRARY_URL" "$NITRO_IMAGE_LIBRARY_URL" "image library URL"
_nitro_url_warn "NITRO_GAMEDATA_URL" "$NITRO_GAMEDATA_URL" "gamedata URL"
exec > >(tee -a "$LOG_FILE") 2>&1
case "$cmd" in
interactive) cmd_interactive ;;
update) cmd_update ;;
backup) cmd_backup ;;
restore) cmd_restore ;;
backups) cmd_backups ;;
status) cmd_status ;;
health) cmd_health ;;
services) cmd_services ;;
database) cmd_database ;;
config) cmd_config ;;
logs) cmd_logs ;;
clean) cmd_clean ;;
gitlog) cmd_gitlog ;;
compare) cmd_compare ;;
schedule) cmd_schedule ;;
stash) cmd_stash ;;
repair) cmd_flyaway_repair ;;
help) show_help ;;
esac
cursor_show
}
main "$@"