What is lammOS?

lammOS is a mod that reworks how the terminal commands work, changing how many of them function, and adding several new ones.

What's Reworked

The way commands are parsed and processed by the terminal have been reworked, making using and adding new content to the terminal a smoother experience.

• This has the negative side effect of command results not being 100% similar or synced with the vanilla game or other mods, especially if the game updates or mods change or add content making any drastic changes.
• This will also cause commands added or changed by other mods that use nodes and keywords, what the game normally uses, to potentially be unstable with the terminal, though some will still work with minimal issues. It is possible for other mods to add their own lammOS compatible commands with an optional or required dependency if they so choose though, minimizing all potential issues.

Specifics

More specifically, for modders that are curious, what I did is pre-patch the Terminal.ParsePlayerSentence method to return my own TerminalNode that does basically nothing unless I need it to, such as to use it's displayText property. This does not run any of the code in the actual Terminal.ParsePlayerSentence method, instead I parse the text myself and run the corresponding command's Execute method to give it it's functionality, then it goes on to call the Terminal.LoadNewNode method as normal to update the terminal's on screen text.

• I also pre-patched the Terminal.TextPostProcess method to do nothing by default, as it's functionality is not needed with this mod. This is toggleable within the config for compatibility with other mods however.

What's Changed

Commands

The >HELP command now lists all of the available commands and the arguments they take in, and giving it the name of another command as a argument will give you more information about that command. Most commands now have shortcuts, all of which are viewable with the >SHORTCUTS command, but for some examples:

• >MOON -> >M
• >PING -> >P
• >TRANSMIT -> >T

Commands like >MOON and >BESTIARY will show even more details about the moon or entity you are curious about. The >STORE command will hide upgrades and other decorations that have already been purchased.

The >SCAN command now shows three categories for scanned items: in the ship, inside the building, and outside, as well as what items are at these locations and their values.

• As of v49, joining lobbies will show any scrap in the ship as being inside until they are picked up and dropped, this does not occur if you are the host.
• Additionally, bee hives will appear as being inside instead of outside until they are picked up and dropped.

The >VIEW MONITOR command has been simplified to >MONITOR, or simply >V with the command's shortcut, and the monitor now shows up instantly rather than slowly loading after entering the command.

The >SWITCH command will switch to the next radar target if entered with no arguments, as if you pushed the white button on the monitor. The >PING and >FLASH commands will now act on the radar booster currently being viewed if entered with no arguments.

Config Options

You can disable confirmation screens for commands such as >ROUTE and >BUY by disabling the ShowCommandConfirmations config option.

You can change how many characters you must enter for the terminal to understand what you were trying to buy or view, this can be changed using the CharsToAutocomplete config option, but keep in mind that it will pick the first thing it finds that matches the first couple character(s) you enter and assume that's what you wanted.

• Setting the CharsToAutocomplete config option to a value above the character length of certain options will require you to type the full name of the option.
• You can enable the ShowMinimumChars config option to show the minimum number of characters you need to enter next to the names of things in lists, such as on the >MOONS and >STORE pages.

You can choose the padding character used in commands that show lists of things with the config option ListPaddingChar.

You can choose whether to show percentages (20%) or rarities (1/5) for things involving chance with the config option ShowPercentagesOrRarity.

What's New

Commands

The >SHORTCUTS command, which will list all of the shortcuts associated with every command.

The >TARGETS command, which lists all of the radar targets you can view on the monitor or terminal with >MONITOR.

A >CLEAR command that will clear all text from the terminal, useful if you can't see the monitor while the monitor is on screen after using the >MONITOR command.

The >CODES command, this lists all of the alphanumeric codes you can enter and what they are associated with (doors, turrets, or landmines) on the moon you are currently on.

The >DOOR and >LIGHTS commands to toggle the ship's door open or closed and lights on or off. The >TP and >ITP commands to remotely activate the teleporter and inverse teleporter.

The >RELOAD command, to reload the config and fix any inconsistencies experienced with the terminal. There shouldn't be any inconsistencies unless you have mods that change certain properties while you're in game, if these changes are made beforehand, then there should be no problems.

• A list of properties that may need reloading if altered by mods, though this list is not limited to these properties, potentially includes:
  • The list of purchaseble items and unlockables
  • Entity invulnerability
  • Entity power and the max that can spawn
  • Ect.

You can create and run macros that'll run a set of commands you give it (>CREATE-MACRO and >RUN-MACRO), great for setting up a kit macro so that you can buy a lot of things you normally do quickly.

Features

A clock has been added to the top right corner of the terminal, optional with the config option ShowTerminalClock.

Using the left and right arrow keys while on the terminal will make you switch between radar targets on the ships monitor. Keybinds can be changed in the game's keybinds menu.

Using the up and down arrow keys will let you go through your command history to run commands again or correct typos near the end of a command without having to type the full command again. Keybinds can be changed in the game's keybinds menu.

There is a synced config that allows you to change the maximum amount of items on the delivery dropship, set the maximum number of commands executable per second within macros, enable or disable commands, and change the prices for every moon, item, and unlockable.

