1. INTRODUÇÃO
Este documento descreve, de forma técnica e detalhada, o funcionamento e a utilização dos comandos administrativos disponíveis no servidor.
O objetivo é padronizar o uso por parte da equipe administrativa, garantindo:
Organização
Segurança
Rastreabilidade (logs)
Uso adequado das permissões
Todos os comandos aqui descritos estão integrados ao sistema vRP e possuem validações de permissão baseadas em grupos e níveis hierárquicos.
2. ESTRUTURA DE PERMISSÕES
2.1 Grupo Administrativo
Grupo principal:
Admin
Hierarquia definida:
| Nível | Cargo |
|---|---|
| 1 | Diretor |
| 2 | Administrador Geral |
| 3 | Administrador |
| 4 | Super Moderador |
| 5 | Moderador |
| 6 | Suporte |
Regra geral:
Quanto menor o número, maior o nível de acesso.
Comandos utilizam verificações como:
vRP.HasGroup(Passport, "Admin", nível)vRP.HasPermission(Passport, "Admin", nível)
2.2 Console
Quando source == 0:
O comando está sendo executado via console (txAdmin ou terminal)
Ignora verificações de permissão
Possui acesso total
3. COMANDOS ADMINISTRATIVOS
3.1 /skinshop
Descrição:
Abre a interface de personalização de personagem.
Uso:
/skinshop
/skinshop [ID]
Permissão:
Admin nível 5 ou superior
Grupo Marketing
Comportamento:
Sem ID: abre para o próprio administrador
Com ID: abre para o jogador especificado
3.2 /debug
Descrição:
Ativa ou desativa o modo de debug no cliente.
Permissão:
Admin nível 5 ou superior
3.3 /addpeso
Descrição:
Define o peso máximo da mochila de um jogador.
Uso:
/addpeso [ID] [QUANTIDADE]
Permissão:
Admin nível 2 ou superior
Observações:
Substitui o peso atual
Pode ser executado via console
3.4 /removerpeso
Descrição:
Remove peso da capacidade de inventário do jogador.
Uso:
/removerpeso [ID] [QUANTIDADE]
Permissão:
Admin nível 5 ou superior
3.5 /kill
Descrição:
Força a morte de um jogador.
Uso:
/kill [ID]
Permissão:
Grupo Admin
Restrições:
Jogadores com permissão especial (HiddenSecret) não podem ser afetados, exceto por Owner
Logs:
Registrado no Discord com sucesso ou falha
3.6 /ugroups
Descrição:
Lista todos os grupos vinculados a um jogador.
Uso:
/ugroups [ID]
Permissão:
Admin nível 5 ou superior
3.7 /clearinv
Descrição:
Remove todos os itens do inventário de um jogador.
Uso:
/clearinv [ID]
Permissão:
Admin nível 5 ou superior
Grupo Marketing
Execução:
Disponível via console e in-game
3.8 /addGems
Descrição:
Adiciona moedas premium (gems) à conta de um jogador.
Uso:
/addGems [ID] [QUANTIDADE]
Permissão:
Admin nível 2 ou superior
Observações:
Utiliza query direta no banco de dados
Possui log completo com IP e executor
3.9 /blips
Descrição:
Exibe todos os jogadores no mapa.
Permissão:
Grupo Admin
3.10 /item
Descrição:
Gera item para o próprio administrador.
Uso:
/item [nome] [quantidade]
Permissão:
Admin nível 3 ou superior
Grupo Marketing
3.11 /daritem
Descrição:
Gera item para outro jogador.
Uso:
/daritem [item] [quantidade] [ID]
Permissão:
Admin nível 7 ou superior
3.12 /delete
Descrição:
Remove permanentemente um personagem.
Uso:
/delete [ID]
Permissão:
Admin nível 2 ou superior
3.13 /nc
Descrição:
Ativa/desativa noclip.
Permissão:
Admin ou Marketing
3.14 /vergaragem
Descrição:
Lista os veículos de um jogador e envia ao Discord.
Uso:
/vergaragem [ID]
Permissão:
Admin nível 2 ou superior
3.15 /kick
Descrição:
Remove um jogador do servidor.
Uso:
/kick [ID] [MOTIVO]
Permissão:
Admin nível 5 ou superior
3.16 /ban
Descrição:
Aplica banimento temporário.
Uso:
/ban [ID] [DIAS] [MOTIVO]
Permissão:
Admin nível 5 ou superior
Limite:
Máximo de 999 dias
3.17 /unban
Descrição:
Remove o banimento de um jogador.
Uso:
/unban [ID]
Permissão:
Admin nível 4 ou superior
3.18 /god
Descrição:
Restaura completamente o estado do jogador.
Uso:
/god
/god [ID]
Efeitos:
Revive
Remove stress
Restaura fome e sede
3.19 /godarea
Descrição:
Aplica efeitos do /god em jogadores próximos.
Uso:
/godarea [RAIO]
Permissão:
Admin nível 3 ou superior
3.20 /godall
Descrição:
Aplica o efeito de cura em todos os jogadores online.
3.21 /tpcds
Descrição:
Teleporta o administrador para coordenadas específicas.
3.22 /cds
Descrição:
Copia as coordenadas atuais do jogador.
3.23 /limparfac
Descrição:
Remove todos os jogadores de um grupo.
Uso:
/limparfac [GRUPO]
Permissão:
Admin nível 5 ou superior
3.24 /group
Descrição:
Adiciona um grupo a um jogador.
Uso:
/group [ID] [GRUPO] [NIVEL]
Exemplo:
/group 10 Admin 1
Regras:
Apenas níveis autorizados podem adicionar grupos superiores
Owner possui controle total
3.25 /ungroup
Descrição:
Remove um grupo de um jogador.
Uso:
/ungroup [ID] [GRUPO]
Permissão:
Admin nível 7 ou superior
3.26 /tptome
Descrição:
Teleporta um jogador até o administrador.
3.27 /tpto
Descrição:
Teleporta o administrador até um jogador.
3.28 /tpway
Descrição:
Teleporta até o waypoint definido no mapa.
3.29 /limbo
Descrição:
Remove o jogador do estado de desmaio.
3.30 /hash
Descrição:
Obtém o hash do veículo atual.
Permissão:
Admin nível 6 ou superior
4. REGISTRO DE LOGS
Todos os comandos críticos são registrados via webhook no Discord, incluindo:
Identificação do administrador
ID do alvo
Ação realizada
Data e hora
Status (sucesso ou falha)
Isso garante rastreabilidade e auditoria completa.
5. BOAS PRÁTICAS
Sempre justificar ações administrativas (kick, ban, delete)
Evitar uso desnecessário de comandos sensíveis
Não utilizar comandos para benefício próprio
Respeitar a hierarquia definida
Manter consistência na aplicação de punições
6. CONSIDERAÇÕES FINAIS
O sistema administrativo possui alto nível de controle e impacto direto na experiência dos jogadores e na economia do servidor.
O uso correto dessas ferramentas é essencial para:
Manutenção da ordem
Prevenção de abusos
Estabilidade do servidor
A responsabilidade pelo uso adequado é individual e monitorada por meio dos logs gerados.
Caso necessário, este documento pode ser expandido com:
Fluxos operacionais da staff
Padronização de punições
Integração com sistemas externos (Discord, painel web, etc.)