Herbs V2

Edizione a pagamento · RedM · VORP incluso · Altri framework tramite bridge pubblici

Raccogli piante, scegli le ricompense e crea le tue zone di raccolta. Non serve essere un developer per configurare Herbs: con VORP, gestisci le impostazioni principali dal menu in gioco seguendo questa guida. Se vuoi cambiare framework o aggiungere effetti di altri script, trovi i file modificabili e le guide dedicate qui sotto.

Usi già un altro framework? Uno sviluppatore può collegare il tuo core e il tuo inventario tramite i bridge pubblici modificabili. Vale per framework esistenti e per quelli sviluppati su misura; l’integrazione fornita è quella per VORP.

▷Anteprima in arrivo

Foto e video saranno disponibili in questa galleria.

Shop RZ

Versione

Leggi la versione installata in fxmanifest.lua. V2 usa la voce rz_herbs_v2 di RZ Releases, distinta dall’edizione gratuita.

Panoramica

• 41 tipi di piante, con nome, blip e ricompense personalizzabili.
• Impostazioni globali o diverse per ogni pianta: blip, raccolta a cavallo, respawn ed effetti di consumo supportati, nei limiti consentiti da RedM. Alcune piante non si mangiano; Saltbush permette soltanto il consumo.
• Gruppi con più coordinate e scelta delle piante in base alle probabilità.
• Posizioni e gruppi già predisposti come nella V1; puoi modificarli o aggiungerne dal menu.

Installazione

1. Scarica il pacchetto dal portale Cfx.re.
2. Metti la cartella rz_herbs dentro resources, anche in una categoria come [rz]: per esempio resources/[rz]/rz_herbs.
3. Avvia core, inventario e oxmysql prima di Herbs. L’integrazione di default è VORP; si può cambiare dai bridge pubblici.
4. Aggiungi al tuo server.cfg:

ensure oxmysql
ensure vorp_core
ensure vorp_inventory
ensure rz_herbs

Serve un server RedM con OneSync e una connessione database funzionante per oxmysql.

Primo avvio — Mostra Herbs nell’elenco degli script del menu RZ.

Passaggio dalla V1

Ferma la V1 e toglila dalle risorse attive; se vuoi conservarla, spostala da parte. Metti al suo posto la V2 con il nome rz_herbs: le due versioni non possono essere avviate insieme.

La V2 va configurata: gruppi e coordinate iniziali sono già quelli della V1, ma le tue modifiche personali non vengono importate. Scegli le ricompense e adatta le impostazioni dal menu. Puoi usare gli item che hai già nell’inventario.

Requisiti

VORP

• vorp_core, vorp_inventory e oggetti ricompensa registrati.

Altri framework

• Uno sviluppatore deve adattare public/bridge_server.lua a core e inventario; vedi Integrazione del framework.

Obbligatori per tutti

• RedM con OneSync, oxmysql e connessione database funzionante.
• Autorizzazione Cfx per il pacchetto protetto.
• Configurazione proprietario e permessi per modificare dal menu RZ.

Configurazione

Apri /rz → Herbs per le impostazioni dello script.

GUIDA MENU →

Generale

Box	Cosa imposti
Base	Lingua dei testi di gioco, attivazione dello script, debug
Piante	Raccolta a cavallo, effetti aggiuntivi, distanza di visualizzazione e tempo di respawn
Blip globali	Visibilità, icona e colore
Log Discord	Webhook e attivazione dei log di raccolta e consumo

La distanza va da 5 a 100; il respawn da 1 a 1440 minuti. Il debug serve durante le verifiche. Gli effetti aggiuntivi sono disattivati di default.

Impostazioni generali — Mostra i box Base, Piante e Blip globali.

Globale o personalizzato

Di default ogni pianta segue le impostazioni globali. Scegli Personalizzato per creare un’eccezione. Esempio: blip spenti per tutte, ma acceso per Yarrow. Usa globale per tutti toglie le eccezioni di quella impostazione.

Piante

Scegli o cerca una pianta per modificarne nome, blip, raccolta a cavallo, respawn e ricompense. Il box degli effetti compare solo sulle piante commestibili.

Una pianta personalizzata — Mostra Yarrow con un blip personalizzato e un’impostazione globale.

Per configurare proprietario e accesso dello staff, segui Accessi e log Discord.

Spawn e coordinate

1. Apri Posizioni e crea un gruppo con un nome riconoscibile.
2. Imposta la probabilità del gruppo e aggiungi le piante; conferma ogni scelta.
3. Cattura in gioco le coordinate in cui vuoi farle comparire. Puoi spostarle o rimuoverle. Premi Salva tutto per applicare il gruppo.

Gruppo di piante — Mostra due piante con probabilità e più coordinate.

Come funzionano le probabilità

Gruppo: probabilità che nasca qualcosa in ogni coordinata, all’avvio e dopo la raccolta. Se il tentativo di respawn fallisce, il punto resta vuoto fino alla ricostruzione delle posizioni, per esempio dopo un riavvio o una modifica salvata ai gruppi: non viene ritentato ogni minuto.

Piante: determinano quale viene scelta quando il punto produce una pianta. Le percentuali si adattano alle scelte: valori 1 e 3 corrispondono al 25% e 75%.

Per un punto fisso con una sola pianta: gruppo al 100%, una pianta e le coordinate desiderate.

Ricompense

Le ricompense sono vuote di default: scegli tu gli item del tuo inventario.

