Implement Tutorial Mode with Guided Gameplay and Bonus Explanations

[Cheelax]

Description: We need to implement a new "Tutorial" mode that guides players through the basic mechanics of the game in an off-chain environment. This mode will provide a structured, step-by-step introduction to core gameplay elements and bonuses.

Tasks:

1. Create Tutorial Mode Framework
   • Implement a new game mode option for "Tutorial" using a “Start” component
   • Design an off-chain system to manage the tutorial progression
   • Create a mechanism to generate simple, predetermined grid layouts for each tutorial step
2. Implement Basic Cube Sliding Tutorial
   • Create a simple grid layout with a slidable cube
   • Implement guided instructions for sliding the cube
   • Add visual cues (e.g., arrows, highlights) to indicate the correct action
   • Be sure that the gravity and clear line mechanics are properly used after the slide even in an offchain logic
3. Implement Hammer Bonus Tutorial
   • Add a step to introduce the Hammer bonus
   • Create a clear explanation of what the Hammer bonus does and how to get it
   • Guide the player through using the Hammer bonus
   • Provide feedback on successful use of the bonus
4. Implement Wave Bonus Tutorial
   • Add a step to introduce the Wave bonus
   • Create a clear explanation of what the Wave bonus does and how to get it
   • Guide the player through obtaining and using the Wave bonus
   • Provide feedback on successful use of the bonus
5. Implement Tiki Bonus Tutorial
   • Add a step to introduce the Tiki bonus
   • Create a clear explanation of what the Tiki bonus does and how to get it
   • Guide the player through obtaining and using the Tiki bonus
   • Provide feedback on successful use of the bonus
6. Develop Tutorial Flow Control
   • Implement a system to manage progression through tutorial steps
   • Add checks to ensure each step is completed before moving to the next
7. Design Tutorial UI Elements
   • Create a tutorial-specific UI overlay for instructions and explanations
   • Design visual cues that are clear but non-intrusive
   • Implement a progress indicator for the tutorial
8. Integrate with Main Game
   • Add a "Tutorial" option to the main menu or game mode selection screen
9. Testing
   • Conduct thorough testing of each tutorial step

Acceptance Criteria:

• Players can easily access and start the Tutorial mode from the main menu
• The tutorial guides players through sliding a cube and completing a line
• Clear explanations are provided for each bonus (Hammer, Wave, Tiki)
• Players are guided through obtaining and using each bonus
• The tutorial provides clear feedback on correct actions and progression
• Players can easily understand and follow the instructions without feeling overwhelmed
• The tutorial UI is visually consistent with the main game aesthetic
• Tutorial mode works consistently across different devices and screen sizes

[Jemiiah]

I would love to work on this issue @Cheelax This would be my first contribution to this repository i have made multiple contributions to different repos and have over 30+ plus contributions and participated in previous OD Hacks as well, here is my GitHub profile : https://github.com/Jemiiah

[Gift-Naomi]

Hi @Cheelax I will be glad to work on this? I am a web3/frontend developer and also a technical writer I can work on this perfectly

i will do the following when you assign me this issue

1. Create Tutorial Mode Framework: Implement a new "Tutorial" game mode with off-chain progression, starting with a simple grid layout and guided cube sliding, using visual cues for instructions.

2. Integrate Bonuses: Add steps to introduce and guide the use of Hammer, Wave, and Tiki bonuses, ensuring clear explanations and feedback for each.

3. Design and Test: Develop tutorial-specific UI elements, integrate the mode into the main menu, and conduct thorough testing to ensure clarity, consistency, and cross-device compatibility.

[ShantelPeters]

Hello @Cheelax I will love to work on this

[martinvibes]

hello @Cheelax I would love to participate in this issue and be a contributor to your repo

[GoSTEAN]

@Cheelax Can this be assigned to me?

[petersdt]

hi @Cheelax can i contribute to this project

[NueloSE]

@Cheelax can i contribute to this task. Using canva and figma i would be able create slides that would enable users ease when accessing this game

