Imperium

Imperium is a powerful and highly performant all-in-one debugging tool to test and explore game mechanics and functionality in Lethal Company.

It is a client-side and server-side mod, meaning it works in singleplayer and multiplayer, as long as Imperium is also installed on the host.

Imperium was made with the intent to be a tool to test game functionality and provide more insight into the weird and wonderful mechanics of Lethal Company.

The Imperium team strongly stands against cheating and trolling in public lobbies. If you really want to cheat, at least put some effort into making your own hacked client!

Features

• Modular and user-centered UI system.
• In-game overlays and indicators for hitboxes of shotguns, shovels, landmines, etc.
• Customizable 3-axis freecam with built-in teleportation and custom FOV settings.
• Visualization of game object hitboxes, spawn locations, tile borders and much more.
• Entity, scrap and map hazard; spawning, de-spawning and teleportation.
• Ability to kill and revive players including the yourself.
• Entity spawn prediction powered by the Oracle Prediction Algorithm.
• Easy adjustment of game variables such as credits, quota deadline, spawn rates and many more.
• Player tweaks such as god mode, infinite sprint, infinite battery, night vision, invisibility, custom movement speed, custom jump height, and many more.
• Player teleportation via coordinate input or interactive location picking alongside a waypoint manager.
• Enabling / Disabling of various render layers, post-processing effects, render passes and more.
• Built-in save file editor for save files (Level options, Furniture location, Player XP, etc.)
• Allows bypassing of the loading screen and instantly loading a save file on start-up.
• Fully compatible with Unity Explorer (Including mouse look fix).
• Fully compatible with the public beta v50 of Lethal Company.

UI System and Keybinds

Imperium is divided into 5 separate main interfaces that can be opened separately with the functional keys F1 - F6. One UI can be opened at a time and opening another UI will result in the others being closed. This also works with the Unity Explorer. Many of the UIs consist of separate windows that can be collapsed if needed. It is currently not possible to re-bind any Imperium keybinds.

Imperium Control Panel

The Main Control Panel allows you to change game and player settings as well as enabling and disabling the various overlays and gizmos Imperium offers. The control panel also allows access the Moon Settings, Render Settings, Imperium Settings, Save File Editor and the Object Settings menu.

• Casting Indicators: Raycast and physics collision indicators (client-side).
• Gizmos: In-game objects that visualize spawn indicators and timers (client-side).
• Colliders: Collider visualization of predefined game objects by tag or layer (client-side).
• Overlays: Various in-game overlays for path-finding, spawn locations, etc. (client-side).
• Player Settings: Player tweaks and adjustments (client-side).
• Game Settings: General game settings and adjustments (client-side).
• Time Settings: Time-related settings (client- and server-side).

Object Explorer

The object explorer allows you to easily manage the various game objects currently loaded in a scene.

• Items and Scrap (Despawn, Drop, Teleport To)
• Entities (Despawn, Respawn, Teleport To)
• Players (Kill, Revive, Teleport To, Teleport Player)
• Map Hazards (Despawn, Teleport To)

Moon Settings

The moon settings interface lets you view and change settings and variables of the current moon. Challenge moon information is always provided, even on non-challenge save files.

All the moon settings, including the min spawns, max power, weather variables and spawn lists are not persistent and reset every time a new game is loaded.

Render Settings

The render settings interface allows you to activate / deactivate render layers and objects that make up the scene. Many of the settings are only used when on a moon. It is also possible to change the resolution of the game in real-time.

• Lighting: Contains light and sub objects.
• Volumetrics: Contains global and local volumes.
• Frame Settings: HDRP-specific camera settings for all the cameras in the scene except the map.
• Post Processing: Screen-space post-processing camera layers.
• Player Overlays / Filters: Contains various employee overlays and filters.

Due to the nature of buffering and rendering of unity cameras, a new render texture has to be generated every time the resolution is changed. The slider has a debounce timer to make sure the game doesn't crash but changing the resolution still lags the game for a few seconds.

Save File Editor

Imperium's built-in save file editor can edit any non-vector data fields from the general save file (LCGeneralSaveData) and the individual game saves (LCSaveFileX).

It is not recommended to use the save file editor unless you know what you are doing.

To provide maximum control over the save files, Imperium doesn't implement any input validation, meaning it is very easy to screw up the saves and render the game completely unplayable!

Always make sure to have a backup before changing anything!

Imperium Freecam

Imperium comes with a built-in freecam that can be activated with F. The freecam camera is an exact copy of the player's gameplay camera with the exception of the culling layers that can be toggled in the layer selector. The layer selector can be toggled with L and is activated by default.

The freecam can be moved with WASD controls and Q and E for up and down movement.

Spawning Console

Tha spawning console allows you to spawn entities, scrap and map hazards into the scene.

There are three different spawn categories; Entites, Items and Map Hazards. The spawn category can be changed with Tab. To spawn the first entity in the autocomplete list, press Return.

