Saw Tapes

Saw Tapes is a mod that adds new mini-games (one for now). These games are triggered by a tape from which the infamous killer Jigsaw will explain the rules of the game to you.

Games

Survival Game

The Survival Game simply consists of surviving for a given amount of time against various creatures from a room in which you will be locked.

It's possible to configure the rooms in which you want to play, as well as the monsters to face and the duration of the mini-game based on the room and the horde of monsters. See the configuration section for details.

An example video is available on a friend's channel : https://www.youtube.com/watch?v=cY1N93jSTv8

Configurations

The different files mentioned below are created when the game is launched (if they don't already exist), and you can find them in the 'config' folder.

Games configurations

Survival Game

The 'ST.survival_game.json' file allows you to configure everything necessary for this mini-game.

It is organized into two main parts:

• Configuration of monster groups (hordes)
• Configuration of the rooms where the game can be played

Horde Configurations:

To add a new horde, copy an existing block while paying attention to the JSON syntax (you can use online validation tools if needed), then:

• Modify the name, which will be used in the next section
• Choose the duration of the mini-game for the horde
• Choose the time range during which a horde can spawn, with 8:00 = 1 and 00:00 = 18
• Choose the value of Billy's puppet for this horde
• Modify/add monsters with their in-game name (you can retrieve the names from other mods like Imperium, for example) and the time at which they will appear — be mindful of the syntax for the final comma!

Room Configurations:

To add a new room, do the same, copy an existing block, then:

• Modify the room name (can be found following the procedure described below)
• Modify the door name (same process)
• Choose the weight value for this room
• Modify the names of the hordes you want to appear; you can assign multiple hordes to one room — in this case, a horde will be randomly selected when the mini-game starts

How to find room and door names?

To do this, use the classic config file associated with the mod and enable debugging (disable it during a game session as it may cause slowdowns). You also need to modify the BepInEx.cfg file to enable the console and set the 'Debug' level for the 'Logging.Console' section (it's best not to keep this enabled during a game session either). Then, launch the modded game and explore the dungeon. When you change rooms, the following log will appear:

[Debug : SawTapes] Enter in the StartRoom(Clone) tile
[Debug : SawTapes] Names of the different possible connections for each doorway:
[Debug : SawTapes] ---
[Debug : SawTapes] - SteelDoorFrameMapSpawn
[Debug : SawTapes] - SteelDoorMapSpawn
[Debug : SawTapes] ---
[Debug : SawTapes] - SteelDoorMapSpawn
[Debug : SawTapes] - SteelDoorFrameMapSpawn
[Debug : SawTapes] ---
[Debug : SawTapes] - SteelDoorMapSpawn
[Debug : SawTapes] - SteelDoorFrameMapSpawn
[Debug : SawTapes] ---

• Choose a room that can have a completely closed variation, or it will never work for that one
• For the room name, simply use the name given on the first line, '(Clone)' is not required
• For the door name, find the correct connection among those displayed (you will need to test it)

Subtitles configurations

The 'ST.subtitles.json' file allows you to change the subtitles: 'timestamp' is the field that corresponds to the moment when the sentence is displayed on the screen according to the recording duration of the tape and 'text' is the sentence displayed.

More informations

For any feedback/suggestions or questions, you can reach me on the 'Lethal Company Modding' Discord server (https://discord.gg/EgQFAq3z) under the same name (username lega2039) or the SawTapes thread. DMs are welcome.

Attributions

Billy On Bike

"Billy On Bike" (https://skfb.ly/oLRPs) by LostBoyz2078 is licensed under Creative Commons Attribution-NonCommercial (http://creativecommons.org/licenses/by-nc/4.0/).

Change made:

• Duplicated part of the model to create the Billy puppet item, which can now be grabbed

CHANGELOG

Version 1.0.8

• Added a config option to display a tip when a player enters the room, informing them to search for the tape
• Fixed a bug that allowed multiple players to play the mini-game at the same time (players can still be in the room together via teleportation, but only the first player to enter can start the mini-game)
• Fixed a bug where the player’s status (whether they are in the mini-game or not) wasn’t reset if they died before starting the mini-game (e.g., dying in the locked room but before playing the tape)

Version 1.0.7

• Fixed a bug that prevented the monster wave from spawning
• Adjusted the resting position of Billy
• Added particles around the tape to make it easier to spot until it’s picked up
• Introduced a feature that moves the tape every 30 seconds after the player enters the room. This feature allows for:
  • fixing the issue where the tape would appear behind a door due to a room having a larger collider
  • fixing cases where the tape spawns at a height requiring a ladder
• Added a feature preventing the tested player from being teleported:
  • the teleporter cannot be used on them
  • if they try to teleport using another method (such as a teleport trap), the player will be killed for cheating
• Added support for new interiors: ScarletDevilMansion, StarlancerWarehouse, Nali Haven and Guardia Fortress
  • delete the ST.survival_game.json file to allow it to regenerate with the new configuration

Version 1.0.6

• Fixed mini-game not resetting if player dies
• Fixed anti-camp system that kills the player if he kills an enemy during the mini-game
• Fixed the music that resumes when player respawns after death
• Fixed an incompatibility with 'Crest' mod

Version 1.0.5 - Forgot to mention some important details:

• The 'ST.survival_game.json' and 'ST.subtitles.json' files need to be reloaded (updated or deleted to let them recreate themselves)
• Modification of the configuration of two rooms for the haunted mansion with a new horde (more suitable for these rooms)

Version 1.0.4

• Fixed an incompatibility with the 'Black Mesa Half Life Moon Interior' mod
• Added Billy which spawns at the end of a mini-game, moving toward the player to announce their victory - It's then possible to collect his puppet and sell it
• Added 'billy_value' configuration in the 'ST.survival_game.json' file to set the value of Billy's puppet based on the horde faced
• Added 'min_hour' and 'max_hour' configurations in the 'ST.survival_game.json' file to configure the time range during which a horde can spawn (8:00 = 2 and 0:00 = 18)
• Added 'billy_announcement' section in the 'ST.subtitles.json' file to configure Billy's subtitles
• Added 'weight' configuration in the 'ST.survival_game.json' file to manage the priority order of the rooms in which the mini-game will appear

Version 1.0.3

• Fixed an incompatibility with ScarletDevilMansion

Version 1.0.2

• Fixed a NullReferenceException when the SawTheme option in the config was disabled

Version 1.0.0

• Initial release