Create Roblox-TS Script

Builds & bundles TypeScript source files into a Lua script, which you can use on Roblox.

Prerequisites

Make sure the following are installed:

• bun

The following are automatically installed; if it fails, install manually:

• rokit

Instructions

1. Create Project

   Run the following in a terminal, and follow the instructions:

   bun create roblox-ts-script
   

2. Develop

   Once the script has created your project, open it in an IDE, preferably Zed.

   In the Zed Terminal, you can execute bun run dev. Now you can edit files in src, and it will compile to out when you save.

3. Build

   If you'd like to manually start the build process, instead of running the dev script, run bun run build which will build once.

4. Sync (optional)

   If you want to test your script on Roblox Studio, run the following once: rojo plugin install.

   Then, simply run bun run dev-sync and connect on Roblox Studio (look for Rojo in the Plugins section).

5. Deploy (optional)

   If you chose to initialize a git repository, and have it connected to a remote GitHub repo, you can run bun run release to create a release with the script attached.

   Only do this once you've made changes and pushed them to the main branch. Otherwise, it won't do anything.

6. Packages (optional)

   You can install roblox-ts packages like usual, through your package manager. An example of a package is @rbxts/vide.

   If the package is not under the @rbxts scope, use bun run scope to add the scope of the package.

   Here's an example of a package being used:

   import greet from "@snipcola/greet-test";
   greet("world");

Credits

• roblox-ts, compiler
• rojo, synchronization
• tape, bundler (heavily modified)
• darklua, minifier
• sunc, types