[教程]自己编写Sourcemod插件

翅膀君的Life

今天我带来一个十分(Hard)的教程.希望大家能学会~
9 _* ~/ t9 z( P8 Q7 s5 h7 Z
, Z( T4 u& h  [: y3 s- }
; ?! \* p- o- J& ]' g4 i0 F" E如何编译Sourcemod插件/应用下载:
* q) x3 A& e+ ^  H8 J9 ^2 D% ~我们需要一个在中国已经找不到的软件( PawnStudio.zip (1.7 MB, 下载次数: 17140)

2014-3-24 19:58 上传

点击文件名下载附件 )这个是在外国也是很难找到滴.所以请大家收藏好哟~
7 q7 t' W8 O3 N5 \
* Y5 ?0 ~, R% \# N  R打开界面.一大堆英文.先不管,我们用这个软件可以对某个插件进行重新编译以及更换ConsleSv等
* \+ j) h" a" b
---如何更改插件:
  x8 G  f9 @' B$ {* P# [7 U8 W点击File->open file找到你要的源码(注意,是.sp许多人误会成.smx了)
/ i* D7 @* E, ?6 T9 L% L/ d$ M打开以后出现许多版本号以及其他信息.先来了解一些
# V. G  U  G, O  Q( I如果显示着一下英文字母:

/**
$ A& j) l1 Y9 S" I4 [1 q3 {& N * vim: set ts=4 :
" D7 a1 ]6 g. |5 T# ^( M, L * =============================================================================
5 |. i. a  f5 S, n% f * SourceMod Admin Menu Plugin
! z" @; M! w! W* k4 ~4 A  j * Creates the base admin menu, for plugins to add items to.
! r4 B$ u* P2 [( S *
( l2 M* q" B8 K1 I* r' Q * SourceMod (C)2004-2008 AlliedModders LLC.  All rights reserved.
  w& l" Z2 `& [ * =============================================================================
*
3 R# W# J) G# z3 K * This program is free software; you can redistribute it and/or modify it under
0 l, E9 I4 q, t& ~. R# D * the terms of the GNU General Public License, version 3.0, as published by the
* Free Software Foundation.
8 S4 S1 }* X5 p' Y *
* This program is distributed in the hope that it will be useful, but WITHOUT
0 O! M& p' N6 E" Q * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
3 y& [! M3 ~" N# c5 a) y * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
3 M2 H  e: H7 t; ? * details.
*
& Z' @# k; D/ G$ ?/ q/ {8 | * You should have received a copy of the GNU General Public License along with
* this program.  If not, see <http://www.gnu.org/licenses/>.
*
2 w' E0 P! ^  f$ |( {% U8 H5 P * As a special exception, AlliedModders LLC gives you permission to link the
9 Z1 u7 S/ y/ _2 q% [9 ? * code of this program (as well as its derivative works) to "Half-Life 2," the
* "Source Engine," the "SourcePawn JIT," and any Game MODs that run on software
& E* x0 O1 v6 M" I9 H * by the Valve Corporation.  You must obey the GNU General Public License in
0 I( }3 `- v! I* W * all respects for all other code used.  Additionally, AlliedModders LLC grants
* this exception to all derivative works.  AlliedModders LLC defines further
& N! z* n3 z7 B( n+ G * exceptions, found in LICENSE.txt (as of this writing, version JULY-31-2007),
* or <http://www.sourcemod.net/license.php>.
*
* Version: $Id$
*/

那就证明你修改的是Sourcemod内置的,建议不要修改以及应用,以免服务端崩溃
" l2 S* p9 h& \7 o1 A往下看可以看到Public Plugin也就是自述文本,这里修改作者呀,链接什么的最适合了

翻译-可以使用

public OnPluginStart()
{
        LoadTranslations("common.phrases");
        LoadTranslations("adminmenu.phrases");
, W9 W, ], y  q7 R% j) B  D5 T       
        hOnAdminMenuCreated = CreateGlobalForward("OnAdminMenuCreated", ET_Ignore, Param_Cell);
