ConVar list

Configuration options in SM:RPG

There are several options to customize the plugin. Lots of console variables (ConVars) are created for each module in [mod]/cfg/sourcemod/ like [mod]/cfg/sourcemod/plugin.smrpg.cfg. Additionally there are other config files in [mod]/addons/sourcemod/configs/smrpg. Every upgrade generates it's own config file in [mod]/cfg/sourcemod/smrpg/.

Table of Contents

• smrpg Core
• SM:RPG Modules
  • smrpg_antisuicide Anti-Selfkill
  • smrpg_chattags Chat Tags
  • smrpg_chatxpstats Chat Experience Stats
  • smrpg_commandlist Command List
  • smrpg_cstrike Counter-Strike Experience Module
  • smrpg_effects Effect Hub
  • smrpg_gifting Credit Gifting
  • smrpg_keyhint_info Stats Info Panel
  • smrpg_resetstats Reset interval
  • smrpg_turbomode Turbo Mode
• Upgrade configuration

smrpg Core

• smrpg_enable - If set to 1, SM:RPG is enabled, if 0, SM:RPG is disabled (Default 1)
• smrpg_ffa - Free-For-All mode to ignore teams and handle teammates as if they're enemies? (Default 0)
• smrpg_bot_enable - If set to 1, bots will be able to use the SM:RPG plugin (Default 1)
• smrpg_bot_save_stats - If set to 1, the stats of bots are saved per bot name and are restored when the bot is added later again. (Default 0)
• smrpg_bot_need_human - Don't allow bots to gain experience while no human player is on the server? (Default 1)
• smrpg_need_enemies - Don't give any experience if there is no enemy in the opposite team? (Default 1)
• smrpg_enemies_not_afk - Don't give any experience if all enemies are currently AFK? (Default 1)
• smrpg_debug - Turns on debug mode for this plugin. More logs. (Default 0)
• smrpg_save_data - If disabled, the database won't be updated (this means player data won't be saved!) (Default 1)
• smrpg_save_interval - Interval (in seconds) that player data is auto saved (0 = off) (Default 150)
• smrpg_player_expire - Sets how many days until an unused player account is deleted (0 = never) (Default 30)
• smrpg_allow_selfreset - Are players allowed to reset their own rpg stats in the settings menu? (Default 1)
• smrpg_allow_sell_disabled_upgrade - Allow players to sell a level of an upgrade they already purchased even if the upgrade is disabled? (Default 0)
• smrpg_bot_maxlevel - The maximum level a bot can reach until its stats are reset (0 = infinite) (Default 250)
• smrpg_bot_maxlevel_reset - Reset the bot to level 1, if the bot reaches the maxlevel for bots? (Default 1)
• smrpg_player_maxlevel - The maximum level a player can reach until he stops getting more experience. (0 = infinite) (Default 0)
• smrpg_player_maxlevel_reset - Reset the player to level 1, if the player reaches the player maxlevel? (Default 0)
• smrpg_bot_kill_player - Bots earn experience for interacting with real players? (Default 1)
• smrpg_player_kill_bot - Real players earn experience for interacting with bots? (Default 1)
• smrpg_bot_kill_bot - Bots earn experience for interacting with bots? (Default 1)
• smrpg_announce_newlvl - Global announcement when a player reaches a new level (1 = enable, 0 = disable) (Default 1)
• smrpg_afk_time - After how many seconds of idleing is the player flagged as AFK? (0 = off) (Default 30)
• smrpg_spawn_protect_noxp - Don't give any experience for actions against players who just spawned and haven't pressed any buttons yet? (Default 1)
• smrpg_exp_notice - Sends notifications to players when they gain Experience (Default 1)
• smrpg_exp_max - Maximum experience that will ever be required (Default 50000)
• smrpg_exp_start - Experience required for Level 1 (Default 250)
• smrpg_exp_inc - Increment experience required for each level (until smrpg_exp_max) (Default 50)
• smrpg_exp_damage - Experience for hurting an enemy multiplied by the damage done (Default 1.0)
• smrpg_exp_kill - Experience for a kill multiplied by the victim's level (Default 15.0)
• smrpg_exp_kill_bonus - Extra constant experience to give on top of the regular experience on a kill. (Default 0.0)
• smrpg_exp_kill_max - Maximum experience a player can ever earn for killing someone. (0 = unlimited) (Default 0.0)
• smrpg_exp_teamwin - Experience multipled by the experience required and the team ratio given to a team for completing the objective (Default 0.15)
• smrpg_exp_use_teamratio - Scale the experience for team events by the team ratio? This is e.g. used to lower the amount of experience earned, when a winning team has more players than the other. (Default 1)
• smrpg_lastexperience_count - How many times should we remember why each player got some experience in the recent past? (Default 50)
• smrpg_level_start - Starting level for new players. (Default 1)
• smrpg_level_start_give_credits - Give the players the credits for all additional start levels as if they'd leveled up themselves? (Default 1)
• smrpg_upgrade_start_levels_free - Don't charge the players for the initial upgrade levels (smrpg__startlevel)? (Default 1)
• smrpg_credits_inc - Credits given to each new level (Default 5)
• smrpg_credits_start - Starting credits for Level 1 (Default 0)
• smrpg_sale_percent - Percentage of credits a player gets for selling an upgrade (Default 0.75)
• smrpg_ignore_level_barrier - Ignore the hardcoded maxlevels for the upgrades and allow to set the maxlevel as high as you want. THIS MIGHT BE BAD! (Default 0)
• smrpg_allow_present_upgrade_usage - Allow players to use the upgrades they already have levels for, if they normally wouldn't have access to the upgrade due to the adminflags.\nThis allows admins to give upgrades to players they aren't able to buy themselves. (Default 0)
• smrpg_disable_level_selection - Don't allow players to change the selected levels of their upgrades to a lower level than they already purchased? (Default 0)
• smrpg_show_maxlevel_in_menu - Show the maxlevel of an upgrade in the upgrade buy, sell and info menus? (Default 0)
• smrpg_show_upgrades_teamlock - Show the upgrades if they are locked to the other team?
  • 0: Don't show teamlocked upgrades at all.
  • 1: Show upgrades if the player already bought a level while being in the other team.
  • 2: Always show all upgrades. (Default 1)
