Addon Details

[b]Please don't hesitate to post your comments and remarks in the discussion thread. I need opinions to know how it's working and what should be changed / added A little website dedicated to the mod is in progress here: [url]http://www.etmod2008.o-n.fr[/url] [/b] [b][u][color=red][size=20]Description[/size][/color][/u][/b] In this mod players play with different classes and gain xp by doing different actions. Each class is configured with the weapons players will use with it, the health, armor, speed, ammo, clip and color that they will get by joining it. Some classes will only be allowed to do basic actions like killing enemies when others will be given some more specific. For example, by default, the engineers will be allowed to plant / defuse bombs (depending on their team) and rescue hostages. Medics will be able to heal themselves and their teammates by using either a chat or console command and gunners will supply ammo once again to themselves or their enemies. A team winning a round will be given a more important amount of xp then for usual actions. Of course all special actions will generally also be worth more xp then the normal ones for the classes using them. Medics will not get much xp for killing while they will raise it a lot faster by healing teammates. Another important thing is that hurting / killing enemies from a higher level will make players gain more xp too. In addition classes can be configured to make players lose xp when they get hurt or killed. In addition to the different actions described so far players will also be able to learn skills specific to each class after reaching a certain level. Once they'll have learnt those skills they'll be able to buy some instances of them whenever they want using the shop menu. Also those skills will be given some specific parameters which players can upgrade if they have the required money. A parameter used for most skills is its duration for example. Not only skills can be bought. The shop menu will also let players buy different things like more health points, armor points, ammo, etc... Classes with special abilities will also be able to upgrade those. Another interesting thing they can buy is a special weapon specific to their class and better then the normal one. [b][u][color=red][size=20]Game rules[/size][/color][/u][/b] As usual in Counter-Strike:Source you'll have to try to win the round by either exploding / defusing a bomb or rescuing the hostages. But here only some will be allowed to do those actions. Some others will be able to heal their teammates and / or supply ammo to them. At your first respawn a menu will let you choose your class. If you open that menu or use the chat / console command while playing you'll be able to choose the class you will have after respawning the next time. Winning the round is the most important thing to do because a lot of xp and money will be given for that. But the special abilities will also give you a lot. Chat and console commands are available to easily use them. Just aim at a teammate and use the command (bound to a key is usually better) to heal him. Depending on the mod configuration you will either respawn alone after some time once you'll have died or at the same time as others. [b][u][color=red][size=20]Classes[/size][/color][/u][/b] Six classes will be available with the mod by default. But as an important feature the mod can be configured in many different ways. About the classes you could decide to create as many as you'd like, replace the default ones, use custom names... The folder where you can find the classes configuration files is under '/etmod_2008/classes/configuration'. Here's a little description of the different classes existing by default: [color=red]#[/color][color=green][i][u]The soldier[/u][/i][/color][color=red]#[/color] - his weapons will be 'galil' and 'glock' for the terrorists and 'famas' and 'usp' for the counter-terrorists - he will be given two 'smoke grenades' - he will have quite a lot of health and will be quite fast - he will be given a lot of xp for hurting and killing enemies, especially with headshots or knives - his special weapons will be 'ak47' for the terrorists and 'm4a1' for the counter-terrorists [color=lightgreen]#[/color][color=green][i][u]The grenader[/u][/i][/color][color=lightgreen]#[/color] - his weapons will be 'tmp' and 'deagle' for the terrorists and 'mac10' and 'deagle' for the counter-terrorists - he will be given a quite large amount of HE grenades - he will have a good health and not a bad armor and will be very fast - he will get a lot of xp by hurting and killing enemies too - his special weapons will be 'p90' for both teams - to play as a grenader players will have to reach level 3 in class soldier first [color=black]#[/color][color=green][i][u]The gunner[/u][/i][/color][color=black]#[/color] - his weapons will be 'p90' and 'p228' for both teams - he will be given two 'smoke grenades' - his health will be quite high and his armor will be at max. As for his speed he will be pretty slow - he will find it easier to gain xp by supplying ammo to his teammates then by killing enemies - his special weapons will be the 'm249' for both teams - to play as a gunner players will have to reach level 5 in class soldier first [color=orange]#[/color][color=green][i][u]The sniper[/u][/i][/color][color=orange]#[/color] - his weapons will be 'scout' for both teams and 'glock' for terrorists and 'usp' for counter-terrorists - his health will not be the highest and he will not be especially fast but he will have some armor - he will easily gain xp by hurting and killing enemies - his special weapons will be the 'awp' for both teams - to play as a sniper players will have to reach level 3 in class gunner [color=yellow]#[/color][color=green][i][u]The medic[/u][/i][/color][color=yellow]#[/color] - his weapons will be 'ump45' and 'glock' for terrorists and 'mp5navy' and 'usp' for counter-terrorists - he will also be given two 'flashbang grenades' - his health and armor will be pretty low but he will be the fastest - he will not get much xp by hurting and killing enemies but healing teammates will make it easy - his special weapons will be 'p90' in both teams to play as a medic players will have to reach level 5 in class soldier [color=blue]#[/color][color=green][i][u]The engineer[/u][/i][/color][color=blue]#[/color] - his weapons will be 'm3' in both teams and 'glock' for terrorists and 'usp' for counter-terrorists - terrorists will also be given 'bombs' and counter-terrorists a 'defuse kit'. Depending on the game configuration terrorists might be able to plant and explode multiple bombs on the same round. If a class has multiple engineers they can also all plant together to all get their xp. - his health will be very high but he will not be given any armor and will be pretty slow - hurting and killing enemies will not give him a lot of xp but planting / defusing bombs or rescuing hostages will make it very fast - his special weapons will be 'p90' for both teams In each class players will also get a specific amount of money that is usually relative to the amount of xp given. Most of the time it will be better for everyone to play together and help each other because that's usually how they will get the most xp and money. It's also possible to play in the default class which will only allow you to use a knife and 1 health point. Levelling in that class will be very useful for different things. The classes can also be configured to accept only a certain percent of players like allowing 50% of the players present on the server to join a specific class. [b][u][color=red][size=20]Skills[/size][/color][/u][/b] Multiple skills are already available but some more will come soon. Once again they can be easily configured with the config file located at '/etmod_2008/skills/configuration/'. Here's a little description of them: [color=green][i][u]Invisibility[/u][/i][/color] Allows players to be invisible or nearly during some time. Its parameters are: - the duration: amount of time one use of it will last in seconds - the intensity: how much invisible you will appear when using it - only engineers can use it and after reaching level 10 [color=green][i][u]Shield[/u][/i][/color] Allows players to be more health during some time. Its parameters are: - the duration: amount of time one use of it will last in seconds - the hp: health points given to the player using it - the ap: armor points given to the player using it - only soldiers and engineers can use it and after reaching level 5 [color=green][i][u]Invincibility[/u][/i][/color] Allows players not to lose health if shot during some time. Its parameters are: - the duration: amount of time one use of it will last in seconds - only soldiers and engineers can use it and after reaching level 20 [color=green][i][u]Poison[/u][/i][/color] Allows players to handicap an enemy during some time. Its parameters are: - the duration: amount of time one use of it will last in seconds - the hp: health points taken from the enemy each time - the ap: armor points taken from the enemy each time - the speed: how many times the enemy will get hurt per second - only medics can use it and after reaching level 10 [color=green][i][u]Boots[/u][/i][/color] Allows players to run faster during some time. Its parameters are: - the duration: amount of time one use of it will last in seconds - the speed: speed amount that will be added to player's default speed [color=green][i][u]Jetpack[/u][/i][/color] Allows players to use a jetpack to fly during some time. Be careful to get down before it stops or you'll fall and hurt yourself. Its parameters are: - the duration: how much time players can fly in seconds [color=green][i][u]Teleport[/u][/i][/color] Allows players to first choose a teleport location and then to teleport themselves to that location. Its parameters are: - the distance: the maximum distance players can be from the selected teleport location to teleport [color=green][i][u]Armor piercing[/u][/i][/color] Makes players do more damage to their enemies when shooting them. Its parameters are: - the duration: how much time they will do more damage in seconds - the hp: additional health points taken from enemies when hurt - the ap: additional armor points taken from enemies when hurt [color=green][i][u]Fast heal[/u][/i][/color] Allows players to give more health to their teammates or themselves when healing. Its parameters are: - the duration: how much time it will last in seconds - the hp: additional health points given each time they use the heal action on someone - the ap: additional armor points given each time they use the supply action on someone [color=green][i][u]Fast supply[/u][/i][/color] Allows players to give more ammo to their teammates or themselves when supplying. Its parameters are: - the duration: how much time it will last in seconds - the primary ammo: additional primary ammo given when supplying - the secondary ammo: additional secondary ammo given when supplying [color=green][i][u]Health pack[/u][/i][/color] Allows players to give a large amount of health and armor to themselves or a teammate. Its parameters are: - the hp: how many health points will be given - the ap: how many armor points will be given [color=green][i][u]Ammo pack[/u][/i][/color] Allows players to give a large amount of ammo to themselves or a teammate. Its parameters are: - the primary ammo: how much primary ammo will be given - the secondary ammo: how much secondary ammo will be given [color=green][i][u]Grenades[/u][/i][/color] Allows players that are given grenades in their class to get some more. It has no parameter. [color=green][i][u]Vulnerability[/u][/i][/color] Allows players to make their enemies more vulnerable. They'll lose health and armor more easily when hurt by their enemies. Its parameters are: - the duration: how much time the enemy will suffer from that skill in seconds - the hp: additional health points taken from the enemy when hurt - the ap: additional armor points taken from the enemy when hurt [color=green][i][u]Remote charges[/u][/i][/color] Allows player pose a charge somewhere and blow it when he wants to. Its parameters are: - the intensity: the explosion intensity - the duration: how long time the flash effect given to the players close to the explosion will last [color=green][i][u]Exploding bullets[/u][/i][/color] Allows players to shoot bullets that will explode once they hurt something during a certain time. Its parameters are: - the intensity: intensity of the explosion - the duration: how much time the fired bullets will explode [color=green][i][u]Mini sticky bombs[/u][/i][/color] Allows players to stick little bombs anywhere using his gun and explode them with a chain reaction when he wants. Its parameters are: - the intensity: intensity of the explosion - the quantity: how many bombs you can plant for one use of the skill - the duration: used for the delay between the explosions of the chain reaction (5s / given value) [b][u][color=red][size=20]Administration[/size][/color][/u][/b] A specific admin system is in place for the mod. it will allow some players to easily configure the server and the mod with a menu. Each of them will be given an admin level that will restrict their rights. To configure the mod admins open the config file located in the '/etmod_2008/admins/configuration/' folder and add them this way: [color=green][i][u]Add an admin[/u][/i][/color] steamid=level The example already present in the file will help you see how it should look like. Admin levels will be described soon. [b][u][color=red][size=20]Commands[/size][/color][/u][/b] There are different chat and console commands that can be bound to keys / written in chat to do the different possible actions. Here's there description: [color=green][i][u]Chat commands[/u][/i][/color] - etspawn: lets you respawn when you're joining the server and would have to wait for the round to end to play otherwise. - etclass : lets you quickly choose your class for when you type it if you don't have one yet or for your next respawn otherwise. - etlevel [class name]: simply displays the xp and level you currently have in the chosen class. If no class name was specified it will be for your current class. - etheal: used to heal yourself or teammates if your class allows you to - etsupply: used to supply ammo to yourself or teammates if your class allows you to - etmenu [menu name]: displays the selected menu which can be "class" to choose a class, "stats" to check your stats, "pref" to choose your preferences, "buy" to buy something, "admin" to open the admin page, "help" for the healp menu or "about" for the about menu. If no menu name is specified then the main menu will be displayed. - etskill [skill name]: allows you to use the specified skill. If none is specified then the skill selection menu will be opened. - etstats: manually display the quick stats info box at any time [color=green][i][u]Client console commands[/u][/i][/color] All the chat commands can be used the same way in console with just a "_" characted between "et" and the action name (e.g. et_menu stats). you can bind them to keyoard keys to use them more easily with commands like "bind v et_heal". An additional command called is also available: - et_rcon : lets admin players use their console to execute a server command (e.g. et_rcon "mp_restartgame 1", typed in the player's client console) [color=green][i][u]Server console commands[/u][/i][/color] Theses commands should be typed in the server console. - et_players: display some info about players currently on the server - et_classes: display some info about the classes currently in use on the server - et_skills: display some info about the skills currently in use on the server - et_saveall: manually save all players stats, preferences and skills (for those currently on the server) - et_shutdown: save player files like "et_saveall" and then shuts the server down after a little warning message to players - et_configbots : choose the bots level and their classes will automatically be upgraded based on it [b][u][color=red][size=20]Configuration[/size][/color][/u][/b] In addition to all that has already been said about it many things can be configured for when the mod is running: [color=green][i][u]Server config[/u][/i][/color] A config file can be created for each map you want to give one. For that you just need to create a file called '.cfg' in the '/etmod_2005/server/configuration/' folder. Then check one of the existing ones to know what can be used inside of it. For the normal server configuration you can for the moment configure all of the 'mp_', 'bot_' and 'hostname' server variables. The administration menu can also be used to change them during the game. [color=green][i][u]Mod config[/u][/i][/color] Many variables exist to configure the mod in different ways. Here are their descriptions: - et_restrict_classes: set it to 1 to use the class restrictions defined in the class config files (like level 3 required in class gunner to unlock class sniper), otherwise set it to 0 - et_restrict_players_in_classes: set it to 1 to use the percent of players allowed in the class defined in the class config files, or to 0 to allow any number of players in each class - et_unlimited_ammo: set it to 1 to allow players to shoot infinitely, or to 0 to disable that feature - et_no_reload: set it to 1 to allow players not to have to reload their gun when their clip is empty. Their clip will be kept full as far as they still have enough ammo left in their pack. - et_spawn_delay: the delay in seconds after which a player will respawn after dying, or afte which all dead players will respawn together - et_spawn_protection_time: how much time in seconds players will be protected from being hurt after respawning to avoid spawn campers to kill them at their respawn - et_synchronized_spawn: set it to 1 to let all dead players respawn together, or to 0 to let each one respawn individually - et_random_classes: set it to 1 to force player classes to be randomly chosen at each respawn like for bots, or to 0 to let them choose - et_use_colors: set it to 1 to use the color defined in the class config files on players to be able to know in which class they are - et_round_xp: how much xp will be given to players of the winning team (for a round won) - et_round_money: how much money will be given to players of the winning team (for a round won) - et_hurt_loose_xp: set it to 1 to make players lose xp when they get hurt, or to 0 to disable that feature (I'll remove the second 'o' in 'loose' when I'll think of it :)) Another important thing that can be customized is the languages section. You can update the files present in the '/etmod_2008/languages/configuration/' as you want to translate things from English to your language the way you want. Only French is available in addition to English so far but you can create new files the same way the others were created if you want. The 'logs' section will be used only for the log messages while the 'words' and 'groups' sections for in-game messages. Groups will be checked first and words after. If a word is left un-translated in a sentence but a translation is present in the 'words' section then it will be translated. [b][u][color=red][size=20]Players info[/size][/color][/u][/b] Of course players stats will be saved on the server. The file names will be made of their steamid with the ':' replaced by '_' and a '.st' extension. Those files will be located at '/etmod_2008/stats/data/'. You can edit them if you want. As players can choose their language in game and some other individual configuration a preferences file will also be created for them in the '/etmod_2008/players/preferences/' folder. One last thing will be saved for each player. It's their skills progression. Those files will be located at '/etmod_2008/skills/skills/data/' and will be easy to update if you need to. All those files will be created the first time players join the server and will automatically be saved at map change. You can also manually save all of them using the 'et_saveall' server command. The 'et_shutdown' command lets you shut the server down by first saving players info files. If needed players can also manually save their files from the different menus at any time. [b][u][color=red][size=20]Notes[/size][/color][/u][/b] Some piece of advice for those who'd be wondering what to do in special cases: [color=#bb8822]Q - I joined when the game was already started and then cannot respawn. How can I quickly join the action ?[/color] [color=#229922]A - Type 'etspawn' but it will work only if you have already chosen your team. If the synchronized respawn is activated just wait for the countdown to reach 0 to respawn with the other dead players.[/color] [color=#bb8822]Q - How can I change class ?[/color] [color=#229922]A - Type 'etclass ' followed by a class name in chat or open the main menu with 'etmenu' and choose the first option then the class you want to join. if class restrictions are activated you might not be allowed to join one if there are already enough players in it or if you didn't reach the requried level in another class yet.[/color] [color=#bb8822]Q - What should I do if I don't have the class menu when I first respawn ?[/color] [color=#229922]A - Same as last answer.[/color] [color=#bb8822]Q - Will my stats be saved so that I can elave and get them back when I join at another time ?[/color] [color=#229922]A - Of course. You classes stats will be saved in a file on the server and be reloaded next time you join. And it will be exactly the same for your classes upgrades,the skills you learnt and the upgrades you bought for them and your mod preferences.[/color] Well I can't think of any others right now. If anyone has some more I will add them :). [b][u][color=red][size=20]Videos[/size][/color][/u][/b] [b][color=blue][url=http://www.youtube.com/watch?v=5Q-eV9urdYM]- Using boots skill[/url][/color][/b] - sorry for the quality, if anyone knows a good capture configuration please let me know and I'll use it (this one was recorded at 1280x800 and unfortunately YouTube reduced the quality a lot I suppose to reduce the size).