Mapping-Setup.md

   1 Mapping - Setup
   2 ===============
   3
   4 How to get your system all set up to start mapping
   5 --------------------------------------------------
   6
   7 ### Step 1: Obtain mapping support
   8
   9 If you didn’t already, download the [mapping support zip](http://dl.xonotic.org/xonotic-0.8.2-mappingsupport.zip)
  10
  11 ### Step 2: Extract zip
  12
  13 Extract the zip archive using your favorite archiving tool
  14
  15 ### Step 3: Locate the folder for userdata
  16
  17 Locate your userdata folder, note that this is **NOT** the install location. This is the place xonotic saves your userdata.
  18
  19 -   **Windows**: `C:\users\user\saved games\xonotic\data`
  20 -   **Linux**: `~/.xonotic/data`
  21 -   **Mac**: `~/Library/Application Support/xonotic/data`
  22
  23 This folder has a similar layout as the game folder. Game wise these data folders are treated similarly, however, it is best to save your work in the userdata folder so that you don’t accidentally mess up your Xonotic install, or so that your work doesn’t get lost in an update.
  24
  25 ### Step 4: Moving the mapping support pk3
  26
  27 The mapping support zip contains a file called `xonotic-<timestamp>-maps-mapping.pk3`. Move this file to the userdata folder (see step 3), **NOT** `data/data`.
  28 This folder should also contain your `config.cfg`.
  29
  30 ### Step 5: Get NetRadiant working
  31
  32 -   **Windows**: The mapping support zip contains a compiled version of NetRadiant in the `mapping` folder
  33 -   **Linux**: Linux users need to compile NetRadiant themselves (see [NetRadiant Repo](https://gitlab.com/xonotic/netradiant)) or can download a compiled version [here](http://ingar.intranifty.net/gtkradiant/index.html)
  34 -   **Mac**: Current versions of MacOS/OSX don't seem to work because of gtkglext, compiled versions from [here](http://ingar.intranifty.net/gtkradiant/index.html) might work
  35
  36 ### Step 6: Setting up NetRadiant
  37
  38 When you first start up radiant it may ask where the engine path is. Simply, point it to the xonotic install location. Then NetRadaint should start,and the lower right pane should have lists of texture packs. If there are no texture packs, then refer back to step 4.
  39
  40 \<\< [Introduction](mapping-Introduction) | [NetRadiant](mapping-NetRadiant) \>\>
  41
  42 … [Creating_Maps](Creating-Maps) …
  43