Skip to content

๐Ÿ follow-the-white-rabbit-python CMD/terminal adventure โ€” Python port of Follow the White Rabbit. Simple, fast, and easy to hack on.

Notifications You must be signed in to change notification settings

GhostArmyIntel/follow-the-white-rabbit-python

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

1 Commit
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿฐ Follow the White Rabbit

"I imagine right now you're feeling a bit like Alice, tumbling down the rabbit hole?"

A command-line mystery game that weaves together The Matrix and Alice in Wonderland into an interactive narrative experience. Make choices, discover secrets, and explore the philosophical questions at the heart of both stories.


๐ŸŽฎ About

Follow the White Rabbit is a text-based adventure that explores the deep connections between Lewis Carroll's Alice's Adventures in Wonderland / Through the Looking-Glass and the Wachowskis' The Matrix trilogy.

The game examines timeless questions:

  • What is reality vs. simulation vs. dream?
  • Who are you when identity itself is a choice?
  • What happens when you question everything you've been told?

Players navigate a branching narrative filled with riddles, philosophical choices, and easter eggs from both source materials.


โœจ Features

  • โšก 5 Unique Endings - Each path reveals different truths
  • ๐ŸŽญ Multiple Story Branches - Your choices truly matter
  • ๐ŸŽจ Matrix-Style Terminal Effects - Green code rain, typing animations
  • ๐Ÿ•ณ๏ธ Deep Easter Eggs - Dozens of references to both Matrix & Alice lore
  • ๐Ÿ” Secret Paths - Hidden routes for curious players
  • ๐Ÿ”„ High Replay Value - Discover all the paths and endings

๐Ÿš€ Getting Started

Prerequisites

  • Python 3.6 or higher
  • A terminal that supports ANSI color codes (most modern terminals do)

Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/white-rabbit.git
    cd white-rabbit
  2. Run the game:

    python white_rabbit.py

That's it! No external dependencies required.


๐ŸŽฏ How to Play

  • Read the story text as it appears
  • Make choices by typing numbers (1, 2, 3, etc.) or keywords
  • Type your choice and press Enter
  • Some paths have secret keywords - experiment!
  • Press Ctrl+C to exit at any time

Tips for Players

  • ๐Ÿ’ก Pay attention to quotes - they're often clues
  • ๐Ÿ” Try typing unusual responses when prompted
  • ๐Ÿฑ Curiosity is rewarded in Wonderland
  • ๐Ÿ” Play multiple times to see all endings
  • ๐Ÿ“ Not all paths are obvious - some are hidden

๐Ÿ“– The 5 Endings

Without spoiling too much, here are the endings you can discover:

  1. ๐Ÿ‡ THE GUIDE - Become the eternal messenger
  2. ๐Ÿ—๏ธ THE ARCHITECT - Transform the system itself
  3. ๐Ÿ’€ THE VOID - Sometimes the cure is worse than the disease
  4. ๐Ÿ’ค THE DREAM - Safety over truth
  5. ๐Ÿ˜ธ THE GRIN - [HIDDEN] - Find the secret path...

๐Ÿ•ต๏ธ Easter Eggs & References

This game is packed with references to both The Matrix trilogy and Alice in Wonderland/Through the Looking-Glass. Here are just a few:

Matrix References

  • Red pill / Blue pill choice
  • "Follow the White Rabbit"
  • Agent Smith, Jones, Brown
  • The Oracle's kitchen & cookie
  • "There is no spoon"
  • Morpheus as guide/Cheshire Cat
  • Switch character (white + pink)
  • "Know Thyself" plaque
  • Liquid mirror / Looking Glass Server
  • Red Queen as system firewall
  • Nebuchadnezzar references

Alice in Wonderland References

  • White Rabbit's pocket watch / "I'm late!"
  • Mad Hatter's Tea Party
  • Dormouse sleeping on server racks
  • March Hare adjusting reality
  • "Eat Me" / "Drink Me" (pills, cookie, tea)
  • Cheshire Cat's grin & riddles
  • "Who in the world am I?"
  • Red Queen's "Off with their heads!"
  • White Queen transformation
  • Pool of Tears
  • Checkered chessboard floor
  • "Curiouser and curiouser"
  • "We're all mad here"
  • Looking-Glass world
  • "Whose dream are we in?" (Red King)
  • Name/identity themes
  • Humpty Dumpty's word philosophy

Philosophical Parallels

  • Plato's Cave allegory
  • Descartes' "Doubting Thomas" / evil deceiver
  • Simulation vs. reality vs. dream
  • Identity as choice, not prison
  • "The Matrix cannot tell you who you are"
  • Questions that drive us vs. answers

