An endless runner game inspired by Pudge character from DOTA 2. Dodge obstacles and achieve the highest score possible!
๐ฎ Play Now | ๐ Documentation | ๐ Report Issues | ๐ค Contribute
- Responsive Jump System - Precise character control with smooth physics
- Dynamic Obstacles - Multiple enemy types with unique behaviors
- Progressive Difficulty - Gradually increasing challenge levels
- Persistent High Score - Local storage with cloud ranking integration
- Optimized Collision Detection - Forgiving hitboxes for better gameplay experience
- Modern Design System - Professional DOTA 2-themed interface
- Particle Effects - Jump trails, collision effects, and visual feedback
- Smooth Animations - Fluid character and obstacle movements
- Dynamic Parallax Background - Multi-layer depth system
- Desktop UI - Optimized interface for web browsers
- Glass-morphism Effects - Modern translucent design elements
- Modular ES6 Architecture - Clean, maintainable object-oriented code
- Robust Asset Management - Fallback system for failed sprite loads
- Keyboard Controls - Optimized desktop input handling
- Auto-pause System - Automatic pause when tab loses focus
- Error Handling - Comprehensive error recovery and debugging
- Modern web browser (Chrome 80+, Firefox 75+, Safari 13+, Edge 80+)
- HTTP server for local development (included in npm scripts)
Open index.html directly in your browser for quick testing (some features may require HTTP server).
- SPACE - Jump
- P - Pause/Unpause
- R - Restart (when game over)
- Dodge obstacles by jumping at the right moment
- Survive as long as possible to achieve higher scores
- Each dodged obstacle awards 10 points (multiplied by combo)
- Speed and obstacle frequency increase every 100 points
| Level | Name | Speed | Spawn Rate | Multi-Spawn | Score Required |
|---|---|---|---|---|---|
| 1 | Iniciante | 5 | 140 frames | 1 | 0 |
| 2 | Fรกcil | 6 | 130 frames | 1 | 100 |
| 3 | Normal | 7 | 120 frames | 1 | 200 |
| 4 | Difรญcil | 8 | 110 frames | 1 | 300 |
| 5 | Expert | 9 | 100 frames | 1 | 400 |
| 6 | Insano | 10 | 90 frames | 2 | 500 |
| 7 | Extremo | 11 | 85 frames | 2 | 600 |
| 8 | Lendรกrio | 12 | 80 frames | 2 | 700 |
| 9 | Mรญtico | 13 | 75 frames | 2 | 800 |
| 10 | Divino | 14 | 70 frames | 3 | 900 |
| 11 | Imortal | 15 | 65 frames | 3 | 1000 |
| 12 | Ancestral | 16 | 60 frames | 3 | 1100 |
| 13 | Transcendente | 17 | 55 frames | 3 | 1200 |
| 14 | Apocalรญptico | 18 | 50 frames | 4 | 1300 |
| 15 | Cataclรญsmico | 19 | 45 frames | 4 | 1400 |
| 16 | Impossรญvel | 20 | 40 frames | 4 | 1500 |
| 17+ | โ Infinito | 20+ | 40- frames | 4+ | 1600+ |
Multi-Enemy Spawns - Starting from level 6, multiple enemies spawn simultaneously
15 Different Enemy Types - Organized by difficulty tiers:
- Basic Enemies (Levels 1-5): Meepo, Ghost, Mad, Spoon
- Intermediate Enemies (Levels 6-10): Boss, Ghost02, Glad, Sad
- Advanced Enemies (Levels 11-15): Bat, Bloodthirsty, Necromancer
- Extreme Enemies (Levels 16+): Broodmother, Terrorblade
Advanced Enemy Behaviors - Each enemy type has unique characteristics:
- Flying Enemies (Bat, Ghost variants): Vertical movement and trail effects
- Magical Enemies (Necromancer): Death pulse abilities and dark auras
- Aggressive Enemies (Bloodthirsty): Enhanced speed when near player
- Heavy Enemies (Boss, Sad): Increased size and resistance
- Spawner Enemies (Broodmother): Can create minions in extreme levels
- Demon Enemies (Terrorblade): Metamorphosis and teleport abilities
Infinite Scaling - After level 16, difficulty continues to increase indefinitely:
- Speed increases by 0.5 per level
- Spawn rate decreases (more frequent spawns)
- Up to 6 enemies can spawn at once in extreme levels
Advanced Enemy Behaviors - Higher level enemies have special abilities:
- Vertical Movement (Nightmare Mode 10+): Ghosts and bosses move up and down
- Erratic Movement (Hell Mode 15+): Mad and spoon enemies move unpredictably
- Increased Size & Speed (All Advanced Enemies)
Stricter Collision Detection - Hitboxes become more precise at higher levels
Reduced Score Scaling - Points decrease in extreme levels to prevent infinite scoring
pudge-runner/
โโโ index.html # Main game file
โโโ package.json # NPM configuration
โโโ README.md # This documentation
โโโ LICENSE # MIT License
โโโ CONTRIBUTING.md # Contribution guidelines
โโโ assets/ # Game assets
โ โโโ style.css # Main CSS stylesheet
โ โโโ logo.png # Game icon
โ โโโ imgs/ # Sprites and images
โ โ โโโ pudg.gif # Player sprite
โ โ โโโ ground.png # Ground texture
โ โ โโโ background/ # Parallax layers
โ โ โโโ boss/ # Boss animation frames
โ โ โโโ meepo/ # Meepo enemy frames
โ โ โโโ ghost/ # Ghost enemy frames
โ โ โโโ mad/ # Mad enemy frames
โ โ โโโ spoon/ # Spoon enemy frames
โ โ โโโ pudge/ # Pudge enemy frames
โ โโโ sounds/ # Audio files
โ โโโ background.mp3 # Background music
โ โโโ kill.ogg # Kill sound effect
โ โโโ pudge_*.mpeg # Character voice lines
โโโ js/ # Modular JavaScript
โ โโโ main.js # Entry point
โ โโโ core/ # Core game modules
โ โ โโโ Game.js # Main game logic
โ โ โโโ AssetManager.js # Asset management
โ โ โโโ Player.js # Player class
โ โ โโโ Enemy.js # Enemy classes
โ โ โโโ Particle.js # Particle system
โ โ โโโ UI.js # User interface
โ โ โโโ Config.js # Game configuration
โ โ โโโ Utils.js # Utility functions
โ โโโ firebase-config.js # Firebase configuration
โ โโโ firebase-rank.js # Global ranking system
โโโ docs/ # Documentation
โโโ ARCHITECTURE.md # Technical architecture
โโโ DEPLOYMENT.md # Deployment instructions
โโโ API.md # API documentation
โโโ CHANGELOG.md # Version history
- โ Enhanced UI/UX Design - Complete interface redesign with premium styling
- โ Advanced CSS System - Professional design system with custom properties
- โ Modular Architecture - Complete ES6 modular architecture
- โ Enhanced Audio System - Robust synchronized audio management
- โ Premium Ranking System - Global leaderboard with elegant design
- โ Advanced Final Score - Professional game over screen with detailed stats
- โ Desktop Excellence - High-quality design optimized for web browsers
- ๐ Lives System - Multiple chances with visual regeneration
- ๐ Basic Power-ups - Invincibility, double jump, slow motion
- ๐ Expanded Achievements - 15+ unlockable achievements
- ๐ Audio Enhancements - Independent music/effects mixing
- ๐ Social Sharing - Share scores on social media
- ๐ Screenshot System - Capture epic moments
- ๐ Performance Analytics - Detailed gameplay telemetry
- ๐ PWA Conversion - Progressive Web App with native installation
- ๐ New Game Modes - Survival, Time Attack, Challenge Mode
- ๐ Boss Battles - Special bosses with unique mechanics
- ๐ Component System (ECS) - Entity-Component-System architecture
- ๐ 3D Audio & Haptic - Spatial audio and vibration feedback
Legend:
- โ Complete - Feature implemented and tested
- ๐ Planned - In development roadmap
- HTML5 Canvas - Game rendering optimized for desktop browsers
- JavaScript ES6+ Modules - Modular architecture with classes and imports/exports
- CSS3 Enhanced Design - Professional design system with custom properties
- Google Fonts - Orbitron & Montserrat for premium typography
- LocalStorage - Local data persistence and user preferences
- Firebase - Real-time global ranking system
- Canvas 2D Context - Advanced rendering with optimized performance
- CSS Grid & Flexbox - Professional desktop layout
- Web Audio API - Audio system with volume control
- Glass-morphism CSS - Modern transparency and blur effects
- โ Chrome/Chromium 80+
- โ Firefox 75+
- โ Safari 13+
- โ Edge 80+
- ๐ฅ๏ธ Desktop: 1366x768 or higher
- ๐ป Laptop: 1280x720 or higher
We welcome contributions! Please see our Contributing Guide for details.
- Fork the project
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
Based on the DOTA 2 universe by Valve Corporation. This is an unofficial fan-made project created for educational and entertainment purposes.
- Valve Corporation for DOTA 2 universe and characters
- The open-source community for inspiration and tools
- Contributors and players who make this project better
- ๐ Report Issues
- ๐ฌ Discussions
- ๐ง Contact: your-email@example.com
A complete evolution of the original concept, now featuring professional modular architecture, premium interface design, advanced audio system, and high-quality user experience.
v4.0 Highlights:
- ๐จ Redesigned interface with professional styling
- ๐๏ธ Complete ES6 modular architecture
- ๐ Synchronized and robust audio system
- ๏ฟฝ๏ธ Excellent desktop optimization
- ๐ Premium ranking system design
- โจ Advanced animations and visual effects
Developed with โค๏ธ for the DOTA 2 community | Enhanced Edition 2025