Editing Modding (section)

==BepInEx Installation==
''Since the installation of BepInEx is completely different between Windows and MacOS, this part of the guide will be split into two parts, one for Windows, and one for MacOS. This section takes info from keymaster's [https://gamebanana.com/tuts/16262 guide].''

'''WINDOWS GUIDE (For linux/mac: [https://bepinex.github.io/bepinex_docs/master/articles/user_guide/installation/index.html?tabs=tabid-nix here])'''
==== '''<big>Windows</big>'''====
''<small>Note: Make sure hidden files are shown, you can google how to do this if they're not shown.</small>''<br />
1. First download [https://github.com/BepInEx/BepInEx/releases/download/v5.4.21/BepInEx_x64_5.4.21.0.zip BepInEx_x64_5.4.21.0.zip] from the BepInEx GitHub repository. The _x86 or _unix versions of it won't work on Windows.<br />
2. Open your worldbox folder. You can do this by opening Steam -> Library -> Worldbox -> Gear Icon (far right) -> Manage -> Browse Local Files.<br />
3. Drag '''the contents of''' the BepInEx_x64_5.4.21.0.zip into your worldbox file<br />
4. Your worldbox folder should contain a folder called BepInEx, a file called winhttp.dll, a file called doorstop_config.ini, a file called changelog.txt, and one called worldbox.exe. Some of the file extensions might not show up for you if you never disabled the "Hide hidden extensions" option in your file explorer. If the folders/files are there, right-click worldbox.exe and select "Run as administrator" to allow it to finish its installation!<br />5. After granting the permissions and letting the game run, a new folder should appear in your BepInEx folder called "plugins". Said folder is where you put BepInEx mods.<br />
<u>You're Done!</u>
[[File:BepInExInstructions.png|thumb|392x392px|An Image to help]]

==='''MacOS'''===
1. First, download [https://github.com/BepInEx/BepInEx/releases/download/v5.4.21/BepInEx_unix_5.4.21.0.zip BepInEx_unix_5.4.21.0.zip] from the BepInEx GitHub repository. The _x86 or _x64 version of it don't work on MacOS.<br />
2. Open your worldbox folder. You can do this by opening Steam -> Library -> Worldbox -> Gear Icon (far right) -> Manage -> Browse Local Files.<br />
3. Drag '''the contents of''' the BepInEx_unix_5.4.21.0.zip into your worldbox file<br />
4. Your worldbox folder should contain a folder called BepInEx, a folder called doorstop_libs, a file called run_bepinex.sh, a file called changelog.txt, and one called worldbox which has the icon of WorldBox. <br />5. The next step is to open run_bepinex.sh with a text/code editor of your choice and to search for 'executable_name=" '.<br />6. There should only be one result in the file. Go to said search result, and have the line say 'executable_name="worldbox.app" ' 7. Once you did that, save the file and completely close it. After you're done with these steps, you're ready to run worldbox with BepInEx on MacOS. But to do this, you can't just open the game like you'd usually do, you instead have to go into a terminal and use sh to run the run_bepinex.sh file.<br />
<u>You're Done... almost (read below to do what is mentioned in step 7)</u>

1. Right-click worldbox.app in your worldbox folder, right-click it, and select "Get Info". In the menu that appears, right-click the path next to the "where" attribute and select "Copy as Pathname".<br />2. Once you have the path copied, go into a terminal of your choice (the default terminal that MacOS provides in called 'terminal', you can search it using spotlight search).<br />3. Once you're in the terminal, type 'cd ""', use your arrow keys to go between the two " characters, and paste in the path that you copied earlier with cmd+v (⌘+v).<br />4. If it does, press the return key (⮐) (the one that is used to make a new line when writing text in applications like word/sending messages in discord).<br />5. After doing so, try to type 'ls' (written with a lower case L, NOT an upper case i), and run said command with the return key (⮐). The text that the terminal displays in response to the command should list worldbox.app and the files from BepInEx which you put into the worldbox folder earlier. The Mods folder will only be there if you also have NCMS/NML installed.<br />6. If you did do everything correctly and see the correct files/folders, type 'sudo sh ./run_bepinex.sh', and press the return key (⮐). You'll be asked for the password of the user that you're currently logged into by MacOS, because the sudo command requires administrator permissions. Just type it in (you can't see it at all while typing it in), and press the return key (⮐) again. If you did everything correctly, your terminal will start displaying a lot of text that seemingly doesn't make any sense, and after a few seconds, worldbox will open itself. There's a very low chance that you might get an error message. Don't worry if this happens, it kinda just does sometimes, and you can try to run the command again. Once you ran the command successfully, your BepInEx folder should get a new folder inside it called "plugins". Said folder is where you put BepInEx mods.<br /><u>You're Really Done!</u>

==='''Videos''' (might be outdated)===
You only need to watch one of the videos as each teach you full installation in their video. 

https://youtu.be/KfEOEFTfboQ - Andreiavich, Mod Installation & Simple GUI guide

https://youtu.be/kep3Tp-5a_U - DogsAreBetterThanCats, Mod Installation