NetRadiant
==========
-
+[](https://netradiant.gitlab.io)
-The open source, cross platform level editor for id Tech-derivated games (has lineage to GtkRadiant).
+The open source, cross platform level editor for id Tech-derivated games, heir of GtkRadiant.
+
+Learn more on NetRadiant website: [netradiant.gitlab.io](https://netradiant.gitlab.io).
+
+
+## Download NetRadiant
+
+Prebuilt binaries can be found on the [Download page](https://netradiant.gitlab.io/page/download/).
## Compatibility matrix
|FreeBSD |**Yes** |_not yet_ |**Yes** |_GCC or Clang_ |
|Windows |**Yes** |**Yes** |**Yes** |_MSYS2/Mingw64 or Mingw32_ |
|Wine |- |- |**Yes** |- |
-|macOS |**Yes** |_not yet_ |_mostly_ |_Homebrew, GCC or Clang and patched GtkGLExt_ |
+|macOS |**Yes** |**Yes** |**Yes** |_Homebrew, GCC or Clang and builtin GtkGLExt_ |
-NetRadiant is known to build and run properly on Linux, FreeBSD and Windows using MSYS2. NetRadiant is known to build on macOS using Homebrew, but can't display things properly without a modified GtkGLExt which is yet to be upstreamed, and issues are known. Windows build is known to work well on wine, which can be used as a fallback on macOS.
+NetRadiant is known to build and run properly on Linux, FreeBSD and Windows using MSYS2, and build on macOS with Homebrew (some bugs are known though). Windows build is known to work well on wine, which can be used as a fallback on some system.
-At this time library bundling is only supported on Windows/MSYS2 and Linux. Since bundling copies things from the host, a clean build environment has to be used in order to get a clean bundle. Linux bundle does not ship GTK (users are expected to have a working GTK environment with GtkGlExt installed).
+At this time library bundling is only supported on Linux, Windows/MSYS2, and macOS/Homebrew. Since bundling copies things from the host, a clean build environment has to be used in order to get a clean bundle. Linux bundle does not ship GTK (users are expected to have a working GTK environment with GtkGlExt installed).
## Getting the sources
-Source browser, issues and more can be found on the gitlab project: https://gitlab.com/xonotic/netradiant/
+Source browser, issues and more can be found on the gitlab project: [gitlab.com/xonotic/netradiant](https://gitlab.com/xonotic/netradiant)
The latest source is available from the git repository: `https://gitlab.com/xonotic/netradiant.git`
-The `git` client can be obtained from your distribution repository or from the Git website: http://git-scm.org
+The `git` client can be obtained from your distribution repository or from the Git website: [git-scm.org](http://git-scm.org)
A copy of the source tree can be obtained using the command line `git` client this way:
* OpenGL, LibXml2, GTK2, GtkGLExt, LibJpeg, LibPng, LibWebp, Minizip, ZLib.
-To fetch default game packages you'll need Git, Subversion and `unzip`.
+To fetch default game packages you'll need Git, Subversion, Wget and `unzip`.
### Ubuntu:
If you use MSYS2 over SSH, add `mingw64` to the path this way (given you compile for 64 bit Windows, replace with `mingw32` if you target 32 bit Windows instead):
```sh
-export PATH="/mingw64/bin:${PATH}"`
+export PATH="/mingw64/bin:${PATH}"
```
Install the dependencies this way:
### macOS:
```sh
-brew install cmake gtkglext pkgconfig minizip webp coreutils gnu-sed
+brew install cmake glib gtk+ pkgconfig minizip webp coreutils gnu-sed wget
brew link --force gettext
```
## Simple compilation
+It is required to first download the sources using `git` (do not use tarballs) and to have dependencies installed, see [Getting the sources](#getting-the-sources) and [Dependencies](#dependencies) above.
+
+
### Easy builder assistant
-If you have standard needs and use well-known platform and operating system, you may try the provided `easy-builder` script which may be enough for you:
+If you have standard needs and use well-known platform and operating system, you may try the provided `easy-builder` script which may be enough for you, you can run it this way:
```sh
./easy-builder
If everything went right, you'll find your netradiant build in `install/` subdirectory.
-If you need to build a debug build (to get help from a developer, for example), you can do it that way:
+If you need to build a debug build (to get help from a developer, for example), you can do it this way:
```sh
./easy-builder --debug
By default, build tools and compilers are using the `build/` directory as workspace.
+For supported system, bundling dependencies can be done this way:
+
+```sh
+./easy-builder -DBUNDLE_LIBRARIES=ON
+```
+
+Note: always do bundling on clean system without unrelated software installed.
+
## Advanced compilation
cmake --build build -- -j$(nproc)
```
+Note: macOS users need to build built-in GtkGLExt before building NetRadiant:
+
+```sh
+cmake -G "Unix Makefiles" -S. -Bbuild -DCMAKE_BUILD_TYPE=Release
+cmake --build build -- -j$(nproc) builtins
+cmake -G "Unix Makefiles" -S. -Bbuild
+cmake --build build -- -j$(nproc)
+```
+
+
### Subsequent builds
The initial build will download the gamepacks and build NetRadiant and tools. If you frequently recompile you can skip downloading the gamepacks:
Options:
* `BUNDLE_LIBRARIES=ON`
- Bundle libraries, only MSYS2 is supported at this time (default: `OFF`);
+ Bundle libraries, only MSYS2 and Linux are supported at this time (default: `OFF`);
* `FHS_INSTALL=ON` (available on POSIX systems)
Install files following the Filesystem Hierarchy Standard (`bin`, `lib`, `share`, etc.)
Also setup XDG mime and application support on Linux-like systems (default: `OFF`, install like in 1999);
* `install` Install files.
-## Additonnal notes
+## Additonnal information
### About Crunch
projects / xonotic / netradiant.git / blobdiff