📪Inventory

Documentação da Classe Inventory

A classe Inventory permite manipular itens no inventário de um jogador.

Esta documentação apresenta as funções de forma clara, intuitiva e com exemplos práticos e concisos para facilitar o uso.

Como Usar a Classe Inventory

Inicialização: Crie um objeto Inventory passando o índice do jogador (aIndex).
```
local playerInventory = Inventory.new(aIndex)
```
Uso de Funções: Use o operador : para chamar as funções, passando o slot do item (posição no inventário) como argumento.
Observação:
- Você pode usar a classe para um ou mais jogadores (ex.: playerInventory para um jogador, playerTargetInventory para outro).
- É possível usar dentro de loops, como em um for.
- Exemplo com múltiplos índices:
  local playerInventory = Inventory.new(aIndex) local playerTargetInventory = Inventory.new(TargetIndex) playerInventory:isItem(1) playerTargetInventory:isItem(1)

Funções da Classe Inventory

Abaixo estão todas as funções disponíveis, explicadas de forma simples com exemplos práticos:

1. `getIndex(slot)`

Descrição: Retorna o índice do item no slot. Retorna -1 se o slot estiver vazio.

Exemplo:

local itemIndex = playerInventory:getIndex(1)
if itemIndex == -1 then
    LogAdd(string.format("[Inventory] - Slot %d está vazio!", 1), 0)
else
    LogAdd(string.format("[Inventory] - Item no slot %d tem índice: %d", 1, itemIndex), 0)
end

2. `isItem(slot)`

Descrição: Retorna 1 se o slot contém um item, ou 0 se estiver vazio.

Exemplo:

if playerInventory:isItem(2) == 1 then
    LogAdd(string.format("[Inventory] - Slot %d contém um item!", 2), 0)
else
    LogAdd(string.format("[Inventory] - Slot %d está vazio!", 2), 0)
end

3. `isExc(slot)`

Descrição: Retorna 1 se o item no slot é excelente, ou 0 caso contrário.

Exemplo:

if playerInventory:isExc(3) == 1 then
    LogAdd(string.format("[Inventory] - Item no slot %d é excelente!", 3), 0)
end

4. `getLevel(slot)`

Descrição: Retorna o nível do item no slot.

Exemplo:

local level = playerInventory:getLevel(1)
LogAdd(string.format("[Inventory] - Nível do item no slot %d: %d", 1, level), 0)

5. `getName(slot)`

Descrição: Retorna o nome do item no slot.

Exemplo:

local itemName = playerInventory:getName(1)
LogAdd(string.format("[Inventory] - Nome do item no slot %d: %s", 1, itemName), 0)

6. `getSection(slot)`

Descrição: Retorna a seção/categoria do item no slot.

Exemplo:

local section = playerInventory:getSection(1)
LogAdd(string.format("[Inventory] - Seção do item no slot %d: %d", 1, section), 0)

7. `getIndex2(slot)`

Descrição: Retorna o índice alternativo do item no slot.

Exemplo:

local index2 = playerInventory:getIndex2(1)
LogAdd(string.format("[Inventory] - Índice alternativo do item no slot %d: %d", 1, index2), 0)

8. `getSerial(slot)`

Descrição: Retorna o serial único do item no slot.

Exemplo:

local serial = playerInventory:getSerial(1)
LogAdd(string.format("[Inventory] - Serial do item no slot %d: %s", 1, serial), 0)

9. `getDurability(slot)`

Descrição: Retorna a durabilidade atual do item no slot (máximo: 255).

Exemplo:

local durability = playerInventory:getDurability(1)
LogAdd(string.format("[Inventory] - Durabilidade do item no slot %d: %d", 1, durability), 0)

10. `setDurability(slot, value)`

Descrição: Define a durabilidade do item no slot (máximo: 255).

Exemplo:

playerInventory:setDurability(1, 200)
LogAdd(string.format("[Inventory] - Durabilidade do item no slot %d definida para %d!", 1, 200), 0)

11. `convertItem(slot)`

Descrição: Atualiza o item no slot após modificações (ex.: mudar opções excelentes).

Exemplo:

playerInventory:setItemTable(1, 1, 1) -- Define item como excelente
playerInventory:convertItem(1) -- Atualiza o item
LogAdd(string.format("[Inventory] - Item no slot %d atualizado!", 1), 0)

12. `getIsPeriodic(slot)`

Descrição: Retorna 1 se o item no slot é periódico, ou 0 caso contrário.

Exemplo:

if playerInventory:getIsPeriodic(1) == 1 then
    LogAdd(string.format("[Inventory] - Item no slot %d é periódico!", 1), 0)
end

13. `getPeriodicTime(slot)`

Descrição: Retorna o tempo restante de um item periódico no slot.

Exemplo:

local time = playerInventory:getPeriodicTime(1)
LogAdd(string.format("[Inventory] - Tempo restante do item periódico no slot %d: %d", 1, time), 0)

14. `getItemTable(slot, type)`

Descrição: Retorna o valor de uma opção específica do item no slot.
Tipos de ItemTable:
- type: 1 -> valor exc (excelente)
- type: 2 -> valor option1
- type: 3 -> valor option2
- type: 4 -> valor option3
- type: 5 -> valor ancient
- type: 6 -> valor JoH (Jewel of Harmony)
- type: 7 -> valor Ex option
- type: 8 -> opção de bônus do socket
- type: 9 -> opção do socket 1
- type: 10 -> opção do socket 2
- type: 11 -> opção do socket 3
- type: 12 -> opção do socket 4
- type: 13 -> opção do socket 5

