Auto-sync: 20260113-015009

MINECRAFT.md

@@ -455,6 +455,58 @@ ssh docker-host2 'tail -f ~/crafty/data/servers/hutworld/logs/latest.log'
 
 ## Troubleshooting
 
+### Plugin Permission Issues (IMPORTANT)
+
+**Root Cause**: Crafty Docker container requires all files to be owned by `<user>:root` (not `<user>:<user>`) for permissions to work correctly.
+
+**Permanent Fix**:
+```bash
+# Fix all permissions immediately
+ssh docker-host2 'sudo chown -R hutson:root ~/crafty/data/servers/ && \
+  sudo find ~/crafty/data/servers/ -type d -exec chmod 2775 {} \; && \
+  sudo find ~/crafty/data/servers/ -type f -exec chmod 664 {} \;'
+```
+
+**Prevention**:
+1. **Always upload plugins through Crafty web UI** - this ensures correct permissions
+2. **Or use the import directory**: Copy to `~/crafty/data/import/` then restart container
+3. **Never directly copy files** to the servers directory
+
+**Check for permission issues**:
+```bash
+# Use the permission check script (recommended)
+ssh docker-host2 '~/check-crafty-permissions.sh'
+
+# Or manually check for wrong group ownership
+ssh docker-host2 'find ~/crafty/data/servers -type f ! -group root -ls'
+ssh docker-host2 'find ~/crafty/data/servers -type d ! -group root -ls'
+```
+
+**Permission Check Script**: Located at `~/check-crafty-permissions.sh` on docker-host2
+- Automatically detects permission issues
+- Offers to fix them with one command
+- Ignores temporary files that are expected to have different permissions
+
+### Crafty Shows Server Offline or "Another Instance Running"
+
+**Cause**: This happens when the server was started manually (not through Crafty) or when Crafty loses track of the server process.
+
+**Fix**:
+```bash
+# 1. Kill any orphaned server processes
+ssh docker-host2 'docker exec crafty pkill -f "paper.jar"'
+
+# 2. Restart Crafty container to clear state
+ssh docker-host2 'cd ~/crafty && docker compose restart'
+
+# 3. Wait 30-60 seconds - Crafty will auto-start the server
+```
+
+**Prevention**:
+- Always use Crafty web UI to start/stop servers
+- Never manually start the server with java command
+- If you must restart, use the container restart method above
+
 ### Server won't start
 
 ```bash