{"id":26685,"library":"zsr-transpiler","title":"zsr-transpiler","description":"CLI tool for transpiling ZetSharpRoblox (.zsr) files to Roblox Luau (.luau) without requiring Python. Version 1.3.0, released under MIT license. Actively maintained with a watch mode for auto-transpilation and support for reverse transpilation. Key differentiators: no Python dependency, seamless Rojo integration, and a beginner-friendly language syntax. Prioritizes simplicity over advanced features, making it ideal for Roblox developers new to transpilation.","status":"active","version":"1.3.0","language":"javascript","source_language":"en","source_url":"https://github.com/zetbytes/zetcoder","tags":["javascript","roblox","luau","transpiler","zsr","zetsharp","zetcoder","game-development"],"install":[{"cmd":"npm install zsr-transpiler","lang":"bash","label":"npm"},{"cmd":"yarn add zsr-transpiler","lang":"bash","label":"yarn"},{"cmd":"pnpm add zsr-transpiler","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"File watching for watch command","package":"chokidar","optional":false}],"imports":[{"note":"Install globally via npm install -g to use the command directly. npx works but requires network on first run.","wrong":"npx zsr-transpiler build","symbol":"zsr-transpiler (CLI)","correct":"zsr-transpiler build src"},{"note":"This package is CLI-only; there is no programmatic API. Attempting to import it will fail.","wrong":"require('zsr-transpiler')","symbol":"Programmatic API (if any)","correct":"Not available; CLI only"}],"quickstart":{"code":"npm install -g zsr-transpiler\nmkdir my-game && cd my-game\necho '@Players\non Players.PlayerAdded(player) {\n    log(\"Welcome, {player.Name}\")\n}' > src/main.zsr\nzsr-transpiler build src      # output: src/main.luau\nzsr-transpiler watch src     # auto-transpile on save","lang":"javascript","description":"Installs globally, creates a minimal ZSR project, transpiles a script to Luau, and demonstrates watch mode."},"warnings":[{"fix":"Run npm install -g zsr-transpiler to install globally, or use npx zsr-transpiler for on-demand usage.","message":"CLI must be installed globally or used via npx; local install may not expose the command directly.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use the CLI via command line only; do not attempt to import in code.","message":"No programmatic API; require('zsr-transpiler') will throw Module not found.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Upgrade Node.js to version 18 or higher.","message":"Watch mode may fail on older Node versions (<18) due to dependency requirements.","severity":"breaking","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run npm install -g zsr-transpiler to install globally, or use npx zsr-transpiler.","cause":"zsr-transpiler not installed globally or not in PATH.","error":"zsr-transpiler: command not found"},{"fix":"Reinstall the package with npm install -g zsr-transpiler to ensure all dependencies are installed.","cause":"Missing dependency due to incomplete installation.","error":"Error: Cannot find module 'chokidar'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}