• smrpg_buy_upgrades_teamlock - Allow players to buy upgrades of the other team, even if they can't use them in the current team? (Default 0)
• smrpg_show_teamlock_notice_own_team - Always show the team restriction of the upgrade in the menu, even if the player is in the correct team? (Default 0)
• smrpg_show_upgrade_purchase_in_chat - Show a message to all in chat when a player buys an upgrade. (Default 0)
• smrpg_show_menu_on_levelup - Show the rpg menu when a player levels up by default? Players can change it in their settings individually afterwards. (Default 0)
• smrpg_fade_screen_on_levelup - Fade the screen golden when a player levels up by default? Players can change it in their settings individually afterwards. (Default 1)
• smrpg_fade_screen_on_levelup_color - RGBA color to fade the screen in for a short time after levelup. Default is a golden shine. (Default 255 215 0 40)

SM:RPG modules

There are several optional modules available. Each of them will generate it's own config file in [mod]/cfg/sourcemod/plugin.<module>.cfg.

smrpg_antisuicide Anti-Selfkill

Punishes players for suiciding.

• smrpg_antiselfkill_lastattack - Only take experience, if the selfkiller got attacked by someone in the last x seconds. (Default 10)
• smrpg_antiselfkill_exppunish - Take x% of the experience required for the next level. (Default 0.1)

smrpg_chattags Chat Tags

Add RPG level and/or rank in front of chat messages. There are two chat processors supported which can be chosen using the USE_SIMPLE_PROCESSOR define while compiling. By default it will compile using the Chat Processor, but it optionally can be compiled to support the old Simple Chat Processor too. In the snapshot builds, the smrpg_chattags_cp.smx uses the Chat Processor and the smrpg_chattags_scp.smx uses the Simple Chat Processor.

• smrpg_chattags_maxrank - Show the rank of the player up until this value in front of his name in chat. -1 to disable, 0 to show for everyone. (Default 10)
• smrpg_chattags_showlevel - Show the level of the player in front of his name in chat? (Default 1)

smrpg_chatxpstats Chat Experience Stats

Shows some RPG stats on events in chat.

• smrpg_chatxpstats_printkillxp - Show experience earned for last kill in chat by default? (Default 0)
• smrpg_chatxpstats_printlifexp - Show total experience earned during last life in chat by default? (Default 0)

smrpg_commandlist Command List

Teaches players about available rpg commands.

• smrpg_commandadvert_interval - Show the description of an available commmand in chat every x seconds. (0 = disabled) (Default 300)

smrpg_cstrike Counter-Strike Experience Module

Counter-Strike specific calculations for SM:RPG