๐Ÿ“š Story Structure

Chapter Breakdown

CHAPTER 1: THE KNOCK

  • The mysterious visitor at 3:33 AM
  • The white rabbit tattoo
  • The red pill / blue pill choice
  • Secret Cheshire path

CHAPTER 2: DOWN THE RABBIT HOLE (Red pill only)

  • Mad Hatter's impossible tea party
  • Riddles about reality and dreams
  • "Know Thyself" philosophy
  • Oracle's cookie choice
  • Agent chase sequence

CHAPTER 3: THE LOOKING GLASS SERVER (Red pill only)

  • The liquid mirror
  • Meeting your reflection
  • Confronting the Red Queen
  • The final choice: Guide, Destroy, or Evolve
  • Chessboard revelation

๐ŸŽจ Technical Details

Game Mechanics

  • Branching narrative engine - Choices affect story flow
  • ANSI color system - Terminal colors for atmosphere
  • Typing animation - Adjustable text speed
  • Matrix rain effect - Falling green code
  • Input validation - Accepts multiple answer formats
  • Replay system - Start over without restarting

Color Coding

  • ๐ŸŸข GREEN - Matrix code, truth, system messages
  • ๐Ÿ”ด RED - Danger, Red Queen, warnings, red pill
  • ๐Ÿ”ต BLUE - Illusion, blue pill, choice
  • โšช WHITE - White Rabbit, purity, revelation
  • ๐ŸŸก YELLOW - Questions, prompts, uncertainty
  • ๐Ÿ”ท CYAN - Cheshire Cat, philosophy, guides

๐ŸŽ“ Educational Context

This game explores the deep philosophical connections between The Matrix and Alice in Wonderland that the Wachowskis intentionally wove into their film.

Why Matrix ร— Alice?

The Wachowski siblings were massive fans of Lewis Carroll and deliberately referenced Alice throughout The Matrix:

  1. Dual Worlds - Wonderland/Real World โ†” Matrix/Reality
  2. Identity Crisis - "Who am I?" drives both protagonists
  3. The Guide Figure - White Rabbit/Cheshire Cat โ†” Morpheus/Trinity
  4. Ingestibles - "Drink Me"/"Eat Me" โ†” Red/Blue pills
  5. Dream vs. Reality - "Am I dreaming?" in both stories
  6. Authority Figures - Queen of Hearts/Card Guards โ†” Agents/Red Queen
  7. The Mirror - Looking Glass โ†” Liquid mirror scene
  8. Transformation - Size changes โ†” Seeing the code
  9. Curiosity Rewarded - Alice's questions โ†” Neo's searching

Philosophical Themes

Both works tackle:

  • Epistemology - What can we know? How do we know it?
  • Ontology - What is real? What is existence?
  • Free Will - Are our choices our own?
  • Identity - Who are we, really?
  • Simulation Theory - Could reality be a construct?

๐Ÿค Contributing

Contributions are welcome! Here are some ways you can help:

  • ๐Ÿ› Report bugs or issues
  • ๐Ÿ’ก Suggest new easter eggs or references
  • โœ๏ธ Improve story branches or dialogue
  • ๐ŸŽจ Add new terminal effects
  • ๐Ÿ“– Enhance documentation
  • ๐ŸŒ Translate to other languages

To Contribute:

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

๐Ÿ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.

This is a fan project and is not affiliated with or endorsed by:

  • Warner Bros. (The Matrix)
  • The Wachowskis
  • Lewis Carroll's estate
  • Any official Matrix or Alice in Wonderland properties

๐Ÿ™ Acknowledgments

  • The Wachowskis - For creating The Matrix and its philosophical depth
  • Lewis Carroll - For Alice's Adventures in Wonderland and Through the Looking-Glass
  • Film analysts & fans - Whose research revealed the connections between these works
  • Players like you - For following the white rabbit

๐Ÿ“ฌ Contact

Questions? Feedback? Found all 5 endings?

  • Open an issue on GitHub
  • Share your favorite ending!
  • Tell us what easter eggs you discovered

๐ŸŽฏ Quick Commands

# Run the game
python white_rabbit.py

# Exit the game (during play)
Ctrl + C

# Replay after finishing
Type 'yes' when prompted

๐Ÿ‡ Final Words

"The Matrix cannot tell you who you are."

"'Who in the world am I?' Ah, that's the great puzzle!"

The rabbit hole awaits. Will you follow?


"Curiouser and curiouser..." ๐Ÿฐโœจ

About

๐Ÿ follow-the-white-rabbit-python CMD/terminal adventure โ€” Python port of Follow the White Rabbit. Simple, fast, and easy to hack on.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages