Visão Geral do TraderPlus

O TraderPlus é um mod avançado para DayZ que adiciona um sistema completo de comércio com NPCs traders, permitindo aos jogadores comprar e vender itens usando um sistema de moedas personalizado.

Principais Recursos

Traders NPCs: Personagens não-jogáveis que compram e vendem itens
Sistema de Moedas: Múltiplas moedas personalizáveis
Categorias: Organização de produtos por categorias
Estacionamento de Veículos: Sistema para compra e venda de veículos
Sistema Bancário: Armazenamento seguro de dinheiro
Seguro: Proteção de itens contra perda

Esta wiki cobre a versão V1 do TraderPlus, versão estável.

Processo de Instalação

Importante: Sempre faça backup do seu servidor antes de instalar novos mods!

Pré-requisitos

DayZ Server

Versão 1.19 ou superior

CF Framework

Dependência obrigatória

Community Online Tools

Para funcionalidades avançadas

Instalação Passo a Passo

1

Download dos Mods

Baixe os seguintes mods da Steam Workshop:

CF Framework

Dependência principal do TraderPlus

Steam Workshop (ID: 1559212036)

Community Online Tools

Ferramentas para funcionalidades avançadas

Steam Workshop (ID: 1564026768)

TraderPlus

Mod principal do sistema de comércio

Steam Workshop (ID: 2458896948)

2

Configuração do Servidor

Adicione os mods ao arquivo de inicialização do servidor:

-mod=@CF;@Community-Online-Tools;@TraderPlus

A ordem dos mods é importante! CF deve vir primeiro.

3

Configuração de Arquivos

Copie os arquivos de configuração para a pasta do servidor:

profiles/
├── TraderPlus/
│   ├── TraderPlusConfig/
│   │   ├── TraderPlusGeneralConfig.json
│   │   ├── TraderPlusIDsConfig.json
│   │   ├── TraderPlusPriceConfig.json
│   │   ├── TraderPlusBankingConfig.json
│   │   ├── TraderPlusGarageConfig.json
│   │   ├── TraderPlusInsuranceConfig.json
│   │   ├── TraderPlusVehiclesConfig.json
│   │   ├── TraderPlusSafeZoneConfig.json
│   │   └── TraderPlusLoggingSettings.json
│   ├── TraderPlusDatabase/
│   │   └── ID_0/ ID_1/ ID_2/ ... (pastas por trader)
│   ├── TraderPlusBankDatabase/
│   ├── TraderPlusGarageDatabase/
│   └── TraderPlusLogs/

4

Configuração Inicial

Edite o arquivo TraderPlusGeneralConfig.json:

{
    "Version": "V1",
    "ConvertTraderConfigToTraderPlus": 0,
    "UseGarageToTradeCar": 0,
    "HideInsuranceBtn": 1,
    "HideGarageBtn": 0,
    "HideLicenceBtn": 0,
    "EnableShowAllPrices": 0,
    "IsReceiptTraderOnly": 1,
    "LicenceKeyWord": "Licence",
    "Licences": [],
    "AcceptedStates": {
        "AcceptWorn": 1,
        "AcceptDamaged": 1,
        "AcceptBadlyDamaged": 1,
        "CoefficientWorn": 0.75,
        "CoefficientDamaged": 0.5,
        "CoefficientBadlyDamaged": 0.25
    },
    "Currencies": [],
    "Traders": []
}

Configure as opções básicas: botões de interface, estados aceitos e coeficientes de preço por condição.

5

Configurar IDs dos Traders

Edite o arquivo TraderPlusIDsConfig.json para definir categorias por trader:

