Este guia abrange todos os comandos de admin e consola disponíveis para o seu servidor dedicado de Empyrion: Galactic Survival na Legion Hosting. Aprenda a configurar permissões de admin, gerir jogadores e utilizar comandos de GameMaster para administrar o seu servidor. Para a configuração inicial do servidor, consulte o nosso Guia de Configuração do Servidor Empyrion: Galactic Survival.
Níveis de Permissão
O Empyrion utiliza um sistema de permissões numerado onde números mais baixos concedem privilégios mais elevados. Cada nível de permissão inclui todos os comandos disponíveis nos níveis com números mais altos.
| Nível | Função | Código | Descrição |
|---|---|---|---|
| 0 | Player | pl |
Nível de permissão predefinido para todos os jogadores. Acesso apenas a comandos básicos. |
| 3 | GameMaster | gm |
Permissões elevadas para gestão do jogo, teletransporte, spawn e controlo do mundo. |
| 6 | Moderator | mod |
Capacidades de gestão de jogadores, incluindo banir, dar itens e gestão de entidades. |
| 9 | Admin | admin |
Privilégios administrativos completos, incluindo atribuição de funções, gestão de playfields e controlo do servidor. |
Configurar Permissões de Admin
Método 1: adminconfig.yaml (Recomendado)
A forma mais fiável de configurar permissões de admin é através do ficheiro adminconfig.yaml. Este ficheiro está localizado na pasta Saves/ do seu servidor (ou por vezes junto ao seu dedicated.yaml).
Crie ou edite o adminconfig.yaml com a seguinte estrutura:
Elevated:
- Id: 76561198012345678
Permission: 3
Name: "PlayerOne"
- Id: 76561198087654321
Permission: 9
Name: "ServerAdmin"
Banned:
- Id: 76561198099999999
Until: "2027-01-01 00:00:00"
Cada entrada requer:
Id— O SteamID64 do jogador (um número de 17 dígitos que começa com 7656)Permission— O nível de permissão a atribuir (3 = GameMaster, 6 = Moderator, 9 = Admin)Name— O nome do jogador (opcional, para sua referência)
7656.
Método 2: Comando de Consola initadmin
Se estiver ligado ao servidor como jogador e ainda não tiver sido definido nenhum admin, pode utilizar o comando initadmin para se definir como o administrador inicial:
initadmin
Isto só funciona se nenhum admin estiver atualmente configurado. Uma vez que exista um admin, as atribuições de funções adicionais devem ser feitas através do comando setrole ou do ficheiro adminconfig.yaml.
Método 3: Comando de Consola setrole
Os admins existentes (nível de permissão 9) podem atribuir funções a outros jogadores utilizando o comando setrole:
setrole PlayerName gm # Set as GameMaster (level 3)
setrole PlayerName mod # Set as Moderator (level 6)
setrole PlayerName admin # Set as Admin (level 9)
setrole PlayerName pl # Reset to Player (level 0)
Também pode utilizar o SteamID64 do jogador em vez do seu nome:
setrole 76561198012345678 gm
Abrir a Consola
Para aceder à consola dentro do jogo, prima a tecla til (~) no seu teclado. A consola permite-lhe introduzir comandos diretamente enquanto joga. Todos os comandos são insensíveis a maiúsculas e minúsculas.
dedicated.yaml. Ligue-se utilizando PuTTY ou um cliente de terminal semelhante com tipo de ligação Raw (não Telnet padrão) à porta Telnet (predefinição: 1030). Consulte o Guia de Configuração do Servidor para detalhes de configuração do Telnet.
Comandos de Jogador (Nível 0+)
Estes comandos estão disponíveis para todos os jogadores.
| Comando | Descrição |
|---|---|
help |
Lista todos os comandos de consola disponíveis. Utilize help [command] para detalhes sobre um comando específico. |
detach |
Desanexa o jogador local se estiver preso sob um cockpit ou na geometria |
destroyme |
Mata a sua própria personagem (útil se estiver preso) |
undock |
Desacopla um SV ou HV especificado da sua estrutura principal |
difficulties |
Mostra as definições de dificuldade atuais do jogo |
origins |
Lista as origens disponíveis (fações iniciais) |
oxygen |
Mostra áreas oxigenadas num POI |
combiner |
Ativa/desativa o combinador de malhas (desempenho) |
deco |
Ativa/desativa as decorações de terreno (desempenho) |
initadmin |
Define-o como o administrador inicial (só funciona se nenhum admin estiver definido) |
Comandos de GameMaster (Nível 3+)
Os comandos de GameMaster fornecem controlo sobre o mundo do jogo, entidades e estado dos jogadores.
Gestão de Jogadores e Entidades
| Comando | Descrição |
|---|---|
godmode / gm |
Ativa/desativa o modo deus (invulnerabilidade) para si próprio |
itemmenu / im |
Ativa/desativa o menu criativo de itens para fazer spawn de qualquer item |
kick [player] |
Expulsa um jogador (ou todos os jogadores) do jogo |
unban [player|SteamID] |
Remove o banimento de um jogador |
list |
Lista jogadores com permissões especiais e jogadores banidos |
level [set|add] [value] |
Modifica o nível, pontos de experiência ou pontos de melhoria do jogador atual |
entity [operation] |
Realiza várias operações em entidades (utilize help entity para detalhes) |
ents |
Lista todas as entidades no playfield atual |
find [name] |
Encontra uma estrutura pelo nome dentro do playfield atual e mostra o seu ID |
faction [operation] |
Funções auxiliares de gestão de fações |
Teletransporte e Movimento
| Comando | Descrição |
|---|---|
teleport [x] [y] [z] / tt |
Teletransporta-o (e a nave controlada) para coordenadas específicas |
setposition [entity] [x] [y] [z] |
Define a posição de uma entidade para coordenadas específicas |
setrotation [entity] [x] [y] [z] |
Define a rotação de uma estrutura |
sector [x] [y] [z] |
Salta para um setor específico no espaço |
Gestão do Mundo e do Jogo
| Comando | Descrição |
|---|---|
changemode |
Alterna o jogo entre os modos Sobrevivência e Criativo |
map |
Revela todos os recursos e POIs no mapa atual |
regenerate [entityId] |
Regenera um POI ou estrutura, restaurando-o ao seu estado original |
weather [type] |
Ativa uma definição de clima personalizada no playfield atual |
time [set] [value] |
Obtém ou define o tempo global do servidor |
finishbp / fbp |
Conclui instantaneamente a produção do blueprint atual |
spawnanyblueprint / sbp |
Ativa/desativa a capacidade de fazer spawn de qualquer blueprint independentemente dos requisitos |
gameoptions / gopt |
Lista todos os valores atuais das opções de jogo (ver secção Opções de Jogo abaixo) |
op [entityId] |
Ativa/desativa a proteção offline numa estrutura específica |
wipe [target] |
Limpa aspetos específicos após reinício do servidor (utilizar com cuidado) |
stats |
Mostra informações de estado sobre o playfield atual |
traders |
Lista todos os comerciantes e recarrega o ficheiro de configuração dos comerciantes |
Efeitos de Estado e Estado do Jogador
| Comando | Descrição |
|---|---|
statuseffect [effect] |
Aplica um efeito de estado ao jogador |
statuseffectremove [effect] |
Remove um efeito de estado do jogador |
prefabactivate |
Liga todos os blocos com energia numa estrutura |
prefabinfo |
Mostra informações sobre um blueprint do utilizador |
resetcore |
Limpa o combustível e o oxigénio na estrutura local |
Comandos de Moderador (Nível 6+)
Os comandos de moderador adicionam capacidades de gestão de jogadores e controlo de entidades.
| Comando | Descrição |
|---|---|
ban [player] [duration] |
Bane um jogador por um período de tempo especificado |
give [player] [itemId] [amount] |
Dá itens a um jogador por ID de item |
repair [player] |
Repara os itens de um jogador |
destroy [entityId] |
Destrói uma entidade ou estrutura |
debugmenu / dm |
Ativa/desativa o menu de depuração |
armor [operation] |
Ajustes de armadura para jogadores |
gents [factionId] |
Lista todas as estruturas pertencentes a uma fação específica |
alliances |
Lista alianças, pedidos de aliança e gere definições de alianças |
sectors [reveal|hide] |
Revela ou oculta playfields no mapa |
ai |
Ativa ou desativa a IA no playfield atual |
si |
Ativa ou desativa os cálculos de integridade estrutural |
globaleffects |
Mostra os efeitos globais atualmente ativos no servidor |
marker [operation] |
Gere marcadores no mapa |
weathersv [type] |
Ativa uma definição de clima personalizada em todo o servidor |
poimanager |
Comandos de gestão de POI (Ponto de Interesse) |
Comandos de Admin (Nível 9)
Os comandos de admin fornecem o nível mais elevado de controlo do servidor.
| Comando | Descrição |
|---|---|
setrole [player|SteamID] [role] |
Define a função de permissão de um jogador (gm, mod, admin, pl) |
playfield / pf |
Recarrega o playfield atual (comando apenas do servidor) |
replaceblocks [entityId] [blockFrom] [blockTo] |
Substitui blocos especificados numa estrutura por outro tipo de bloco |
setdevicespublic [entityId] |
Define todos os dispositivos numa estrutura como acesso público |
pda [operation] |
Executa comandos relacionados com o PDA (utilize help pda para detalhes) |
Comando de Opções de Jogo (gopt)
O comando gameoptions (ou gopt) permite-lhe ver e modificar definições de jogabilidade do servidor em tempo de execução, sem editar ficheiros de configuração ou reiniciar o servidor.
Ver Definições
# Show all game options
gopt
# Show only settings that differ from defaults
gopt nd
Modificar Definições
# Set a specific option
gopt set DecayTime 48
gopt set MaxStructures 150
gopt set ForcePvP true
gopt set DiffAttackStrength Hard
gopt set DiffConstrCraftTime Instant
Opções de Jogo Disponíveis
| Opção | Predefinição | Descrição |
|---|---|---|
DecayTime |
24 | Horas antes de estruturas sem núcleo/pequenas serem removidas quando não visitadas |
WipeTime |
0 | Horas antes de qualquer estrutura não visitada ser removida (0 = desativado) |
ProtectTime |
48 | Horas de proteção offline para estruturas de jogadores |
ProtectDelay |
300 | Segundos antes da proteção offline ser ativada |
MaxStructures |
200 | Máximo de estruturas por playfield (0-255) |
AntiGriefDistancePvE |
30 | Distância mínima em metros entre bases de fações em PvE |
AntiGriefDistancePvP |
300 | Distância mínima em metros entre bases de fações em PvP |
ForcePvP |
false | Forçar PvP em todos os playfields |
DiffAmountOfOre |
Normal | Abundância de depósitos de minério (Rich, Normal, Poor) |
DiffNumberOfDeposits |
Normal | Frequência de depósitos (Plenty, Normal, Few) |
DiffAttackStrength |
Medium | Dano de ataque dos NPCs (Easy, Medium, Hard) |
DiffConstrCraftTime |
Normal | Velocidade do construtor (Faster, Normal, Slower, Instant) |
Comandos de Gestão do Servidor
Estes são comandos essenciais para a administração diária do servidor, disponíveis através da consola dentro do jogo ou Telnet.
# Save and shut down the server (with countdown in minutes, max 15)
saveandexit 5
# List all connected players
plys
# List all active playfield servers
servers
# Regenerate a specific playfield
regenerateplayfield [name]
# View server performance statistics
stats
saveandexit [minutes] para encerrar o servidor em segurança. Isto aciona uma gravação automática e dá aos jogadores ligados uma contagem decrescente de aviso. Terminar diretamente o processo do servidor pode resultar em perda de dados.
Tarefas Comuns de Admin
Lidar com Jogadores Presos
Se um jogador estiver preso na geometria ou debaixo de um cockpit:
# Player can try this themselves:
detach
# If that fails, teleport them:
tt [player] [x] [y] [z]
# Or as a last resort, kill and respawn:
destroyeme
Limpar Estruturas Abandonadas
# List all structures for a faction
gents [factionId]
# Find a specific structure
find "Structure Name"
# Destroy a structure by ID
destroy [entityId]
# Adjust automatic decay timers
gopt set DecayTime 12
gopt set WipeTime 168
Banir e Desbanir Jogadores
# Ban a player (duration examples: 1h, 24h, 7d, permanent)
ban PlayerName 7d
# Unban a player
unban PlayerName
# List all players with special roles or bans
list
Artigos Relacionados
- Guia de Configuração do Servidor Empyrion: Galactic Survival
- Como Encontrar o IP e a Porta do Seu Servidor
- Como Carregar Ficheiros via SFTP
- Primeiros Passos com o Seu Novo Servidor
Precisa de Ajuda?
Se precisar de mais assistência com a administração do servidor Empyrion ou tiver questões sobre comandos específicos, a nossa equipa de suporte está pronta para ajudar. Submeta um ticket de suporte e responderemos o mais brevemente possível.