Cursed Scraps

Cursed Scraps is a mod inspired by Strange Objects, revisiting the original concept but with different effects. Special thanks to the author of this other mod for their original idea, which inspired me to create my own version.

Description

Some scraps may appear cursed, offering a more attractive price, but you will have to face this curse until you return to the ship. When a cursed item is picked up, the curse is shared with the player, but this doesn't prevent another player from acquiring the same curse if they pick up the same item later. The curse remains active until the player returns to the ship, where all curses are lifted. Storing a cursed item in the ship removes its curse, but its price remains the same.

New pills can appear in the level, with a probability (configurable) of appearance per cursed item spawned. Only one can be used at a time, and when used, it immunizes the player against the cursed of the NEXT scrap they pick up. However, the scrap will retain its curse, so take the opportunity to bring it back to the ship! This feature can be disabled.

A configurable mechanic is available to hide curses on scraps :

• Always - Always hide curses.
• Never - Never hide curses.
• Counter - Use a counter to hide curses once a certain number (configurable) of non-cursed items have been picked up.
• NeverNotNamed - Never hide that a scrap is cursed, but hide the curse by replacing the name with '???'.
• CounterNotNamed - Use a counter to hide curses once a certain number (configurable) of non-cursed items have been picked up and always hide the curse by replacing the name with '???'.

Curses

• INHIBITION - Prevents the player from jumping and crouching
• CONFUSION - Reverses movement controls and jump/crouch keys for the player
• CAPTIVE - Prevents the item from being thrown until it has been brought back to the ship
• BLURRY - Reduces visual clarity on the player's camera
• MUTE - Mutes the player's microphone
• DEAFNESS - Removes the player's sound
• ERRANT - Teleports the player randomly when an item is picked up or placed down
• PARALYSIS - Paralyzes the player when scanning an enemy
• SHADOW - All enemies are invisible by default (their sound is still active), scanning reveals them
• SYNCHRONIZATION - The scrap is split into two parts, when both parts are picked up by two different players, their cameras invert. You must bring both parts back to the ship... or die for the effect to fade
  • If a player who doesn't have the curse picks up one of the two parts, he is immobilized until another player picks up the other part and the curse takes effect
  • If a player dies with the effect activated, the other player returns to their camera but is immobilized until another player picks up the other part and the curse takes effect
  • If no player is available to share the curse, the immobilized player can simply drop the item on the ground to move again
• DIMINUTIVE - Reduces the player's size and applies the following effects :
  • The movement speed is reduced
  • The grab distance is reduced
  • The player's voice is modified
  • Double jumping is possible, allowing passage through jumping rooms
  • Picked up objects are reduced in size but return to normal size when released
  • A normal-sized player can crush a reduced-sized player
• EXPLORATION - Prevents the player from exiting or entering the factory through all doors except one
  • The player is then able to scan the door they must take for a certain amount of time (configurable)
  • The door to be taken changes each time they enter or exit the factory