• All of these options will shared by the host to the rest of the players who also have the mod. Joining players are not required to have the mod, but purchases made by them will be corrected by the host and they won't be blocked from running vanilla commands.
  • The host is not required to have the mod either, as players joining with the mod will use the default synced config options and not their set options.

What's Planned

Allowing the saving and loading of macros to and from more accessible .txt files within the config folder, allowing them to be shared with others more easily.

• Either by adding save and load macro commands, or by switching from using es3 to plain text files.

Showing the entity's base health when viewing one using the >BESTIARY command.

• This isn't hard if done with fixed values, but will be annoying to do dynamically, which is how I'd want to do it.

Supporting translations, or mods that change text in several areas in general.

Fixing the possibility of any desyncing or inconsistencies occuring caused by other mods, so that the >RELOAD command doesn't need to be used.

• This will take a lot of work to get to this point.

Known Incompatibilities

Advanced Company by PotatoePet

• Price changes don't sync, this has to do with how Advanced Company saves these changes, not making it possible for me to access them.
  • The creator of the mod has plans to make an api that will allow me and other mod creators to get and modify these prices.

Contact

@lammas123 on Discord - Lethal Company Modding Discord - lammOS Thread

Changelog

1.3.0

• Made lots of changes regarding my mod's .csproj file (thanks to @nyxchrono on Discord) and upgraded to VSCode 2022, leading to me making lots of minor changes here and there with the newer IDE.
  • Additionally, the project's .sln and .csproj files are available on the GitHub, contributions and suggestions are appreciated!
• Split the mod's underlying code into more than one .cs file.
• Made changes to command arguments to match more with already defined command argument standards.
• Made changes to the results of commands that list a lot of things to , like >STORE and >SCAN, giving them padding to make prices and values aligned.
  • The character used for this can be modified in the config using the ListPaddingChar option.
• Made lots of changes to the results of commands, making them more consistent throughout, giving them more detail, and making them feel less empty.
• Moved the >CODES and >CODE command to the new Alphanumeric Codes category.
• Made it easier to understand the >CODE command and why it's there.
• Added the >WAIT command to be used within macros to make the macro wait for a given amount of time.
  • This command doesn't do anything normally, and is only used for macros.
• Added a MacroInstructionsPerSecond synced config option, allowing the host to customize how many commands can be ran through a macro per second.
• Added host to client version mismatch warnings for the synced config to the console, this will help with diagnosing problems related to hosts and clients not having the same version of the mod.
• Changed the default value of all price modifiers in the synced config to -1. A value of -1 will signify that the multiplier should be ignored and to use the default price.
• Made several changed to how I load and cache game related information into lammOS on start.
  • Fixed an incompatibility with More_Suits by x753 by improving how purchasable unlockables are loaded into lammOS.
  • Fixed a potential error that could have occured if modded planets didn't follow the same naming scheme that vanilla ones did.
• Made lots of changes to how commands are parsed and executed, removing unnecessary uses of the ref keyword and passes of the whole TerminalNode when just passing and or returning a string result would suffice.
• Fixed a typo I've been making throughout my code regarding 'purchaseables', it's purchasables haha.

1.2.3

• Added a helpful description to all of the first config options in the Synced config per category.
• Actually fixed the issue with items not being properly discounted.
• Made some code readability improvements to getting a moon, item, or unlockables price.

1.2.2

• Added >MONITOR body/helmet camera support for Solos_Bodycams by CapyCat and OpenBodyCams by Zaggy1024.
• Improved the valid radar targets filter on the >TARGETS command to use the same one that switching to targets on the monitor actually uses, rather than filtering out names that start with "Player #".
• Cached the Terminal object as a static property so that I don't need to use the slower FindObjectOfType method to get it in some places.
• Replaced the usages of FindObjectOfType<StartOfRound>() with StartOfRound.Instance.
• Fixed purchasable items not properly being discounted in the store or while purchasing items. (How did I miss this??)
• Fixed using the left arrow to switch to previous radar targets skipping some targets when it shouldn't.

1.2.1

• Added an enabled property to all commands that is set to true by default. Though some commands, like a few I am adding in this update, will be disabled by default.
  • Additionally, I've added a section to the Synced config for commands to be to set as enabled or disabled by the host.
• Added the >LAND and >LAUNCH commands to the Interactive help category as confirmation commands, meaning they depend on the ShowCommandConfirmations config option.
• Added the >CODE command to the Radar help category as a visual command. Typing 'code' or 'code b2' won't do anything, but typing 'b2' as usual will interact with objects on the radar map.
• Added the optional arguments default, toggle, deactivate, and activate to the alphanumeric code commands, with default just being normal functionality.
  • The toggle argument is disabled by default, but will only toggle door's open or closed states with the entered code.
  • The deactivate argument is disabled by default, but will only deactivate mines and turrets with the entered code.
  • The activate argument is disabled by default, but will trigger mines to detonate and turrets to go haywire with the entered code.
