🐍 Python Adventure — Learn to Code!

CH 1

The Text Spells ✨

Learning: print() and Strings

🪄

⭐☆☆☆☆ First Steps ⏱ 20 min ✨ You'll make: A welcome message that prints YOUR name and battle cry

📖 The Story

You've just arrived at the Python Wizard Academy! To prove you're worthy of the title Apprentice Coder, you must master your first spell — the legendary Text Spell. With it, you can make any words appear on any screen in the kingdom. No magic wand required… just a keyboard! 🧙

💡 The Big Idea

In Python, print() is your megaphone. Any message you put inside the brackets will appear on the screen. Words inside quote marks ("like this") are called Strings — they're the magical text scrolls of Python!

print("Hello, World!") → Hello, World! print("I cast a spell!") → I cast a spell!

🖥️ Do This in PyCharm

1

Open PyCharm and go to File → Open…. Navigate to the kids-python-adventure folder and click OK / Trust Project.
2

In the left panel (Project Explorer), double-click chapter_1_magic_words.py to open it in the editor.
3

Read the green comment lines at the top — they're your quest briefing! Every line that starts with # is a comment (Python ignores it; it's written for you).
4

Find the lines marked # TODO. These are your challenges! Change the text inside the quotes to your own name and answers. Keep the " " marks exactly where they are!
5

Click the big green ▶ Play button in the top-right corner (or press Shift + F10). Watch the magic happen in the Console below!

👀 What to Look For in PyCharm

At the bottom of your screen, a dark panel pops open — that's the Run Console. It's like the display screen of your computer game. Look for:

✅ Your own name printed on a line by itself
✅ Your favorite animal and battle cry
✅ A big decorative banner made of ✨ symbols
✅ The message "CHAPTER 1 COMPLETE!"

🎉 If you see your name in the Console — you cast your FIRST Python spell!

🏆 After This Chapter You'll Know:

print() Strings " " Comments # Running Code ▶

CH 2

Memory Boxes 📦

Learning: Variables — Storing Your Inventory

🎒

⭐⭐☆☆☆ Easy ⏱ 25 min ✨ You'll make: A character stat sheet with your name, weapon, and gold count

📖 The Story

Your character has levelled up and urgently needs an inventory system! In every great RPG, your hero carries weapons, gold coins, and magical potions in a backpack. Python lets you store all this information in Variables — special labelled boxes that remember things for you. Time to pack your adventurer's backpack! ⚔️

💡 The Big Idea

A variable is a labelled box that holds a value. Write the name on the left, then use = to put something inside. There are three main types of box:

          hero_name   = "Zara"    ← text (string)
          gold_coins  = 250      ← number (int)
          has_shield  = True     ← yes/no (bool)
           
          print("Name:", hero_name)
          → Name: Zara
        

🖥️ Do This in PyCharm

1

Open chapter_2_inventory_boxes.py in PyCharm (double-click it in the left panel).
2

Press ▶ Run first to see the default hero. Notice how the variables control what gets printed!
3

Find # TODO #1 and change player_name to YOUR name. Keep the " " quotes around it — text always needs them!
4

Fill in your weapon, your power level (a plain number — no quotes!), and set has_dragon to True or False.
5

Press ▶ Run again. Your personalised character sheet and inventory chest will display!

👀 What to Look For in PyCharm

In the Run Console at the bottom, look for:

✅ Your actual name next to "Adventurer:"
✅ The weapon you invented
✅ A neat inventory chest made with = characters

🎉 Your name in the output means your variable WORKED — you stored data like a real programmer!

🏆 After This Chapter You'll Know:

Variables Strings (text) Integers (numbers) Booleans True/False

CH 3

The Secret Doors 🚪

Learning: if / elif / else — The Fork in the Road

🔀

⭐⭐☆☆☆ Easy ⏱ 30 min ✨ You'll make: A password-protected secret room that reacts to your answer

📖 The Story

Deep in the Python Dungeon, three mysterious doors block your path. Each leads to a completely different fate — treasure, dragons, or a hidden passage. Python can choose which door to open using if / elif / else. It checks a condition, then takes the right path automatically. This is how programs make decisions! 🏰

💡 The Big Idea

if / elif / else is a fork in the road. Python checks each condition top to bottom — the first one that's True wins, and its block of code runs.

          if door == "red":
          print("Dragon ahead! 🐲")
          elif door == "blue":
          print("Treasure found! 💰")
          else:
          print("Secret passage! 🌀")
        

🌟 New Spell: the f-string!

This chapter also unlocks the f-string — a way to drop a variable inside your text. Put an f before the first quote, then wrap the variable in {curly braces}:

          score = 95
          print("Score:", score)      # the comma way
          print(f"Score: {score}")    # the f-string way!
        

You'll see f-strings everywhere from now on — they make printing much tidier!

🖥️ Do This in PyCharm

1

Open chapter_3_secret_doors.py in PyCharm.
2

Press ▶ Run. This chapter uses input() — the program will pause and wait for you to type! Look for the blinking cursor in the Console.
3

Type the password shown in the file and press Enter. See what happens when you get it right — and wrong!
4

