tts-types
v0.0.3
Published
<div align="center">
Downloads
5
Readme
Typescript Declarations for Tabletop Simulator
Hello! These types are intended to be used with Typescript to Lua. With that compiler you can transpile .ts
files into .lua
files. This package is the safety net for the Tabletop Simulator functions and objects. Let your editor have some nice autocompletion!.
Usage
- Install these packages and make a
src
directory:
npm i tts-types typescript typescript-to-lua
mkdir src
- Create tsconfig.json:
{
"compilerOptions": {
"rootDir": ".",
"outDir": "build",
"target": "ESNext",
"lib": ["ESNext"],
"moduleResolution": "nodenext",
"module": "NodeNext",
"declaration": false,
"declarationMap": false,
"strict": true,
"types": ["tts-types"],
},
"tstl": {
"luaTarget": "5.2",
"noImplicitSelf": true,
"tstlVerbose": true,
"luaBundle": "bundle.lua",
"luaBundleEntry": "src/index.ts",
},
}
note: we use "luaTarget": "5.2"
to be compatible with the LUA version Tabletop Simulator uses.
- Create
src/index.ts
// The OnLoad function. This is called after everything in the game save finishes loading.
// Most of your script code goes here.
function onLoad( saveData: any ) {
// Lock color-UI cube
let cube = getObjectFromGUID( "c1a0d1" )
cube.interactable = false
cube.setLock( true )
}
- Your project is ready! run
npx tstl
to compile it into Lua
npx tstl
You will have some output like this:
Loaded 0 plugins
Parsing project settings
Transforming C:/Source/tts-test/src/index.ts
Printing C:/Source/tts-test/src/index.ts
Constructing emit plan
Resolving dependencies for C:/Source/tts-test/src/index.ts
Emitting output
Emitting C:/Source/tts-test/build/bundle.lua
Emit finished!
Your .lua file now exists at build/bundle.lua:
--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
local ____modules = {}
local ____moduleCache = {}
local ____originalRequire = require
local function require(file, ...)
if ____moduleCache[file] then
return ____moduleCache[file].value
end
if ____modules[file] then
local module = ____modules[file]
____moduleCache[file] = { value = (select("#", ...) > 0) and module(...) or module(file) }
return ____moduleCache[file].value
else
if ____originalRequire then
return ____originalRequire(file)
else
error("module '" .. file .. "' not found")
end
end
end
____modules = {
["src.index"] = function(...)
--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
function onLoad(saveData)
local cube = getObjectFromGUID("c1a0d1")
cube.interactable = false
cube.setLock(true)
end
end,
}
return require("src.index", ...)
I use this to copy it in automatically (package.json):
"scripts": {
"compile": "tstl && npm run deploy",
"deploy": "copy \"build\\bundle.lua\" \"%LOCALAPPDATA%\\Temp\\TabletopSimulator\\Tabletop Simulator Lua\\Global.-1.lua\""
}
So I can simply use npm run compile
Contributing (TODO)
- Finish tests
- Create example projects
Development
- Clone
npm install
npm run build
to build the projectnpm run test
to run tests