diff --git a/compiling.txt b/compiling.txt index b0c6213..e63f319 100644 --- a/compiling.txt +++ b/compiling.txt @@ -2,18 +2,23 @@ This plugin has a command for dumping detailed version info (zr_version) based on info from a automatically generated file (hgversion.h.inc). There's a script that generate this file and must be executed every time before -compiling. Currently there's only a linux version of that script: +compiling: updateversion.sh + updateversion.bat (Executes updateversion.sh using Cygwin) -Mercurial must be installed for this script to work. Use the makefile to -compile since that one will do most of the work. Make sure you clean any -existing builds before compiling: +Mercurial (or TortoiseHG) must be installed for this script to work. Use the +makefile to compile since that one will do most of the work. Make sure you +clean any existing builds before compiling: make clean make -If you're compiling on windows, there's an option to disable this feature. In +For compiling on windows, run: + + compile.bat + +If you don't have Mercurial, there's an option to disable this feature. In zombiereloaded.sp there's a line like this: #define ADD_VERSION_INFO 1 diff --git a/cstrike/cfg/sourcemod/zombiereloaded/zombiereloaded.cfg b/cstrike/cfg/sourcemod/zombiereloaded/zombiereloaded.cfg index 97e8d28..21d3076 100644 --- a/cstrike/cfg/sourcemod/zombiereloaded/zombiereloaded.cfg +++ b/cstrike/cfg/sourcemod/zombiereloaded/zombiereloaded.cfg @@ -168,7 +168,7 @@ zr_classes_change_timelimit "20" // Default: "1" zr_classes_save "1" -// Admin class assigned to admins on connect. ["random" = Random admin class | "" = Class config default] +// (Incomplete) Admin-mode class assigned to admins on connect. Do not confuse this with admin-only classes. ["random" = Random admin class | "" = Class config default] // Default: "random" zr_classes_default_admin "random" diff --git a/docs/images/zm_crazys_warehouse_be4_anticamp.jpg b/docs/images/zm_crazys_warehouse_be4_anticamp.jpg new file mode 100644 index 0000000..a0cdd20 Binary files /dev/null and b/docs/images/zm_crazys_warehouse_be4_anticamp.jpg differ diff --git a/docs/zr.css b/docs/zr.css index eba7aae..3caf27b 100644 --- a/docs/zr.css +++ b/docs/zr.css @@ -6,7 +6,7 @@ h1 h2 { - font-family: "Courier New", "Verdana" "Arial"; + font-family: "Courier New", "Verdana", "Arial"; font-size: larger; color: #900000; border-bottom-style: solid; @@ -62,6 +62,13 @@ p.headerinfo color: #000000; } +.imagetext +{ + font-family: "Arial", "Times"; + font-size: x-small; + color: #000000; +} + table { border-style: none; @@ -103,19 +110,33 @@ th border-bottom-width: 2px; } -th.namewidth +.namewidth { - width: "400px"; + width: 200px; } -th.tinywidth +.tinywidth { - width: "100px"; + width: 75px; } -th.mediumwidth +.mediumwidth { - width: "200px"; + width: 150px; +} + +td.parameter +{ + font-family: "Courier New", "Lucida Console"; + color: #000000; + width: 150px; +} + +td.valueoption +{ + font-family: "Courier New", "Lucida Console"; + color: #000000; + width: 125px; } .container @@ -124,3 +145,15 @@ th.mediumwidth margin-right: auto; width: 700px; } + +img +{ + border-style: solid; + border-color: #000000; + border-width: thin; +} + +img.noborder +{ + border-style: none; +} diff --git a/docs/zr_manual.htm b/docs/zr_manual.htm index e4ab2d4..f46ffca 100644 --- a/docs/zr_manual.htm +++ b/docs/zr_manual.htm @@ -14,7 +14,7 @@

Targets plugin version 3.0.0 Beta 2, (not released)
Written by Richard Helgeby

-

Manual last modified: 2009.10.14

+

Manual last modified: 2009.10.20

Index