• smrpg_exp_non_objective_teamwin - Should the winning team get smrpg_exp_teamwin experience for other reasons than completing an objective like killing all players of the enemy team or a timeout? (Default 0)
• smrpg_exp_kill_assist - Experience for assisting in killing a player multiplied by the victim's level (Default 10.0)
• smrpg_exp_headshot - Experience extra for a headshot (Default 50.0)
• smrpg_exp_bombplanted - Experience multipled by the experience required for the player's next level and the team ratio given for planting the bomb (Default 0.15)
• smrpg_exp_bombdefused - Experience multipled by the experience required for the player's next level and the team ratio given for defusing the bomb (Default 0.30)
• smrpg_exp_bombexploded - Experience multipled by the experience required for the player's next level and the team ratio given to the bomb planter when it explodes (Default 0.20)
• smrpg_exp_hostage - Experience multipled by the experience required for the player's next level and the team ratio for rescuing a hostage (Default 0.10)
• smrpg_exp_vipescaped - Experience multipled by the experience required for the player's next level and the team ratio given to the vip when the vip escapes (Default 0.35)
• smrpg_exp_dominating - Experience for dominating an enemy multiplied by the victim's level. (Default 5.0)
• smrpg_exp_revenge - Experience for killing a dominating enemy in revenge multiplied by the attackers's level. (Default 8.0)
• smrpg_exp_dz_place_1 - Experience for first place in a Danger Zone match. (Default 10000)
• smrpg_exp_dz_place_2 - Experience for second place in a Danger Zone match. (Default 7500)
• smrpg_exp_dz_place_3 - Experience for third place in a Danger Zone match. (Default 5000)
• smrpg_bot_exp_objectives - Should bots earn experience for completing objectives (bomb, hostage, ..)? (Default 1)
• smrpg_mvp_level - Show player level as MVP stars on the scoreboard? (Default 1)
• smrpg_anti_knifelevel - Stop giving exp to players who knife each other too often in a time frame? (Default 1)

smrpg_effects Effect Hub

Central place for effects.

• smrpg_credit_ignite_attacker - Credit fire damage to the attacker which ignited the victim? (Default 1)

smrpg_gifting Credit Gifting

Players are able to gift credits to other players

• smrpg_gifting_minlevel - The minimum level a player has to be to be allowed to gift credits to other players. (Default 10)

smrpg_keyhint_info Stats Info Panel

Shows some RPG stats in a panel on the screen

• smrpg_hide_infopanel_default - Hide the info panel by default for new players? They'll have to enable it themselves. (Default 0)

smrpg_resetstats Reset interval

Resets the stats every x months

• smrpg_resetstats_firstreset - The date of the first reset which is used as a base to get the coming reset dates. Format yyyy-mm-dd. (Default 2014-02-01)
• smrpg_resetstats_months - After how many months shall we reset the stats again? (Default 2)
• smrpg_resetstats_top10_maxlevel - When the top 10 players total levels add together to this maxlevel, the server is reset. (0 to disable) (Default 0)
• smrpg_resetstats_autoreset - Reset the database automatically when one of the reset conditions is true? (Default 0)

smrpg_turbomode Turbo Mode

Highers levelup rates for the current map. Stats are not saved.

• smrpg_turbomode_enabled - Enable SM:RPG turbo mode with higher experience and credits rates. (Default 0)
• smrpg_turbomode_announce - Announce turbomode to all players in chat when it's enabled. (Default 1)
• smrpg_turbomode_persist_changes - Keep the player's stat changes while turbo mode is active and don't set them to level 1 beforehand? (Default 0)
• smrpg_turbomode_expmultiplier - Multiply all earned experience by this value. (Default 3)
• smrpg_turbomode_creditsmultiplier - Multiply all earned credits by this value. (Default 2)

Upgrade configuration

Every upgrade will generate a config file with a set of default convars. Upgrades might add additional individual convars, which will show up in the upgrade's config file in [mod]/cfg/sourcemod/smrpg/smrpg_upgrade_example.cfg. Replace example with the upgrade's short name in the examples below.

• smrpg_example_enable - Enables (1) or disables (0) the Example upgrade.
• smrpg_example_maxlevel - Example upgrade maximum level. This is the maximum level players can reach for this upgrade. When changed, all players who bought a higher level before are refunded with the full upgrade costs and set down to the new maxlevel.
• smrpg_example_startlevel - Example upgrade start level. The initial levels players get of this upgrade when they first join the server. (Has to be lower than the upgrade's maxlevel.)
• smrpg_example_cost - Example upgrade start cost. The initial amount of credits the first level of this upgrade costs.
• smrpg_example_icost - Example upgrade cost increment for each level. The amount of credits added to the costs for each level: Buy upgrade level x -> startcost + x * incrementcost.
• smrpg_example_adminflag - Required admin flag to use this upgrade. Leave blank to allow everyone to use this upgrade. This also checks for a "smrpg_upgrade_example" admin override for permissions.
• smrpg_example_allowbots - Allow bots to use the Example upgrade?
• smrpg_example_teamlock - Restrict access to the %s upgrade to a team? Options:
  • 0: Disable restriction and allow the upgrade to be used by players in any team.
  • 2: Only allow players of the RED/Terrorist team to use this upgrade.
  • 3: Only allow players of the BLU/Counter-Terrorist team to use this upgrade.