zal0 / zgb Goto Github PK

When compiling a game in Color mode and executing on B/W hardware the HUD Window doesn't appear correctly, e.g. not displaying any text printed by Printf.
When compiling in classic mode or when compiling in Color and running in GBC appears Ok.

I followed the tutorial for creating enemies. when I define the enemy sprite I get this error.

?ASlink-Warning-Undefined Global '_Start_SpriteEnemy' referenced by module 'ZGBMain_Init'

?ASlink-Warning-Undefined Global '___bank_SpriteEnemy' referenced by module 'ZGBMain_Init'

?ASlink-Warning-Undefined Global '_Update_SpriteEnemy' referenced by module 'ZGBMain_Init'

make: *** [../bin/ZGB_TEMPLATE.gb] Error 2

I downloaded the latest ZGB-template-master and opened the solution in Visual Studio 2022 Community Edition. Immediately, I am seeing errors in the Error List such as:

E0070 incomplete type is not allowed

E0260 explicit type is missing ('int' assumed)

E0065 expected a ';'

I did install the latest release of ZGB and ran install.bat.

Hey,

I have a PAL Snes as well as PAL Super Gameboy and SGB Borders don't load with ZGB on it. I had initially noticed it in my GBDK-2020 game and toxa mentioned there is a timing issue on PAL Systems, added a delay of 4 frames fixed it on my GBDK-2020 game. He also suggested to test ZGB, so i took the latest version (by first grabbing the release and then overwriting with latest github version sources so i also had the environment) and i took the ZGB Template and added a border as per the documentation, but on my PAL SNES / SGB the border did not load. It did work in BGB and it also worked when using the the easy flash junior, but it did not work if i used GBX-RW to flash an empty cartridge. I'm guessing easy flash junior and perhaps everdrive do some other things that don't require the delay or so.

GB Studio used a similar delay https://github.com/chrismaltby/gbvm/blob/master/src/core/core.c#L192-L196 (its what toxa was refering to as well) and we've seen other games incorporating such delays ... (https://sourcegraph.com/github.com/SimonLarsen/tobutobugirl-dx/-/blob/init.c?L125 and https://sourcegraph.com/github.com/SimonLarsen/tobutobugirl-dx/-/blob/main.c?L34:3)

Initially i had put the same delay in the LOAD_SGB_BORDER Function but this still did not work, if i moved that delay to right at the beginning of main it started working also on my PAL SNES / SGB.

So basically (if wait_vbl_done) does not interfere we can either delay 4 frames or at a fixed delay as other examples did. we are guessing interrupts could interfere and the delay has to be set before them or the SGB Border does not load but it's only guessing as i did not really verify this.

I'll create a pull request to add the delay

I'm not sure if this is a limitation of ZGB or GBDK, but it seems as though there isn't a way to set which of the four sprite colors is transparent.

Save the file into the res/ folder as enemy.gbr (the b3 before the gbr extension indicates that we want to save this sprite on bank 3, notice how all the resources in the template are also stored in bank3 by default)
https://github.com/Zal0/ZGB/wiki/Enemies

This section has 2 errors:

1. The parts about banks (b3) are no longer relevant.
2. The file must be saved into res/Sprites/ (not just res). Otherwise, the game will crash.

It is not really and issue of ZGB is an issue of make.
ZGB can't be inside any folder that have spaces. Is the path of the installation of ZGB have spaces then the build don't work.
It seems to be a bug of make http://savannah.gnu.org/bugs/?712

For ZGB I think the better is to point that in the readme and in the wiki tutorial.

There is a call to StopMusic; on line 136 of main.c. The levels in my game can be quite short, and it would be nice to be able to conditionally continue playing music. At least in my project, if I comment out this line, music continues playing fine.

I'm loving working with ZGB so far, builds fast, reasonably documented, good start up tutorials, etc.

My current project doesn't need saves but it would be great to be able to add them :)

It would be really cool to have the option to add background animations.
Waterfall animations in games like Luna make backgrounds take life.
Thanks for all!

