bug fix/install scripts

SCRIPTS/update/UPDATE_GUIDE.md

@@ -0,0 +1,104 @@
+# Update Scripts Guide
+
+Simple scripts to update your OC Bot installation with the latest code and fixes from GitHub.
+
+## What Was Fixed Recently
+
+### 1. **database.py** - SQL Syntax Errors
+- Added backticks around reserved SQL keywords (`trigger`, `characters`)
+- Fixed all database queries to work with MariaDB 10.5+
+- Maintains cached trigger lookups for performance
+
+### 2. **cogs/help.py** - Command Conflict Fix
+- Fixed conflict with discord.py's built-in help command
+- Help command now works as `,help` without errors
+- Support for `,help <topic>` still works
+
+### 3. **requirements.txt** - Python 3.13 Support
+- Updated discord.py to >=2.5.0 for Python 3.13 compatibility
+- Fixed `audioop` module error
+- All dependencies now verified working
+
+## Usage
+
+### Linux / macOS
+
+```bash
+bash update.sh
+```
+
+The script will:
+- ✅ Check for Git repository
+- ✅ Fetch latest changes from GitHub
+- ✅ Pull code updates
+- ✅ Create/activate virtual environment
+- ✅ Upgrade pip
+- ✅ Install/update all dependencies
+- ✅ Show warnings if database changes needed
+
+### Windows
+
+```bash
+update.bat
+```
+
+Same process as Linux, but Windows-compatible.
+
+## Features
+
+- **Smart Detection**: Only updates dependencies if requirements.txt changed
+- **Change Tracking**: Shows which files were modified
+- **Safety Checks**: Warns about database changes
+- **Error Handling**: Reports any failures immediately
+- **Restart Guidance**: Tells you when to restart the bot
+
+## If You Get Database Errors
+
+After updating, if you see SQL errors, recreate the database:
+
+```sql
+DROP DATABASE rp_bot;
+CREATE DATABASE rp_bot;
+```
+
+The bot will automatically recreate tables with the correct schema.
+
+## Manual Update Steps
+
+If the scripts don't work, do this manually:
+
+```bash
+# 1. Pull latest code
+git pull origin main
+
+# 2. Activate virtual environment
+source venv/bin/activate  # Linux/Mac
+# or
+venv\Scripts\activate.bat  # Windows
+
+# 3. Install dependencies
+pip install --upgrade -r requirements.txt
+
+# 4. Restart bot
+python3 bot.py
+```
+
+## Recent Changes Summary
+
+| File | Change | Impact |
+|------|--------|--------|
+| database.py | Fixed SQL syntax for reserved keywords | Database operations now work on MariaDB |
+| cogs/help.py | Removed command conflict | Help command now loads without errors |
+| requirements.txt | Updated discord.py to 2.5.0+ | Python 3.13 compatibility |
+
+## Support
+
+If updates fail:
+1. Check Git is installed: `git --version`
+2. Check Python version: `python3 --version` (need 3.11+)
+3. Check MySQL/MariaDB is running
+4. Try manual update steps above
+
+---
+
+**Coded by Ball Studios 🎨**