https://github.com/snipcola/create-roblox-ts-script

CLI tool for creating Roblox scripts using TypeScript.
https://github.com/snipcola/create-roblox-ts-script

bundle lua luau rbxts roblox roblox-ts typescript

Last synced: 24 days ago
JSON representation

CLI tool for creating Roblox scripts using TypeScript.

• Host: GitHub
• URL: https://github.com/snipcola/create-roblox-ts-script
• Owner: snipcola
• License: mit
• Created: 2024-09-16T19:53:01.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2024-09-29T12:02:37.000Z (about 1 month ago)
• Last Synced: 2024-09-29T15:22:31.491Z (about 1 month ago)
• Topics: bundle, lua, luau, rbxts, roblox, roblox-ts, typescript
• Language: JavaScript
• Homepage:
• Size: 15.2 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
## 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:

- [node](https://nodejs.org/en/download)

- [pnpm](https://pnpm.io/installation#using-a-standalone-script) (optional)

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

- [aftman](https://github.com/LPGhatguy/aftman/releases/latest)

## Instructions

If you installed `pnpm`, use that instead of `npm` for the following steps.

1. **Create Project**

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

   ```

   (p)npm create roblox-ts-script

   ```

2. **Develop**

   Once the script has created your project, open it in an IDE, preferably [VSCode](https://code.visualstudio.com).

   In the VSCode Terminal, you can execute `npm run dev / pnpm 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 `npm run build / pnpm 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 `npm run dev -- --sync / pnpm 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 `npm run release / pnpm 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.

## Credits

- [roblox-ts](https://github.com/roblox-ts/roblox-ts), compiler

- [tape](https://github.com/Belkworks/tape), bundler (heavily modified)

- [darklua](https://github.com/seaofvoices/darklua), minifier

- [rbxts-hax](https://github.com/richie0866/rbxts-hax), unc types