Manual › FH VIRTUAL PAINEL › Planos VIP e itens exclusivos

Planos VIP e itens exclusivos

Como montar um plano: categorias, packs, itens fixos, herança e exclusividade — com o comportamento exato de cada campo.

Nesta páginaUm arquivo por plano Campos do plano Categorias (VipItens)Packs (VipInventario)Itens fixos (VipInventarioHidden)Itens exclusivos Tutorial: criar o plano VIPGold

Um arquivo por plano

Pasta PainelVip/Vips/. Todo .json da pasta vira um plano. De fábrica: VIPBasic.json, VIPMythical.json, VIPEpic.json (eles só são recriados se a pasta ficar sem nenhum JSON).

Cuidado ao renomear ou quebrar um plano: se um VipID que tem assinantes no db_vips.json sumir (arquivo apagado, JSON inválido ou ID trocado), o servidor remove esses assinantes do banco no start (guarda uma cópia em db_vips.json.N.backup). Valide o JSON antes de subir.

Campos do plano

Campo	O que faz
`VipID`	Identificador (vira minúsculas). É o `Type` da loja e a chave do `db_vips.json`. Único.
`VipNome`	Nome exibido (retorno da compra, webhook).
`VipHerdarID`	Herda as categorias (`VipItens`) de outro plano. Packs, itens fixos e exclusivos não são herdados. Vazio = não herda. O plano herdado tem que existir.
`VipPeso`	Desempate quando o jogador tem 2+ planos: só o de menor peso entrega os itens fixos (`VipInventarioHidden`). Fábrica: Basic 12, Mythical 11, Epic 10.
`VipItensExclusivesType`	0 = sem exclusivos. 1 (ou 2) = os classnames de `VipItensExclusivesHidden` ficam exclusivos deste plano.
`VipItens`	As categorias para o jogador escolher (abaixo).
`VipInventario`	Packs — o jogador escolhe um.
`VipInventarioHidden`	Itens sempre entregues, sem escolha.
`VipItensExclusivesHidden`	Classnames que só quem tem este plano pode carregar.

Jogador com vários planos ativos vê as opções de todos somadas (sem repetição).

Categorias (VipItens)

Só estas 13 chaves aparecem no painel — escreva exatamente assim:

ArmaPrimaria · ArmaSecundaria · ArmaBonus · Capacete · Olhos · Rosto · Blusas · Coletes · Luvas · Cinto · Calcas · Botas · Mochilas

"ArmaPrimaria": [
  {
    "Item": "SKS",
    "Attach": ["ImprovisedSuppressor", "HuntingOptic", "Ammo_762x39Tracer"],
    "ExtraNoInventario": ["AmmoBox_762x39Tracer_20Rnd", "AmmoBox_762x39Tracer_20Rnd"]
  }
]

Campo	O que faz
`Item`	Classname da opção.
`Attach`	Acoplados. Com `ArmasPreCarregadasDoAttach`, o primeiro pente/munição é carregado na arma. Bateria de mira pode ir aqui (o servidor encaixa dentro da mira). O que não encaixar vai para o inventário.
`ExtraNoInventario`	Itens soltos no inventário. Sem espaço, são perdidos — dê mochila/roupas com espaço.

Não existe campo de quantidade: para 2 caixas de munição, repita o classname.

Packs (VipInventario)

"VipInventario": [
  { "NomePack": "Pack de Medicina", "Itens": [ { "Item": "BandageDressing", "Attach": [] }, { "Item": "Morphine", "Attach": [] } ] }
]

O jogador escolhe um pack pelo NomePack. Renomear um pack invalida o preset salvo dos jogadores para ele.
Mantenha packs com até 7 itens (a prévia do card mostra até esse número).

Itens fixos (VipInventarioHidden)

"VipInventarioHidden": [ { "Item": "TunaCan", "Attach": [] }, { "Item": "WaterBottle", "Attach": [] } ]

Sempre entregues. Se o jogador tiver mais de um plano, valem só os do plano de menor VipPeso.

Itens exclusivos

Por plano

Com VipItensExclusivesType: 1, os classnames de VipItensExclusivesHidden só podem ser carregados por quem tem aquele plano. Quem não pode:

não consegue pegar/equipar o item;
se já estiver com ele, o item é largado no chão no próximo login ou respawn.

Globais: Exclusive_Itens.json

{
  "AtivarExclusiveItens": 1,
  "IncludeInTodosVips": ["Ammo_408trundra", "M_Asiimov_Supressor_01", "AmmoBox_408Tundra_15Rnd"],
  "ExcludeInTodosVips": ["AKM", "BaseballBat"]
}

Campo	O que faz
`AtivarExclusiveItens`	0 = ignora as duas listas abaixo. A exclusividade definida nos planos continua valendo.
`IncludeInTodosVips`	Exclusivos de qualquer VIP (qualquer plano).
`ExcludeInTodosVips`	Liberados para todos, mesmo que algum plano marque como exclusivo.

Isso não coloca itens no painel — só controla quem pode carregar.

Tutorial: criar o plano VIPGold

Pare o servidor. Copie VIPBasic.json para VIPGold.json.

Mude o topo:

"VipID": "VIPGold",
"VipNome": "VIP Gold",
"VipHerdarID": "VIPBasic",
"VipPeso": 5,
"VipItensExclusivesType": 1,

Em VipItens, deixe só as opções extras do Gold (as categorias do Basic vêm pela herança).
Defina os packs e itens fixos do próprio Gold (eles não são herdados).
Em VipItensExclusivesHidden, liste o que só o Gold pode carregar.
Na loja (StorePanelVIP.json), crie o produto com "Type": "VIPGold".
Valide os dois JSON, suba e compre com seu ID em Admins para testar.