View source for Set Up SonLVL

__NOTOC__
{{SonLVL Manual TOC}}
{{GuideBy|MainMemory}}<br />
(Additional Linux Setup By by [[User:RobiWanKenobi|RobiWanKenobi]])

Ever since I set up the (now defunct) Bug reporting system for [[SonLVL]], most of the "bugs" have been a simple case of people not understanding how SonLVL is supposed to be set up. So, this guide is here to show you exactly how to set up SonLVL.
==The Guide==
To start with, you will need two things: a [[Disassemblies|disassembly]] and SonLVL's [http://mm.reimuhakurei.net/SonLVL%20Updater.zip updater].<br />
Download a disassembly for the game you want to edit, and the updater, extract both to separate folders where you can easily find them. If you are not using one of the Git disassemblies, you should copy an unedited copy of the game into the disassembly and run split.bat.<br />
For this guide, I will be using the "Sonic 1 (Split and Text by Hivebrain) (ASM68K)" disassembly, AKA the Sonic 1 2005 disassembly.<br />
<br />
Go to the folder that you extracted the SonLVL updater to, and run SonLVL Updater.exe. You will be presented with a list of components that can be downloaded. You may select all of them, or only SonLVL and the INI files for your disassembly:
[[Image:SonLVL setup 1.png|center]]
Click "Download Selected + Exit". A download progress window will open, then the program will exit when it finishes.<br />
You should see several new things in the updater folder, including SonLVL.exe and a folder with INI files for your disassembly:
[[Image:SonLVL setup 2.png|center]]
In another window, open the folder with your disassembly, which should contain at least one asm file and build.bat:
[[Image:SonLVL setup 3.png|center]]
Go back to the updater folder window, right click on the INI file folder, and click "Copy" from the menu:
[[Image:SonLVL setup 4.png|center]]
In the disassembly folder, right click on a file or empty space (not a folder) and click "Paste" in the menu:
[[Image:SonLVL setup 5.png|center]]
A copy of the INI file folder will appear in the window:
[[Image:SonLVL setup 6.png|center]]
In the updater folder, run SonLVL.exe. It should look like this:
[[Image:SonLVL setup 7.png|center]]
Click on the File menu, then "Open...". Navigate to the disassembly folder, then the INI folder you pasted into it, and select an INI file that does not start with obj:
[[Image:SonLVL setup 8.png|center]]
Now go to the "Change Level..." item under File, and a list of levels should appear:
[[Image:SonLVL setup 9.png|center]]
After you select one, it will begin loading, then you will be able to move the camera around the level and edit it (see readme.txt for details):
[[Image:SonLVL setup 10.png|center]]
After some editing, go to File, and click Save:
[[Image:SonLVL setup 11.png|center]]
If you have not yet, you should now click on the "Setup Emulator..." item in the File menu, and select [[sega:Gens/GS|your favorite emulator]]:
[[Image:SonLVL setup 12.png|center]]
Then, you can use the "Build and Run..." option in the File menu (if it is grayed out, you will have to run build.bat and start the built ROM manually):
[[Image:SonLVL setup 13.png|center]]
Congratulations, you have used SonLVL to edit a Sonic game!
[[Image:SonLVL setup 14.png|center]]
[[Category:SCHG How-tos|Set Up SonLVL]]
==Linux Setup==
Firstly, you will need Wine Mono and Wine itself
<syntaxhighlight>
$sudo apt install wine
$sudo apt install mono-complete
</syntaxhighlight>
[[Image:MonoInstall.png]]
now cd into the directory SonLVL updater is in and run
<syntaxhighlight>
$mono "SonLVL Updater.exe"
</syntaxhighlight>
it should look almost exactly the same as the Windows version, here is a shot of it getting updates

[[Image:SonLVLUpdater.png]]

after that is done, just run
<syntaxhighlight>
$mono SonLVL.exe
</syntaxhighlight>
You should be able to use SonLVL as normal, minus the fact that you cannot set up an emulator to use, you will have to manually build and run it since it relies on .exe(Windows Format) emulator files to work and Linux doesn't use that.
[[Image:LinuxSonLVL.png]]