JsMacros-typescript
Type information for the JsMacros minecraft mod
Setup
Install the package
Install the version of the package that matches your mod version (for full releases), or 0.0.0-sha (for beta releases)
$ npm install jsmacros/jsmacros-typescript@1.7.0
(release 1.7.0)
$ npm install jsmacros/jsmacros-typescript@0.0.0-30d74d2
(beta-30d74d2)
Add a tsconfig.json file
Mandatory fields
These fields tell typescript to use the ambient type definitions without having to import them
compilerOptions.typeRoots: ["node_modules"]
compilerOptions.types: ["jsmacros/jsmacros-types"]
skipLibCheck: true
: Prevents typescript from reporting errors in the type declaration file - the errors are caused by differences in the typescript and java type systems and are unavoidable
Example config
{
"include": ["src"],
"compilerOptions": {
"outDir": "dist",
"typeRoots": ["node_modules"],
"types": ["jsmacros/jsmacros-types"],
"skipLibCheck": true
}
}
Compiling
If you're writing typescript then you need to compile it to javascript before you can use it in the mod.
- Compile the scripts
Compile once:
$ tsc
or compile automatically whenever you make changes to the sources
$ tsc --watch
- In the mod, select the compiled files from the
outDir
folder instead of the source files