Imperium Settings

The Imperium settings interface provides access to various preferences of Imperium.

Logging

Imperium uses message boxes to provide more user-friendly logs; these message boxes can be turned off by unchecking General Logging.

Oracle uses these message boxes to log spawn predictions, meaning, it generates a message box every time the prediction is updated.

It is recommended to keep Oracle logging turned off when not needed, for performance reasons.

Quickload

When enabled, Quickload will skip the start-up screen and / or the game menu.

If the menu is skipped, the number of the save file that will be loaded can be provided in the input box. If Clean File is selected, the save file will be deleted every time a game is loaded.

If Reload On Quit is selected, the game will instantly be reloaded after you exit a game via the quickmenu (Esc).

Other Settings

• Optimize Logs: Adds harmony patches to verbose LC functions to reduce logs and increase the overall game performance and log readability.
• UE Mouse Fix: If turned on, the Unity Explorer UI will capture the cursor and disable head rotation.
• Notifications: Activates / Deactivates the different in-game notifications.

Oracle Spawn Prediction

Oracle is an algorithm developed by the Imperium team to predict indoor, outdoor and daytime entity spawns over the course of the day.

Oracle predicts daytime, outdoor and indoor entities including their spawn times and spawn positions. Clicking the position text in an oracle entry teleports you to the spawn point.

Entities spawned with Imperium do not count towards current level power or their max count, meaning, they do not influence the entity spawning.

Oracle is currently in beta stage and is therefore not guaranteed to always work properly.

Prediction Restrictions

Entity spawns in Lethal Company are dependent on a lot of factors. Since v47 everything became more strictly dependent on the map seed and while this made things a lot easier, there are still a few exceptions in the code that mess up entity spawning. Oracle accounts for all these changes, meaning the spawn predictions can change if one of the following events occur:

• An entity dies (Affects all spawn cycles).
• An eyeless dog kills an employee.
• A masked (entity) is searching for a place to walk to.
• A forest giant is grabbing a player / reaching it's targeted AI node during roaming.
• A bunker spider attempts to place a web.

While Oracle notifies you for most of these prediction adjustments, due to the frequent nature of some of them (e.g. masked searching for a node) it is just not feasible to spam notifications. Make sure to regularly check the Oracle UI for changes if there are masked or bunker spiders present on the map as the prediction can shift a lot.

Bug Reports and Feature Requests

Feel free to submit bug reports or feature requests asissues on Imperium's Github page. Please include your BepInEx log file or an excerpt to make our life easier.

Credits

Imperium was designed and implemented by the Imperium team (giosuel).

Various icons were provided by FlatIcon.

Special Thanks To

• Nebby for helping with the documentation and the testing!

• Swaggies, aminoob and star0138 for the help with the testing of Imperium!

• Dancemoon who made DanceTools for the inspiration for Imperium!

• chaser324 for providing the wireframe shader for the collider visualizations!

• Sligili for writing HDLethalCompany!

Changelog

Imperium v0.1.9 [Beta] - The API Update

As so many of you have requested more advanced debugging functionality that can be accessed by other mods, I have started to implement an API that can be used either in the UE console or by other mods.

I also started writing a wiki that should cover the basics on how to use Imperium as well as information for devs that want to work with Imperium or contribute to Imperium.

Added Stuff

• Added the Imperium API and a wiki for it.
• Added minecraft-like creative flight.
• Added options for the ship to instantly land, take off and travel betwen planets.
• Added an option that removes the hold time on interact triggers (e.g. ship lever or main entrance).
• Added new custom visualizer for Old Birds.
• Added new custom visualizer for Baboon Hawks.
• Added a moon indicator to the minimap.

QOL Changes

• I had to limit the possible quota deadline to 3 days as deadlines above 4 were actually breaking the game. Instead, I added an option to completely disable the quota deadline for testing.
• Turning on god mode now restores health to full and removes the damage overlay.

Internal Fixes

• Fixed a bug where spawned entities would sometimes be placed below the ground.

Known Issues

• Switching between Unity Explorer and a Imperium UI directly breaks the cursor.

  • To fix, just open and close Unity Explorer once.

• Scanner overlays are broken at higher texture resolutions.

• There are currently some issues with multiplayer. Mostly, when someone without Imperium is trying to join an Imperium lobby.

Compatibility

This version is compatible with the v50 update of Lethal Company (Imperium Mod Compatibilities).

Imperium v0.1.8 [Beta] - The Visualizer Update

I reworked the whole visualizer system and added a lot of new visualizers and indicators, including indicators for entity LOS and noise detection.

There is a new UI from which all visualizers can be managed!

Added

• Added many new visualizers for various game objects and layers.
• Added a new notification type for access control and spawning notifications.
• Added a new interface to manage all the visualizers in one place.
• Added entity LOS, proximity and noise detection visualizations.
• Added an option to disable out-of-bounds triggers.
• Added an option to unlock all unlockable items in the terminal shop.
• Added a scaling option for the minimap in the minimap settings.

