{"id":24632814,"url":"https://github.com/cihat-kose/java-mine-field-game","last_synced_at":"2025-03-20T06:45:06.946Z","repository":{"id":186688394,"uuid":"675347502","full_name":"cihat-kose/java-mine-field-game","owner":"cihat-kose","description":"A text-based Mine Field Game built in Java. Users select points on a grid to avoid hidden mines. Win by selecting all safe points; lose by stepping on a mine. Dynamic grid sizing and mine placement make each game unique.","archived":false,"fork":false,"pushed_at":"2025-01-18T20:52:11.000Z","size":9,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-18T21:27:54.384Z","etag":null,"topics":["java-challenges"],"latest_commit_sha":null,"homepage":"","language":"Java","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/cihat-kose.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}},"created_at":"2023-08-06T16:10:59.000Z","updated_at":"2025-01-18T20:52:13.000Z","dependencies_parsed_at":"2024-12-30T02:34:32.203Z","dependency_job_id":"ca4bdabe-be32-4359-8d5e-89215d144610","html_url":"https://github.com/cihat-kose/java-mine-field-game","commit_stats":null,"previous_names":["chatgthb/javaminefieldgame","cihat-kose/javaminefieldgame","cihat-kose/java-mine-field-game"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cihat-kose%2Fjava-mine-field-game","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cihat-kose%2Fjava-mine-field-game/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cihat-kose%2Fjava-mine-field-game/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cihat-kose%2Fjava-mine-field-game/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cihat-kose","download_url":"https://codeload.github.com/cihat-kose/java-mine-field-game/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244566934,"owners_count":20473451,"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":["java-challenges"],"created_at":"2025-01-25T08:13:01.786Z","updated_at":"2025-03-20T06:45:06.922Z","avatar_url":"https://github.com/cihat-kose.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Java Mine Field Game 🎮\n\n**Java Mine Field Game** is a text-based, strategic mine-detection game implemented in Java. This game challenges players to navigate a grid full of hidden mines while avoiding detonations. Successfully uncover all safe spots to win!\n\n---\n\n## 🚧 Under Development\n\nThis project is currently in the development phase. Features and functionality may change as the game progresses. Contributions and feedback are welcome! If you're interested in contributing, please check the [How to Contribute](#how-to-contribute) section below. 🚀\n\n---\n\n## Features\n\n- **Interactive Gameplay:** Fully text-based and runs in the console.\n- **Customizable Grid:** Players can specify the size of the grid at the start.\n- **Random Mine Placement:** Mines are randomly placed based on the grid size.\n- **Dynamic Feedback:** The grid dynamically updates with the number of surrounding mines.\n- **Win or Lose:** Avoid all mines to win, or hit one and lose the game.\n\n---\n\n## How to Play\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/cihat-kose/java-mine-field-game.git\n   cd java-mine-field-game\n   ```\n\n2. Compile the game:\n   ```bash\n   javac -d bin ./src/_00_MineFieldGame/*.java\n   ```\n\n3. Run the game:\n   ```bash\n   java -cp bin _00_MineFieldGame.MineField\n   ```\n\n4. Enter the grid size (rows and columns).\n5. Select a cell by entering the row and column indices.\n6. Avoid mines and uncover all safe cells to win!\n\n---\n\n## Game Rules\n\n1. The game runs on a two-dimensional grid.\n2. Players specify the grid size (rows and columns).\n3. Mines are randomly placed (1/4th of total cells).\n4. Select a point by entering row and column numbers.\n5. If the selected point contains a mine, the game ends.\n6. If it's safe, the number of surrounding mines is displayed.\n7. Clear all safe cells to win.\n\n---\n\n## Example Gameplay\n\n```\nWelcome to Mine Field Game!\nEnter grid size (rows x columns): 4 4\n\nSelect a cell (row column): 2 3\nSafe! 1 mine(s) nearby.\n\nSelect a cell (row column): 1 1\nOops! You hit a mine. Game Over!\n```\n\n---\n\n## How to Contribute\n\nContributions are welcome!\n1. Fork the repository.\n2. Create a new branch (`git checkout -b feature-branch`).\n3. Commit your changes (`git commit -m 'Add new feature'`).\n4. Push to the branch (`git push origin feature-branch`).\n5. Create a Pull Request.\n\n---\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n---\n\n## Contributors\n\n- **Cihat Köse** – Initial Developer\n\n---\n\n## Project URL\n\n[Java Mine Field Game Repository](https://github.com/cihat-kose/java-mine-field-game.git)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcihat-kose%2Fjava-mine-field-game","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcihat-kose%2Fjava-mine-field-game","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcihat-kose%2Fjava-mine-field-game/lists"}