From a67294aecda74be93599afda734b654e0163b6b7 Mon Sep 17 00:00:00 2001
From: Deckard <uprightbass360@gmail.com>
Date: Sun, 19 Oct 2025 20:29:59 -0400
Subject: [PATCH] backup import/export docs

---
 README.md                                 | 15 +++++++++++++++
 export-user-backup.sh => backup-export.sh |  2 +-
 import-user-backup.sh => backup-import.sh |  2 +-
 3 files changed, 17 insertions(+), 2 deletions(-)
 rename export-user-backup.sh => backup-export.sh (96%)
 rename import-user-backup.sh => backup-import.sh (98%)

diff --git a/README.md b/README.md
index d20267a..e093cd8 100644
--- a/README.md
+++ b/README.md
@@ -310,6 +310,10 @@ docker exec -it ac-mysql mysql -u root -p
 ./scripts/backup.sh                              # Create immediate backup
 ./scripts/restore.sh YYYYMMDD_HHMMSS            # Restore from specific backup
 
+# User data backup/import utilities
+./backup-export.sh [output_dir]                 # Export user accounts & characters
+./backup-import.sh [backup_dir]                 # Import user data from backup
+
 # View available backups
 ls -la storage/backups/
 ```
@@ -467,6 +471,17 @@ storage/backups/
         ├── acore_auth.sql.gz
         ├── acore_characters.sql.gz
         └── acore_world.sql.gz
+
+# User data import/export
+ExportBackup_YYYYMMDD_HHMMSS/     # Created by backup-export.sh
+├── acore_auth.sql.gz             # User accounts
+├── acore_characters.sql.gz       # Character data
+└── manifest.json
+
+ImportBackup/                     # Used by backup-import.sh
+├── acore_auth.sql[.gz]           # Required: accounts
+├── acore_characters.sql[.gz]     # Required: characters
+└── acore_world.sql[.gz]          # Optional: world data
 ```
 
 ---
diff --git a/export-user-backup.sh b/backup-export.sh
similarity index 96%
rename from export-user-backup.sh
rename to backup-export.sh
index 81d87f6..989f830 100755
--- a/export-user-backup.sh
+++ b/backup-export.sh
@@ -8,7 +8,7 @@ DB_CHAR="${DB_CHARACTERS_NAME:-acore_characters}"
 
 usage(){
   cat <<EOF
-Usage: ./export-user-backup.sh [output_dir]
+Usage: ./backup-export.sh [output_dir]
 
 Creates a timestamped backup of the auth and character databases.
 If output_dir is provided, places the timestamped folder inside it
diff --git a/import-user-backup.sh b/backup-import.sh
similarity index 98%
rename from import-user-backup.sh
rename to backup-import.sh
index 87e8fb8..a4a6153 100755
--- a/import-user-backup.sh
+++ b/backup-import.sh
@@ -15,7 +15,7 @@ COLOR_RESET='\033[0m'
 
 usage(){
   cat <<EOF
-Usage: ./import-user-backup.sh [backup_dir]
+Usage: ./backup-import.sh [backup_dir]
 
 Restores user accounts and characters from a backup folder.