Usage Guide - giosuel/imperium GitHub Wiki

This section of the wiki is dedicated to guides on how to use and be productive with Imperium.

UI System and Keybinds

Imperium is divided into multiple main interfaces that can be opened separately with the functional keys F1 - F8. 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.

Default Keybind Action
F1 Opens the main Imperium interface.
F3 Opens the teleportation interface and the waypoint manager.
F6 Opens the Oracle spawn prediction.
F8 Opens the full-screen map.
T Toggles interactive teleportation.
F Toggles the Imperium freecam.
M Toggles the Imperium minimap.
X Toggles the freecam's picture-in-picture mode.
F11 Toggles the freecam's picture-in-picture mode's fullscreen.
Z Toggles the employee's HUD.

Imperium UI

The Imperium UI is the heart of Imperium. It contains the most important general settings as well as the objects explorer, that lets you view and modify the game objects in the current scene.

imperium-control-center

  • 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)

Minimap / Map

Imperium comes with it's own built-in map and minimap.

imperium-map

imperium-minimap

imperium-minimap2

Keybind Action
M Enable / Disable minimap.
ScrollUp Zoom map in (Alt + ScrollUp when map is not open).
ScrollDown Zoom map out (Alt + ScrollDown when map is not open).
LMB Drag Rotate the map camera around the target.
RMG Drag Pan the map camera.

Visualizers

The visualizers windows allows access to all the static and dynamic collider visualizers, gizmos and screen-space overlays.

imperium-visualizers

  • Overlays: Various in-game overlays for nodes, vents and other static objects.
  • Colliders: Collider visualization of predefined game objects by tag or layer.
  • Gizmos: In-game objects that help visualize casts, effect ranges and more.

imperium-los-vis

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.

[!TIP] 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.

moon-settings

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.

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

save-file-editor

[!CAUTION] 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.

freecam

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

Keybind Action
UpArrow Moves layer selection up in layer selector.
DownArrow Moves layer selection down in layer selector.
Space Toggles selected layer in layer selector.
LeftArrow Increases freecam field of view.
RightArrow Descreases freecam field of view.
ScrollUp Increases freecam movement speed.
ScrollDown Decreases freecam movement speed.
R Resets the freecam's position, FOV and movement speed.
T Teleports the player model to the freecam.
L Toggles layer selector.

Spawning Console

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

Command Syntax: objectName [amount] [health / value]

spawning-ui

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.

[!NOTE] Oracle is currently in beta stage and is therefore not guaranteed to always work properly.

imperium-oracle

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.