]> de.git.xonotic.org Git - xonotic/xonotic.wiki.git/blobdiff - Old_Creating_Maps.md
textile to gh-markdown (pandoc conversion)
[xonotic/xonotic.wiki.git] / Old_Creating_Maps.md
index 53457f2a2850028b1f661afdd62c86af69816c15..648b7e79c21ac849800132a3442ac3cd9c6e9519 100644 (file)
-h1. Old Creating Maps
+Old Creating Maps
+=================
 
-*!! this page has been replaced ... I left this hear for archival purposes ... and if my page ins't good enough for you 
--- hutty --*
+**![]() this page has been replaced … I left this hear for archival purposes … and if my page ins’t good enough for you
+— hutty —**
 
+Introduction
+------------
 
-h2. Introduction
+Creating maps requires the [[Netradiant]], a gtkradiant based mapping program that generates .bsp files compiled by q3map2. It helps to have a [[well packaged map]] while reading through this article.
 
-Creating maps requires the [[Netradiant]], a gtkradiant based mapping program that generates .bsp files compiled by q3map2.  It helps to have a [[well packaged map]] while reading through this article.
+Using Netradiant
+----------------
 
-h2. Using Netradiant
+NetRadiant is a fork of the popular Quake-based game editor, GtkRadiant, if you have familiarity with that software or another derivative of it, this For more information and more in-depth specifics, refer to the [[Netradiant]] page.
 
-NetRadiant is a fork of the popular Quake-based game editor, GtkRadiant, if you have familiarity with that software or another derivative of it, this  For more information and more in-depth specifics, refer to the [[Netradiant]] page.
+### Compiling from Source
 
-h3. Compiling from Source
+NetRadiant is included with the git checkout from the [[Repository Access|repository]]. On a Linux/UNIX system, the basic technique for building is to change to your **./xonotic/netradiant** directory and use ‘make’ to compile it. Resolve any dependencies. The binary file is located in **./xonotic/netradiant/install**, ‘radiant.x86’.
 
-NetRadiant is included with the git checkout from the [[Repository Access|repository]]. On a Linux/UNIX system, the basic technique for building is to change to your *./xonotic/netradiant* directory and use 'make' to compile it.  Resolve any dependencies.  The binary file is located in *./xonotic/netradiant/install*, 'radiant.x86'.
+*directions to compile on windows (TODO?)*
 
-_directions to compile on windows (TODO?)_
-
-h3. Builds
+### Builds
 
 http://www.icculus.org/netradiant/files/
 
-h2. Map Packages
+Map Packages
+------------
 
-Maps are packaged as a .zip file with a .pk3 extension.  They can be opened with any program that opens zip files.  The pk3 gets loaded when you start the game, [[Xonotic]].  The engine, [[Darkplaces]] reads pk3 files as it would a normal files system.  You can thus create a pk3 package with any files that the engine can normally read.  (needs well packaged map example pk3)
+Maps are packaged as a .zip file with a .pk3 extension. They can be opened with any program that opens zip files. The pk3 gets loaded when you start the game, [[Xonotic]]. The engine, [[Darkplaces]] reads pk3 files as it would a normal files system. You can thus create a pk3 package with any files that the engine can normally read. (needs well packaged map example pk3)
 
-h3. Package Design
+### Package Design
 
-h4. Naming Conventions
+#### Naming Conventions
 
-<mapname> should be alpha-numeric, lowercase with dashes, periods and underscores only,([a-z0-9-_.]+).pk3 -- preferably they are suffixed with a version and revision.  Following this convention will yield better results from scripts that use this format to help distribute your map.
+<mapname> should be alpha-numeric, lowercase with dashes, periods and underscores only,([a-z0-9-\_.]+).pk3 — preferably they are suffixed with a version and revision. Following this convention will yield better results from scripts that use this format to help distribute your map.
 
-h4. Required Files
+#### Required Files
 
 maps/<mapname>.bsp - This is your compiled map file
-maps/<mapname>.map - This is an open-source game, help others learn.  This file is required to be in the game.
+maps/<mapname>.map - This is an open-source game, help others learn. This file is required to be in the game.
 maps/<mapname>.mapinfo - This file has the meta information, global music track, gametype(s) and game settings
