assaultcube-/docs/mapediting2.xml

<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<?xml-stylesheet type="text/xsl" href="transformations/cubedoc2xhtml.xslt"?>

<html xmlns="http://www.w3.org/1999/xhtml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" lang="en" xml:lang="en">
  <head><title>Map editing: Beginners</title></head>
  <body>
    <h1>Map editing: Beginners</h1>
    <p>
      Prior to reading this, please learn the controls and interface <a href="mapediting1.xml">here</a>.
    </p>
    <p> 
      To begin map editing, while in AssaultCube, press the letter <b>E</b> which toggles editmode. AssaultCubes map editor is built into the client,
      so its easy to learn and you don't need to download any special tools to get started. 
      <br />Note: Because of how the <a href="cubeengine.xml">cube engine works</a> there are some limitations to what you can create, but 
      there are also some clever work-arounds you can use to get what you want.
    </p>
    <p>
      In editmode (<b>press E</b>) you can fly around in any direction you 
      like and you can even go through walls. <br />This is to make map-editing easier...
    </p>
    <p>
      <b>Tip:</b> When editing a map, make sure you have your settings set back to the defaults, so you can see what your map looks like to the
      average player (example: set gamma back to 100, so you can judge lighting correctly).
    </p>

    <h2 id="startmap">Starting, saving and loading a map</h2>
    <p>
      If you would like to start creating a new map, type: <i>/newmap</i> and then the size you would like (7 is the sensible default) and 
      then press ENTER. If you made your mapsize too small, you can easily make it double in size, simply by typing <i>/mapenlarge</i>.
    </p>
    <p>
      You can save your map at any time by typing: <i>/savemap</i> and then the name you would like it saved as. The map gets
      saved in the <i>packages/maps</i> directory. Save your map often, to avoid the frustration of losing all of your work if something goes wrong.
    </p>
    <p>
      <b>Note:</b> Make sure when you start a map, to use the <i>/newmap</i> command, rather than editing an existing map, otherwise your map may get saved
      a bit strangely. Also note: you cannot put spaces or any illegal characters in the name you wish to save it as.
    </p>
    <p>
      To load your map, type /map and the file name you chose for your map. If you have not placed lighting in your map yet, your map will turn up dark. 
      To temporarily fix this problem, type: <i>/fullbright 1</i>  - this will fill your whole map with light. The fullbright command only works in edit
      mode and is not a permanent fix. To remove fullbright mode, reload the map, or type: <i>/recalc</i>. 
      Note: Fullbright can be turned on/off in the lighting menu (press <b>L</b>).
    </p>

    <h2>Manipulating geometry</h2>
    <p>
      The ceiling and floor of AssaultCube are made up of individual cubes, which can be made into various objects that you choose, such as walls, 
      by simply manipulating the geometry.
    </p>
    <p>
      There are five different ways to manipulate geometry:
      <ul>
        <li>
          Make cubes "solid".
        </li>
        <li>
          Make cubes "space".
        </li>
        <li>
          Move cubes in the floor.
        </li>
        <li>
          Move cubes in the ceiling.
        </li>
        <li>
          Manipulate cubes by using heightfields (a bit more complex, so this is covered later).
        </li>
      </ul>
    </p>
    <h3>Solids and spaces</h3>
    <p>
      The reason we are covering solids and spaces, before moving cubes, is because solids block visibility and do not need to be rendered, so they 
      are more efficient to use in maps. The use of solids in a map is <u>essential</u> to creating a good map. Without solids AssaultCube maps would 
      lag too much for the average user and would be unplayable, so make sure you use enough. Solids are also easy to create and can be used to make 
      wall with a single keystroke!
    </p>
    <ul>
      <li>
        To make a cube into a solid wall, press <b>F</b>.
      </li>
      <li>
        To make a solid wall turn back into space, select it and press <b>G</b>.
      </li>
    </ul>
    <h3>Moving cubes</h3>
    <p>
      Moving cubes is simple and can be done, either with your mouse or keyboard...
    </p>
    <ul>
      <li>
        Using your mouse
        <p>
          Using your scroll wheel, move it backward/forward to lower/raise cubes. 
          Be sure to look in the direction of the cubes you want to move to raise/lower those cubes.
        </p>
      </li>
      <li>
        Using your keyboard
        <p>
          To move cubes in the floor, press <b>[</b> to raise them and <b>]</b> to lower them.<br />
          To move cubes in the ceiling, press <b>P</b> to raise them and <b>O</b> to lower them.
        </p>
      </li>
    </ul>

    <h2>Textures</h2>
    <p>
      There are four different parts of the cube world that you can change textures on (see below)...
    </p>      
    <table>
      <tr>
        <td width="100">
          <u><b>Cubes</b></u>
        </td>
        <td width="140">
          <b><u>Browse forwards</u></b>
        </td>
        <td width="140">
          <b><u>Browse backwards</u></b>
        </td>
      </tr>
      <tr>
        <td>
          <b>Floor</b>
        </td>
        <td>
          Insert
        </td>
        <td>
          Delete
        </td>
      </tr>
      <tr>
        <td>
          <b>Ceiling</b>
        </td>
        <td>
          Page up
        </td>
        <td>
          Page down
        </td>
      </tr>
      <tr>
        <td>
          <b>Wall</b>
        </td>
        <td>
          Home
        </td>
        <td>
          End
        </td>
      </tr>
      <tr>
        <td>
          <b>Upper-Wall</b>
        </td>
        <td>
          Number pad 7
        </td>
        <td>
          Number pad 4
        </td>
      </tr>
    </table>
      
    <p>
      There is 1 key allocated to move forwards through the textures for each of these and one key to move backwards. When selecting textures, 
      the AssaultCube engine automatically puts the last chosen texture at the start of the list, so commonly used textures become easier to find.
      <br />Note: The "upper-wall" the the sides of the wall that protrudes from the ceiling.
    </p>  
    
    
    
    
    <h2 id="co-op">Co-operative map editing</h2>
    <p>
      Co-operative map editing lets you build and modify maps with others easily. This mode allows you to edit maps online with other players
      who could help speed up repetitive or boring tasks, bring in fresh ideas or spot errors you may have missed.
    </p>
    <p>
      To start co-operative map editing, when in a server, type: <i>/mode 1</i> and then type: <i>/map</i> and then your mapnames name and press ENTER.
      You will have to of made a "newmap" previous to entering the server to be able to co-op edit it.
    </p>
    <p>
      You will then need to <b>send</b> the map. You can do this by typing: <i>/sendmap</i> and then your mapnames name and press ENTER. Note: Custom 
      materials can't be sent, they will have to be downloaded another way if you are using them. If you are using a custom "cfg" file, it will automatically
      be sent with the map, if there is a cfg file present.
    </p>
    <p>
      Note: Some useful editing commands can't be used in co-op editing, such as: copy, paste, slope, arch, undo, etc.
    </p>
  </body>
</html>