Welcome to Copilot Adventures! This series of coding adventures is all about learning new concepts and languages by using GitHub Copilot to help you write code. Let's get started!

Choose Your Own Copilot Adventure

1. Enter the Adventure Arena

To get started, enter the "adventure arena" by clicking the button below. This will create a GitHub Codespace that you can work in. Once it loads select the Create codespace button.

NOTE: You can use 60 hours of GitHub Codespaces for free each month.

If you'd prefer, you can clone the repo and run locally:

git clone https://github.com/microsoft/copilotadventures

2. Choose an Adventure

Pre-Reqs: Basic programming language knowledge is helpful.

New to GitHub Copilot?

If you're new to GitHub Copilot, need to install the extensions, and want to learn how to get started using it, start with the Warmup Adventure.

Once you've completed the warmup adventure and have the extensions installed, choose another GitHub Copilot adventure from the list below:

Beginner Adventures

• The Clockwork Town of Tempora - In the mechanical town of Tempora, everything operates on clockwork and precise timing. At the heart of the town is the Grand Clock Tower, responsible for keeping time for all the town's activities. However, over the years, some smaller clocks in the town have started to drift away from the accurate time.
• The Magical Forest of Algora - Deep within the enchanted Forest of Algora, two mystical creatures, the Lox and the Faelis, perform a sacred dance every millennium. This dance is not just for celebration but is a ritual to bring balance to the forest.

Intermediate Adventures

• The Celestia Alignment of Lumoria - In the vast expanse of the Galaxia Nebulae, a rare phenomenon is about to occur in the Lumoria star system. The planets, revolving around the Lumorian Sun, are aligning in a celestial dance that happens only once every few millennia. This alignment has a unique effect on how the light from the Lumorian Sun reaches each planet.
• The Legendary Duel of Stonevale - In the mystical realm of Stonevale, two warriors, Rok and Papyra, are chosen for a duel that determines the fate of their tribes for the next century. The arena, known as Scissoria, is where each move carries weight and consequences.
• The Scrolls of Eldoria - In the enchanted land of Eldoria, ancient scrolls contain the secrets of the universe. These scrolls, however, were scattered and protected by the Elders using powerful spells. These spells concealed the secrets within the scrolls, adding layers of misleading information to deter prying eyes. Over time, these scrolls were digitized and stored in the Great Eldorian Library, accessible only through the Eldorian Web of Knowledge.

Advanced Adventures

• The Gridlock Arena of Mythos - In the mystical land of Mythos, creatures from various realms come together to battle in the Gridlock Arena, a chess-like grid where strategy, power, and cunning are tested. Each creature has its unique move, power, and strategy.

3. Start Coding

Read Your Copilot Adventure description, the high-Level tasks to perform, and the GitHub Copilot hints to help you write your code.

• Use GitHub Copilot and/or GitHub Copilot Chat to help you write the code for the adventure. You can use any language you'd like. Try learning a new language if you're up for the challenge (more on that below)!
• Leave any comments in your code to explain your thought process and show prompts that GitHub Copilot used to help you out.

4. Submit Your Adventure Solution (Optional)

If you'd like to share your solution with others, perform the following steps:

• Publish your adventure solution to a GitHub repo.

• Visit https://github.com/microsoft/CopilotAdventures/issues and select New Issue.

• Use the following naming convention for the issue title.

  Solution for [Name of Your Adventure]
  

  Replace [Name of Your Adventure] with the adventure name you chose to solve (example: The Legendary Duel of Stonevale).

• Add a link to your GitHub repo in the body section.

• If you have any feedback, share what you found (good or bad). We'd love to hear your feedback!

Next Steps: Learn a New Language or Create a UI for Your Adventure

Once you've completed your first adventure, try it again but this time use GitHub Copilot to complete the adventure using a language that's new to you. For example, if you normally write code in C#, use Copilot to help you solve the adventure using Python or another language you'd like to learn more about.

Try creating a UI for your adventure. Use pure HTML/CSS/JavaScript or a library/framework of your choosing. Let GitHub Copilot/Chat help you out with the UI code. If your UI requires images, consider using Bing Image Creator or another AI image generation service.

Have a Copilot Adventure Idea? Submit a PR!

Do you have a copilot adventure story/puzzle you'd like to submit for others to go through? We'd love to see it! Please submit a pull request to this repository with your adventure and solution.

• Use New Copilot Adventure: [Your Adventure Name] for the PR title. Replace [Your Adventure Name] with the name of your adventure.
• Include if your adventure is at the beginner, intermediate, or advanced level.
• Follow the markdown template used with each adventure in the Adventures folder as you create your adventure.
• Provide an image for your adventure (use Microsoft Copilot Image Creator or another image generator solution). The image should "landscape" and be 1456x832 pixels.
• Provide a solution using your chosen language. Place all of the code in a single file (to keep things simple), add it to the appropriate language folder in Solutions, and include it in the PR.

We'll review your submission and merge it into the repo if it meets the criteria.