Requirements:
C++20
libsndfile
libogg
libvorbis
Just including a Visual Studio project at the moment, as that's what I'm developing this with. It should build with any C++20 compiler that supports the above packages though.
SDL3 Mixer doesn't have an official release yet, so you'll have to build from the main repository.
You will also need the resources file (MainResources.rsrc) from the creator of the original program this work is based off of. Place it in the Resources folder of this program.
There are also a few files which didn't seem to be uploaded to the repo, but you can find them in the zip under the Releases.
https://github.com/beastie/ultima3
While it initially supported SDL Mixer 3, due to there being no official version yet, development on that has been paused, and went to a purely OpenAL approach.
Building for Mac
I'm not familiar with the ecosystem, so this is what I did to get it to compile. Unfortunately, I can't distribute this, as it wants to sandbox everything. The only way I know how to get it up and running is to do a local build.
Open up the Terminal.
Install Brew:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Install Brew packages:
brew install llvm
brew install cmake
brew install libogg
brew install libsndfile
brew install libvorbis
brew install openal-soft
Download and install the necessary SDL3 Libraries (SDL3, SDL3Image, SDL3TTF) according to their directions. It's basically downloading the appropriate library, and placing them in ~/Library/Frameworks.
You may have to also remove the quarantine attributes: Go to the the library directory:
cd ~/Library/Frameworks
xattr -r -d com.apple.quarantine SDL3.xcframework
xattr -r -d com.apple.quarantine SDL3_image.xcframework
xattr -r -d com.apple.quarantine SDL3_ttf.xcframework
xattr -r -d com.apple.quarantine share
At this point, you should now have everything necessary to build.
Building for non Visual Studio:
Navigate to the directory of the LairWare U3 CMakeLists.txt
mkdir build
cd build
cmake ../
make
After you make the files, place the Resources Directory in the same directory of the compiled executable, and the Mainresources.rsrc in the /Resources/Bin directory, and you should now be able to run the game.
Adding new tilesets:
In the graphics directory, provided the image is a multiple of 12x16 (e.g. 192x256 for 16x16 tiles), and ends with -Tiles.gif/png, the game should pick it up automatically. The same holds true for Font, Mini, and UI images. But, you will need a Tiles image for the others to work.
TO DO: In the future, something similar will be there to allow easy replacement of audio. For the time being, only the default ogg files are played, but you can replace them. The ogg files currently need to be 22050 Hz and Mono channel in order to work with OpenAL. (I believe the SDL Mixer version has more support.)
Controls:
Alt-x quits the game regardless of where you are. Yes, I finally changed this.
To bring up the Options screen, press Esc.
For debugging purposes, press Alt-F to show the fps.
Adding new music:
In the Mustic folder, add new subfolders and place the ogg files there.
In the Save folder, edit settings.xml and change the MusicSubfolder value to your new folder.
Right now, you'll have to restart the game in order for the new music to play.
Adding new fonts:
In the Fonts folder, add new subfolders and place the ttf files there.
In the Save folder, edit settings.xml and change the Font value to your new ttf font.
Right now, you'll have to restart the game in order to use the new font.
This part is very experimental. Right now I'm using several different unicode characters, and many ttf fonts don't include the full Unicode set, creating several graphical anomalies. Also, the size of the font was specifically designed around FreeSerif, and font spacing and sizes vary from font to font which can create abnormalities. While it is an option to change the font, I'd do this at your own discretion.