The Forgotten Server - TypeScript scripting environment

[Humberd]

The Forgotten Server - TypeScript scripting environment

Link to a project -> GitHub - Humberd/forgottenserver-ts-scripting: Script your ForgottenServer with TypeScript! (https://github.com/Humberd/forgottenserver-ts-scripting)

Note: It's the follow-up of my previous post My little project - scripting in Typescript (https://otland.net/threads/my-little-project-scripting-in-typescript.287748/)

Allows you to write scripts in Typescript instead of Lua for the Forgotten Server.
It uses hand-written type declarations to provide a type-safe environment for scripting.

How to install?

1. Install node.js. Verify it's installed by running:

node --version

2. Copy everything from content-to-paste directory to your forgottenserver root directory.





3. Install node dependencies by running in a root directory of your forgottenserver:

npm ci

How to use?

Development mode

There are 2 helper scripts you can run side by side

• Transpiling Typescript to Lua:

It watches for changes in ./ts-lua directory and transpiles them to Lua.

npm run build-ts:watch

• Compiling and running The Forgotten Server:

npm run build-and-run-cpp

Production mode

npm run build-ts
npm run build-cpp

Features

Syntax Highlighting

Code Completion

Autocompletes enums:

Autocompletes C++ and Lua functions and methods:

Compilation errors

How it works?

All the TypeScript files from ./ts-lua directory are transpiled to Lua
and are placed in ./data/scripts/ts-lua directory.
They are treated as normal Lua scripts by the Forgotten Server.

There is also a library generated in ./data/lib/lualib_bundle.lua.
It contains compat functions that allow a seamless use of typescript builtin feature,
such as Array, Map, Set, etc.
It is placed in the ./data/lib directory, because it needs not to be reloaded,
when you reload your scripts using /reload scripts GOD command.

Example code

A talkaction script that instantly kills a player

const talkAction = TalkAction('/kill_player', '/kp');

/**
 * Kills a players by name.
 * Usage: /kill_player <player name>
 * Example: /kill_player Player1
 */
talkAction.onSay((player, words, param) => {
  const potentialPlayer = Player(param.trim());
  potentialPlayer
  if (!potentialPlayer) {
    player.sendTextMessage(MessageClasses.MESSAGE_STATUS_WARNING, `Player ${param} not found.`);
    return false;
  }
 
  potentialPlayer.addHealth(-potentialPlayer.getHealth());
  potentialPlayer.getPosition().sendMagicEffect(MagicEffectClasses.CONST_ME_MORTAREA);
  potentialPlayer.sendTextMessage(
    MessageClasses.MESSAGE_STATUS_CONSOLE_BLUE,
    `You were instantly killed by god`,
  );

  player.sendTextMessage(
    MessageClasses.MESSAGE_STATUS_CONSOLE_BLUE,
    `Killed ${potentialPlayer.getName()}`,
  );

  return false;
});

talkAction.separator(' ');
talkAction.access(true);
talkAction.accountType(AccountType.ACCOUNT_TYPE_GOD);
talkAction.register();

export {};

Is transpiled to:

local ____lualib = require("data/lib/lualib_bundle")
local __TS__StringTrim = ____lualib.__TS__StringTrim
local __TS__SourceMapTraceBack = ____lualib.__TS__SourceMapTraceBack
__TS__SourceMapTraceBack(debug.getinfo(1).short_src, {["6"] = 1,["7"] = 8,["8"] = 9,["9"] = 11,["10"] = 12,["11"] = 13,["12"] = 18,["13"] = 18,["14"] = 18,["15"] = 18,["16"] = 23,["17"] = 8,["18"] = 26,["19"] = 27,["20"] = 28,["21"] = 29});
local ____exports = {}
local talkAction = TalkAction("/kill_player", "/kp")
talkAction:eek:nSay(function(player, words, param)
    local potentialPlayer = Player(__TS__StringTrim(param))
    potentialPlayer:addHealth(-potentialPlayer:getHealth())
    potentialPlayer:getPosition():sendMagicEffect(CONST_ME_MORTAREA)
    potentialPlayer:sendTextMessage(MESSAGE_STATUS_CONSOLE_BLUE, "You were instantly killed by god")
    player:sendTextMessage(
        MESSAGE_STATUS_CONSOLE_BLUE,
        "Killed " .. potentialPlayer:getName()
    )
    return false
end)
talkAction:separator(" ")
talkAction:access(true)
talkAction:accountType(ACCOUNT_TYPE_GOD)
talkAction:register()
return ____exports

Compatibility

It should work with any version of the Forgotten Server.
However, type declarations are currently written only for the 1.4 version of the Forgotten Server.

https://github.com/Humberd/forgottenserver-ts-declarations.

If you want to use it with a different version, you need to write your own type declarations
to match the API of your version of the Forgotten Server.
Contributions are welcome!

 

[oen432]

Is it using TypeScriptToLua (https://typescripttolua.github.io/) ?

Edit: Ye it is, "typescript-to-lua": "1.24.1". Cool, I remember someone mentioning this in the past. Good job making it work.

 

[Erikas Kontenis]

Indeed, good job on making this happen and sharing I wouldn't say I would be a fan of using typescript however this gathers community and its interested folks

 

[Ftilt]

Goated, thanks!