{"version":"https://jsonfeed.org/version/1.1","title":"Jaryl Chng's Knowledge Base","home_page_url":"https://kb.jarylchng.com","feed_url":"https://kb-jarylchng-com.pages.dev/json/","description":"

Welcome to the index page of my knowledge base, if you haven't done so, do visit my website at https://jarylchng.com.

I will mainly use this site to document stuff, most of which will likely be in the public domain.

","icon":"https://kb-static.jarylchng.com/kb-jarylchng-com/production/images/channel-c68f1f55f856ab833b4365991609dbec.png","favicon":"https://kb-static.jarylchng.com/kb-jarylchng-com/production/images/favicon-b94914f57599a477f9f72dab6bc71001.png","authors":[{"name":"Jaryl Chng"}],"language":"en-us","items":[{"id":"D0SMMNp96yY","title":"PowerShell - Lethal Company BepInEx one-click mods synchronizer powered by S3 buckets (Cloudflare R2) and RClone","attachments":[{"url":"https://kb-static.jarylchng.com/kb-jarylchng-com/production/media/video-24bdd7921c9c801e2c88abb528af32c9.mp4","mime_type":"video/mp4","size_in_byte":887187,"duration_in_seconds":12}],"url":"https://kb.jarylchng.com/i/powershell-lethal-company-bepinex-one-click-mods-D0SMMNp96yY/","content_html":"

A few months ago, I was very active in playing Lethal Company with my peers. With the introduction of the mods from the modding community, it enhanced gameplay tremendously and me and my friends had a lot of fun.

However, my friends are not very tech-savvy, and I did not want them to go through the trouble of installing r2modman, traversing the UI, typing the export UUID and getting my mods every single time I update. But I would like to continue to manage my mods using r2modman as it makes updating mods a breeze.

I had a few friends who, unfortunately, were working with data limits as well and could not keep downloading a zip file containing hundreds of megabytes worth of all my mods.

Most of my friends are on Windows as well, so I had to cater for that fact.

Solution

A PowerShell script that allows a one-click automatic mod update that also does delta downloads (only downloads changed files).

Said PowerShell script is powered by an S3 bucket, in my case Cloudflare R2, and RClone.

Prerequisites

  1. A Cloudflare account
  2. A payment method to enable the use of R2 (pay-per-usage)
  3. r2modman installed with a few Lethal Company mods already added

Instructions

Add the Cloudflare R2 subscription on your Cloudflare dashboard

Make sure to take note of the limits and keep it below that to stay on the free tier. Unless you have a lot of mods or a lot of friends, it's unlikely to hit the free-tier limits with just this.

Create an R2 bucket

After subscribing, you can now go ahead and create an R2 bucket, it is recommended to select a location hint to a region near yourself and your friends.

In this case, we are calling the bucket `lethalcompany`.

Generating a read-only and a read-write API tokens for the bucket

In our case, we would want 2 types of keys, a read-only one that will be sent to your friends and the other for you to upload mods.

You can manage your API tokens here on the right side of the R2 overview page as of the time of posting:

Note: Make sure to note down the Access ID here for later.

You would want to create a read-only token similar to the following:

Note: Make sure to note down the Access Key ID and Secret Access Key after creating and note down this is for read-only!

And a read-write token as follows:

Note: Make sure to note down the Access Key ID and Secret Access Key after creating and note down this is for read-write!

Find your Lethal Company r2modman profile folder

Open r2modman to Lethal Company and open the Settings section

From there you would want to click on `Browse profile folder` and it would open up your profile folder in Windows Explorer

Download RClone

You have a choice of downloading from 2 official places:

  1. Official website
  2. Github

In most cases, you should be downloading the Windows Intel/AMD - 64 Bit build.

After downloading, open up the zip archive and traverse into the folder until you see `rclone.exe`

Drag and drop `rclone.exe` onto the Lethal Company r2modman profile folder you've found above

Create RClone configuration for uploading

In your Lethal Company r2modman profile folder, beside the new `rclone.exe`, create a file named: `z_rclone.conf`

Copy and paste the following into `z_rclone.conf`:

[r2]\ntype = s3\nprovider = Cloudflare\naccess_key_id = PASTE_OVER_YOUR_READ_WRITE_ACCESS_KEY_HERE\nsecret_access_key = PASTE_OVER_YOUR_READ_WRITE_SECRET_ACCESS_KEY_HERE\nendpoint = https://PASTE_OVER_YOUR_R2_ID_HERE.r2.cloudflarestorage.com\n

Make sure to replace the PASTE_OVER values according to your read-write R2 token and Account ID.

Note: The `z_` prefix is important to set up ignore rules, but can be customized later on.

Create mods uploader script

In the same folder, create a file named: `z_upload.bat`

Copy and paste the following into `z_upload.bat`:

# 2>NUL & @CLS & PUSHD \"%~dp0\" & \"%SystemRoot%\\System32\\WindowsPowerShell\\v1.0\\powershell.exe\" -nol -nop -ep bypass \"[IO.File]::ReadAllText('%~f0')|iex\" & POPD & EXIT /B\n\nif (Test-Path -Path '.\\Lethal Company.exe') {\n    Write-Host \"Error: Lethal Company.exe detected! Do not run the uploader here!\"\n    cmd /c pause\n    Exit\n}\n\n$ErrorActionPreference = \"Inquire\"\n\nWrite-Host 'Uploading...'\n./rclone --config ./z_rclone.conf -v sync --checkers 12 --transfers 12 --update --checksum --use-server-modtime --fast-list --delete-excluded . r2:lethalcompany --exclude z_rclone.conf --exclude-from z_exclude.txt\n\nWrite-Host \"Mod upload complete!\"\ncmd /c pause\n
Note: The `z_` prefix is important to set up ignore rules, but can be customized later on.

Create files to exclude list

In the same folder, create a file named: `z_exclude.txt`

Copy and paste the following into `z_exclude.txt`:

z_*\nmods.yml\nLogOutput.log\n*.zip\n_state/**\nBepInEx/cache/**\nBepInEx/plugins/**/*.old\nBepInEx/plugins/**/icon.png\nBepInEx/plugins/**/manifest.json\nBepInEx/plugins/**/README\nBepInEx/plugins/**/CHANGELOG\nBepInEx/plugins/**/LICENSE\nBepInEx/plugins/**/INSTALLING\nBepInEx/plugins/**/*.md\nBepInEx/plugins/**/*.txt\n
Note: The `z_` prefix is important to set up ignore rules, but can be customized later on.

Run the upload script

Double-click on `z_upload.bat` and run it to upload your mods, if you have configured your `rclone.conf` file properly, it should get uploaded smoothly.

Note: Your output should be longer than this as you are uploading mods from scratch

Now that your mods are all uploaded, we can set up the mod downloader configuration and script to send to your friends

Create RClone configuration for downloading

In the same folder, create a file named: `rclone.conf`

Copy and paste the following into `rclone.conf`:

[r2]\ntype = s3\nprovider = Cloudflare\naccess_key_id = PASTE_OVER_YOUR_READ_ONLY_ACCESS_KEY_HERE\nsecret_access_key = PASTE_OVER_YOUR_READ_ONLY_SECRET_ACCESS_KEY_HERE\nendpoint = https://PASTE_OVER_YOUR_R2_ID_HERE.r2.cloudflarestorage.com\n

Make sure to replace the PASTE_OVER values according to your read-only R2 token and Account ID.

Create the mod downloader script

In the same folder, create a file named: `update_mods.bat`

Copy and paste the following into `update_mods.bat`:

# 2>NUL & @CLS & PUSHD \"%~dp0\" & \"%SystemRoot%\\System32\\WindowsPowerShell\\v1.0\\powershell.exe\" -nol -nop -ep bypass \"[IO.File]::ReadAllText('%~f0')|iex\" & POPD & EXIT /B\n\nif (-not(Test-Path -Path '.\\Lethal Company.exe')) {\n    Write-Host \"Error: Make sure this file is in the same folder as Lethal Company.exe before running!\"\n    cmd /c pause\n    Exit\n}\n\n$ErrorActionPreference = \"Inquire\"\n\nWrite-Host '(1/2) Syncing base files...'\n./rclone.exe --config ./rclone.conf -P --stats-one-line copy --checkers 12 --transfers 12 --checksum --use-server-modtime --fast-list r2:lethalcompany . --exclude BepInEx/\n\nWrite-Host '(2/2) Syncing mods...'\n./rclone.exe --config ./rclone.conf -P --stats-one-line sync --checkers 12 --transfers 12 --checksum --use-server-modtime --fast-list r2:lethalcompany/BepInEx/ ./BepInEx/\n\nWrite-Host \"Mod update complete!\"\ncmd /c pause\n

Test the mod downloader

Open Steam and click on Lethal Company

Click on the gear icon on the right side

Traverse to `Manage` and click on `Browse local files` to open up the Lethal Company game folder on Windows Explorer

Copy `rclone.conf`, `rclone.exe` and `update_mods.bat` from your Lethal Company r2modman profile folder here.

Double click update_mods.bat and run it.

If everything is configured well, the mods should download nicely.

Ship the mod downloader to your friends

Select `rclone.conf`, `rclone.exe` and `update_mods.bat`.

Important: do not select the files starting with `z_`! They are meant to be for you only.

Right click any of the selected files, traverse to `Send to` and click on `Compressed (zipped) folder`

Go ahead and rename the zip file if needed and send it to your friends.

Instruct them to find the Lethal Company folder with the same steps as Test the mod downloader, extract the 3 files there and double-click `update_mods.bat` and run it.

They should observe the same results as you.

After which, the game can be launched and your friends will have the exact same mods as you!

Afterword

Note that a few antiviruses will flag rclone.exe as a virus as a false positive, you may need to add it to your antivirus scan exclusion list or just not use this at all.

Although the setup is lengthy, after everything, the mod update flow is really just a matter of (as seen in the demo video)

  1. updating mods with r2modman
  2. z_upload.bat
  3. get your friends to run update_mods.bat

No need for traversing the r2modman UI at all and pasting UUIDs.

You may notice in my demo, my mod updater has a few more steps, I've excluded them as feel that they are out of scope for this post.

As we are already doing a lot of do-it-yourself, everything above is customizable, and you can add and remove features if you wish to do so, your imagination is the limit!

","content_text":"A few months ago, I was very active in playing Lethal Company with my peers.\nWith the introduction of the mods from the modding community, it enhanced\ngameplay tremendously and me and my friends had a lot of fun.\n\nHowever, my friends are not very tech-savvy, and I did not want them to go\nthrough the trouble of installing r2modman, traversing the UI, typing the export\nUUID and getting my mods every single time I update. But I would like to\ncontinue to manage my mods using r2modman as it makes updating mods a breeze.\n\nI had a few friends who, unfortunately, were working with data limits as well\nand could not keep downloading a zip file containing hundreds of megabytes worth\nof all my mods.\n\nMost of my friends are on Windows as well, so I had to cater for that fact.\n\n\nSOLUTION\n\nA PowerShell script that allows a one-click automatic mod update that also does\ndelta downloads (only downloads changed files).\n\nSaid PowerShell script is powered by an S3 bucket, in my case Cloudflare R2, and\nRClone.\n\n\nPREREQUISITES\n\n 1. A Cloudflare account\n 2. A payment method to enable the use of R2 (pay-per-usage)\n 3. r2modman installed with a few Lethal Company mods already added\n\n\nINSTRUCTIONS\n\n\nADD THE CLOUDFLARE R2 SUBSCRIPTION ON YOUR CLOUDFLARE DASHBOARD\n\n[https://kb-static.jarylchng.com/kb-jarylchng-com/production/media/rich-editor/items/D0SMMNp96yY/image-4da53a80abf3b1ab1da81c77e384798b.png]\n\nMake sure to take note of the limits and keep it below that to stay on the free\ntier. Unless you have a lot of mods or a lot of friends, it's unlikely to hit\nthe free-tier limits with just this.\n\n\nCREATE AN R2 BUCKET\n\nAfter subscribing, you can now go ahead and create an R2 bucket, it is\nrecommended to select a location hint to a region near yourself and your\nfriends.\n\nIn this case, we are calling the bucket `lethalcompany`.\n\n[https://kb-static.jarylchng.com/kb-jarylchng-com/production/media/rich-editor/items/D0SMMNp96yY/image-608d29889776dddc5e5314182c03230e.png]\n\n\nGENERATING A READ-ONLY AND A READ-WRITE API TOKENS FOR THE BUCKET\n\nIn our case, we would want 2 types of keys, a read-only one that will be sent to\nyour friends and the other for you to upload mods.\n\nYou can manage your API tokens here on the right side of the R2 overview page as\nof the time of posting:\n\n[https://kb-static.jarylchng.com/kb-jarylchng-com/production/media/rich-editor/items/D0SMMNp96yY/image-2d182f34d7d47480bcec57da977ebe32.png]\n\n> Note: Make sure to note down the Access ID here for later.\n\nYou would want to create a read-only token similar to the following:\n\n[https://kb-static.jarylchng.com/kb-jarylchng-com/production/media/rich-editor/items/D0SMMNp96yY/image-6d350fed7c5957da5c920f8cca89d2f1.png]\n\n> Note: Make sure to note down the Access Key ID and Secret Access Key after\n> creating and note down this is for read-only!\n\nAnd a read-write token as follows:\n\n[https://kb-static.jarylchng.com/kb-jarylchng-com/production/media/rich-editor/items/D0SMMNp96yY/image-5e34e92861891186df5e7f9b7a5c2b5f.png]\n\n> Note: Make sure to note down the Access Key ID and Secret Access Key after\n> creating and note down this is for read-write!\n\n\nFIND YOUR LETHAL COMPANY R2MODMAN PROFILE FOLDER\n\nOpen r2modman to Lethal Company and open the Settings section\n\n[https://kb-static.jarylchng.com/kb-jarylchng-com/production/media/rich-editor/items/D0SMMNp96yY/image-174f2a65940e116bd97dba3c0e3c1a86.png]\n\nFrom there you would want to click on `Browse profile folder` and it would open\nup your profile folder in Windows Explorer\n\n\nDOWNLOAD RCLONE\n\nYou have a choice of downloading from 2 official places:\n\n 1. Official website\n 2. Github\n\nIn most cases, you should be downloading the Windows Intel/AMD - 64 Bit build.\n\nAfter downloading, open up the zip archive and traverse into the folder until\nyou see `rclone.exe`\n\nDrag and drop `rclone.exe` onto the Lethal Company r2modman profile folder\nyou've found above\n\n\nCREATE RCLONE CONFIGURATION FOR UPLOADING\n\nIn your Lethal Company r2modman profile folder, beside the new `rclone.exe`,\ncreate a file named: `z_rclone.conf`\n\nCopy and paste the following into `z_rclone.conf`:\n\n[r2]\ntype = s3\nprovider = Cloudflare\naccess_key_id = PASTE_OVER_YOUR_READ_WRITE_ACCESS_KEY_HERE\nsecret_access_key = PASTE_OVER_YOUR_READ_WRITE_SECRET_ACCESS_KEY_HERE\nendpoint = https://PASTE_OVER_YOUR_R2_ID_HERE.r2.cloudflarestorage.com\n\n\nMake sure to replace the PASTE_OVER values according to your read-write R2 token\nand Account ID.\n\n> Note: The `z_` prefix is important to set up ignore rules, but can be\n> customized later on.\n\n\nCREATE MODS UPLOADER SCRIPT\n\nIn the same folder, create a file named: `z_upload.bat`\n\nCopy and paste the following into `z_upload.bat`:\n\n# 2>NUL & @CLS & PUSHD \"%~dp0\" & \"%SystemRoot%\\System32\\WindowsPowerShell\\v1.0\\powershell.exe\" -nol -nop -ep bypass \"[IO.File]::ReadAllText('%~f0')|iex\" & POPD & EXIT /B\n\nif (Test-Path -Path '.\\Lethal Company.exe') {\n    Write-Host \"Error: Lethal Company.exe detected! Do not run the uploader here!\"\n    cmd /c pause\n    Exit\n}\n\n$ErrorActionPreference = \"Inquire\"\n\nWrite-Host 'Uploading...'\n./rclone --config ./z_rclone.conf -v sync --checkers 12 --transfers 12 --update --checksum --use-server-modtime --fast-list --delete-excluded . r2:lethalcompany --exclude z_rclone.conf --exclude-from z_exclude.txt\n\nWrite-Host \"Mod upload complete!\"\ncmd /c pause\n\n\n> Note: The `z_` prefix is important to set up ignore rules, but can be\n> customized later on.\n\n\nCREATE FILES TO EXCLUDE LIST\n\nIn the same folder, create a file named: `z_exclude.txt`\n\nCopy and paste the following into `z_exclude.txt`:\n\nz_*\nmods.yml\nLogOutput.log\n*.zip\n_state/**\nBepInEx/cache/**\nBepInEx/plugins/**/*.old\nBepInEx/plugins/**/icon.png\nBepInEx/plugins/**/manifest.json\nBepInEx/plugins/**/README\nBepInEx/plugins/**/CHANGELOG\nBepInEx/plugins/**/LICENSE\nBepInEx/plugins/**/INSTALLING\nBepInEx/plugins/**/*.md\nBepInEx/plugins/**/*.txt\n\n\n> Note: The `z_` prefix is important to set up ignore rules, but can be\n> customized later on.\n\n\nRUN THE UPLOAD SCRIPT\n\nDouble-click on `z_upload.bat` and run it to upload your mods, if you have\nconfigured your `rclone.conf` file properly, it should get uploaded smoothly.\n\n[https://kb-static.jarylchng.com/kb-jarylchng-com/production/media/rich-editor/items/D0SMMNp96yY/image-3a4eb03abdcada6207b8d969551fa4fa.png]\n\n> Note: Your output should be longer than this as you are uploading mods from\n> scratch\n\nNow that your mods are all uploaded, we can set up the mod downloader\nconfiguration and script to send to your friends\n\n\nCREATE RCLONE CONFIGURATION FOR DOWNLOADING\n\nIn the same folder, create a file named: `rclone.conf`\n\nCopy and paste the following into `rclone.conf`:\n\n[r2]\ntype = s3\nprovider = Cloudflare\naccess_key_id = PASTE_OVER_YOUR_READ_ONLY_ACCESS_KEY_HERE\nsecret_access_key = PASTE_OVER_YOUR_READ_ONLY_SECRET_ACCESS_KEY_HERE\nendpoint = https://PASTE_OVER_YOUR_R2_ID_HERE.r2.cloudflarestorage.com\n\n\nMake sure to replace the PASTE_OVER values according to your read-only R2 token\nand Account ID.\n\n\nCREATE THE MOD DOWNLOADER SCRIPT\n\nIn the same folder, create a file named: `update_mods.bat`\n\nCopy and paste the following into `update_mods.bat`:\n\n# 2>NUL & @CLS & PUSHD \"%~dp0\" & \"%SystemRoot%\\System32\\WindowsPowerShell\\v1.0\\powershell.exe\" -nol -nop -ep bypass \"[IO.File]::ReadAllText('%~f0')|iex\" & POPD & EXIT /B\n\nif (-not(Test-Path -Path '.\\Lethal Company.exe')) {\n    Write-Host \"Error: Make sure this file is in the same folder as Lethal Company.exe before running!\"\n    cmd /c pause\n    Exit\n}\n\n$ErrorActionPreference = \"Inquire\"\n\nWrite-Host '(1/2) Syncing base files...'\n./rclone.exe --config ./rclone.conf -P --stats-one-line copy --checkers 12 --transfers 12 --checksum --use-server-modtime --fast-list r2:lethalcompany . --exclude BepInEx/\n\nWrite-Host '(2/2) Syncing mods...'\n./rclone.exe --config ./rclone.conf -P --stats-one-line sync --checkers 12 --transfers 12 --checksum --use-server-modtime --fast-list r2:lethalcompany/BepInEx/ ./BepInEx/\n\nWrite-Host \"Mod update complete!\"\ncmd /c pause\n\n\n\nTEST THE MOD DOWNLOADER\n\nOpen Steam and click on Lethal Company\n\nClick on the gear icon on the right side\n\nTraverse to `Manage` and click on `Browse local files` to open up the Lethal\nCompany game folder on Windows Explorer\n\n[https://kb-static.jarylchng.com/kb-jarylchng-com/production/media/rich-editor/items/D0SMMNp96yY/image-e10b737a15c4294419f4e41bea5b0fdc.png]\n\nCopy `rclone.conf`, `rclone.exe` and `update_mods.bat` from your Lethal Company\nr2modman profile folder here.\n\nDouble click update_mods.bat and run it.\n\n[https://kb-static.jarylchng.com/kb-jarylchng-com/production/media/rich-editor/items/D0SMMNp96yY/image-5510f829629ebb284d63b7486e50fc7c.png]\n\nIf everything is configured well, the mods should download nicely.\n\n\nSHIP THE MOD DOWNLOADER TO YOUR FRIENDS\n\nSelect `rclone.conf`, `rclone.exe` and `update_mods.bat`.\n\n> Important: do not select the files starting with `z_`! They are meant to be\n> for you only.\n\nRight click any of the selected files, traverse to `Send to` and click on\n`Compressed (zipped) folder`\n\n[https://kb-static.jarylchng.com/kb-jarylchng-com/production/media/rich-editor/items/D0SMMNp96yY/image-a61c4c90fa92d5170ab67a27510ae3e0.png]\n\nGo ahead and rename the zip file if needed and send it to your friends.\n\nInstruct them to find the Lethal Company folder with the same steps as Test the\nmod downloader, extract the 3 files there and double-click `update_mods.bat` and\nrun it.\n\nThey should observe the same results as you.\n\nAfter which, the game can be launched and your friends will have the exact same\nmods as you!\n\n\nAFTERWORD\n\nNote that a few antiviruses will flag rclone.exe as a virus as a false positive,\nyou may need to add it to your antivirus scan exclusion list or just not use\nthis at all.\n\nAlthough the setup is lengthy, after everything, the mod update flow is really\njust a matter of (as seen in the demo video)\n\n 1. updating mods with r2modman\n 2. z_upload.bat\n 3. get your friends to run update_mods.bat\n\nNo need for traversing the r2modman UI at all and pasting UUIDs.\n\nYou may notice in my demo, my mod updater has a few more steps, I've excluded\nthem as feel that they are out of scope for this post.\n\nAs we are already doing a lot of do-it-yourself, everything above is\ncustomizable, and you can add and remove features if you wish to do so, your\nimagination is the limit!","date_published":"2024-04-14T07:55:00.000Z","_microfeed":{"is_audio":false,"is_document":false,"is_external_url":false,"is_video":true,"is_image":false,"web_url":"https://kb-jarylchng-com.pages.dev/i/powershell-lethal-company-bepinex-one-click-mods-D0SMMNp96yY/","json_url":"https://kb-jarylchng-com.pages.dev/i/D0SMMNp96yY/json/","rss_url":"https://kb-jarylchng-com.pages.dev/i/D0SMMNp96yY/rss/","guid":"D0SMMNp96yY","status":"published","duration_hhmmss":"00:00:12","itunes:episodeType":"full","date_published_short":"Sun Apr 14 2024","date_published_ms":1713081300000}}],"_microfeed":{"microfeed_version":"0.1.2","base_url":"https://kb-jarylchng-com.pages.dev","categories":[{"name":"Technology"}],"subscribe_methods":[{"name":"RSS","type":"rss","url":"https://kb-jarylchng-com.pages.dev/rss/","image":"https://kb-jarylchng-com.pages.dev/assets/brands/subscribe/rss.png","enabled":true,"editable":false,"id":"sQbXXExV58H"},{"name":"JSON","type":"json","url":"https://kb-jarylchng-com.pages.dev/json/","image":"https://kb-jarylchng-com.pages.dev/assets/brands/subscribe/json.png","enabled":true,"editable":false,"id":"nC8cjLCnOOi"}],"description_text":"Welcome to the index page of my knowledge base, if you haven't done so, do visit\nmy website at https://jarylchng.com.\n\nI will mainly use this site to document stuff, most of which will likely be in\nthe public domain.","copyright":"©2024","itunes:type":"episodic","items_sort_order":"newest_first"}}