Kit Boas Vindas Plus - zerodawnbr/zerodawntoolbox GitHub Wiki
🎁 Kit de Boas-Vindas Plus
O Kit de Boas-Vindas Plus é uma versão aprimorada do kit já existente. Ele não funciona em conjunto com o kit padrão, mas sim como uma alternativa com recursos adicionais.
Assim como o kit original, ele concede itens iniciais ao jogador na sua primeira entrada no servidor, ajudando a tornar o começo da jornada mais fácil e divertido. A diferença é que esta versão traz novas funcionalidades: você pode enviar kits para todos os jogadores de uma vez ou definir grupos específicos que receberão determinados kits.
⚠️ Requer os mods @CF e @Notications para funcionar corretamente.
O Kit de Boas-Vindas e o Kit de Boas-Vindas Plus possuem objetivos semelhantes, mas cada um tem características próprias.
🎞️ Demonstração
📂 Arquivo de configuração
Ao iniciar o servidor pela primeira vez, é criado automaticamente o arquivo de configuração.
Se estiver com o mod ToolBox
$profile:/ZeroDawnBRCoreTools/WelcomeKit/Config.json
Se estiver apenas com o mod KitBoasVindas
$profile:/ZeroDawnBRKitPlus/Config.json
⚙️ Funcionalidades
-
Itens configuráveis
Qualquer item listado notypes.xmlpode ser adicionado ao kit. -
Local de spawn
Escolha se os itens aparecem direto no inventário do jogador ou fora dele, dentro de um contêiner (ex.: caixa). -
Itens aleatórios
Defina uma porcentagem de chance para spawnar itens aleatórios. -
Criação de vários kits
Permite criar vários kits que poderão ser entregues aos jogadores. Porém apenas 1 kit será entregue, evitando o jogador receber o mesmo kit várias vezes. -
Kit específicos
Usando o steamID do jogador, você pode definir kits especificos para eles. -
Veículos
Permite spawnar veículos completos e com itens anexados a ele. -
Atualização do kit online
Pode atualizar o arquivo de configuração online. -
Receber kit via chat ou ao conectar
É possível receber os kit via chat ou ao se conectar. Com o atributoenableEarlyDelivery = 1, o jogador receberá o kit ao se conectar, se estiver 0, deverá solicitar via chat Com o atributospawnDelay, você define o tempo em segundo para o jogador receber o kit, isso é importante quando fizer entrega de veiculos. Ele funciona em conjunto comenableEarlyDelivery = 1
💡 Importante
Para alguns servidores, o uso da barra (\) no atributo kits para definir as palavras chaves não funciona, você pode usar outro caractere como ! ou -, ou até mesmo deixar apenas a palavra. Mas cuidado com a palavra que usar para não atrapalhar as mensagens do chat.
Arquivo json
{
"versao": "1.0.3",
"info": "The Welcome Kit is a feature that delivers starter items to the player when they first join the server.",
"m_reloadCommands": [
"\\kitreload",
"!kitreload"
],
"kits": {
"\\kit": {
"container": "FurImprovisedBag",
"spawnInventory": 1,
"message1": "Você recebeu o seu kit boas vindas! Abra e aproveite.",
"message2": "Você já recebeu o seu pacote desta temporada.",
"NotificationInChat": 1,
"Notification": 1,
"isVehicle": 0,
"enableEarlyDelivery": 1,
"spawnDelay": 1,
"steamIDs": [],
"items": [
{
"classType": "BBP_Blueprint",
"quantityMax": 1,
"health": 1.0,
"chance": 0.45,
"attachments": []
},
{
"classType": "Whetstone",
"quantityMax": 2,
"health": 1.0,
"chance": 0.45,
"attachments": []
},
{
"classType": "BoneKnife",
"quantityMax": 1,
"health": 1.0,
"chance": 0.45,
"attachments": []
},
{
"classType": "Apple",
"quantityMax": 2,
"health": 1.0,
"chance": 0.45,
"attachments": []
},
{
"classType": "Hacksaw",
"quantityMax": 1,
"health": 1.0,
"chance": 0.45,
"attachments": []
},
{
"classType": "Rope",
"quantityMax": 1,
"health": 1.0,
"chance": 0.45,
"attachments": []
},
{
"classType": "Ammo_45ACP",
"quantityMax": 1,
"health": 1.0,
"chance": 0.45,
"attachments": []
},
{
"classType": "Ammo_357",
"quantityMax": 1,
"health": 1.0,
"chance": 0.45,
"attachments": []
},
{
"classType": "Ammo_9x19",
"quantityMax": 1,
"health": 1.0,
"chance": 0.45,
"attachments": []
},
{
"classType": "ImprovisedSuppressor",
"quantityMax": 1,
"health": 1.0,
"chance": 0.45,
"attachments": []
},
{
"classType": "BandageDressing",
"quantityMax": 2,
"health": 1.0,
"chance": 0.45,
"attachments": []
},
{
"classType": "CodeLock",
"quantityMax": 1,
"health": 1.0,
"chance": 0.45,
"attachments": []
}
]
},
"\\kitveiculo": {
"container": "OffroadHatchback",
"spawnInventory": 0,
"message1": "Você recebeu o seu VEICULO COMPLETO!",
"message2": "Você já recebeu o seu veículo desta temporada.",
"NotificationInChat": 1,
"Notification": 1,
"isVehicle": 1,
"enableEarlyDelivery": 0,
"spawnDelay": 0,
"steamIDs": ["0000000000"],
"items": [
{
"classType": "SparkPlug",
"quantityMax": 1,
"health": 1.0,
"chance": 1.0,
"attachments": []
},
{
"classType": "CarBattery",
"quantityMax": 1,
"health": 1.0,
"chance": 1.0,
"attachments": []
},
{
"classType": "CarRadiator",
"quantityMax": 1,
"health": 1.0,
"chance": 1.0,
"attachments": []
},
{
"classType": "HeadlightH7",
"quantityMax": 2,
"health": 1.0,
"chance": 1.0,
"attachments": []
},
{
"classType": "HatchbackDoors_Driver",
"quantityMax": 1,
"health": 1.0,
"chance": 1.0,
"attachments": []
},
{
"classType": "HatchbackDoors_CoDriver",
"quantityMax": 1,
"health": 1.0,
"chance": 1.0,
"attachments": []
},
{
"classType": "HatchbackHood",
"quantityMax": 1,
"health": 1.0,
"chance": 1.0,
"attachments": []
},
{
"classType": "HatchbackTrunk",
"quantityMax": 1,
"health": 1.0,
"chance": 1.0,
"attachments": []
},
{
"classType": "HatchbackWheel",
"quantityMax": 4,
"health": 1.0,
"chance": 1.0,
"attachments": []
},
{
"classType": "CanisterGasoline",
"quantityMax": 1,
"health": 1.0,
"chance": 1.0,
"attachments": []
}
]
}
}
}
💡 Resumindo
- Ajuda novos jogadores a começarem equipados.
- Entrega kits básicos para todos.
- Permite distribuir varios kits para o mesmo jogador.
- Permite entregar veículos completos (validado com veículos Vanilla, com tanque e radiador cheios)
- Distribui apenas um vez o kit, evitando assim que o jogador receba o mesmo kit várias vezes.
- 100% configurável pelo
Config.json.
📂 Explicação dos campos – WelcomeKit
Seção principal (config.json)
| Atributo | Descrição | Valor Padrão / Exemplo |
|---|---|---|
version |
Versão do sistema de Welcome Kit. | "1.0.1" |
info |
Texto informativo/descritivo do sistema. | "This file defines which items the player will receive..." |
m_reloadCommands |
Comando que será chamado para atualização online | !kitreload |
Estrutura dos kits
| Atributo | Descrição | Exemplo |
|---|---|---|
nome do kit |
Você pode definir um nome qualquer para o kit. | \kitarmas \kitsaude etc... |
spawnInventory |
Permite spawnar o container no chão ou no jogador. Fique atento com o tamanho do container, pois não pode caber no slot do jogador | 0 = no chão 1 = no jogador |
container |
Define o contêiner usado para entregar os itens. Pode ser caixa, barril, baú, etc. | "WoodenCrate" |
message1 |
Mensagem informando ao jogador que ele recebeu o kit | Você recebeu o seu kit boas vindas! Abra e aproveite. |
message2 |
Mensagem informando ao jogador que ele ja recebeu o kit | Você já recebeu o seu pacote desta temporada. |
NotificationInChat |
Notifica o jogador pelo chat do jogo | 0 = não notifica 1 = sim notifica |
Notification |
Notifica o jogador em uma mensagem no topo da tela | 0 = não notifica 1 = sim notifica |
isVehicle |
Sinalizar se o container é um véiculo | 0 = não 1 = sim |
enableEarlyDelivery |
Se habilitado, o jogador recebe o kit segundos após entrar no servidor sem precisar digitar no chat | 0 = desabilitado 1 = habilitado |
spawnDelay |
tempo em segundos para spawnar o container quando enableEarlyDelivery estiver habilitado | 10000 = 10 segundos |
steamID |
Steam ID de jogadores que receberão, caso esteja em branco, liberado para todos. | [ ] |
items |
itens que serão entregues | [ ] |
Estrutura dos itens
| Atributo | Descrição | Exemplo |
|---|---|---|
classType |
Nome do item conforme registrado no types.xml. |
"Apple" |
quantityMax |
Quantidade do item a ser entregue. | 1 |
health |
Saúde do item a ser entregue. 1 = 100%, 0.7 = 70%, etc... | 1.0 |
chance |
Chance do item a ser entregue. 1 = 100%, 0.7 = 70%, etc... | 1.0 |
attachments |
Permite anexar itens ao item principal. | [ ] |
📜 Registro de Kits Entregues
Quando um jogador recebe o Kit de Boas-Vindas, o sistema cria automaticamente um arquivo chamado: welcomekit_players.json
Se estiver com o mod ToolBox
$profile:/ZeroDawnBRCoreTools/WelcomeKit/welcomekit_players.json
Se estiver apenas com o mod KitBoasVindas
$profile:/ZeroDawnBRKitPlus/welcomekit_players.json
Esse arquivo registra quem já recebeu o kit e os kits que foram entregues, garantindo que o jogador não possa receber novamente.
🗂️ Estrutura do welcomekit_players.json
{
"76561198000000001": {
"userName": "Survivor1",
"steamID": "76561198000000001",
"date": "2025-9-30 5:38:25",
"claimedKits": [
"\\kitsaude",
"\\kitcomida",
"\\kitarmas",
"\\kitbase",
"\\kitVeiculo"
]
},
"76561198000000002": {
"userName": "Survivor2",
"steamID": "76561198000000002",
"date": "2025-9-30 5:38:25",
"claimedKits": [
"\\kitsaude",
"\\kitcomida",
"\\kitarmas",
"\\kitbase"
]
}
}
📖 Explicação dos campos – welcomekit.json
| Atributo | Descrição | Exemplo |
|---|---|---|
userName |
Nome do jogador no momento em que recebeu o kit. | "player1" |
steamID |
Identificador único do jogador na Steam. Serve como chave do registro. | "76561198868988100" |
date |
Data e hora em que o kit foi entregue ao jogador. | "2025-8-24 16:21:40" |
claimedKits[] |
Lista de kits que foram entregues ao jogador. | \\kitsaude \\kitcomida |
💡 Atenção
- Dependendo da quantidade de itens a serem entregues, é preciso incluir um container maior, caso contrario não será entregue ao jogador
- Se incluir uma mochila no atributo container e definir spawnInventory como 1. A mochila será colocada nas costas do jogador (desde que não haja outra).
- Quando usar mochilas, as armas irão automaticamente para o slot de armas quando houver, se incluir mais uma arma e não tiver slot, será guardado dentro da mochila caso tenha espaço.
📜 Comandos para atualização online do arquivo de configuração
- Você poderá alterar o arquivo de configuração mesmo com o servidor online e não precisará reinicia-lo para que pegue as novas configurações.
- Pode criar novos kits ou alterar os ja existentes
Comandos: \kitreload ou !kitreload
Colocamos as 2 opções, pois em alguns mods que usam chat, pode impedir o uso da barra invertida (\).
📜 Registros de logs
💡 Personalização
- Caso precise, personalizamos o MOD conforme a sua necessidade.
🎮 Oficina na Steam
📂 Atualizações
- 10/10/2025 - Incluído a opção de criar um kit de veículos (testado apenas com veículos Vanilla)
- 15/10/2025 - Incluído comando de atualização online dos arquivos de configuração
- 17/10/2025 - Para evitar a incompatibilidade com alguns mods, fizemos a tratativa de uso do caracter ! antes da palavra-chave.