BetterBetterTeleporter

BetterBetterTeleporter is a mod for Lethal Company that adds configurable features for both the regular Teleporter as well as the Inverse Teleporter. The default configuration matches the unmodded version of the game, so this mod will not do anything unless you configure it.

Features

• Configurable Cooldowns: Adjust the cooldown times for each teleporter.
• Item Teleport Behavior: Choose whether items are kept or dropped when using the teleporters.
• Item Whitelists/Blacklists: Specify comma-separated lists of items that are always kept or dropped, overriding the general item teleport behavior.
• Reset Cooldown on Orbit: Automatically reset teleporter cooldowns when returning to orbit.
• Inverse Teleporter Battery Drain: An optional penalty to decrease battery charge for held items when using the Inverse Teleporter.

Configuration

The mod is configured using BepInEx's configuration system. You can modify the settings in the BepInEx/config/BetterBetterTeleporter.cfg file.

If LethalConfig is installed, you can also configure the mod in-game through the LethalConfig menu.

Configuration Options

As an example, if you wanted an Inverse Teleporter that drops all items except for keys and walkie-talkies, and drains batteries by 25%:

InverseTeleporterCooldown = 210
InverseTeleporterBehavior = Drop
InverseTeleporterAlwaysKeep = Key,WalkieTalkie
InverseTeleporterAlwaysDrop =
BatteryDrainPercent = 25

Configuring Item Lists

There are two ways to specify items: by name or by filter. You can specify multiple items/filters by separating them by commas (such as shovel,key,[held],walkietalkie). Names/filters are not case-sensitive (Key, KEY and key all work).

Specifying Items by Name

Here is a list of Lethal Company's internal item names that can be used for whitelisting/blacklisting items:

This is not an exhaustive list: any item should work, including from other mods.

BetterBetterTeleporter will do its best to resolve items with inconsistent names (example: "clipboard" vs "Clipboard" vs "ClipboardItem"). As long as you have a reasonable idea of what the item is called, it should work. Using the in-game display name will also work, but it could have issues between players that use different language settings.

If you have LethalConfig installed, there is a button at the bottom of the BetterBetterTeleporter config section to display the names of all items you're currently holding in your inventory. This should help verify if you're using the correct item name.

(EXPERIMENTAL) Specifying Items by Filter

Disclaimer: this feature is being actively developed and may change in the future.

There are predefined item filters you can use to describe items or groups of items. Here is the current list of item filters:

As an example, take this configuration:

InverseTeleporterBehavior = Drop
InverseTeleporterAlwaysKeep = key,clipboard,[held]

This setting makes the Inverse Teleporter drop all items except for the Key and Clipboard, as well as the currently-selected inventory slot (so if the player is actively holding a GoldBar, they keep it, but if the GoldBar is not the active inventory item, it drops).

For any item filter, you can additionally specify items/filters to exclude from that filter using the :not attribute. Reusing the previous example, if you wanted to disallow the Shovel to be brought into the Inverse Teleporter even if it's currently being held, you can do this:

InverseTeleporterBehavior = Drop
InverseTeleporterAlwaysKeep = key,clipboard,[held:not(shovel)]

Now the Inverse Teleporter still keeps the Key and Clipboard, as well as the currently-held item, UNLESS the currently-held item is a Shovel, in which case it drops.

Dependencies

• BepInExPack
• (Optional) LethalConfig for in-game configuration.

Installation

It's recommended to install from Thunderstore using a mod manager such as Gale.

Contributing

See CONTRIBUTING.md for information on how to contribute to the mod.

Version 1.3.0

• Include utility slot in teleport logic
• Added [utilslot] and [nonutilslot] filters
• Fix issue displaying weight after teleporting

Version 1.2.4

• Compatibility update for v80

Version 1.2.3

• Fix issue with lightning strikes on conductive items after teleporting

Version 1.2.2

• Fix a compatibility issue with mods that modify carry weight

Version 1.2.1

• Delay visual fixes to compensate for possible lag
• Fix issue where players that die during teleport keep items

Version 1.2.0

• Added [filter:item] syntax
• Added patch to fix a visual bug on the teleporter

Version 1.1.5

• Added [all] item filter
• Added [none] item filter
• Added [gordion] item filter
• Added [gordioff] item filter

Version 1.1.4

• Added [battery] item filter
• Added [charged] item filter
• Added [discharged] item filter
• Added [metal] item filter
• Added [nonbattery] item filter
• Added [nonmetal] item filter
• Added [nonscrap] item filter
• Added [nonweapon] item filter
• Added [onehanded] item filter
• Added [pocketed] item filter
• Added [scrap] item filter
• Added [twohanded] item filter
• Added [value] item filter
• Added [weapon] item filter
• Added [weighted] item filter
• Added [weightless] item filter
• Added [worthless] item filter

Version 1.1.3

• Added experimental item filter engine
• Added [held] item filter

Version 1.1.2

• Rewrote netcode from scratch

Version 1.1.1

• Fix issue where dead players wouldn't drop some items
• Fix issue where reconnecting players would always drop all items when teleporting

Version 1.1.0

• Using CSync for better network communication
• Changed BatteryDrainPercent to an integer range from 0 to 100
• Improving init and update performance
• Fix issue where disconnecting players wouldn't drop some items
• Fix incorrect default value on ResetCooldownOnOrbit
• Fix issue where changing server host synced incorrect settings

Version 1.0.2

• Setting default config to match unmodded game behavior
• Fix issue with incorrect carry weight after teleporting

Version 1.0.1

• Hotfix to fix packaged file structure

Version 1.0.0

Initial Release

• Reset cooldowns on orbit
• Customize Teleporter cooldown
• Customizable list of items to keep on Teleport
• Customize Inverse Teleporter cooldown
• Customizable list of items to keep on Inverse Teleport
• Customizable battery drain on Inverse Teleport