{
    "Version": "V1",
    "IDs": [
        {
            "Id": 0,
            "Categories": [
                "Suprimentos Médicos"
            ],
            "LicencesRequired": [],
            "CurrenciesAccepted": [
                "DBR_Money_Real_Limpo1",
                "DBR_Money_Real_Limpo2",
                "DBR_Money_Real_Limpo5",
                "DBR_Money_Real_Limpo10",
                "DBR_Money_Real_Limpo20",
                "DBR_Money_Real_Limpo50",
                "DBR_Money_Real_Limpo100",
                "DBR_Money_Real_Limpo200",
                "DBR_Money_Real_Limpo10000"
            ]
        },
        {
            "Id": 1,
            "Categories": [
                "Kit de Costura",
                "NVG",
                "Óculos e Luvas",
                "Toucas e Capacetes",
                "Mascaras",
                "Coletes e Cintos",
                "Jaquetas e Casacos",
                "Calças",
                "Sapatos",
                "Mochilas"
            ],
            "LicencesRequired": [],
            "CurrenciesAccepted": [
                "DBR_Money_Real_Limpo1",
                "DBR_Money_Real_Limpo2",
                "DBR_Money_Real_Limpo5",
                "DBR_Money_Real_Limpo10",
                "DBR_Money_Real_Limpo20",
                "DBR_Money_Real_Limpo50",
                "DBR_Money_Real_Limpo100",
                "DBR_Money_Real_Limpo200",
                "DBR_Money_Real_Limpo10000"
            ]
        }
    ]
}

6

Adicionar Primeiro Trader

No arquivo TraderPlusGeneralConfig.json, adicione ao array "Traders":

{
    "Id": 0,
    "Name": "SurvivorM_Jose",
    "GivenName": "Comerciante",
    "Role": "Trader Geral",
    "Position": [7500.0, 0.0, 7500.0],
    "Orientation": [0.0, 0.0, 0.0],
    "Clothes": []
}

7

Teste e Verificação

Inicie o servidor e verifique:

✅ Servidor inicia sem erros
✅ Logs do TraderPlus aparecem no console
✅ Pastas TraderPlusDatabase são criadas automaticamente
✅ Trader aparece na posição configurada
✅ Interface de comércio funciona

O TraderPlus criará automaticamente as pastas de database (ID_0, ID_1, etc.) baseado nos IDs configurados.

Solução de Problemas Comuns

❌ Servidor não inicia

Solução: Verifique se todos os mods estão instalados e na ordem correta.

❌ Trader não aparece

Solução: Verifique as coordenadas e se o arquivo JSON está válido.

❌ Erro de JSON inválido

Solução: Use um validador JSON online para verificar a sintaxe.

Parabéns! Seu TraderPlus está instalado e funcionando. Agora você pode adicionar mais traders, categorias e produtos.

Configuração de Traders

Os traders são NPCs que permitem aos jogadores comprar e vender itens. Cada trader pode ter múltiplas categorias de produtos.

Estrutura do Trader

{
    "npcId": 0,
    "className": "SurvivorM_Jose",
    "givenName": "João",
    "role": "Comerciante de Armas",
    "position": [7500, 0, 7500],
    "orientation": [0, 0, 0],
    "categoriesId": ["cat_weapons_001"],
    "currenciesAccepted": [],
    "loadouts": []
}

Parâmetros

Parâmetro	Tipo	Descrição
npcId	number	ID único do trader
className	string	Classe do NPC (ex: SurvivorM_Jose)
givenName	string	Nome exibido do trader
position	array	Coordenadas [X, Y, Z]

Categorias de Produtos

As categorias organizam os produtos em grupos lógicos, facilitando a navegação para os jogadores.

Estrutura da Categoria

{
    "isVisible": 1,
    "icon": "",
    "categoryName": "Armas",
    "licensesRequired": [],
    "productIds": [
        "prod_ak74_001",
        "prod_m4a1_001"
    ]
}

Use nomes descritivos para as categorias para facilitar a navegação dos jogadores.

Configuração de Produtos

Os produtos são os itens individuais que os traders podem comprar e vender.

Estrutura do Produto

{
    "className": "AK74",
    "coefficient": 1,
    "maxStock": 10,
    "tradeQuantity": 1,
    "buyPrice": 800,
    "sellPrice": 1000,
    "stockSettings": 0,
    "attachments": [],
    "variants": []
}

Preços e Estoque

O sistema de preços permite definir valores diferentes para compra e venda:

buyPrice: Preço que o trader paga pelo item
sellPrice: Preço que o trader cobra pelo item
maxStock: Quantidade máxima em estoque

Sistema de Moedas

O TraderPlus suporta múltiplas moedas personalizadas para transações.