Find # TODO #1 and change secret_password to something only YOU would know. Run it again and test your new password!
5

Find # TODO #2 and # TODO #3 to customise the three-door challenge. Change the door colour and add your own secret word!

👀 What to Look For in PyCharm

When you run this file the Console will PAUSE and show a question. This is input() asking for your answer! Look for:

✅ A question with a blinking cursor — type your answer and press Enter
✅ A different message depending on what you typed
✅ The "✅ door opens" message when you nail the right password

🎉 Different output for different inputs = your if/else logic is WORKING!

🏆 After This Chapter You'll Know:

if / elif / else input() == comparison f-strings Decision Logic

CH 4

The Repeat Potions 🔁

Learning: for loops & while loops

⚗️

⭐⭐⭐☆☆ Medium ⏱ 30 min ✨ You'll make: An animated potion-brewing machine with a live progress bar

📖 The Story

The wizard's brewery needs 1,000 potions by morning! You could type print("Brewing...") one thousand times… or you could use a Loop! Loops are the most powerful spells in Python — they make the computer repeat an action over and over without you having to write it over and over. Work smarter, not harder! ♻️

💡 The Big Idea

A for loop repeats a block of code a set number of times. A while loop keeps repeating until a condition becomes False.

for i in range(5): print("Brewing potion #", i+1) → Brewing potion # 1 → Brewing potion # 2 → Brewing potion # 3 … (5 times total!)

🖥️ Do This in PyCharm

1

Open chapter_4_repeat_potions.py in PyCharm.
2

Press ▶ Run and watch the countdown and potion counter appear automatically. That's a loop doing the work!
3

Find # TODO #1 and change the number in number_of_potions = 5. Try 3, then 15, then 100. Notice how tiny the code change is for a huge result!
4

Find # TODO #2 and change the items list. Find # TODO #3 and change the magic power word (try "legendary" or "cursed"!).
5

The Success Challenge at the bottom runs an animated progress bar! The output prints slowly on purpose — watch the 🧪 symbols fill up one by one.

👀 What to Look For in PyCharm

This chapter has animated output! Because of time.sleep() the Console prints line by line with short pauses. Watch for:

✅ Lines appearing one at a time with a slight delay
✅ The progress bar growing as 🧪 symbols fill in
✅ The while loop countdown ticking from 5 → 4 → 3 → 2 → 1 → 🎆

🎉 Your loop runs live = you've unlocked Python Programmer Superpowers!

🏆 After This Chapter You'll Know:

for loops range() while loops Lists [ ] time.sleep()

CH 5

Function Spells 🔮

Learning: def, parameters, return

⚗️

⭐⭐⭐☆☆ Medium ⏱ 35 min ✨ You'll make: A reusable spell announcer that introduces any hero with one call

📖 The Story

The master brewer of the Potion Guildhall has a secret — he never re-invents a recipe. He writes it once, then any apprentice can follow it a thousand times. Python functions work the same way: define a block of steps once with def, then call it whenever you need it, anywhere in your program. 🧙

💡 The Big Idea

Write a function once with def. Pass in data via parameters. Get a result back with return.

def greet(name): print("Hello, " + name) greet("Aria") → Hello, Aria greet("Bolt") → Hello, Bolt

🖥️ Do This in PyCharm

1
Open chapter_5_function_spells.py in PyCharm.
2
Press ▶ Run and watch greet_hero() get called three times from a single definition.
3
Find # TODO #1 — change "Adventurer" to YOUR name in the function call.
4
Find # TODO #2 — change "Warrior" to your chosen class and run again.
5
Find # TODO #3 & #4 — write a full_hero_name function with a return statement and call it with your own name parts.

👀 What to Look For in PyCharm

In the Run Console look for:

✅ greet_hero() printing the exact same output three times — that's the power of reuse
✅ Your name appearing in the personalised call
✅ The Spell Catalogue at the end showing each spell formatted by your function

🎉 One function, many calls = your code is now reusable!

🏆 After This Chapter You'll Know:

def Parameters return Calling functions

CH 6

List Quests 📋

Learning: Lists — collections of items

⚔️

⭐⭐⭐☆☆ Medium ⏱ 30 min ✨ You'll make: A party roster you can add heroes to, remove them, and loop through

📖 The Story

Your adventuring party needs an official Roster! Until now every variable held one thing at a time. A List holds many things in order — inside a single variable. Add heroes when they join, remove them when they leave, loop through the whole party in three lines of code. 📜

💡 The Big Idea

Square brackets [ ] create a list. Items are separated by commas. Access any item by its index number — Python counts from 0!

party = ["Aria", "Bolt", "Zara"] print(party[0]) → Aria party.append("Nova") print(len(party)) → 4

🖥️ Do This in PyCharm

1
Open chapter_6_list_quests.py in PyCharm and press ▶ Run to see the default party roster.
2
Find # TODO #1 — change the three hero names to characters YOU invented.
3
Find # TODO #2 — use .append() to add a 4th hero of your choice.
4
Find # TODO #3 — use .remove() to dismiss one hero from the party.
5
Find # TODO #4 — replace the inventory items with your own gear and re-run to see the loop display them all.

