[alongub]

Donator

This plugin gives your donators a little extra by granting them HP, armor, speed, glow, etc. It is a port of the original AMX Mod X plugin to SourceMod.

It was sponsored by the California-based Kung Fu Comedy community.

Configuration

You can configure different donation ranks and assign different players to them. The ranks config file (configs/donator/ranks.txt) looks like:

"Ranks"
{
	"Starter"
	{
		"level"			"1"
		"health"		"1.0"
		"armor"			"1.0"
		"glow"			"255"
		"speed"			"1.0"
		"gravity"		"1.0"
	}

	"Medium"
	{
		"level"			"2"
		"health"		"1.1"
		"armor"			"1.1"
		"glow"			"230"
		"speed"			"1.1"
		"gravity"		"0.9"
	}

        ...
}

Any admin with the RCON flag access can add donators and set their rank through his admin menu.

The donators list file (configs/donator/donators_simple.ini), is fully compatible to the original plugin file and is very similar to admins_simple.ini:

//
// READ THIS CAREFULLY! 
//
// For each donator, you need two settings:
//  "identity"		"ranklevel"
//
// For the Identity, you can use a SteamId.
// For the Rank level, you can use an integer value that represents the rank level.
//
// So if you have the following rank in configs/donator/ranks.txt:
//
// "Hardcore Donator"
// {
// 		"level"		"8"
//		"gravity"	"1.5"
//		...
// }
//
// And you want to make STEAM_0:X:XXXXXXX a hardcore donator, type 8 in the rank level.
//
////////////////////////////////
// Examples: (do not put // in front of real lines, as // means 'comment')
//
//   "STEAM_0:1:1634871"		"1"
//   "STEAM_0:0:0512161"		"2"
//   "STEAM_0:0:1451571"		"8"
//
//////////////////////////////

Database Support

Using a database to store donators is completely optional, but highly recommended. The donators_simple.cfg file is mainly for comparability with the original AMX Mod X plugin.

To add database support, just add the following lines to configs/databases.cfg, depending on your DB type of choice.

MySQL

"donator"
{
	"driver"			"mysql"
	"host"				"127.0.0.1"
	"database"			"donator"
	"user"				"user"
	"pass"				"pass"
}

SQLite

"donator"
{
	"driver"			"sqlite"
	"database"			"donator"
}

Cvars

• sm_donator_gravity - Sets whether gravity boost is enabled for donators.
• sm_donator_health - Sets whether health boost is enabled for donators.
• sm_donator_glow -Sets whether glow is enabled for donators.
• sm_donator_armor - Sets whether armor boost is enabled for donators.
• sm_donator_speed - Sets whether speed boost is enabled for donators.
• sm_donator_healthtokiller - When a non-donator kills a donator, give them this value of his health, in percent.

Change Log

1.0.2 (8 February 2012)

• Added optional MySQL and SQLite support.
• Added a public version cvar.
• Added a cvar that represents the amount of health to give to a non-donator after killing a donator, in percent.
• Changed health and armor values in the ranks configuration file to be multipliers and not absolute values (=> better support with games like TF2).
• Replaced some deprecated functions.

1.0.1 (31 January 2012)

• Changed armor default value to be the HP value.

1.0.0 (28 January 2012)

• Initial Release

Download

The plugin and the config files, as well as the full source code are available on the following zip file:

http://dl.dropbox.com/u/16304603/donator-1.0.2.zip

[ositoe]

Lovin the Plug-in !!!! Sweet!

[Jasonbourne]

Plugins that make for unequal game play , wouldn't this drive non donators away

[nightrider]

Interesting idea plugin, thank you alongub

The plugin could be used for non game changing settings.
Specifically the glow, but it would be of diminishing value.

[alongub]

Originally Posted by Jasonbourne Plugins that make for unequal game play , wouldn't this drive non donators away

Not necessarily, if you balance your configuration correctly.

The default configuration in the ZIP file is completely unbalanced though.

[Zephyrus]

Originally Posted by alongub Not necessarily, if you balance your configuration correctly. The default configuration in the ZIP file is completely unbalanced though.

how could giving someone extra hp be balanced?

[alongub]

Originally Posted by Zephyrus how could giving someone extra hp be balanced?

Originally Posted by alongub sm_donator_health - Sets whether health boost is enabled for donators.

[Jasonbourne]

is it balanced with donator health enabled?

[alongub]

Originally Posted by Jasonbourne is it balanced with donator health enabled?

Possibly, if you set it to grant minimal health amounts.

[Horsedick]

I think many miss the point of this plugin.... I created something similar for my "donators" for my servers but they are TRADE servers - so they get to do all kinds of fun things. Much like what RTD is for... this isn't something you would likely use on a regular playing server...if it was then I would imagin it would have to be posted as a notice of the MOTD upon entry so people know and tags were adjusted as such.