Navegação da documentação

Configuração

Onde fica cada coisa#

Bancadas, receitas, rotas e melhorias vivem no banco e são editadas dentro do jogo, pelo /craftconfig. Salvou, vale na hora para quem já está online — sem editar .lua, sem reiniciar o recurso.

O que sobrou em arquivo é o técnico, que muda uma vez na instalação:

ArquivoO que tem
config/config.luavisual, prefixo das tabelas, anti-abuso, raios, textos, NPC das rotas, aviso à polícia, encomendas, grupos do /craftconfig e do /sfdiagnostico
bridge/server.luacomo falar com a sua framework: item, dinheiro, permissão, grupos, notify
bridge/client.luacomo falar com o seu target, notify, barra de progresso, blip

/craftconfig#

Quatro abas. Toda gravação é validada no servidor e recarregada na hora.

Bancadas#

CampoO que faz
Idchave interna. Não muda depois — é o que liga armazém, fila e histórico
Nome / Subtítuloo que aparece na tela
Permissãogrupo que pode usar. Vazio = qualquer um
Modode quem é o armazém: compartilhado, pessoal, da facção, ou os dois
Facções com cofrequais facções têm cofre aqui. A ordem importa: quem está em duas cai sempre na primeira
Encomendasaceita pedidos pagos adiantado, com prazo e teto por jogador
Raio da zonatamanho do ponto de interação. Zero faz a bancada sumir do mapa
Capacidade / Limite por itemtamanho do armazém
Produção simultâneaquantos crafts ao mesmo tempo
Locaisquantos você quiser. O botão Usar minha posição pega onde você está

Desativar uma bancada não apaga nada: armazém, fila e histórico continuam guardados e voltam inteiros quando você reativar.

O modo Organização e o Pessoal e organização exigem ao menos uma facção cadastrada. Sem isso a bancada abriria e recusaria todo mundo sem explicar por quê — o painel recusa salvar, e o /sfdiagnostico também aponta.

Receitas#

Escolha a bancada e cadastre o que ela produz: item, nome na tela, quantidade por produção, tempo, destino (armazém e/ou mochila) e os ingredientes.

  • Item é a CHAVE do item no seu inventário, não o nome de exibição. Errar aqui é a causa nº 1 de "a bancada abre e não produz" — o /sfdiagnostico aponta.
  • Permissão da receita deixa a receita exclusiva de um grupo dentro de uma bancada que os outros também usam.

Rotas#

Ponto inicial (onde fica o NPC), pontos de entrega na ordem em que o jogador deve seguir, itens coletados com faixa mínima/máxima, pagamento por entrega e a chance de denúncia à polícia. Os pontos são marcados andando até eles e clicando em Usar minha posição.

A chance de denúncia é por rota; quem recebe o aviso fica em Config.Rotas.Policia.Grupos. Com a chance configurada e nenhum grupo na lista, o sorteio roda e o aviso cai no vazio — o /sfdiagnostico avisa.

Melhorias#

Escada de níveis por bancada, em três trilhas independentes:

TrilhaO que aumenta
Armazémcapacidade e limite por item
Produçãocrafts simultâneos
Velocidadereduz o tempo de cada produção (até 90%)

Cada degrau precisa custar mais e entregar mais que o anterior — o painel recusa uma escada que não cresce, porque o jogador pagaria mais por menos sem nada acusar o erro.

O nível acompanha o dono do armazém, não a bancada. Num cofre de facção, quem paga a melhoria é a facção e o benefício fica com ela; preso à bancada, um jogador compraria e a cidade inteira levaria junto.

Encomendas#

Ligadas por bancada, no /craftconfig. Em config/config.lua ficam só o intervalo da varredura que expira e devolve, e por quantos dias a encomenda encerrada permanece na tabela.

O dinheiro sai da conta do comprador no instante em que a encomenda nasce e fica retido nela. Sai de lá para o crafter a cada entrega, ou volta inteiro para o comprador quando a encomenda vence ou é cancelada. A devolução tem marca própria no banco: se o servidor cair no meio, a varredura seguinte devolve.

Anti-abuso das rotas#

Config.Rotas.VelocidadeMaxMs é a velocidade máxima (m/s) admitida entre duas coletas. O padrão, 120 m/s (~430 km/h), é folgado de propósito: o alvo é o salto instantâneo, não o carro rápido. 0 desliga.

Uma coleta recusada por esse motivo não encerra a rota — teleporte de staff e reposicionamento por queda de conexão acontecem, e punir o jogador por isso seria pior que o abuso.