Um item é uma lista de funcionalidades, executadas de cima para baixo quando o jogador o utiliza, e um conjunto de restrições verificadas antes que qualquer uma delas seja executada.
- O jogador usa o item pelo inventário.
- No servidor, as restrições de cooldown, item necessário e emprego são verificadas. Se alguma falhar, o jogador recebe o motivo e nada acontece.
- As funcionalidades do lado do servidor são executadas (Bundle).
- As funcionalidades do lado do cliente são executadas na ordem em que você as listou. Cada uma pode ter um atraso (delay) em milissegundos, aguardado antes de iniciar — é assim que você cria uma sequência: animação, depois de 3 segundos uma notificação, depois um prop.
- Se Remove on Use estiver ativado, aquela quantidade do item é removida.
Funcionalidades que têm duração — animações, cenários, estilos de caminhada, velocidade, superpoderes, props anexados — podem ser interrompidas pelo jogador com a tecla de cancelar (X por padrão).
| Funcionalidade | O que faz |
|---|
| Animation | Reproduz uma animação de um dicionário. Loop executa até ser cancelada; caso contrário, repete pela duração que você definir. Movable mantém as pernas livres (apenas parte superior do corpo); static usa o corpo inteiro. Não é reproduzida dentro de veículos |
| Scenario | Inicia um cenário do GTA no local, por uma determinada duração |
| Walking Style | Muda a forma como o jogador caminha, por uma duração (15 segundos se você deixar em branco) |
| Speed | Aumenta (ou diminui) a velocidade de movimento do jogador por um multiplicador, por uma duração ou até ser cancelada |
| Superpower | Qualquer um entre Teleport (para a marcação no mapa), Invisibility, Invincibility, Superjump e Stamina (corrida infinita), cada um com sua própria duração |
| Clothes | Veste peças de roupa e props, definidos separadamente para os modelos freemode masculino e feminino, com uma animação correspondente de data/clothing.lua |
| Funcionalidade | O que faz |
|---|
| Attach Prop | Coloca um objeto em um osso do jogador, posicionado no editor ao vivo. Todos ao redor o veem. Loop mantém até ser cancelado; caso contrário, é removido após a duração. Não é usado dentro de veículos |
| Placeable Prop | O jogador coloca um objeto no mundo: uma prévia segue para onde ele olha, a roda do mouse gira, ↑ / ↓ sobem e descem, E posiciona e X cancela. O objeto posicionado pode ser recolhido de volta — veja abaixo |
| Particles | Um efeito de partícula no jogador, a partir de um asset e nome de efeito, com escala e duração |
| Visual Effect | Um efeito em tela cheia por uma determinada duração |
| Sound | Um som do GTA, a partir de um nome e conjunto de sons, em um volume específico |
| Funcionalidade | O que faz |
|---|
| Health/Armor | Adiciona vida e colete, limitados ao máximo |
| Food/Thirst | Adiciona fome e sede, através do esx_status no ESX ou dos eventos consumables no QBCore |
| Stress | Adiciona estresse, ou o remove usando um número negativo |
| Funcionalidade | O que faz |
|---|
| Notification | Uma notificação através do seu framework, com um tipo (sucesso por padrão) |
| Progress Bar | Uma barra de progresso com um rótulo, por uma duração: a integrada ou a do ox_lib, conforme Config.ProgressBar |
| Webhook | Envia para um webhook do Discord: sua mensagem, os identificadores do jogador e, opcionalmente, uma captura de tela (requer screenshot-basic). Apenas URLs de webhook do Discord são aceitas |
| Funcionalidade | O que faz |
|---|
| Command | Executa um comando como o jogador. Pode incluir ou não uma / no início |
| Trigger | Dispara um evento de cliente, um evento de servidor ou um export escrito como resourceName:exportName. Cada um recebe o nome do item |
| Car | Gera um modelo de veículo onde o jogador está, virado na direção dele, e opcionalmente o coloca no banco do motorista |
| Bundle | Entrega vários itens de uma vez — um fardo de seis cervejas, um kit de primeiros socorros. Executa no servidor. Combine com Remove on Use para que a caixa em si seja consumida; um bundle nunca dá o próprio item ao qual pertence |
Quando um jogador coloca um Placeable Prop, o objeto é criado para todos. O jogador que o colocou pode recolhê-lo de volta — com texto 3D e E, ou através de ox_target / qb-target se Config.Interaction estiver configurado assim. Recolhê-lo devolve a mesma quantidade do item que Remove on Use consumiu, para que um cone colocado no chão volte para o bolso de onde saiu.
Abra as configurações de um item para encontrá-las. Cada uma tem seu próprio botão de ativação.
| Restrição | O que faz |
|---|
| Cooldown | Tempo que o jogador deve esperar entre usos deste item, em milissegundos (60000 equivale a um minuto). Lembrado até que o servidor reinicie |
| Job Restriction | Apenas jogadores com um dos empregos listados, no cargo mínimo ou acima dele, podem usar o item |
| Required Item | O jogador deve carregar essa quantidade de outro item — como um isqueiro para usar um cigarro |
| Remove on Use | Quantas unidades do item são removidas cada vez que ele é usado |
| Always Attached Prop | Enquanto o item estiver no inventário, o Attach Prop do item permanece no jogador; ele desaparece quando o último sai. Apenas o jogador que o carrega vê este prop |
- Save armazena o item na tabela
mic_itemcreator e o torna utilizável imediatamente, para todos.
- O menu pode dar (give) o item a você, um de cada vez, para testá-lo.
- Delete remove a configuração: usar o item não faz mais nada a partir daí. O framework mantém o item registrado como utilizável até a próxima reinicialização, o que é inofensivo.