• If the Helmet_Cameras mod by RickArg is on, using the >MONITOR command will show both the map and radar target's helmet camera on the terminal side by side.
• Fixed an error that could occur if the amount of text you typed into the terminal was longer than the amount of text output by a command after submitting it, this error didn't cause any problems as far as I could tell.
• Patched an error that could occur if more than a single unlockable with the same name existed were added, causing lots of functionality with lammOS to break. This was seemingly caused by some additional suit mods.

1.2.0

• Added a command category feature, which sorts terminal commands into categories (based on what it does or what mod added it) in the >HELP command's response.
• Slightly modified how commands are added/registered with the mod, as well as how commands are handled.
• Added some command compatibility with the Lategame Upgrades mod by malco, by giving it it's own help page category if you have the mod enabled. These are purely visual, the commands are still parsed by Lategame Upgrades.
• Added functionality for confirmation screens after entering commands like >BUY and >ROUTE, as well as a config option to make them optional.
  • The confirmation screens will be enabled by default, you'll have to disable them through the config once you run the mod if you liked how commands didn't ask for confirmation before.
• Added the ability to create saveable macros and run them with several macro based commands, which when ran execute a series of instructions you tell it to.
  • These are saved in the file "lammas123.lammOS.Macros.es3" in BepInEx's config folder, making them shareable but sending this file to others. Alternatively you could share the command you used to create the macro and have them copy and paste it.
• Implemented between radar targets using the left and right arrow keys while on the terminal, like the FastSwitchPlayerViewInRadar mod by kRYstall9.
• Implemented a command history using the up and down arrow keys, like the Terminal_History mod by NotAtomicBomb. The maximum amount of commands to save to the history configurable with the MaxCommandHistory config option.
  • The keybinds for switching between radar targets and shifting through command history are configurable within the game's keybind settings menu with the use of the LethalCompany_InputUtils mod by Rune5680.

1.1.2

• Fixed an incompatibility with Lategame Upgrades by malco and other mods that modified the help node's results, making lammOS' replacement of it more mod friendly, as it was causing Lategame Upgrades to throw errors.
  • This incompatibility in particular caused quite a few problems for lammOS, as Lategame Upgrades throwing this error would cause a slight desync from the Terminal for lammOS. This lead to the case where routing to a paid moon would attempt to use the Terminal from the first lobby the host created, but never any lobby after that until they restarted their game.
• Made adding entities to the list of entities viewable with the >BESTIARY command more broad, as it wouldn't add the Rolling Giant from the RollingGiant mod by NomnomAB.

1.1.1

• Fixed a bug that would occur when buying more than 12 items at a time as a client where your purchase wouldn't register but the group credits would be deducted only for you. You would then no longer be able to purchase anything for being on a permanent group credit usage cooldown until someone else did, which would then also fix your desynced group credits.
• Fixed routing to other moons or buying unlockables taking your group credits if purchased as the host. Doing so would either take double the group credits taken if you had the funds, or take only the normal amount but not route you to the moon or unlock the unlockable.

1.1.0

• Fixed a bug with loading all entities into the entity dictionary the bestiary would use when any mod added additional entities.
• Fixed an incompatibility with Lethal Things by Evasia where some of their decor items would cause an error to be thrown when entering the >STORE command.
• Made lots of changes to the publicity of methods and properties in the mod.
• Removed the DisableNewTerminal config option, not sure why I added it initially as it just adds more complexity.
• Made lots of little changes to several commands to make them more consistent with each other.
• Added a new Synced config, along with the new config option MaxDropshipItems.
• Added a synced price multiplier config option for every moon, item, and unlockable, including ones added by mods to the Synced config. This works as a workaround for price changes from Advanced Company by PotatoePet not being retrievable.
  • When joining another server with this mod, your synced config options will sync with the host if they have the mod, otherwise all prices will be set to their default values (so you can't cheat).
  • When joining a host who has the mod while you do not, you'll be able to use and buy things on the terminal as normal, but the host will check to make sure any purchases you make were actually possible according to their config and sync any changes they need to make regarding your purchase accordingly (also so you can't cheat or accidentally break something).

1.0.1

• Switched from using the Terminal.Awake method to the Terminal.Start method, for better compatibility with other mods. Namely Lategame Upgrades by malco, as it would add information to the help node after I would change it and make the resulting node's result look strange.
• Moved appending \n\n> to the end of nodes to a post Terminal.ParsePlayerSentence method, so that the text is added to the end of other mod's nodes, making responses slightly more consistent everywhere.
• Made general improvements to the underlying code to make it more readable by adding some helper methods.
• Made command shortcuts actually change to the name of the command you type in visually upon pressing enter, fixing an incompatibility with Lategame Upgrades by malco that made the >TRANSMIT command shortcut not transmit a message.
  • This also makes the command appear rather than the shortcut if the command doesn't clear all of the text previously there, as well as for Terminal_History by NotAtomicBomb when going back through your history.
• Fixed a (potential) small bug (with the terminal itself) that occured when running multiple commands that don't clear the previous text back to back. Doing so would continuously add 2 new lines before all of the previous text creating a big block of nothing at the top of the screen.
• The current time is now shown in the top right of the terminal. Like Terminal_Clock by NotAtomicBomb

1.0.0

• Initial release