Admin & Moderation

◈ Admin & Moderation

WordSeek provides robust tools for group administrators and bot owners to manage games, prevent cheating, and ensure a smooth experience for all players.

---

◈ Group Administration

▪ Authorized Users (/seekauth)

By default, the /end command requires a majority vote from players. Admins can authorize specific users to end games instantly.

• Authorize: Reply to a user with /seekauth or use /seekauth @username.
• Remove: /seekauth remove @username.
• List: /seekauth list — View all authorized users in the current group.

▪ Forum & Topic Management

For groups using Telegram Forums:

• Restricting Games: Use /setgametopic inside a topic to make it the dedicated game area.
• Filtering Lengths: Use /allowonlylen 4 5 6 to restrict which word lengths are allowed in a specific topic.
• Auto-Recreation: Use /recreatetopic on to have the bot automatically recreate the topic if it expires or is deleted (if the bot has permission).

---

◈ Bot Ownership (Global Admin)

Users listed in the ADMIN_USERS environment variable have global privileges:

▪ Global Moderation

• Banning: /ban <user_id> — Prevents a user from interacting with the bot in any chat. Use /unban to reverse.
• Captcha: /captcha <chat_id> <user_id> — Forces a user to solve a visual captcha. Useful for suspected bot/macro users.
• Tracking: /track <chat_id> — Monitor messages in a specific chat to detect suspicious behavior.

▪ System Management

• Statistics: /stats — Real-time bot performance, active game counts, and server load.
• Broadcasting: Send a message to every user/group that has used the bot. Reply to a message with /broadcast.
• User Support: /transfer <old_id> <new_id> — Merge or move a user's scores and streaks to a new Telegram ID.

---

◈ Security Best Practices

▸ Restrict Admin Access: Only add trusted IDs to ADMIN_USERS.
▸ Topic Permissions: Ensure the bot has "Manage Topics" permission in Forum groups.
▸ Log Tracking: Monitor your LOGS_CHANNEL (if configured) for errors or suspicious activity.

---

Next: For a full list of commands, see the Commands Reference.