{"id":17703317,"url":"https://github.com/vianpyro/text-based_adventure_game","last_synced_at":"2025-04-24T05:41:12.424Z","repository":{"id":258717608,"uuid":"869831305","full_name":"Vianpyro/Text-Based_Adventure_Game","owner":"Vianpyro","description":"A text-based RPG I made to learn C++","archived":false,"fork":false,"pushed_at":"2024-10-29T12:55:10.000Z","size":180,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-30T07:23:18.921Z","etag":null,"topics":["text-based-game"],"latest_commit_sha":null,"homepage":"","language":"C++","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/Vianpyro.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":"2024-10-09T00:59:41.000Z","updated_at":"2025-01-27T15:47:56.000Z","dependencies_parsed_at":"2024-10-23T21:57:06.235Z","dependency_job_id":null,"html_url":"https://github.com/Vianpyro/Text-Based_Adventure_Game","commit_stats":null,"previous_names":["vianpyro/text-based_adventure_game"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vianpyro%2FText-Based_Adventure_Game","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vianpyro%2FText-Based_Adventure_Game/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vianpyro%2FText-Based_Adventure_Game/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vianpyro%2FText-Based_Adventure_Game/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Vianpyro","download_url":"https://codeload.github.com/Vianpyro/Text-Based_Adventure_Game/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250573289,"owners_count":21452337,"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":["text-based-game"],"created_at":"2024-10-24T20:22:35.789Z","updated_at":"2025-04-24T05:41:12.409Z","avatar_url":"https://github.com/Vianpyro.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Shattered Kingdom: Text-Based Adventure Game\n\nWelcome to **Shattered Kingdom**, a text-based RPG where you take on the role of a hero in the fractured world of **Elyndor**. Your mission is to recover the five pieces of the legendary **Shattered Crown** and unite the kingdom before the dark sorcerer **Malakar** plunges it into chaos.\n\n## Features\n\n- **Classes**: Choose between **Warrior**, **Mage**, or **Rogue**, each with unique abilities and playstyles.\n- **Exploration**: Journey through the **Frostbound Peaks**, **Sunken Ruins**, **Forbidden Forest**, **Ashen Wastes**, and **Abyssal Tower**.\n- **Combat**: Engage in turn-based battles with mythical creatures and rival warlords.\n- **Quests and Choices**: Complete side quests, make moral decisions, and shape the future of Elyndor through your actions.\n- **Multiple Endings**: Your choices throughout the game determine the fate of the kingdom.\n\n## Inspiration\n\nThe world of Elyndor and the plot of **Shattered Kingdom** are inspired by classic RPG mechanics and fantasy tropes found in games like _The Elder Scrolls_ series, _The Legend of Zelda_, and traditional _Dungeons \u0026 Dragons_ campaigns. These inspirations helped shape the game's atmosphere and mechanics, but the story and characters are entirely original.\n\n## Technologies Used\n\n- **C++**: The game is written in C++ to take advantage of object-oriented programming and memory management.\n- **STL**: Utilizes the Standard Template Library for efficient handling of player inventory, quests, and game logic.\n- **File I/O**: Supports saving and loading game progress using file streams.\n- **Smart Pointers**: Implements modern C++ techniques like smart pointers to manage memory and avoid leaks.\n\n## Plot\n\nCurious about the story of **Shattered Kingdom**? Learn more about the world of **Elyndor**, its history, and your mission to reclaim the **Shattered Crown** on our [Wiki Plot Page](https://github.com/Vianpyro/Text-Based_Adventure_Game/wiki/Plot:-The-Shattered-Kingdom).\n\n## Getting Started\n\n## Requirements\n\n- **Compiler**: g++ with C++17 support\n- **External Libraries**:\n  - `nlohmann::json` (JSON for Modern C++)\n\n### Build Instructions\n\n1. Clone the repository:\n\n    ```bash\n    git clone https://github.com/Vianpyro/Text-Based_Adventure_Game.git\n    ```\n\n2. Navigate to the project directory:\n\n    ```bash\n    cd Text-Based_Adventure_Game\n    ```\n\n3. Include external libraries\n\n    ```bash\n    sudo apt install nlohmann-json3-dev\n    ```\n\n4. Compile the code:\n\n    ```bash\n    make all\n    ```\n\n5. Run the Unit Tests (optional):\n\n    ```bash\n    make distcheck\n    ```\n\n6. Run the game:\n    ```bash\n    ./bin/ShatteredKingdom\n    ```\n\n## Contributing\n\nFeel free to open issues or submit pull requests to improve the game, add new features, or suggest new quests and storylines!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvianpyro%2Ftext-based_adventure_game","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvianpyro%2Ftext-based_adventure_game","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvianpyro%2Ftext-based_adventure_game/lists"}