os_battlepass

Disponível em todos os frameworks!

Siga estes passos para realizar a configuração de nosso Passe de Batalha!

Configuração geral

config/Config.json

{
  "website": "onesourceteam.dev", // WebSite que será exibido. 
  "color": "92, 66, 230", // Coloração de todo o battlepass, siga o formato RGB
  "command": "passe", // Comando cujo deve ser adicionado para abrir o battlepass
  "admin": {
    "permissions": ["Admin"], // Adicione as permissões que são necessarias para executar comandos da administração
    "commands": {
      "set_premium": "setpremium",
      "set_level": "setlevel",
      "set_xp": "setxp"
    }
  },
  "max_level": 15, // O level máximo permitido no battlepass
  "close_on_collect": true, // Caso ele deva fechar o battlepass quando coletar algum item
  "xp_to_upgrade": [ // Neste item, dite o level maximo e minimo e quanto de XP será necessário para upar entre esses leveis
    { "min_level": 1, "max_level": 5, "necessary_xp": 500 },
    { "min_level": 6, "max_level": 10, "necessary_xp": 1000 }
  ],
  "xp_per_time": [10, 600], // Caso não queira que o jogador receba XP por tempo apenas coloque o valor como null, caso o contrario muda o primeiro valor para a quantidade de XP e o segundo para o tempo em segundos
  "language": { // Utilize estes itens para ditar a linguagem do battlepass
    "title": "Passe de Batalha",
    "description": "Ganhe recompensas de acordo com suas experiências",
    "statisticsTitle": "Suas estatísticas",
    "passCategory": "Categoria do passe",
    "gameTime": "Tempo de jogo",
    "timeFormat": "%sh %smin %ss",
    "complete": "completou",
    "pass": "Passe",
    "premiumPass": "o passe premium!",
    "remainingXp": "xp restante",
    "passTypes": ["Premium", "Grátis"],
    "collectAll": "Resgator todos",
    "you": "Você",
    "alreadyAcquired": "já adquiriu",
    "dontAcquired": ["ainda", "não adquiriu"],
    "extraMissions": "missões extras",
    "accessStore": ["Acessar", "Loja"],
    "buyPremium": ["Comprar", "Premium"]
  },
  "license_key": "" // Adicione a sua key do script
}

Configuração de recompensas

config/Config.json

{
  // RECOMPENSAS GRÁTIS EM ORDEM POR NÍVEL
  "free": [
    {
      "spawn": "radio", // Spawn do item que será dado ao jogador 
      "image": "nui://vrp/config/item-images/radio.png", // URL da imagem do item
      "quantity": 3, // Quantidade do item
      "type": "item" // Tipo do item que pode ser item, vehicle ou vip
    },
    {}, // Itens que estiverem vazios ficaram como slots vazios no battlepass 
    {
      "spawn": "bandagem",
      "image": "nui://vrp/config/item-images/bandage.png",
      "quantity": 10,
      "type": "item"
    },
    {
      "spawn": "ferramenta",
      "image": "nui://vrp/config/item-images/ferramenta.png",
      "quantity": 35,
      "type": "item"
    }
  ],
  // RECOMPENSAS PREMIUM EM ORDEM POR NÍVEL
  "premium": [
    {
      "spawn": "wbody|WEAPON_PISTOL_MK2",
      "image": "nui://vrp/config/item-images/fiveseven.png",
      "quantity": 3,
      "type": "item"
    },
    {
      "spawn": "lockpick",
      "image": "nui://vrp/config/item-images/lockpick.png",
      "quantity": 10,
      "type": "item"
    },
    {
      "spawn": "wbody|WEAPON_ASSAULTRIFLE_MK2",
      "image": "nui://vrp/config/item-images/ak103.png",
      "quantity": 2,
      "type": "item"
    },
    {
      "spawn": "dinheiro",
      "image": "nui://vrp/config/item-images/dinheirosujo.png",
      "quantity": 10,
      "type": "money"
    }
  ]
}

Configuração de missões

config/Missions.json

[
  {
    "id": "deliverydrugs", // ID da missão para passar no export
    "title": "Entregar Drogas", // Titulo da missão
    "description": "Entregue 200 drogas para completar a missão.", // Breve descrição da missão
    "progress": [0, 200], // Quantidade de pontos necessarios para completar, deixe sempre o primeiro valor como 0 e o segundo com o desejado
    "xp": 2000, // A quantidade de XP que a missão dará ao finaliza-la
    "active": true // Sempre deixe como true
  },
  {
    "id": "makeassault",
    "title": "Fazer assalto",
    "description": "Faça 10 assaltos para completar a missão.",
    "progress": [0, 10],
    "xp": 800,
    "active": true
  },
  {
    "id": "makeassault1",
    "title": "Fazer assalto",
    "description": "Faça 10 assaltos para completar a missão.",
    "progress": [0, 10],
    "xp": 800,
    "active": false
  },
  {
    "id": "makeassault2",
    "title": "Fazer assalto",
    "description": "Faça 10 assaltos para completar a missão.",
    "progress": [0, 10],
    "xp": 800,
    "active": false
  }
]

Configuração de recompensas VIP

config/Vips.json

{
  "vipgold": { // ID do VIP, que dee ser passado no spawn das Rewards
    "items": [ // Items que o VIP pode dar, deixe vazio caso não queira
      {
        "spawn": "c4",
        "amount": 10
      },
      {
        "spawn": "wbody|WEAPON_SPECIALCARBINE_MK2",
        "amount": 5
      },
      {
        "spawn": "wammo|WEAPON_SPECIALCARBINE_MK2",
        "amount": 1000
      }
    ],
    "vehicles": ["adder"], // Veículos que o VIP pode dar, deixe vazio caso não queira
    "groups": ["ultra"] // Grupos que o VIP pode dar, deixe vazio caso não queira
  }
}

Exports

Todos os exports devem ser feitos via Server-Side

-- Setar XP diretamente no jogador passando seu ID e quantidade de XP
exports['os_battlepass']:SetXp(userId, quantity)

-- Setar level diretamente no jogador passando seu ID e o level
exports['os_battlepass']:SetLevel(userId, quantity)

-- Setar o premium diretamente no jogador passando seu ID e 1 para battlepass premium e 0 para free
exports['os_battlepass']:SetPremium(userId, 1)

-- Utilize para contabilizar as missões no jogador, passe o ID do jogador, ID da missão e quantidade a ser contabilizada
exports['os_battlepass']:AddPlayerMission(userId, missionId, quantity)