Exemplo:

local excValue = playerInventory:getItemTable(1, 1)
LogAdd(string.format("[Inventory] - Valor excelente do item no slot %d: %d", 1, excValue), 0)

15. `setItemTable(slot, type, value)`

Descrição: Define o valor de uma opção específica do item no slot.
Tipos de ItemTable:
- type: 1 -> valor exc (excelente)
- type: 2 -> valor option1
- type: 3 -> valor option2
- type: 4 -> valor option3
- type: 5 -> valor ancient
- type: 6 -> valor JoH (Jewel of Harmony)
- type: 7 -> valor Ex option
- type: 8 -> opção de bônus do socket
- type: 9 -> opção do socket 1
- type: 10 -> opção do socket 2
- type: 11 -> opção do socket 3
- type: 12 -> opção do socket 4
- type: 13 -> opção do socket 5

Exemplo:

playerInventory:setItemTable(1, 1, 1) -- Define como excelente
LogAdd(string.format("[Inventory] - Item no slot %d agora é excelente!", 1), 0)

Exemplo Prático Completo

Abaixo está um exemplo fictício que utiliza várias funções da classe Inventory em uma única função para verificar e modificar um item no inventário do jogador. Este código pode ser usado como base para manipulações no inventário.

-- Sistema de gerenciamento de inventário
INVENTORY_MANAGER = {}

function INVENTORY_MANAGER.ProcessPlayerInventory(aIndex)
    -- Cria um objeto Inventory para o jogador
    local playerInventory = Inventory.new(aIndex)
    local player = User.new(aIndex)
    local playerName = player:getName()

    -- Verifica se há um item no slot 1
    if playerInventory:isItem(1) == 1 then
        -- Obtém informações do item
        local itemName = playerInventory:getName(1)
        local itemLevel = playerInventory:getLevel(1)
        local isExc = playerInventory:isExc(1)
        local durability = playerInventory:getDurability(1)
        local serial = playerInventory:getSerial(1)
        local section = playerInventory:getSection(1)
        local index2 = playerInventory:getIndex2(1)

        -- Exibe informações do item
        LogAdd(string.format("[Inventory] - [%s] Item no slot 1: %s, Nível: %d, Excelente: %d, Durabilidade: %d, Serial: %s, Seção: %d, Índice Alternativo: %d",
            playerName, itemName, itemLevel, isExc, durability, serial, section, index2), 0)

        -- Verifica se o item é periódico
        if playerInventory:getIsPeriodic(1) == 1 then
            local periodicTime = playerInventory:getPeriodicTime(1)
            LogAdd(string.format("[Inventory] - [%s] Item no slot 1 é periódico com %d segundos restantes!", playerName, periodicTime), 0)
        end

        -- Modifica o item: define durabilidade, torna excelente e adiciona uma opção de socket
        playerInventory:setDurability(1, 255)
        playerInventory:setItemTable(1, 1, 1) -- Define como excelente
        playerInventory:setItemTable(1, 9, 3) -- Define opção de socket 1
        playerInventory:convertItem(1) -- Atualiza o item

        LogAdd(string.format("[Inventory] - [%s] Item no slot 1 foi atualizado: durabilidade máxima, agora é excelente e com socket!", playerName), 0)
    else
        LogAdd(string.format("[Inventory] - [%s] Nenhum item encontrado no slot 1!", playerName), 0)
    end
end

-- Exemplo de chamada da função
INVENTORY_MANAGER.ProcessPlayerInventory(100) -- Substitua 100 pelo aIndex do jogador

return INVENTORY_MANAGER

Resumo

A classe Inventory facilita a manipulação de itens no inventário do jogador de forma prática e eficiente.
Use o operador : para chamar as funções, passando o slot do item como argumento.
As funções getItemTable e setItemTable permitem controle detalhado sobre opções como excelente, sockets e mais.
O exemplo prático mostra como verificar, exibir e modificar propriedades de um item em uma única função.

PreviousGameServerFunctions NextPacket Functions

Last updated 4 months ago

Documentação da Classe Inventory

Como Usar a Classe Inventory

Funções da Classe Inventory

1. getIndex(slot)

2. isItem(slot)

3. isExc(slot)

4. getLevel(slot)

5. getName(slot)

6. getSection(slot)

7. getIndex2(slot)

8. getSerial(slot)

9. getDurability(slot)

10. setDurability(slot, value)

11. convertItem(slot)

12. getIsPeriodic(slot)

13. getPeriodicTime(slot)

14. getItemTable(slot, type)

15. setItemTable(slot, type, value)

Exemplo Prático Completo

Resumo

1. `getIndex(slot)`

2. `isItem(slot)`

3. `isExc(slot)`

4. `getLevel(slot)`

5. `getName(slot)`

6. `getSection(slot)`

7. `getIndex2(slot)`

8. `getSerial(slot)`

9. `getDurability(slot)`

10. `setDurability(slot, value)`

11. `convertItem(slot)`

12. `getIsPeriodic(slot)`

13. `getPeriodicTime(slot)`

14. `getItemTable(slot, type)`

15. `setItemTable(slot, type, value)`