[ikemHood]

I am applying to this issue via OnlyDust platform.

My background and how it can be leveraged

Hey, I am ikem Peter. a fullstack software developer with 3+ years of working experience, I would love to help out with this issue...

How I plan on tackling this issue

I would break it down into manageable steps:

Create the Framework:

Start by adding a "Tutorial" mode option in the game, using a dedicated "Start" component. Design an off-chain system to manage the tutorial progression, ensuring it's separate from the main game logic. Implement Basic Mechanics:

Begin with a simple cube sliding tutorial. Create a grid layout with a slidable cube and provide guided instructions for the player. Use visual cues like arrows or highlights to guide the player, ensuring gravity and clear line mechanics are properly handled even off-chain. Introduce Bonuses:

Add steps to introduce the Hammer, Wave, and Tiki bonuses sequentially. For each bonus, create clear explanations, guide the player through its use, and provide feedback on successful execution. Develop Flow Control:

Implement a system to manage the progression through tutorial steps, ensuring each step is completed before moving to the next. Add checks and balances to maintain the flow. Design UI Elements:

Create a tutorial-specific UI overlay to display instructions and explanations. Design visual cues that are clear but not overly intrusive, and add a progress indicator to show tutorial completion. Integrate and Test:

Add the "Tutorial" option to the main menu or game mode selection screen. Conduct thorough testing to ensure each tutorial step functions as expected, refining as needed.

[NueloSE]

I am applying to this issue via OnlyDust platform.

My background and how it can be leveraged

I am a frontend developer with experience in technical writing and documentation .

with my expirence i believe i would be able to create a guide for users to access and use this platform

How I plan on tackling this issue

steps to tackle issue:

Create Tutorial Mode Framework:

Implement a new game mode option for "Tutorial" accessible through a “Start” component. Design an off-chain system to manage the progression of the tutorial steps. Generate Tutorial Grids and Mechanics:

Create predefined grid layouts for each step of the tutorial. Ensure core mechanics like gravity and line clearing work correctly even in an off-chain logic setup. Implement Core Tutorial Steps:

Basic Cube Sliding Tutorial: Design a grid layout with a slidable cube. Implement step-by-step guided instructions for sliding the cube, including visual cues like arrows and highlights. Hammer Bonus Tutorial: Introduce the Hammer bonus, explain its purpose, and guide the player in using it. Provide feedback after the player successfully uses the bonus. Wave Bonus Tutorial: Introduce the Wave bonus, explain its purpose, and guide the player in using it. Provide feedback after the player successfully uses the bonus. Tiki Bonus Tutorial: Introduce the Tiki bonus, explain its purpose, and guide the player in using it. Provide feedback after the player successfully uses the bonus. Develop Tutorial Flow Control:

Implement a system to manage progression through each step, ensuring one step is completed before moving to the next. Include conditions to check whether the player has performed the correct actions. Design Tutorial UI Elements:

Create a UI overlay specific to the tutorial for instructions and explanations. Implement non-intrusive visual cues and a progress indicator for the tutorial steps. Integrate the Tutorial with the Main Game:

Add a "Tutorial" option to the main menu or game mode selection screen. Ensure that the tutorial mode fits seamlessly with the existing game UI and flow. Testing and Optimization:

Conduct thorough testing to verify that each tutorial step functions as expected. Test across different devices and screen sizes to ensure consistent performance. Gather feedback to ensure the tutorial is clear, engaging, and easy to follow.

[Gift-Naomi]

I am applying to this issue via OnlyDust platform.

My background and how it can be leveraged

I am a web3/frontend developer

How I plan on tackling this issue

1. Create Tutorial Framework and UI: Develop a new game mode for "Tutorial" with a structured flow, including off-chain progression management and a tutorial-specific UI overlay.

2. Implement and Guide Mechanics: Build tutorials for basic cube sliding and introduce Hammer, Wave, and Tiki bonuses, using guided instructions, visual cues, and feedback mechanisms.