0 [* N8 U: d' n. C  z  B- O        hOnAdminMenuReady = CreateGlobalForward("OnAdminMenuReady", ET_Ignore, Param_Cell);

2 v+ ^0 _' V7 B        RegAdminCmd("指令", Command_DisplayMenu, ADMFLAG_GENERIC, "Displays the admin menu");
}

& \' b+ B/ a4 D! ^7 ]. F5 i这个指令来表示.要载入翻译文件有common.phrases和adminmenu.phrases~
  K# k9 N" t4 N9 p( h% F这里我是以Adminmenu例子修改的.要是想要载入其他翻译文件也是同样的道理
8 t& J! ?" d0 I; R9 `% m0 H# H若你要载入中文的翻译文件的话是不行的..那个需要在Core里设置!
/ e7 i: q: q2 T/ w$ e2 B
似乎基本上修改也不能修改太大..也就讲那么多...

9 o: v; o! q) d- J---如何创建插件
点击一张白纸的图标.进入创建插件界面.我们首先看到是AMX MOD X我们使用的是Sourcemod~别选错了
Soucrmod里又来选择了共3个,其中2个是特殊的,所以选择SourcePawnScript~
显示出:

/* Plugin Template generated by Pawn Studio */
( n3 c3 C/ B3 H; P- h+ l
: W1 N. Z) w2 [" W+ L% C#include <sourcemod>
- _+ D( N% i$ O- t
public Plugin:myinfo =
+ J( U5 U. w7 b/ p8 l9 U, w{
        name = "New Plugin",
3 g( e, X' ~0 G6 a( f/ V, ^4 _        author = "Unknown",
" A9 `" W; Y) G! \/ ~, f        description = "<- Description ->",
4 Y( a% b% X6 `' k" j; d        version = "1.0",
        url = "<- URL ->"
) ]/ o0 X( a' c4 B}

* t( `+ a% L+ g) k3 B" J5 ^$ i) ^public OnPluginStart()
{
        // Add your own code here...

那就证明创建了一个初始化文本~
  U% t: M7 C$ x1 Q3 m2 L像刚才那样子,先填入Info信息Url等

我来介绍一下很常见的例子:
, a9 Z! _8 b! R比方说，我们要添加一个测试命令显示半条命2如何分解命令参数。一个可能的实现可能是
9 I+ a  J2 P! n& `. c5 f( l8 P

public OnPluginStart()
{
8 f' z9 c+ o! L5 c# {4 K! Y9 T1 B$ f        RegServerCmd("test_command", Command_Test);
0 @: G( m) ^4 C7 N- v}

7 H5 E4 k1 W( z5 Z  A4 |" c& j3 w& Ppublic Action:Command_Test(args)
$ W9 d, T  B9 S{
5 X' g, |3 H" ]        new String:arg[128];
5 F# ?3 a, D! d! {: D        new String:full[256];

/ ]4 B( j3 h2 _' j/ n1 b        GetCmdArgString(full, sizeof(full));
& {) l& y: B* x) ?! `
        PrintToServer("Argument string: %s", full);
. i0 [, y1 u/ q( R7 ]. ~        PrintToServer("Argument count: %d", args);
# r, `8 K, y% m        for (new i=1; i<=args; i++)
        {
. M( [- o5 O' D5 w$ o                GetCmdArg(i, arg, sizeof(arg));
0 e4 ~+ ~" ?( @+ B7 J7 F6 N0 H                PrintToServer("Argument %d: %s", i, arg);
( L1 |& e" ?- r: d/ F" a# |& v        }
  _1 }! R- k# [1 G        return Plugin_Handled;
) u# B$ s8 _; N9 H}

比方说，我们想在服务器上禁用“kickid”命令。有没有真正很好的理由这样做，但举例的缘故：
9 W5 C8 D" {0 a: B$ ^/ q) z. R/ k

public OnPluginStart()
1 r" ]) y6 j* t' d* V{
        RegServerCmd("kickid", Command_KickId);
+ Y) x& h/ f3 m, y+ [) Y}

public Action:Command_Kickid(args)
( m/ p, g  v. p1 E( w0 @3 ~0 l6 M{
        return Plugin_Handled;
. `: R5 q. {1 [( k}

public OnPluginStart()
5 A9 @2 [& U( t% p2 q{
$ G8 V  G* A, @3 A7 Y2 A0 j        RegConsoleCmd("test_command", Command_Test);
}
4 a1 ]6 {- `. [8 j& W
, _0 h0 z$ G! k% O/ kpublic Action:Command_Test(client, args)
{
        new String:arg[128];
        new String:full[256];

# x4 m( h9 u% N1 ?7 T; i3 z        GetCmdArgString(full, sizeof(full));
" G( |+ j7 {7 J+ p7 O
        if (client)
! q+ f# A0 I% S4 `# G        {
: @% y1 i3 ~, T2 k+ r, s- j& v, S0 u                PrintToServer("Command from client: %N", name);
( t8 p, ?! W  I+ z, k) S7 s        } else {
                PrintToServer("Command from server.");
& ?( |! g" j3 k5 t. u: A+ h        }
: n% d1 x( J3 C( d# M8 Y
        PrintToServer("Argument string: %s", full);
        PrintToServer("Argument count: %d", args);
        for (new i=1; i<=args; i++)
        {
                GetCmdArg(i, arg, sizeof(arg));
                PrintToServer("Argument %d: %s", i, arg);
        }
        return Plugin_Handled;
1 Y, i! }+ Z4 t4 R# o5 r8 X* E}

new Handle:ff = INVALID_HANDLE;

/ J5 _- Y2 ^5 k5 _# H7 tpublic OnPluginStart()
{
        AddCommandListener(Command_Say, "say");
8 ^3 G; o2 f8 D5 q; A        AddCommandListener(Command_Say, "say2");
& g9 w0 R* |2 _$ a* c        AddCommandListener(Command_Say, "say_team");

" b0 x0 i, q* y1 K        ff = FindConVar("mp_friendlyfire");
6 a& G* \  }; p* m5 k  E& L}
+ v- m! [- M% [' k, c
public Action:Command_Say(client, const String:command[], argc)
  J9 h5 h% n8 {2 L{
( |% b* S8 y% U+ D0 L) u        decl String:text[192];
/ I, x( G4 G7 S" F1 J9 S) p        new startidx = 0;
- r2 v" T1 M+ X8 V        if (GetCmdArgString(text, sizeof(text)) < 1)
        {
                return Plugin_Continue;
        }

2 I& c% m! G  j        if (text[strlen(text)-1] == '"')
        {
                text[strlen(text)-1] = '\0';
                startidx = 1;
        }

        if (strcmp(command, "say2", false) == 0)
' ?" g. P' [0 K9 _" s4 Y( a& {                startidx += 4;
% f6 K1 p) h; M+ w
        if (strcmp(text[startidx], "ff", false) == 0)
        {
9 \# p& A6 L4 t! o6 ]% ~                if (ff != INVALID_HANDLE)
                {
& c& W+ H, R1 e9 J                        if (GetConVarBool(ff))
3 j* x' q) L7 r8 A                        {
                                PrintToChat(client, "Friendly fire is enabled.");
                        } else {
                                PrintToChat(client, "Friendly fire is disabled.");
                        }
, p; O4 i& E- }7 n# k                        /* Block the client's messsage from broadcasting */
                        return Plugin_Handled;
                }
        }

% a' H& e! X- a5 J& ^        /* Let say continue normally */
        return Plugin_Continue;

一个常见的&#8203;&#8203;例子是挂钩的发言权命令。比方说，我们要告诉FF玩家是否启用时，他们说在游戏的/ FF'。

在我们实现这一点，混淆了公共点的'说'命令是，半条命2（和半条命1），默认情况下，在一个大的带引号的字符串文本发送。这意味着，如果你说“我喜欢热狗，”你的命令将被作为这样的分解：

• 参数字符串：“我喜欢热狗”
• 参数计数：1
• 参数＃1：我喜欢热狗
  ( F1 ?1 U4 d+ [- S  F$ z" H

但是，如果在其控制台的球员 &#8203;&#8203;类型这样的：说我喜欢山药，它会被分解为：

• 参数字符串：我喜欢山药
• 参数计数：3
• 参数＃1：我
• 参数＃2：喜欢
• 参数＃3：山药
  4 v" d% N( W3 k

因此，考虑到这两种情况下，我们将使用GetCmdArgString和手动解析输入。

public OnPluginStart()
7 f4 q0 ^" F( O{
8 n( ]3 B1 j0 U3 ^% X" J6 p& `        RegAdminCmd("admin_kick",
- q8 D2 l$ B1 M% c: _: U                Command_Kick,
                ADMFLAG_KICK,
                "Kicks a player by name");
/ f  o" |  M+ ?5 A' P6 ?}
' I0 ]# R: @0 m! [. r% M+ s
public Action:Command_Kick(client, args)
3 @7 Z0 |- Z6 {$ x{
* z. w$ }0 r2 ^* x9 M* E        if (args < 1)
        {
                PrintToConsole(client, "Usage: admin_kick <name>");
                return Plugin_Handled;
% v5 D& }8 ~) v. N        }
& X  }3 e$ V% a3 h/ w" W& B
1 E& y& F2 P) q6 z2 k  I6 q- @        new String:name[32], target = -1;
        GetCmdArg(1, name, sizeof(name));

        for (new i=1; i<=MaxClients; i++)
0 \. C$ l; M7 r5 N9 x* D        {
                if (!IsClientConnected(i))
                {
! u) \5 X9 d6 m                        continue;
( u5 Z% q- M' Y8 R0 E3 f                }
# A3 i- K+ w4 L* Y& E                decl String:other[32];
                GetClientName(i, other, sizeof(other));
                if (StrEqual(name, other))
                {
                        target = i;
9 i1 t7 U  n2 J5 Z: p                }
        }
0 j' T6 y8 N- l* D8 F3 G
% i% z" O1 T" _8 D8 c        if (target == -1)
4 m& l! ^0 L7 `0 S2 b9 U        {
. f: O# I; G! L. _+ o5 m3 Y                PrintToConsole(client, "Could not find any player with the name: \"%s\"", name);
; x. U. I/ S( S9 S                return Plugin_Handled;
        }
! o* c0 B+ r3 g+ q+ n& b; ]+ G+ a
4 t% c+ R) H7 L: r/ W6 q) o        ServerCommand("kickid %d", GetClientUserId(target));
5 M% Y# b- E" x
        return Plugin_Handled;

让我们来创建它通过其全名踢另一Player一个简单的管理命令。
' y- W' F2 ?$ y* `2 f

7 q* l2 N5 b: M具体就介绍到这里了

& S3 Y2 C3 M. ?6 B$ G9 d+ }
. a; i0 v( R  Z4 H; I/ T$ ^+ b) ]

Lovemiku

果然是看不懂的节奏- -翅膀君，我加群了能通过一下吗？

无双

Lovemiku 发表于 2014-4-17 18:18
果然是看不懂的节奏- -翅膀君，我加群了能通过一下吗？

# U4 u, I" Z4 M: J没有见到你的加群申请

Lovemiku

无双 发表于 2014-4-18 09:03
没有见到你的加群申请

我都加好几回了，现在我又加一回。

无双

Lovemiku 发表于 2014-4-27 13:17
" s7 |* t9 n: `2 e& ?1 x, v' C6 W我都加好几回了，现在我又加一回。

; O9 {) [7 o# x' @1 u6 U4 ~还是没有成功吗？加我QQ吧 344380788 注明你的论坛id

Lovemiku

无双 发表于 2014-4-29 12:36
: v9 U* ^8 r$ f* [7 _还是没有成功吗？加我QQ吧 344380788 注明你的论坛id

谢谢，我已经加上了。