https://github.com/vero-code/skill-seeker
SkillSeeker is an epic, multiplayer challenge where you recruit your team of professionals, take quests, and compete for leaderboard glory — all inside a Reddit thread! 🤝💥 It's a fast-paced, community-driven game that turns Reddit into a thrilling, interactive experience. Join, compete, and conquer — because every professional has a role to play.
https://github.com/vero-code/skill-seeker
challenge collaboration devvit game gamification hackathon interactive leaderboard multiplayer nodejs npm open-source professionals quiz-game real-time reddit social-games team-building typescript vscode
Last synced: 3 months ago
JSON representation
SkillSeeker is an epic, multiplayer challenge where you recruit your team of professionals, take quests, and compete for leaderboard glory — all inside a Reddit thread! 🤝💥 It's a fast-paced, community-driven game that turns Reddit into a thrilling, interactive experience. Join, compete, and conquer — because every professional has a role to play.
- Host: GitHub
- URL: https://github.com/vero-code/skill-seeker
- Owner: vero-code
- License: mit
- Created: 2025-03-04T13:12:36.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-03-27T14:42:59.000Z (7 months ago)
- Last Synced: 2025-06-05T06:56:37.809Z (4 months ago)
- Topics: challenge, collaboration, devvit, game, gamification, hackathon, interactive, leaderboard, multiplayer, nodejs, npm, open-source, professionals, quiz-game, real-time, reddit, social-games, team-building, typescript, vscode
- Language: TypeScript
- Homepage: https://devpost.com/software/skill-seeker
- Size: 12.6 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🔮 Skill Seeker
Welcome to **Skill Seeker** — a community multiplayer game that turns your Reddit post into a wild professional quest! Recruit your crew, take on challenges, and climb the leaderboard — all from inside a Reddit thread. This project was built for **[Hack Reddit 2025](https://devpost.com/software/skill-seeker)** to showcase the power of real-time multiplayer experiences using Devvit.
## 🎯 Mission
Become part of a **secret society** of professionals. Each mission requires a team of experts: doctor, astronomer, sysadmin, and more. 🕵️♂️💼 Assemble your crew. Answer the right questions. **Win as a team**. 🏆 Get a point as an **individual professional**, and show others your **professionalism** on the leaderboard. 🎯
## 💡 Game Highlights
- ✨ **Assemble a team & face the challenge** — all questions are synced in real-time via Devvit channels.
- 👥 **Comment-based team joining** — just reply with `!join` command.
- 📩 **Invite teammates directly** — use the built-in invite form to bring others into the game.
- ⚡ **Live role validation** — only the right player can answer.
- 🔁 **Restart anytime** — reshuffle your team and try again.
- 📈 **Leaderboard powered by Redis** — top players score big.
- 🎲 **35 total questions and professions** — but only 5 are randomly selected per game.
No one knows in advance which specialists will be needed — assemble wisely!
Each team must have exactly **5 players** to begin the challenge.
## 🕹️ How to Play
1. 🔁 Start a new game from the post.
2. 👥 Users join the team via comment: `!join [profession]`
3. 🤝 When all roles are filled, hit **Continue**.
4. 🎓 Answer questions only if it’s your role’s turn.
5. 🏆 Beat the final challenge to score a point on the leaderboard!
## 💬 Example Join
`!join programmer`
⚡ Will fill the "programmer" slot if it’s available.
## 🧪 Example Flow
1. User A clicks **Go to Team ➡️**
2. Game generates 5 questions and 5 specialists (broadcasted)
3. User B joins with `!join painter`
4. Game shows team status: `PAINTER - userB`
5. Once all filled → start challenge
6. Each user takes their turn answering
7. Victory? Leaderboard +1 point!
Failure? Try again.
## 🧠 Pro Tips
- Only the assigned role can **answer**!
- You can **invite** users via the built-in invite form
- Use **restart** to regenerate roles & questions
## 📋 Requirements
- A Reddit post to host the game
- Devvit app setup and installed on your subreddit
- Users with Reddit accounts (no login required in-game)
## 📦 Tech Stack
- **Devvit API**: realtime sync, UI blocks, Reddit data integration
- **Redis**: persistent leaderboard via `zIncrBy`
- **React-style structure**: modular functional pages with shared props
- **Comment polling**: listens for comments via `getComments()` every 5s
### 🛠 Local Dev Tools
| Tool | Version | Notes |
|-------------------|-------------------|----------------------------|
| Devvit CLI | 0.11.7 | Core Devvit CLI |
| Node.js & npm | 23.4.0 / 11.1.0 | Includes `npx` utility |
| TypeScript & Prettier | 5.3.2 / 3.5.3 | For typing and formatting |
| VS Code | latest | Editor of choice |
| Redis | latest | For leaderboard storage |
## 🧱 Core Components
| Page | Purpose |
|--------------------|----------------------------------------------|
| `PageWelcome` | Entry screen with navigation |
| `PageTeam` | Comment-based team assembly |
| `PageChallenge` | Questions by role with validation |
| `PageVictory` | Victory screen + point assignment |
| `PageDefeat` | Failure screen + restart option |
| `PageLeaderboard` | Live leaderboard from Redis |
## 🔗 Real-Time Channels
- `question_set` — syncs the exact same questions across all players
- `specialists_sync` — syncs roles for the team
- `page_sync` / `level_sync` — for smooth multi-user transitions
- `reset_team` — resets team slots for a new run
## 🛠 Dev Mode
Built entirely in [`main.tsx`](./main.tsx) using modular page components.
All logic runs inside the Devvit custom post renderer — no backend required beyond Redis for leaderboard scoring.
## 🤝 Built For
Reddit + Devvit + multiplayer fun 🎉
Optimized for community-driven gameplay in subreddit threads.
Perfect for hackathons, online communities, or just showing off what Devvit can really do.
## 📜 License
MIT License — see [`LICENSE`](./LICENSE) for full text.
Built with 💜 by [vero-git-hub](https://github.com/vero-git-hub).
Please keep this credit if you reuse or remix the project.