{"id":23890438,"url":"https://github.com/exurd/alcubierre","last_synced_at":"2025-02-23T05:13:04.346Z","repository":{"id":264484991,"uuid":"846278911","full_name":"exurd/alcubierre","owner":"exurd","description":"A Roblox Badge-to-Badge Place Teleporter","archived":false,"fork":false,"pushed_at":"2024-12-31T01:00:59.000Z","size":3986,"stargazers_count":1,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-31T02:17:20.389Z","etag":null,"topics":["achievements","badges","bloxstrap","overengineering","python","roblox","roblox-achievements","roblox-badges","roblox-python","sober","teleporter"],"latest_commit_sha":null,"homepage":"","language":"Python","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/exurd.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-08-22T22:03:30.000Z","updated_at":"2024-12-31T01:01:02.000Z","dependencies_parsed_at":"2024-11-24T17:34:26.118Z","dependency_job_id":null,"html_url":"https://github.com/exurd/alcubierre","commit_stats":null,"previous_names":["exurd/alcubierre"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exurd%2Falcubierre","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exurd%2Falcubierre/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exurd%2Falcubierre/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exurd%2Falcubierre/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/exurd","download_url":"https://codeload.github.com/exurd/alcubierre/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240271540,"owners_count":19774859,"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":["achievements","badges","bloxstrap","overengineering","python","roblox","roblox-achievements","roblox-badges","roblox-python","sober","teleporter"],"created_at":"2025-01-04T11:30:17.490Z","updated_at":"2025-02-23T05:13:04.326Z","avatar_url":"https://github.com/exurd.png","language":"Python","readme":"# alcubierre\n\u003cimg src=\"docs/icon.png\" title=\"icon for alcubierre\" style=\"image-rendering:smooth; width:25%; height:auto;\"/\u003e\n\n###### Roblox Badge-to-Badge Place Teleporter\n[![Python 3.6+](https://img.shields.io/badge/python-3.6+-blue.svg)](https://www.python.org/downloads/)\n![GitHub repo size](https://img.shields.io/github/repo-size/exurd/alcubierre)\n![Github Created At](https://img.shields.io/github/created-at/exurd/alcubierre)\n![GitHub commit activity week](https://img.shields.io/github/commit-activity/w/exurd/alcubierre)\n![GitHub commit activity month](https://img.shields.io/github/commit-activity/m/exurd/alcubierre?color=AA4A44)\n[![GitHub License](https://img.shields.io/github/license/exurd/alcubierre)](./LICENSE)\n\n[alcubierre](https://en.wikipedia.org/wiki/Alcubierre_drive) is a [CLI](https://en.wikipedia.org/wiki/Command-line_interface)-based [Python](https://en.wikipedia.org/wiki/Python_(programming_language)) program that allows you to play multiple [Roblox](https://en.wikipedia.org/wiki/Roblox) experiences containing [player badges](https://roblox.fandom.com/wiki/User_badge) in a row, with minimal interruption to the flow. Specify what you want to play in a [text file](https://en.wikipedia.org/wiki/Text_file), and alcubierre will [automagically](https://en.wiktionary.org/wiki/automagically) figure out what to do for each line.\n\nThis program currently supports player badges, [places](https://roblox.fandom.com/wiki/Place), [universes/experiences](https://roblox.fandom.com/wiki/Experience), [users/players](https://roblox.fandom.com/wiki/User), and [groups](https://roblox.fandom.com/wiki/Group). \n\nIt can run on Python 3.6 and above. It also supports [Bloxstrap](https://bloxstraplabs.com) and [Sober](https://sober.vinegarhq.org).\n\nAny questions?\n\n## Installation\nTo run alcubierre, you will need the same requirements as Roblox: Windows 8.1 or above, macOS 10.13 High Sierra, or any Linux distro that can support Sober. Windows 7 users will need to manually run the source code on Python 3.8 or below.\n\nThe releases tab contains binary files of this program. Download and run the executable in a terminal.\n\nIf you have Python installed and want to run the source code, you will need to use `pip install -r requirements.txt` to install the required packages. It is advised to create a virtual environment for this program ([conda](https://docs.conda.io/projects/conda/en/latest/index.html) / [venv](https://docs.python.org/3/library/venv.html)). You can then use `python .` to run the program.\n\nIf the command above fails to install the packages, try using `pip install -U pip setuptools wheel` to update the package manager.\n\n## Usage\nThe `--help` command shows the commands you can use.\n\n```\nusage: alcubierre [-h] [--version] [--env-file ENV_FILE]\n                  [--rbx-token RBX_TOKEN] [--user-id USER_ID]\n                  [--awarded-threshold NUMBER] [--vote-threshold RATIO]\n                  [--seconds SECONDS] [--no-bloxstrap] [--no-sober]\n                  [--sober-opts SOBER_OPTS] [--open-in-browser] [--verbose]\n                  [--very-verbose] [--no-detect-one-badge]\n                  [--cache-directory CACHE_DIRECTORY]\n                  [--user-agent USER_AGENT] [--save-response-cache]\n                  [--play-sound] [--sound-pack SOUND_PACK]\n                  [file_path]\n\nThere are 20 arguments available.\n\npositional arguments:\n  file_path             Filename path of Badge IDs/URLs.\n\noptions:\n  -h, --help            show this help message and exit\n  --version             show program's version number and exit\n  --env-file, -e ENV_FILE\n                        An .env file allows you to specify settings (the below\n                        options) for alcubierre to follow without cluttering\n                        the terminal or risking important tokens. If the file\n                        doesn't exist, the program will create a template in\n                        its place. More information on .env files can be found\n                        in the README.\n  --rbx-token, -t RBX_TOKEN\n                        .ROBLOSECURITY token. By using this option, you agree\n                        that this is your unique token and not anyone else's.\n                        DO NOT SHARE YOUR ROBLOX TOKEN WITH ANYONE! More info\n                        can be found here:\n                        https://ro.py.jmk.gg/dev/tutorials/roblosecurity/\n  --user-id, -u USER_ID\n                        Specify a Roblox User ID to check inventory for\n                        badges. Not required if you're already using --rbx-\n                        token. The User ID argument takes priority from --rbx-\n                        token.\n  --awarded-threshold, -at NUMBER\n                        Threshold of players with the badge. If the badge has\n                        a lower number than the threshold, it gets skipped.\n                        Setting to -1 (default) disables the threshold.\n  --vote-threshold, -vt RATIO\n                        Threshold ratio of likes and dislikes. If a game has a\n                        lower ratio than the threshold, it gets skipped.\n                        Setting to -1 (default) disables the threshold.\n  --seconds, -s SECONDS\n                        How many seconds before killing the Roblox process.\n                        Setting to -1 (default) disables the timer.\n  --no-bloxstrap, -nbs  Windows only! Don't use Bloxstrap to open Roblox (not\n                        recommended). When this option is not in use, the\n                        program automagically detects if Bloxstrap is\n                        installed and uses it if so. Bloxstrap website:\n                        https://bloxstraplabs.com\n  --no-sober, -nsob     Linux only! Don't use Sober to open Roblox. When this\n                        option is not in use, the program automagically\n                        detects if Sober is installed and uses it if so. Sober\n                        website: https://sober.vinegarhq.org\n  --sober-opts, -sopts SOBER_OPTS\n                        Linux only! Commands to give Sober. Connect with an\n                        equal sign for it to work (`--sober-opts='--opengl'`)\n                        See --no-sober for more info on Sober.\n  --open-in-browser, -ob\n                        Opens the Roblox place in the default browser. Highly\n                        recommended, but set to False as default.\n  --verbose, -v         Verbose mode. Prints out things to help with\n                        debugging.\n  --very-verbose, -vv   Very verbose mode. Print out as many things as it can\n                        to help with debugging. Not recommended as it can slow\n                        down the program.\n  --no-detect-one-badge, -ndob\n                        Turns off one badge place detection, which\n                        automatically closes Roblox after the user has\n                        collected the solo badge on a place.\n  --cache-directory, -cd CACHE_DIRECTORY\n                        The directory where cache data is kept.\n  --user-agent, -ua USER_AGENT\n                        Sets the user agent for requests made by the program.\n  --save-response-cache, -src\n                        Save API responses from Roblox into a file. This can\n                        save bandwidth, at the cost of new information from\n                        already checked responses being ignored.\n  --play-sound, -ps     Play sounds for important context.\n  --sound-pack SOUND_PACK\n                        Sound packs to choose from: ['piano', 'tts']\n```\n\n### Guest mode\nIn guest mode, 90% of the features still work. A Roblox token is needed for detecting place playability and less harsh rate limits. To grab your token safely, visit ro.py's page on .ROBLOSECURITY tokens: https://ro.py.jmk.gg/dev/tutorials/roblosecurity\n\n### Creating a list\nYou can create a list with URLs, or with \"comma-comma\" strings:\n```text\nhttps://www.roblox.com/games/1818/Classic-Crossroads\nplace::1818\ngame::1818\nhttps://www.roblox.com/users/1/profile\nuser::1\nuniverse::1234\nhttps://www.roblox.com/groups/4199740/Roblox-Video-Stars\ngroup::4199740\n```\n\n### .env files\nIf you want to avoid showing sensitive data through the terminal, you can create an .env file.\n```text\nRBX_TOKEN=\"TOKEN_HERE\"\nUSER_AGENT=\"USER_AGENT_HERE\"\n```\nSee [.envs/.example.env](.envs/.example.env) for settings that are currently supported through .env.\n\n## Development\nSee [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)\n\n## License and Credits\nalcubierre is licensed under the GNU General Public License v3.0. Check the file [LICENSE](./LICENSE) for details.\n```\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\nGNU General Public License for more details.\n```\n\nThe rate limit sleep code for getRequestURL() was derived from [ArchiveTeam/roblox-marketplace-comments-grab](https://github.com/ArchiveTeam/roblox-marketplace-comments-grab), which is under The Unlicense. For more information, please refer to https://unlicense.org.\n\nThe icon is a modified derivative of [File:Alcubierre.png](https://commons.wikimedia.org/wiki/File:Alcubierre.png) by [AllenMcC.](https://commons.wikimedia.org/wiki/User:AllenMcC.), which is licensed under [Creative Commons Attribution-Share Alike 3.0 Unported](https://creativecommons.org/licenses/by-sa/3.0) \u003cimg style=\"height:22px!important;margin-left:3px;vertical-align:text-bottom;\" src=\"https://mirrors.creativecommons.org/presskit/icons/cc.svg?ref=chooser-v1\" alt=\"\"\u003e\u003cimg style=\"height:22px!important;margin-left:3px;vertical-align:text-bottom;\" src=\"https://mirrors.creativecommons.org/presskit/icons/by.svg?ref=chooser-v1\" alt=\"\"\u003e\u003cimg style=\"height:22px!important;margin-left:3px;vertical-align:text-bottom;\" src=\"https://mirrors.creativecommons.org/presskit/icons/sa.svg?ref=chooser-v1\" alt=\"\"\u003e\n\nTherefore, the alcubierre icon (located in `docs/icon.*`) is licensed under [Creative Commons Attribution-ShareAlike 4.0 International](https://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1) \u003cimg style=\"height:22px!important;margin-left:3px;vertical-align:text-bottom;\" src=\"https://mirrors.creativecommons.org/presskit/icons/cc.svg?ref=chooser-v1\" alt=\"\"\u003e\u003cimg style=\"height:22px!important;margin-left:3px;vertical-align:text-bottom;\" src=\"https://mirrors.creativecommons.org/presskit/icons/by.svg?ref=chooser-v1\" alt=\"\"\u003e\u003cimg style=\"height:22px!important;margin-left:3px;vertical-align:text-bottom;\" src=\"https://mirrors.creativecommons.org/presskit/icons/sa.svg?ref=chooser-v1\" alt=\"\"\u003e","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexurd%2Falcubierre","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexurd%2Falcubierre","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexurd%2Falcubierre/lists"}