karma plugin added. various debug fixes to funguy.py

README.md

@@ -733,6 +733,53 @@ Fetches current time information for locations using the TimeAPI.io service.
 !time New York
 ```
 
+### Karma Tracking System
+
+**☯ !karma [user]**
+Track karma points for users with leaderboards and statistics. Supports display names and Matrix IDs.
+
+**Features:**
+- Give/take karma points from users using display names or Matrix IDs
+- Track karma history with timestamps
+- View karma leaderboards (top/bottom)
+- Rate limiting to prevent spam
+- Room-specific karma tracking
+
+**Commands:**
+- `!karma <user>` - Show karma for a user
+- `!karma++ <user>` - Give +1 karma to a user
+- `!karma-- <user>` - Give -1 karma to a user
+- `!karma top [n]` - Show top karma entries
+- `!karma bottom [n]` - Show bottom karma entries
+- `!karma rank <user>` - Show rank of user
+- `!karma stats` - Show overall statistics
+- `!karma history <user>` - Show recent karma history
+
+**Shortcuts:**
+- `!++ <user>` - Same as `!karma++ <user>`
+- `!-- <user>` - Same as `!karma-- <user>`
+- `<user>++` - Give +1 karma (inline)
+- `<user>--` - Give -1 karma (inline)
+
+**Examples:**
+```bash
+!karma @user:server.com
+!karma++ @user:server.com
+!karma top 5
+!karma bottom 3
+!karma rank @user:server.com
+!karma stats
+!karma history @user:server.com
+```
+
+**Notes:**
+- You cannot modify your own karma
+- There is a 5 second cooldown between votes
+- Karma is tracked separately per room
+- Display names with emojis are supported
+
+### Dependencies
+
 - Ensure all environment variables are set correctly
 - Check that required services are running (Stable Diffusion API, Ollama, etc.)
 - Verify plugin permissions and whitelist settings