== Standard Zip format ==
Any plugins requiring supporting files would need to upload a zip file containing them. This zip file should be based on the sourcemod directory, so that if you were to extract it to the sourcemod directory on the server, everything would go to the correct place.

Example:
<blockquote>
configs/admin_myadmin.cfg
gamedata/obscuregame.gamedata.txt
translations/myplugin/phrases.txt
</blockquote>

This zip file should be named the same as your plugins name (IE, if your compiled plugin is "adminfly.smx", this file should be "adminfly.zip")

Left 4 Voting

2008-11-27T05:47:02Z

Devicenull: /* Example voting plugin */

Left 4 Dead has a new VGUI voting system, it's controlled by a bunch of events. You can use either a string from the resource file, or L4D_TargetID_Player which will let you create any vote you want.

== How voting works ==
Server begins by sending a vote_started event, followed by a vote_changed event. Client's use the "Vote" command to register their votes, after which the server sends a vote_cast_yes or vote_case_no event, along with a vote_changed event.

When the vote is complete, the server sends vote_ended, followed by either vote_passed or vote_failed.

== Example voting plugin ==
This is a basic plugin that starts a vote, "Is gaben fat?". It does not ensure the same client does not vote multiple times, nor does it actually kick the user.

<pre>#include <sourcemod>
new yesvotes;
new novotes;
#define MAX_VOTES 4

public OnPluginStart()
{
RegConsoleCmd("testvote",Callvote_Handler);
RegConsoleCmd("Vote",vote);
}
public Action:Callvote_Handler(client, args)
{
new Handle:msg = CreateEvent("vote_started");
SetEventString(msg,"issue","#L4D_TargetID_Player");
SetEventString(msg,"param1","Is gaben fat?");
SetEventInt(msg,"team",0);
SetEventInt(msg,"initiator",0);
FireEvent(msg);

yesvotes = 0;
novotes = 0;
UpdateVotes();

return Plugin_Handled;
}
public UpdateVotes()
{
new Handle:msg = CreateEvent("vote_changed");
SetEventInt(msg,"yesVotes",yesvotes);
SetEventInt(msg,"noVotes",novotes);
SetEventInt(msg,"potentialVotes",MAX_VOTES);
FireEvent(msg);

if (yesvotes+novotes == MAX_VOTES)
{
PrintToServer("voting complete!");
msg = CreateEvent("vote_ended");
FireEvent(msg);
if (yesvotes > novotes)
{
msg = CreateEvent("vote_passed");
SetEventString(msg,"details","#L4D_TargetID_Player");
SetEventString(msg,"param1","Gaben is fat");
SetEventInt(msg,"team",0);
FireEvent(msg);
}
else
{
msg = CreateEvent("vote_failed");
SetEventInt(msg,"team",0);
FireEvent(msg);
}
}
}
public Action:vote(client, args)
{
new String:arg[8];
GetCmdArg(1,arg,8);
PrintToServer("Got vote %s from %i",arg,client);
if (strcmp(arg,"Yes",true) == 0)
{
yesvotes++;
}
else if (strcmp(arg,"No",true) == 0)
{
novotes++;
}

UpdateVotes();
return Plugin_Continue;
}</pre>

See the following images for examples what this looks like:

http://devicenull.org/temp/l4d_question.jpg

http://devicenull.org/temp/l4d_result.jpg

2006-06-04T23:04:45Z

Devicenull: Added global banlist

= Open Source Plugins for SourceMM =
This page lists known plugins with available source code. Please check the licenses for each one as they may not truly be "open source."
 
