{"id":50127391,"url":"https://github.com/zefir1990/mars-miners-client","last_synced_at":"2026-05-23T20:34:44.465Z","repository":{"id":339790081,"uuid":"1129314633","full_name":"zefir1990/mars-miners-client","owner":"zefir1990","description":"Mars miners game client","archived":false,"fork":false,"pushed_at":"2026-04-24T08:01:10.000Z","size":65417,"stargazers_count":0,"open_issues_count":11,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-24T09:41:05.887Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/zefir1990.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":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-01-06T23:15:22.000Z","updated_at":"2026-04-12T18:39:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zefir1990/mars-miners-client","commit_stats":null,"previous_names":["zefir1990/mars-miners-client"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zefir1990/mars-miners-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zefir1990%2Fmars-miners-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zefir1990%2Fmars-miners-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zefir1990%2Fmars-miners-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zefir1990%2Fmars-miners-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zefir1990","download_url":"https://codeload.github.com/zefir1990/mars-miners-client/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zefir1990%2Fmars-miners-client/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33412082,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T18:09:33.147Z","status":"ssl_error","status_checked_at":"2026-05-23T18:09:31.380Z","response_time":53,"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":[],"created_at":"2026-05-23T20:34:43.790Z","updated_at":"2026-05-23T20:34:44.457Z","avatar_url":"https://github.com/zefir1990.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mars Miners\n\n[**Play Online Demo**](https://demensdeum.com/demos/mars-miners/)\n\nMars Miners is a turn-based strategy game for 4 players (Human or AI). Build stations to expand your territory, mines to gather resources, and lasers to destroy your enemies. Be the last miner standing or gather the most resources to win!\n\n## Features\n\n- **Strategic Gameplay**: Balance expansion (`Stations`), resource gathering (`Mines`), and aggression (`Lasers`).\n- **Game Modes**:\n  - **Singleplayer**: Play against 3 AI opponents.\n  - **Multiplayer**: Real-time battles via WebSocket server. Supports joining via Session ID.\n- **Battle Log \u0026 Replays**: Every move is recorded. Save your battle logs and replay them later to analyze strategies.\n- **Cross-Platform**: Built with React Native / Expo for iOS, Android, and Web.\n- **Localization**: Supports English and Russian.\n\n## Getting Started\n\n### Prerequisites\n\n- [Node.js](https://nodejs.org/)\n- [Expo CLI](https://docs.expo.dev/get-started/installation/)\n\n### Installation\n\n1.  Clone the repository:\n    ```bash\n    git clone https://github.com/demensdeum/mars-miners-client.git\n    cd mobile-app\n    ```\n\n2.  Install dependencies:\n    ```bash\n    npm install\n    ```\n\n3.  Start the app:\n    ```bash\n    npx expo start\n    ```\n\n## Gameplay Rules\n\n- **Turn-Based**: Players take turns one by one (Red, Green, Blue, Yellow).\n- **Territory**: You can only build on empty cells adjacent to your existing stations.\n- **Weapons**: To shoot a laser, you must have a line of **4 Stations** (horizontal or vertical).\n- **Sacrifice**: Shooting a laser consumes (destroys) one of your weapon-ready stations.\n- **Winning**: Eliminate all other players or have the most mines when no moves remain.\n\n## Project Structure\n\n- `app/`: Expo Router screens (`index`, `setup`, `game`, `multiplayer`, `replay`).\n- `src/logic/`: Core game logic.\n  - `MarsMinersGame.ts`: The authoritative game state machine.\n  - `battlelog/`: Handles move recording and networking.\n    - `WebsocketsBattlelogWriter.ts`: Manages multiplayer WebSocket connections, reconnection, and command buffering.\n  - `locales.ts`: Translation strings.\n\n## Contributing\n\nPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.\n\n## License\n\n[MIT](https://choosealicense.com/licenses/mit/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzefir1990%2Fmars-miners-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzefir1990%2Fmars-miners-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzefir1990%2Fmars-miners-client/lists"}