{"id":48908847,"url":"https://github.com/gungwang/home-game","last_synced_at":"2026-04-16T22:04:02.577Z","repository":{"id":347587940,"uuid":"1194164508","full_name":"gungwang/home-game","owner":"gungwang","description":"Dragon VS New York | 飞龙大战纽约","archived":false,"fork":false,"pushed_at":"2026-04-06T22:10:46.000Z","size":80786,"stargazers_count":1,"open_issues_count":6,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-06T23:21:54.217Z","etag":null,"topics":["2d-game","ai","ai-driven","ai-driven-development","ai-game","cyberpunk-game","dragon-game","game","game-development","nextjs","office-games","phaser3","reactjs","shooting-game","vite","web-game","webgame"],"latest_commit_sha":null,"homepage":"https://gungwang.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gungwang.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-28T01:59:48.000Z","updated_at":"2026-04-06T22:10:50.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gungwang/home-game","commit_stats":null,"previous_names":["gungwang/home-game"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gungwang/home-game","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gungwang%2Fhome-game","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gungwang%2Fhome-game/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gungwang%2Fhome-game/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gungwang%2Fhome-game/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gungwang","download_url":"https://codeload.github.com/gungwang/home-game/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gungwang%2Fhome-game/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31905895,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T18:22:33.417Z","status":"ssl_error","status_checked_at":"2026-04-16T18:21:47.142Z","response_time":69,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["2d-game","ai","ai-driven","ai-driven-development","ai-game","cyberpunk-game","dragon-game","game","game-development","nextjs","office-games","phaser3","reactjs","shooting-game","vite","web-game","webgame"],"created_at":"2026-04-16T22:03:53.162Z","updated_at":"2026-04-16T22:04:02.548Z","avatar_url":"https://github.com/gungwang.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dragon vs New York\n\n[中文说明](./README_CN.md)\n\n[![MIT License](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)\n![React](https://img.shields.io/badge/React-19-blue)\n![Phaser](https://img.shields.io/badge/Phaser-3-2b2d42)\n![TypeScript](https://img.shields.io/badge/TypeScript-6-3178c6)\n![Vite](https://img.shields.io/badge/Vite-8-646cff)\n\nA cyberpunk-themed 2D side-scrolling web shooter built with React, Phaser 3, and TypeScript.\n\nYou pilot a dragon across Manhattan, fight mutated farm-animal monsters on rooftops, trigger music-video moments between stages, and finish the run with a resume-style ending screen. The project is designed as both a game and a personal portfolio experience.\n\n- GitHub: https://github.com/gungwang/home-game\n- Demo: https://gungwang.com/\n\n## Screenshots\n### Mobile Friendly \u0026 Mobile Control\n![Gameplay screenshot 1](./image-4.png)\n![Gameplay screenshot 1](./image-5.png)\n![Gameplay screenshot 2](./image-2.png)\n![Gameplay screenshot 4](./image.png)\n\n## Gameplay Video\n\n![Gameplay GIF](./dragon-newyork1-gif.gif)\n\nIf the animated preview does not render on your GitHub client, open it directly: [dragon-newyork1-gif.gif](./dragon-newyork1-gif.gif)\n\n## Highlights\n\n- Cyberpunk Manhattan skyline with weather, lighting, and day/night transitions\n- Dual-weapon combat with fireballs, missiles, upgrades, and boss encounters\n- YouTube MV integration between level milestones\n- Resume and portfolio presentation after game completion\n- Keyboard and mouse controls for arcade-style movement and combat\n\n## Tech Stack\n\n- React 19\n- TypeScript\n- Phaser 3\n- Vite\n- Tailwind CSS\n- react-youtube\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js 20 or newer recommended\n- npm 10 or newer recommended\n\n### Installation\n\n```bash\ngit clone https://github.com/gungwang/home-game.git\ncd home-game\nnpm install\n```\n\n### Start the Development Server\n\n```bash\nnpm run dev\n```\n\nThen open the local URL shown by Vite, usually `http://localhost:5173`.\n\nIf port `5173` is already in use, Vite automatically selects another available port.\n\n## Available Scripts\n\n```bash\nnpm run dev      # start the local dev server\nnpm run build    # type-check and create a production build\nnpm run preview  # preview the production build locally\n```\n\n## Controls\n\n- Move: `WASD` or arrow keys\n- Fireball: left mouse button\n- Missile: right mouse button\n\n## Project Structure\n\n```text\nsrc/\n\tcomponents/           React UI and overlay components\n\tgame/                 Phaser configuration, events, and scenes\n\tApp.tsx               top-level application shell\npublic/                 sprites, backgrounds, sound effects, and icons\ndocs/                   design notes and feature plans\n```\n\n## Architecture\n\n```mermaid\nflowchart TD\n\tA[React App] --\u003e B[GameCanvas]\n\tA --\u003e C[UIOverlay]\n\tA --\u003e D[VideoModal]\n\tA --\u003e E[ResumeScreen]\n\tA --\u003e F[BackgroundMusicPlayer]\n\tB --\u003e G[Phaser Game]\n\tG --\u003e H[GameConfig]\n\tG --\u003e I[MainScene]\n\tI --\u003e J[GameEvents]\n\tJ --\u003e A\n\tI --\u003e K[Assets from public/]\n\tD --\u003e J\n\tF --\u003e J\n```\n\n## Roadmap\n\n- Improve stage variety across Manhattan districts and boss pacing\n- Expand enemy types, attack patterns, and upgrade combinations\n- Add richer content transitions between gameplay, video moments, and resume scenes\n- Improve onboarding, difficulty tuning, and mobile-friendly presentation\n- Add stronger automation for regression checks and content QA\n\n## Development Notes\n\n- The main gameplay loop lives in `src/game/scenes/MainScene.ts`\n- React components in `src/components/` handle overlays, video playback, and resume screens\n- Vite is configured to build both the game entry page and `README.html`\n\n## Contributing\n\nContributions, balancing ideas, bug reports, and content improvements are welcome.\n\n- Contribution guide: [CONTRIBUTING.md](./CONTRIBUTING.md)\n- Code of conduct: [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md)\n\n## License\n\nThis project is licensed under the MIT License. See [LICENSE](./LICENSE) for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgungwang%2Fhome-game","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgungwang%2Fhome-game","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgungwang%2Fhome-game/lists"}