3. Integrate and Test: Add the "Tutorial" option to the main menu, ensure smooth integration with the main game, and conduct thorough testing across various devices and screen sizes.

[Benjtalkshow]

I am applying to this issue via OnlyDust platform.

My background and how it can be leveraged

Hi @Cheelax

I will be glad to work on the "Implement Tutorial Mode" issue. My name is Benjamin, and I have extensive experience in designing and implementing user-focused tutorials and game mechanics. My background includes creating intuitive onboarding experiences and guiding players through new features in a structured manner.

Understanding the Issue

We need to implement a new "Tutorial" mode that guides players through the basic mechanics of the game in an off-chain environment. This mode will offer a structured, step-by-step introduction to core gameplay elements and bonuses, ensuring that players understand how to play effectively.

How I plan on tackling this issue

Create Tutorial Mode Framework

• Game Mode Option: I will add a new game mode option for "Tutorial" using the existing “Start” component.
• Off-Chain System: I will design an off-chain system to manage the tutorial progression, including simple, predetermined grid layouts for each step.

Implement Basic Cube Sliding Tutorial

• Simple Grid Layout: I will create a grid layout with a slidable cube.
• Guided Instructions: I will implement guided instructions for sliding the cube and add visual cues (e.g., arrows, highlights) to indicate the correct action.
• Mechanics: I will ensure that gravity and clear line mechanics are used properly after the slide, even within the off-chain logic.

Implement Hammer Bonus Tutorial

• Bonus Introduction: I will add a step to introduce the Hammer bonus.
• Explanation and Guidance: I will provide a clear explanation of what the Hammer bonus does and guide the player through using it.
• Feedback: I will implement feedback to indicate successful use of the bonus.

Implement Wave Bonus Tutorial

• Bonus Introduction: I will add a step to introduce the Wave bonus.
• Explanation and Guidance: I will provide a clear explanation of what the Wave bonus does and guide the player through obtaining and using it.
• Feedback: I will implement feedback to indicate successful use of the bonus.

Implement Tiki Bonus Tutorial

• Bonus Introduction: I will add a step to introduce the Tiki bonus.
• Explanation and Guidance: I will provide a clear explanation of what the Tiki bonus does and guide the player through obtaining and using it.
• Feedback: I will implement feedback to indicate successful use of the bonus.

Develop Tutorial Flow Control

• Progression System: I will implement a system to manage progression through tutorial steps, adding checks to ensure each step is completed before moving to the next.

Design Tutorial UI Elements

• UI Overlay: I will create a tutorial-specific UI overlay for instructions and explanations, designing visual cues that are clear but non-intrusive.
• Progress Indicator: I will implement a progress indicator to show how far the player has advanced in the tutorial.

Integrate with Main Game

• Main Menu Option: I will add a "Tutorial" option to the main menu or game mode selection screen.

Testing

• Tutorial Steps: I will conduct thorough testing of each tutorial step to ensure that it functions as intended.

[Cheelax]

Hi everyone. There is a new process for the ODHack, now you must apply to the tasks directly from Onlydust: https://app.onlydust.com/hackathons/odhack-70 We will only look at application made via this process.

[onlydustapp[bot]]

The maintainer Cheelax has assigned Gift-Naomi to this issue via OnlyDust Platform. Good luck!

[Cheelax]

GM @Gift-Naomi! any update on the state of this issue?

[Gift-Naomi]

GM @Gift-Naomi! any update on the state of this issue?

I’ll create a PR soon

[josephchimebuka]

Hello @Cheelax I would to solve this issue

[Gift-Naomi]

@Cheelax I’m almost done with this The issue is not complex that why I’ve not created a PR

[Gift-Naomi]

@Cheelax I will send my PR today

[Benjtalkshow]

Hello @Cheelax I would love to work on this task. My task to create dashboard on dune didn't go well as planned. I would love if I am given this task to work on as my first task on zkube. I would deliver as fast as possible.