Local Development

Cobalt uses the wax bundler to bundle the script. If wax is not setup, you must use the following instructions to build the script:

Setup

Rokit is a toolchain manager for Roblox projects. Open a terminal and run the install command for your operating system:

Open Terminal and run the following command:

curl -sSf https://raw.githubusercontent.com/rojo-rbx/rokit/main/scripts/install.sh | bash

git clone https://github.com/notpoiu/cobalt.git
cd cobalt

Once inside the Cobalt directory, install the required tools with Rokit:

rokit install

If prompted to trust any tools, select yes to allow them to be installed.

You can build Cobalt using the VSCode build task or the command line.

Press Ctrl + Shift + B (or ⌘ + Shift + B on macOS) to run the default build task.

We recommend using the Live Server extension for VSCode to serve the built script locally.

Install the Live Server extension in VSCode.
Open the Cobalt project folder in VSCode.
Click the "Go Live" button in the bottom-right corner of VSCode's status bar.
Make sure the port matches the one in your loadstring below (default is 5500).
Use the loadstring below in your executor to load the locally served script.

Use the playground below to generate a loadstring with a custom base URL. This is useful when testing local builds or hosting the script yourself.