X Tutup
Skip to content

pro-grammer-SD/mini_platformer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

🎮 Epic Platformer - All Assets Edition

A vibrant, action-packed 2D platformer built with Python and Arcade


✨ About the Game

Epic Platformer is an exciting platformer adventure featuring colorful characters, challenging levels, and classic arcade-style gameplay. Jump across floating platforms, collect coins and gems, avoid hazards, and reach the door to progress through increasingly difficult levels!

🎨 Features

  • 5 Playable Characters – Choose from Beige, Green, Pink, Purple, or Yellow characters
  • Dynamic Level Design – Multiple floating platforms, hazards, and interactive elements
  • Collectibles System – Gather coins (+10 points), gems (+25 points), and hearts for extra lives
  • High Quality Assets - Derived from kenney.nl, the assets are of very high quality.
  • Smooth Animations – Idle, walk, and jump animations with sprite flipping
  • Enemy AI – Patrolling frogs that move back and forth
  • Sound Effects – Jump, coin collection, gem collection, hurt, and magic level-up sounds
  • Camera System – Smooth camera following for immersive gameplay
  • Progressive Levels – Advance through levels by reaching the exit door

🎮 How to Play

Controls

  • W – Move Right
  • E – Move Left
  • S – Jump

Objective

Collect coins and gems, avoid spikes and enemies, and reach the door to advance to the next level. You start with 5 lives—don't lose them all!

Scoring

  • 🪙 Coin = +10 points
  • 💎 Gem = +25 points
  • ❤️ Heart = +1 life (max health)

⚠️ Current Status

🚧 UNDER DEVELOPMENT 🚧

This game is currently in an early development stage and has not been extensively played tested yet. While the core mechanics are in place, there may be occasional glitches and balance issues.

One such example is the game being unplayable due to the character weirdly glitching and falling when the game starts. Also, another one is that the camera position is beyond the background.

So, technically, though you cannot play this game right now, but you can give feedback.

Known Issues

  • ⚠️ Occasional physics edge cases
  • ⚠️ Platform collision refinements needed
  • ⚠️ Camera positioning improvements in progress
  • ⚠️ Asset loading dependencies

Coming Soon 🔜

I am actively working on squashing bugs and improving the experience! The next update will include:

  • ✅ Enhanced collision detection
  • ✅ Improved camera behavior
  • ✅ Better platform stability
  • ✅ Additional levels and content
  • ✅ Quality of life improvements

🛠️ Technical Details

Requirements

  • Python 3.10 or higher.
  • arcade library

Installation

pip install arcade

Assets Structure

assets/
    ├───Sounds/
    ├───Sprites/
    │   ├───Backgrounds/
    │   │   ├───Default/
    │   │   └───Double/
    │   ├───Characters/
    │   │   ├───Default/
    │   │   └───Double/
    │   ├───Enemies/
    │   │   ├───Default/
    │   │   └───Double/
    │   └───Tiles/
    │       ├───Default/
    │       └───Double/
    ├───Spritesheets/
    └───Vector/
        ├───Backgrounds/
        ├───Characters/
        ├───Enemies/
        └───Tiles/

Running the Game

python platformer.py

🤝 Contributing

Found a bug? Have suggestions? I would love to hear from you! This project is actively being developed and refined.


📝 License

This project uses Arcade library assets and custom game design.


🎪 Game Features Breakdown

Character System

Five unique character sprites with direction-aware animations:

  • Walking (2-frame animation)
  • Idle (static pose)
  • Jumping (mid-air sprite)

Platform Variety

  • Ground Platforms – Continuous base platform across the level
  • Floating Platforms – Strategic platforms for skilled navigation
  • Hazards – Moving spikes to avoid
  • Collectibles – Animated coins, gems, and heart pickups

Enemy Behavior

Intelligent frog enemies patrol specific ranges, providing engaging obstacles for players to avoid or jump over.


🌟 Special Thanks

Built with ❤️ using the Python arcade library – A fantastic framework for 2D game development!


Status: 🔧 In Development | Next Update: Coming Soon

Enjoy the game, and stay tuned for improvements! 🚀

Releases

No releases published

Packages

 
 
 

Contributors

Languages

X Tutup