Skip to content

A Lethal Company (EasySave3) Data Editor. It should work with any game that utilizes EasySave, however the project is setup for Lethal Company.

Notifications You must be signed in to change notification settings

BEMZ01/LethalCompanySaveEditor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LethalCompanySaveEditor CLI

GitHub Downloads (all assets, all releases) GitHub Repo stars

If you find the save editor useful, please give the repo a star!

A simple save editor for Lethal Company, written in Python 3.11 for python versions higher than 3.10 This should work for any project that utilizes ES3 Saves with encryption, you'll need the save location and the decryption password for the game you wish to edit.

This is the CLI version. If you're looking for the GUI version, you can find it here.

How to Download

You can download the latest build of the program from the releases page here.

When you first run LethalCompanySaveEditor, Windows Defender SmartScreen might display a warning message because the program is not yet widely recognized (or signed). This is a safety feature aimed at protecting you from potentially harmful applications. Click "More information" and then "Run anyway" to execute the program.

Features

  • Restore original save file
  • View save file contents
  • Edit save file values
  • Add keys to the save file

Future Features

  • Ability to easily insert items into your save
  • GUI Added 12.01.2024
  • Some way to easily define Vector3 coordinates

Usage

  1. Create a virtual environment (Suggested)

  2. Install the required libraries:

    pip install -r "requirements.txt"
  3. Run the program:

    python main.py [-p decryption_password] [-sf save_folder]

Notes

  • Backup your save files before making any changes!
  • The program is currently in development and may have bugs.
  • Use this program at your own risk.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Text exports

Below is a list of saves that have been exported to text via the program, feel free to use them to test the program or to see what the save file looks like.

Basic save with 2 apparatuses

{"CurrentPlanetID":{"__type":"int","value":3},"DeadlineTime":{"__type":"int","value":3240},"EnemyScans":{"__type":"System.Int32[],mscorlib","value":[15,13,14,3,16,5,0,4]},"FileGameVers":{"__type":"int","value":45},"GroupCredits":{"__type":"int","value":116},"ProfitQuota":{"__type":"int","value":244},"QuotaFulfilled":{"__type":"int","value":0},"QuotasPassed":{"__type":"int","value":1},"RandomSeed":{"__type":"int","value":97682829},"ShipUnlockMoved_Cupboard":{"__type":"bool","value":true},"ShipUnlockMoved_Light switch":{"__type":"bool","value":true},"ShipUnlockMoved_Loud horn":{"__type":"bool","value":true},"ShipUnlockMoved_Teleporter":{"__type":"bool","value":true},"ShipUnlockMoved_Terminal":{"__type":"bool","value":true},"ShipUnlockPos_Cupboard":{"__type":"Vector3","value":{"x":7.568144,"y":1.63693845,"z":-16.7935486}},"ShipUnlockPos_Light switch":{"__type":"Vector3","value":{"x":11.01549,"y":3.74941587,"z":-13.2114782}},"ShipUnlockPos_Loud horn":{"__type":"Vector3","value":{"x":5.877596,"y":1.54161429,"z":-17.0593548}},"ShipUnlockPos_Teleporter":{"__type":"Vector3","value":{"x":5.67885256,"y":2.14171457,"z":-12.2461662}},"ShipUnlockPos_Terminal":{"__type":"Vector3","value":{"x":10.179327,"y":1.92971718,"z":-11.5579805}},"ShipUnlockRot_Cupboard":{"__type":"Vector3","value":{"x":270,"y":179.588562,"z":0}},"ShipUnlockRot_Light switch":{"__type":"Vector3","value":{"x":270,"y":260.14035,"z":0}},"ShipUnlockRot_Loud horn":{"__type":"Vector3","value":{"x":270,"y":183.371933,"z":0}},"ShipUnlockRot_Teleporter":{"__type":"Vector3","value":{"x":270,"y":64.7,"z":0}},"ShipUnlockRot_Terminal":{"__type":"Vector3","value":{"x":270,"y":350.75882,"z":0}},"ShipUnlockStored_Bunkbeds":{"__type":"bool","value":true},"ShipUnlockStored_Cupboard":{"__type":"bool","value":false},"ShipUnlockStored_File Cabinet":{"__type":"bool","value":true},"ShipUnlockStored_Goldfish":{"__type":"bool","value":false},"ShipUnlockStored_Inverse Teleporter":{"__type":"bool","value":false},"ShipUnlockStored_JackOLantern":{"__type":"bool","value":false},"ShipUnlockStored_Loud horn":{"__type":"bool","value":false},"ShipUnlockStored_Plushie pajama man":{"__type":"bool","value":false},"ShipUnlockStored_Record player":{"__type":"bool","value":false},"ShipUnlockStored_Romantic table":{"__type":"bool","value":false},"ShipUnlockStored_Shower":{"__type":"bool","value":false},"ShipUnlockStored_Signal translator":{"__type":"bool","value":false},"ShipUnlockStored_Table":{"__type":"bool","value":false},"ShipUnlockStored_Teleporter":{"__type":"bool","value":false},"ShipUnlockStored_Television":{"__type":"bool","value":false},"ShipUnlockStored_Toilet":{"__type":"bool","value":false},"ShipUnlockStored_Welcome mat":{"__type":"bool","value":false},"Stats_DaysSpent":{"__type":"int","value":4},"Stats_Deaths":{"__type":"int","value":0},"Stats_StepsTaken":{"__type":"int","value":29336},"Stats_ValueCollected":{"__type":"int","value":665},"StoryLogs":{"__type":"System.Int32[],mscorlib","value":[0,6]},"UnlockedShipObjects":{"__type":"System.Int32[],mscorlib","value":[0,1,2,3,5,7,8,11,15,16,18]},"shipGrabbableItemIDs":{"__type":"System.Int32[],mscorlib","value":[10,57,7,7,9,14,9,9,10,9,14,14]},"shipGrabbableItemPos":{"__type":"UnityEngine.Vector3[],UnityEngine.CoreModule","value":[{"x":7.978323,"y":1.357842,"z":-16.8466},{"x":6.84798431,"y":0.559296131,"z":-16.6242027},{"x":-3.66072845,"y":0.506222248,"z":-13.9978933},{"x":-3.13606262,"y":0.506222248,"z":-14.1138687},{"x":7.51461029,"y":1.85879278,"z":-16.86476},{"x":7.464815,"y":2.52133226,"z":-16.8023663},{"x":8.295965,"y":1.7387929,"z":-16.9431248},{"x":7.01499557,"y":1.85879278,"z":-16.9921741},{"x":7.1845665,"y":1.357842,"z":-16.6289959},{"x":7.870886,"y":1.85879278,"z":-16.9591885},{"x":6.893564,"y":2.42568541,"z":-17.0349121},{"x":7.824463,"y":2.52133226,"z":-16.82979}]},"shipItemSaveData":{"__type":"System.Int32[],mscorlib","value":[2]},"shipScrapValues":{"__type":"System.Int32[],mscorlib","value":[80,80]}}

