Installazione

Cinque minuti. Una cartella, un oggetto, una riga in config.lua.

Prima di iniziare

Ti serve	Perché
ESX, QBCore o QBox, avviato	L’oggetto corda viene registrato tramite il tuo framework
Un inventario che possa contenere `rope`	ox_inventory, qb-inventory o quello predefinito di ESX vanno bene
ox_target o qb-target (opzionale)	Solo se preferisci il menu target al posto del testo 3D

1. Posiziona la cartella

Inserisci mic_drag nelle tue risorse, ad esempio dentro resources/[mic]/. Mantieni la cartella stream/ inclusa: contiene il modello della corda (prop_stag_do_rope) e la sua texture; senza di essa la corda non apparirà mai nella mano del giocatore.

2. Avvialo dopo il tuo framework

Nel server.cfg, posiziona ensure mic_drag sotto il tuo framework (es_extended, qb-core o qbx_core) e sotto il tuo inventario. Se usi un sistema di target, avvia anch’esso prima di mic_drag — anche se la corda rileverà comunque il target da sola qualora partisse dopo.

Ha funzionato quando la console del server non mostra alcuna riga rossa da parte di mic_drag all’avvio. Il messaggio che non vuoi vedere è “Config.Framework must be esx or qbcore”.

3. Il database — nulla di proprio

mic_drag non salva alcun dato. L’unico passaggio relativo al database è la riga dell’oggetto per ESX al punto 4, e solo se utilizzi l’inventario predefinito di ESX.

4. Aggiungi l’oggetto corda

Il nome dell’oggetto è rope (impostato da Config.Item).

Oggetto	Cosa fa
`rope`	Usalo per impugnare la corda o riporla. Necessario nell’inventario per iniziare a trascinare. Non viene mai consumato

Le definizioni pronte all’uso si trovano nella cartella inventory/ della risorsa:

Inventario	File in `mic_drag/inventory/`	Dove va
ox_inventory	`ox_inventory.md`	Aggiungi la voce a `ox_inventory/data/items.lua`
QBCore / qb-inventory	`qb_inventory.md`	Aggiungi la voce a `qb-core/shared/items.lua`
Inventario predefinito ESX	`esx_inventory.sql`	Importalo una volta nel tuo database

Con la risorsa non viene fornita alcuna immagine per l’oggetto. Se il tuo inventario mostra un’icona vuota, inserisci un qualsiasi file rope.png nella cartella immagini del tuo inventario (ox_inventory/web/images/ o qb-inventory/html/images/).

Ha funzionato quando ti dai un oggetto rope e questo compare nel tuo inventario con la sua etichetta.

5. Imposta il tuo framework e l’interazione

Apri config.lua:

Config.Framework — esx (predefinito) o qbcore. Non c’è rilevamento automatico; deve corrispondere al tuo. Su QBox, scegli qbcore: QBox esegue le risorse QBCore tramite il suo livello di compatibilità.
Config.InteractionSystem — ox_target (predefinito), qb-target o drawtext.

Se scegli un target che non è in esecuzione, vedrai “ox_target is not started; using drawtext until it starts” nella console client (F8) e nel frattempo la corda funzionerà con il testo 3D.

6. Primo test

Hai bisogno di un secondo giocatore per questo test — la corda afferra solo i giocatori.

Usa l’oggetto rope. La corda apparirà nella tua mano destra.
Avvicinati all’altro giocatore (entro 2 m). Con il target, guardalo e scegli Drag with rope. Con drawtext, premi E quando compare il suggerimento.
Allontanati. Ti seguirà attaccato alla fune. Tieni premuto Freccia Su / Freccia Giù per modificare la lunghezza.
Avvicinati a un’auto e scegli Tie to vehicle (oppure premi Y con drawtext). Parti con l’auto.

Ha funzionato quando l’altro giocatore cade in ragdoll all’estremità di una corda visibile, e la corda passa dalla tua mano al retro dell’auto quando la leghi.

Prima di aprire la tua città

Config.Framework corrisponde al framework che usi effettivamente (qbcore su QBox).
QBCore: il campo name dell’oggetto è rope, tutto minuscolo.
Le etichette in Config.Labels sono nella lingua del tuo server — sono l’unico testo visibile ai giocatori.
Config.KeyLabels corrisponde ancora ai tasti scelti se hai modificato Config.AttachKey o Config.AttachToVehicleKey.
Decidi cosa fare con Config.EnableMaxDragTime. Se disattivato, la corda dura finché qualcuno non la lascia andare.