Skip to content

jasonbrianhall/willytheworm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

54829f1 ยท Jan 6, 2025
May 18, 2023
Apr 22, 2023
Jan 2, 2025
Jul 7, 2023
Apr 22, 2023
Apr 22, 2023
Apr 10, 2023
Jan 2, 2025
Oct 11, 2024
Aug 6, 2023
Aug 23, 2023
Jun 27, 2023
Jan 6, 2025
Oct 10, 2023
Oct 11, 2024
Apr 7, 2023
Jan 6, 2025

Repository files navigation

๐Ÿ› Willy the Worm: A Retro Gaming Adventure! ๐Ÿ•น๏ธ

Willy the Worm Banner

๐ŸŒŸ Dive into the Quirky World of Willy! ๐ŸŒŸ

Ever wondered what it's like to be a worm with a passion for adventure? Look no further! Willy the Worm is here to squirm into your heart and provide hours of nostalgic fun!

๐ŸŽฎ What's the Buzz About?

Willy isn't your average earthworm. He's a:

  • ๐Ÿชœ Ladder-climbing extraordinaire
  • ๐Ÿฆ˜ Spring-bouncing champion
  • ๐ŸŽ Present-hunting aficionado
  • ๐Ÿ”” Bell-ringing enthusiast

But watch out! Willy's world is full of perilous tacks and mischievous bouncing balls. Can you help him navigate through the challenges?

Level 1 Screenshot

๐Ÿ•น๏ธ How to Play

  • Use arrow keys โ†ค โ†ฅ โ†ฆ โ†ง to guide Willy
  • Smash that spacebar to make him jump
  • Any other key? Willy takes a breather!

๐Ÿš€ Features That'll Make You Go "Wow!"

  • ๐Ÿ“บ Fullscreen toggle with F11
  • ๐ŸŒˆ Dynamic screen color changes (F5, F6, F7)
  • ๐ŸŽน WASD support for the cool kids
  • โšก Adjustable game speed
  • ๐Ÿ–ฑ๏ธ Mouse support for the pointer-inclined

๐Ÿ› ๏ธ Customization at Your Fingertips

Tweak your Willy experience with these command-line options:

./willy.py 
    -l level           (Start at a specific level)
    -b numberofballs   (Adjust ball count)
    -w                 (Enable WASD controls)
    -f                 (Disable flash effects)
    -F framespersecond (Speed up or slow down)
    -m                 (Enable mouse support)
    -h or --help       (Show all options)

๐ŸŽจ Unleash Your Creativity with the Level Editor!

Think you can create the ultimate Willy challenge? Fire up edwilly.py and let your imagination run wild!

Editor Hotkeys:

  • F11: Toggle fullscreen
  • S: Save your masterpiece
  • L: Jump to next level
  • Left click: Place objects
  • Right click: Remove objects
  • Scroll: Cycle through items
  • P: Playtest your creation

๐ŸŒŸ What Makes a Willy Level Shine?

Every great level needs:

  1. Willy (of course!)
  2. Two ball pits (the last one placed is where the action starts)
  3. A bell (Willy's ultimate goal!)
  4. Your creative touch of obstacles and challenges!

๐ŸŽต A Symphony of Nostalgia

While we've updated the audio for modern ears, the spirit of the original game lives on. We've even added an option to disable screen flashes for our photosensitive friends!

๐ŸŽจ Customize Willy's Look with HD Sprites!

Want to give Willy and friends a high-definition makeover? Check out the HD Sprite Tool in hd/hd.py! Transform those classic 8x8 sprites into glorious 128x128 HD versions.

Quick Start with HD Sprites:

# Extract existing sprites
pip install -r hd/requirements.txt (one time only)
python hd/hd.py extract --input willy.chr --output hd/sprites/

# Customize sprites in your favorite image editor
# Create new HD chr file
python hd/hd.py create --input hd/sprites/ --output willy.chr

๐Ÿš€ Ready to Dive In?

  1. Clone this repo
  2. Run pip install -r requirements.txt
  3. Launch with ./willy.py

๐ŸŒ Spread the Willy Love!

Enjoyed your wormy adventure? Don't keep it to yourself:

  • ๐ŸŒŸ Star this repo
  • ๐Ÿด Fork it and add your twist
  • ๐Ÿ“ฃ Share it with fellow retro gaming enthusiasts

๐Ÿ‘ฅ Join the Willy Community!

Created something cool? Found a bug? Want to chat about worm physics? Open an issue or submit a pull request. Let's make Willy the talk of the town!

๐Ÿ“š Additional Resources

  • Wiki: Detailed game mechanics, characters, items, and level design tips
  • Contribution Guide: Learn how to contribute to Willy the Worm

๐ŸŽ‰ Willy the Worm - Bringing joy to invertebrate enthusiasts since 2023! ๐ŸŽ‰

Original Pascal version by Alan Farmer (1985)
Python reincarnation by Jason Hall (jasonbrianhall@gmail.com)

This code is FOSS (Free and Open-Source Software). Remix it, share it, love it! ๐Ÿ’–


Keywords: retro gaming, platformer, Python game, open-source game, Willy the Worm, level editor, nostalgic games, indie game, 2D game, arcade-style game