The Forgotten Server - TypeScript Declarations

Typescript declaration files for The Forgotten Server 1.4.2.

Installation

npm install --save-dev forgottenserver-ts-declarations

In your project modify tsconfig.json to include the following:

{
  "include": [
    "<your other packages>",
    "node_modules/forgottenserver-ts-declarations"
  ]
}

Example

A talkaction /kill_player that instantly kills a player when you are a God.

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

talkAction.onSay((player, words, param) => {
  const potentialPlayer = Player(param.trim());
  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 {};

Good to know

• Typescript code is transpiled to Lua, so there is no browser or Node.js specific APIs. Treat it as a templating language for Lua.
• All the structures are defined in a global scope. No importing is required.
• By default all root level variables are not scoped, for example:

    // file A.ts
    const a = 1;
    
    // file B.ts
    const a = 2; // Error: Variable 'a' is already defined in the global scope.

  To avoid this, use export {} at the end of the file to create a module scope.

    // file A.ts
    const a = 1;
    export {};
    
    // file B.ts
    const a = 2; // No error
    export {};

• All the enums are treated in a special way. See example:

  // A.ts
  print(MessageClasses.MESSAGE_STATUS_WARNING);

  is transpiled to:

  # A.lua
  print(MESSAGE_STATUS_WARNING);

Overview

This project includes TypeScript declaration files in two directories for type definitions:

• cpp: Contains declarations for structures defined in src/luascript.cpp.
• lua: Contains declarations for structures defined in the data directory with Lua scripts.

Contributing

Pull requests are welcome.