rbxlaunch v0.1.3

rbxlaunch

Directly launch Roblox games and Studio sessions from within Node.js applications.

Prerequisites

• Node.js
• A package manager (npm, yarn, etc.)
• Windows*

* Currently rbxlaunch is only supported on Windows devices, due to the rbxapp library's limitations.

Install

$ npm i rbxlaunch

Usage

Launching Studio

const rbxlaunch = require("rbxlaunch")

(async () => {
    try {
        await rbxlaunch.studio()
        console.info("Roblox Studio launched successfully!")
    } catch (error) {
        console.error(error)
    }
})()

Launching a Game

A cookie is required to launch games, due to Roblox requiring an authentication ticket to be generated before allowing a player to join the game.

const rbxlaunch = require("rbxlaunch")

(async () => {
    try {
        await rbxlaunch.game({
            placeId: 4901843753, // place ID for rotopia
            cookie: "_|WARNING:-DO-NOT-SHARE-THIS.--Sharing-this-will-allow-someone-to-log-in", // to authenticate the request
        })

        console.info("rotopia launched successfully!")
    } catch (error) {
        console.error(error)
    }
})()

API

game(options)

Returns a Promise, which resolves with a ChildProcess object. Games are launched using the default roblox-player: protocol, as the Roblox website does.

options

Type: object

• * placeId is required when not following another user in-game.
• * instanceId is required when isPrivate is set to true

studio(options?)

Returns a Promise, which resolves with a ChildProcess object. Games are launched using the RobloxStudioLauncherBeta application, rather than via a protocol. This is to allow local files to be opened.

options

Type: object

Caveats

• Launching Roblox Studio is currently only supported on Windows.