{"id":20400722,"url":"https://github.com/stuffbymax/bash-theft-auto","last_synced_at":"2025-04-12T14:08:32.094Z","repository":{"id":246734929,"uuid":"822020813","full_name":"stuffbymax/Bash-Theft-Auto","owner":"stuffbymax","description":"a gta but in terminal ","archived":false,"fork":false,"pushed_at":"2025-04-07T15:08:29.000Z","size":48944,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-07T16:25:48.536Z","etag":null,"topics":["cli-app","cli-game","grand-theft-auto","grand-theft-auto-v","gta","help-needed","help-wanted","linux","open-source","terminal-game"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/stuffbymax.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-06-30T04:53:34.000Z","updated_at":"2025-04-07T15:12:44.000Z","dependencies_parsed_at":"2025-04-07T16:24:37.555Z","dependency_job_id":"0d04f48e-bb3b-4fcd-a47c-e8160a64b39a","html_url":"https://github.com/stuffbymax/Bash-Theft-Auto","commit_stats":null,"previous_names":["stuffbymax/bash-theft-auto"],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuffbymax%2FBash-Theft-Auto","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuffbymax%2FBash-Theft-Auto/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuffbymax%2FBash-Theft-Auto/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuffbymax%2FBash-Theft-Auto/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stuffbymax","download_url":"https://codeload.github.com/stuffbymax/Bash-Theft-Auto/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248578868,"owners_count":21127713,"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":["cli-app","cli-game","grand-theft-auto","grand-theft-auto-v","gta","help-needed","help-wanted","linux","open-source","terminal-game"],"created_at":"2024-11-15T04:45:24.198Z","updated_at":"2025-04-12T14:08:32.088Z","avatar_url":"https://github.com/stuffbymax.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bash Theft Auto\n\n\n## licensing\n\n[the code and animation is under MIT](./LICENSE)\n[the Music and SFX is under CC-BY](https://creativecommons.org/licenses/by/4.0/) \n[the ascii animation is made by AI]\n## Overview\n\nBash Theft Auto is a text-based adventure game implemented entirely in Bash. Inspired by classic open-world crime games, this script allows players to navigate a virtual world, earn money through legitimate jobs or criminal activities, purchase weapons and items, engage in dangerous encounters, and manage their health and inventory. \n\nThe game features several locations, a variety of jobs and crimes, drug dealing, and even a music player. The script also includes save and load functionality, so players can continue their progress at a later time.\n\n## Features\n\n-   **Multiple Locations**: Explore different cities like Los Santos, San Fierro, Las Venturas, Vice City, and Liberty City.\n-   **Player Customization**: Start the game by entering your player's name.\n-   **Dynamic Economy**: Earn cash through various jobs with different payouts based on location and job type.\n-   **Criminal Activities**: Engage in heists, gang wars, store robberies, and carjacking with risks and rewards.\n-   **Inventory Management**: Purchase and manage an inventory of guns, drugs, and other items.\n-   **Health System**: Manage your health, and visit the hospital for treatment.\n-   **Drug Dealing**: Buy and sell drugs with risk and rewards.\n-   **Hospital Services**: Get treatment, buy health packs, and body armor.\n-   **Hookers**: Hire hookers to restore some health.\n-   **Music Player**: Play music within the game.\n-   **Save/Load**: Persist and load game progress.\n-   **Plugin Support**: Extend the game's functionality by adding custom plugins.\n\n## Getting Started\n\n### Prerequisites\n\n-   A Unix-like operating system (e.g., Linux, macOS) with `bash` installed.\n-   `mpg123` installed (for the music player).\n    -   On Debian/Ubuntu: `sudo apt-get install mpg123`\n    -   On macOS: `brew install mpg123`\n\n### Installation\n\n1.  **Download the Script:** Save the `bash` script to your local machine (e.g., `bash_theft_auto.sh`).\n2.  **Make the Script Executable:**\n\n    ```bash\n    chmod +x bash_theft_auto.sh\n    ```\n    \n4.  **IF DELITED Create Necessary Directories:**\n   \n\t- Create a `plugins` directory for your plugins\n\t- Create a `music` directory for your music files (must be .mp3 files)\n\t- Create a `saves` directory for your save files\n\n    ```bash\n    mkdir plugins\n\tmkdir music\n\tmkdir saves\n    ```\n5.  **Add music files** Put .mp3 files into the music folder. The game will randomly choose between the files in the folder.\n\n### How to Play\n\n1.  **Run the Script:**\n    ```bash\n    ./bta.sh\n    ```\n2.  **Follow the Prompts:** The game will guide you through the different actions and options available.\n3.  **Navigate Using Numbers:** Use the number keys on your keyboard to select options in the game menu.\n4.  **Use \"Enter\" to Continue:** Press `Enter` to proceed after each action or message.\n\n## Game Mechanics\n\n### Main Menu\n\nThe main menu presents the following options:\n\n-   **Travel to another city**: Move your character to a new city for a cost.\n-   **Buy guns**: Purchase weapons from the gun store.\n-   **Show inventory**: View your current inventory of items, cash, health, drugs and weapons.\n-   **Work (earn money)**: Take on a legitimate job, such as taxi driving, delivery, mechanic work, security, or street performing to earn cash.\n-   **Work (criminal activity)**: Participate in dangerous activities such as a heist, gang war or carjacking to gain money and potentially take damage.\n-   **Buy drugs**: Buy different types of drugs from a dealer.\n-   **Sell drugs**: Sell your drugs for a profit.\n-   **Hire hooker**: Hire a hooker to restore health.\n-   **Visit hospital**: Get full treatment or buy a health pack or body armor to reduce damage on the next encounter.\n-   **Exit Game**: Quit the game.\n-   **Save Game**: Save your current progress.\n-   **Load Game**: Load a previously saved game.\n-   **Play Music**: Play music in the game.\n\n### Jobs and Criminal Activities\n\n-   Different jobs offer varying pay based on location.\n-   Criminal activities have risk involved - if you succeed you might gain money, but if you fail you might lose money or health.\n-   Body armor can reduce damage by 50% in the next encounter you take damage.\n\n### Inventory\n\n-   Keep track of your cash, health, guns, and other items.\n-   Purchase different guns at the gun store.\n-   Drugs can be bought and sold at the drug dealer.\n\n### Health System\n\n-   Health points affect how long you can play the game - if you reach 0 health you are transported to a hospital where you are healed for $200.\n-   Use health packs or a hooker to restore health.\n-   Visit the hospital to receive treatment for your wounds.\n\n### Save and Load\n\n-   The game saves your character's name, location, cash, health, inventory, and drug information in separate files within the `saves` directory.\n-   You can load a previous game using the \"Load Game\" option in the main menu.\n\n### Music Player\n\n-   Choose and play music files in the `music` directory.\n-   Use \"q\" to stop the music.\n\n## Plugin Support\n\nThe game supports plugins, which are simply `.sh` files located in the `plugins` folder. To extend the game’s functionalities you can create your own plugin files.\n\n### Plugin guidelines\n\n- Plugin files must have the `.sh` extension.\n- Plugin files must be placed into the `plugins` directory.\n-  The plugin files are sourced on game startup.\n- Your plugin script can add new functions that you can use in the main game loop, for example:\n\t- New work function.\n\t- New criminal activity function.\n\t- New weapons or items\n\t- New locations\n\t\n### Contributing\n\nIf you wish to contribute to this project, feel free to fork the repository and submit a pull request with your improvements.\nLicense\n\nThis project is open-source. Feel free to use and modify the code for educational and personal purposes.\n\n### Disclaimer\n\nThis game is a text-based simulation and does not condone real-life criminal activity.\nRockstar Games has no involvement with this project, and the content within this game is not associated with or endorsed by them in any way.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstuffbymax%2Fbash-theft-auto","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstuffbymax%2Fbash-theft-auto","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstuffbymax%2Fbash-theft-auto/lists"}