/LethalTerminalExtender

Mod library for adding custom commands and interactions on the Lethal Company terminal.

Primary LanguageC#MIT LicenseMIT

Lethal TerminalExtender

A modding utility for Lethal Company that allows mods to add their own custom commands to the ship terminal.

terminalextender

Some Notes

  • Mod is entirely client side and does not attempt to handle any networking logic, this should be handled by your mod instead.
  • A custom interaction mode can be enabled that will temporarily disable the default terminal commands.

Todo

  • Need to consolidate harmony patches into a single class.
  • Add an event/callback for when user begins/ends interaction with terminal.

Getting Started

Download the current built .dll file in the releases and include it as a refrence in your local mod project. When packaging your mode, be sure to either include it (local play) or include it as a dependency (mod manager).

Once included in your project, inside your mod you can run the following to add a custom command.

TerminalExtenderUtils.addQuickCommand("helloworld", "Hello World!", true, (Terminal term, TerminalNode node) =>
{
    // a callback that is called when the command is ran
});

If you need/want to define your own keyword, node, and compatible nouns, you can add a command this way as well.

TerminalNode nodeObject = ScriptableObject.CreateInstance<TerminalNode>();
nodeObject.clearPreviousText = true;
nodeObject.terminalEvent = "helloWorldEvent";
nodeObject.displayText = "Hello world!";

TerminalKeyword keywordObject = ScriptableObject.CreateInstance<TerminalKeyword>();
keywordObject.word = "helloworld";
keywordObject.specialKeywordResult = nodeObject;

Action<Terminal, TerminalNode> callbackAction = (term, node) =>
{
    // run some function here
    //
    //

    // or if you want to take over the terminal completely for custom applications
    TerminalExtenderUtils.setOnSubmit((string command) =>
    {
        // command will be the next raw text command that is submitted
        // you can call various helper methods such as

        // toggle terminal input state
        TerminalExtenderUtils.setInputState(true);

        // clear terminal screen
        TerminalExtenderUtils.cleanTerminalScreen();

        // write to terminal
        TerminalExtenderUtils.writeToTerminal("Hello again, you typed in: " + command + "\n");

        // play audio
        TerminalExtenderUtils.playAudioClip(0);

        // instead of writing, you can send a node
        TerminalExtenderUtils.displayNodeOnTerminal(nodeObject);

        // we are done with custom input, handle the terminal over to the game
        TerminalExtenderUtils.releaseOnSubmit();

        // in a real world use case, you would not run all of these at once.
        // they are just here to display what can be done
    });
};

TerminalExtenderUtils.addCustomCommand(new TerminalCustomCommand()
{
    keyword = keywordObject,
    node = nodeObject,
    callback = callbackAction
});

External Dependencies Used

New to Lethal Company Modding?

Check out this Lethal Company Modding Wiki which has some good resources on how modding the game works, and even guides to add multiplayer to your mod.

License

Feel free to fork, submit pull requests, or use this mod in any way shape or form as long as you include the LICENSE file which is above in the repo. The source uses the open source MIT License.