Manual › FH VIRTUAL PAINEL › Instalação dos mods

Instalação dos mods

Requisitos, ordem de carregamento, primeiro start e o mapa completo de pastas que os mods criam no servidor.

Nesta páginaOs 4 pacotes Requisitos Linha de comando Primeiro start Mapa das pastas Checklist depois de instalar Regras para editar JSON

Os 4 pacotes

Pasta	Onde vai	Função
`@FH-SHOP`	Cliente e servidor (`-mod=`)	Interface da loja e do Painel VIP, itens (moeda, tickets, caixas, skins), sons e teclas.
`@FH-SHOPServer`	Só servidor (`-serverMod=`)	Lê os JSON, cobra DCoins, entrega itens/veículos, ativa VIP, recompensa e recarga.
`@FH-CarSeguro`	Cliente e servidor (`-mod=`)	Chips, interface do seguro, tranca, holograma do redrop, sons.
`@FH-CarSeguroServer`	Só servidor (`-serverMod=`)	Registra carros, redrop, acionar, busca, tranca, logs e integração com garagem.

Requisitos

Community Framework (CF) — obrigatório para os dois mods (loja, Painel VIP e seguro usam o CF). Carregue antes de tudo.
Licença: no start, os servidores dos mods verificam a licença. Servidores hospedados na FlameHost são liberados automaticamente. Fora da FlameHost, é preciso o arquivo de licença (ver abaixo).
Internet de saída (HTTPS) no start, para a verificação de licença (e para a recarga, se usar).
Jogadores precisam dos mods de cliente (@FH-SHOP, @FH-CarSeguro e o CF) — o DZSA Launcher baixa sozinho.

Sem licença válida o servidor desliga sozinho logo após iniciar. Fora da FlameHost, coloque a chave em:

Loja/VIP: profiles/FlameHost/Addons/Shop/private.key (ou profiles/FlameHost/private.key)
Seguro: profiles/FlameHost/Addons/CarSeguro/private.key (ou profiles/FlameHost/private.key)

A chave vai na primeira linha do arquivo.

Linha de comando

-mod=@CF;@FH-SHOP;@FH-CarSeguro
-serverMod=@FH-SHOPServer;@FH-CarSeguroServer
-profiles=profiles

No painel TCFLAMEV2: coloque os dois de cliente no campo MOD e os dois de servidor no SERVERMOD (ou use o ServerSideMods.txt). Copie as .bikey dos pacotes (pasta keys de cada mod) para keys\ da raiz.

@FH-SHOPServer exige @FH-SHOP carregado. Se o servidor não sobe, confira a ordem e o .RPT.

Primeiro start

Suba o servidor com os mods e espere carregar o mapa.
Pare o servidor.
Abra profiles/FlameHost/Addons/: existem Shop, PainelVip e CarSeguro, com os arquivos de fábrica.
Faça os ajustes do checklist e suba de novo.

Todas as configurações são lidas só no start. Mudou um JSON? Reinicie o servidor. A única exceção é o saldo de DCoins de cada jogador (lido a cada abertura da loja).

Mapa das pastas

profiles/FlameHost/Addons/
├── Shop/
│   ├── Config.json                  ← loja: tecla, abas, moeda, recompensa, webhook, admins
│   ├── Settings/                    ← catálogo (um JSON por aba)
│   ├── Items/
│   │   ├── ItemTeleport.json        ← coordenadas dos tickets de teleporte
│   │   └── GiftBox*.json            ← conteúdo das caixas misteriosas
│   ├── ConfigPayment.v1.json        ← recarga com dinheiro real (opcional)
│   ├── ConfigPaymentPacks.v1.json   ← pacotes de recarga (só aparece com licença de pagamento)
│   ├── Players/PlayerDatabase/      ← saldo de cada jogador (SteamID64.json)
│   └── Logs/LogStore.log
├── PainelVip/
│   ├── Config.json                  ← liga/desliga, tecla, proteção de spawn, corpo
│   ├── Exclusive_Itens.json         ← itens exclusivos de VIP
│   ├── Exclusive_Explicacao.txt
│   ├── Vips/                        ← um JSON por plano VIP (+ vips_explicando.txt)
│   ├── db/db_vips.json              ← quem tem VIP e até quando
│   ├── db/db_vips_resumo.txt        ← resumo legível (gerado no start)
│   └── Logs/Log_*.log               ← um arquivo por start
└── CarSeguro/
    ├── Config.json                  ← tempos, cooldowns, lockpick, anúncios, admins
    ├── ConfigChips.json             ← o que cada chip dá
    ├── Carros/                      ← peças que o carro recebe no redrop (opcional)
    ├── Data/Cars/  Data/Players/    ← dados ao vivo (não edite com o servidor ligado)
    └── Logs/Log_*.log

No PC do jogador (não no servidor) fica o preset do Painel VIP: FlameHost/CachePlayer/VipCachePreset.json no profile do DayZ dele.

Checklist depois de instalar

Seu SteamID64 de admin (17 dígitos) em Shop/Config.json → Admins e CarSeguro/Config.json → Admins. (O campo SteamIDAdmins do Painel VIP não é usado.)
Coordenadas de teleporte do seu mapa em Shop/Items/ItemTeleport.json (as de fábrica são de Chernarus).
Catálogo: revise preços e itens em Shop/Settings/. Apague o que for de mods que você não usa (ex.: helicópteros RFFS).
Planos VIP: revise PainelVip/Vips/ e confira se o Type dos produtos em StorePanelVIP.json bate com os VipID.
Moeda física: se quiser que a moeda FHShopCoin caia no loot ou seja vendida em trader, adicione no types.xml/trader — o mod não faz isso sozinho.
Reinicie e teste com seu SteamID em Admins.

Regras para editar JSON

Pare o servidor antes (os arquivos de dados ao vivo são sobrescritos pelo servidor).
Use VS Code ou Notepad++ e salve em UTF-8.
Sem vírgula depois do último item de uma lista ou objeto.
Valide em jsonlint.com se o servidor recriar o arquivo "de fábrica" — sinal de que o JSON quebrou.
Guarde cópia da pasta Settings e Vips: um arquivo apagado volta com os padrões de fábrica.