Difference between revisions of "Install"

From MSX Game Library

(28 intermediate revisions by the same user not shown)
Line 1: Line 1:
''<u>Note</u>: For the moment, the [[Build Tool]] is only compatible with Windows 64-bits OS.''
+
== How to install MSXgl ==
  
 
Follow those steps:
 
Follow those steps:
  
1️⃣ '''Create''' a directory (name it "<tt>MSXgl</tt>" e.g.).
+
1️⃣ '''Create''' a directory (name it "<tt>MSXgl</tt>" for example).
* ''<u>Note</u>: For now (v0.3.5), please use a directory without any space in the full path.
+
* ''<u>Note</u>: It is recommanded to use a directory without any space in the full path.
  
 
2️⃣ Install the '''engine''':
 
2️⃣ Install the '''engine''':
* Clone the Git repository https://github.com/aoineko-fr/MSXgl.git (<tt>v0.3.0-alpha</tt> tag),
+
* Clone the Git repository https://github.com/aoineko-fr/MSXgl.git (<tt>v1.0.0</tt> tag),
* or Download and unzip the [https://github.com/aoineko-fr/MSXgl/releases/download/v0.3.0-alpha/MSXgl-v0.3.0-alpha.zip latest version of the engine].
+
* or Download and unzip the [https://github.com/aoineko-fr/MSXgl/releases latest version of the engine].
 +
 
 +
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)'',
 +
* Search for "<tt>Emulator</tt>", set the path for your favorite [[Emulators|emulator]] (can be [https://openmsx.org openMSX], [https://emulicious.net Emulicious], [http://bluemsx.msxblue.com BlueMSX], [https://fms.komkon.org/fMSX fMSX], [https://www.msx.org/news/emulation/en/meisei-132 Meisei] or [http://www.lexlechz.at/en/software/RuMSX.html Ru-MSX]) and set "<tt>DoRun = true</tt>".
 +
* ''<u>Note</u>: Many other options from <tt>default_config.js</tt> are overwriten by the project's configuration.''
  
3️⃣ If you want to use the emulator '''auto-launch''' option:
 
* Edit <tt>MSXgl\projects\default_config.cmd</tt> file,
 
* Search for "<tt>set 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]).
 
* ''<u>Note</u>: Many other options from <tt>default_config.cmd</tt> are overwriten by samples' build script.''
 
 
✅ '''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]]!
 +
 +
=== macOS ===
 +
 +
For '''Windows''' and '''Linux''', all the needed tools are imbedded into MSXgl package, but '''macOS''' users need to manually install [https://nodejs.org/ Node.js] (18.12.1 or newer) and [https://sdcc.sourceforge.net/ SDCC] (4.2.0) before they can run the MSXgl's [[Build tool]]. See this [[Install/macOS|installation guide]].
 +
 +
The path of all the programs used in the [[Build tool]] can be changed in the <tt>default_config.js</tt> file.
 +
 +
== Annexe ==
 +
 +
See also:
 +
* [[Alternative file layout]] (to have the MSXgl directory inside your project directory)

Revision as of 00:59, 24 February 2024

How to install MSXgl

Follow those steps:

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

  • Note: It is recommanded to 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 configuration),
  • Search for "Emulator", set the path for your favorite emulator (can be openMSX, Emulicious, BlueMSX, fMSX, Meisei or Ru-MSX) and set "DoRun = true".
  • Note: Many other options from default_config.js are overwriten by the project's configuration.

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

macOS

For Windows and Linux, all the needed tools are imbedded into MSXgl package, but macOS users need to manually install Node.js (18.12.1 or newer) and SDCC (4.2.0) before they can run the MSXgl's Build tool. See this installation guide.

The path of all the programs used in the Build tool can be changed in the default_config.js file.

Annexe

See also: