Перейти к содержанию

Команды

Команды в чате

Команды можно запускать прямо в чате. Префикс по умолчанию ;:

;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.