A setup ready for 4 players

{"CurrentPlanetID":{"__type":"int","value":3},"DeadlineTime":{"__type":"int","value":3240},"EnemyScans":{"__type":"System.Int32[],mscorlib","value":[15,13,14,3,16,5,0,4,6,1,7]},"FileGameVers":{"__type":"int","value":45},"GroupCredits":{"__type":"int","value":833},"ProfitQuota":{"__type":"int","value":591},"QuotaFulfilled":{"__type":"int","value":0},"QuotasPassed":{"__type":"int","value":3},"RandomSeed":{"__type":"int","value":2412159},"ShipUnlockMoved_Cupboard":{"__type":"bool","value":true},"ShipUnlockMoved_Goldfish":{"__type":"bool","value":true},"ShipUnlockMoved_Inverse Teleporter":{"__type":"bool","value":true},"ShipUnlockMoved_Light switch":{"__type":"bool","value":true},"ShipUnlockMoved_Loud horn":{"__type":"bool","value":true},"ShipUnlockMoved_Signal translator":{"__type":"bool","value":true},"ShipUnlockMoved_Teleporter":{"__type":"bool","value":true},"ShipUnlockMoved_Television":{"__type":"bool","value":true},"ShipUnlockMoved_Terminal":{"__type":"bool","value":true},"ShipUnlockMoved_Welcome mat":{"__type":"bool","value":true},"ShipUnlockPos_Cupboard":{"__type":"Vector3","value":{"x":7.31643343,"y":1.63763463,"z":-16.9174538}},"ShipUnlockPos_Goldfish":{"__type":"Vector3","value":{"x":10.3073874,"y":2.760485,"z":-13.3254519}},"ShipUnlockPos_Inverse Teleporter":{"__type":"Vector3","value":{"x":2.742992,"y":2.14171457,"z":-13.0040865}},"ShipUnlockPos_Light switch":{"__type":"Vector3","value":{"x":11.01549,"y":3.74941587,"z":-13.2114782}},"ShipUnlockPos_Loud horn":{"__type":"Vector3","value":{"x":5.877596,"y":1.54161429,"z":-17.0593548}},"ShipUnlockPos_Signal translator":{"__type":"Vector3","value":{"x":7.044799,"y":0.5210928,"z":-11.19898}},"ShipUnlockPos_Teleporter":{"__type":"Vector3","value":{"x":4.70941639,"y":2.14171457,"z":-12.8421249}},"ShipUnlockPos_Television":{"__type":"Vector3","value":{"x":10.6104879,"y":1.95212674,"z":-13.2053919}},"ShipUnlockPos_Terminal":{"__type":"Vector3","value":{"x":10.179327,"y":1.92971718,"z":-11.5579805}},"ShipUnlockPos_Welcome mat":{"__type":"Vector3","value":{"x":-4.99567175,"y":0.346222043,"z":-14.2044926}},"ShipUnlockRot_Cupboard":{"__type":"Vector3","value":{"x":270,"y":179.588562,"z":0}},"ShipUnlockRot_Goldfish":{"__type":"Vector3","value":{"x":270,"y":0,"z":0}},"ShipUnlockRot_Inverse Teleporter":{"__type":"Vector3","value":{"x":270,"y":64.7,"z":0}},"ShipUnlockRot_Light switch":{"__type":"Vector3","value":{"x":270,"y":260.14035,"z":0}},"ShipUnlockRot_Loud horn":{"__type":"Vector3","value":{"x":270,"y":183.371933,"z":0}},"ShipUnlockRot_Signal translator":{"__type":"Vector3","value":{"x":270,"y":92.971,"z":0}},"ShipUnlockRot_Teleporter":{"__type":"Vector3","value":{"x":270,"y":64.7,"z":0}},"ShipUnlockRot_Television":{"__type":"Vector3","value":{"x":-3.41509462e-06,"y":275.174683,"z":89.9951553}},"ShipUnlockRot_Terminal":{"__type":"Vector3","value":{"x":270,"y":350.75882,"z":0}},"ShipUnlockRot_Welcome mat":{"__type":"Vector3","value":{"x":270,"y":0,"z":0}},"ShipUnlockStored_Bunkbeds":{"__type":"bool","value":true},"ShipUnlockStored_Cupboard":{"__type":"bool","value":false},"ShipUnlockStored_File Cabinet":{"__type":"bool","value":true},"ShipUnlockStored_Goldfish":{"__type":"bool","value":false},"ShipUnlockStored_Inverse Teleporter":{"__type":"bool","value":false},"ShipUnlockStored_JackOLantern":{"__type":"bool","value":false},"ShipUnlockStored_Loud horn":{"__type":"bool","value":false},"ShipUnlockStored_Plushie pajama man":{"__type":"bool","value":false},"ShipUnlockStored_Record player":{"__type":"bool","value":false},"ShipUnlockStored_Romantic table":{"__type":"bool","value":false},"ShipUnlockStored_Shower":{"__type":"bool","value":false},"ShipUnlockStored_Signal translator":{"__type":"bool","value":false},"ShipUnlockStored_Table":{"__type":"bool","value":false},"ShipUnlockStored_Teleporter":{"__type":"bool","value":false},"ShipUnlockStored_Television":{"__type":"bool","value":false},"ShipUnlockStored_Toilet":{"__type":"bool","value":false},"ShipUnlockStored_Welcome mat":{"__type":"bool","value":false},"Stats_DaysSpent":{"__type":"int","value":13},"Stats_Deaths":{"__type":"int","value":8},"Stats_StepsTaken":{"__type":"int","value":130786},"Stats_ValueCollected":{"__type":"int","value":2665},"StoryLogs":{"__type":"System.Int32[],mscorlib","value":[0,6]},"UnlockedShipObjects":{"__type":"System.Int32[],mscorlib","value":[0,1,2,3,5,6,7,8,11,15,16,17,18,19,21,22]},"shipGrabbableItemIDs":{"__type":"System.Int32[],mscorlib","value":[10,9,15,10,9,10,12,12,9,14,14,9,14,5,5,14]},"shipGrabbableItemPos":{"__type":"UnityEngine.Vector3[],UnityEngine.CoreModule","value":[{"x":7.477545,"y":1.35853815,"z":-16.809391},{"x":6.685484,"y":1.859488,"z":-16.98854},{"x":7.663727,"y":0.719992161,"z":-16.9423981},{"x":8.042654,"y":1.25853825,"z":-16.8445415},{"x":6.95417,"y":1.7394886,"z":-17.1565762},{"x":6.6861515,"y":1.35853863,"z":-16.8820419},{"x":6.96377754,"y":3.1844945,"z":-16.8779182},{"x":8.260508,"y":3.184494,"z":-16.6893654},{"x":7.60728645,"y":1.73948908,"z":-17.151886},{"x":6.65681267,"y":2.422028,"z":-16.747673},{"x":7.72170258,"y":2.422029,"z":-16.7400265},{"x":8.044043,"y":1.7394886,"z":-17.03784},{"x":6.901497,"y":2.4224062,"z":-16.7459164},{"x":6.90683174,"y":0.5599923,"z":-16.7458782},{"x":7.26692,"y":0.629992,"z":-16.9238},{"x":7.30209541,"y":2.42246914,"z":-16.7430382}]}}

About

A Lethal Company (EasySave3) Data Editor. It should work with any game that utilizes EasySave, however the project is setup for Lethal Company.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages