Difference between revisions of "Install"

From MSX Game Library

Line 11: Line 11:
  
 
3️⃣ ''(Optional)'' If you want to use the emulator '''auto-launch''' option:
 
3️⃣ ''(Optional)'' If you want to use the emulator '''auto-launch''' option:
* Edit <tt>MSXgl\projects\default_config.js</tt> file ''(the default Build tool's configuration)'',
+
* Edit <tt>MSXgl\projects\default_config.js</tt> file ''(the default [[Build tool]]'s setting)'',
 
* Search for "<tt>Emulator</tt>" and set the path for your favorite emulator (can be [https://openmsx.org OpenMSX], [https://emulicious.net Emulicious], [http://bluemsx.msxblue.com BlueMSX], [https://www.msx.org/news/emulation/en/meisei-132 Meisei], [https://fms.komkon.org/fMSX fMSX] or [http://www.lexlechz.at/en/software/RuMSX.html Ru-MSX]) and add "<tt>DoRun = true</tt>".
 
* Search for "<tt>Emulator</tt>" and set the path for your favorite emulator (can be [https://openmsx.org OpenMSX], [https://emulicious.net Emulicious], [http://bluemsx.msxblue.com BlueMSX], [https://www.msx.org/news/emulation/en/meisei-132 Meisei], [https://fms.komkon.org/fMSX fMSX] or [http://www.lexlechz.at/en/software/RuMSX.html Ru-MSX]) and add "<tt>DoRun = true</tt>".
* ''<u>Note</u>: Many other options from <tt>default_config.js</tt> are overwriten by projet setting.''
+
* ''<u>Note</u>: Many other options from <tt>default_config.js</tt> are overwriten by project's setting.''
  
 
✅ '''You are done!''' You can start [[testing library samples]] or [[Create my first program|create your own brand new game]]!
 
✅ '''You are done!''' You can start [[testing library samples]] or [[Create my first program|create your own brand new game]]!

Revision as of 18:41, 22 December 2022

How to install MSXgl

Follow those steps:

1️⃣ Create a directory (name it "MSXgl" for example).

  • Note: For now (v0.6.5), please use a directory without any space in the full path.

2️⃣ Install the engine:

3️⃣ (Optional) If you want to use the emulator auto-launch option:

  • Edit MSXgl\projects\default_config.js file (the default Build tool's setting),
  • Search for "Emulator" and set the path for your favorite emulator (can be OpenMSX, Emulicious, BlueMSX, Meisei, fMSX or Ru-MSX) and add "DoRun = true".
  • Note: Many other options from default_config.js are overwriten by project's setting.

You are done! You can start testing library samples or create your own brand new game!

Linux

For Linux users, you need to manually install Node.js (19.3.0) and SDCC (4.2.0) before you can use MSXgl.