= Mapping for Orxonox - The Tutorial =

This tutorial explains you how to install and configure your GTK-Radiant and Orxonox files to build and implement BSP maps for Orxonox.

== Overview ==
 1. [https://dev.orxonox.net/wiki/MappingForOrxonox#1 Preparation]
 1. [https://dev.orxonox.net/wiki/MappingForOrxonox#2 Installation]
 1. [https://dev.orxonox.net/wiki/MappingForOrxonox#3 Configuration]
 1. [https://dev.orxonox.net/wiki/MappingForOrxonox#4 Implementation]


{{{
#!html
<a name="1"></a>
}}}
== Preparation ==
Make sure, your data repository includes at least the following folders:
{{{
data
  worlds
    baseq3
    · maps
    · textures
}}}

The "baseq3" folder is needed to access our files in GTK-Radiant.[[br]]
The "textures" folder contains all textures you want to use in your map in several subfolders.[[br]]
The "maps" folder contains all map- and bsp-files.[[br]]

The "baseq3" folder must contain the "orxonox_common_textures.pk3" file ([https://dev.orxonox.net/wiki/MappingForOrxonox#common read more]). We need it to include the common-textures like caulk, nodraw or invisible into GTK-Radiant.


{{{
#!html
<a name="2"></a>
}}}
== Installation ==
If you work on a tardis system, you can start GTK-Radiant simply by typing "radiant" into your console and go to [https://dev.orxonox.net/wiki/MappingForOrxonox#3 Configuration].[[br]]
If you work on your personal system, read the following instrucions.

Get the newest version of GTK-Radiant from [http://www.qeradiant.com/ www.qeradiant.com] and start the installation. You can, if you want, uncheck all components except "Quake III Arena Support". We don't need them, we will just use the Q3A support.

Start GTK-Radiant. If you get asked for which game you want to build maps, choose "Quake III Arena". You will be asked where the engine path is. Choose your ...orxonox/data/worlds as path. GTK-Radiant should start now. Continue with the configuration.


{{{
#!html
<a name="3"></a>
}}}
== Configuration ==
Open Edit->Preferences and make the following changes:
{{{
Global
  Game: Disable "Startup: Show Global Preferences"
Interface
  Layout: Choose the third option (four equal areas), disable "Detachable Menus"
Display
  Entities: Enable "Show Light Radii"
Settings
  Undo: Increase the Undo Queue Size to the maximum
  Paths: If you've chosen the wrong path, you can enter your ...orxonox/data/worlds/ path here
  Camera: Disable "Discrete movement"
  Build: Enable "Build Process Monitoring"
}}}
Restart GTK-Radiant to make the changes take effect.

Click on Textures and verify whether at least the "common" textures are available ([https://dev.orxonox.net/wiki/MappingForOrxonox#common read more]).


{{{
#!html
<a name="4"></a>
}}}
== Implementation ==


{{{
#!html
<a name="common"></a>
}}}
== Common textures ==
The "orxonox_common_textures.pk3" package contains several common textures for GTK-Radiant. With them you can realize special things in your maps like invisible walls or cubes without collision.

If you don't have "orxonox_common_textures.pk3" in your ...orxonox/data/worlds/baseq3 folder, download it [https://dev.orxonox.net/attachment/wiki/MappingForOrxonox/orxonox_common_textures.pk3?format=raw here].[[br]]
If you got it, but the textures dont't appear in your texture-list, unzip the package (it's a zip folder) and move the textures in your ...orxonox/data/worlds/baseq3/textures/common folder. Now they should be available in GTK-Radiant.