Shooting King: Using proper table header

2021-09-28T22:39:51Z

Using proper table header

Yurizhou: /* 入门 */

2019-09-09T04:37:20Z

‎入门

Yurizhou: Created page with "== 开始熟悉 == === 服务器控制台 === 你刚刚安装了sourcemod并保证它正常运行。为此你执行了Installing_SourceMod#Checki..."

2019-09-08T15:24:30Z

Created page with "== 开始熟悉 == === 服务器控制台 === 你刚刚安装了sourcemod并保证它正常运行。为此你执行了Installing_SourceMod#Checki..."

New page

== 开始熟悉 ==
=== 服务器控制台 ===
你刚刚[[Installing_SourceMod/zh|安装了sourcemod]]并保证它正常运行。为此你执行了[[Installing_SourceMod#Checking_the_Install|Checking the Install]]章节中的指令并且在服务器控制台中第一次尝试了命令。

要熟悉控制台，可以直接用服务器控制台或者rcon指令。(例如使用[http://www.hlsw.org/ HLSW]).

至少尝试以下指令
* sm
* sm version
* sm plugins
* sm plugins list
* sm plugins reload 1
* sm plugins refresh
* sm plugins unload funvotes
* sm plugins load funvotes
* sm exts list

=== 文件结构 ===
你也要熟悉sourcemod的文件结构，这意味着
Also get to know the directory layout sourcemod is using, this means:
# 看看有哪些文件夹
# 文件夹中有什么文件
# 文件中有什么(使用记事本打开 (推荐: notepad++[https://notepad-plus-plus.org] 或者其他第三方编辑器)).

{| style="width:600px;" cellpadding="5"
|- class="t2th"
|文件夹
|描述
|- class="t2td"
| '''/bin'''
| 忽略这个文件夹，这里面是sourcemod的二进制文件
|- class="t2td"
| '''/configs'''
| 这是sourcemod和插件默认放置配置文件的地方。
查看里面所有文件至少一次，尝试去理解它们
|- class="t2td"
| '''/data'''
| 暂时忽略这个文件夹
|- class="t2td"
| '''/extensions'''
| 这是拓展安装的位置。你可能注意到了许多拓展出现了多次，这是因为不同的游戏引擎需要基于他们SDK的独特的拓展。
拿bintools举例：
{| style="width:450px;" cellpadding="5"
|- class="t1td"
| '''bintools.ext.dll'''
| 这是原版的source引擎拓展
|- class="t1td"
| '''bintools.ext.1.ep1.dll'''
| "老版Metamod" (Insurgency，Eternal Silence和其他EP1的mods)
|- class="t1td"
| '''bintools.ext.2.darkm.dll'''
| 这是Dark Messiah的拓展
|- class="t1td"
| '''bintools.ext.2.ep2.dll'''
| 这是"OrangeBox"引擎下的ZPS, AOC, PVKII之类的拓展
|- class="t1td"
| '''bintools.ext.2.ep2v.dll'''
| 这是"OrangeBoxValve"引擎下的CSS,TF2,DODS,HL2DM,GMOD之类的拓展
|- class="t1td"
| '''bintools.ext.2.l4d.dll'''
| 这是L4D的拓展
|- class="t1td"
| '''bintools.ext.2.l4d2.dll'''
| 这是L4D2的拓展
|- class="t1td"
| '''bintools.ext.2.swarm.dll'''
| 这是Alien Swarm的拓展
|}
|- class="t2td"
| '''/gamedata'''
| 有拓展或者插件使用了游戏引擎提供的功能。例如，如果要重生玩家或者给玩家装备武器，sourcemod需要知道一些函数的前提条件（具体地，偏移和签名这些参数）。这些数据每次更新都会改变，你目前不需要知道更多信息，因为sourcemod有内置的更新其，它会自动的从新的游戏数据文件夹中获取这些数据。
|- class="t2td"
| '''/logs'''
| debug的神器。一切都被记录在这里。如果有人问你日志文件在说什么，或者你遇到了任何错误：复现你的问题，然后看看日志文件然后复制粘贴这些信息。如果你不了解错误原因，发给相关人士处理。
|- class="t2td"
| '''/plugins'''
| 所有插件（.smx文件）都会在sourcemod启动时自动加载。当地图更改时如果文件发生了改变，也会重新加载。
|- class="t2td"
| '''/plugins/disabled'''
| 在这个子文件夹中的插件不会被加载。如果你想要禁用一个插件，就把它从父文件夹中剪切进去。反之亦然。你会发现这个文件夹中有一些你可能想安装的官方插件（例如，rtv换图插件）。
|- class="t2td"
| '''/scripting'''
| 你能看到一些插件的源码。安装插件并不需要放置任何文件在这里，但是我们强烈推荐不要仅仅安装smx文件，最好也带上相应的sp文件。
|- class="t2td"
| '''/translations'''
| 无需多言，这里有许多语言的翻译。我们鼓励插件提供翻译文件，所有你安装插件时也许需要拷贝一些文件到这。
|}

=== 将自己设为管理员 ===
为了便于管理，你应该把自己设为root管理员。
有许多方法来获取服务器权限。这里我们用最简单暴力的方式，但你可能需要查看[[Zh_cn:Adding_Admins_(SourceMod)|增加管理员]] and [[Adding_Groups_(SourceMod)|增加组]]，然后创建一组系统管理员并设置自己的权限。

我们使用最简单的方式，只需要在<tt>sourcemod/configs/</tt>文件夹下的<tt>admins_simple.cfg</tt>文件中加一行：
<pre>"你的steamid" "99:z"</pre>
然后在服务器控制台输入'''sm_reloadadmins'''，你会收到以下回复<tt>[SM] Admin cache has been refreshed.</tt>

=== 尝试启用/禁用插件 ===
如果你看了上面的内容，你应该已经知道如何做了。

如果你看了关于服务器控制台的内容，你也知道了如何测试它了。

但让我们再解释一次，我们想要启用mapchooser（选择地图）插件:
# 复制 <tt>plugins/disabled/mapchooser.smx</tt> 到 <tt>plugins/mapchooser.smx</tt>
# 你可以使用<tt>sm plugins load mapchooser</tt> 或者换图来启用。
# 输入<tt>sm plugins list</tt>来看看当前启用的插件。

如果失败了，查看 [[#怎样检查你的插件是否安装好了|怎样检查sourcemod插件的安装]]?

== 安装插件 ==
=== 基础 ===
对于一些只有源码和二进制文件的插件，例如[http://forums.alliedmods.net/showthread.php?t=74531 Basic AFK Manager]，安装起来十分直接，并且基本和启用官方插件一样。(参考[[#尝试启用/禁用插件|1.4]]). 你复制<tt>.smx</tt> 文件去 <tt>plugins</tt>文件夹， <tt>.sp</tt>文件去<tt>scripting</tt>文件夹。

对于一些复杂的插件，例如[http://forums.alliedmods.net/showthread.php?t=59147 SM Bot Tools],可能需要赋值翻译或者游戏数据到相应的文件夹。但是聪明的开发者会给你一个完美的压缩文件，所有的文件都放在了对应的文件夹中，你只需要将所有东西直接复制到sourcemod文件夹。
'''插件自己的说明永远是第一位的'''

=== 依赖 ===
有一部分插件依赖于其他插件，但是很多插件依赖于一个或多个拓展。拓展通常提供了一些能让插件做更多事情的特性。如果一个插件有依赖项，肯定会在描述页提及，这就需要你自己去找了。

在第三章[[#安装拓展|如何安装拓展]]中学习如何安装拓展。

=== 怎样检查你的插件是否安装好了 ===
当你遇到了插件或者拓展的问题，永远用服务器客户端来解决，不需要管客户端控制台的事情，SourceMod是一个服务器端的插件。

只需要在安装后换图，然后再服务器控制台输入<tt>sm plugins list</tt>。你应该看到了改变。如果你安装的插件没有被列出来，这意味着插件没有被正确地安装。（这意味着这不是插件的错，而是你的错），并且你需要想清楚什么地方做错了。一般而言，你没有把编译后的插件(the <tt>.smx</tt> 文件)放在sourcemod下的<tt>/plugins</tt>文件夹中。

如果插件被列了出来，但是有<tt><Failed></tt>前缀，那就是发生了其他错误。为了获取问题的类型，输入<tt>sm plugins info <plugin id></tt>, replace <tt><plugin id></tt>加上列表中问题插件的名字。你可能会看到

{| style="width:600px;" cellpadding="5"
! scope="col" width="80" |
! scope="col" width="180" |
|- class="t2th"
|错误 || 描述
|- class="t2td"
| '''Could not find translation file'''
| 你没有把翻译文件放到正确的位置。请再一次检查插件页的内容，再一次检查提供的压缩文件。如果真的缺失了翻译文件，报告给开发者，否则自行放置到相应的文件夹。
|- class="t2td"
| '''Native 'xyz' was not found''' 或者 '''Required extension "xyz" file("xyz.ext") not running.'''
| 你安装了旧版本的拓展，或者没有安装需要的拓展。检查你的拓展版本（输入sm exts list）并更新它。
|- class="t2td"
| '''Wrong game'''
| 你用的是其他游戏的插件。停用这个插件。
|}

=== 帮助开发者 ===
如果你竭尽所能，依然无法让插件正常工作，那是相当不正常的事情。插件开发者会认为你没有正常安装这个插件并给你这个页面的链接。'''请避免这样的事情发生''' 给他们充分的证据证明你已经到了无法独自处理问题的地步.告诉他们你已经试过了，并给他控制台的日志文件（如果你无法复制粘贴，也可以给截图）和一切有关信息。

== 安装拓展 ==
=== 基础 ===
拓展和插件类似，但是更加有力。在有插件需要的情况下才会被启用。这意味着，一个拓展如果没有被任何插件依赖，你输入<tt>sm exts list</tt>后看不到它。

一些拓展给其他插件提供了功能(例‘’'如[http://forums.alliedmods.net/showthread.php?t=106748 SDKHooks])，一些拓展直接影响游戏本身。(例如[http://forums.alliedmods.net/showthread.php?t=145218 UnlockBlock]).

=== 拓展名和版本 ===
一些拓展只有一个版本。它们的文件名类似<tt>bintools.ext.dll</tt> for Windows, <tt>bintools.ext.so</tt> for Linux, or <tt>bintools.ext.dylib</tt> for OSX.

另一些拓展基于不同的引擎有多个版本。它们的文件名通常像<tt>[extension name].ext.[MetaMod: Source API version].[Game engine string].[extension]</tt>.

例如，SDKTools在Windows SourceMod中有以下文件

{| class="wikitable"
|-
! 游戏 !! 文件名
|-
| Alien Swarm || <tt>sdktools.ext.2.swarm.dll</tt>
|-
| Bloody Good Time || <tt>sdktools.ext.2.bgt.dll</tt>
|-
| Dark Messiah || <tt>sdktools.ext.2.darkm.dll</tt>
|-
| Episode 1 / Generic non-OB mods || <tt>sdktools.ext.1.ep1.dll</tt>
|-
| Episode 2 / Orange Box / Source 2007 / Generic OB mods || <tt>sdktools.ext.2.ep2.dll</tt>
|-
| E.Y.E: Divine Cybermancy || <tt>sdktools.ext.2.eye.dll</tt>
|-
| Left 4 Dead || <tt>sdktools.ext.2.l4d.dll</tt>
|-
| Left 4 Dead 2 || <tt>sdktools.ext.2.l4d2.dll</tt>
|-
| Source 2009 / Half-Life 2: DeathMatch / Day of Defeat: Source / Counter-Strike: Source / Team Fortress 2 || <tt>sdktools.ext.2.ep2v.dll</tt>
|}

=== 安装一个拓展 ===
这和安装插件很像，所以没必要再说一遍，但我还是做了😂。
安装拓展你只需要复制到<tt>/extensions</tt>文件夹。
'''拓展也可能需要翻译文件和游戏数据，不要遗漏了它们'''

要自动加载拓展，只需要换图或者输入<tt>sm exts load <name of your extension></tt>。谨记，没有被依赖的拓展是不会被自动加载的。

强制加载拓展只需要创建一个空文件，名字为拓展名加上<tt>.autoload</tt>.
* 例如:
** 拓展名是<tt>extensions/sdkhooks.ext.2.ep2v.dll</tt>
** 空文件为<tt>extensions/sdkhooks.autoload</tt>

'''注意：''' 你不能更新一个正在运行的拓展，你需要首先通过<tt>sm unload <拓展名></tt>停用拓展或关闭服务器。否则，你的Linux服务器很容易崩溃，你的Windows服务器则禁止你这样操作。

=== 处理拓展问题 ===
和你之前学到的方式类似。

如何查看拓展是否加载了，或者加载失败了? sm exts list
如何在运行时加载拓展? sm exts load <extension name>

以上都会告诉你 '''为什么''' 失败了。这和[[#怎样检查你的插件是否安装好了|怎样检查你的插件是否安装好了]]章节类似，请确保你看了里面的内容。
至少它会告诉你如何继续。

[[Category:SourceMod Documentation]]

@@ Line 25: / Line 25: @@
 {| style="width:600px;" cellpadding="5"
-  |- class="t2th"
+  !文件夹
- |文件夹
+  !描述
   |- class="t2td"
   | '''/bin'''

@@ Line 1: / Line 1: @@
-== 开始熟悉 ==
+== 入门 ==
 === 服务器控制台 ===
 你刚刚[[Installing_SourceMod/zh|安装了sourcemod]]并保证它正常运行。为此你执行了[[Installing_SourceMod#Checking_the_Install|Checking the Install]]章节中的指令并且在服务器控制台中第一次尝试了命令。
@@ Line 109: / Line 109: @@
 如果失败了，查看 [[#怎样检查你的插件是否安装好了|怎样检查sourcemod插件的安装]]?
 == 安装插件 ==

Managing your Sourcemod installation/zh - Revision history

Shooting King: Using proper table header

Yurizhou: /* 入门 */

Yurizhou: Created page with "== 开始熟悉 == === 服务器控制台 === 你刚刚安装了sourcemod并保证它正常运行。为此你执行了Installing_SourceMod#Checki..."