== Basic Templates ==
=== stub_mm ===
Author: [[User:BAILOPAN|BAILOPAN]] 
Description: minmum implentation of a valid SourceMM plugin 
Features: starting template 
Download: Included in the SourceMM source code package: [http://prdownloads.sourceforge.net/sourcemm/sourcemm-1.2.2-source.tar.gz?download prdownloads.sourceforge.net/sourcemm/sourcemm-1.2.2-source.tar.gz?download]
 
=== sample_mm ===
Author: [[User:BAILOPAN|BAILOPAN]] 
Description: implements the features of the standard Valve server plugin from the SDK 
Features: starting template with similar functionality to the Valve sample_plugin 
Download: Included in the SourceMM source code package: [http://prdownloads.sourceforge.net/sourcemm/sourcemm-1.2.2-source.tar.gz?download prdownloads.sourceforge.net/sourcemm/sourcemm-1.2.2-source.tar.gz?download]
 
=== sample2_mm ===
Author: [[User:BAILOPAN|BAILOPAN]], edited by [[User:L._Duke|L. Duke]] 
Description: fixes (by inheriting from IGameEventListener2 instead of hooking FireGameEvent) the problem in sample_mm plugin where some events are not received 
Features: starting template with similar functionality to the Valve sample_plugin 
Download: [http://www.sourcemod.net/forums/viewtopic.php?p=34891 www.sourcemod.net/forums/viewtopic.php?p=34891] (you must be logged in to view the download link)
 

== Functional Plugins ==
=== Basic Admin Tool (BAT) ===
Author: [[User:EKS|EKS]] 
Description: Provides basic admin functions 
Features: Kick, ban, menus, reserved slots, timeleft/nextmap say commands, etc. 
Download: [http://www.sourcemod.net/forums/viewtopic.php?t=2923 www.sourcemod.net/forums/viewtopic.php?t=2923]
 
=== CS:S Weapon Restrictions 2 ===
Author: [[User:L._Duke|L. Duke]] 
Description: Prevents players from picking up restricted weapons (if bought, they fall to the ground). Also includes an option to remove restricted weapons from the game. 
Features: Hook CCSPlayer::Weapon_CanUse(CBaseCombatWeapon *pWeapon) and returns false for restricted weapons. Also shows how to use virtual functions on weapons such as Delete()and GetName() and on players for Weapon_GetSlot(int) and Drop(CBaseCombatWeapon*). 
Download: [http://www.sourcemod.net/forums/viewtopic.php?p=34892 www.sourcemod.net/forums/viewtopic.php?p=34892]
 
=== Last Users Connected ===
Author: [[User:devicenull|devicenull]] 
Description: With this plugin, every player who comes onto your server has their steamid logged, along with any name they used on the server. You can then either view the names/steamid's of the last people to disconnect, or you can search for a name/steamid and see everyone who has used that name. 
Features: shows how to embed sqlite3, send basic messages/basic hooks. 
Download: [http://www.sourcemod.net/forums/viewtopic.php?t=3339 http://www.sourcemod.net/forums/viewtopic.php?t=3339]
 
=== Stripper:Source ===
Author: [[User:BAILOPAN|BAILOPAN]] 
Description: You can add any type of entity - hostage, spawn point, physics prop, permanently to the map. You can also filter out entities for deletion, either by specific entries or regular expressions. Stripper:Source lets you define global rules and per-map rules. It also lets other plugins (both SourceMM plugins and Server Plugins) use its API. 
Features: shows how to edit the map entity lump in memory to change map entities 
Download: [http://www.sourcemod.net/forums/viewtopic.php?t=3008 www.sourcemod.net/forums/viewtopic.php?t=3008]
 
=== Global Banlist===
Author: [[User:devicenull|devicenull]] 
Description: This plugin allows srcds to reguarly connect to an external PHP page, and download updates about it's banlist. Srcds then stores these in a SQLite database. 
Features: Embedding sqlite, using pthreads, using libcurl. 
Download: [http://www.sourcemod.net/forums/viewtopic.php?t=3539]http://www.sourcemod.net/forums/viewtopic.php?t=3539]
 
=== Anti-Griefer ===
Author: [[User:devicenull|devicenull]] 
Description: This plugin is for the mod SourceForts. In keeps track of what player unfreezes or freezes a block, and allows any other player to retrieve this information by aiming at a block. 
Features: Basic VFuncs, listening for events, partial traceline (The method used for traceline might not be effective for any other mod) 
Download: [http://www.sourcemod.net/forums/viewtopic.php?t=3652]http://www.sourcemod.net/forums/viewtopic.php?t=3652]
 
[[Category:Documentation (SourceMM)]]