Just a stupid suggestion, could you add void LCD_isr(); declaration to main.h? in case you want to remove this interruption to have the sprites over the window. It's an easy tweak, but if it's already included in ZGB it's always better.
Thanks in advance!

The fade functions found in "Fade.h" appear to be broken when running the non-color version of a game. FadeIn() works (fading the screen to pure white, but FadeOut() appears to have no effect. If called after calling FadeIn() the screen stays pure white. If called without first calling FadeOut(), the color does not change.

I wrote a simple example game with this Update:

void UPDATE() {
	if(KEY_TICKED(J_START))
	{
		FadeIn();
	}
	
	if (KEY_TICKED(J_SELECT))
	{
		FadeOut();
	}

These 2 gifs are the same game compiled as Color and Non-Color. In both cases I press START and shortly after I press SELECT. Note that while both versions fade up to white, the DMG version does not fade back down.

I'm not programming using this engine myself, but there's a visual issue I've seen in Super Princess' 2092 Exodus and Luna, so I suspect it's a bug in the engine, and so I thought I would file a ticket.

Sometimes when scrolling the engine appears to incorrectly decode or assign a map tile, resulting in a corrupt appearance. The tile remains in its incorrect state as long as it remains on-screen. If I scroll the tile off-screen and then back on-screen the issue goes away. Unfortunately, I don't have a reliable way to force the issue to happen. It just happens somewhat rarely seemingly at random.

I have attached photos of the bug expressing twice in Luna. Look towards the top-left corner. Again, I saw the issue once or twice in Super Princess' 2092 Exodus, but I lack any screenshots of the issue there.

I've been successfully building/running on macOS for a while now using changes very similar to this pull request: https://github.com/Zal0/ZGB/pull/32/files

However I've recently added music to my game, and I'm noticing this issue:

creating zgb.lib
Linking
?ASlink-Warning-Cannot open library module ../DebugColor/zgb/-e gbt_player.o

?ASlink-Warning-Undefined Global '_gbt_stop' referenced by module 'main'

?ASlink-Warning-Undefined Global '_gbt_enable_channels' referenced by module 'main'

?ASlink-Warning-Undefined Global '_gbt_play' referenced by module 'Music'

?ASlink-Warning-Undefined Global '_gbt_loop' referenced by module 'Music'

?ASlink-Warning-Undefined Global '_gbt_update' referenced by module 'Music'

The culprit seems to be some bad string concatenation with macOS make, where -e is in the wrong place: /zgb/-e gbt_player.o

I was able to work around this by removing the link to $(ZGB_PATH_UNIX)/lib/hUGEDriver.obj.o, and adding an explicitly linking $(OBJDIR_ZGB)/gbt_player.o instead. I can keep my copy of ZGB patched and rebase as new changes come out, since I already do this for gbm2c, gbr2c, and gbr2png binaries... But it would be nice if a fix were incorporated upstream since the makefile seems like fertile ground for merge conflicts.

If you remove all sprites from the game, you will be unable to compile.

These pages are still referencing to bank handling stuff:

1. https://github.com/Zal0/ZGB/wiki/Music
2. https://github.com/Zal0/ZGB/wiki/Maps
3. https://github.com/Zal0/ZGB/wiki/Enemies

When I try compiling I get the following error from the compiler :
ZGB/common/src/main.c:127: warning 112: function 'add_low_priority_TIM' implicit declaration
ZGB/common/src/main.c:127: error 101: too many parameters make: *** [../ReleaseColor/zgb/main.o] Error 1

This isn't a big issue, but could you include a screen shot in your readme.md, i think it could help people want to download it, at least, screenshots influence my decisions on downloading things.

title says it all, no? this feature could be very useful for an attack, i.e. punching. you wouldn't want to have the animation loop, right? just play once.

I'm having an issue compiling any games with this tool, it works fine on my laptop but on my desktop I get an error when it starts on __sdcc_call_hl.s. The error that pops up calls out sdasgb.exe

The text from cmd reads

make: Entering directory c:/ZGB/common/src'
compiling __sdcc_call_hl.s
make: *** [../Release/__sdcc_call_hl.o] Error -1073741502
make: Leaving directory `c:/ZGB/common/src'

C:\Users\digis\Downloads\ZGB-template-master\ZGB-template-master>cd src

C:\Users\digis\Downloads\ZGB-template-master\ZGB-template-master\src>C:\gbdk\bin\make-3.81-bin\bin\make run
compiling resource: ../res/src/font.b3.c
0 [main] sh 16880 sync_with_child: child 13780(0x208) died before initialization with status code 0xC0000142
105 [main] sh 16880 sync_with_child: *** child state waiting for longjmp
/usr/bin/sh: fork: Resource temporarily unavailable
make: *** [../Release/res/font.b3.o] Error 128

C:\Users\digis\Downloads\ZGB-template-master\ZGB-template-master\src>cd ..

C:\Users\digis\Downloads\ZGB-template-master\ZGB-template-master>pause
Press any key to continue . . .`

If this isn't where this should be posted, let me know where I should move it.

Thanks

If multiple maps are loaded with InitScroll(), it is possible to run out of palettes (and I assume have the wrong palettes assigned to the wrong tile).

I believe in Scroll.c, InitScrollWithTiles should reset last_bg_pal_loaded back to 0, prior to loading the tile and map data.

https://discord.com/channels/790342889318252555/790346049377927168/928058473692954674

I looked for AGES for a simple image to c converted that ALSO did colour, the only one I've found so far is: pngb - https://github.com/battlecoder/pngb

Figured that if I had that much trouble, having it listed or included might help others out too.

Open the tiles.bgr with the Game Boy Tile Designer and go to View->Tile Count and set that to 255. Now edit the tile 254 that corresponds to the sprite of type 1 (SPRITE_ENEMY) and create a thumbnail of the enemy

https://github.com/Zal0/ZGB/wiki/Maps

This part of the tutorial assumes that tiles.gbr is setup for 256 tiles, but it only has 128.

dear @Zal0 , please make ZGB compatible with the latest GBDK-2020 from your repo, i have a conflict with _current_bank definition, thank you

add it mate lol

Heya, I love this project, it's making GB dev so accessible and the tutorial is great!

I found a small issue when going through the HUD section of the tutorial: I had hud_tiles.gbr in res/sprites (i duplicated the player.gbr sprite so I didn't have to redefine the colour palette) and hud.gbm in res. This resulted in it rendering glitchy tiles:

After a while I figured it out, I don't know if this is a bug or just something to be documented.

Cheers!

Without a license, it isn't legal (at least where I live) for anyone to use this library in their game, because you haven't given them permission (even though the code is right here). I would recommend adding either the MIT license or the zlib license.

• The MIT license requires that you give the library credit.
• The zlib license requires that you give credit in your source code, but binaries do not have to.

To add one of these licenses, you can put one of the following texts in a file called LICENSE.txt (or LICENSE.md).

zlib:

zlib License

(C) 2017 Zalo

This software is provided 'as-is', without any express or implied
warranty.  In no event will the authors be held liable for any damages
arising from the use of this software.

Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not
   claim that you wrote the original software. If you use this software
   in a product, an acknowledgment in the product documentation would be
   appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be
   misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.

MIT:

MIT License

Copyright (c) 2017 Zalo

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

I'm observing an issue where the last sprite loaded has its color palette overwrite previous sprites palettes.

• a grey box that is supposed to be green. generated from a gbr.
• a person that appears correct on the right and wrong on the left. generated from a png.
• a blue hint window that is correct generated from a png.

I think the strncmp is trying to allow multiple sprites that are sharing colors to share a hardware palette? I don't think it's functioning correctly. Perhaps after filing this issue I'll try to find a more proper fix.

I'm having problems with 32x32 sprites.
This is how it should appear (in the previous versions of ZGB it was working ok):

And this is how appears now:

As I see, the problem is with the automatically exported file. Here I left an attached a file with the file exported from GBTD (enemy3 (ok).b3.c) and the automatically generated file (enemy3 (wrong).b3.gbr.c). As you can see, the sprite array is not the same.

Thanks in advance!

enemy3.zip

Hi !

I was wondering about something. I'm trying to make a game where you get to stick to walls and ceilings and stuff, but I can't figure out how to check the collision tiles at a certain point. I'm mainly wondering what the .... command ? is that the word ?
I'm wondering what the command is for that. I thought "GetScrollTile" might do the trick, but.... Yeah, that's not working.

If it doesn't exist already, I was wondering if you could add it ? I've been looking through the include files for anything that could help, but... I couldn't find anything. Maybe I'm blinding on it...

Does anyone know if this is doable?

Hello! First of all, thanks for this wonderfull engine.

I've got a problem with the latest version, I've updated engine and game code to work with it, but I cannot compile any of the test i was making before all the changes in the engine were made. I try to redownload all and configure again and with the new template, but the results are the same. If I restore the previous game code and ZGB enviroment, everything is Ok.

There goes an attachement with the result:

Thanks in advance!

`C:\ZGB\proyectos\ZGB-template-master>cd src

C:\ZGB\proyectos\ZGB-template-master\src>c:/ZGB/common..\env\make-3.81-bin\bin\make run
El sistema no puede encontrar la ruta especificada.
El sistema no puede encontrar la ruta especificada.
El sistema no puede encontrar la ruta especificada.
El sistema no puede encontrar la ruta especificada.
El sistema no puede encontrar la ruta especificada.
El sistema no puede encontrar la ruta especificada.
El sistema no puede encontrar la ruta especificada.
El sistema no puede encontrar la ruta especificada.
El sistema no puede encontrar la ruta especificada.
El sistema no puede encontrar la ruta especificada.
El sistema no puede encontrar la ruta especificada.
El sistema no puede encontrar la ruta especificada.
El sistema no puede encontrar la ruta especificada.
El sistema no puede encontrar la ruta especificada.
El sistema no puede encontrar la ruta especificada.
El sistema no puede encontrar la ruta especificada.
El sistema no puede encontrar la ruta especificada.
El sistema no puede encontrar la ruta especificada.
Creating folder ../res/src
La sintaxis del comando no es correcta.
Error writing fileCreating folder ../Release/zgb
La sintaxis del comando no es correcta.
common..\env\make-3.81-bin\bin\make: *** [../Release/zgb] Error 1

C:\ZGB\proyectos\ZGB-template-master\src>cd ..

C:\ZGB\proyectos\ZGB-template-master>pause
Presione una tecla para continuar . . .`

I'm not sure if this's a bug but... I'm trying to add a sprite with a simple 4 frames 32x32 animation.

I added this to ZGBMain.h:

_SPRITE_DMG(SPRITE_ENEMY, enemy, 3, FRAME_32x32, 4)\

I have an exported enemy.b3.c file under res/src.

The enemy code is:

#pragma bank 2
#include "main.h"
UINT8 bank_SPRITE_ENEMY = 2;

#include "SpriteManager.h"

const UINT8 anim_enemy_idle[] = {0, 1, 2, 3};

void Start_SPRITE_ENEMY() {
	SetSpriteAnim(THIS, anim_enemy_idle, 15);
}

void Update_SPRITE_ENEMY() {

}

void Destroy_SPRITE_ENEMY() {
}

The result is:
https://www.youtube.com/watch?v=NDc7awTalys

I would appreciate any advice!

Before as the collisions of the sprites were defined, you could change the collisions at any time you wanted, now as it is done through the meta is something that I do not know how it could be done.

I declare the music and use it as indicated in the documentation but I get this error when I save a song .uge in the res/music folder

This line should be replaced with
SetTile (id, replacement);

which will check STAT_REG & 2 before writing.

This is similar to the call directly above to write the tile data

I believe the FadeStepColor function could be improved by changing the calls to set_bkg_palette and set_sprite_palette to one call each outside the for loop:

https://github.com/Zal0/ZGB/blob/master/common/src/Fade_b.c#L61

void FadeStepColor(UINT8 i) {
	UINT8 pal, c;
	UWORD palette[4];
	UWORD palette_s[4];
	UWORD* col = ZGB_Fading_BPal;
	UWORD* col_s = ZGB_Fading_SPal;

	for(pal = 0; pal < 8; pal ++) {
		for(c = 0; c < 4; ++c, ++col, ++col_s) {
				palette[c] = UpdateColor(i, *col);
				palette_s[c] = UpdateColor(i, *col_s);
		};
	}
	set_bkg_palette(pal, 8, palette);
	set_sprite_palette(pal, 8, palette_s);
	delay(20);
}

This would reduce the number of function calls, and in cases where the for loop takes longer than a single frame would reduce the chances of the palette updates spanning frames (since they occur closer together), thus reducing out-of-sync palette updates.

One thing that would make this library perfect would be native support for hUGETracker's hUGEDriver. It's specifically designed to be used with Gameboy development, meaning it is way better than OpenMPT and all the clunkiness with that system.

If you use MoveScroll to jump more than 1 tile at a time, it will not load in tiles for the rows you skip over.

For example, this is the result of scrolling by 16 pixels at a time:

The functionality is required for maps the don't start in the top left hand corner of the map.

It would be awesome if ZGB had sprite flickering management when there are more sprites in a scanline than supported :)

This line is incorrect; hUGE_init is for initializing to a song descriptor, but 0 isn't one. Up until now, I believe this went unnoticed since hUGE_init doesn't do any unbounded looping, but when I added song decompression to a fork of hUGEDriver, this broke.

Here's a patch which fixes things up :)

diff --git a/common/include/Music.h b/common/include/Music.h
index 8ed475d..e36ae0c 100644
--- a/common/include/Music.h
+++ b/common/include/Music.h
@@ -13,7 +13,7 @@ void MusicCallback() __nonbanked;
 	extern BYTE hUGE_paused;
 	void hUGE_mute(UBYTE mute);
 
-	#define INIT_MUSIC hUGE_init(0)
+	#define INIT_MUSIC
 	#define DECLARE_MUSIC(SONG) extern const void __bank_ ## SONG ## _uge; extern const hUGESong_t SONG ## _uge
 	#define PlayMusic(SONG, LOOP) __PlayMusic(&SONG ## _uge, (uint8_t)&__bank_ ## SONG ## _uge, 0)
 	#define StopMusic hUGE_paused = 1; hUGE_mute(HT_CH_MUTE); last_music = 0

Some times it's usefull to have string format specifier.

Often a save file should not be completely zero'd out by default.

It would be nice if the SRAM API allowed for either passing in a "default" savegame struct to copy in the case of CheckSRAMIntegrity needing to clear out the save. Alternatively, some sort of callback that the game could implement would work too.

In the music section of the tutorial (https://github.com/Zal0/ZGB/wiki/Music) the part about declaring the music is slightly confusing.

First, the template using HUDTRACKER by default, not GBT_PLAYER. The tutorial doesn't seem to work with HUGETRACKER (linker errors), so it requires that the user editor the Makefile here:

# Music player: HUGETRACKER(default) or GBT_PLAYER MUSIC_PLAYER = GBT_PLAYER

Modify it and save it with a different name. Don't forget to include in what bank the music should be (level1.mod for example).

This talks about setting the bank that the music should live in, but I'm pretty sure that isn't required anymore, as the project using automatic banking.

Additionally, there is a missing step to "include music.h".

I was on 2020.2 and rom compilation was working fine, but today I installed 2021.0 and compilation doesn't work.

C:\Users\censored\Downloads\ZGB-template-master\ZGB-template-master>cd src

C:\Users\censored\Downloads\ZGB-template-master\ZGB-template-master\src>C:\Users\censored\Downloads\ZGB->2021.0\ZGB\common..\env\make-3.81-bin\bin\make run BUILD_TYPE=ReleaseColor
Linking
Multiple definition of _empty
Multiple definition of _empty
Multiple definition of _empty
Multiple definition of _empty
Multiple definition of _empty
Multiple definition of _empty
Multiple definition of _empty
?ASlink-Warning-Cannot open library module ../ReleaseColor/zgb/.rel
Multiple definition of _empty
make: *** [../bin/ZgbTest.gbc] Erreur 2

C:\Users\censored\Downloads\ZGB-template-master\ZGB-template-master\src>cd ..

C:\Users\censored\Downloads\ZGB-template-master\ZGB-template-master>pause
Appuyez sur une touche pour continuer...

Changing back to 2020.2 wasn't helpful since now it makes a new error when compilling:

C:\Users\censored\Downloads\ZGB-template-master\ZGB-template-master>cd src

C:\Users\censored\Downloads\ZGB-template-master\ZGB-template-master\src>C:\Users\censored\Downloads\ZGB-2020.2\ZGB->2020.2\common..\env\make-3.81-bin\bin\make run BUILD_TYPE=ReleaseColor
Linking
C:/Users/censored/Downloads/ZGB-2020.2/ZGB-2020.2/common/../env/gbdk/bin/lcc -Wl-m -Wl-j -Wl-yt1 -Wl-yo128 -Wl->yp0x143=0xC0 -Wl-g.STACK=0xDEFF -k../ReleaseColor/zgb -lzgb.lib -o ../ReleaseColor/ZgbTest.gbc >../ReleaseColor/res/map.b3.gbm.o ../ReleaseColor/res/enemy.b3.gbr.o ../ReleaseColor/res/font.b3.gbr.o >../ReleaseColor/res/player.b3.gbr.o ../ReleaseColor/res/tiles.b3.gbr.o ../ReleaseColor/SpriteEnemy.o >../ReleaseColor/SpritePlayer.o ../ReleaseColor/StateGame.o ../ReleaseColor/ZGBMain.o
Error: Format(XL3) Only XL2 format is supported
Error: Format(XL3) Only XL2 format is supported
Error: Format(XL3) Only XL2 format is supported
Error: Format(XL3) Only XL2 format is supported
Error: Format(XL3) Only XL2 format is supported
Error: Format(XL3) Only XL2 format is supported
Error: Format(XL3) Only XL2 format is supported
Error: Format(XL3) Only XL2 format is supported
Error: Format(XL3) Only XL2 format is supported
Error: Format(XL3) Only XL2 format is supported
Error: Format(XL3) Only XL2 format is supported
Error: Format(XL3) Only XL2 format is supported
Error: Format(XL3) Only XL2 format is supported
Error: Format(XL3) Only XL2 format is supported
Error: Format(XL3) Only XL2 format is supported
Error: Format(XL3) Only XL2 format is supported
Error: Format(XL3) Only XL2 format is supported
Error: Format(XL3) Only XL2 format is supported

?ASlink-Warning-Undefined Global ___sdcc_bcall_ehl referenced by module Frame
ERROR: address overflow (addr c0a1 >= 8000)
c:\Users\censored\Downloads\ZGB-2020.2\ZGB-2020.2\env\gbdk\bin\lcc.exe: c:\Users\censored\Downloads\ZGB-2020.2\ZGB->2020.2\env\gbdk\bin/link-gbz80: No such file or directory
make: *** [../bin/ZgbTest.gbc] Erreur 1

C:\Users\censored\Downloads\ZGB-template-master\ZGB-template-master\src>cd ..

C:\Users\censored\Downloads\ZGB-template-master\ZGB-template-master>pause
Appuyez sur une touche pour continuer...

Edit: I deleted the Release/Debug/ReleaseColor/DebugColor folder(s) and compilation with 2020.2 worked again, however 2021.0 still doesn't work

Description of Changes

I recently have started using this library and first, thank you for all your hard work you put into it. Its very impressive and heavily enriches the community of game boy developers.

I use Ubuntu on desktop and I would like to help refine some instructions for the wiki to help other developers using this repo on linux. I was wondering if we could have a "installation / building" page separate from the Creating a New Project Wiki Page. Ideally this page can lead with the expected installation with windows, but could have a header for linux building instructions with some more specific commands. I read your post in #10 (comment) and believe that the instructions you gave are spot on, and with a little refinement would be a very good start for the wiki page.

Thank you again for your time, and I would love to help with this if I can.

Where can I get a macOS build? I don't own a windows maschine.