From 481b6e407935623d73caee71dc3afac3498abebb Mon Sep 17 00:00:00 2001
From: Denis Ranneft <denis@ranneft.ru>
Date: Mon, 30 Mar 2026 01:05:34 +0200
Subject: [PATCH] Update 'scripts/admin.sh'

---
 scripts/admin.sh | 55 +++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 54 insertions(+), 1 deletion(-)

diff --git a/scripts/admin.sh b/scripts/admin.sh
index 79383e7..2765b77 100644
--- a/scripts/admin.sh
+++ b/scripts/admin.sh
@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-COMMAND="${1:-}"
+COMMAND="${1:-help}"
 
 HERO_ID=""
 TOWN_ID=""
@@ -18,6 +18,55 @@ PASSWORD="${ADMIN_BASIC_AUTH_PASSWORD:-}"
 
 shift || true
 
+show_help() {
+  cat <<EOF
+Usage:
+  ./admin.sh <command> [options]
+
+Commands:
+  info
+  heroes                [--limit N --offset N]
+  hero                  --hero-id ID
+  set-level             --hero-id ID --level N
+  set-gold              --hero-id ID --gold N
+  set-hp                --hero-id ID --hp N
+  revive                --hero-id ID
+  reset                 --hero-id ID
+  reset-buffs           --hero-id ID
+  add-potions           --hero-id ID --n N
+  delete                --hero-id ID
+  engine-status
+  engine-combats
+  ws-connections
+  towns
+  start-adventure       --hero-id ID
+  teleport-town         --hero-id ID --town-id ID
+  start-rest            --hero-id ID
+  time-pause
+  time-resume
+
+Options:
+  --hero-id ID
+  --town-id ID
+  --level N
+  --gold N
+  --hp N
+  --limit N (default: 20)
+  --offset N (default: 0)
+  --n N
+
+Env:
+  ADMIN_BASE_URL
+  ADMIN_BASIC_AUTH_USERNAME
+  ADMIN_BASIC_AUTH_PASSWORD
+
+Examples:
+  ./admin.sh heroes --limit 50
+  ./admin.sh hero --hero-id 123
+  ./admin.sh set-level --hero-id 123 --level 10
+EOF
+}
+
 # --- parse args ---
 while [[ $# -gt 0 ]]; do
   case "$1" in
@@ -71,6 +120,9 @@ request() {
 }
 
 case "$COMMAND" in
+  help)
+    show_help
+    ;;
   info)
     request GET "/admin/info"
     ;;
@@ -175,6 +227,7 @@ case "$COMMAND" in
 
   *)
     echo "Unsupported command: $COMMAND"
+    show_help
     exit 1
     ;;
 esac
\ No newline at end of file