Custom Map Makers Wiki - User contributions [en-gb]

Mapping:What is a patch

2011-12-22T17:43:26Z

Flajeen: /* Tutorial */

== General information ==
{{Info|Way too much tech stuff, doesn't matter for mappers}}
Bezier Patches or "curves" are one type of Parametric Surface.

A parametric surface is a surface with a shape defined by a set of parameters, so the shape of the surface can change depending on the values of the parameters.

For Bezier Patches in Quake 3, the parameter is the LOD, or Level Of Detail.

Patches in Quake 3 are rendered with triangles, so the curves must be 'tessellated' (subdivided) into a number of triangles.

The higher the LOD value, the more the curve is subdivided, and the more triangles are created in tessellation.

The LOD can be set to change with the viewer's distance from the Patch, decreasing as they get further away.

In Q3 "r_lodCurveError" controls how much the LOD changes with distance, and "r_subdivisions" fixes the maximum LOD for all curves.

A Patch is stored as a 2-dimensional matrix of points.

A 2-dimensional matrix is a table containing sets of values arranged in rows and columns.

Each point is stored as two sets of values.

One set contains the XYZ coordinates defining the location of the point in the 3-dimensional volume of the map.

The other set contains the UV coordinates defining the location of that point on the 2-dimensional area of the Shader.

One Patch can only have one Shader, for the same reason one brush face can only have one Shader.

== Creating patches ==
'''Note: By postit, originally posted at [http://www.urtjumpers.com/forum/viewtopic.php?id=595 urtjumpers.com forum]'''

The aim of this tutorial is to guide a mapper in creating curved walls using patches, as pictured below:

[[File:patches_1.jpg|200px]]

Creating a curved wall is about moving vertices into the right positions. I've tried to use pictures more than words to show this.

=== Quarter Circle ===
# In the menu select Curve -> Simple Patch Mesh
# Accept default settings (3 X 3)
# Use x/y/z axis rotate or change view (CTRL+TAB) until you are viewing the patch edge on - it looks like a line.
# Press V to enter Vertex Selection mode. Your screen should look like the image below. The vertices have been numbered. [[File:patches_2.jpg|200px]]
# Drag vertices 3 and 2 as shown below. A quarter circle is achieved. [[File:patches_3.jpg|200px]] [[File:patches_4.jpg|200px]]
# Texture the wall. With the wall selected, press S to bring up the Surface Inspector and select "Natural" in the patch texturing section.

{{Info|If you can't texture the correct side of the patch, you need to invert the matrix: Menu -> Curve -> Matrix -> Invert}}

[[File:patches_5.jpg|200px]]

=== Semi Circle ===
# This time create a 5 X 5 patch mesh. [[File:patches_6.jpg|200px]]
# Move the vertices as shown to create a semi circle. [[File:patches_7.jpg|200px]] [[File:patches_8.jpg|200px]] [[File:patches_9.jpg|200px]] [[File:patches_10.jpg|200px]]
# Texture and voila: [[File:patches_11.jpg|200px]]

=== Go Nuts ===
# Create a 15 x 15 patch mesh. [[File:patches_12.jpg]]
# Arrange vertices to an interesting kidney shape. [[File:patches_13.jpg|200px]]

This gives the result shown in the picture at the top of this tutorial.

[[Category:Mapping]]

Radiant:MacRadiant

2011-12-20T23:26:35Z

Flajeen:

== Installation ==
MacRadiant is a port of the GtkRadiant map editor for OSX, it exists thanks to Eridan. The only pre-requisit is that you have Apple's X11 installed.

You can get the most up to date version of MacRadiant 1.4 [http://ingar.satgnu.net/gtkradiant/index.html#download here]

You'll also need to get the game packs. GtkRadiant supports Quake 3, Star Trek: Elite Force, SOF2, Jedi Knight II: Jedi Outcast, Jedi Knight: Jedi Academy, Wolfenstein: ET.

The original GtkRadiant is in a bundle, containing GtkRadiant 1.4 and GtkRadiant 1.5, can still be downloaded from www.redsaurus.net/macradiant/GtkRadiant_1.4_1.5_Macintosh.dmg , but it requires a PPC mac. It already contains a Packs Installer, but unless you need GtkRadiant 1.5, I recommend getting the most up to date version rather than downloading this.

Don't forget to read the documentation, and happy mapping!

== Issues ==
MacRadiant has some issues in specific OSX versions but there are existing fixes below.

=== Leopard ===
Update X11, get the latest Leopard version from [http://trac.macosforge.org/projects/xquartz here].

Navigate inside your MacRadiant 1.x bundle and locate the "script" file inside Contents/Resources. To open "Contents/Resources", just control-click or right-click on the MacRadiant 1.x icon. A menu should appear. Select "Display content" or something similar and a window should pop up, with a "Contents" folder in it.

Open the "script" file with your favorite text editor and remove the group of lines starting from the line ''<nowiki>### Work around ...etc...</nowiki>'' down to (and including) the line ''<nowiki>export DISPLAY= ...etc...</nowiki>'' Then, you should have, at the end of the file:
''<nowiki>ulimit -n 512 exec "$CWD/sw/ .... etc ....</nowiki>''

Open the terminal and type the the following three lines (in the following, YOURPATH should be replaced by the path to your MacRadiant application bundle. The commands are separed with semicolon <nowiki>(;)</nowiki>, that means that it is a different line: ''<nowiki>cd "YOURPATH/MacRadiant 1.4.app/Contents/Resources/sw/lib"</nowiki>''; ''<nowiki>mv libiconv.2.dylib libiconv.2.dylib.orig</nowiki>''; ''<nowiki>ln -s /usr/lib/libiconv.dylib libiconv.2.dylib</nowiki>''

=== Snow Leopard ===
Make all the changes above, skip the X11 updating, it isn't needed.

Open the terminal and go to the lib folder inside the MacRadiant bundle by entering the following line: ''<nowiki>cd "/Applications/MacRadiant 1.4.app/Contents/Resources/sw/lib"</nowiki>''. If MacRadiant is not located in the Applications folder, change the beginning of the preceding line accordingly.

Type the following lines and press the return key (the commands are separed with semicolon <nowiki>(;)</nowiki>, that means that it is a different line): ''<nowiki>rm libxml2.2.dylib</nowiki>''; ''<nowiki>ln -s /usr/lib/libxml2.2.dylib libxml2.2.dylib</nowiki>''

[[Category:Radiant]]

Radiant:MacRadiant

2011-12-20T23:05:33Z

Flajeen: /* Installation */

== Installation ==

MacRadiant is a port of the GtkRadiant map editor for the Idtech 3 and 4 engine. It exists thanks to Eridan. The only pre-requisit is that you have Apple's X11 to use it

=== Getting MacRadiant ===

You can get the most up to date version of MacRadiant 1.4 at [http://ingar.satgnu.net/gtkradiant/index.html#download http://ingar.satgnu.net/gtkradiant/index.html#download]

You'll also need to get the game packs. GtkRadiant supports Quake 3, Star Trek: Elite Force, SOF2, Jedi Knight II: Jedi Outcast, Jedi Knight: Jedi Academy, Wolfenstein: ET.

The original GtkRadiant is in a bundle, containing GtkRadiant 1.4 and GtkRadiant 1.5, can still be downloaded from www.redsaurus.net/macradiant/GtkRadiant_1.4_1.5_Macintosh.dmg , but it requires a PPC mac. It already contains a Packs Installer, but unless you need GtkRadiant 1.5, I recommend getting the most up to date version rather than downloading this.

Don't forget to read the documentation, and happy mapping!

=== Problems with Leopard and Snow Leopard ===

MacRadiant has some problems with Leopard and Snow Leopard, but you can work around them as follows (taken from Eridan's posts on the forum): Leopard

*First, you need to update X11. Get the latest Leopard version from trac.macosforge.org/projects/xquartz
*Navigate inside your MacRadiant 1.x bundle and locate the "script" file inside Contents/Resources. To open "Contents/Resources", just control-click or right-click on the MacRadiant 1.x icon. A menu should appear. Select "Display content" or something similar and a window should pop up, with a "Contents" folder in it. Open the "script" file with your favorite text editor and remove the group of lines starting from the line

###Work around ...etc...

down to (and including) the line export DISPLAY= ...etc... (15 lines in all I think). Then, you should have, at the end of the file : ulimit -n 512 exec "$CWD/sw/ .... etc ....

*Fire up the Terminal application (in /Applications/Utilities/) and type the the following three lines (in the following, YOURPATH should be replaced by the path to your MacRadiant application bundle; don't forget to press the RETURN key at the end of each line) :

cd "YOURPATH/MacRadiant 1.4.app/Contents/Resources/sw/lib"
mv libiconv.2.dylib libiconv.2.dylib.orig
ln -s /usr/lib/libiconv.dylib libiconv.2.dylib

=== Snow Leopard ===

*Make the changes as for Leopard - note you don't need to update X11 though.
*Fire the Terminal application
*Go to the lib folder inside the MacRadiant bundle by entering the following line (press the return key at the end)

cd "/Applications/MacRadiant 1.4.app/Contents/Resources/sw/lib"

(If MacRadiant is not located in the Applications folder, change the beginning of the preceding line accordingly)

*Type the following line and press the return key :

rm libxml2.2.dylib

*Type the following line and press the return key :

ln -s /usr/lib/libxml2.2.dylib libxml2.2.dylib

If you still have problems, make a post on the forums.

Original topic from www.redsaurus.net

 [[Category:Radiant]]

Mapping:Brushwork

2011-12-20T23:02:13Z

Flajeen: /* Preface */

{{Stub}}
== Brushes ==
To understand the concept of brushes, please take a look at this: [[Mapping:What is a brush]]

== Complex brushes ==
A few sites and tools exist to help mappers on the creation of complex shapes.

* [http://mapgen.nerius.com/ Rambetter's Surface Generators]
* [http://www.custommapmakers.org/storage/download/q3stairgen.zip Drewfin's stair, arch and hole creator] Check out the topic of this utility on [http://www.urbanterror.info/forums/topic/23045-circular-stairway-tool/page__view__findpost__p__279840 Urban Terror forums]

This last tool works under Windows (pre-requirements are that you have .NET framework 2.0 installed) and under Linux using the utility Wine.

[[Category:Mapping]]

Mapping:Brushwork

2011-12-20T23:01:31Z

Flajeen: /* Automation */

{{Stub}}
== Preface ==
To understand the concept of brushes, please take a look at [[Mapping:What is a brush]]
== Complex brushes ==
A few sites and tools exist to help mappers on the creation of complex shapes.

* [http://mapgen.nerius.com/ Rambetter's Surface Generators]
* [http://www.custommapmakers.org/storage/download/q3stairgen.zip Drewfin's stair, arch and hole creator] Check out the topic of this utility on [http://www.urbanterror.info/forums/topic/23045-circular-stairway-tool/page__view__findpost__p__279840 Urban Terror forums]

This last tool works under Windows (pre-requirements are that you have .NET framework 2.0 installed) and under Linux using the utility Wine.

[[Category:Mapping]]

Main Page

2011-12-20T22:57:52Z

Flajeen: /* Beginning */

__NOTOC__
== Introduction ==
Welcome to the '''Custom Map Makers wiki''' - a repository for all information relating to mapping for the popular first person shooter [http://www.urbanterror.info/ Urban Terror].

If you feel you'd like to contribute to this wiki, please email '''john@custommapmakers.org''' for more information.

The wiki is divided into the following sections, each of these contains further sub-topics. You can also search the wiki using the search box on the top.

{{Info|The wiki also has a collection of '''[[tutorials]]''' and '''[[tools]]''' gathered from the Internet and donated by experienced mappers.}}
== Beginning ==
{| cellspacing="5" width="100%"

|
{{RyMainPageBox|radiant.png|[[:Category:Radiant|Radiant]]|
* [[Radiant:MacRadiant|Installing MacRadiant]]
* [[Radiant:ZeroRadiant|Installing ZeroRadiant (GtkRadiant 1.6.0)]]
* [[Radiant:NetRadiant|Installing NetRadiant]]
* [[Radiant:Using|Using Radiant]]
* [[Radiant:Shortcuts_And_Menu_Options|Keyboard shortcuts/menu options]]
|HEIGHT=200px}}

|
{{RyMainPageBox|mapping.png|[[:Category:Mapping|Mapping]]|
* [[Mapping:Brushwork|Brushes]]
* [[Mapping:VIS|VIS]]
* [[Mapping:What is a patch|Patch Meshes]]
* [[:Category:Models|Models]]
* [[Mapping:Sky|Sky]]
* [[Mapping:Terrain|Terrain]]
* [[Compiling:Healthy_Map|Healthy Map]]
|HEIGHT=200px}}

|
{{RyMainPageBox|textures.png|[[:Category:Textures|Textures]]|
* [[Textures:Texturing|Texturing]]
* [[Textures:Shaders|Shaders]]
* [[Textures:Sites|Resources]]
* [[Textures:Formats|Formats]]
* [[Textures:Advanced Normal Maps Creation|Normal Maps]]
|HEIGHT=200px}}

|-

|
{{RyMainPageBox|lighting.png|[[:Category:Lighting|Lighting]]|
* [[Lighting:General|General]]
* [[Lighting:Leaks|Light leaks]]
* [[Lighting:Painting|Annoying FrankieV (Painting with lights)]]
* [[Lighting:Light Style|Light Style]]
|HEIGHT=176px}}

|
{{RyMainPageBox|entities.png|[[:Category:Entities|Entities]]|
* [[Entities:Func|func_*]]
* [[Entities:Info|info_*]]
* [[Entities:Target|target_*]]
* [[Entities:Trigger|trigger_*]]
* [[Entities:Misc|misc_*]]
* [[Entities:UT|ut_*]]
|HEIGHT=176px}}

|
{{RyMainPageBox|compiling.png|[[:Category:Compiling|Compiling]]|
* [[Compiling:q3map2|q3map2]]
* [[Compiling:Commands|Commands]]
* [[Compiling:Surface sounds|Surface sounds]]
* [[Compiling:Setup|Setup]]
* [[Compiling:Batch Files|Batch Files]]
* [[Compiling:Scripts|Scripts]]
|HEIGHT=176px}}

|}

== Advanced ==

{| cellspacing="5" width="100%"
|-
|
{{RyMainPageBox|packaging.png|[[:Category:Packaging|Packaging]]|
* [[Packaging:Levelshot|Making a levelshot]]
* [[Packaging:Minimap|Making a minimap]]
* [[:Category:Packaging|Packaging]]
|HEIGHT=152px}}

|
{{RyMainPageBox|bots.png|[[:Category:Bots|Bots]]|
* [[Bots:Adding bots to your map|Adding bots]]
* [[Bots:Issues|Issues]]
* [[AI_Misbehaving|Misbehaviour]]
* [[Bots:Advanced|Advanced topics]]
|HEIGHT=152px}}

|
{{RyMainPageBox|urt_hd.png|[[:Category:UrTHD|Urban Terror HD]]|
* [[UrTHD:Setup|Setup]]
* [[UrTHD:Mapping|Mapping]]
* [[UrTHD:Tools|Tools]]
|HEIGHT=152px}}

|
{{RyMainPageBox|layout.png|[[:Category:Layout|Layout]]|
* [[Layout:Level Design|Level design]]
* [[Layout:Bens Bible|Ben's small bible]]
* [[Layout:Dragonne|Dragonne's article]]
|HEIGHT=152px}}

|}

== Further reading ==
{| cellspacing="5" width="100%"

|
{{RyMainPageBox|modelling.png|[[:Category:Models|Modelling]]|
* [[Models:Programs|Programs]]
* [[Models:Exporting|Exporting]]
* [[Models:Texturing|Texturing]]
* [[Models:Resources|Resources]]
|HEIGHT=176px}}

|
{{RyMainPageBox|resources.png|[[:Category:Resources|Resources]]|
* [[Resources:Tips|Tips and tricks]]
* [[:Category:Inspiration|Inspiration]]
* [[Resources:Tools|Tools]]
* [[Resources:Links|Links]]
* [[Sound:Websites|Sound websites]]
* [[IRC|CMM IRC Channel]]
|HEIGHT=176px}}

|
{{RyMainPageBox|funstuff.png|[[:Category:Funstuff|Funstuff]]|
* [[Funstuff:Creating|Creating]]
|HEIGHT=176px}}

|
{{RyMainPageBox|xreal.png|[[:Category:XreaL|XreaL]]|
* [[XreaL:About|About]]
* [[XreaL:Setup|Setup]]
* [[XreaL:Games|Games]]
|HEIGHT=176px}}
|}

Category:Packaging

2011-12-15T15:54:39Z

Flajeen: /* The folders */

Packaging your finished map is the final step in the map making process, it's important to get this stage right.

==Check list==
Before you begin to package your map check the following.

*You've added Surface sounds to your map,if not see [[Compiling:Surface sounds|Surface sounds]]
*You've prepared a levelshot and it's been resized to a value which is a power of 2, 32,64,128,256,512,1024,2048, etc. For more information see [[Packaging:Levelshot|Creating a levelshot]]
*You've created a bot navigation file (.aas). For more information about adding bots see [[Bots:Adding_bots_to_your_map|Adding bots to your map]]
*All images are resized correctly

==The folders==
Personally I always start with clean folder somewhere on my system. In this folder I create the following sub-folders.

env

levelshots
maps
models
mapobjects
mymapmodels
anyothermodels
scripts
sound
mysoundsfolder
textures
mytexturesfolder
video

===env===
Generally sky textures go in this folder, if not used you may omit this folder.

Some mappers put the sky textures in the textures folder, but it doesn't have any benefit at all.

===levelshots===
The image that is displayed while your map is loading. This should have been resized to be 1024x1024 or 2048x2048 and be in .tga or .jpg format.

For more information about creating a levelshot see [[Packaging:Levelshot|Creating a levelshot]]

===maps===
The maps folder should contain the following objects

yourmap.bsp
yourmap.aas
yourmap.rad
yourmap.tga

Of these the .bsp and .tga files are the most important.

====bsp====
Your compiled map file.

====aas====
The bot navigation file, for more information about making bot files see [[Bots:Adding_bots_to_your_map|Adding bots to your map]]

====rad====
The rad file is generated when you've compiled your map with the -radbump switch
====tga====
The mini-map. You can include the standard generated mini-map or with a little effort create a small work of art. For more information about creating stylish minimaps, see [[Packaging:Minimap]]

===models===
The most common mistake when first packing your map is to forget to include the textures/shaders for the models you've added. If you've not used models in your map you can ignore this section.

Models, like those you may have downloaded from blackrayne generally go in the mapobjects sub-folder, you should confirm this by looking at your own mapping configuration. You should include all textures and any licence information, the model maker will sometimes ask you credit his work by including his README file.

Do not distribute the actual models : md3, qc, ase models can be removed before packing your map.

The models are "baked" into your map by the compiler, so the actual models are not needed and take a lot of space when distributed in your map.

===scripts===
The arena file describes your map to the menu system, declares which game modes your map supports and contains a short description of your map which is displayed in the ui.

An example arena file might take the form.

{
map "ut4_yourmapname"
longname "The bestest map that ever lived"
type "ut_ffa ut_team ut_survivor ut_follow ut_cah ut_ctf ut_bomb"
}

You should remove any game modes which your map doesn't support. Game types are

ut_ffa
ut_team
ut_survivor
ut_follow
ut_cah
ut_ctf
ut_bomb
ut_jump - please note : This is gametype 9 (jump mode) and not currently supported.

You need to save the file with the .arena extension

===sound===
Sound effects and music for your map should be placed in your maps folder inside the sound folder.

===textures===
Your map texture folder should be copied to the textures folder. Check and then recheck your image files.

*Remove any original artwork (photoshop and gimp files)
*Check the images sizes, power of 2 only sizes should be used, this includes levelshots
*Convert any non-transparent .tga (targa) files to .jpg - this can save an enormous amount of space

===video===
If your map includes video - place in this folder. Video files for q3 games use the .roq format at the maximum of 256x256 resolution. Videos can be used in shader stages in a similar way to images.

==The readme with credits==
In the course of building your map you will have used textures or models from a 3rd party source. You should at least credit the hard work of those people in some way.

Download and complete the following template to include as readme.txt in the root folder of your map

===Template===
================================================================
Title :
Map Filename :
Filename :
Release Date :
Author(s) :
Email Address :
Description :
Additional Credits to : id Software: For making Q3

Silicon Ice Development/Frozen Sand LLC: For making Urban Terror and so strongly supporting the UT community.

Artwork :
Testers and other :
Contributors :

Info about the Author :
========================================================================
Installation :
========================================================================

* PK3 File Information *

Map(.bsp) Name :
New Textures :
New Sounds :
New Music Track :

* Play Information *

Bot Support :
Deathmatch :
Last Man Standing :
Follow The Leader :
Team Survivor :
Capture The Flag :
Capture and Hold :
Bomb :
Jump mode :

* Construction *

Base :
Editor(s) used :
Other Progs used :
Build Time :
Build Machine :
Compile machine :
Final Compile time :

* Map/Creative Notes *

* Copyright / Permissions *

Authors MAY NOT use this level as a base to build additional
levels, and the geometry CANNOT be changed in any way. If you
wish to recreate this level for another game or mod, please
inform me be e-mail, just so I know it's out there in other
forms, and I might even help. Please retain this text file if you do.

This .pk3 may be distributed over the Internet and/or BBS
systems(like these exist anymore) as long as the ORIGINAL(this)
text file is included in the .zip file.

You may NOT distribute this map/.pk3/.bsp file commercially
without my expressed WRITTEN permission. If you wish to include
this in a compilation of some form, have your people contact my
people and they'll talk, or just send me an e-mail and we'll talk.