# roblox-ts

> A TypeScript-to-Luau Compiler for Roblox

Latest version **3.0.0** (published 2024-09-12) · MIT license · 0 weekly downloads

## Install

```sh
npm install roblox-ts
pnpm add roblox-ts
yarn add roblox-ts
bun add roblox-ts
```

Provides the command `rbxtsc`.

## Health

**Score 40/100 (D)** — status: abandoned.

Positive: has types; no vulnerabilities; high maintenance score; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 3.0.0 |
| Published | 2024-09-12 |
| First published | 2018-09-06 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 9 |
| Unpacked size | 770 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1304 |
| Maintainers | osyris |

## Links

- npm: https://www.npmjs.com/package/roblox-ts
- Repository: https://github.com/roblox-ts/roblox-ts
- Homepage: https://github.com/roblox-ts/roblox-ts#readme
- Issues: https://github.com/roblox-ts/roblox-ts/issues
- npm.io page: https://npm.io/package/roblox-ts

## Dependencies (9)

- [kleur](https://npm.io/package/kleur.md) ^4.1.5
- [yargs](https://npm.io/package/yargs.md) ^17.7.2
- [resolve](https://npm.io/package/resolve.md) ^1.22.6
- [chokidar](https://npm.io/package/chokidar.md) ^3.6.0
- [fs-extra](https://npm.io/package/fs-extra.md) ^11.2.0
- [typescript](https://npm.io/package/typescript.md) =5.5.3
- [@roblox-ts/luau-ast](https://npm.io/package/@roblox-ts/luau-ast.md) =2.0.0
- [@roblox-ts/rojo-resolver](https://npm.io/package/@roblox-ts/rojo-resolver.md) =1.1.0
- [@roblox-ts/path-translator](https://npm.io/package/@roblox-ts/path-translator.md) =1.1.0

## Recent versions

- 3.0.0 (latest) — 2024-09-12
- 3.0.0-dev-3106b14 (next) — 2026-09-18
- 3.0.0-dev-41c392d — 2026-09-18
- 3.0.0-dev-d9f7512 — 2026-09-17
- 3.0.0-dev-85abfae — 2026-09-16
- 3.0.0-dev-1a44d8f — 2026-09-15
- 3.0.0-dev-543040f — 2026-09-15
- 3.0.0-dev-cdcce19 — 2026-09-14
- 3.0.0-dev-df01bf5 — 2026-09-13
- 3.0.0-dev-27685f7 — 2026-09-12
- 3.0.0-dev-8a21ba6 — 2026-09-11
- 3.0.0-dev-883c6ff — 2026-09-10
- 3.0.0-dev-9d25f9b — 2026-09-09
- 3.0.0-dev-ecca939 — 2026-09-08
- 3.0.0-dev-fede64c — 2026-09-07
- … 421 more at https://npm.io/package/roblox-ts/versions

## README

<div align="center"><img width=25% src="https://i.imgur.com/yCjHmng.png"></div>
<h1 align="center"><a href="https://roblox-ts.com">roblox-ts</a></h1>
<div align="center">A TypeScript-to-Luau Compiler for Roblox</div>
<br>
<div align="center">
	<a href="https://discord.roblox-ts.com"><img src="https://discordapp.com/api/guilds/476080952636997633/embed.png" alt="Discord server" /></a>
	<a href="https://github.com/roblox-ts/roblox-ts/actions"><img src="https://github.com/roblox-ts/roblox-ts/actions/workflows/UnitTests.yml/badge.svg?branch=master" alt="CI Status" /></a>
	<a href="https://coveralls.io/github/roblox-ts/roblox-ts?branch=master"><img src="https://coveralls.io/repos/github/roblox-ts/roblox-ts/badge.svg?branch=master" alt="Coverage Status" /></a>
	<a href="https://www.npmjs.com/package/roblox-ts"><img src="https://badge.fury.io/js/roblox-ts.svg"></a>
</div>
<div>&nbsp;</div>

## Introduction

**roblox-ts** is an attempt to bridge the abilities of TypeScript to work in a Roblox environment. We break down your code into an abstract syntax tree and emit functionally similar structures in [Luau](https://luau-lang.org/) so that the code behaves the same.

## Quick start & Documentation

Ready to dive in? [Check out the documentation.](https://roblox-ts.com/docs)

## Join the Community!

https://discord.roblox-ts.com

## Games that use roblox-ts

<a href="https://www.roblox.com/games/6872265039"><img width=32.9% src="https://i.imgur.com/S2x5isG.png" /></a><!-- BedWars 9.5B -->
<a href="https://www.roblox.com/games/4872321990"><img width=32.9% src="https://i.imgur.com/pkuQfdG.png" /></a><!-- Islands 2.2B -->
<a href="https://www.roblox.com/games/7711635737"><img width=32.9% src="https://i.imgur.com/lmJLoAx.png" /></a><!-- Emergency Hamburg 388.0M -->
<a href="https://www.roblox.com/games/3759927663"><img width=32.9% src="https://i.imgur.com/OAmrsuz.png" /></a><!-- Zombie Strike 225.3M -->
<a href="https://www.roblox.com/games/8542259458"><img width=32.9% src="https://i.imgur.com/n6fMYfz.jpeg" /></a><!-- SkyWars 195.9M -->
<a href="https://www.roblox.com/games/12851888521"><img width=32.9% src="https://i.imgur.com/K8SvYsc.png" /></a><!-- Punch Wall Simulator 166.6M -->
<a href="https://www.roblox.com/games/9759729519"><img width=32.9% src="https://i.imgur.com/n1dye62.png" /></a><!-- All of Us Are Dead 126.2M -->
<a href="https://www.roblox.com/games/8597844216"><img width=32.9% src="https://i.imgur.com/S728lWz.png" /></a><!-- Slither Simulator 108.5M -->
<a href="https://www.roblox.com/games/841531820"><img width=32.9% src="https://i.imgur.com/KFUgqsV.png" /></a><!-- Deep Space Tycoon 30.2M -->
<a href="https://www.roblox.com/games/3837841034"><img width=32.9% src="https://i.imgur.com/nffggbO.png" /></a><!-- Deadline 28.5M -->
<a href="https://www.roblox.com/games/9611595239"><img width=32.9% src="https://i.imgur.com/qISPda3.png" /></a><!-- Rift Royale 21.1M -->
<a href="https://www.roblox.com/games/8747402506"><img width=32.9% src="https://i.imgur.com/cZsnXms.png" /></a><!-- Prop Hunt 19.7M -->
<a href="https://www.roblox.com/games/5414779423"><img width=32.9% src="https://i.imgur.com/5GTAGqt.png" /></a><!-- Science Simulator 19.1M -->
<a href="https://www.roblox.com/games/9655469250"><img width=32.9% src="https://i.imgur.com/GXt8rmT.png" /></a><!-- Space War Tycoon 10.7M -->
<a href="https://www.roblox.com/games/9681195418"><img width=32.9% src="https://i.imgur.com/599Tpu0.png" /></a><!-- popper 10.0M -->
<a href="https://www.roblox.com/games/13251504936"><img width=32.9% src="https://i.imgur.com/6AyGF1m.png" /></a><!-- Creepy Crawlers 6.3M -->
<a href="https://www.roblox.com/games/11688361399"><img width=32.9% src="https://i.imgur.com/EDC7xw6.png" /></a><!-- Wealdland Foods 6.1M -->
<a href="https://www.roblox.com/games/12147220287"><img width=32.9% src="https://i.imgur.com/iD2PKgW.png" /></a><!-- LegacyVerse 2.8M -->
<a href="https://www.roblox.com/games/2184151436"><img width=32.9% src="https://i.imgur.com/JSFPTA0.png" /></a><!-- Dungeon Life 2.0M -->

---
_Source: https://npm.io/package/roblox-ts · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._