Skip to content

doribd/eaterai

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

11 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿค– EaterAI

A classic arcade-style game where you eat dots while dodging intelligent AI robots that learn your movement patterns and get smarter over time!

EaterAI Game React AI

๐ŸŽฎ Game Features

  • ๐Ÿง  Intelligent AI: Robots that learn your movement patterns and adapt their hunting strategies
  • ๐Ÿ“ˆ Progressive Difficulty: Each level adds more robots AND makes them smarter
  • โš™๏ธ Fully Configurable: Customize robot count, lives, completion percentage, and power-up duration
  • ๐Ÿ† Persistent Leaderboard: Top 3 high scores with player names saved locally
  • ๐ŸŽฏ Classic Gameplay: Eat dots, avoid robots, grab power-ups to turn the tables
  • ๐ŸŽจ Modern UI: Clean, responsive design with smooth animations

๐Ÿš€ How to Play

  1. Enter your name and click "Start Game"
  2. Use arrow keys to move your yellow character around the maze
  3. Eat the yellow dots to score points and progress through the level
  4. Avoid the red robots - they're learning your patterns and getting smarter!
  5. Grab green power-ups to temporarily become invincible and eat the robots
  6. Complete 80% of the board to advance to the next level
  7. Survive and score high to make it onto the top 3 leaderboard!

๐ŸŽฏ Game Controls

  • โ†‘ โ†“ โ† โ†’ Arrow Keys: Move your character
  • Configuration Menu: Adjust game settings
  • High Scores: View the top 3 players

๐Ÿ› ๏ธ Installation & Setup

Prerequisites

  • Node.js (version 14 or higher)
  • npm (comes with Node.js)

Local Development

  1. Clone the repository

    git clone https://github.com/yourusername/eaterai.git
    cd eaterai
  2. Install dependencies

    npm install
  3. Start the development server

    npm start
  4. Open your browser and navigate to http://localhost:3000

Build for Production

npm run build

This creates a build folder with optimized production files.

๐ŸŒ Deploy to GitHub Pages

  1. Update package.json with your GitHub username:

    "homepage": "https://yourusername.github.io/eaterai"
  2. Install gh-pages (if not already installed):

    npm install --save-dev gh-pages
  3. Deploy to GitHub Pages:

    npm run deploy

Your game will be live at https://yourusername.github.io/eaterai

๐Ÿค– AI Features

The robots in EaterAI aren't just simple chasers - they're genuinely intelligent:

  • Pattern Recognition: Robots remember where you've been and predict where you're going
  • Adaptive Pathfinding: AI learns your favorite escape routes and cuts them off
  • Cross-Level Learning: Robots get smarter between levels, not just more numerous
  • Coordinated Hunting: Multiple robots work together to corner you
  • Dynamic Difficulty: The challenge evolves based on your playstyle

๐ŸŽ›๏ธ Configuration Options

Customize your experience:

  • Starting Robots: 1-8 robots to begin with
  • Lives: 1-5 lives per game
  • Completion Percentage: 70-90% board completion to advance
  • Power-up Duration: 3-10 seconds of invincibility

๐Ÿ—๏ธ Built With

  • React 18.2.0 - Frontend framework
  • Tailwind CSS - Styling and animations
  • Lucide React - Modern icons
  • Custom AI Algorithm - Smart robot behavior and learning

๐Ÿ“ฑ Browser Compatibility

EaterAI works on all modern browsers:

  • Chrome, Firefox, Safari, Edge
  • Mobile browsers (iOS Safari, Chrome Mobile)
  • Responsive design for desktop and mobile

๐Ÿค Contributing

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

๐Ÿ“„ License

This project is open source and available under the MIT License.

๐ŸŽฏ Game Tips

  • Study the robots: They learn from your movements, so try changing your patterns!
  • Use walls strategically: Corner yourself deliberately to force robots into predictable paths
  • Save power-ups: Don't grab them immediately - wait for the right moment
  • Watch the progress bar: You only need 80% completion, so plan your route efficiently
  • Each level teaches the AI: The robots get smarter, so adapt your strategy!

๐Ÿ› Bug Reports

Found a bug? Please open an issue with:

  • Description of the problem
  • Steps to reproduce
  • Expected vs actual behavior
  • Browser and device information

โญ Star this Repository

If you enjoyed EaterAI, please give it a star! It helps others discover the game.


Happy Gaming! ๐ŸŽฎ

Challenge yourself against AI that actually learns and evolves. Can you outsmart the machines?

About

๐ŸŽฎ Arcade game featuring AI robots that learn and evolve their hunting strategies as you play. Built with React.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors