text-adventure-engine

name	text-adventure-engine
description	The Enchanted Journey - A playable text adventure game with branching narratives, moral choices, multiple endings, and save functionality. An interactive fantasy adventure where your choices shape the story and determine your fate. Play directly by running the game - no programming required.

The Enchanted Journey 🏰✨

A magical text adventure game where your choices matter. Explore ancient forests, meet mysterious creatures, uncover hidden truths, and discover which ending awaits you.

Quick Start

Play the Game

# Method 1: Direct run (easiest)
python3 scripts/play.py

# Method 2: From skill directory
cd text-adventure-engine
python3 scripts/play.py

That's it! The game will start immediately. No setup required.

Game Controls

Command	Action
1, 2, 3...	Select a choice
S	Save your game
L	Load a saved game
H	Show help
Q	Quit game

About The Game

The Enchanted Journey is an interactive fantasy adventure where you play as a traveler who arrives at a mysterious forest. Your choices will:

• Shape your character's moral alignment
• Unlock hidden paths and secrets
• Determine which of 6 endings you receive
• Affect the lives of those you meet

Key Stats

• ❤️ Health - Your physical condition
• 💖 Morality - Your moral compass (determines your ending!)
• 🧠 Knowledge - Wisdom gained through exploration
• 💰 Gold - Currency for special choices
• 🎒 Inventory - Items you collect
• 🏆 Achievements - Special accomplishments

The Six Endings

Your morality and choices determine which ending you get:

Ending	Morality	Requirements
👑 The Guardian	High (80+)	Accept responsibility
🌗 The Age of Balance	High	Meet Shadow King, choose unity
🏠 The Return	Any	Refuse the Crown (humility path)
∞ Eternal Wanderer	Any	Choose to merge with Crown
💔 Failed Hero	Low	Selfish choices throughout
🌑 Shadow's Servant	Very Low	Consistently evil choices

Gameplay Tips

For the Best Experience

1. Read carefully - Details matter in this world
2. Explore everything - Knowledge unlocks new paths
3. Think before choosing - Actions have consequences
4. Help others - High morality leads to better endings
5. Save often - Before major decisions

Secret Paths to Discover

• 🦊 The Fox Ally - Help Felix for guidance throughout your journey
• 🧙‍♀️ The Witch's Deal - Visit the cottage for powerful (but costly) assistance
• 👤 The Star Watcher - Hidden path that reveals the truth about the Crown
• 🌑 The Shadow King - Can be met... or defeated... or joined

Achievement Guide

Achievement	How to Unlock
🔍 Curious Mind	Reach 50 knowledge
📚 Scholar	Reach 100 knowledge
🧠 Sage	Reach 200 knowledge
⭐ Master of Knowledge	Reach 500 knowledge
🦊 Fox Friend	Help Felix
🔮 Touched Destiny	Touch the crystal in ruins
🌟 True Balance	Achieve the co-ruler ending
∞ Eternal Wanderer	Choose to merge with Crown

Moral Choices Guide

The Power of Morality

Your morality stat is the most important factor in the game. It affects:

• Which endings are available
• How characters react to you
• Secret paths that unlock
• The ultimate fate of the kingdom

Examples of Moral Choices

Good Morality Choices (+10 to +20):

• Help those in need
• Show mercy to enemies
• Choose diplomacy over violence
• Keep your promises
• Sacrifice for others

Evil Morality Choices (-10 to -20):

• Harm innocents
• Betray allies
• Choose selfish gain
• Ignore suffering
• Break promises

Neutral Choices:

• Focus on practical concerns
• Avoid involvement
• Choose inaction

Save System

Your progress is automatically saved to the saves/ folder.

Save Slots:

• autosave - Default quick save
• Custom names - Create named saves for different story branches

Pro Tip: Save before major story decisions to explore different outcomes!

Character Companions

Throughout your journey, you may meet allies who join you:

Companion	How to Recruit	Benefits
🦊 Felix	Talk to him at the forest entrance	Safe paths, shortcuts, lore
👤 Orion	Find the hidden trail with Felix	Reveals the Crown's true purpose
🧙‍♀️ Zora	Visit the witch's cottage	Potions, knowledge, or warnings
💚 Elara	Rescue her on the mountain path	Healing, companionship

Walkthrough Hints

Stuck? Here are some hints (spoilers minimal):

Beginning:

• Talk to the fox! He's a valuable guide.
• The ruins contain valuable knowledge.
• The witch's cottage offers help... at a price.

Middle:

• Explore all three mountain paths for different experiences.
• The Shadow General can be defeated in multiple ways.
• Knowledge unlocks special dialogue options.

End Game:

• Your morality determines which endings are available.
• Meeting the Shadow King reveals the truth.
• The "best" ending requires high morality AND making the right final choice.

For Creators

Want to create your own text adventure game? This game includes a full game engine that's easy to modify.

Key Files:

• scripts/engine.py - The game engine
• scripts/example_game.json - The game script (easily editable!)
• scripts/play.py - The game player

To Create Your Own Game:

1. Copy example_game.json as a template
2. Edit scenes, choices, and endings
3. Run python3 scripts/play.py to test

The JSON format is straightforward - no programming needed!

Game Info

• Title: The Enchanted Journey
• Genre: Text Adventure / Interactive Fiction
• Playtime: 30-60 minutes per playthrough
• Replayability: High (6 endings, secret paths)
• Difficulty: Easy to learn, choices matter

Troubleshooting

Game won't start?

• Make sure Python 3 is installed: python3 --version
• Check you're in the correct directory

Lost your save?

• Saves are in the saves/ folder
• Each save is a JSON file you can back up

Want to restart?

• Delete saves in saves/ folder
• Or just load autosave and make different choices

---

Enjoy your adventure! 🗝️✨

Version: 2.0 | Created with love for interactive fiction fans everywhere