Configuração de Moedas

{
    "version": "2.5",
    "currencyTypes": [
        {
            "currencyName": "USD",
            "currencies": [
                {
                    "className": "TraderPlus_Money_Dollar100",
                    "value": 100
                },
                {
                    "className": "TraderPlus_Money_Dollar1",
                    "value": 1
                }
            ]
        }
    ]
}

Moedas Padrão

O mod inclui as seguintes moedas por padrão:

Dólar Americano (USD)
Euro (EUR)
Rublo Russo (RUB)

Sistema de Estacionamento

O sistema de estacionamento permite aos jogadores comprar, vender e armazenar veículos com segurança.

Configuração

{
    "parkingId": 1,
    "position": [7500, 0, 7500],
    "orientation": [0, 0, 0],
    "size": [10, 10],
    "maxVehicles": 5,
    "parkingFee": 100
}

Como Usar

1. Aproxime-se da área de estacionamento
2. Interaja com o painel de controle
3. Selecione a opção desejada (estacionar/retirar)

Sistema Bancário

O sistema bancário permite aos jogadores armazenar dinheiro com segurança.

Recursos

Depósito e saque de dinheiro
Transferências entre jogadores
Histórico de transações
Taxas configuráveis

O dinheiro no banco está protegido contra perda por morte.

Exemplos de Configuração

Trader Básico de Armas

{
    "npcId": 1,
    "className": "SurvivorM_Jose",
    "givenName": "Armeiro Silva",
    "role": "Comerciante de Armas",
    "position": [7500, 0, 7500],
    "orientation": [0, 0, 0],
    "categoriesId": ["cat_weapons_001", "cat_ammo_001"]
}

Categoria de Comida

{
    "isVisible": 1,
    "categoryName": "Alimentos",
    "productIds": [
        "prod_apple_001",
        "prod_beans_001",
        "prod_water_001"
    ]
}

TraderPlusGeneralConfig.json

Este arquivo contém as configurações principais do TraderPlus, incluindo traders, moedas e opções de interface.

Estrutura Principal

{
    "Version": "V1",
    "ConvertTraderConfigToTraderPlus": 0,
    "UseGarageToTradeCar": 0,
    "HideInsuranceBtn": 1,
    "HideGarageBtn": 0,
    "HideLicenceBtn": 0,
    "EnableShowAllPrices": 0,
    "IsReceiptTraderOnly": 1,
    "AcceptedStates": {...},
    "Currencies": [...],
    "Traders": [...]
}

Opções de Interface

Parâmetro	Tipo	Descrição
HideInsuranceBtn	number	Ocultar botão de seguro (0=mostrar, 1=ocultar)
HideGarageBtn	number	Ocultar botão de garagem (0=mostrar, 1=ocultar)
EnableShowAllPrices	number	Mostrar todos os preços (0=não, 1=sim)

Estados Aceitos

Configure quais condições de itens o trader aceita:

"AcceptedStates": {
    "AcceptWorn": 1,
    "AcceptDamaged": 1,
    "AcceptBadlyDamaged": 1,
    "CoefficientWorn": 0.75,
    "CoefficientDamaged": 0.5,
    "CoefficientBadlyDamaged": 0.25
}

Perguntas Frequentes

Como adicionar um novo trader?

1. Adicione o trader no TraderPlusGeneralConfig.json
2. Configure as categorias no TraderPlusIDsConfig.json
3. Adicione produtos no TraderPlusPriceConfig.json

Por que meu trader não aparece no jogo?

Verifique se:

As coordenadas estão corretas
O ID do trader existe no TraderPlusIDsConfig.json
O arquivo JSON está válido
O servidor foi reiniciado após as alterações

Como funciona o sistema de categorias?

Cada trader tem um ID que corresponde a uma entrada no TraderPlusIDsConfig.json. Essa entrada define quais categorias o trader vende e quais moedas aceita.

Como definir preços dos produtos?

Os preços são definidos no arquivo TraderPlusPriceConfig.json, organizados por categorias.

Não encontrou sua pergunta? Consulte a documentação oficial ou entre em contato com a comunidade.

TraderPlus Wiki