You can find Genesis Code in the Microsoft Marketplace for Extensions; when you find the extension click on install via web or via visual studio code.
To use Genesis code, you need to configure two important things.
First, you need to install and configure your Genesis Development Kit; it can be SGDK or GENDEV projects.
Its important to set the enviroment variable of GDK for SGDK projects, or GENDEV enviroment variable for GENDEV based project.
After configure the SGDK or GENDEV enviroment, we need to configure the Gens path command.
Configure all settings for the extension
First of all you need to go a section to configure your Genesis Code extension. This is located in Visual Studio Code following menu : File -> Prefernces -> Settings [Ctrl+,]. Go to Extensions -> Genesis Code, now you can start configuring as your preferences.
Configuration with build using Docker (since v1.4.x)
Genesis Code is compatible build using docker. Previously you should be created a docker image, Genesis Code asume your are followed stepd in the SGDK repo.
If you want to build using docker, you should be select a toolchain Docker in the Genesis Code settings.
If you want to use docker adding a tag, you can set in the Docker Tag section.
Configuration with MarsDev (since v1.2.0)
Genesis Code is compatible with MarsDev toolchain. Only you need to do is install MarsDev and select the toolchain in the Genesis Code settings.
For more information with MarsDev toolchain, please go to MarsDev Github Repo.
Configuration in MaCOs (since v1.1.0)(Deprecated)
To use SGDK and Genesis code in MacOs, you need to install and configure Wine for use with SGDK. Follow the next instructions for install and configure SGDK with Wine in MacOs.
1 . Install brew on your system.
2 . Create and configure the installation directory:
sudo mkdir /opt/gendev/ sudo chown $USER: /opt/gendev
3 . Set the next environment Variables.
export GENDEV=/opt/gendev export GDK='c:/sgdk' export GDK_WIN='c:\sgdk'
NOTE: Remember to put this variables into your bash_profile to make them permanent.
4 . Install the packages needed with brew.
brew cask install xquartz brew install wine
5 . Configure wine
mkdir $GENDEV/wine WINDEBUG=-all WINEARCH=win64 WINEPREFIX=$GENDEV/wine wineboot
6 . clone SGDK project using git.
cd $GENDEV git clone https://github.com/Stephane-D/SGDK.git ln -sv $GENDEV/SGDK $GENDEV/wine/drive_c sgdk
7 . For use Java with SGDK for the resource management you need to install Java in the wine system. First, you need to dowload the JDK (using oracle or openjdk); its important to download the x86 version (32 bits). Once downloaded we need to install it in wine.
cd <your folder where the jdk installer is downloaded> WINEPREFIX=$GENDEV/wine wine64 cmd
z:\> jdk-8u221-windows-i586.exe /s
8 . Once java is instaled in wine, we need to configure the wine environment variables to add java to the Path variable.
WINEPREFIX=$GENDEV/wine wine regedit
This will open the register editor in wine; now we need to go the the next register path:
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Session Manager\Environment; and change the PATH variable adding the current windows java path.
9 . For last, we need to compile and build all the tools in SGDK.
WINEPREFIX=$GENDEV/wine wine64 cmd %GDK_WIN%\bin\make -f %GDK_WIN%\makelin.gen
NOTE: thanks to the https://github.com/v4ld3r5/sgdk_vscode_template.git project for this configuration.
NOTE2: You can see some errors due to MacOs 32bits limitations; check the MacOs Documentation for more information.
WARNING: THis is a deprecated configuration and will be changed in the future.
If you get an error using genesis code commands like:
Cannot load'%GDK%' module. for more information, please run 'Import-Module %GDK%'.
This is becasuse you are using PowerShell instead CMD Prompt; you can fix this in two ways:
cmdcommand on gens-code terminal.
- Change default terminal, using the command
>Terminal: Select default Profileand select Command Prompt (cmd).
Gens Path Command Configuration
To use an Emulator like Gens you need to configure your gens path Command Configuration.
This configuration store you gens command to call the emulator and open the attached rom binary. In this case you can set it by tow ways.
The first way is using the Genesis Code Configuration. You can see the settings section in your visual studio instalation using the menu File->preferences->settings (or with the ctrl+, shortcut).
The second way is using the Set run path Command; this command allows you to put the Gens Emulator command in one Input Box. For more information, please see commands section.
NOTE: You can use other emulators like Blastem.