LaunchRoblox 0.1.0__py3-none-any.whl

launchroblox-0.1.0.dist-info/METADATA

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: LaunchRoblox
+Version: 0.1.0
+Summary: A lightweight utility to programmatically authenticate and launch the Roblox client.
+Author-email: noaclr <154766525+noaclr@users.noreply.github.com>
+Project-URL: Homepage, https://github.com/noaclr/LaunchRoblox
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Dynamic: license-file
+
+# LaunchRoblox
+
+A lightweight, cross-platform Python utility to programmatically authenticate and launch the Roblox client using a `.ROBLOSECURITY` cookie and a specific Place ID.
+
+## Features
+
+- **Automated Auth Flow:** Seamlessly exchanges a `.ROBLOSECURITY` cookie for an official `rbx-authentication-ticket` using the secure Roblox authentication endpoints.
+- **Cross-Platform Support:** Native client launching support across **Windows** (`os.startfile`), **macOS** (`open`), and **Linux** (`xdg-open`).
+- **Defensive Error Handling:** Built-in validation checks to catch expired, missing, or invalid authentication tokens before launching.
+- **Zero Disk Overhead:** Clean, direct execution without bloating your local environment.
+
+## Installation
+
+Install the package directly from PyPI:
+
+```bash
+pip install LaunchRoblox
+
+```
+
+## Quick Start
+
+```python
+from roblox_launcher import launchRoblox, AuthenticationError
+
+# Replace with your actual .ROBLOSECURITY cookie
+cookie = "_|WARNING:-DO-NOT-SHARE-THIS..."
+# The Place ID you want to join (e.g., 2753915549 for Blox Fruits)
+placeId = 2753915549 
+
+try:
+    print("Authenticating and launching client...")
+    launchRoblox(placeId, cookie)
+    print("Success! Roblox protocol handler triggered.")
+except AuthenticationError as e:
+    print(f"Authentication failed: {e}")
+except Exception as e:
+    print(f"An unexpected error occurred: {e}")
+
+```
+
+## API Reference
+
+### `launchRoblox(placeId, cookie)`
+
+Generates an authentication ticket and fires the platform's native URI scheme (`roblox-player:1+...`) to open the game client.
+
+* `placeId` *(int)*: The unique ID of the Roblox place/experience.
+* `cookie` *(str)*: The full `.ROBLOSECURITY` token for the target account.
+
+### `fetchAuthTicket(cookie)`
+
+Handles the underlying backend API handshake to retrieve a valid launch token. This involves retrieving a client assertion, obtaining a valid CSRF token, and exchanging them for the final authentication ticket.
+
+* `cookie` *(str)*: The target account's cookie.
+* **Returns:** *(str)* A valid `rbx-authentication-ticket`.
+* **Raises:** `AuthenticationError` if the cookie is invalid, missing, or if the API communication fails.
+
+## Requirements
+
+* Python >= 3.7
+* `requests` library
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

launchroblox-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+launchroblox-0.1.0.dist-info/licenses/LICENSE,sha256=TX0BhGAOhJT76UUlxGPlMr51t_d8tTPtRAjB4DP2bHg,1082
+roblox_launcher/__init__.py,sha256=SmfQDlU6kIGE0lcjyTwsJldm4k814Tl7XXj3chkOdSQ,144
+roblox_launcher/launcher.py,sha256=XqNDFQXcfq_Q__LRC0p289hAl5hiPykNRUtmOiEPtLg,2826
+launchroblox-0.1.0.dist-info/METADATA,sha256=L0FdjevHcEKHR4U3LuCtdKan7kuix4UaPOCLfETI_XM,2985
+launchroblox-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+launchroblox-0.1.0.dist-info/top_level.txt,sha256=zaL9x1PK_DN3oMVMNbVhNO1xInU_b9_5jwiFSPe72Ho,16
+launchroblox-0.1.0.dist-info/RECORD,,

launchroblox-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

launchroblox-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 noaclr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

launchroblox-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+roblox_launcher

roblox_launcher/__init__.py

@@ -0,0 +1,3 @@
+from .launcher import launchRoblox, fetchAuthTicket, AuthenticationError
+
+__all__ = ["launchRoblox", "fetchAuthTicket", "AuthenticationError"]

roblox_launcher/launcher.py

@@ -0,0 +1,82 @@
+import os
+import sys
+import time
+import requests
+from urllib.parse import urlencode, quote
+
+class AuthenticationError(Exception):
+    pass
+
+def fetchAuthTicket(cookie):
+    cookies = {".ROBLOSECURITY": cookie}
+    
+    try:
+        r = requests.get("https://auth.roblox.com/v1/client-assertion", cookies=cookies)
+        rJson = r.json()
+    except (requests.RequestException, ValueError):
+        raise AuthenticationError("Failed to communicate with the Roblox auth API.")
+
+    if "clientAssertion" not in rJson:
+        errorMsg = rJson.get("errors", [{}])[0].get("message", r.text)
+        if "Authentication token is missing" in errorMsg:
+            raise AuthenticationError("You forgot to provide a valid .ROBLOSECURITY cookie.")
+        elif "User is not authenticated" in errorMsg:
+            raise AuthenticationError("You provided an invalid .ROBLOSECURITY cookie.")
+        raise AuthenticationError(f"API Error: {errorMsg}")
+    
+    clientAssertion = rJson["clientAssertion"]
+    
+    r = requests.post("https://auth.roblox.com/v2/logout", cookies=cookies)
+    csrfToken = r.headers.get("x-csrf-token")
+    if not csrfToken:
+        raise AuthenticationError("Could not retrieve x-csrf-token header.")
+    
+    payload = {"clientAssertion": clientAssertion}
+    headers = {"x-csrf-token": csrfToken, "Referer": "https://www.roblox.com/"}
+    
+    r = requests.post(
+        "https://auth.roblox.com/v1/authentication-ticket", 
+        data=payload, 
+        cookies=cookies, 
+        headers=headers
+    )
+    
+    authTicket = r.headers.get("rbx-authentication-ticket")
+    if not authTicket:
+        raise AuthenticationError("Failed to obtain rbx-authentication-ticket from response headers.")
+
+    return authTicket
+
+def launchRoblox(placeId, cookie):
+    query = urlencode({
+        "request": "RequestGame",
+        "browserTrackerId": "0",
+        "placeId": placeId,
+        "isPlayTogetherGame": "false",
+        "referredByPlayerId": 0,
+        "joinAttemptId": "",
+        "joinAttemptOrigin": "PlayButton",
+    })
+    
+    encodedPlaceUrl = quote(f"https://www.roblox.com/Game/PlaceLauncher.ashx?{query}", safe="")
+    launchTime = int(time.time() * 1000)
+    
+    robloxURI = (
+        "roblox-player:1"
+        + "+launchmode:play"
+        + f"+gameinfo:{fetchAuthTicket(cookie)}"
+        + f"+launchtime:{launchTime}"
+        + f"+placelauncherurl:{encodedPlaceUrl}"
+        + f"+browsertrackerid:0"
+        + "+robloxLocale:en_us"
+        + "+gameLocale:en_us"
+        + "+channel:"
+        + "+LaunchExp:InApp"
+    )
+
+    if sys.platform == "win32":
+        os.startfile(robloxURI)
+    elif sys.platform == "darwin":
+        os.system(f"open '{robloxURI}'")
+    else:
+        os.system(f"xdg-open '{robloxURI}'")