{"id":29161330,"url":"https://github.com/codemeapixel/8bitpixel","last_synced_at":"2025-07-14T01:12:10.532Z","repository":{"id":294141830,"uuid":"986020801","full_name":"CodeMeAPixel/8BitPixel","owner":"CodeMeAPixel","description":"8BitPixel Arcade is a modern web platform for retro-style pixel art games, built with Next.js, TypeScript, and our custom game engine 8BitGE. The platform features a growing collection of games designed to be playable across desktop and mobile devices.","archived":false,"fork":false,"pushed_at":"2025-05-19T03:24:37.000Z","size":4386,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-30T10:50:16.235Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CodeMeAPixel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-19T01:42:09.000Z","updated_at":"2025-05-19T03:24:40.000Z","dependencies_parsed_at":"2025-05-19T04:37:13.144Z","dependency_job_id":null,"html_url":"https://github.com/CodeMeAPixel/8BitPixel","commit_stats":null,"previous_names":["codemeapixel/8bitpixel"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/CodeMeAPixel/8BitPixel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeMeAPixel%2F8BitPixel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeMeAPixel%2F8BitPixel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeMeAPixel%2F8BitPixel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeMeAPixel%2F8BitPixel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CodeMeAPixel","download_url":"https://codeload.github.com/CodeMeAPixel/8BitPixel/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeMeAPixel%2F8BitPixel/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262887249,"owners_count":23379771,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-01T03:09:55.227Z","updated_at":"2025-07-01T03:09:56.214Z","avatar_url":"https://github.com/CodeMeAPixel.png","language":"TypeScript","readme":"# 8BitPixel Arcade\n\n8BitPixel Arcade is a modern web platform for retro-style pixel art games, built with Next.js, TypeScript, and our custom game engine 8BitGE. The platform features a growing collection of games designed to be playable across desktop and mobile devices.\n\n![8BitPixel Arcade](./public/images/8bitpixel-banner.png)\n\n## Features\n\n- 🎮 **Multiple Game Types**: Native games built directly into the platform and integrations with external games\n- 🎲 **Custom Game Engine**: 8BitGE (8BitPixel Game Engine) provides powerful tools for building pixel-perfect games\n- 📱 **Cross-Platform**: All games are responsive and work on desktop and mobile devices\n- 🏆 **Achievements \u0026 Leaderboards**: Track your progress and compete with other players\n- 🌈 **Pixel Art Aesthetic**: Consistent retro visual style across the platform\n- ⚡ **Modern Tech**: Fast, responsive, and built with cutting-edge web technologies\n\n## Games Collection\n\n### Native Games\n\nThese games run directly in your browser and are built specifically for the 8BitPixel platform:\n\n#### Word Isles\nConnect islands to form letter pairs that appear in the target word. Features an increasing difficulty curve with progressively longer words and time limits.\n\n#### Cat Mazes\nGuide a cat through procedurally generated mazes. Collect fish treats and find the exit door to progress to increasingly complex levels.\n\n#### Break the Ice\nA strategic puzzle game where you break ice blocks of varying thickness. Create combos and use power-ups to maximize your score within limited moves.\n\n#### Emoji Grid\nCreate meaningful emoji sequences by connecting related emoji patterns. Find combos and build chains to score points before time runs out.\n\n#### Cyber Pong\nA futuristic twist on the classic pong game, featuring neon graphics, particle effects, and progressively challenging AI.\n\n### 8BitGE-Powered Games\n\nThe following games utilize our custom 8BitPixel Game Engine (8BitGE) for enhanced performance, particles, physics, and more:\n\n- Cyber Pong\n- (More coming soon!)\n\n## Technology Stack\n\n- **Frontend**: Next.js 13+, React, TypeScript\n- **Styling**: Tailwind CSS\n- **Game Engine**: Custom 8BitGE engine built in TypeScript\n- **Animation**: Custom animation system with sprite support\n- **State Management**: React hooks and context\n- **Deployment**: Vercel\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js 16+\n- npm or yarn\n\n### Installation\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/codemeapixel/8bitpixel.git\n   cd 8bitpixel\n   ```\n\n2. Install dependencies:\n   ```bash\n   npm install\n   # or\n   yarn install\n   ```\n\n3. Start the development server:\n   ```bash\n   npm run dev\n   # or\n   yarn dev\n   ```\n\n4. Open your browser and navigate to:\n   ```\n   http://localhost:3000\n   ```\n\n## Game Development\n\n### Creating a New Game\n\nTo create a new game for the platform:\n\n1. Create a new component in `components/games/your-game.tsx`\n2. Register the game in `lib/games.ts`\n3. Add game metadata and description\n4. Implement the game logic and UI\n\n### Using 8BitGE\n\nTo use our custom game engine:\n\n1. Import the engine components:\n   ```typescript\n   import { createGame, GameStatus, ParticleBlendMode } from '@/8bitge'\n   ```\n\n2. Initialize the engine:\n   ```typescript\n   const engine = createGame({\n     gameId: 'your-game-id',\n     element: containerRef.current,\n     width: 800,\n     height: 600,\n     pixelPerfect: true\n   });\n   ```\n\n3. Set up event listeners and rendering:\n   ```typescript\n   engine.on('update', ({ deltaTime }) =\u003e {\n     // Update game logic\n   });\n   \n   engine.on('render', ({ context }) =\u003e {\n     // Draw your game\n   });\n   ```\n\n## Project Structure\n\n- `/8bitge/` - Custom game engine\n- `/app/` - Next.js app router pages\n- `/components/` - React components\n- `/components/games/` - Individual game implementations\n- `/lib/` - Utility functions and game registry\n- `/public/` - Static assets\n\n## Contributing\n\nWe welcome contributions to 8BitPixel Arcade! Whether you want to fix bugs, improve features, or add new games, please follow these steps:\n\n1. Fork the repository\n2. Create a new branch (`git checkout -b feature/amazing-game`)\n3. Make your changes\n4. Run tests and ensure everything works\n5. Commit your changes (`git commit -m 'Add amazing game'`)\n6. Push to your branch (`git push origin feature/amazing-game`)\n7. Open a Pull Request\n\n## Future Plans\n\nSee our [FuturePlans.md](./FuturePlans.md) for upcoming features and improvements.\n\n## Security\n\nWe take the security of 8BitPixel Arcade seriously. For more information about reporting vulnerabilities and our security policies, please see our [Security Policy](./SECURITY.md).\n\n## License\n\nThis project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0) - see the [LICENSE](./LICENSE) file for details.\n\nThe AGPL-3.0 license ensures that all users who interact with the software over a network have access to the source code. If you modify the code and share it with others or use it to provide a service over a network, you must also share your source code under the same license terms.\n\n## Acknowledgements\n\n- All game developers and contributors\n- Open-source projects that made this platform possible\n- The retro gaming community for inspiration","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodemeapixel%2F8bitpixel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodemeapixel%2F8bitpixel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodemeapixel%2F8bitpixel/lists"}