]> git.xonotic.org Git - xonotic/netradiant.git/blob - README.md
6270506950b4f123153f45e6ea08ed6ae40fa9c4
[xonotic/netradiant.git] / README.md
1 NetRadiant
2 ==========
3
4 ![NetRadiant logo](setup/data/tools/bitmaps/splash.png)
5
6 The open source, cross platform level editor for idtech games (Radiant fork).
7
8 # Getting the sources
9
10 The latest source is available from the git repository:
11 https://gitlab.com/xonotic/netradiant.git
12
13 The git client can be obtained from the Git website:
14 http://git-scm.org
15
16 To get a copy of the source using the command line git client:
17
18 ```
19 git clone --recursive https://gitlab.com/xonotic/netradiant.git
20 cd netradiant
21 ```
22
23 See also https://gitlab.com/xonotic/netradiant/ for a source browser, issues and more.
24
25 # Dependencies
26
27 * OpenGL
28 * LibXml2
29 * GTK2
30 * GtkGLExt
31 * LibJpeg
32 * LibPng
33 * LibWebp
34 * Minizip
35 * ZLib
36
37 ## msys2
38
39 Under MSYS2, the mingw shell must be used
40
41 ### 32 bit:
42
43 ```
44 pacman -S --needed base-devel mingw-w64-i686-{toolchain,cmake,make,gtk2,gtkglexti,libwebp}
45 ```
46
47 ### 64 bit:
48
49 ```
50 pacman -S --needed base-devel mingw-w64-x86_64-{toolchain,cmake,make,gtk2,gtkglext,libwebp}
51 ```
52
53 ## macOS:
54
55 ```
56 brew install gcc cmake Caskroom/cask/xquartz gtkglext pkgconfig minizip webp coreutils gnu-sed
57 brew link --force gettext
58 ```
59
60 # Submodules
61
62  * Crunch (optional, disabled by default, only supported with CMake build)
63
64 If you have not used `--recursive` option at `git clone` time, you can fetch Crunch this way (run it within the NetRadiant repository):
65
66
67 ```
68 git submodule update --init --recursive
69 ```
70
71 # Compiling
72
73 This project uses the usual CMake workflow:
74
75 ## Debug
76
77 ```
78 cmake -G "Unix Makefiles" -H. -Bbuild && cmake --build build -- -j$(nproc)
79 ```
80
81 ## Release
82
83 ```
84 cmake -G "Unix Makefiles" -H. -Bbuild -DCMAKE_BUILD_TYPE=Release && cmake --build build -- -j$(nproc)
85 ```
86
87 On Mac you have to add this to the first cmake call:
88
89 ```
90 -DCMAKE_C_COMPILER=/usr/local/bin/gcc-9 -DCMAKE_CXX_COMPILER=/usr/local/bin/g++-9 -DOPENGL_INCLUDE_DIR=/opt/X11/include -DOPENGL_gl_LIBRARY=/opt/X11/lib/libGL.dylib
91 ```
92
93 ## Build and installation details
94
95 ### Compilation details
96
97 options:
98
99 * `BUILD_RADIANT=OFF`  
100    Do not build NetRadiant (default: `ON`, build radiant graphical editor)
101 * `BUILD_TOOLS=OFF`  
102    Do not build q3map2 and other tools (default: `ON`, build command line tools)
103 * `BUILD_CRUNCH=ON`  
104    Enable crunch support (default: `OFF`, disable crunch support)
105 * `RADIANT_ABOUTMSG="Custom build"`  
106    A message shown in the about dialog
107
108 targets:
109
110 * `radiant`    Compiles the radiant core binary
111 * `modules`    Compiles all modules (each module has its own target as well)
112 * `plugins`    Compiles all plugins (each plugin has its own target as well)
113 * `quake3`     Compiles all the Quake3 tools
114   - `q3map2`   Compiles the quake3 map compiler
115   - `q3data`   Compiles the q3data tool
116
117 ### Download details
118
119 options:
120
121 * `DOWNLOAD_GAMEPACKS=OFF`  
122    Do not automatically download the gamepack data during the first compilation (default: `ON`)
123 * `GAMEPACKS_LICENSE_LIST=all`  
124    Download all gamepacks whatever the license (default: `free`, download free gamepacks)
125 * `GAMEPACKS_NAME_LIST=Xonotic Unvanquished`  
126    Download gamepacks for the given games (default: `none`, do not select more gamepacks to download)
127
128 target:
129
130 * `game_packs` Downloads the game pack data
131
132 Run `./gamepacks-manager -h` to know about available licenses and other available games. Both lists are merged, for example setting `GAMEPACKS_LICENSE_LIST=GPL` and `GAMEPACKS_NAME_LIST=Q3` will install both GPL gamepacks and proprietary Quake 3 one.
133
134 ### Installation details
135
136 options:
137
138 * `FHS_INSTALL=ON`  
139   Install files following the Filesystem Hierarchy Standard (bin, lib, share, etc.), also setup XDG mime and application support on POSIX systems (default: `OFF`, install like in 1999)
140 * `CMAKE_INSTALL_PREFIX=/usr`  
141   Install system-wide on Posix systems, always set `FHS_INSTALL` to `ON` when doing this (default: install in `install/` directory within source tree)
142
143 target:
144
145 * `install`  
146   Install files
147
148 ## Note about Crunch
149
150 The crnlib used to decode `.crn` files is the one from [Dæmon](http://github.com/DaemonEngine/Daemon) which is the one by [Unity](https://github.com/Unity-Technologies/crunch/tree/unity) made cross-platform and slightly improved. Since Unity brokes compatibility with [BinomialLLC's legacy tree](https://github.com/BinomialLLC/crunch) it's required to use either the `crunch` tool from Dæmon or the one from Unity to compress textures that have to be read by radiant or q3map2.