AlliedModders Wiki - User contributions [en]

Reserved Slots (SourceMod)/zh

2019-09-15T04:35:19Z

Yurizhou: /* 最大管理员通道 */

{{Languages|Reserved Slots (SourceMod)}}
本章的通道的概念有关你加入服务器的成功与否。保留通道指的是服务器为你留了位置（尤其是管理员的保留通道），在你没有使用保留通道的权限时，你不一定能加入一个没有满人的服务器。
==控制台语句==

*[[#保留类型|sm_reserve_type <0|1|2>]]
*[[#保留通道|sm_reserved_slots <#>]]
*[[#隐藏保留通道|sm_hide_slots <0|1>]]
*[[#最大管理员通道|sm_reserve_maxadmins <#>]]
*[[#踢人类型|sm_reserve_kicktype <0|1|2>]]

==保留类型==

sm_reserve_type <0|1|2>

这控制服务器如何保留通道。This controls how reserve slots work on the server (the default is 0).

* <tt>sm_reserve_type 0</tt>

玩家加入时使用公用通道。这保证了至少有一个管理员能在任何时候加入服务器（如果你只给管理员保留通道的权限的话）。这样就可以避免有人告诉你有人开挂，然而服务器没有管理员的境地了。如果一个没有保留通道权限的用户试图加入只剩下保留通道的服务器，那他就会被踢掉。

* <tt>sm_reserve_type 1</tt>

当有保留通道权限的人加入保留通道时，没有保留通道权限中的最不活跃的玩家会被踢出（尤其是观察者）来腾空间。这意味着，保留通道对所有开放，但是在有权限的人来的时候会踢掉某人。（类似高铁火车的站票和坐票）。只有在服务器全是权限玩家时，另一个权限用户才无法加入。这让一些服务器可以做到为特定的人提供更高的游玩权限。这样管理们就能一个一个地加入满人的服务器了:)

* <tt>sm_reserve_type 2</tt> - 只在SourceMod 1.1或更高版本生效

基本类似上一条，但是只要有一定数目的管理到了保留通道，就会停止踢人。这样你就可以给一堆保留通道权限给玩家，但是只有一个是在管理员不多时不可用的。

==保留通道==

sm_reserved_slots <#>

这个控制有多少保留通道。（默认为0）

使用sm_reserve_type 0 控制在服务器满员（对于普通玩家而言）时能加入多少权限用户
使用sm_reserve_type 1 控制有多少保留下来不开放的通道（没必要多于一个）

==隐藏保留通道==

sm_hide_slots <0|1>

这控制插件是否隐藏保留通道的存在。This controls the plugin hides the reserved slots (the default is 0).

如果开启，在服务器窗口就看不到保留通道。例如，一个有2个保留通道的24人服务器，对外只显示22人（除非保留通道被使用了）。
去连接一个显示满员的服务器的保留通道在控制台需要使用'connect ip:port'命令。 (例如 'connect 192.168.1.100:27015')

让保留通道只对普通用户隐藏是不可能的。管理员认证发生在连接至服务器后。因此，最好隐藏保留通道来避免普通用户加进服务器然后又被踢掉。（考虑自动加入这个情况）

==保留通道管理员预留位==

sm_reserve_maxadmins <#> - 只在SourceMod 1.1或更高版本生效。

控制在保留通道被普通用户占用后有多少管理员能加入服务器。(只在sm_reserve_type 2的情况下有意义)

==踢人类型==

sm_reserve_kicktype <0|1|2> - 只在SourceMod 1.1或更高版本生效。

这控制如何选择踢掉的用户。(只在sm_reserve_type 1/2的情况下有意义)

有保留通道权限或者'sm_reskick_immunity'的人永远不会被踢。观察者有限被踢。

0 - 高Ping 
1 - 最长连接时间 
2 - 随机 

==免疫被踢==

为了让用户不因为保留通道插件被踢，他们应该重写'sm_reskick_immunity' (有root权限或者保留通道权限的人已经有了不被踢的权限)。

注意：只在sm_reserve_type 1/2的情况下有意义

你可以在admin_overrides.cfg重写标志 (例如 "sm_reskick_immunity" "o" - 所有有标志 'o'的人免疫踢人 (自定义标志1) '''请参考[[Overriding Command Access (SourceMod)/zh|重写权限]]'''
或者在admin_groups.cfg中重写组的权限 (例如"sm_reskick_immunity" "allow") '''请参考[[Overriding Command Access (SourceMod)/zh|重写权限]]和[[Adding_Groups_(SourceMod)/zh#.E6.96.87.E4.BB.B6.E6.A0.BC.E5.BC.8F|增加组]]'''

然后你就可以把VIP用户或者你希望拥有此权限的用户加入你给了免疫踢人的组了。

==未来==
目前已经有一些被请求过的或者正在考虑当中的新特性，也许会在接下来的SourceMod中发布。也许会允许玩家被重定向至其他服务器，而不是被直接踢出。
[[Category:SourceMod Documentation|Categories]]

User:Yurizhou

2019-09-13T03:17:09Z

Yurizhou: Created page with "Hi, I'm a software engineering student from China. I like CS:Source most; You can find me in [https://steamcommunity.com/profiles/76561198424095916/ steam]. ---- My transl..."

Hi, I'm a software engineering student from China.

I like CS:Source most;

You can find me in [https://steamcommunity.com/profiles/76561198424095916/ steam].

----
My translations may be wrong, so feel free to re-edit them.

Admin Commands (SourceMod)/zh

2019-09-12T17:47:10Z

Yurizhou:

{{Languages|Admin Commands (SourceMod)}}
__FORCETOC__
这个页面展示了SourceMod的主要管理命令。

'''聊天框触发''': 请记住命令不一定必须要控制台输入。命令也可以用聊天框来触发。例如，在聊天框说"!ban bail"会执行"sm_ban"指令并且将结果展示在聊天框。你也可以用"/"来替代"!"来避免别人看到你输入的命令。（你也不希望被人知道你发起了针对某人的投票吧）

=如何选择目标=

'''常见目标''':
<ul>
<li>name - 完整名字或者名字的一部分（如果这一部分只有一个名字对应的话，也就是独特的）</li>
<li>#userid - 如果用户id是数字，你可以用他们的用户id来选择用户。（参考"users"指令）</li>
<li>#steamid - 使用Steam ID来匹配。如果你使用":"，你必须把Steam ID包含在一组双引号(英文引号)中间，否则你就全部用下划线("_")代替。例如，<tt>"#STEAM_0:1:4433"</tt>,<tt>#STEAM_0_1_4433</tt></li>
<li>#<name> - #后使用完整的名字.
<li>@all - 所有用户（对于绝大多数命令有效）</li>
<li>@bots - 所有机器人（对于绝大多数命令有效）</li>
<li>@alive - 所有活着的玩家（对于绝大多数与存活玩家有关的命令有效）</li>
<li>@dead - 所有死亡的玩家（对于绝大多数与死亡玩家有关的命令有效）</li>
<li>@humans - 所有人类玩家（对于绝大多数命令有效）</li>
<li>@aim - 当前你瞄准的玩家</li>
<li>@me - 自己</li>
<li>@!me - 除了自己的所有玩家</li>
</ul>

注意，名字匹配的解析顺序最低，特殊指向（例如#或者@开头的）优先解析。这意味着"@all"会指向所有用户，即使正好有一名玩家叫做"@all"。因此，你如果只想针对这一名名字独特的用户，你应该使用"#@all"。

'''Counter-Strike 特有''':
<ul>
<li>@ct 或 @cts - 所有的反恐精英</li>
<li>@t 或 @ts - 所有的恐怖分子</li>
</ul>

'''Team Fortress 2 特有''':
<ul>
<li>@red - 所有红队成员</li>
<li>@blue - 所有蓝队成员</li>
</ul>

=基础命令=
这些是在[[War_Mode_(SourceMod)/zh|War Mode]]中也能安全使用的基础命令。他们提供了基础的管理功能。

{| class="wikitable"
! 命令
! 插件
! 需求权限
! 格式
! 描述
|-
| sm_addban
| basebans
| rcon
| <nowiki><time> <steamid> [reason]</nowiki>
| 增加一名玩家到服务器黑名单
|-
| sm_admin
| adminmenu
| admin
|
| 展示 [[Admin_Menu_(SourceMod_Scripting)|管理员菜单]].
|-
| sm_ban
| basebans
| ban
| <nowiki><#userid|name> <minutes|0> </nowiki>[reason]
| 封禁一个客户端一定时间
|-
| sm_banip
| basebans
| ban(我觉得需要rcon?)
| <nowiki><ip|#userid|name> <time></nowiki> [reason]
| 增加一个IP地址到服务器黑名单。只有有<tt>rcon</tt> 权限才可以屏蔽任意IP。
|-
| sm_cancelvote
| basecommands
| vote
|
| 取消任何进行中的投票
|-
| sm_cvar
| basecommands
| cvar
| <nowiki><cvar> [value]</nowiki>
| 检索或者改变一个cvar的值（cvar指的是控制台变量，例如sv_cheats就是一种cvar）。被保护的cvar只能用密码访问，sv_cheats只能被有cheat权限的用户访问。如果要把一个cvar加入保护列表，（默认包括了所有标记为PROTECTED的cvar和rcon_password，sm_show_activity,和sm_immunity_mode），需要使用sm_cvar protect <nowiki><name></nowiki>。
|-
| sm_execcfg
| basecommands
| config
| <nowiki><filename></nowiki>
| 执行一个cfg文件（配置文件）。（不需要路径，但是拓展需要）
|-
| sm_help
| adminhelp
| admin
| <nowiki>[page|search]</nowiki>
| 展示所有的控制命令。结果会分页显示，并且会显示当前页数。可选参数可以让你搜索特定的命令。
|-
| sm_kick
| basecommands
| kick
| <nowiki><#userid|name></nowiki> [reason]
| 踢出一名玩家。
|-
| sm_map
| basecommands
| map
| <nowiki><map></nowiki>
| 更换当前地图。
|-
| sm_rcon
| basecommands
| rcon
| <nowiki><argstring></nowiki>
| 使用rcon来执行命令。你只会在SourceMod 1.4或者更高版本看到RCON的输出信息。
|-
| sm_reloadadmins
| basecommands
| config
|
| 重新加载管理员信息。参考[[Adding_Admins_(SourceMod)/zh#快速入门|增加管理员]]。
|-
| sm_unban
| basebans
| unban
| <nowiki><steamid|ip></nowiki>
| 需要一个Steam ID或者IP地址的封禁。
|-
| sm_who
| basecommands
| admin
| <nowiki>[#userid|name]</nowiki>
| 展示所有或特定用户的访问权限。
|}

=拓展命令=
以下命令提供的功能不一定在所有游戏都能使用，这取决于游戏和引擎的差异。通常来说，它们能与主流的mod良好的协作。如果你有一个新mod，或者因为人气低而缺乏支持的mod，你可以在[http://bugs.alliedmods.net/index.php?project=5&do=index feature request]发帖求助。

{| class="wikitable"
|-
! 命令
! 插件
! 需求权限
! 格式
! 描述
|-
| sm_beacon
| funcommands
| slay
| <nowiki><target></nowiki>
| 在每个目标旁边加一个光圈来让玩家之间易于发现。
|-
| sm_burn
| funcommands
| slay
| <nowiki><target> [time]</nowiki>
| 让目标着火一段时间。在特定的游戏上可能无法良好的运作。（例如，TF2没有火焰粒子特效，但是受害者还是会失去体力）燃烧效果会持续[time]秒。
|-
| sm_chat
| basechat
| chat
| <nowiki><message></nowiki>
| 给所有管理发送一条消息。
|-
| sm_csay
| basechat
| chat
| <nowiki><message></nowiki>
| 给所有玩家发送一条消息。（屏幕中心）
|-
| sm_gag
| basecomm
| chat
| <nowiki><target></nowiki>
| 禁言目标。（聊天框）
|-
| sm_hsay
| basechat
| chat
| <nowiki><message></nowiki>
| 在屏幕中下部的提示框给所有玩家发送一条消息。
|-
| sm_msay
| basechat
| chat
| <nowiki><message></nowiki>
| 以菜单的形式发送消息 (只在支持无线电菜单的游戏中有效)。
|-
| sm_mute
| basecomm
| chat
| <nowiki><target></nowiki>
| 禁言目标。（语音）
|-
| sm_play
| sounds
| admin
| <nowiki><target> <file></nowiki>
| 给目标播放服务器上的某个音乐。
|-
| sm_psay
| basechat
| chat
| <nowiki><target> <message></nowiki>
| 给单独的用户发送一条私密消息。
|-
| sm_rename
| playercommands
| slay
| <nowiki><#userid|name></nowiki>
| 改变一个用户的名字。
|-
| sm_resetcvar
| basecommands
| cvar
| <nowiki><cvar></nowiki>
| 重置CVAR值。
|-
| sm_say
| basechat
| chat
| <nowiki><message></nowiki>
| 给所有玩家发送一条消息。
|-
| sm_silence
| basecomm
| chat
| <nowiki><target></nowiki>
| 禁言目标。（聊天框+语音）
|-
| sm_slap
| playercommands
| slay
| <nowiki><target> [damage]</nowiki>
| “拍打”玩家，发出噪音并把玩家推向随机方向。如果有damage参数，就会造成相应伤害。
|-
| sm_slay
| playercommands
| slay
| <nowiki><target></nowiki>
| 杀死玩家。
|-
| sm_tsay
| basechat
| chat
| <nowiki>[color] <message></nowiki>
| 在屏幕左上角发送信息给所有玩家。如果没有指明颜色，默认为白色。可选颜色为white, red, green, blue, yellow, purple, cyan, orange, pink, olive, lime, violet, lightblue。大小写不敏感。
|-
| sm_ungag
| basecomm
| chat
| <nowiki><target></nowiki>
| 解除禁言。（聊天框）
|-
| sm_unmute
| basecomm
| chat
| <nowiki><target></nowiki>
| 解除禁言。（语音）
|-
| sm_unsilence
| basecomm
| chat
| <nowiki><target></nowiki>
| 解除禁言。（聊天框和语音）
|}

=投票命令=
以下指令是与投票相关的。所有在war mode中都是默认不启用的。

{| class="wikitable"
|-
! 命令
! 插件
! 需求权限
! 格式
! 描述
|-
| sm_vote
| basevotes
| vote
| <nowiki><question> [answer1] [answer2] [answer3] ...</nowiki>
| 发起一个提问式投票。如果没有指明可选项，那就默认为Yes和No，而且不会本地化为玩家的默认语言。
|-
| sm_votealltalk
| funvotes
| vote
|
| 发起一个投票以启用all_talk模式。
|-
| sm_voteban
| basevotes
| vote, ban
| <nowiki><target> [reason]</nowiki>
| 发起投票封禁玩家30分钟。
|-
| sm_voteburn
| funvotes
| vote, slay
| <nowiki><target></nowiki>
| 发起投票点燃某个玩家。
|-
| sm_voteff
| funvotes
| vote
|
| 发起投票改变是否启用友伤。
|-
| sm_votegravity
| funvotes
| vote
| <nowiki><amount> [amount2] [amount3] ...</nowiki>
| 发起投票改变重力。
|-
| sm_votekick
| basevotes
| vote, kick
| <nowiki><target> [reason]</nowiki>
| 发起投票踢出玩家。
|-
| sm_votemap
| basevotes
| vote, map
| <nowiki><map> [map2] [map3] ...</nowiki>
| 发起换图投票。
|-
| sm_voteslay
| funvotes
| vote, slay
| <nowiki><target></nowiki>
| 发起投票处死玩家。
|}

[https://steamcommunity.com/profiles/76561198424095916/ 翻译者]
[[Category:SourceMod Documentation]]

2019-09-10T16:51:04Z

Yurizhou: Yurizhou moved page Ru:Custom Admin Menu (SourceMod) to Custom Admin Menu (SourceMod)/ru: change to new template to help developers jump from the english version

{{Languages|Custom Admin Menu (SourceMod)}}
==Вступление==

Кастом меню (Custom menu) позволяет серверным администраторам добавлять новые пункты в меню администратора. Оно было разработано, чтобы позволить плагинам добавлять свои возможности в меню, без внесения изменений в исходный код, т.к. большинство людей не обладают необходимыми знаниями. Для более подробной информации смотрите [[Admin Menu (SourceMod Scripting)]].

Настраивается кастом меню через конфиг файл (расположен по пути: sourcemod/configs/adminmenu_custom.txt) и именно этот файл определяет, какие пункты или категории будут ''добавлены'' к стандартному меню при запуске сервера.

==Параметры==

Ниже перечислены все парамерты, которые могут быть указаны при настройке вашего меню. Многие из них опциональны и имеют значение по умолчанию, если их не указали. Для более подробной информации смотрите [[#Пример|Пример]] и/или приложение(я) [[#Файлы с примерами|Файлы с примерами]].

*cmd - команда на выполнение (#1,#2 и так далее - лимита на число параметров нет) Используйте @номер чтобы параметр не был взят в "кавычки"
*admin - требуемый уровень администратора для доступа к этой команде - смотрите [[#Уровни администраторов|Уровни администраторов]] для более подробной информации
*execute - 'server' или 'player' - кто является "выполнителем" команды - сервер или тот, кто использует эту команду. По умолчанию 'player'
*1 - Информация о параметре 1 (#1) - их должно быть ровно столько, сколько параметров в cmd
**type - по умолчанию 'list', если не было указан.
***'groupplayer' - Лист [[#Group Подменю|Групп]] + подключенные игроки
***'group' - Лист [[#Group Подменю|Групп]]
***'player' - Лист игроков
***'list' - Настраеваемый список опций
***'mapcycle' - Автоматически заполняемое меню из карт вашего файла цикла карт
***'onoff' - "Вкл" или "Выкл", отсылает 1/0 (удобно для работы с консольными переменными (квары, ConVars, cvars), и им подобным)
**path - Требуется только при type = mapcycle. Путь (включая имя файла и расширение) к файлу, содержащему список карт (с форматом записи как у mapcycle.txt) - по умолчанию значение 'mapcycle.txt'
**method - 'name' (имена игроков), 'steamid' (стим айди), 'userid' (юзерид), 'userid2' (не содержит '#'), 'clientid' (айди клиента), 'ip' (айпи) - требуется только для groupplayer/player типов - по умолчанию name
**title - Заглавие меню, которое будет отображаться для выбора параметров (опционально (не обязательно))
**1-x - Лист параметров - требуется только для типа 'list'
**1.-x. - Текст, который будет показан для параметра - требуется только для типа 'list' (опционально, если не указать, то будет написано то, что указано в соответствующем листе параметров)
**1* - x* - Требуемый уровень доступа администратора, чтобы увидеть эту опцию (тоже самое, что и поле 'admin')

==Пример==
'''Внимание!'''
Если вы хотите использовать русские буквы в меню, то кодировка файла '''должна быть''' UTF-8 (без BOOM), иначе вместо букв вы увидите знаки вопроса!
<pawn>
"Commands"
{
"Fun Commands"
{
"Set Player Speed"
{
"cmd" "sm_speed #1 @2"
"admin" "sm_kick"
"execute" "player"
"1"
{
"type" "groupplayer"
"method" "name"
"title" "Player/Team to Edit"

}
"2"
{
"type" "list"
"title" "Speed Multiplier"
"1" "1.0"
"1." "Normal"
"2" "0.8"
"2." "80%"
"3" "0.5"
"3." "Half"
"4" "1.5"
"4." "50% Boost"
"5" "2.0"
"5." "Double"
"5*" "sm_ban"
//Double увидят лишь те администраторы, которые имеют доступ к команде "sm_ban"
}

}
}
}
</pawn>
Если использовать пример выше для вашего adminmenu_custom.txt, то при запуске сервера в меню администратора будет добавлена новая категория под названием 'Fun Commands'.
*Эта категория будет содержать пункт под названием: "Set Player Speed".
*Выбрав его, вы увидите другое меню, с названием: "Player/Team to Edit", содержащий названия команд и имена игроков.
*Выбрав один из вариантов, будет создано второе меню, с названием "Speed Multiplier".
*С выбором опций: "Normal", "80%", и так далее.
*Если игрок выберет опцию "Double", то команда на выполнение будет выглядеть так: 'sm_speed "@CT" 2.0' (команда отсылается на выполнение через FakeClientCommand)

Заметка: Вы можете использовать \ как управляющий символ. Таким образом, \" позволит вам добавить кавычку в вашу строку.

==Уровни администраторов==

Все 'type' 'admin' теперь требуют строчную команду. Эта команда может уже существовать (например, sm_ban) или быть полностью придуманной (например, onlycrabscanusethis).

Если команда существует, то эта опция (или лист опций) будет требовать уровень доступа, равный уровню доступа к этой команде (включая любые переопределения (оверрайды, overrides), которые вы сделали). 
Например, если вы используете sm_ban как уровень администратора для подменю, то таким образом каждый, кто имеет доступ к sm_ban, будет так же иметь доступ и к этому подменю (по умолчанию доступ к этой команде является флаг бана). Однако если вы переопределили sm_ban для одной из групп ("override" "allow" - в файле admin_groups.cfg), то эта группа так же получит доступ.

Если команда не существует, то вам нужно будет добавить переопределение для этой команды, как это делается для простых команд. Это делается в файле admin_overrides.cfg (чтобы назначить флаг доступа к этой команде,
и/или в файле admin_groups.cfg (чтобы дать доступ к команде определенной группе или же забрать, несмотря на то, что они имеют флаг доступа)

Если уровень доступа не был назначен, то тогда уровнем доступа будет назначен первый аргумент "cmd". Например, для команды
<pawn>
"cmd" "sm_ban #1 #2"
</pawn>

уровнем доступа будет уровень доступа sm_ban, включая все его переопределения.

Для более подробной информации смотрите [[Ru:Overriding Command Access (SourceMod)|Переопределение уровней доступа]]

==Group Подменю==

Типы 'group' и 'groupplayer' автоматически добавляют заранее настроенные опции в меню. Эти опции настраиваются в файле sourcemod/configs/adminmenu_grouping.txt

Обычно они используются, чтобы добавить такие команды как '@all', '@t' и другие, для ваших меню.

==Категории==

Если вы хотите добавить пункт в уже существующую SourceMod категорию, вы должны будете определить его внутреннее имя в "commands" группе. Три категории, предоставленные SourceMod'ом:

*PlayerCommands (Управление игроками)
*ServerCommands (Управление сервером)
*VotingCommands (Управление голосованиями)

==Сортировка==
Категории и пункты, добавленные с использованием динамических меню, могут быть отсортированы, как обычные пункты. Для подробной информации смотрите [[Admin Menu Configuration (SourceMod)|Admin Menu Configuration]]

Для того, чтобы можно было сортировать добавленный пункт, вы должны дать вашей команде уникальное имя в вашем конфигурационном файле. Для приведенного примера:
<pawn>
"item" "Set Player Speed"
</pawn>
==Дополнительные возможности==
Пример использования полного потенциала меню: даем администраторам доступ к квару, не давая им флага доступа 'sm_cvars'

Добавьте квар, к которому вы хотите дать доступ, и установите 'execute' 'server'
<pawn>
"cmd" "mp_friendlyfire #1"
"execute" "server"
"admin" "sm_kick"
</pawn>
Таким образом, команда будет выполнена через rcon, несмотря на обычную систему уровней доступа, и проверит доступ только к флагу, указанному в поле 'admin'. Это так же работает для любых других команд, включая sm_rcon.

==Файлы с примерами==

Пример файла adminmenu_custom.txt настроенный для Super Commands: 
[http://users.alliedmods.net/~pred/supercmdsmenu.ini adminmenu_custom.txt] 
 
Полный пример, спасибо uE|Tekniqal: 
[http://users.alliedmods.net/~pred/smsuper.ini adminmenu_custom.txt] 
[http://users.alliedmods.net/~pred/admin_overrides.cfg admin_overrides.cfg] 
[http://users.alliedmods.net/~pred/admin_groups.cfg admin_groups.cfg] 

[[Category:SourceMod Documentation]]

Custom Admin Menu (SourceMod)/ru

2019-09-10T16:50:51Z

Yurizhou:

Custom Admin Menu (SourceMod)

2019-09-10T16:50:10Z

Yurizhou:

{{Languages|Custom Admin Menu (SourceMod)}}
==Introduction==
The custom menu feature allows server admins to add new items to the SourceMod admin menu. It is designed to be used as a complement to plugins adding themselves to the menu. For more information see [[Admin Menu (SourceMod Scripting)]].

Admins configure their menu using the config file (sourcemod/configs/adminmenu_custom.txt) and this is generated into a set of items and categories for the admin menu when the server starts.

==Parameter List==

These are all the parameters that can be specified to configure your menu. Most are optional and have a default value if they are not found. See the [[#Example Command|Example Command]] and/or the attached [[#Example Files|Example Files]] for information on how to lay out your config file.

*cmd - command to be executed (#1,#2 etc for parameters - no limit on these) Use @num to have the parameter sent without being surrounded by "quotes"
*admin - admin level required to access the command - see [[#Admin Levels|Admin Levels]]
*execute - 'server' or 'player' - selects whether to execute as a client command or server command - defaults to 'player'
*1 - Information about parameter 1 (#1) - You need as many of these as you have parameters
**type - defaults to 'list' if not provided
***'groupplayer' - List of [[#Group Submenus|Groups]] + connected player
***'group' - List of [[#Group Submenus|Groups]]
***'player' - List of players
***'list' - Custom Defined list of Options
***'mapcycle' - Auto filled with the contents of your mapcycle file
***'onoff' - On or Off menu that sends the numbers 1/0 (good for cvars etc)
**path - Only required for type mapcycle. Path (including file name and extension) to the file containing a list of maps (straight text formatting like mapcycle.txt) - defaults to 'mapcycle.txt'
**method - 'name', 'steamid', 'userid', 'userid2' (doesn't prepend the '#'), 'clientid', 'ip' - only needed for groupplayer/player menus - defaults to name
**title - To be shown for the parameter selection menu (optional)
**1-x - List parameters - only needed for 'list' type parameters
**1.-x. - Text to be shown for parameter - only needed for 'list' type parameters (optional, above will be used as text if ommited)
**1* - x* - Admin level required to see this option (same as the rest of the admin types)

==Example Command==
<pawn>
"Commands"
{
"Fun Commands"
{
"Set Player Speed"
{
"cmd" "sm_speed #1 @2"
"admin" "sm_kick"
"execute" "player"
"1"
{
"type" "groupplayer"
"method" "name"
"title" "Player/Team to Edit"

}
"2"
{
"type" "list"
"title" "Speed Multiplier"
"1" "1.0"
"1." "Normal"
"2" "0.8"
"2." "80%"
"3" "0.5"
"3." "Half"
"4" "1.5"
"4." "50% Boost"
"5" "2.0"
"5." "Double"
"5*" "sm_ban"
//restrict the double option to admins who have access to the 'sm_ban' override
}

}
}
}
</pawn>
Using the above as the contents of your adminmenu_custom.txt config file would create a new category option in the admin menu called 'Fun Commands'.
*This category would contain an option called : "Set Player Speed".
*Selecting it would prompt another menu titled: "Player/Team to Edit" containing a list of Groups and Player Names.
*Selecting one of these would prompt a second menu titled "Speed Multiplier".
*List of options like "Normal", "80%" etc.
*Example command sent if the user selected "Double" (through the player using FakeClientCommand) - 'sm_speed "@CT" 2.0'

NB: You can use \ as an escape character. So \" will let you add quotes to your strings.

==Admin Levels==

All 'admin' types now require a string command name. This command can be already existing (sm_ban) or completely imaginary (onlycrabscanusethis).

If the command exists that section (or list option) will require the exact same access level as that command (including any overrides you have specified). 
E.g. You use sm_ban as the admin level for a submenu, so anyone that can access sm_ban will also be able to access this menu option (By default this is admins with the 'ban' flag). However if you have overridden sm_ban in one of your lower groups ("override" "allow" - in admin_groups.cfg). This group will also have access.

If the command doesn't exist you will need to add it to your overrides sections as if it was a normal command. This can be done in admin_overrides.cfg (to assign flag letters to this command),
and/or in admin_groups.cfg (to give access to the command to a specified group or remove it from a group even though they have the flag)

If no admin level is specified for a base command it will default to the first argument of the "cmd" string. For example having
<pawn>
"cmd" "sm_ban #1 #2"
</pawn>

would have a default admin override string of 'sm_ban'

For more information, see [[Overriding Command Access (SourceMod)|Overriding Command Access]]

==Group Submenus==

Types 'group' and 'groupplayer' auto-add pre configured options to the menu. These options are configured using sourcemod/configs/adminmenu_grouping.txt

They are generally used to provide common commands like '@all' , '@t' etc to your menus.

==Categories==

If you wish to add items to an existing SourceMod category you will need to specify it’s internal name within the "commands" group. The three categories provided by SourceMod are:

*PlayerCommands
*ServerCommands
*VotingCommands

==Sorting==
Categories and items added using the dynamic menu can be sorted in the same way as normal items. For more information, see [[Admin Menu Configuration (SourceMod)|Admin Menu Configuration]]

You need to specify the name you gave the command in your configuration file. For the provided example:
<pawn>
"item" "Set Player Speed"
</pawn>
==Extra Uses==
An example of using the dynamic menu to its full potential: Giving admins access to some cvars while not letting them have general 'sm_cvar' access.

Add the cvar you want to make available using the command directly and set the 'execute' parameter to 'server'
<pawn>
"cmd" "mp_friendlyfire #1"
"execute" "server"
"admin" "sm_kick"
</pawn>
This fires the command directly through rcon so it bypasses the normal SourceMod admin requirements and only checks what you set using the 'admin' parameter. This method can be used to create a list of commonly used (and low impact) cvars that your lower admins can change at will, without giving them access to everything. The same method works for rcon commands.

==Example Files==

Example adminmenu_custom.txt setup with Super Commands examples: 
[http://users.alliedmods.net/~pred/supercmdsmenu.ini adminmenu_custom.txt] 
 
A Full example setup thanks to uE|Tekniqal: 
[http://users.alliedmods.net/~pred/smsuper.ini adminmenu_custom.txt] 
[http://users.alliedmods.net/~pred/admin_overrides.cfg admin_overrides.cfg] 
[http://users.alliedmods.net/~pred/admin_groups.cfg admin_groups.cfg] 

[[Category:SourceMod Documentation]]

Adding Admins (SourceMod)/ru

2019-09-10T16:48:03Z

Yurizhou: Yurizhou moved page Ru:Adding Admins (SourceMod) to Adding Admins (SourceMod)/ru: change to new template to help developers jump from the english version

{{Languages|Adding Admins (SourceMod)}}
__FORCETOC__
SourceMod обладает детальной и гибкой системой администрирования, и это может быть сложным для некоторых пользователей. Чтобы упростить вещи, были введены "флаги", которые определяют права администраторов.

На данный момент есть два пути добавления администратора. Один из них через admin-flatfile.smx плагин, который по умолчанию включен. Этот файл обеспечивает два файла: упрощенный файл, и другой, более сложный древообразный файл. Другой путь добавления администратора - использование [[SQL Admins (SourceMod)|SQL]].

SourceMod обладает тремя методами идентификации:
*''Steam ID'' (уникален для каждого Steam аккаунта)
*''IP Address'' (полу-уникален для данного компьютера, лучше для локальных сетей)
*''Name'' (требует пароля для идентификации)

=Быстрый Старт=
Зайдите в корневую папку сервера. Откройте [папка мода (для CSS это cstrike, для tf2 это tf, и так далее)]/addons/sourcemod/configs/admins_simple.ini

С новой строки добавьте следующий текст, заменив yoursteamid на ваш Steam ID (используйте клиентскую консольную команду '''status''', чтобы узнать ваш Steam ID - он выглядит как STEAM_n:o:p)

'''"yoursteamid" "99:z"'''

Сохраните файл, затем напишите в консоль сервера sm_reloadadmins. Подключитесь к серверу с помощью игрового клиента. Напишите sm_admin в консоль игры, а затем вернитесь к игре. Вы должны увидеть меню администратора.

=Уровни Доступа=
Для начала давайте быстро пробежимся через предоставленные уровни доступа:
:{| cellpadding="5"
|- class="t2th"
| Название Флага
| Флаг
| Для чего предназначен
|- class="t2td"
| reservation
| a
| Доступ к резервному слоту.
|- class="t2td"
| generic
| b
| Обычная админка, требуется для администраторов.
|- class="t2td"
| kick
| c
| Кикать других игроков.
|- class="t2td"
| ban
| d
| Банить других игроков.
|- class="t2td"
| unban
| e
| Удалять баны.
|- class="t2td"
| slay
| f
| Убивать/вредить другим игрокам.
|- class="t2td"
| changemap
| g
| Менять карту или другие воздействия на игровой процесс.
|- class="t2td"
| cvar
| h
| Изменять большинство консольных переменных (конваров, cvars, ConVars).
|- class="t2td"
| config
| i
| Выполнять конфиг файлы.
|- class="t2td"
| chat
| j
| Специальные привилегии чата.
|- class="t2td"
| vote
| k
| Запускать или создавать голосования.
|- class="t2td"
| password
| l
| Устанавливать пароль на сервер.
|- class="t2td"
| rcon
| m
| Использование RCON команд.
|- class="t2td"
| cheats
| n
| Изменять sv_cheats или использовать читерские команды.
|- class="t2td"
| root
| z
| Волшебным образом включает все флаги.

|- class="t2td"
| custom1
| o
| Настраиваемая Группа 1.
|- class="t2td"
| custom2
| p
| Настраиваемая Группа 2.
|- class="t2td"
| custom3
| q
| Настраиваемая Группа 3.
|- class="t2td"
| custom4
| r
| Настраиваемая Группа 4.
|- class="t2td"
| custom5
| s
| Настраиваемая Группа 5.
|- class="t2td"
| custom6
| t
| Настраиваемая Группа 6.
|}

=Иммунитет=
В SourceMod'е иммунитет - гибкая система, построенная на ''уровнях иммунитета''. Каждый администратор может иметь произвольное значение уровня иммунитета. Таким образом, произвести действие над администратором может лишь тот администратор, чей уровень иммунитета больше.

Например, Админстратор #1 обладает "3" уровнем иммунитета, а Админстратор #2 обладает уровнем иммунитета "10". Админстратор #2 может производить действия над Админстратором #1, а Админстратор #1 не может произвести действия над Админстратором #2. Уровни иммунитета могут быть совершенно произвольными, могут быть равны любому числу, которое больше нуля. Помните, что "0" значит отсутствие иммунитета.

По умолчанию администраторы с одинаковым уровнем иммунитета могут воздействовать друг на друга. Это может быть изменено через <tt>sm_immunity_mode</tt> в файле <tt>cfg/sourcemod.cfg</tt>.

=Пароли=
Чтобы пароли работали, серверный администратор должен изменить строку "PassInfoVar" в файле <tt>addons/sourcemod/configs/core.cfg</tt>. Например:
<pre>"PassInfoVar" "_sm1337"</pre>

Дальше, если администратор имеет пароль, он или она должен ввести пароль через команду ''setinfo'' в консоль клиента. Например, используя пример выше, <tt>BAILOPAN</tt> должен прописать следующее:
<pre>setinfo "_sm1337" "Gab3n"</pre>

Для автоматизации этого процесса (ввода пароля через setinfo), вы можете создать "autoexec.cfg" файл в вашей папке игрового клиента. Этот файл расположен по пути <tt>SteamApps\ACCOUNT\[игра]\[папка мода]\cfg</tt>. Например:
*<tt>C:\Program Files\Steam\steamapps\bailopan\Counter-Strike Source\cstrike\cfg</tt>

Вы так же можете ввести пароль перед соединением с сервером. Для Steam ID и IP идентификации, ваши привилегии администратора будут автоматически выданы вам, если пароль правильный. Для идентификации по имени, ваш пароль должен быть правильным при смене имени, иначе вы будете кикнуты с сервера.

=Простое Добавление Администратора=
Самый простой путь добавить администратора - редактирование файла <tt>configs/admins_simple.ini</tt>. Этот файл содержит два параметра на линии: идентификационная информация, и флаги. Строка флагов - нечто гибкое и может содержать следующую информацию:
*Опционально: уровень иммунитета, разделенный двоеточием (':');
*Строчно флаг, '''или''';
*Имя группы, начинающееся с символа '@'

Три примера:
<pre>
"STEAM_0:1:16" "bce" //админка, кик и разбан по данном SteamID. Без иммунитета.
"!127.0.0.1" "5:z" //все права для этого ip, уровень иммунитета = 5
"BAILOPAN" "abc" "Gab3n" //имя BAILOPAN, пароль "Gab3n": обладает резервным слотом, доступом к админке, кик
</pre>

=Детальная Настройка Администратора=
Вы так же можете добавить администратора через <tt>configs/admins.cfg</tt>, настраиваемый файл в формате KeyValues. Каждый администратор обладает своим собственным блоком внутри блока администратора. Вы можете создавать и / или модифицировать <tt>admins.cfg</tt> файл с помощью [http://forums.alliedmods.net/showthread.php?t=81160 KVManager]. Формат файла следующий:

<pre>Admins
{
"Имя администратора"
{
"auth" "[steam|name|ip]"
"identity" "[unique id]"
"[option1]" "[value1]"
"[option2]" "[value2]"
/* .... */
}
}</pre>

Доступные опции:
*<tt>auth</tt>: Требуется. Должен быть: <tt>steam</tt>, <tt>name</tt>, или <tt>ip</tt> (если нет специального метода идентификации), говорит SourceMod'у, чем является <tt>идентификационное</tt> значение.
*<tt>identity</tt>: Требуется. Уникальное значение, которое позволяет SourceMod'у найти этого администратора по аудентификационному методу и полученному значению.
*<tt>password</tt>: Опционально. Пароль, который должен ввести администратор (смотрите раздел выше про пароли).
*<tt>group</tt>: Опционально. Имя группы, к которой должен принадлежать администратор. Может быть объявлено больше чем одна "group" линия. Здесь не нужно ставить символ '@' перед именем группы.
*<tt>flags</tt>: Опционально. Флаг доступа.
*<tt>immunity</tt>: Опционально. Уровень иммунитета.

Имя администратора опционально (оно может быть пустым). Оно не используется и присутствует только для удобства сторонним программам.

Пример:
<pre>Admins
{
"BAILOPAN"
{
"auth" "steam"
"identity" "STEAM_0:1:2345"
"flags" "abcdef"
"immunity" "5"
"group" "Awesome Admins"
}

"Blue Crab"
{
"auth" "steam"
"identity" "STEAM_0:1:666666"
"flags" "z"
"immunity" "99"
}
}</pre>

=Смотрите Также=
*[[Adding Groups (SourceMod)]]
*[[Ru:Overriding Command Access (SourceMod)|Переопределение Доступа к командам]]

[[Category:SourceMod Documentation]]

Ru:Adding Admins (SourceMod)

2019-09-10T16:48:03Z

Yurizhou: Yurizhou moved page Ru:Adding Admins (SourceMod) to Adding Admins (SourceMod)/ru: change to new template to help developers jump from the english version

#REDIRECT [[Adding Admins (SourceMod)/ru]]

Adding Admins (SourceMod)/ru

2019-09-10T16:47:30Z

Yurizhou:

Base Plugins (SourceMod)/zh

2019-09-10T16:45:39Z

Yurizhou: Created page with "{{Languages|Base Plugins (SourceMod)}} __FORCETOC__ 这里会介绍SourceMod附带的基本插件和它们的用途。加粗的插件能在War_Mode_(SourceMod)|War Mod..."

{{Languages|Base Plugins (SourceMod)}}
__FORCETOC__
这里会介绍[[SourceMod]]附带的基本插件和它们的用途。

加粗的插件能在[[War_Mode_(SourceMod)|War Mode]]下安全使用，因为他们没有可滥用或者不公平的成分。

=默认插件=
{| style="width:600px;" cellpadding="5"
|- class="t2th"
|插件
|用途
|- class="t2td"
| '''admin-flatfile'''
| 从管理员配置文件中获取管理员信息
|- class="t2td"
| '''adminhelp'''
| 提供了sm_help命令（显示其他的命令和它们的语法）
|- class="t2td"
| '''adminmenu'''
| 提供了管理菜单的API和核心功能
|- class="t2td"
| antiflood
| 防止客户端被各类信息骚扰
|- class="t2td"
| '''basebans'''
| 提供了基础的封禁功能和封禁菜单
|- class="t2td"
| basechat
| 提供了管理用户使用语音聊天或者聊天框的命令和菜单
|- class="t2td"
| basecomm
| 提供了改变用户交流方式的功能（与sv_alltalk相比）
|- class="t2td"
| '''basecommands'''
| 提供了不被用户滥用的基础管理指令（例如换图，踢人等）
|- class="t2td"
| basetriggers
| 提供了对一些语句的回复（例如，"nextmap", "thetime", 和 "timeleft"）
|- class="t2td"
| basevotes
| 提供了基础的投票指令，例如换图
|- class="t2td"
| '''clientprefs'''
| 给客户端增加了一个基于控制台（sm_cookies）的和一个基于菜单的设置功能(sm_settings)
|- class="t2td"
| funcommands
| 提供了类似拍打的有趣的命令（影响平衡）
|- class="t2td"
| funvotes
| 提供基于funcommands的投票功能
|- class="t2td"
| '''nextmap'''
| 允许客户或者其他插件换图
|- class="t2td"
| playercommands
| 增加了sm_slap, sm_slay, 和sm_rename命令
|- class="t2td"
| reservedslots
| 允许服务器保留通道给管理员或者特权人员，来保证他们可以加入服务器
|- class="t2td"
| sounds
| 增加了命令“sm_play”
|}

=额外插件=
接下来是默认禁用了的插件。（位于<tt>addons/sourcemod/plugins/disabled</tt>，你需要把它们移出到上一级文件夹来启用）

如果一个插件有CVars（控制台变量，提供了在控制台修改部分属性的功能），你可以从加载一次来在<tt>cfg/sourcemod</tt>生成配置文件。

{| style="width:600px;" cellpadding="5"
|- class="t2th"
|插件
|用途
|- class="t2td"
| '''admin-sql-prefetch'''
| 每次换图时，重新从数据库读取管理员信息。启用这个时，必须禁用<tt>admin-sql-threaded</tt>。参考[[SQL_Admins_(SourceMod)|SQL Admins]]
|- class="t2td"
| '''admin-sql-threaded'''
| 每次管理员连入时，重新从数据库读取管理员信息。启用这个时，必须禁用<tt>admin-sql-prefetch</tt>。参考[[SQL_Admins_(SourceMod)|SQL Admins]]
|- class="t2td"
| mapchooser
| 提供了一个便于玩家选图的系统。启用这个时，必须禁用<tt>randomcycle</tt>。Cvars生成在<tt>mapchooser.cfg</tt>
|- class="t2td"
| randomcycle
| 随机换图。启用这个时，必须禁用<tt>mapchooser</tt>。Cvars生成在<tt>randomcycle.cfg</tt>
|- class="t2td"
| rockthevote
| 提供玩家投票开启换图的功能。（也就是rtv）Cvars生成在<tt>rtv.cfg</tt>.
|}

[[Category:SourceMod Documentation]]

Base Plugins (SourceMod)

2019-09-10T16:26:58Z

Yurizhou:

{{Languages|Base Plugins (SourceMod)}}
__FORCETOC__
The following is a full list of [[SourceMod]]'s base plugins and the purpose of each one.

Plugins with a bold name are safe to be used in [[War_Mode_(SourceMod)|War Mode]], as they do not contain anything that could be considered abusive or unfair.

=Default Plugins=
{| style="width:600px;" cellpadding="5"
|- class="t2th"
|Plugin
|Purpose
|- class="t2td"
| '''admin-flatfile'''
| Loads admins from the admin configuration files.
|- class="t2td"
| '''adminhelp'''
| Provides the sm_help command (lists other commands and their syntax).
|- class="t2td"
| '''adminmenu'''
| Provides the admin menu API and core features.
|- class="t2td"
| antiflood
| Prevents clients from spamming messagemode/chat.
|- class="t2td"
| '''basebans'''
| Provides basic banning commands and menu options.
|- class="t2td"
| basechat
| Provides commands and menu options for managing player's abilities to use voice chat or say chat.
|- class="t2td"
| basecomm
| Provides functionality for tweaking how players can communicate (in comparison to sv_alltalk).
|- class="t2td"
| '''basecommands'''
| Provides basic administrative commands unrelated to player abuse (for example, map changing, kicking, and cvar changing).
|- class="t2td"
| basetriggers
| Provides automated responses to phrases such as "nextmap", "thetime", and "timeleft".
|- class="t2td"
| basevotes
| Provides basic voting commands, such as map voting.
|- class="t2td"
| '''clientprefs'''
| Adds a console based (sm_cookies) and menu based (sm_settings) inteface for clients to access their settings.
|- class="t2td"
| funcommands
| Provides "fun" commands, like slapping.
|- class="t2td"
| funvotes
| Provides votes based on basefuncommands.
|- class="t2td"
| '''nextmap'''
| Allows admins or other plugins to dynamically alter or retrieve the effective mapcycle.
|- class="t2td"
| playercommands
| Adds commands sm_slap, sm_slay, and sm_rename
|- class="t2td"
| reservedslots
| Allows the server to have slots that are reserved for administrators (or privileged people), to ensure prioritized entry.
|- class="t2td"
| sounds
| Adds command sm_play
|}

=Extra Plugins=
The following plugins are in the <tt>addons/sourcemod/plugins/disabled</tt> folder by default, and must be moved out of that folder to be enabled.

If a plugin has cvars, you can load it once to generate its config file in <tt>cfg/sourcemod</tt>.

{| style="width:600px;" cellpadding="5"
|- class="t2th"
|Plugin File
|Purpose
|- class="t2td"
| '''admin-sql-prefetch'''
| Loads admins from an SQL database as a big lump every mapchange. If enabled, <tt>admin-sql-threaded</tt> must be disabled; see [[SQL_Admins_(SourceMod)|SQL Admins]].
|- class="t2td"
| '''admin-sql-threaded'''
| Loads admins from an SQL database dynamically as each admin connects. If enabled, <tt>admin-sql-prefetch</tt> must be disabled; see [[SQL_Admins_(SourceMod)|SQL Admins]].
|- class="t2td"
| mapchooser
| Provides an automated system for players to vote for map changes. If enabled, <tt>randomcycle</tt> should be disabled. Cvars are generated in <tt>mapchooser.cfg</tt>.
|- class="t2td"
| randomcycle
| Randomizes the map cycle. If enabled, <tt>mapchooser</tt> should be disabled. Cvars are generated in <tt>randomcycle.cfg</tt>.
|- class="t2td"
| rockthevote
| Provides a player-initiated system for players to vote for map changes. Cvars are generated in <tt>rtv.cfg</tt>.
|}

[[Category:SourceMod Documentation]]

Admin Menu Configuration (SourceMod)/zh

2019-09-09T08:12:39Z

Yurizhou: Created page with "{{Languages|Admin Menu Configuration (SourceMod)}} SourceMod的管理菜单选项能改变顺序。尽管菜单项不能改变他们的种类，但是能在一个种类下改..."

{{Languages|Admin Menu Configuration (SourceMod)}}

SourceMod的管理菜单选项能改变顺序。尽管菜单项不能改变他们的种类，但是能在一个种类下改变他们的顺序。没有显性的指明排序的菜单项排在明确了顺序的菜单项后，并且按照用户的语言排序。

通过''addons/sourcemod/configs/adminmenu_sorting.txt''可以控制菜单项顺序。每个区块代表一个种类。区块的顺序代表这些种类在菜单下的顺序。每个区块又有自己特有的菜单项的排序。

注意，这些菜单项并不是指令。它们是与菜单连接的识别名。第三方插件也许会新增一些菜单项到管理菜单中，并且这些菜单项也有它们特有的识别名。（无论有没有相关的指令）

=样例=

这个格式和Mani插件很像。
<pre>
"Menu"
{
"PlayerCommands"
{
"item" "sm_slay"
"item" "sm_kick"
"item" "sm_ban"
"item" "sm_gag"
"item" "sm_burn"
}

"ServerCommands"
{
"item" "sm_map"
"item" "sm_execcfg"
"item" "sm_reloadadmins"
}

"VotingCommands"
{
"item" "sm_cancelvote"
"item" "sm_votemap"
"item" "sm_votekick"
"item" "sm_voteban"
}
}</pre>

[[Category:SourceMod Documentation]]

Overriding Command Access (SourceMod)/zh

2019-09-09T08:04:15Z

Yurizhou: Created page with "{{Languages|Overriding Command Access (SourceMod)}} 这个文章介绍了如何在不改变插件源代码的情况下，去改变标志或者任何控制语句的权限。权..."

{{Languages|Overriding Command Access (SourceMod)}}
这个文章介绍了如何在不改变插件源代码的情况下，去改变标志或者任何控制语句的权限。权限既可以是全局的，也可以是给特定的组员的。

=介绍=
重写权限是SourceMod管理系统中最为有力的特性之一。这能让你高效地:
*在不更改插件源码的前提下更改管理命令的权限
*不更改源码的情况下更改整个用户组的命令权限
*创建自定义权限级别
*无视命令的标志，允许或拒绝任何玩家或组的访问权限

当你更改了一个SourceMod成员的权限，你就完成了"重写"这一动作。重写是一条字符串。如果这个字符串与命令名匹配，那么这个命令的权限将会从这条重写中继承（而不是代码中）。

这个概念重要在于:
*重写能改变一条命令的权限。
*重写能被当作自定义的访问权限标志。

例如，一个插件需要等级“g”才能使用<tt>sm_map</tt>命令。然而，重写可以对特定的组直接同意或者拒绝这条命令的使用，也可以把默认需要的等级改为“k”。

更有意思的事，一个插件可以要求使用特殊的菜单选项必须有权限访问<tt>sm_map</tt>指令。在这种情况下，用户必须有<tt>sm_map</tt>的权限，而不是一个硬编码的标志。

最后一个例子，一个插件可能要求用户必须有权限访问<tt>plugin_crab_usage</tt>,然而这完全不是一个命令。这意味着插件要求的只是默认权限，用户爱怎么重写怎么重写。这也暗示着重写是和命令无关的。但是，命令本身会从同名的重写中继承权限要求。

更改重写文件不会立刻生效，你可以使用"sm_reloadadmins"指令来刷新。

=重写方法=
重写有两种方法：重写指令和重写组。重写命令基于命令会自动继承同名的重写提供的权限要求。重写组则导致一个用户组有这个命令的权限。

例如，如果一个重写为<tt>sm_map<tt>，任何<tt>sm_map<tt>的指令都会继承重写中的权限要求。
如果一个重写组为<tt>CSDM</tt>，任何标记权限组为"CSDM"的成员都会获得该权限。

=全局设置=
全局权限重写配置文件为<tt>configs/admin_overrides.cfg</tt>。格式如下：

<pre>
Overrides
{
"[名字]" "[标志]"
"@[用户组]" "[标志]"
/* ... */
}</pre>

用户组会以“@”开头，例如：
<pre>
Overrides
{
"sm_map" "k" //Change "sm_map" to the "k" flag.
"@CSDM" "m" //Change all CSDM commands to the "m" flag.
"sm_chat" "" //Allow anyone to use "sm_chat"空则代表不需要权限
}</pre>

注意，如果你给一堆权限要求，那么客户端就必须有所有需要的权限了，而不是任意一个。（例如"abc"需要你有三个权限，而不是任意一个）
=组配置=
Group overrides are given on an allow or deny basis. That is, rather than changing flags per-group, the override is simply whether it is allowed or denied to members of that group.

更多内容请参考[[Adding_Groups_%28SourceMod%29#File_Format|增加用户组]].

[[Category:SourceMod Documentation]]

Overriding Command Access (SourceMod)

2019-09-09T07:29:56Z

Yurizhou: change template

{{Languages|Overriding Command Access (SourceMod)}}
This article explains how, without editing plugin source code, you can change the flags or permissions on any command, either globally, or for a specific group.

=Introduction=
Command access overrides are one of the most powerful aspects of the SourceMod administration system. They effectively let you:
*Change the access to any admin command without modifying plugin source code;
*Change the access to entire groups of commands without modifying source code;
*Create custom access levels;
*Allow or deny commands and groups of commands to an administrator group regardless of the command flags.

When you change the permissions to a SourceMod object, it is called an ''override''. An override is an arbitrary string. If the override string matches a command name, then the command permissions will be inherited from that override.

This concept is important for two reasons:
*An override can change the permissions of a command.
*An override can be used as a custom access flag.

For example, a plugin might require access "g" to use the <tt>sm_map</tt> command. However, an override could explicitly allow/deny usage of this command to a given group, and/or it could change the default flag for <tt>sm_map</tt> to be "k" instead.

More interestingly, a plugin could require <tt>sm_map</tt> access in order to use a specific menu option. In this case, a user would have to be able to access <tt>sm_map</tt>, rather than have a hardcoded flag.

As a final example of the flexibility of this system, a plugin might say that users must be able to access <tt>plugin_crab_usage</tt>, which isn't a command at all. Instead, the plugin assumes a ''default'' access level internally, and users can opt to override it as they wish. This demonstrates that overrides are separate from commands, however, commands themselves inherit their permissions from overrides of the same name.

Changes to the override configuration are not immediate. You can reload overrides by issuing the "sm_reloadadmins" command.

=Override Types=
Overrides come in two flavors: ''command'' overrides and ''command group'' overrides. Command overrides are overrides that, if they have the same name as a command, that command will automatically inherit that override's permissions.

Similarly, a ''command group'' override is an override that which, if a command has the same group name as a ''command group'' override, that command will inherit the override's permissions.

Example 1: If a command override exists for <tt>sm_map</tt>, any admin command named <tt>sm_map</tt> will inherit those permissions.

Example 2: If a command group override exists for <tt>CSDM</tt>, any admin command labelled as a "CSDM" command will inherit those permissions.

=Global Configuration=
Access levels for overrides can be globally reconfigured via <tt>configs/admin_overrides.cfg</tt>. The file format is very simple:

<pre>
Overrides
{
"[name1]" "[flags]"
"@[group1]" "[flags]"
/* ... */
}</pre>

Command groups are specified with an 'at' sign ('@') preceding the name. Example:

<pre>
Overrides
{
"sm_map" "k" //Change "sm_map" to the "k" flag.
"@CSDM" "m" //Change all CSDM commands to the "m" flag.
"sm_chat" "" //Allow anyone to use "sm_chat"
}</pre>

Note that given an arbitrary number of flags, the client must require access to '''all''' specified flags in the string, as opposed to just any one of them.

=Group Configuration=
Group overrides are given on an allow or deny basis. That is, rather than changing flags per-group, the override is simply whether it is allowed or denied to members of that group.

For more information, visit [[Adding_Groups_%28SourceMod%29#File_Format|Adding Groups]].

[[Category:SourceMod Documentation]]

Overriding Command Access (SourceMod)/ru

Yurizhou: Created page with "__FORCETOC__ SourceMod有着十分详尽并且灵活的管理系统，这可能会吓退很多新手用户。为了简化操作,MOD中有许多“标志”指定了管理员..."