ZGB Installation Tutorial - Revision history

CloudZz: linux installation for ZGB so it won't get buried in the forums

2019-07-11T17:30:21Z

linux installation for ZGB so it won't get buried in the forums

Npzman: /* Installation */

2017-04-07T02:13:36Z

‎Installation

Npzman: /* Installation */

2017-04-07T02:12:27Z

‎Installation

Npzman: /* Installation */

2017-04-07T02:10:39Z

‎Installation

Npzman: /* Installation */

2017-04-07T02:09:49Z

‎Installation

Npzman: /* Installation */

2017-04-07T02:08:56Z

‎Installation

Npzman: /* Installation */

2017-04-05T14:32:15Z

‎Installation

Npzman: Created page with "==Introduction== ZGB is a gameboy engine devloped by Zal0 ==Installation== Download and install: gbdk ([2.95-3] at the moment of writing this) on c:\gbdk msys anywhere but a..."

2017-04-05T14:20:49Z

Created page with "==Introduction== ZGB is a gameboy engine devloped by Zal0 ==Installation== Download and install: gbdk ([2.95-3] at the moment of writing this) on c:\gbdk msys anywhere but a..."

New page

==Introduction==
ZGB is a gameboy engine devloped by Zal0

==Installation==

Download and install:
gbdk ([2.95-3] at the moment of writing this) on c:\gbdk
msys anywhere but add the folder msys/bin to your Path environment var
Make for Windows* on C:\gbdk\bin\make-3.81-bin
BGB on c:\gbdk\bin
mod2gbt on c:\gbdk\bin
Game Boy Map Builder on c:\gbdk\tools\gbmb18
Game Boy Tile Designer on c:\gbdk\tools\gbtd22
This repo, anywhere but create an env var called ZGB_PATH pointing the common folder eg: c:\ZGB\common
Microsoft Visual Studio Community Edition (optional)
*The make that comes with msys doesn't print any error messages and that's why you need to download make for windows too.

