Команды
Команды в чате¶
Команды можно запускать прямо в чате. Префикс по умолчанию ;:
;fly me
;paint all red
Префикс у каждого свой, и его можно поменять в панели в разделе You Settings (если владелец игры его не заблокировал). Чтобы команда не светилась в окне чата, поставь перед ней /e:
/e ;fly me
Команды в панели¶
На странице Commands в панели собраны все команды, которые тебе доступны. Если нажать на любую из них, откроется её страница запуска, где можно спокойно заполнить аргументы. Это незаменимо для игроков, которые не могут писать в чат, и просто удобно, когда не помнишь, что именно ждёт команда.
Командная строка¶
Есть ещё экранная командная строка с живыми подсказками и автодополнением, чтобы запускать команды быстро. Недавние команды сохраняются, так что повторить любую можно парой нажатий. Чтобы открыть её, нажми кавычку (') или точку с запятой (;). Открыть её получится, только если твои роли дают разрешение Command Bar.
Выбор игроков¶
Большинству команд нужен игрок. Достаточно части имени (;fly ben найдёт Benjamin), а если поставить перед именем @, поиск пойдёт по нику, а не по отображаемому имени, например ;fly @ForeverHD (часть ника тоже подойдёт). Вместо имени можно использовать квалификатор:
| Квалификатор | Кого выбирает |
|---|---|
me |
тебя |
all |
всех игроков на сервере |
others |
всех, кроме тебя |
random |
одного случайного игрока |
role(mod) |
игроков с этими ролями |
friends |
игроков, которые у тебя в друзьях |
radius(20) |
игроков в таком радиусе от тебя, в стадах |
amount(5) |
столько случайных игроков |
percent(50) |
такой процент игроков сервера |
team(red) |
игроков из этих команд |
group(123456) |
игроков из этих групп Roblox |
premium |
игроков с Roblox Premium |
;jump others
;kill radius(20)
;give team(red) sword
Квалификаторы можно соединять запятыми: ;fly me,role(admin) выберет тебя и всех админов. Выбирать не себя и выбирать сразу нескольких игроков тоже нужно отдельное разрешение в роли (Targeting Others и Multiple Targets). Как их выдать, смотри в Roles.
Модификаторы¶
Модификаторы ставятся перед названием команды и меняют то, как она выполняется:
;unfly me
;globalMessage hello
;permMusic 123456
| Модификатор | Что делает | Разрешение |
|---|---|---|
undo (или un) |
завершает все задачи этой команды и/или игрока | Neutral |
preview |
открывает страницу запуска команды вместо её выполнения | Neutral |
random |
выбирает одну случайную команду из выражения | Neutral |
loop(10,2) |
запускает команду повторно, здесь 10 раз с паузой в 2 секунды | Abusive |
spawn |
запускает сейчас и каждый раз, когда игрок возрождается | Abusive |
delay(5) |
ждёт столько секунд, потом запускает | Abusive |
schedule(1767225600) |
запускает в указанное epoch-время | Abusive |
expire(30) (или until) |
завершается через столько секунд | Abusive |
join |
выполняется на игроках, когда они заходят на этот сервер | Global |
global |
выполняется один раз на всех серверах | Global |
perm |
выполняется на всех серверах, в том числе будущих | Global |
permSpawn |
выполняется сейчас и каждый раз, когда игроки возрождаются, на этом сервере и на всех будущих серверах, куда они зайдут | Global |
permJoin |
выполняется на игроках, когда они заходят, на всех серверах, в том числе будущих | Global |
permLoop |
запускается повторно на всех серверах, в том числе будущих | Global |
permDelay |
ждёт, потом запускается на всех серверах, в том числе будущих | Global |
permSchedule |
запускается в указанное epoch-время на всех серверах, в том числе будущих | Global |
unperm |
завершает все постоянные задачи этой команды и/или игрока | Global |
Important
Чтобы использовать модификаторы Abusive и Global, нужны разрешения роли Modifiers Abusive и Modifiers Global. Будь ОЧЕНЬ осторожен, кому ты их выдаёшь: одна глобальная команда может добраться до каждого сервера твоего плейса.
Лимиты¶
У команд есть ограничения по частоте и размеру, чтобы игроки не завалили твой сервер. В каждой роли есть Commands Per Minute и Requests Per Second, и действует наибольшее значение среди всех твоих ролей. Размер одного запроса тоже ограничен настройкой игры RequestSizeLimit, по умолчанию это 1000 символов.
Important
Роли с Bypass Limits пропускают эти проверки, так что будь осторожен, кому ты её выдаёшь.
Выбери, что загружается¶
Ты сам решаешь, какие именно команды загружаются в твою игру. В ConfigCommands твоего загрузчика лежат семь модулей по умолчанию (Owner, Dev и так далее), которые подтягивают готовые наборы команд через Internal.loadCommands:

-- Config/Commands/Admin
local modules = script:FindFirstAncestor("HD Admin").Core.MainModule.Value.Modules
local Internal = require(modules.Internal)
return Internal.loadCommands({
modules = {"AdminPack"}, -- what collection to load (e.g. "AdminPack", "ModUtility", etc)
exclude = {"LoadMap", "SaveMap"}, -- commands to be skipped from loading
onlyInclude = {}, -- when not-empty, ONLY these commands load
tag = script.Name, -- the tag added to every command loaded here which is then used in the 'From Tags' selector in role settings
modify = { -- a way to change how a command is defined before it loads, keyed by command name
map = function(command)
command.config.loadMapOnStart = true
end,
},
})
Эти готовые наборы лежат в MainModuleValueModulesInternalCommands (например, "AdminPack" или "DevPack"), и можно указывать наборы поменьше, такие как "ModUtility", "Movement" и другие.
Если модуль ни разу не упомянут в loadCommands, его код не подключается через require, клиентские модули не загружаются, а ассеты не передаются клиентам.
Warning
Если убрать команды, от которых зависит страница, её возможности перестанут работать. Например, если команда ban не загружается, то функции «Add Ban» на странице Ban тоже не будут работать.
Проверка команд¶
Мы часто добавляем в HD Admin новые команды. Они попадают в самый подходящий пак (а значит, и в нужные роли), но разработчики не раз просили оставить за ними последнее слово в том, что попадёт в их плейс. Поэтому мы сделали раздел Vet Commands:
У ролей с правом редактирования Vet Commands вверху страницы Commands появится кнопка Vet. Она открывает раздел проверки с тремя вкладками:
| Вкладка | Что в ней |
|---|---|
| Pending | Новые команды, по которым ещё нет решения. Запускать их могут только проверяющие, так что можно спокойно тестировать до одобрения |
| Approved | Команды, которые может использовать любой, у кого есть к ним доступ |
| Disabled | Команды, которые не может запустить никто, даже владелец. Как и Pending, они скрыты со страницы Commands |
Полный список команд смотри здесь.
Tip
По умолчанию «Auto Approve New» стоит в true, так что если хочешь, чтобы новые команды всегда попадали в Pending, переключи это значение на false прямо в игре.
Info
Большинство будущих команд будут выходить в ExtraPack. Поэтому даже при «Auto Approve New» в true можно не бояться, что новые команды внезапно появятся на твоей странице команд: тег «Extra» по умолчанию не используется ни в одной роли. Вместо этого тебе придёт уведомление при каждом добавлении новой команды, и ты решишь, добавлять её в существующую или новую роль или нет.
Инструменты¶
Настраивать ;give и ;giveAll не нужно: HD Admin сам просматривает ReplicatedStorage, ServerStorage, Lighting и StarterPack в поисках каждого экземпляра Tool. Найденные инструменты показываются на странице запуска и в подсказках командной строки. Если хочешь держать их все в одном месте, положи их в HD AdminConfigTools.