Quest Chain and Progressive Puzzle Sequences

[Mkalbani]

Location: Backend API
Labels: backend, game-logic, good first issue
Estimated Time: 7 hours
Difficulty: Medium

Description

Build a quest chain system where completing one puzzle unlocks the next in a progressive sequence with story elements.

Tasks

• Design quest chain schema
• Create chain creation and configuration endpoints
• Implement sequential unlock logic
• Add progress checkpointing
• Create branch/alternate path support
• Implement cumulative chain rewards
• Add chain completion tracking
• Write chain progression tests
• Create chain reset functionality
• Add chain leaderboards (speed runs)

Acceptance Criteria

• Chains created with sequential puzzles
• Unlocking works based on completion
• Progress saved at checkpoints
• Branching paths functional
• Chain rewards distributed
• Tests cover all scenarios

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 150 Points.

🧑‍💻 Interested in contributing? Apply to work on this issue on Drips Wave, earn points, and receive rewards.

Warning

Only applications submitted via the apply link above will be considered. Please do not apply by commenting on the issue or opening a PR directly.

🤠 Repo maintainers: You can manage this issue's Points and Complexity on your Maintainer Dashboard here. Please keep an eye on applications and respond quickly 💙

ℹ️ Learn more about Drips Wave

[Cofez]

@Cofez has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

I would like to work on this issue because quest chains and progressive puzzles are a great way to guide users through complex systems in an engaging way. I enjoy building experiences that help users learn step by step without feeling overwhelmed.

I’ve worked on interactive flows and logic-driven features where each step unlocks the next, and I’m comfortable implementing state management, validations, and progression logic to make these experiences smooth and reliable.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Cofez to this issue.

[odeyemitobi]

@odeyemitobi has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

I would like to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @odeyemitobi to this issue.

[teethaking]

@teethaking has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

I am highly motivated to implement the Quest Chain System because it combines technical backend architecture with engaging game logic. Designing a system that handles sequential unlocks, branching paths, and progress checkpointing requires a thoughtful approach to database schema design—specifically ensuring that the state of a player's journey is both performant and resilient. I enjoy building systems where the backend logic directly enhances the storytelling and player progression experience.

Relevant Experience:

Game Logic & State Management: Experience designing state machines and progress trackers that handle "if-then" unlock scenarios and prerequisite logic.

Schema Design: Proficient in creating relational database schemas (SQL/NoSQL) to handle parent-child relationships, which is essential for "Chain" and "Puzzle" entities.

Branching Logic: Skilled in implementing conditional routing and logic flows, ensuring that "alternate path support" is modular and easy to extend.

Performance & Competition: Experience building leaderboard systems (Redis/SQL) to track "speed run" metrics and cumulative rewards without bottlenecking the API.

Test-Driven Development: Committed to writing comprehensive integration tests to ensure that progression, resets, and reward distribution work flawlessly across all edge cases.

Technical Approach (To impress the maintainers)
If you have space or a "comment" section, mentioning how you'll solve it can set you apart:

The Schema: I’ll likely use a Directed Acyclic Graph (DAG) approach or a linked-list style schema for the quest steps to ensure that branching paths don't create infinite loops.

The Checkpoints: I plan to implement a "Snapshot" pattern for progress saving, allowing users to resume exactly where they left off or reset to a specific milestone.

The Rewards: I will ensure reward distribution is atomic to prevent "double-claiming" or lost items during chain completion.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @teethaking to this issue.

[abdulomeiza]

@abdulomeiza has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

I am a Full Stack Developer specializing in Next.js,Python, TypeScript, Node.js,Rust, PostgreSQL,Oracle, JavaScript and DevOps Engineering. With over 50 contributions across projects in web3 and specifically stellar ecosystem, I’ve developed strong proficiency in delivering high-quality solutions and resolving complex issues within tight deadlines. My experience spans frontend, backend, smart contracts, and the optimization and maintenance of scalable codebases.
I can handle this task. Kindly assign.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @abdulomeiza to this issue.

[drips-wave]

Congratulations, @abdulomeiza! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on February 26, 2026.

🧑‍💻 @abdulomeiza: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are issued when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[drips-wave]

This issue has been completed by @abdulomeiza as part of the Stellar Wave Program's 2nd Wave 🥳

😎 @abdulomeiza: You earned 150 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.