1
1
BZFlag README for Mac OS X
2
2
==========================
3
3
4
- BZFlag is fully supported on Mac OS X. Included below are instructions on
5
- installing BZFlag both from a binary and from a released source distribution.
4
+ BZFlag is supported on Mac OS X 10.7 and later. Included below are
5
+ instructions on installing BZFlag both from a binary and from a released
6
+ source distribution.
6
7
7
8
Binary Distribution
8
9
-------------------
@@ -14,7 +15,7 @@ distribution.
14
15
Once you've obtained a binary distribution of BZFlag, installation should be a
15
16
simple matter of copying the icon provided in the disk mounting image (the
16
17
.dmg) to your Applications folder. If you cannot run the client at all
17
- (e .e. it starts to a black screen, or the icon bounces but then nothing
18
+ (i .e. it starts to a black screen, or the icon bounces but then nothing
18
19
happens), you can try several things:
19
20
20
21
1) Move or delete the BZFlag directory in your personal application support
@@ -32,27 +33,33 @@ happens), you can try several things:
32
33
should be listed there and will start with "BZFlag."
33
34
34
35
3) Run the binary directly by using Terminal:
35
- /Applications/BZFlag-#.#.#.app/Contents/MacOS/BZFlag-#.#.#
36
+ /Applications/BZFlag-#.#.#.app/Contents/MacOS/BZFlag
36
37
(replace "#.#.#" with your actual BZFlag version number)
37
38
38
39
Source Distribution
39
40
-------------------
40
41
41
- You can build BZFlag from source using Xcode version 4.2 and later. As of
42
- BZFlag version 2.4.4, BZFlag has a fully native Xcode project
43
- file. The earlier method of using the Xcode project file as a wrapper for
44
- autotools is no longer supported. If you have a version of Xcode which
45
- includes autotools, or have installed autotools yourself, you may additionally
46
- be able to build using the traditional autotools method. See the README file
47
- for further information. You will still need to install the SDL 2 framework as
48
- detailed below.
42
+ You can build BZFlag from source using Xcode version 7 and later (You may also
43
+ be able to build with Xcode versions as early as 4.2, but you will need to
44
+ update the locations of libncurses, libcurl, and libz since those changed in
45
+ the Mac OS X 10.11 SDK). As of BZFlag version 2.4.4, BZFlag has a fully native
46
+ Xcode project file. The earlier method of using the Xcode project file as a
47
+ wrapper for autotools is no longer supported. If you have a version of Xcode
48
+ which includes autotools, or have installed autotools yourself, you may
49
+ additionally be able to build using the traditional autotools method. See the
50
+ README file for further information. You will still need to install the SDL 2
51
+ framework as detailed below.
49
52
50
53
BZFlag has two external dependencies: SDL 2 and c-ares.
51
54
52
55
Download the latest version of the SDL 2 framework from
53
56
https://www.libsdl.org/download-2.0.php. Version 2.0.4 or later is required.
54
- Mount the disk image and place the file "SDL2.framework" in your
55
- /Library/Frameworks directory (an administrator's account may be required).
57
+ As of the BZFlag 2.4.4 release, SDL 2.0.4 has not yet been released, but you
58
+ can build the latest development version of SDL 2 from Mercurial. If you
59
+ obtained a binary release of SDL 2, mount the disk image and place the file
60
+ "SDL2.framework" in your /Library/Frameworks directory (an administrator's
61
+ account may be required). If you built SDL 2 from source, locate the file
62
+ "SDL2.framework" and copy it into that same location.
56
63
57
64
This project expects the c-ares library and header files to be located in
58
65
/usr/local. If you install it elsewhere, you must update the library and
67
74
$ sudo make install
68
75
69
76
Obtain the latest BZFlag source archive from GitHub at
70
- https://github.com/BZFlag-Dev/bzflag (you want the .tar.gz archive, NOT the
71
- .zip archive). Once you have obtained the source code, open the
72
- BZFlag.xcodeproj file located in the Xcode/ directory.
77
+ https://github.com/BZFlag-Dev/bzflag. Once you have obtained the source code,
78
+ open the BZFlag.xcodeproj file located in the Xcode/ directory.
73
79
74
80
The default behavior is to build a debug client. If you want a standard
75
81
client, click the "BZFlag" scheme button at the top left corner of the screen,
@@ -119,6 +125,6 @@ any system without issue.
119
125
To access the bzadmin text client or the bzflag server bzfs, right click the
120
126
application, click "Show Package Contents," and navigate to Contents/MacOS.
121
127
Server plugins are located at Contents/PlugIns. Note that while the plugin
122
- names are different from Windows and Linux (something like "name.dylib"
123
- instead of "name.dll or "name.so"), bzfs will still load them when you specify
124
- the full plugin path.
128
+ names are different from Windows and Linux (something like "< name> .dylib"
129
+ instead of "< name> .dll or "< name> .so"), bzfs will still load them when you
130
+ specify the full plugin path.
0 commit comments