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.

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

• The screens that are shown upon opening the terminal have been changed to show that the terminal is powered by lammOS.
• All responses from commands will be formatted to end with a > with an empty line between the previous text and the >, to ensure command responses have some level of consistency.
• You now don't need to enter at least three characters for the terminal to understand what you were trying to buy or view, you only need to type the first character, or however many you set for the CharsToAutocomplete config option, but keep in mind 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.
• 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 it.
  • All commands are given a "category", and those commands will be shown in categories when using the >HELP command with no arguments.
• Most commands now have shortcuts, for example:
  • >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 decorative items that have already been purchased.
• There's a config option to have commands like >ROUTE and >BUY not ask for confirmation before doing something.
• 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 the building until they are picked up and dropped, this does not occur if you are the host.
• 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, and the >PING and >FLASH commands will now act on the radar booster currently being viewed if entered with no arguments.
• Along with many other small changes to vanilla commands, such as how they work to make them easier to use, and how their responses will look to clean some of the unnecessary text.

What's Added

• The >TARGETS command, which lists all of the radar targets you can view on the monitor or terminal with >MONITOR.
• A clear command (>CLR or >C) that will clear all text from the terminal, useful if you can't see the monitor 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/closed and lights on/off.
• The >TP and >ITP commands to remotely activate the teleporter and inverse teleporter.
• The >SHORTCUTS command, which will list all of the shortcuts associated with every command.
• 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:
    • Purchaseable items and unlockables
    • Entity invulnerability
    • Entity power and the max that can exist
    • Ect.
• A clock in the top right corner of the terminal, optional with a config option.
• Using the left and right arrow keys while on the terminal will make you switch between radar targets on the ships monitor.
• Using the up and down arrow keys will let you go through your command history to run commands again or correct typos without having to retype the full command.
• You can create and run macros that'll run a set of commands you give it, great for setting up a "kit" macro so that you can buy a lot of things you normally do quickly.
  • If you have command confirmations on, you'll also have to have the macro confirm the action with a second command. Just entering C will make it so the command is confirmed if that config option is enabled, and it will "clear the terminal" if it isn't enabled as C is a shortcut for >CLR. Great to remember if you want to share your macros with others and want them to work universally.
• A synced config to allow you to change the maximum amount of items on the delivery dropship, as well as change the prices for every moon, item, and unlockable.

What's Planned

• Fixing a potential error that could occur if modded planets don't follow the same naming scheme that vanilla ones do. This hasn't been a problem quite yet but it is something I'm aware of.
• Fixing the possibility of any desyncing or inconsistencies occuring caused by other mods, so that the >RELOAD command doesn't need to be used.
• Showing the entity's base health when viewing one using the >BESTIARY command.

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.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