forked from exult/exult
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME.MacOSX
149 lines (108 loc) · 4.55 KB
/
README.MacOSX
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
Exult instructions for MacOS
----------------------------
To play
-------
First you need to get Ultima VII: The Black Gate or Ultima VII Part 2:
Serpent Isle. Either you own it already, or you buy it somewhere.
In the documentation of Exult (ReadMe, ReadMe.html) we describe
several ways of how to install the original games and where to
put the files on your Mac so Exult finds them automatically.
Now download Exult, and have fun!
More Information
----------------
More information can be found in the accompanying files README and FAQ.
In addition, you might want to check out our homepage at
https://exult.info
How to compile on macOS
-----------------------
The following guide is only for people that want to compile Exult on their own.
This is not needed if there is a current snapshot for macOS available on our
download page.
Make sure you have Apple's Xcode, which can be installed for free from
the App Store (https://apps.apple.com/de/app/xcode/id497799835?l=en&mt=12).
In order to compile Exult, you need to install several Unix packages.
If you are an expert, you may want to install them manually; for all others,
we recommend installing them via the package manager MacPorts (http://www.macports.org/).
Alternative package managers are Fink (https://www.finkproject.org) or
Homebrew (https://brew.sh/).
With MacPorts install:
autoconf-archive
libsdl2
libvorbis
munt-mt32emu
libpng
fluidsynth
dylibbundler
create-dmg
Installing these packages with MacPorts will actually install many other
packages these depend on.
Open terminal and enter the following to allow the compile to find all the
headers.
If you use MacPorts:
export CFLAGS=-I/opt/local/include
export CXXFLAGS=$CFLAGS
export CPPFLAGS=$CFLAGS
Now you are ready to compile Exult. If you are compiling from Git, the
first thing you have to run is this:
autoreconf -v -i
The next step is the same whether you compile a release version or Git:
./configure
make
This will give you a "exult" binary in the current directory. If you want
a nice Exult.app (double clickable from the Finder and all), enter this
command:
make bundle
To use this bundle on another machine you need to run:
make bundle_shared
How to compile Exult Studio on macOS
------------------------------------
If you want to compile Exult Studio, you have to install these packages:
libsdl2
gtk3
This will cause many other packages required by gtk3 to
be installed.
After that, you have to re-run configure and make (remember to do the export commands
to find the headers):
./configure --enable-exult-studio --enable-exult-studio-support
make
- You need to add the path of Exult Studio to your PATH settings so that Exult
can start Exult Studio on entering Map-Edit-Mode (ctrl+cmd+m).
Normally Exult Studio gets compiled in /path_to_the_Exult_source_code/mapedit,
so if you do "export PATH=$PATH:/path_to_the_Exult_source_code/mapedit" before
starting Exult, you can start using Exult and Exult Studio.
If you don't want to set the path to Exult Studio, you can also start Exult,
go into Map-Edit-Mode, start Exult Studio manually and click in it's menu
on File->Connect.
- You need to copy the file exult_studio.glade (found in
/path_to_the_Exult_source_code/mapedit/) to your Exult data folder which is by
default in /Library/Application Support/Exult/data.
How to build an Exult Studio app Bundle
---------------------------------------
You will need another package from MacPorts:
gtk-mac-bundler
Follow the above steps to build Exult Studio and Exult with Exult Studio Support.
Afterwards run the commands:
export PREFIX=PATH_TO_PREFIX
make studiobundle
In the above command substitute PATH_TO_PREFIX with your real prefix path.
If you use MacPorts this would be "/opt/local", so the commands look like this:
export PREFIX=/opt/local
make studiobundle
This will generate the Exult_Studio.app in your Exult source.
How to build a disk image
-------------------------
For building a disk image for Exult, run:
make osxdmg
For building a disk image for Exult Studio, run:
make studiodmg
How to build the Gimp plugin
----------------------------
With MacPorts install:
gimp2 +quartz
Then re-run configure and make
./configure --enable-tools --enable-gimp-plugin
make
You will then find the Gimp plugin "u7shp" in the mapedit folder of our source. For the Gimp
to use it you need to copy it into ~/Library/Application Support/GIMP/2.10/plug-ins.
Note that this is again not a static build of the plugin and relies on your MacPorts installation.
So if you uninstall MacPorts the Plugin will cease to work.