Saw Tapes

Saw Tapes is a mod that adds new mini-games. 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

Hunting Game

The Hunting Game starts when a player comes within a configurable distance of the tape.

The targeted player is gassed and appears in front of the tape, along with a shovel and wearing the iconic "Reverse Bear Trap" on their head. The mini-game's objective is to remove the trap within the time limit.

To remove the trap, the player must find the key, hidden within the entrails of a specific monster. If the tested player kills a monster that doesn’t have the key, it will drop a "Pursuer Eye" item instead, allowing the player to reveal the aura of the monster they need to find. This aura is also revealed at the start of the mini-game, giving the player some direction and possibly identifying the correct monster.

Warning! To prevent players from searching for the monster before the mini-game begins, they can't stray far from the mini-game's starting point without facing punishment. They must start the tape, which will trigger the game once Jigsaw finishes explaining the rules.

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

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 doors names (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)

Hunting Game

All the necessary configurations can be found in the mod's classic config file

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

Reverse Bear Trap

"Reverse Bear Trap" (https://skfb.ly/oSWDH) by ✩~𝙼𝚒𝚔𝚘 𝙲𝚑𝚊𝚗~✩ is licensed under Creative Commons Attribution (http://creativecommons.org/licenses/by/4.0/).

Change made:

• Slight jaw reduction, allowing the player to see better ahead

CHANGELOG

Version 1.1.5

• Added compatibility with the Yavin IV and CastleGrounds interiors for the Survival Game
  • delete the ST.survival_game.json file to allow it to regenerate with the new configuration
• Fixed a bug that altered rarity configurations in the config file

Version 1.1.4

• Improved aura for the Hunting Game and fixed some monsters that were not showing it

Version 1.1.3

• Added checks for potential NREs
• Added a HUD section in the settings
• Moved the subtitles enable option to the HUD section
• Added two settings, 'Chrono pos X' and 'Chrono pos Y,' to adjust the position of the chrono text
• Modified the chrono text to make it easier to reposition

Version 1.1.2

• Changed the teleportation system during the setup of the Hunting Game: now the player, along with the tape and shovel, are teleported to the main entrance, preventing the player from spawning in a location where they could get stuck
• Fixed an issue that allowed the Hunting Game key to be dropped on all monsters of the same type as the one being hunted
• The monster spawned by the Hunting Game will now despawn at the end of the mini-game if it hasn’t been killed
• Prevented mini-games with a rarity of 0 from having their spawn rate increased by the 'Rarity increment' config

Version 1.1.1

• Fixed a bug that allowed players to start the Hunting Game in the ship when loading a lobby with the tape inside
• Fixed a bug that allowed the first mini-game to be replayed even after a successful completion
• Fixed an error that occurred when the selected enemy for the Hunting Game didn’t have an EnemyAICollisionDetect or a Renderer on EnemyAICollisionDetect
• Added a check to prevent a Null Reference Exception if Billy’s animator is null
• Increased the default value for the maximum allowed distance a player can move before starting the tape for the Hunting Game mini-game and added a config option to modify this distance

Version 1.1.0

• Added a new mini-game "Hunting Tape"
• Added a JSON file structure check: if the structure is incorrect, the old file will be renamed with ".old" and the default file will be generated
• Refactored code extensively to allow both mini-games to share common code
• Fixed an issue where the Saw theme would play but not the mini-game if the tape was triggered by someone other than the tested player just before

Version 1.0.9

• Game version update
• Adding StarlancerAIFix as a dependency
• Fixed a bug with orbiting ship monitors not displaying what they should.
• Changed the player's camp penalty -> spawn a Nutcracker instead of killing the player, the option has been renamed the config file
• Modified monster spawns to be based a little more on the player's height (to avoid spawns on unreachable positions).
• Many changes to the ST.survival_game.json file (don't hesitate to give me feedback on the difficulty of some hordes depending on the rooms you encounter, it's hard to find the right balance!):
  • Addition of numerous monster hordes to provide greater variety and take into account the size of all rooms.
  • Addition of several possible interiors for the Saw game: Toy Store / The Rubber Rooms / Niven Reactor / Storehouse / Gothic Monastery / Chizra Temple / Skaarj Outpost / Guardia Fortress
  • Changed the 'door_name' field to 'doors_names', which now includes a list of door names.
  • delete the ST.survival_game.json file to allow it to regenerate with the new configuration

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