@@ -112,10 +112,11 @@ Written by Richard Helgeby

  • Volumetric Feature Configuration
      -
    1. volume Attributes
    2. -
    3. Feature Attributes
    4. -
    5. Anti-Camp
    6. -
    7. Class Editor
    8. +
    9. Creating A Volume
    10. +
    11. Volume Attributes
    12. +
    13. Volume Commands
    14. +
    15. Anti-Camp
    16. +
    17. Class Editor
  • @@ -165,6 +166,7 @@ Written by Richard Helgeby

  • Startup
  • Error and Warning Messages
  • Common Problems
  • +
  • Known Issues
  • @@ -275,7 +277,7 @@ round starts there sould be some messages at the chat with "[ZR]". Or type "!zme bring up the zombie menu to confirm that the plugin is running.

    Next check error logs from SourceMod and look if there are any entries from "zombiereloaded.smx". -If the plugin doesn't work at all or there are error logs, see Troubleshooting (5).

    +If the plugin doesn't work at all or there are errors logged, see Troubleshooting (5).

    3. Configuration

    @@ -316,11 +318,11 @@ written the command replies with some info about the syntax.

    Examples:

    zr_somecommand <number>
    - zr_infect <target>

    + zr_infect <target>

    Usage examples:

    zr_somecommand 100
    - zr_infect "unnamed"

    + zr_infect "unnamed"

    3. Multiple Options In The Same Parameter

    @@ -333,8 +335,8 @@ separated by a "|" symbol. Only one of the options listed is used in a command.<

    Usage examples:

    zr_do_something 1
    - zr_do_something "all"
    - zr_do_something "unnamed"

    + zr_do_something "all"
    + zr_do_something "unnamed"

    4. Text As Parameters

    @@ -343,7 +345,7 @@ do this on all string parameters to avoid parsing mistakes.

    Example:

    zr_infect "unnamed" "player"
    - zr_do_something "example text. test."

    + zr_do_something "example text. test."

    Example of bad usage:

    zr_do_something example text. test.

    @@ -357,40 +359,40 @@ results and is an example of why strings should be quoted.

    - + - + - + - + - + - + - + - + - +
    Type:Type: File:
    Main conf.cfg/sourcemod/zombiereloaded/zombiereloaded.cfgcfg/sourcemod/zombiereloaded/zombiereloaded.cfg
    Map config.cfg/sourcemod/zombiereloaded/<mapname>.cfgcfg/sourcemod/zombiereloaded/<mapname>.cfg
    Post map conf.cfg/sourcemod/zombiereloaded/<mapname>.post.cfgcfg/sourcemod/zombiereloaded/<mapname>.post.cfg
    Hitgroup conf.addons/sourcemod/configs/zr/hitgroups.txtaddons/sourcemod/configs/zr/hitgroups.txt
    Class conf.addons/sourcemod/configs/zr/playerclasses.txtaddons/sourcemod/configs/zr/playerclasses.txt
    Weapon conf.addons/sourcemod/configs/zr/weapons.txtaddons/sourcemod/configs/zr/weapons.txt
    Download listaddons/sourcemod/configs/zr/downloads.txtaddons/sourcemod/configs/zr/downloads.txt
    Model listaddons/sourcemod/configs/zr/models.txtaddons/sourcemod/configs/zr/models.txt
    @@ -521,8 +523,8 @@ configuration file.

    List Of Modules (3.3.2).

    Parameters:

    - - + +
    moduleName of the module to add.
    modulesAdditional modules to add.
    moduleName of the module to add.
    modulesAdditional modules to add.
    @@ -536,8 +538,8 @@ configuration file.

    List Of Modules (3.3.2).

    Parameters:

    - - + +
    moduleName of the module to remove.
    modulesAdditional modules to remove.
    moduleName of the module to remove.
    modulesAdditional modules to remove.
    @@ -548,7 +550,6 @@ configuration file.

    Lists current log flag settings and module filtering settings.

    -

    Parameters:

    @@ -627,79 +628,79 @@ unit converter like below can also be used.

    - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - +
    Short name:Short name: Description:
    accountaccount Money manager
    antistickantistick Anti-Stick feature
    configconfig Configuration file manager
    cvarscvars Console variables
    damagedamage Damage manager
    downloadsdownloads File download manager
    hitgroupshitgroups Hit group feature
    infectinfect Infection manager
    modelsmodels Model list file manager
    playerclassesplayerclasses Class manager
    veffectsveffects Visual effect manager
    seffectsseffects Sound effect manager
    toolstools Helper functions (offsets)
    volfeaturesvolfeatures Volumetric features
    weaponsweapons Weapon manager
    weaponrestrictweaponrestrict Weapon restriction manager
    zspawnzspawn Spawn command manager
    zteleztele Teleport manager
    @@ -709,8 +710,8 @@ unit converter like below can also be used.

    Configuration files for each map is supported. They're executed after the main configuration files are executed, and are ideal for customizing map settings. These files are just regular -configuration files and can also have standard console commands like setting map time. These files -are optional.

    +configuration files and can also have standard console commands like setting map time. Map +configuration files are optional.

    The main purpose of these files is to make it possible to change settings for Zombie:Reloaded on certain maps. That could be scaling knockback, restricting certain weapons, changing class @@ -718,9 +719,9 @@ attributes or changing ambience sound.

    1. Types

    There are two kinds of map configs; pre and post. Pre map configuration files are executed -before the modules are loaded. They're useful for changing configuration sets for certain modules -like classes. Post map configuration files are executed after the modules are loaded. Certain stuff -have to be placed in this one to be effective, like changing class attributes.

    +before the modules and data is loaded. They're useful for changing configuration sets for certain +modules like classes. Post map configuration files are executed after the modules are loaded. Certain +stuff have to be placed in this one to be effective, like changing class attributes.

    @@ -730,7 +731,7 @@ have to be placed in this one to be effective, like changing class attributes. - + @@ -767,19 +768,19 @@ specified it's treated as a regular public model.

    PreBefore modulesBefore modules and data loading cfg/sourcemod/zombiereloaded/<mapname>.cfg
    - + - + - + - +
    adminonlyadminonly Can only be used by admins.
    donatordonator Can only be used by donators.
    hiddenhidden Is not included in random selections.
    motherzombiemotherzombie Can only be used on mother zombies.
    @@ -831,7 +832,7 @@ player depending on console variables and the class file.

    Admin-mode classes are currently incomplete and will be validated, but ignored in the game. This is a special mode in the game, but not the same as admin-only classes. To get admin-only classes set -the admin-only flag in the "flags" attribute.

    +the admin-only flag in the flags attribute.

    2. Class Attributes

    @@ -867,15 +868,15 @@ the admin-only flag in the "flags" attribute.

    menus, so only zombies can use zombie class types, and only humans can use human class types. These are the allowed team IDs:

    - - - + + +
    0Zombie classes
    1Human classes
    2Admin-mode classes
    0Zombie classes
    1Human classes
    2Admin-mode classes

    The admin-mode class type sets the player in spectacting like mode, but allow admins to walk around. They can't take or give damage, and they won't affect the game rules in any way. Admin-mode is incomplete and classes of this type is ignored in the game.

    -

    See the "flags" attribute for admin-only classes.

    +

    See the flags attribute for admin-only classes.

    @@ -905,17 +906,18 @@ the admin-only flag in the "flags" attribute.

    Flags (3.3.1)
    ). Available flags:

    - + - + + zombies. Note that zr_classes_default_mother_zombie + setting must be set to motherzombies for this flag to + be effective.
    11 Admins only
    Marks the class to be used by admins only. Classes with this option on will not be visible for regular players in the class menu.
    22 Mother zombie.
    Marks the class as a mother zombie class. These classes will be used on mother - zombies. Note that zr_classes_default_mother_zombie setting must be set to - "motherzombies" for this flag to be effective.

    These flags can be used in a combination (1 + 2), so it could be a mother zombie @@ -970,15 +972,15 @@ the admin-only flag in the "flags" attribute.

    are a few special values supported by this attribute:

    - + - + - + @@ -1482,6 +1484,8 @@ Place these console variables in the main configuration file:

    the default classes are assigned.

    This setting also override zr_classes_*_select. If players have saved class indexes in cookies they will be restored.

    +

    Disabling this option won't erase saved settings, they just won't be restored when + players connect.

    Options:
    0 or 1

    @@ -1496,11 +1500,11 @@ Place these console variables in the main configuration file:

    Default zombie class selected for all players when they connect.

    Options:

    defaultdefault Use default CS models. The one players select when selecting team.
    randomrandom Selects a random model for the current team.
    nochangenochange Don't change model. To be used in combination with other plugins that change model on players.
    - - -
    <class name>Specify a class name to use as +
    <class name>Specify a class name to use as default zombie.
    "default"Use the default class in the class +
    "default"Use the default class in the class configuration.
    "random"Select a random zombie class from the class +
    "random"Select a random zombie class from the class configuration.
    @@ -1516,12 +1520,12 @@ Place these console variables in the main configuration file:

    exist it will use the class selected by the player.

    Options:

    - - - + -
    <class name>Specify a class name to use as +
    <class name>Specify a class name to use as default mother zombie.
    "random"Select a random regular zombie class.
    "motherzombies"Select a random zombie class with +
    "random"Select a random regular zombie class.
    "motherzombies"Select a random zombie class with mother zombie flag.
    "disabled"No change. Use the zombie class selected by +
    "disabled"No change. Use the zombie class selected by the player.
    @@ -1536,11 +1540,11 @@ Place these console variables in the main configuration file:

    Default human class selected for all players when they connect.

    Options:

    - - -
    <class name>Specify a class name to use as +
    <class name>Specify a class name to use as default human.
    "default"Use the default class in the class +
    "default"Use the default class in the class configuration.
    "random"Select a random human class from the class +
    "random"Select a random human class from the class configuration.
    @@ -1555,13 +1559,15 @@ Place these console variables in the main configuration file:

    Note: This feature is incomplete!

    Default admin-mode class selected for all players when they connect, if found. This feature is incomplete and ignored.

    +

    Do not confuse this with admin-only classes. Admin-mode is a special spawn mode for + admins.

    Options:

    - - -
    <class name>Specify a class name to use as +
    <class name>Specify a class name to use as default admin-mode class.
    "default"Use the default class in the class +
    "default"Use the default class in the class configuration.
    "random"Select a random admin-mode class from the +
    "random"Select a random admin-mode class from the class configuration.
    @@ -1611,16 +1617,17 @@ Place these console variables in the main configuration file:

    5. Modifying Class Attributes

    -

    Classes can be modified after they're loaded. This is useful in map configs -to do stuff like scaling knockback to tune map balance.

    +

    Classes can be modified after they're loaded. This is useful in map configs to do stuff like +scaling knockback to tune map balance.

    -

    All attributes can be modified, and some can also be scaled with a multiplier. -The value in the original class cache is multiplied with the specified value -and written back to the modified cache.

    +

    All attributes can be modified, and some can also be scaled with a multiplier. The value in the +original class cache is multiplied with the specified value and written back to the modified cache.

    -

    When multiplying, the value is always based on the original value, not -multiplying the earlier multiplied value. This also makes it easy to restore -the original value.

    +

    When multiplying, the value is always based on the original value, not multiplying the earlier +multiplied value. This also makes it easy to restore the original value.

    + +

    Note:These commands must be used in a post map config files, +otherwise they won't have any effect because class data isn't loaded yet.

    Console commands:

    @@ -1638,21 +1645,21 @@ the original value.

    Parameters:

    - + - + - + - + @@ -1689,29 +1696,32 @@ values may cause unexpected behaviour, or even crash the plugin.

    Parameters:

    class|teamclass|team The class to modify. Can be any valid class name, or one of the following team names:
    "all", "humans", "zombies" or "admins".
    attributeattribute The name of the class attribute to modify.
    valuevalue Value to set, or multiplier if a multiplier.
    is_multiplieris_multiplier Optional. Specifies wether the original value should be multiplied by the specified value. Default is false.
    - + - + - +
    teamteam What multiplier set to use. Options:
    "zombies" or "humans"
    attributeattribute A numeric class attribute. See Class Attributes (3.7.2) for details on attributes. Valid attribute multipliers:
      -
    • "napalm_time" (zombies only)
    • -
    • "health"
    • -
    • "health_regen_interval"
    • -
    • "health_regen_amount"
    • -
    • "health_infect_gain" (zombies only)
    • -
    • "speed"
    • -
    • "knockback" (zombies only)
    • -
    • "jump_height"
    • -
    • "jump_distance"
    • +
    • health
    • +
    • health_regen_interval
    • +
    • health_regen_amount
    • +
    • speed
    • +
    • jump_height
    • +
    • jump_distance
    • +
    + Multipliers for zombies only: +
      +
    • napalm_time
    • +
    • health_infect_gain
    • +
    • knockback
    valuevalue Value to set, or multiplier if a multiplier.
    @@ -1740,10 +1750,8 @@ This only applies to players who already are the same class.

    Refreshes the player cache and reloads class attributes on one or more players.

    Parameters:

    - - - - +
    targetTarget player(s) to refresh cache on. A name or a SourceMod target specifier.
    targetTarget player(s) to refresh cache on. A name + or a SourceMod target specifier.
    @@ -1767,7 +1775,7 @@ This only applies to players who already are the same class.

    Parameters:

    - + @@ -1846,16 +1851,16 @@ map configuration files it must be in a pre configuration file.

    A list of weapon groups and the weapon type.

    Pre-defined options:

    @@ -1870,10 +1875,10 @@ map configuration files it must be in a pre configuration file.

    The slot index the weapon resides in. Don't change this!

    Options:

    cachetypecachetype Cache to read from. Cache types: @@ -1777,7 +1785,7 @@ This only applies to players who already are the same class.

    - +
    "original"Unmodified raw class data.
    index|targetnameindex|targetname Class index, or name of player if "player" cache type is used.
    @@ -1803,11 +1811,8 @@ multipliers.

    Dumps class attribute multipliers for the specified team.

    Parameters:

    - - - - +
    teamThe multiplier set to dump. Valid options are:
    - "humans" or "zombies"
    teamThe multiplier set to dump. Valid options + are:
    "humans" or "zombies"
    - - - - + + + +
    0Primary weapon slot
    1Secondary weapon slot
    2Knife slot
    3Equipment slot
    0Primary weapon slot
    1Secondary weapon slot
    2Knife slot
    3Equipment slot
    @@ -1888,8 +1893,8 @@ map configuration files it must be in a pre configuration file.

    The default restricted status of the weapon on map start.

    Options:

    - - + +
    "yes"Enable
    "no"Disable
    "yes"Enable
    "no"Disable
    @@ -1904,8 +1909,8 @@ map configuration files it must be in a pre configuration file.

    Enable weapon to have restrictions toggled mid-game.

    Options:

    - - + +
    "yes"Enable
    "no"Disable
    "yes"Enable
    "no"Disable
    @@ -1920,16 +1925,16 @@ map configuration files it must be in a pre configuration file.

    Ammo entity that belongs to weapons. Don't change this!

    Options:

    - - - - - - - - - - + + + + + + + + + +
    ammo_50aedeagle
    ammo_762mmscout, ak47, g3sg1, aug
    ammo_556mm_boxm249
    ammo_556mmgalil, sg552, famas, m4a1, sg550
    ammo_338magawp
    ammo_9mmmp5navy, tmp, glock, elite
    ammo_buckshotm3, xm1014
    ammo_45acpump45, mac10, usp
    ammo_357sigP228
    ammo_57mmp90, fiveseven
    ammo_50aedeagle
    ammo_762mmscout, ak47, g3sg1, aug
    ammo_556mm_boxm249
    ammo_556mmgalil, sg552, famas, m4a1, sg550
    ammo_338magawp
    ammo_9mmmp5navy, tmp, glock, elite
    ammo_buckshotm3, xm1014
    ammo_45acpump45, mac10, usp
    ammo_357sigP228
    ammo_57mmp90, fiveseven
    @@ -1988,7 +1993,7 @@ sub section for each weapon using short names from the list below.

    - + @@ -2153,8 +2158,8 @@ file, or on a per-map basis with map configuration files.

    Restricts one or more weapons or weapon types (group).

    Parameters:

    Weapon name:Weapon name: Type: Full name:
    - - + +
    weaponThe weapon name.
    weapon typeThe weapon type group.
    weaponThe weapon name.
    weapon typeThe weapon type group.
    @@ -2167,8 +2172,8 @@ file, or on a per-map basis with map configuration files.

    Unrestricts one or more weapons or weapon types (group).

    Parameters:

    - - + +
    weaponThe weapon name.
    weapon typeThe weapon type group.
    weaponThe weapon name.
    weapon typeThe weapon type group.
    @@ -2210,22 +2215,22 @@ This is useful for fine tuning game balance.

    Parameters:

    - + -
    hitgrup namehitgrup name Name of the hit group to adjust. Options:
      -
    • generic
    • -
    • head
    • -
    • chest
    • -
    • stomach
    • -
    • leftarm
    • -
    • rightarm
    • -
    • leftleg
    • -
    • rightleg
    • -
    • gear
    • +
    • generic
    • +
    • head
    • +
    • chest
    • +
    • stomach
    • +
    • leftarm
    • +
    • rightarm
    • +
    • leftleg
    • +
    • rightleg
    • +
    • gear
    valueOptional. Enable hit group damage. Default action is to toggle +
    valueOptional. Enable hit group damage. Default action is to toggle setting. Options: 0 or 1
    @@ -2251,15 +2256,15 @@ This is useful for fine tuning game balance.

    The hit group index.

    Options:

    - - - - - - - - - + + + + + + + + +
    0Generic
    1Head
    2Chest
    3Stomach
    4Left Arm
    5Right Arm
    6Left Leg
    7Right Leg
    8Gear
    0Generic
    1Head
    2Chest
    3Stomach
    4Left Arm
    5Right Arm
    6Left Leg
    7Right Leg
    8Gear
    @@ -2274,8 +2279,8 @@ This is useful for fine tuning game balance.

    Allows damage to be done on the specified hit group for zombies.

    Options:

    - - + +
    yesAllow damage
    noIgnore damage
    yesAllow damage
    noIgnore damage
    @@ -2401,9 +2406,9 @@ tune game balance.

    Enable explosion effects. If disabled, this setting will also disable the following CVARs:

    Options:
    0 or 1

    @@ -2516,8 +2521,8 @@ tune game balance.

    Infects one or more players.

    Parameters:

    - - + +
    targetA SourceMod target string with one or more players.
    respawnTeleport players to spawn.
    targetA SourceMod target string with one or more players.
    respawnTeleport players to spawn.
    @@ -2530,8 +2535,8 @@ tune game balance.

    Turn one or more zombies into humans.

    Parameters:

    - - + +
    targetA SourceMod target string with one or more players.
    respawnTeleport players to spawn.
    targetA SourceMod target string with one or more players.
    respawnTeleport players to spawn.
    @@ -2871,9 +2876,9 @@ in progress by the SourceMod team).

    representing amount of red, green and blue.

    Examples

    - - - + + +
    255 255 0Yellow
    255 0 255Purpule
    96 96 96Dark grey
    255 255 0Yellow
    255 0 255Purpule
    96 96 96Dark grey
    @@ -2889,9 +2894,9 @@ in progress by the SourceMod team).

    representing amount of red, green and blue.

    Examples

    - - - + + +
    255 255 0Yellow
    255 0 255Purpule
    96 96 96Dark grey
    255 255 0Yellow
    255 0 255Purpule
    96 96 96Dark grey
    @@ -2965,12 +2970,12 @@ in progress by the SourceMod team).

    Dissolve effect to use when removing bodies.

    Options:

    - - - - - - + + + + + +
    -2No effect
    -1Random effect
    0Energy dissolve
    1Heavy electrical dissolve
    2Light electrical dissolve
    3Core dissolve
    -2No effect
    -1Random effect
    0Energy dissolve
    1Heavy electrical dissolve
    2Light electrical dissolve
    3Core dissolve
    @@ -3331,8 +3336,10 @@ right after they've spawned.

    Force one or more players to spawn.

    Parameters:

    - - +
    targetA SourceMod target string with one or more players.
    spawn teamOptional. Specify what team to spawn to. Options:
    +
    targetA SourceMod target string with one or more + players.
    spawn teamOptional. Specify what team to spawn to. + Options:
    0 (humans) or 1 (zombies)
    @@ -3468,8 +3475,8 @@ protection.

    Force teleport on a player. Does not add delay or add to teleport count.

    Parameters:

    - +
    clientSingle target player. Support SourceMod targets like - @me and @aim.
    clientSingle target player. Support SourceMod + targets like @me and @aim.
    @@ -3617,15 +3624,325 @@ each model used in the game. Data for these models are stored in the following f

    3.23 Volumetric Feature Configuration

    -

    (Feature exist, but incomplete documentation)

    +

    Volumetric Features is a way to do various stuff on players when they enter custom created +volumes in a map. A volume is rectangular and is created by using two coordinates in the map that +defines the three-dimensional area.

    -

    1. Volume Attributes

    -

    2. Feature Attributes

    -

    3. Anti-Camp

    -

    4. Class Editor

    +

    +
    This is a visualized volume where the red border is the volume, and the blue or green circles are +examples of what points in the map that could be used.

    + +

    Known issues/bugs:

    +
      +
    • Volumes placed in spawn areas won't take effect on them until they leave the area and go + back in. There's a bug where it doesn't apply to spawned players.
    • +
    • Avoid overlapping volumes of same type. There's currently no conflict handling and whichever + volume the player enter or leave last will be triggered.
    • +
    + +

    1. Creating A Volume

    + +

    To create a volume go into spectactor mode (or no-clip). Enable position display in the client +(cl_showpos 1), the numbers appear in the top right corner of the scteen. +Visualize a rectangular area and move to one of its corners. Get the x, y and z coordinates (make +sure you don't miss the "-" if it's a negative number). Go to the diagonally oposite corner, in the +oposite height and get the second set of coordinates.

    + +

    Use the zr_vol_add console command in map configs to add volumes.

    + +

    Short summary:

    + +
      +
    1. Go into spectator mode or no-clip
    2. +
    3. Enable position display: cl_showpos 1
    4. +
    5. Go to one of the corners, get the coordinates
    6. +
    7. Go to the diagonally oposite corner, in the oposite height and get the second set of + coordinates.
    8. +
    9. Use these coordinates in the zr_vol_add command along with + additional attributes.
    10. +
    + +

    2. Volume Attributes

    + +

    Each volume has a set of standard attributes that tell how it should behave and look like. +In addition each feature has a set of attributes. All attributes have default values and are +not required, except the type attribute.

    + +

    These are the generic attributes and apply to all volumes:

    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Attribute:Value type:Default:
    typetext-
    +

    Note: This attribute is required!

    +

    Specified the volumetric feature type.

    +

    Valid options:

    + + + +
    anticampAnti-Camp volume.
    classeditClass editor volume.
    +
    teamfiltertext"all"
    +

    Sets the team filtering settings.

    +

    Valid options:

    + + + + +
    allApplies to all players.
    humansApplies to humans only.
    zombiesApplies to zombies only.
    +
    delaynumber0
    +

    Trigger delay. Number of seconds to wait when a player enter the volume before + triggering actions. Time is in seconds.

    +
    effecttext"none"
    +

    Note: Incomplete, this attribute is ignored.

    +

    What effect to apply to the volume

    +

    Valid options:

    + + + + + +
    noneNo effect.
    wireframeDraw a wireframe.
    smokePut smoke in the volume.
    firePut fire in the volume.
    +
    effect_colortext"0,0,0"
    +

    Note: Incomplete, this attribute is ignored.

    +

    Color of the effect. RGB format, represented by three numbers from 0 to 255 separated + by a comma. Syntax: <red>,<green>,<blue>

    +
    enabledboolean1
    +

    Set the initial enabled setting on the volume. Usually this attribute won't be used.

    +
    + +

    3. Volume Commands

    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Syntax:
    zr_vol_add <x1> <y1> <z1> <x2> <y2> + <z2> <type> [params]
    +

    Creates a rectangular volume in the map.

    +

    Parameters:

    + + + + + +
    x1, y1, z1First set of coordinates.
    x2, y2, z2Second set of coordinates.
    typeVolumetric feature type. Described in + Volume Attributes.
    paramsAdditional key-value chain of volume + attributes, separated by space. Syntax: attribute=value + attribute=value ...
    +
    zr_vol_remove <volume index>
    +

    Removes an existing volume in the map.

    +

    Parameters:

    + + +
    volume indexZero-based index of volume (ID) to + remove.
    +
    zr_vol_list [volume index]
    +

    Lists existing volumes in the map, or dumps volume details.

    +

    Parameters:

    + + +
    volume indexOptional. Zero-based index of volume + (ID) to dump.
    +
    zr_vol_dumpstates <userid|targetname>
    +

    Dumps a list of all volumes and a indicator whether the target is in it or not.

    +

    Parameters:

    + + +
    userid|targetnameA SourceMod target string to a single player.
    +
    -

    4. How To Play

    +

    4. Anti-Camp

    + +

    The anti-camp feature can be used to force players to leave areas that are considered unfair or +not allowed. It uses a timer to trigger actions at a specified interval. In addition warning messages +can be displayed to player that enter the volume.

    + +

    Anti-camp spesific attributes:

    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Attribute:Value type:Default:
    intervalnumber5
    +

    Trigger interval. How often to apply actions on players in the volume. Time is in + seconds.

    +
    actiontext"damage"
    +

    What kind of action to apply.

    +

    Valid options:

    + + + + + + +
    noneDo nothing. Useful for just giving warning + messages.
    damageHurt player.
    slayKill player.
    drug(Incomplete!) Drug player. Players will be + un-drugged when leaving volume.
    igniteSet player on fire. Players will be extinguished + when leaving volume.
    +
    amountdecimal5.0
    +

    Specifies amount to apply depending on action type.

    +

    Amount type for action:

    + + + + + + +
    none(ignored)
    damageHealt points
    slay(ignored)
    drugTime in seconds
    igniteTime in seconds
    +
    warningtext"chat"
    +

    Where to show warning message.

    +

    Valid options:

    + + + + + +
    noneDon't show a warning message.
    chatDisplay in client's chat area.
    centerDisplay warning text centered on the screen.
    menuDisplay warning in a menu panel, stays open for + 30 seconds or when closed.
    +
    messagetext""
    +

    Use custom warning message (max 255 byte). Leave blank to use default warning + message.

    +
    + +

    5. Class Editor

    + +

    (Docs incomplete.)

    + +

    4. How To Play

    (Incomplete) Feel free to contribute to this section. Make a new thread with suggestions in the Zombie:Reloaded Forum.

    @@ -3699,7 +4016,7 @@ might help.

    When jumping it's not easy for humans to hit the head and they can't get that good knock back anymore. With multiple zombies jumping fast, pushing eachother on their way into a tube, the humans are doomed. The tube camping problem much better balanced. This problem can also be solved by -using a class editor volume or anti-camp in tubes and +using a class editor volume or anti-camp in tubes and vents.

    @@ -3709,6 +4026,10 @@ vents.

    5.2 Startup

    5.3 Error Messages

    5.4 Common Problems

    +

    5.5 Known Issues

    + +

    Conflicts with WCS Races plugin and other plugins who change player model/skin and speed.

    +

    Do not run es_tools, it's not compatible with SourceMod.

    6. Gameplay Guidelines

    @@ -3732,12 +4053,14 @@ href="http://forums.alliedmods.net/forumdisplay.php?f=132">Zombie:Reloaded forum issue. If you're unsure about this, just make new threads.
  • Tell us what version you use. If you use a old version the problem might be solved in a newer version.
  • -
  • Use a short thread title that describes your problem (keyworks is enough).
  • +
  • Use a short thread title that describes your problem (keywords is enough).
  • If you found a bug, start the thread title with [BUG] or similar.
  • If your problem were solved you could share the solution in your thread. Also add [SOLVED] or similar in the thread title.
  • +

    Valid XHTML 1.0 Strict