• COMMUNICATION - This curse affects two players in two stages :
  • Step 1 :
    • The first player picks up the scrap and is immobilized (it's still possible to drop the scrap to cancel the curse during the first step)
    • The picked-up scrap is cloned at a distant position from the player
    • The second player is selected, which is the one closest to the first player
    • The first player sees numbers appear at the top left of the screen, indicating the distance between the second player and the second part of the scrap
    • The second player must then retrieve this second part of the scrap, and the first player can assist the second using a Walkie-Talkie to guide them based on the distance
  • Step 2 :
    • The second player picks up the second part of the scrap, and the first player can move again
    • A timer appears at the top left of the screen for both players. For the first player, the timer replaces the previously displayed distance
    • Both players must bring the two scrap parts back to the ship before the time runs out, or else... they both die!

More informations

I've tried to make the mod as optimized as possible with my knowledge. I'm far from being an experienced developer, so if there are people more comfortable than me who have feedback on my code, I'm open to it as it will help me improve. 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). DMs are welcome.

CHANGELOG

Version 2.0.4

• Added a check to only apply curses to scraps that spawn in the dungeon (fixes an incompatibility with LethalCasino)
• Added a check to prevent coop curses from spawning when the player is solo
• Added a test to destroy scraps that still have a curse while in the ship at the end of the game (mainly for coop curses)
• Added a test to kill players who still have a coop curse at the end of the game

Version 2.0.3

• Added a config to enable/disable curse particles
• Added a config to enable/disable the red scan node (fix an incompatibility with LGU's 'Better Scan' upgrade)

Version 2.0.2

• Added a config to hide the information popup when the player is cursed
• Added a config to hide the curse particle when picking up the scrap and make it reappear when dropping the scrap
• Fixed an error with the Communication curse that made the player immobile even after dropping the scrap
• Removed the ability to drop the scrap when the Synchronization curse is active on both players
• To drop a scrap with a coop curse, both players must be in the ship
• Fixed a crash when connecting to a save with items in the ship
• Added an informational message that prevents the player from picking up a scrap with a coop curse if they have the Captive curse

Version 2.0.1

• Forgot the asset file

Version 2.0.0

• Mod Rewrite - this is primarily to clean up the code, optimize various aspects, and enable the addition of future curses that couldn't be implemented before (also potentially fixes several incompatibilities)
• Deactivation of the 'EXPLORATION' curse, pills, and the hide mechanic - I plan to rework these features, they will return later
• CAPTIVE - Players affected by this curse will no longer be able to drop any items (previously, it was only the cursed scrap)
• PARALYSIS - Now applies not only to monsters but to all red scans
• SYNCHRONIZATION - Added the ability to reorient the camera towards the controlled player to make the curse less impactful (use the tertiary action button on an item). This new feature only works when holding the cursed scrap
• DIMINUTIVE - Collision with another player is now modified:
  • If a player jumps on the cursed player, he is are crushed and die
  • If a player collides with the cursed player while walking or running, he is pushed according to the force of the impact
• Added a particle effect to identify cursed scraps without scanning
• Added an exclusion list to prevent certain scraps from being cursed

Version 1.1.0

• Recompiled for v56

Version 1.0.9

• Fixed "You already have an active cooperation curse" message displayed for all curses

Version 1.0.8

• Fixed some curses persisting after leaving a game
• Added an exclusion list to prevent some enemies from being affected by the "Shadow" curse
• Added new modes for the hiding mechanic

Version 1.0.7

• Fixed an error that occurs during an interaction with nothing

Version 1.0.6

• Added the curse 'Communication'
• Added more configs
• Change in the global chance configuration; it is now possible to configure it per moon (requires a manual update of the configuration with the new default value)
• Resolved an incompatibility with EmergencyDice
• Fixed some other bugs

Version 1.0.5

• Added the curse 'Exploration'
• Added a mechanic to hide curses, see README for more info
• Change in behavior for removing effects upon arrival at the ship: all effects are now canceled even if cursed items are present in the inventory
  • This modification fixes some issues, including a problem with player acceleration upon canceling the 'Diminutive' curse

Version 1.0.4

• Added controls to prevent teleportation from the ship and when attempting to throw a 'Captive' scrap

Version 1.0.3

• Added the curse 'Diminutive'
• Pill rework, see README for more info
• Resolved an incompatibility with LethalSnap
• Changed some values
• Fixed a bug with 'Synchronization'
• Fixed a bug where the 'Mute' curse could disable the 'Deafen' curse when applied to the player after the latter

Version 1.0.2

• Added the curse 'Synchronization'
• Corrected some bugs

Version 1.0.1

• Fixed some potential null reference issues
• Resolved an incompatibility with LethalThings
• Resolved an incompatibility with Diversity
• Corrected an error with invisible meshes on enemies

Version 1.0.0

• Initial release