FAQ & Troubleshooting

◈ FAQ & Troubleshooting

Find answers to common questions and solutions for issues you might encounter while using or hosting WordSeek.

---

◈ General FAQ

▪ How many daily puzzles are there?

There is one unique word per day, globally synchronized. A new puzzle unlocks every day at 06:00 (based on your TIME_ZONE setting).

▪ Can I play normal WordSeek and Daily at the same time?

In a Private Chat, you can only have one active game mode. If Daily is active, you must use /pausedaily to play normal games.

▪ Why is the bot not responding in my group?

1. Ensure the bot is an Administrator in the group.
2. Ensure the bot has permission to Read Messages.
3. If it's a Forum group, check if a game topic has been set via /setgametopic.

---

◈ Troubleshooting (For Hosts)

▪ Database Connection Error

• Issue: Error: connect ECONNREFUSED
• Solution: Check if your PostgreSQL service is running and the DATABASE_URL in your .env file is correct. Ensure the database user has the necessary permissions.

▪ Redis Connection Error

• Issue: Error: Redis connection to 127.0.0.1:6379 failed
• Solution: Ensure your Redis server is running. If you are using an external Redis provider, verify the REDIS_URI including the password.

▪ Bot Token Invalid

• Issue: 401: Unauthorized
• Solution: Your BOT_TOKEN is incorrect. Double-check the value provided by @BotFather.

▪ Migrations Failing

• Issue: Errors during bun run db:migrate
• Solution: Ensure your database exists and you have provided the correct schema permissions. Check if there are conflicting migrations in the migrations/ folder.

---

◈ Getting More Help

If your issue isn't covered here: ▸ Join our Discussion Group.
▸ Open a GitHub Issue with logs and steps to reproduce.

---

Maintained by the WordSeek Community.