👀 What to Look For in PyCharm

In the Run Console look for:

✅ Your invented hero names in the party roster
✅ The party size updating correctly after add and remove
✅ The Quest Board at the end — a numbered list built entirely from a list variable

🎉 A loop over a list = you can process any number of items with just 2 lines!

🏆 After This Chapter You'll Know:

Lists [ ] Indexing [0] append / remove len() for item in list

CH 7

The Random Oracle 🎲

Learning: import random

🃏

⭐⭐☆☆☆ Easy ⏱ 25 min ✨ You'll make: A random loot drop system and a Magic 8-Ball fortune teller

📖 The Story

Real games need unpredictability — dice rolls, surprise loot drops, critical hits that change everything. Python's random module is the Oracle that never gives the same answer twice. Roll dice, draw fate cards, and build a battle simulator whose outcome changes every single run! 🎲

💡 The Big Idea

import random loads the module. Three key spells: randint() rolls a die, choice() draws from a list, shuffle() scrambles one.

import random random.randint(1, 20) → 14 (different every run!) random.choice(["fire", "ice", "thunder"]) → "ice" (random pick)

🖥️ Do This in PyCharm

1
Open chapter_7_random_oracle.py and press ▶ Run. Then run it again — notice the output is different!
2
Find # TODO #1 — change randint(1, 6) to a different dice. Try (1, 100)!
3
Find # TODO #2 — replace the 5 loot items with your own invented treasures.
4
Find # TODO #3 — write 5 Magic 8-Ball answers: some yes, some no, some mysterious.
5
Run the Battle Simulator at the bottom 3 times — every fight has a different hero, enemy, and outcome!

👀 What to Look For in PyCharm

In the Run Console look for:

✅ Different dice numbers every time you press ▶ Run
✅ Your own loot item appearing in the drop
✅ The Battle Simulator — different heroes, enemies, and winners each run

🎉 When your output changes every run — randomness is working!

🏆 After This Chapter You'll Know:

import random randint() choice() shuffle()

CH 8

String Sorcery 🔤

Learning: String methods & the in operator

📜

⭐⭐⭐☆☆ Medium ⏱ 30 min ✨ You'll make: A magic name generator that builds hero names from word pieces

📖 The Story

The kingdom's most powerful wizards carry a Translation Stone — press it to any scroll and it transforms the words: SHOUT them, whisper them, swap one word for another, or search for a hidden message buried in the text. Python string methods are your Translation Stone! 🔮

💡 The Big Idea

Strings have built-in methods you call with a dot. The in operator searches inside a string and returns True or False.

s = "fireball" s.upper() → "FIREBALL" s.replace("fire", "ice") → "iceball" "ball" in s → True

🖥️ Do This in PyCharm

1
Open chapter_8_string_sorcery.py and press ▶ Run to see all the text transformations.
2
Find # TODO #1 — change "adventurer" to YOUR name and see it displayed in all four forms.
3
Find # TODO #2 — change the sentence and the words being replaced.
4
Find # TODO #3 — change search_word to a word that IS or IS NOT in the scroll. Try both!
5
Run the Magic Name Generator at the bottom — run it 5 times and collect your favourite generated hero name!

👀 What to Look For in PyCharm

In the Run Console look for:

✅ Your name appearing in four different forms (original, UPPER, lower, Title)
✅ A word in your sentence getting swapped out by .replace()
✅ A randomly generated hero name + battle shout at the end

🎉 Transforming text with one line = string methods mastered!

🏆 After This Chapter You'll Know:

.upper() / .lower() .replace() .split() len() "x" in s

The Text Spells ✨

📖 The Story

💡 The Big Idea

🖥️ Do This in PyCharm

👀 What to Look For in PyCharm

🏆 After This Chapter You'll Know:

Memory Boxes 📦

📖 The Story

💡 The Big Idea

🖥️ Do This in PyCharm

👀 What to Look For in PyCharm

🏆 After This Chapter You'll Know:

The Secret Doors 🚪

📖 The Story

💡 The Big Idea

🌟 New Spell: the f-string!

🖥️ Do This in PyCharm

👀 What to Look For in PyCharm

🏆 After This Chapter You'll Know:

The Repeat Potions 🔁

📖 The Story

💡 The Big Idea

🖥️ Do This in PyCharm

👀 What to Look For in PyCharm

🏆 After This Chapter You'll Know:

Function Spells 🔮

📖 The Story

💡 The Big Idea

🖥️ Do This in PyCharm

👀 What to Look For in PyCharm

🏆 After This Chapter You'll Know:

List Quests 📋

📖 The Story

💡 The Big Idea

🖥️ Do This in PyCharm

👀 What to Look For in PyCharm

🏆 After This Chapter You'll Know:

The Random Oracle 🎲

📖 The Story

💡 The Big Idea

🖥️ Do This in PyCharm

👀 What to Look For in PyCharm

🏆 After This Chapter You'll Know:

String Sorcery 🔤

📖 The Story

💡 The Big Idea

🖥️ Do This in PyCharm

👀 What to Look For in PyCharm

🏆 After This Chapter You'll Know:

🏆 Quest Complete!