{"id":15047383,"url":"https://github.com/vinkami/honkai-star-rail-simulator-cpp","last_synced_at":"2026-01-21T10:36:46.986Z","repository":{"id":244284015,"uuid":"773174762","full_name":"vinkami/honkai-star-rail-simulator-cpp","owner":"vinkami","description":"Group project","archived":false,"fork":false,"pushed_at":"2024-06-15T16:10:28.000Z","size":316,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-10-26T22:38:19.142Z","etag":null,"topics":["comp2113","cpp","cpp11","engg1340","honkai-star-rail"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vinkami.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-03-16T23:52:16.000Z","updated_at":"2024-06-15T16:10:32.000Z","dependencies_parsed_at":"2025-02-13T17:55:43.235Z","dependency_job_id":null,"html_url":"https://github.com/vinkami/honkai-star-rail-simulator-cpp","commit_stats":null,"previous_names":["vinkami/honkai-star-rail-simulator-cpp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/vinkami/honkai-star-rail-simulator-cpp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinkami%2Fhonkai-star-rail-simulator-cpp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinkami%2Fhonkai-star-rail-simulator-cpp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinkami%2Fhonkai-star-rail-simulator-cpp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinkami%2Fhonkai-star-rail-simulator-cpp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vinkami","download_url":"https://codeload.github.com/vinkami/honkai-star-rail-simulator-cpp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinkami%2Fhonkai-star-rail-simulator-cpp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28631937,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T04:47:28.174Z","status":"ssl_error","status_checked_at":"2026-01-21T04:47:22.943Z","response_time":86,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["comp2113","cpp","cpp11","engg1340","honkai-star-rail"],"created_at":"2024-09-24T20:57:24.351Z","updated_at":"2026-01-21T10:36:46.971Z","avatar_url":"https://github.com/vinkami.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Honkai: Star Rail Battle Simulator\n\n## Notes for COMP2113/ENGG1340 Newcomers\nYes, this is one of the group projects done for this course.  \nThis is group 39 of the 2023/2024 semester 2, getting the grade 14/15.  \n\nThe project deadline was 30 Apr 2024. Just in case if the repository is modified after that point, you can do:\n```bash\ngit clone https://github.com/vinkami/honkai-star-rail-simulator-cpp\ngit reset --hard 3128854\n```\nto get the version exactly at the point where it is submitted.  \nAt this version there are still quite a few bugs like repeated DoT checking and random crashing, but the results did show that it's not too shabby :D  \nFeel free to look around to get inspirations, just don't forget to mention this project in the citations and don't plagiarize.  \n--[vinkami](https://github.com/vinkami)\n\n## Introduction\nThis is a simulator for the battle in the game Honkai: Star Rail.    \nThis game consists of various characters and enemies, which all have different skills and stats.  \nThis is a turn-based RPG game where the speed stat determines how fast each character moves.\n\n## How to start the game\nTo start the game, of course you first need to clone the game files into a directory in your computer\nThen, run the following commands in the terminal in the project directory:\n```bash\nbash ./run.sh\n```\nYes, that's all you need to do.  \nIn the game you can run `help` and see the available commands to work out more.\n\n## How to play\n### Outside battle\nYou can select from the main menu the actions you would like to do, such as selecting your team or opponents.\n#### Exit\nQuits the game.\n#### Help\nShows the help menu, provides details on all the commands.\n#### Start\nStarts the game, only works when you have a team snd battle selected.\n#### Team\nLet you select the characters you would put in battle. You should select 4 for your team.\n#### List\nShows the list of playable characters available, and detailed profiles of them.\n#### Battle\nLet you select the battle scenario you would like to fight in.\n#### Level\nShows the leveling selection menu, you can change the levels of your characters.\n#### Settings\nShows the settings menu, you can change the levels and difficulty of the enemies.\n#### Restart\nStarts the game with the settings of the last game.\n#### Quickstart\nStart the game with a predetermined team and battle.\n### During battle\n#### Help\nShows the help menu, shows all the commands.\n#### Check\nCheck the effects and stats of the allies or enemies.\n#### Escape\nEscape from the fight.\n#### Reset\nRestart with all same setting.\n#### Exit\nExit the battle menu and return to the main menu.\n#### Q\nDo a normal attack.\n#### E\nRelease the skill of the current character\n#### 1,2,3,4\nRelease the ultimate of the character at the corresponding position, only when the ultimate energy bar is full.\nFor most normal attacks, skills and ultimates, you will be prompted to select a target.\n\n## Stats\nEach character and enemy has the following stats:\n- Hp: Health Points\n- Atk: Attack\n- Def: Defense\n- Spd: Speed\n- Crit%: Critical Rate\n- CritDmg: Critical Damage\n\n## Characters\n### Jingliu\n### Huohuo\n### Kafka\n### Clara\n### Tingyun\n### Fuxuan\n### Natasha\n### Asta\n### Danheng\n### Sparkle\n\n## Enemies\nThere are multiple situations in the game, and each situation has different enemies to fight against.  \nWhen you enter the battle menu, you will be able to see the situations' description as well as the enemies in that situation.  \n\n# Other stuff that are required by the group project brief\n## Team members\n- [Vincent](https://github.com/vinkami)\n- [David](https://github.com/IamnotOscar)\n- [Sunny](https://github.com/Sanichi52)\n- [John](https://github.com/wanndieearly)\n- [Jacky](https://github.com/Icescream46)\n\n## Features aka Code Requirements\n- Random game events: Enemies choose a random skill and a random target based on taunt system; allies critical hits\n- Data structures: `vector\u003cCharacter\u003e allies` and `vector\u003cCharacter\u003e enemies` to store the characters and enemies\n- Dynamic memory management: Many pass-by-reference functions and the vectors you saw above\n- File I/O: `getPlayableCharacters()` to load the characters from a file (You can actually modify the values in `characters.csv` to manually change the difficulty, but a difficulty setting is in game so it's not recommended)\n- Program codes in multiple files: `main.cpp`, `setup.cpp`, `battle.cpp`, `character.cpp`, etc.\n\n## Non-standard libraries\n### VariadicTable\n- File: `VariadicTable.h`\n- Source: https://github.com/friedmud/variadic_table\n- Usage: To print the table of characters and enemies in a nice format\n\n## Credits\n-Characters and enemies: inspired by the game Honkai Star Rail by Mihoyo hsr.hoyoverse.com/\n- Ascii art: some of the art was modified from ascii.co.uk\n- Table: Table function from friedmud github.com/friedmud/variadic_table\n## Link to demonstration video\n- https://connecthkuhk-my.sharepoint.com/:f:/g/personal/u3622713_connect_hku_hk/EgE_0wQxkhBDnc4aEoDhYlYBpzCvhVmTT25nYZPvd4Ksfw?e=Mr83u2\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvinkami%2Fhonkai-star-rail-simulator-cpp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvinkami%2Fhonkai-star-rail-simulator-cpp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvinkami%2Fhonkai-star-rail-simulator-cpp/lists"}