https://wiki.unvanquished.net/api.php?action=feedcontributions&user=Thelionroars&feedformat=atomUnvanquished - User contributions [en-gb]2024-03-28T15:11:10ZUser contributionsMediaWiki 1.25.3https://wiki.unvanquished.net/index.php?title=Tools/Level_editors&diff=2892Tools/Level editors2014-02-05T06:17:42Z<p>Thelionroars: Forgot the colour change</p>
<hr />
<div>Making maps for Unvanquished requires some external tools. They are all free.<br />
<br />
<br />
<br />
<br />
= Recommended tool load-out =<br />
You will want:<br />
* The game itself<br />
* [http://ingar.satgnu.net/gtkradiant/index.html#download Ingar's Netradiant]<br />
* The [http://ingar.satgnu.net/gtkradiant/files/gamepacks/UnvanquishedPack.zip gamepack for netradiant]<br />
<br />
Setup instructions are later in this guide.<br />
<br />
{{Note|content=Arch Linux users can use the [https://aur.archlinux.org/packages/netradiant-git netradiant-git] PKGBUILD to get the game and the [https://aur.archlinux.org/packages/netradiant-unvanquished netradiant-unvanquished] for the gamepack.}}<br />
<br />
== Installing Netradiant ==<br />
Follow the instructions on [http://ingar.satgnu.net/gtkradiant/installation.html Ingar's Installation Guide]. Mac and Linux users will have to use the terminal.<br />
<br />
== Gamepack ==<br />
NetRadiant is designed to work with many Quake-based games, not just Unvanquished. This step gives NetRadiant Unvanquished-specific information such as entity lists.<br />
<br />
Inside the gamepack zip file you will find two folders:<br />
* unvanquished.game<br />
* games<br />
<br />
Extract and merge both of these into your NetRadiant installation directly, where you will see similar folders such as "warsow.game" and "xonotic.game".<br />
<br />
=====Mac OS X=====<br />
<br />
Installation of the game pack on Mac OS X is slightly more complex, as you must place the game pack within the application's package:<br />
<br />
# Extract <code>UnvanquishedPack.zip</code> if you have not already done so. On some versions of Mac OS X, Safari is set by default to do this.<br />
# Navigate to your copy of Radiant and right-click it.<br />
# Select "Show Package Contents".<br />
# Navigate to <code>Contents/MacOS/install</code>.<br />
# Manually copy the <code>unvanquished.game</code> file (not directory) from the <code>game/</code> directory of the unzipped archive to the <code>Contents/MacOS/install/game/</code> directory of the application package.<br />
# Manually copy the <code>unvanquished.game</code> directory (not file) from the unzipped archive to the <code>Contents/MacOS/install/</code> directory of the application package.<br />
<br />
Note that you cannot copy all the files at once because Mac OS X lacks a "merge" feature; if you attempt to copy both folders at once, you will be prompted if you would like to overwrite the existing "games" folder with the new one. If this happens, cancel the operation.<br />
<br />
The directory tree should look as follows:<br />
* Contents/<br />
** MacOS/<br />
*** games/<br />
**** darkplaces.game<br />
**** nexuiz.game<br />
**** ...<br />
**** ufoai.game<br />
**** <span style="color:#49ab47;">unvanquished.game</span><br />
**** warsow.game<br />
**** xonotic.game<br />
*** <span style="color:#49ab47;">unvanquished.game/</span><br />
**** <span style="color:#49ab47;">default_build_menu.xml</span><br />
**** <span style="color:#49ab47;">game.xlink</span><br />
**** <span style="color:#49ab47;">main/</span><br />
***** <span style="color:#49ab47;">default_shaderlist.txt</span><br />
***** <span style="color:#49ab47;">entities.def</span><br />
Note that most of the contents of the tree have been omitted for brevity. Files that were added are highlighted green.<br />
<br />
=====Windows=====<br />
<br />
Extract the archive and copy and paste the contents in your NetRadiant installation folder. You will be prompted if you would like to merge the "<code>games/</code>" folder: choose "Yes".<br />
<br />
== Start up NetRadiant for the first time ==<br />
When you first start up NetRadiant you will be asked what game you want to develop for. <br />
<br />
* If Unvanquished is not listed, then you have not installed the gamepack properly<br />
* If you don't want to see this dialog on startup you can disable it with the second checkbox.<br />
<br />
[[File:Netrad_global_prefs.png]]<br />
<br />
<br />
You may also be asked for the game's ''engine path'' if NetRadiant can't find it. This is the location where the game stores its "main" folder holding the many .pk3 resources. <br />
<br />
[[File:Netrad_engine_not_found.png]]<br />
<br />
These are the default locations:<br />
<br />
{{Game Locations}}<br />
<br />
Finally you should be greeted by NetRadiant's default interface:<br />
<br />
[[File:Netrad_default.png]]<br />
<br />
Make sure you have a ''Common'' shader category. If you do not: contact the devs via [[IRC]] or the [https://unvanquished.net/forum forums] so we can get it fixed for you and write a guide here.<br />
<br />
[[File:Netrad_common.png]]<br />
<br />
== Optional Mapping Tools ==<br />
It is recommended you start with NetRadiant, however many other options are available:<br />
{| class="wikitable progress"<br />
|-<br />
! rowspan="2" | Program<br />
! rowspan="2" | Tested and Recommended<br />
! rowspan="2" | Mapping method<br />
! colspan="3" | Supported OSes<br />
! rowspan="2" | Last stable release<br />
! rowspan="2" | Notes<br />
|-<br />
! Mac OS X<br />
! Windows<br />
! Linux<br />
|-<br />
! [http://ingar.satgnu.net/gtkradiant/ NetRadiant] <br> (Ingar's builds)<br />
| class="done" | Yes<br />
| Brushes<br />
| class="done" | 10.5 & 10.6 <br />
| class="done" | Yes<br />
| class="done" | Yes<br />
| Current (2013)<br />
| Highly recommended brush-based editor. Mac users need X11 (10.7 users can get this from the [http://xquartz.macosforge.org/landing/ XQuartz project]). Arch Linux users can use the [https://aur.archlinux.org/packages/netradiant-git netradiant-git] PKGBUILD in the AUR.<br />
|-<br />
! [[#Blender|Blender]]<br />
| class="done" | Yes<br />
| Polygons<br />
| class="done" | Yes<br />
| class="done" | Yes<br />
| class="done" | Yes<br />
| Current<br />
| Extremely popular and open-source polygon based modelling tool. See the [http://www.katsbits.com/tutorials/blender/map-basics-tutorial.php katsbits tutorial] for getting it to work with Unvanq.<br />
|-<br />
! [http://www.redsaurus.net/00/node/4 MacRadiant]<br />
| class="wip" | ?<br />
| Brushes<br />
| class="done" | Yes (Intel &amp; PPC)<br />
| class="none" | No<br />
| class="none" | No<br />
| Unknown (v1.4 and v1.5)<br />
| Problems have been reported with Snow Leopard and Leopard, though there are workarounds. See the download page for more information.<br />
|-<br />
! [http://quark.sourceforge.net/ QuArK]<br />
| class="wip" | ?<br />
| ?<br />
| class="none" | No<br />
| class="done" | Yes<br />
| class="none" | No<br />
| Current (2013)<br />
| An all in one quake editor, capable of much more than mapping.<br />
|-<br />
! [http://kristianduske.com/trenchbroom/ Trenchbroom]<br />
| class="none" | No<br />
| Brushes<br />
| class="done" | 10.6 or newer<br />
| class="done" | Yes<br />
| class="done" | Yes (source)<br />
| Current (2013)<br />
| Editor for quake 1 maps, possibly with quake 3 mapping support. Notably ''not'' a Radiant derivative<br />
|-<br />
! [http://www.milkshape3d.com/ Milkshape 3D]<br />
| class="none" | No<br />
| Brushes<br />
| class="none" | No<br />
| class="wip" | ?<br />
| class="none" | No<br />
| Abandoned (2011)<br />
| Designed originally for Half Life<br />
|-<br />
! [http://icculus.org/gtkradiant/ GtkRadiant]<br />
| class="none" | No<br />
| Brushes<br />
| class="done" | Yes<br />
| class="done" | Yes<br />
| class="done" | Yes<br />
| 13 December 2013<br />
| Successor of NetRadiant. Brush based.<br />
|-<br />
! [http://darkradiant.sourceforge.net/ DarkRadiant]<br />
| class="none" | No<br />
| Brushes<br />
| class="none" | No<br />
| class="done" | Yes (32 and 64-bit)<br />
| class="wip" | ?<br />
| Current<br />
| Designed for a Doom 3 mod. Linux packages are not yet available (but have been promised by the developer).<br />
|-<br />
! [[#Gmax|Gmax]]<br />
| class="none" | No<br />
| Polygons<br />
| class="none" | No<br />
| class="done" | Yes<br />
| class="none" | No<br />
| Abandoned (2005)<br />
| Freeware version of polygon-based modelling tool 3DsMax. Used by many games but never updated: small bugs exist. May require a registration bypass to work (easily found) as the registration web-form has disappeared.<br />
|-<br />
|}<br />
<br />
'''Brush based''' editors require you to make your maps using [https://en.wikipedia.org/wiki/Constructive_solid_geometry constructive solid geometry] (CSG). Most mapping tutorials for Quake-like games such as Unvanquished follow this method.<br />
<br />
'''Polygon based''' editors give a larger focus on 2D shapes making up 3D ones, which ''can'' be more powerful but is more difficult to teach and learn. These editors generally support 'boolean operations', allowing them to be used like CSG editors, but with more difficulty.</div>Thelionroarshttps://wiki.unvanquished.net/index.php?title=Tools/Level_editors&diff=2891Tools/Level editors2014-02-05T06:16:35Z<p>Thelionroars: Updated information for GtkRadiant, which is now actively maintained by TTimo and others.</p>
<hr />
<div>Making maps for Unvanquished requires some external tools. They are all free.<br />
<br />
<br />
<br />
<br />
= Recommended tool load-out =<br />
You will want:<br />
* The game itself<br />
* [http://ingar.satgnu.net/gtkradiant/index.html#download Ingar's Netradiant]<br />
* The [http://ingar.satgnu.net/gtkradiant/files/gamepacks/UnvanquishedPack.zip gamepack for netradiant]<br />
<br />
Setup instructions are later in this guide.<br />
<br />
{{Note|content=Arch Linux users can use the [https://aur.archlinux.org/packages/netradiant-git netradiant-git] PKGBUILD to get the game and the [https://aur.archlinux.org/packages/netradiant-unvanquished netradiant-unvanquished] for the gamepack.}}<br />
<br />
== Installing Netradiant ==<br />
Follow the instructions on [http://ingar.satgnu.net/gtkradiant/installation.html Ingar's Installation Guide]. Mac and Linux users will have to use the terminal.<br />
<br />
== Gamepack ==<br />
NetRadiant is designed to work with many Quake-based games, not just Unvanquished. This step gives NetRadiant Unvanquished-specific information such as entity lists.<br />
<br />
Inside the gamepack zip file you will find two folders:<br />
* unvanquished.game<br />
* games<br />
<br />
Extract and merge both of these into your NetRadiant installation directly, where you will see similar folders such as "warsow.game" and "xonotic.game".<br />
<br />
=====Mac OS X=====<br />
<br />
Installation of the game pack on Mac OS X is slightly more complex, as you must place the game pack within the application's package:<br />
<br />
# Extract <code>UnvanquishedPack.zip</code> if you have not already done so. On some versions of Mac OS X, Safari is set by default to do this.<br />
# Navigate to your copy of Radiant and right-click it.<br />
# Select "Show Package Contents".<br />
# Navigate to <code>Contents/MacOS/install</code>.<br />
# Manually copy the <code>unvanquished.game</code> file (not directory) from the <code>game/</code> directory of the unzipped archive to the <code>Contents/MacOS/install/game/</code> directory of the application package.<br />
# Manually copy the <code>unvanquished.game</code> directory (not file) from the unzipped archive to the <code>Contents/MacOS/install/</code> directory of the application package.<br />
<br />
Note that you cannot copy all the files at once because Mac OS X lacks a "merge" feature; if you attempt to copy both folders at once, you will be prompted if you would like to overwrite the existing "games" folder with the new one. If this happens, cancel the operation.<br />
<br />
The directory tree should look as follows:<br />
* Contents/<br />
** MacOS/<br />
*** games/<br />
**** darkplaces.game<br />
**** nexuiz.game<br />
**** ...<br />
**** ufoai.game<br />
**** <span style="color:#49ab47;">unvanquished.game</span><br />
**** warsow.game<br />
**** xonotic.game<br />
*** <span style="color:#49ab47;">unvanquished.game/</span><br />
**** <span style="color:#49ab47;">default_build_menu.xml</span><br />
**** <span style="color:#49ab47;">game.xlink</span><br />
**** <span style="color:#49ab47;">main/</span><br />
***** <span style="color:#49ab47;">default_shaderlist.txt</span><br />
***** <span style="color:#49ab47;">entities.def</span><br />
Note that most of the contents of the tree have been omitted for brevity. Files that were added are highlighted green.<br />
<br />
=====Windows=====<br />
<br />
Extract the archive and copy and paste the contents in your NetRadiant installation folder. You will be prompted if you would like to merge the "<code>games/</code>" folder: choose "Yes".<br />
<br />
== Start up NetRadiant for the first time ==<br />
When you first start up NetRadiant you will be asked what game you want to develop for. <br />
<br />
* If Unvanquished is not listed, then you have not installed the gamepack properly<br />
* If you don't want to see this dialog on startup you can disable it with the second checkbox.<br />
<br />
[[File:Netrad_global_prefs.png]]<br />
<br />
<br />
You may also be asked for the game's ''engine path'' if NetRadiant can't find it. This is the location where the game stores its "main" folder holding the many .pk3 resources. <br />
<br />
[[File:Netrad_engine_not_found.png]]<br />
<br />
These are the default locations:<br />
<br />
{{Game Locations}}<br />
<br />
Finally you should be greeted by NetRadiant's default interface:<br />
<br />
[[File:Netrad_default.png]]<br />
<br />
Make sure you have a ''Common'' shader category. If you do not: contact the devs via [[IRC]] or the [https://unvanquished.net/forum forums] so we can get it fixed for you and write a guide here.<br />
<br />
[[File:Netrad_common.png]]<br />
<br />
== Optional Mapping Tools ==<br />
It is recommended you start with NetRadiant, however many other options are available:<br />
{| class="wikitable progress"<br />
|-<br />
! rowspan="2" | Program<br />
! rowspan="2" | Tested and Recommended<br />
! rowspan="2" | Mapping method<br />
! colspan="3" | Supported OSes<br />
! rowspan="2" | Last stable release<br />
! rowspan="2" | Notes<br />
|-<br />
! Mac OS X<br />
! Windows<br />
! Linux<br />
|-<br />
! [http://ingar.satgnu.net/gtkradiant/ NetRadiant] <br> (Ingar's builds)<br />
| class="done" | Yes<br />
| Brushes<br />
| class="done" | 10.5 & 10.6 <br />
| class="done" | Yes<br />
| class="done" | Yes<br />
| Current (2013)<br />
| Highly recommended brush-based editor. Mac users need X11 (10.7 users can get this from the [http://xquartz.macosforge.org/landing/ XQuartz project]). Arch Linux users can use the [https://aur.archlinux.org/packages/netradiant-git netradiant-git] PKGBUILD in the AUR.<br />
|-<br />
! [[#Blender|Blender]]<br />
| class="done" | Yes<br />
| Polygons<br />
| class="done" | Yes<br />
| class="done" | Yes<br />
| class="done" | Yes<br />
| Current<br />
| Extremely popular and open-source polygon based modelling tool. See the [http://www.katsbits.com/tutorials/blender/map-basics-tutorial.php katsbits tutorial] for getting it to work with Unvanq.<br />
|-<br />
! [http://www.redsaurus.net/00/node/4 MacRadiant]<br />
| class="wip" | ?<br />
| Brushes<br />
| class="done" | Yes (Intel &amp; PPC)<br />
| class="none" | No<br />
| class="none" | No<br />
| Unknown (v1.4 and v1.5)<br />
| Problems have been reported with Snow Leopard and Leopard, though there are workarounds. See the download page for more information.<br />
|-<br />
! [http://quark.sourceforge.net/ QuArK]<br />
| class="wip" | ?<br />
| ?<br />
| class="none" | No<br />
| class="done" | Yes<br />
| class="none" | No<br />
| Current (2013)<br />
| An all in one quake editor, capable of much more than mapping.<br />
|-<br />
! [http://kristianduske.com/trenchbroom/ Trenchbroom]<br />
| class="none" | No<br />
| Brushes<br />
| class="done" | 10.6 or newer<br />
| class="done" | Yes<br />
| class="done" | Yes (source)<br />
| Current (2013)<br />
| Editor for quake 1 maps, possibly with quake 3 mapping support. Notably ''not'' a Radiant derivative<br />
|-<br />
! [http://www.milkshape3d.com/ Milkshape 3D]<br />
| class="none" | No<br />
| Brushes<br />
| class="none" | No<br />
| class="wip" | ?<br />
| class="none" | No<br />
| Abandoned (2011)<br />
| Designed originally for Half Life<br />
|-<br />
! [http://icculus.org/gtkradiant/ GtkRadiant]<br />
| class="none" | No<br />
| Brushes<br />
| class="none" | Yes<br />
| class="done" | Yes<br />
| class="done" | Yes<br />
| 13 December 2013<br />
| Successor of NetRadiant. Brush based.<br />
|-<br />
! [http://darkradiant.sourceforge.net/ DarkRadiant]<br />
| class="none" | No<br />
| Brushes<br />
| class="none" | No<br />
| class="done" | Yes (32 and 64-bit)<br />
| class="wip" | ?<br />
| Current<br />
| Designed for a Doom 3 mod. Linux packages are not yet available (but have been promised by the developer).<br />
|-<br />
! [[#Gmax|Gmax]]<br />
| class="none" | No<br />
| Polygons<br />
| class="none" | No<br />
| class="done" | Yes<br />
| class="none" | No<br />
| Abandoned (2005)<br />
| Freeware version of polygon-based modelling tool 3DsMax. Used by many games but never updated: small bugs exist. May require a registration bypass to work (easily found) as the registration web-form has disappeared.<br />
|-<br />
|}<br />
<br />
'''Brush based''' editors require you to make your maps using [https://en.wikipedia.org/wiki/Constructive_solid_geometry constructive solid geometry] (CSG). Most mapping tutorials for Quake-like games such as Unvanquished follow this method.<br />
<br />
'''Polygon based''' editors give a larger focus on 2D shapes making up 3D ones, which ''can'' be more powerful but is more difficult to teach and learn. These editors generally support 'boolean operations', allowing them to be used like CSG editors, but with more difficulty.</div>Thelionroars