{"id":21086627,"url":"https://github.com/aboueleyes/the-conqueror","last_synced_at":"2025-06-30T03:34:12.298Z","repository":{"id":43217504,"uuid":"360553472","full_name":"aboueleyes/the-conqueror","owner":"aboueleyes","description":"A single player turn-based empire building game.","archived":false,"fork":false,"pushed_at":"2022-03-12T20:47:45.000Z","size":97123,"stargazers_count":17,"open_issues_count":9,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-16T11:38:53.283Z","etag":null,"topics":["game","java","oop","oops-in-java"],"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/aboueleyes.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}},"created_at":"2021-04-22T14:44:19.000Z","updated_at":"2025-01-12T16:49:09.000Z","dependencies_parsed_at":"2022-09-13T10:41:04.579Z","dependency_job_id":null,"html_url":"https://github.com/aboueleyes/the-conqueror","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aboueleyes/the-conqueror","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aboueleyes%2Fthe-conqueror","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aboueleyes%2Fthe-conqueror/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aboueleyes%2Fthe-conqueror/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aboueleyes%2Fthe-conqueror/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aboueleyes","download_url":"https://codeload.github.com/aboueleyes/the-conqueror/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aboueleyes%2Fthe-conqueror/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262704484,"owners_count":23351080,"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":["game","java","oop","oops-in-java"],"created_at":"2024-11-19T20:48:52.408Z","updated_at":"2025-06-30T03:34:12.274Z","avatar_url":"https://github.com/aboueleyes.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TheConqueror\n\n[![Codacy Badge](https://api.codacy.com/project/badge/Grade/fedd9f7938f14125ae98f4c33dd8d0d7)](https://app.codacy.com/gh/aboueleyes/the-conqueror?utm_source=github.com\u0026utm_medium=referral\u0026utm_content=aboueleyes/the-conqueror\u0026utm_campaign=Badge_Grade_Settings)\n\nA single player turn-based empire building game. A player\ninitially chooses one historical city to start his empire with. The goal is to conquer the whole\nworld by taking control over every other city under a certain amount of turns. In order to\nachieve this goal, the player have the option of building various types of building in any city he has control over and also build armies in order to conquer other cities.\n\n## Contents \n1. OOP concepts (Inheritance - Polymorphism - Abstraction - Encapsulation ).\n2. Exception Handling.\n3. GUI \n\n### Who is this game for\n  - For anyone who wants to learn about OOP, MVC, Swing. \n  - For anyone who might find this game fun :relieved:.\n  - For my future employer who will accept my resume when seeing this wonderful clean code game :\"D.\n## Project Structure\n\u003cdetails\u003e\n    \n```bash\nsrc/\n├── buildings\n│   ├── ArcheryRange.java\n│   ├── Barracks.java\n│   ├── Building.java\n│   ├── EconomicBuilding.java\n│   ├── Market.java\n│   └── ..............\n├── controllers\n│   └── Controller.java\n├── engine\n│   ├── City.java\n│   ├── Distance.java\n│   ├── Game.java\n│   ├── Player.java\n│   └── ............\n├── exceptions\n│   ├── ArmyException.java\n│   ├── BuildingException.java\n│   ├── FriendlyCityException.java\n│   ├── FriendlyFireException.java\n│   └── .......................\n├── units\n│   ├── Archer.java\n│   ├── Army.java\n│   ├── Infantry.java\n│   ├── Status.java\n│   └── ................\n├── utlis\n│   └── ReadingCSVFile.java\n└── views\n    ├── button\n    │   ├── CityButton.java\n    │   ├── StyledButton.java\n    │   └── UnitButton.java\n    ├── MyInputVerifier.java\n    ├── panel\n    │   ├── ArmyPanel.java\n    │   ├── CardsPanel.java\n    │   ├── MilitaryBuildingPanel.java\n    │   ├── PlayerPanel.java\n    │   └── .....................\n    ├── RXCardLayout.java\n    └── view\n        ├── BattleView.java\n        ├── CityView.java\n        ├── EndGameView.java\n        ├── StartView.java\n        └── ..............\n\n```\n\u003c/details\u003e\n\n## Views Of the game \n  \nthe game consists of 3 views beside the start view \n\n1) \u003cstrong\u003e World Map View \u003c/strong\u003e \n \n \n   \u003cimg src = \"assets/img/views/worldMapView.jpeg\" \u003e\n  \n   responsible for viewing the cities of the game , armies of the player and thier status.\n\n2) \u003cstrong\u003e City View \u003c/strong\u003e\n\n\n   \u003cimg src = \"assets/img/views/cityView.jpeg\"\u003e\n   \n   responsible for showing different buildings for each city where the player could build , upgrade and recruit units ti build his/her army.\n\n\n3) \u003cstrong\u003e Battle View \u003c/strong\u003e \n\n\n   \u003cimg src = \"assets/img/views/battleView.jpeg\"\u003e \n   \n   responsible for battles between army of the player and opponent cities where player could manage the battle manually or choose to auto resolve it.\n \n\n## Authors \n1. [Shimaa Ahmed](https://github.com/ShimaaBetah)\n2. [Ahmed Shaawray](https://github.com/shaarawy29)\n3. [Ibrahim Abou Elenein](https://github.com/aboueleyes)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faboueleyes%2Fthe-conqueror","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faboueleyes%2Fthe-conqueror","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faboueleyes%2Fthe-conqueror/lists"}