1. Apri una pianta → Ricompense di raccolta.
2. Scegli item, quantità minima/massima e probabilità; aggiungi la riga.
3. Ripeti per gli altri premi desiderati, poi premi Salva tutto per applicare le modifiche.

Ogni premio ha una probabilità indipendente: due premi al 50% possono dare nessuno, uno o entrambi. Il 100% non supera i limiti dell’inventario. La notifica elenca gli item effettivamente ricevuti.

Nessun item ricevuto?

Controlla ricompense impostate, nome esatto dell’item e spazio/limiti dell’inventario. Senza ricompense la pianta viene comunque raccolta.

Ricompense multiple — Mostra due item con quantità e probabilità.

Item piante facoltativi — VORP

Se vuoi aggiungere gli item delle piante, puoi eseguire public/herbs-vorp.sql nel database. È facoltativo: non serve se usi item già esistenti e non imposta le ricompense al tuo posto. Le istruzioni sono nel file SQL e nel README del pacchetto.

Effetti del consumo

In public/eateffects.lua puoi aggiungere le funzioni di altri script: fame, sete, stress o gli effetti che vuoi. Trovi una funzione per ogni pianta commestibile: inserisci la chiamata del tuo sistema e attiva l’effetto dal menu.

Il controllo abilita gli effetti aggiuntivi, non il tasto nativo “Mangia” di RedM. La notifica di consumo parte già dallo script: non serve aggiungerla nell’effetto.

Effetto del consumo — Mostra l’opzione di una pianta commestibile e il relativo aiuto.

Sincronizzazione e ricomparsa

Chi entra trova lo stato attuale delle piante. Quando qualcuno raccoglie o mangia, gli altri giocatori ricevono l’aggiornamento; la stessa pianta non assegna la raccolta a due giocatori insieme.

Resmon bassa: nel test dell’autore in mezzo a 41 piante, il valore massimo osservato è stato 0,02 ms. È il risultato di quel test, non un limite garantito per ogni server.

La ricomparsa usa l’impostazione effettiva della pianta ed è controllata una volta al minuto. Impostazioni, gruppi, coordinate e ricompense salvate rimangono nel database di configurazione: fanne un backup prima degli aggiornamenti. Lo stato raccolto e i cooldown delle singole piante sono invece in memoria e si azzerano al riavvio della risorsa.

Integrazione del framework

L’integrazione VORP è fornita. Altri framework richiedono l’adattamento delle chiamate reali di core e inventario nel bridge pubblico: non vengono selezionati automaticamente.

File	A cosa serve
public/bridge_server.lua	Adattare framework e inventario diversi da VORP
public/bridge_client.lua	Cambiare il sistema di notifica
public/eateffects.lua	Collegare effetti di altri script
public/notifications.lua	Cambiare le parole delle notifiche

GUIDA BRIDGE →

Lingue e notifiche

Apri public/notifications.lua e modifica i testi tra virgolette nel blocco inglese en o italiano it. Non ci sono segnaposto da gestire: nomi e quantità vengono aggiunti automaticamente.

Esempio: cambiando found = "Hai trovato:", una raccolta può mostrare “Hai trovato: x1 Yarrow”. I campi found_suffix ed eaten_suffix aggiungono soltanto la punteggiatura finale e possono restare vuoti.

Salva il file e riavvia solo rz_herbs. Per cambiare il sistema che mostra la notifica, segui la guida dedicata.

Notifiche in gioco — Mostra una raccolta con più item e il messaggio dopo il consumo.

Log Discord

In Generale → Log Discord, inserisci il webhook e attiva i log di Herbs per registrare raccolta e consumo.

Log di Herbs — Mostra script, pianta e risultato dell’interazione. Oscura gli identificatori personali.

Aggiornamento

1. Fai un backup della risorsa, dei file pubblici modificati e del database di configurazione.
2. Ferma rz_herbs e scarica il pacchetto aggiornato completo da Cfx.
3. Sostituisci la risorsa con il pacchetto completo, compresi .rz e le interfacce fornite. Non modificare i file generati in .rz e non aggiornare soltanto public/.
4. Confronta e riapplica le personalizzazioni di bridge, notifiche ed effetti nei file pubblici nuovi, senza sovrascriverli alla cieca con la vecchia cartella.
5. Conserva il database di configurazione e segui il changelog per eventuali migrazioni. Le ricompense già salvate non vanno azzerate come passaggio di aggiornamento.
6. Riavvia e controlla accesso al menu, impostazioni salvate, raccolta, ricompense, consumo e sincronizzazione multiplayer.

Mantieni rz_update_product "rz_herbs_v2" nel manifest fornito. Il controllo segnala gli aggiornamenti, ma non li installa. Per V1 → V2 usa il Passaggio dalla V1.

Risoluzione dei problemi

Problema	Cosa controllare
La risorsa non parte	Autorizzazione, dipendenze, connessione database e nome risorsa
Non posso modificare dal menu	Proprietario e permessi assegnati nella guida accessi
Nessuna pianta visibile	Impostazioni salvate/attive, coordinate, probabilità gruppo, distanza e cooldown
Nessuna ricompensa	Di default sono vuote: aggiungi gli oggetti, salva e controlla i limiti inventario
Nessun effetto aggiuntivo	Pianta commestibile supportata, effetto attivo e integrazione public/eateffects.lua
Notifica errata	Lingua script, public/notifications.lua e bridge notifiche client

Indica versione, framework, passaggi ed errori console pertinenti in un ticket Discord.