Instalação

Nota

💬 Precisa de ajuda? Suporte, atualizações e changelogs estão no Discord da Mic Scripts. Abra um ticket com o seu ID de transação do Tebex e o erro do console.

Dez minutos: duas pastas, um arquivo SQL, oito itens.

---

Antes de começar

Você precisa	Por quê
ESX, QBCore ou QBox, em execução	Pagamento, itens e itens utilizáveis. Detectado automaticamente
oxmysql, em execução	Os placares de líderes
ox_target ou qb-target (opcional)	Apenas se você quiser interação via target

---

1. Coloque ambas as pastas no lugar

Seu download contém dois resources. Coloque ambos na sua pasta de resources, por exemplo dentro de resources/[mic]/:

Pasta	O que é
mic_arcade	O script e os jogos
mic_arcade_props	Os sete modelos de gabinete e o renderizador que coloca o jogo nas telas deles

Cuidado

Mantenha a pasta com o nome mic_arcade. A tela de cada gabinete carrega seu jogo a partir de mic_arcade pelo nome, e os jogos fazem callbacks para ele usando esse nome. Se for renomeada, as telas ficarão pretas.

---

2. Ordem de inicialização

No server.cfg, abaixo do oxmysql e do seu framework, inicie mic_arcade_props e depois mic_arcade, cada um em sua própria linha ensure.

Funcionou quando você entra no servidor e as máquinas fixas estão nas coordenadas listadas no config.lua — por padrão, uma fileira com quatro: Pixel, Race, Tower e Road.

---

3. O banco de dados

Importe install.sql (na raiz de mic_arcade) uma única vez. Ele cria uma tabela, mic_arcade_leaderboard, que guarda a melhor pontuação de cada personagem por jogo.

O script não cria essa tabela sozinho. Sem ela, os jogos continuam funcionando, mas as pontuações não são salvas e o placar de líderes fica vazio.

Funcionou quando o seu banco de dados tiver a tabela mic_arcade_leaderboard.

---

4. Adicione os itens

Item	O que faz
arcade_coin	A moeda para jogar quando Config.PaymentType = 'item' (o padrão)
arcade_alien	Posiciona um gabinete Alien
arcade_brick	Posiciona um gabinete Breakout
arcade_duofight	Posiciona um gabinete DuoFight
arcade_pixel	Posiciona um gabinete Pixel
arcade_race	Posiciona um gabinete Race
arcade_road	Posiciona um gabinete Road
arcade_tower	Posiciona um gabinete Tower

O script nunca entrega fichas ou gabinetes por conta própria. Venda-os em uma loja, entregue-os em um emprego ou dê pelo seu menu de admin.

As definições prontas vêm em mic_arcade/items/, e os ícones em mic_arcade/items/images/:

Inventário	Definições (mic_arcade/items/)	Onde colocá-las	Ícones
ox_inventory	ox.lua	ox_inventory/data/items.lua	Copie items/images/*.png para ox_inventory/web/images/
QBCore / qb-inventory	qbcore.lua	qb-core/shared/items.lua	Copie-os para qb-inventory/html/images/
Inventário padrão ESX	esx_items.sql	Importe uma vez no seu banco de dados	—

As entradas nos dois arquivos .lua estão comentadas — remova os -- iniciais quando colá-las.

Funcionou quando você se der um de cada e todos os oito aparecerem no seu inventário com seus ícones.

---

5. Framework e interação

O framework não precisa de configuração: ESX, QBCore ou QBox são detectados ao iniciar. O QBox é reconhecido pela sua compatibilidade com QBCore — qbx_core fornece qb-core — então não há nada para configurar.

A interação fica em Config.Interaction no config.lua. Ela vem como ox-target — com hífen neste script. Mude para qb-target se for o que você usa, ou para drawtext para um aviso simples de Pressione E.

---

6. Primeira partida

1. Dê a si mesmo pelo menos 100 arcade_coin — todos os gabinetes exceto o DuoFight custam 100 por padrão.
2. Caminhe até uma das máquinas fixas e escolha Play Arcade (ou pressione E com drawtext).
3. Inicie um jogo pelo menu da máquina. O Price da máquina será descontado em fichas.
4. Pressione ESC para sair da máquina.

Funcionou quando a câmera se aproximar da tela, o jogo rodar e suas fichas diminuírem pelo preço da partida.

Depois teste posicionar uma: use arcade_race, mova a prévia com a sua visão, gire com a roda do mouse e pressione E (ESC ou Backspace cancela). Olhe para ela novamente e você verá a opção Pick Up Arcade que só você pode ver.

---

Antes de abrir sua cidade

• Decida a moeda. Config.PaymentType vem como item usando arcade_coin. Se mantiver assim, certifique-se de que os jogadores tenham onde conseguir fichas.
• Defina os preços por gabinete em Config.Arcades.
• Posicione as máquinas fixas onde quiser, ou comente-as e deixe que os jogadores posicionem as próprias.
• Avise os jogadores que máquinas posicionadas são temporárias. Um gabinete posicionado permanece até que o resource ou o servidor reinicie; recolhê-lo antes devolve o item. Veja Solução de problemas.