SCHG How-to

Set Up SonLVL

From Sonic Retro

Main Article
Beginner's Guide
Main Menu
Palette Editing
Object Editing
Layout Editing
Art Editing
Project Files

(Original guide by MainMemory)
(Additional Linux Setup By by 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 disassembly and SonLVL's updater.
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.
For this guide, I will be using the "Sonic 1 (Split and Text by Hivebrain) (ASM68K)" disassembly, AKA the Sonic 1 2005 disassembly.

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:

SonLVL setup 1.png

Click "Download Selected + Exit". A download progress window will open, then the program will exit when it finishes.
You should see several new things in the updater folder, including SonLVL.exe and a folder with INI files for your disassembly:

SonLVL setup 2.png

In another window, open the folder with your disassembly, which should contain at least one asm file and build.bat:

SonLVL setup 3.png

Go back to the updater folder window, right click on the INI file folder, and click "Copy" from the menu:

SonLVL setup 4.png

In the disassembly folder, right click on a file or empty space (not a folder) and click "Paste" in the menu:

SonLVL setup 5.png

A copy of the INI file folder will appear in the window:

SonLVL setup 6.png

In the updater folder, run SonLVL.exe. It should look like this:

SonLVL setup 7.png

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:

SonLVL setup 8.png

Now go to the "Change Level..." item under File, and a list of levels should appear:

SonLVL setup 9.png

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):

SonLVL setup 10.png

After some editing, go to File, and click Save:

SonLVL setup 11.png

If you have not yet, you should now click on the "Setup Emulator..." item in the File menu, and select your favorite emulator:

SonLVL setup 12.png

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):

SonLVL setup 13.png

Congratulations, you have used SonLVL to edit a Sonic game!

SonLVL setup 14.png

Linux Setup

Firstly, you will need Wine Mono and Wine itself

$sudo apt install wine
$sudo apt install mono-complete

MonoInstall.png now cd into the directory SonLVL updater is in and run

$mono "SonLVL Updater.exe"

it should look almost exactly the same as the Windows version, here is a shot of it getting updates


after that is done, just run

$mono SonLVL.exe

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. LinuxSonLVL.png