QOL Changes

• Entity and Player info panels are now rendered in screen-space, resulting in higher resolution.
• The size of the visualizers for indoor and outdoor nodes has been decreased.
• Clamped the freecam movement speed between 1 and 200.

Internal Fixes

• Fixed a bug where Imperium client access would lock the host out.
• Fixed a bug where the render pipeline changed the aspect ratio of some screens.
• Fixed an issue where not all notifcations were toggleable.
• Fixed a bug where the map camera clipping would not adjust when in unlocked mode.

Known Issues

• Switching between Unity Explorer and a Imperium UI directly breaks the cursor.

  • To fix, just open and close Unity Explorer once.

• Scanner overlays are broken at higher texture resolutions.

Compatibility

This version is compatible with the v50 update of Lethal Company. (Imperium Mod Compatibilities)

Imperium v0.1.7 [Beta] - Hotfix

Internal Fixes

• Removed unnecessary debug statements.
• Fixed a bug where items would fall through the ground when teleporting them.
• Fixed a bug where the version wouldn't display correctly.
• FIxed a big where spawned items would fall through the ground.

Imperium v0.1.6 [Beta] - The Map Update

Imperium now has its own isometric map and minimap!

Besides that, Imperium's UI got a complete overhaul with new components, better and more consistent alignment and brand new interface skins! There are currently 8 different interface skins to pick from.

I also reworked the night vision system to be more uniform and comfortable to use.

Compatibility

This version is compatible with the v50 update of Lethal Company (Imperium Mod Compatibilities).

Added

• Added a hybrid 2D/3D isometric map - Open with F8.

  • Added minimap - Open with M.

  • LMB - Look, RMB - Move, MMB - Zoom, R - Reset

• Added an option to prevent the ship from leaving automatically.

• Added eight new interface skins to pick from.

• Added option for host to allow or disallow Imperium commands from clients.

• Added visualization for interact triggers.

Changes

• Completely overhauled the look and feel of the Imperium interface.
• Reworked night vision to be more uniform and comfortable to use.
• The custom welcome message can now be turned off in the settings.

Internal Fixes

• Multiplayer works again!
• Security doors now correctly open and close.
• Fixed a bug where changing weathers was causing an exception on certain moons.
• Fixed the freecam teleport button in the Teleport UI.
• Fixed a bug where Oracle crashed when a vent was overwritten.

QOL Changes

• Teleport Indicator can now be toggled with T.
• The "Vent" category in the object explorer can now be collapsed properly.

Known Issues

• Switching between Unity Explorer and a Imperium UI directly breaks the cursor.

  • To fix, just open and close Unity Explorer once.

• Scanner overlays are broken at higher texture resolutions.

Imperium v0.1.5 [Beta] - The Compat Update

I re-wrote the entity and item management system to improve the compatibility with mods that add items and entities with LethalLib.

In general, using Imperium in existing v50 modpacks should now work a lot better, but I still can't guarantee that it doesn't break with certain mods.

Compatibility

This version is compatible with the v50 update of Lethal Company.

Changes

• Completely rewrote the Spawning UI and entity handling system to be more robust.
• Added support for modded items and entities.
• Items, scrap and spider webs can now be teleported from the Object Explorer.
• Added indoor spawning vents to the Object Explorer.
• Added breaker boxes to the Object Explorer.

Internal Fixes

• Changing the weather in real-time is now fully implemented.
• FOV transitions are now smooth (e.g. when sprinting).
• Fixed a bug that caused freecam inputs to go through when the UI was open.
• Fixed the BepInEx dependency.
• Fixed a bug that caused problems when spawning entities with a space in their name.

QOL Changes

• Entity spawn location can now be picked interactively when in freecam.
• Freecam now spawns above the player when opened for the first time.
• More overlays now correctly look at freecam when its active.

Known Mod Incompatibilities

• Minimap by Tyzeron - Conflicts with the cursor locking

Imperium v0.1.4 [Beta] - The Noise Update

Compatibility

This version is compatible with the v50 rev.4 update of Lethal Company.

Added Features

• Added picture-in-picture mode for freecam (Shortcut: X).
• Added keybind to toggle the Player HUD (Shortcut: Z).
• Added visualization of the outdoor spawn denial points.
• Added night vision to the freecam.
• Added noise markers to indicate nearby noises.

Internal Fixes

• Switched from runtime netcode patching to post-build patching.

QOL Changes

• Dead entities are now marked as dead in the object explorer.

Imperium v0.1.3 [Beta] - Hotfix

Compatibility

This version is compatible with the v50 rev.3 update of Lethal Company.

Buxfixes

• Adjusted Oracle predictions as the daytime entity bug was fixed.
• Updated README with new images.