← Older revision		Revision as of 17:30, 11 July 2019
Line 25:		Line 25:

	The make that comes with msys doesn't print any error messages and that's why you need to download make for windows too.		The make that comes with msys doesn't print any error messages and that's why you need to download make for windows too.
		+
		+	== Installation on Linux ==
		+
		+	These instructions were written for an [https://github.com/Zal0/ZGB/commit/87cde03188e3784a9cdb885a09ff2be3e7113fa1 older version] of ZGB, but should work in similar fashion for the more recent versions.
		+
		+	GBDK is based on a now ancient version of SDCC and in newer SDCC versions bank support (needed for binaries > 32kB) appears to be broken. However, it is possible to combine GBDK's linker with a more recent version of SDCC to get a less buggy binary and retain banking support [http://zalods.blogspot.com/2017/07/bitbitjam-4-velcro-sheep.html 1].
		+
		+	1. Get SDCC version 3.6.0 or 3.5.0, preferably [https://sourceforge.net/projects/sdcc/files/sdcc-linux-x86/3.6.0/ 3.6.0], but check your distro's default version first.
		+	<blockquote>Newer versions 3.9.0 and 3.8.0 don't work with GBDK's linker out of the box.</blockquote>
		+
		+	2. download [https://sourceforge.net/projects/gbdk/files/gbdk/2.96/ gbdk-2.96a-i586-pc-linux2.2.tar.gz]
		+
		+	unpack to /opt/gbdk (or any other directory of your choice)
		+
		+	Set GBDK_HOME="/opt/gbdk"
		+
		+	For Arch users there is also an [https://aur.archlinux.org/packages/gbdk/ AUR package].
		+
		+	Zal0 recommends 2.95-3, but the Linux version of lcc seems to have a problem with Objectfile names that have more than 8 characters [http://gbdev.gg8.se/forums/viewtopic.php?id=597 2].
		+
		+	3. git clone ZGB & ZGB template
		+
		+	Set ZGB_PATH="/path/to/ZGB/common"
		+
		+	Modify SDCC and SDASGB in ''MakefileCommon'' to point to wherever you put the binaries for sdcc and sdasgb (from step 1).
		+
		+	(4. Change all #includes with \ to / (e.g in StateGame.c))
		+
		+	5. Then you can just use the makefiles to build the project:
		+	Open up a terminal in ZGB/common/src/ and type make.
		+
		+	Then go to ZGB-template/src and type make.
		+
		+	This will then build the ROM and put it in ZGB-template/bin/

@@ Line 20: / Line 20: @@
 *[http://www.devrs.com/gb/hmgd/gbtd.html Game Boy Tile Designer] on c:\gbdk\tools\gbtd22
-*The [https://github.com/Zal0/ZGB/archive/master.zip ZGB Official repository], anywhere but create an env var called ZGB_PATH pointing the common folder eg: c:\ZGB\common
+*The [https://github.com/Zal0/ZGB/archive/master.zip ZGB Official repository], anywhere but create an environment variable called ZGB_PATH pointing the common folder eg: c:\ZGB\common
 *[https://www.visualstudio.com/downloads/ Microsoft Visual Studio Community Edition]
 The make that comes with msys doesn't print any error messages and that's why you need to download make for windows too.

@@ Line 20: / Line 20: @@
 *[http://www.devrs.com/gb/hmgd/gbtd.html Game Boy Tile Designer] on c:\gbdk\tools\gbtd22
-*This repo, anywhere but create an env var called ZGB_PATH pointing the common folder eg: c:\ZGB\common
+*The [https://github.com/Zal0/ZGB/archive/master.zip ZGB Official repository], anywhere but create an env var called ZGB_PATH pointing the common folder eg: c:\ZGB\common
 *[https://www.visualstudio.com/downloads/ Microsoft Visual Studio Community Edition]
 The make that comes with msys doesn't print any error messages and that's why you need to download make for windows too.

← Older revision		Revision as of 02:10, 7 April 2017
Line 24:		Line 24:
	*[https://www.visualstudio.com/downloads/ Microsoft Visual Studio Community Edition]		*[https://www.visualstudio.com/downloads/ Microsoft Visual Studio Community Edition]

−	*The make that comes with msys doesn't print any error messages and that's why you need to download make for windows too.	+	The make that comes with msys doesn't print any error messages and that's why you need to download make for windows too.

@@ Line 6: / Line 6: @@
 Download and install:
-gbdk ([https://sourceforge.net/projects/gbdk/files/gbdk-win32/2.95-3/ 2.95-3] at the moment of writing this) on c:\gbdk
+*gbdk ([https://sourceforge.net/projects/gbdk/files/gbdk-win32/2.95-3/ 2.95-3] at the moment of writing this) on c:\gbdk
-[https://sourceforge.net/projects/mingw-w64/files/External%20binary%20packages%20%28Win64%20hosted%29/MSYS%20%2832-bit%29/MSYS-20111123.zip/download msys] anywhere but add the folder msys/bin to your Path environment var
+*[https://sourceforge.net/projects/mingw-w64/files/External%20binary%20packages%20%28Win64%20hosted%29/MSYS%20%2832-bit%29/MSYS-20111123.zip/download msys] anywhere but add the folder msys/bin to your Path environment var
-[http://gnuwin32.sourceforge.net/packages/make.htm Make for Windows]* on C:\gbdk\bin\make-3.81-bin
+*[http://gnuwin32.sourceforge.net/packages/make.htm Make for Windows]* on C:\gbdk\bin\make-3.81-bin
-[http://bgb.bircd.org/ BGB] on c:\gbdk\bin
+*[http://bgb.bircd.org/ BGB] on c:\gbdk\bin
-[https://github.com/AntonioND/gbt-player/raw/master/legacy_gbdk/mod2gbt/mod2gbt.exe mod2gbt] on c:\gbdk\bin
+*[https://github.com/AntonioND/gbt-player/raw/master/legacy_gbdk/mod2gbt/mod2gbt.exe mod2gbt] on c:\gbdk\bin
-[http://www.devrs.com/gb/hmgd/gbmb.html Game Boy Map Builder] on c:\gbdk\tools\gbmb18
+*[http://www.devrs.com/gb/hmgd/gbmb.html Game Boy Map Builder] on c:\gbdk\tools\gbmb18
-[http://www.devrs.com/gb/hmgd/gbtd.html Game Boy Tile Designer] on c:\gbdk\tools\gbtd22
+*[http://www.devrs.com/gb/hmgd/gbtd.html Game Boy Tile Designer] on c:\gbdk\tools\gbtd22
-This repo, anywhere but create an env var called ZGB_PATH pointing the common folder eg: c:\ZGB\common
+*This repo, anywhere but create an env var called ZGB_PATH pointing the common folder eg: c:\ZGB\common
-[https://www.visualstudio.com/downloads/ Microsoft Visual Studio Community Edition]
+*[https://www.visualstudio.com/downloads/ Microsoft Visual Studio Community Edition]
 *The make that comes with msys doesn't print any error messages and that's why you need to download make for windows too.

@@ Line 5: / Line 5: @@
 Download and install:
 gbdk ([2.95-3] at the moment of writing this) on c:\gbdk
 msys anywhere but add the folder msys/bin to your Path environment var
 Make for Windows* on C:\gbdk\bin\make-3.81-bin
 BGB on c:\gbdk\bin
 mod2gbt on c:\gbdk\bin
 Game Boy Map Builder on c:\gbdk\tools\gbmb18
 Game Boy Tile Designer on c:\gbdk\tools\gbtd22
 This repo, anywhere but create an env var called ZGB_PATH pointing the common folder eg: c:\ZGB\common
 Microsoft Visual Studio Community Edition (optional)
 *The make that comes with msys doesn't print any error messages and that's why you need to download make for windows too.