diff --git a/docs/mapediting5.xml b/docs/mapediting5.xml index 1c71efbc..0e752fb4 100644 --- a/docs/mapediting5.xml +++ b/docs/mapediting5.xml @@ -1,4 +1,4 @@ - + @@ -33,6 +33,9 @@
  • Custom fog distances and colours
    • +
  • + Changing the angle shadow stencils are drawn +
  • Ambient sounds
    • @@ -216,6 +219,15 @@ To change the colour of the fog, add this command to a single line in your config file: fogcolour X
    Replace X with the appropriate hexadecimal colour code.

    + +

    Changing the angle shadow stencils are drawn

    +

    + Changing the angle at which shadows stencils are drawn can have some nice effects on lighting in your map. + To change the angle, first experiment in the map by typing "/shadowyaw D" (replace "D" + with an angle between 0 and 360). When you have found the appropriate angle you wish to use, simply add the command + shadowyaw D to a single line in your configuration file (replacing "D" + with an angle between 0 and 360). +

    Ambient sounds

    diff --git a/docs/reference.xml b/docs/reference.xml index 0a6d0200..807704ce 100644 --- a/docs/reference.xml +++ b/docs/reference.xml @@ -26,7 +26,7 @@ -

    +
    This section describes identifiers that are closely related to the CubeScript language. @@ -281,7 +281,7 @@
    -
    +
    This section describes general identifiers. @@ -720,7 +720,7 @@
    -
    +
    This section describes gameplay related identifiers. @@ -1073,7 +1073,7 @@
    -
    +
    @@ -1144,21 +1144,6 @@ - - Loads the skybox P - - - The available textures reside in packages/textures/skymaps/.., - to select a given set (of 6 images) you need to pass the full path from "packages/" but only up to the underscore "_". - - - Example: loadsky "textures/skymaps/makke/mountain" - - - - - - Marks the current selection as a heightfield. @@ -1513,51 +1498,6 @@ - - Sets the texture slot to 0 for the subsequent "texture" commands. - - - Binds a texture to the current texture slot. - - - Binds the texture indicated in filename to the current texture slot, then increments the slot number. - This is for use in map configs only. A secondary textures can be specified for a single texture slot, - for use in shaders and other features (unused for now, should be set to 0 to indicate primary texture). - - - - - - - - - - - - Binds a texture to be used if a slot couldn't be loaded with a given path. - - - Binds the texture indicated in filename to the alternative texture slot. - This is for use in map configs only. - The path is given exactly as with the texture-command, if it is omitted (or can't be loaded) the default is used. - The default is located in packages/misc/notexture.jpg (not in packages/textures - where custom ones must reside!) - - - - - loadnotexture // reset to default - - - loadnotexture "makke/black.jpg" // any missing texture will show up black - - - - - - - - - Makes a slope out of the current selection. @@ -1660,22 +1600,6 @@ - - Defines a mapsound. - - - Registers the sound as a map-specific sounds. These map-specific sounds may currently only be used with "sound" entities within a map. The first map sound registered in a map has index 0, and increases afterwards. - - - - - - - - - - - Scales all lights in the map. @@ -1688,7 +1612,7 @@ - + A variable indicating if the game is in editmode. @@ -1710,7 +1634,7 @@
    -
    +
    This section describes identifiers related to the menu gui. @@ -1786,7 +1710,7 @@
    -
    +
    This section describes the identifiers to configure the head-up display (HUD). @@ -1934,7 +1858,7 @@
    -
    +
    This section describes identifiers to configure the visuals. @@ -2156,7 +2080,7 @@
    -
    +
    This section describes all identifiers related to music and sound effects. @@ -2231,7 +2155,7 @@
    -
    +
    This section describes all indentifiers related to the ingame documentation reference. @@ -2412,7 +2336,7 @@
    -
    +
    This section lists commands used by the client that communicate to the server. Most are used for server administration. @@ -2584,7 +2508,7 @@
    -
    +
    @@ -2818,7 +2742,7 @@
    -
    +
    All the below commands are used specifically in map configuration files. Some of these commands can also be used without the need of a map configuration file. @@ -2853,6 +2777,57 @@ + + + Binds a texture to be used if a slot couldn't be loaded with a given textures path. + + + + Binds the texture indicated in the filename to the texture slot of any textures that aren't found. + The path is given exactly as with the texture-command, if it is omitted (or can't be loaded) the default is used. + The default is located in packages/misc/notexture.jpg (not in packages/textures - where custom ones must reside!) + + + + + loadnotexture // Reset to default + + + loadnotexture "makke/black.jpg" // Any missing texture will show up black + + + + + + + + + + + + + Loads a skymap for a map. + + + The available skymaps reside in packages/textures/skymaps/.. + + + To select a skymap you need to use the full path from "packages/" + but only up to the underscore "_" in the filename. + + + + + + + + + loadsky "textures/skymaps/makke/mountain" + + + + + Registers a mapmodel that can be placed in maps. @@ -2881,7 +2856,7 @@ - Resets the mapmodel slots/indices to 0. + Resets the mapmodel slots/indices to 0 for the subsequent "mapmodel" commands. Each subsequent mapmodel command increases it again. See config/default_map_settings.cfg for an example. @@ -2889,38 +2864,95 @@ + + + + Defines a mapsound. + + + Registers the sound as a map-specific sound. These map-specific sounds may currently + only be used with "sound" entities within a map. The first map sound registered in a map has slot/index number 0 + and increases afterwards. + + + + + + + + + + - + - Shadow yaw specifies the angle at which shadow stencils are drawn on a map. The default angle is 45 degrees. - When specifying shadowyaw, remember that the angle will be added with the default 45 degrees. The example below - would make the shadows appear at 90 degrees. + Shadow yaw specifies the angle at which shadow stencils are drawn on a map. - shadowyaw 45 + shadowyaw 90 - + + + + When specifying shadowyaw, remember that the default angle is 45 degrees. The example below + would make the shadows appear at 90 degrees (45 degrees more to the left). + + + + Binds a texture to the current texture slot. + + + Binds the texture indicated in the filename to the current texture slot and increments the slot number. + + + + + + + + + + + + + + Sets the texture slots/indicies to 0 for the subsequent "texture" commands. + + Each subsequent texture command increases it again. See config/default_map_settings.cfg for an example. + + + + + + Determines the water colour in a map. - - - + + + + + + You must define all 3 values, otherwise this command may not work + correctly (use "1" as a placeholder if needed). + +