Pular para conteúdo

Comandos

Comandos no chat

Você pode executar comandos no chat. O prefixo padrão é ;:

;fly me
;paint all red

Seu prefixo é pessoal e pode ser alterado no painel, em You Settings (a menos que o dono do jogo tenha bloqueado). Para executar um comando sem que ele apareça na janela do chat, coloque /e na frente:

/e ;fly me

Comandos no painel

A página Comandos do painel lista todos os comandos que você pode usar, e ao clicar em cada um você abre a própria página de execução dele, onde dá para preencher os argumentos com facilidade. Isso é essencial para jogadores que não conseguem usar o chat, e também útil quando você não lembra o que um comando espera.


Barra de comandos

Também existe uma barra de comandos na tela, com sugestões ao vivo e preenchimento automático para executar comandos rapidamente. Seus comandos recentes ficam salvos, então executar um de novo leva só algumas teclas. Pressione a tecla Aspas simples (') ou Ponto e vírgula (;) para abri-la. Ela só pode ser aberta se o(s) seu(s) cargo(s) concederem a permissão Command Bar.


Selecionando jogadores

A maioria dos comandos recebe um jogador. Parte do nome já basta (;fly ben encontra Benjamin), ou coloque @ na frente para buscar pelo nome de usuário em vez do nome de exibição, como ;fly @ForeverHD (nomes de usuário parciais também funcionam). Você também pode trocar o nome por um qualificador:

Qualificador Seleciona
me você
all todos os jogadores do servidor
others todos, menos você
random um jogador aleatório
role(mod) jogadores com esses cargos
friends jogadores que são seus amigos
radius(20) jogadores dentro dessa quantidade de studs de você
amount(5) essa quantidade de jogadores aleatórios
percent(50) essa porcentagem do servidor
team(red) jogadores nessas equipes
group(123456) jogadores nesses grupos do Roblox
premium jogadores com Roblox Premium
;jump others
;kill radius(20)
;give team(red) sword

Os qualificadores se encadeiam com vírgulas, então ;fly me,role(admin) seleciona você e todos os admins. Selecionar alguém além de você mesmo e selecionar vários jogadores de uma vez também são permissões de cargo (Targeting Others e Multiple Targets). Veja Cargos para saber como concedê-las.


Modificadores

Os modificadores são colocados na frente do nome de um comando e mudam a forma como ele é executado:

;unfly me
;globalMessage hello
;permMusic 123456
Modificador Efeito Permissão
undo (ou un) encerra todas as tarefas deste comando e/ou jogador Neutral
preview abre a página de execução do comando em vez de executá-lo Neutral
random escolhe um comando aleatório da instrução Neutral
loop(10,2) executa de novo repetidamente, aqui 10 vezes com 2 segundos entre as execuções Abusive
spawn executa agora e toda vez que o jogador renascer Abusive
delay(5) espera essa quantidade de segundos antes de executar Abusive
schedule(1767225600) executa no horário epoch informado Abusive
expire(30) (ou until) termina depois dessa quantidade de segundos Abusive
join executa nos jogadores quando eles entram neste servidor Global
global executa uma vez em todos os servidores Global
perm executa em todos os servidores, atuais e futuros Global
permSpawn executa agora e toda vez que os jogadores renascerem, neste servidor e em todo servidor futuro em que entrarem Global
permJoin executa nos jogadores quando eles entram, em todos os servidores, atuais e futuros Global
permLoop executa de novo repetidamente, em todos os servidores, atuais e futuros Global
permDelay espera e depois executa, em todos os servidores, atuais e futuros Global
permSchedule executa no horário epoch informado, em todos os servidores, atuais e futuros Global
unperm encerra todas as tarefas permanentes deste comando e/ou jogador Global

Important

Os modificadores Abusive e Global exigem as permissões de cargo Modifiers Abusive e Modifiers Global para serem usados. Tenha MUITO cuidado com quem recebe essas permissões, já que um único comando global pode alcançar todos os servidores da sua experiência.


Limites

Os comandos têm limite de frequência e de tamanho para que os jogadores não sobrecarreguem seu servidor. Cada cargo tem um valor de Commands Per Minute e de Requests Per Second, e vale o maior valor entre os cargos que você possui. Uma única requisição também é limitada pela configuração de jogo RequestSizeLimit, que por padrão é 1000 caracteres.

Important

Cargos com Bypass Limits ignoram essas verificações, então tenha cuidado com quem recebe essa permissão.


Decidir o que carrega

Você decide exatamente quais comandos são carregados no seu jogo. O ConfigCommands do seu loader contém sete módulos padrão (Owner, Dev, etc.) que trazem coleções prontas de comandos por meio de Internal.loadCommands:

imagem

-- 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,
    },
})

Você encontra essas coleções prontas em MainModuleValueModulesInternalCommands (por exemplo "AdminPack" ou "DevPack") e pode até especificar coleções menores, como "ModUtility", "Movement", etc.

Se um módulo nunca é referenciado via loadCommands, o código dele nunca é executado com require, os módulos de cliente nunca são carregados e os assets nunca são replicados para os clientes.

Warning

Remover comandos dos quais uma página depende desativa os recursos dela. Por exemplo, se o comando ban nunca for carregado, os recursos de 'Add Ban' da página Ban deixam de funcionar.


Revisar comandos

Adicionamos novos comandos ao HD Admin com frequência e, embora eles sejam agrupados no pacote mais adequado (e, portanto, nos cargos), os desenvolvedores muitas vezes pediram ter uma palavra final sobre quais comandos entram na experiência deles. Para resolver isso, criamos uma nova seção Vet Commands:

Cargos com a permissão de edição Vet Commands verão um novo botão Vet no topo da página Comandos. Ele abre a seção Vet com três abas:

Aba O que ela contém
Pending Comandos novos aguardando uma decisão. Só quem revisa pode executá-los, então você pode testar com segurança antes de aprovar
Approved Comandos que todos com acesso podem usar
Disabled Comandos que ninguém pode executar, nem mesmo o Owner. Assim como os Pending, eles também ficam ocultos da página Comandos

Veja a lista de todos os comandos aqui.

Tip

Por padrão, "Auto Approve New" vem como true, então você precisa alterar isso no jogo para false se quiser que os comandos novos sempre entrem como Pending.

Info

A maioria dos comandos futuros será publicada em ExtraPack, ou seja, mesmo com "Auto Approve New" como true, você não precisa se preocupar com comandos novos aparecendo aleatoriamente na sua página de comandos, já que a tag "Extra" não é usada por padrão em nenhum cargo. Em vez disso, você será avisado sempre que um novo comando for adicionado, e então poderá decidir se quer incluí-lo em um cargo existente ou novo.


Ferramentas

Você não precisa se preocupar em configurar ;give e ;giveAll, pois o HD Admin procura em ReplicatedStorage, ServerStorage, Lighting e StarterPack por toda instância de Tool. As que forem encontradas aparecem na página de execução e nas sugestões da barra de comandos. Se preferir manter todas em um só lugar, coloque-as em HD AdminConfigTools.