03 - Tebex Store

2 min read

Tebex Store

INFO

Tebex è la piattaforma per vendere abbonamenti, pacchetti e risorse in FiveM. È il modo standard per monetizzare un server o distribuire risorse a pagamento.

ObiettivoDettagli
Cosa imparerai• Cos’è Tebex e come funziona
• Collegarlo al server (sv_tebexSecret)
• Pacchetti e delivery
Prerequisiti• Account Tebex
• (Per delivery) server attivo

1. Cos’è Tebex

Tebex (ex BuyCraft) vende pacchetti in-game: abbonamenti, monete, veicoli, permessi. Il server comunica con Tebex per “consegnare” ciò che il giocatore compra.

2. Collegare Tebex al Server

  1. Crea un account su https://tebex.io/
  2. Crea un package/listing per il tuo gioco (FiveM)
  3. Ottieni il secret key dal pannello

Nel server.cfg:

sv_tebexSecret c4f1300bda0ab123976449d27c160185bc31e175

WARNING

sv_tebexSecret è un secret: tienilo nel server.cfg privato, mai nel client o su GitHub (modulo 12/05).

3. Pacchetti (Packages)

In Tebex crei categorie e pacchetti:

Tipo pacchettoEsempio
AbbonamentoVIP mensile
Moneta virtuale1000 Coins
Item in-gameKit armi
AccessoWhitelist

Ogni pacchetto può avere comandi di consegna (es. giveitem %id% %item% %amount%).

4. Delivery (Consegna)

Quando un giocatore compra, Tebex invia un webhook/API al server. Il modo più semplice:

  • Configura nei pacchetti comandi server da eseguire alla consegna
  • Oppure usa la API di Tebex dal server per pollare le vendite
-- server.lua (esempio di comando di consegna)
-- Il comando configurato in Tebex esegue questo
RegisterCommand('giveitem', function(source, args)
    local target = tonumber(args[1])
    local item = args[2]
    local amount = tonumber(args[3]) or 1
    local xPlayer = ESX.GetPlayerFromId(target)
    if xPlayer then
        xPlayer.addInventoryItem(item, amount)
    end
end, true)  -- admin-only

5. Best Practice

  • Testa i comandi di consegna manualmente prima di attivare vendite
  • Aggiungi log delle consegne (modulo 14/06 Discord webhook)
  • Non vendere contenuti vietati dai ToS (modulo 17/04)
  • Verifica che il pagamento sia confermato prima della consegna (Tebex lo gestisce)

Verifica

  • sv_tebexSecret nel server.cfg privato
  • Comandi di consegna testati
  • Log delle consegne attivi
  • Nessun contenuto vietato in vendita

TIP

Prossimo passo: 04 - Licenze e Legal

Torna alla: Indice Generale