-maps/<mapname>.tga|png|jpg - This file is a screenshot of your map.  If you don't include this, you map doesn't have a picture in the menu or the voting screen for servers and angels cry.
-maps/<mapname>.waypoints - This is required to be added to the game, it's for bot [[adding waypoints|waypoints]
-maps/gfx/<mapname>_mini.tga|png|jpg - This is required to be added to the game, it's a radar of the map.  These can be generated with the command "<".
+maps/<mapname>.tga|png|jpg - This file is a screenshot of your map. If you don’t include this, you map doesn’t have a picture in the menu or the voting screen for servers and angels cry.
+maps/<mapname>.waypoints - This is required to be added to the game, its for bot [[adding waypoints|waypoints]
+maps/gfx/<mapname>\_mini.tga|png|jpg - This is required to be added to the game, it’s a radar of the map. These can be generated with the command “\<”.
 
-h4. Optional/Suggested Files
+#### Optional/Suggested Files
 
 This is not an exhaustive list, remember, you can include almost any file that loads with a map. (needs list of files)
 
-h4. Files You Should Never Include
+#### Files You Should Never Include
 
 csprogs.dat
 progs.dat
 effectsinfo.txt
 
-By including any of the files above, you could cause undesired results.  Try and use common sense about how you're adding dimension to your map, if you have questions, ask for help.
+By including any of the files above, you could cause undesired results. Try and use common sense about how you’re adding dimension to your map, if you have questions, ask for help.
 
-h2. Examples
+Examples
+--------
 
-maps/tutorial-world-v1_r2.bsp
-maps/tutorial-world-v1_r2.map
-maps/tutorial-world-v1_r2.mapinfo
-maps/tutorial-world-v1_r2.png
-maps/tutorial-world-v1_r2.waypoints
-maps/gfx/tutorial-world-v1_r2_mini.png
+maps/tutorial-world-v1\_r2.bsp
+maps/tutorial-world-v1\_r2.map
+maps/tutorial-world-v1\_r2.mapinfo
+maps/tutorial-world-v1\_r2.png
+maps/tutorial-world-v1\_r2.waypoints
+maps/gfx/tutorial-world-v1\_r2\_mini.png
 maps/models/tutorial-world/crate.md3
 maps/models/tutorial-world/jumppad.md3
 scripts/tutorial-world/map-tutorial-world.shader
 maps/sound/cdtracks/tutorial-world/main-room.ogg
 maps/sound/tutorial-world/jumppad.ogg
 maps/sound/tutorial-world/wind.ogg
-maps/textures/tutorial-world/base_1.tga
-maps/textures/tutorial-world/floor_1.tga
-maps/textures/tutorial-world/floor_2.tga
-maps/textures/tutorial-world/floor_1.tga
-maps/textures/tutorial-world/wall_1.tga
-maps/textures/tutorial-world/wall_2.tga
+maps/textures/tutorial-world/base\_1.tga
+maps/textures/tutorial-world/floor\_1.tga
+maps/textures/tutorial-world/floor\_2.tga
+maps/textures/tutorial-world/floor\_1.tga
+maps/textures/tutorial-world/wall\_1.tga
+maps/textures/tutorial-world/wall\_2.tga
 
-_add a well packaged map_
+*add a well packaged map*
 
-h2. Testing Maps
+Testing Maps
+------------
 
-You can compile your map locally or on the build server.  The build server (requires [[Repository Access]]) requires a <mapname>.mapoptions file. For more info check ask in #xonotic.editing on irc.quakenet.org
+You can compile your map locally or on the build server. The build server (requires [[Repository Access]]) requires a <mapname>.mapoptions file. For more info check ask in \#xonotic.editing on irc.quakenet.org
 
-h2. Maps on Servers
+Maps on Servers
+---------------
 
-Find a server admin to add your map.  (this section needs work)
+Find a server admin to add your map. (this section needs work)
 
-h2. Map Repositories
+Map Repositories
+----------------
 
-_*Maps must be properly packaged to be included in a repository*_
+***Maps must be properly packaged to be included in a repository***
 
 An official map repository is in the planning stages, please check back later or find help on IRC.
 
+Help
+----
 
-h2. Help
-
-#xonotic.editing on irc.quakenet.org
+\#xonotic.editing on irc.quakenet.org
 http://forums.xonotic.org
 
 [[Création de cartes|Français]]
 
-<< [[Creating_Maps]]
+\<\< [[Creating\_Maps]]
+