Forsiden

Gratis script · v1.0.0

KD Vendingmachine

Realistiske vending machines til FiveM, hvor hver maskine har sit eget UI. Gå hen til maskinen, tryk på knapperne, betal med kontant eller kort, se dåsen falde, og tag den fra bakken.

ZIP fra GitHub · MIT-licens

Kan du lide scriptet? Giv det en ⭐ på GitHub. Det er gratis og hjælper andre med at finde det.

  • QBox
  • QBCore
  • ESX
  • Standalone
  • ox_inventory
  • ox_target
  • qb-target
  • Lua 5.4
eCola-maskinen: man vælger en drik, betaler med kort, dåsen falder ned i bakken, og lågen åbner
eCola-maskinen. Snacks, kaffe, vand, Sprunk og den retro cigaretautomat har hver deres eget UI.

Et UI til hver maskine

Det er ikke én menu med en anden farve. Hver maskine har sin egen hardware, sine egne knapper og sin egen lyd.

  • Se den i videoen øverst

    eCola

    Rød sodavandsfront, oplyst vindue med prøver, valgknapper, seddelindføring og kontaktløs kortlæser.

    • prop_vend_soda_01
  • Sprunk-maskinens UI i KD Vendingmachine Vis større billede

    Sprunk

    Samme hardware som eCola, men med Sprunks limegrønne branding.

    • prop_vend_soda_02
  • Raine-maskinens UI i KD Vendingmachine Vis større billede

    Raine

    En ren, gletsjerblå vandmaskine.

    • prop_vend_water_01
  • Snacks-maskinens UI i KD Vendingmachine Vis større billede

    Snacks

    Glasfront med spiraler, hyldeskilte og et A1–D6 tastatur. Du kan også skrive på dit eget keyboard.

    • prop_vend_snak_01
    • prop_vend_snak_01_tu
  • Coffee-maskinens UI i KD Vendingmachine Vis større billede

    Coffee

    Touchskærm: vælg drik, kopstørrelse (ændrer prisen), sukker og styrke. Bryggering, kopholder med hældeanimation og damp.

    • prop_vend_coffe_01
  • Cigarettes-maskinens UI i KD Vendingmachine Vis større billede

    Cigarettes

    70'er-automat med træk-knapper: træårer, løbelys, indsæt mønter og træk i et forkromet håndtag.

    • prop_vend_fags_01

Det får du

Alt det, der får en vending machine til at føles som en rigtig maskine, og det, der holder din økonomi sikker.

  • Fysiske animationer

    Spilleren går hen til maskinen og vender sig mod den, trykker på knapper, mens UI'et er åbent, og rækker ned i bakken efter varen. Den rigtige prop (dåse, flaske, chokoladebar, chips, kaffekop eller cigaretpakke) er i hånden, og andre spillere kan se den.

  • Feedback fra maskinen

    LCD- og VFD-displays, LED'er på kortlæseren, en seddel der glider ind, spiralen der drejer, varen der falder og hopper i bakken, og en låge du skubber for at tage den.

  • Procedurale lydeffekter

    Bip fra tasterne, mønter, godkendt kort, motorbrum, bunket fra varen, brygning og knappernes klik. Lavet med Web Audio, så der følger ingen lydfiler med.

  • Virker med dit framework

    QBox, QBCore, ESX eller standalone med ox_inventory. Det bliver fundet automatisk.

  • Virker med din interaktion

    ox_target, qb-target, ox_lib text UI eller GTA's egen hjælpetekst (~INPUT_CONTEXT~). Den bedste, du har, bliver valgt.

  • Serveren bestemmer

    Pris, lager, afstand, betaling, plads i inventory og cooldown tjekkes på serveren. Kan varen ikke gives, får spilleren automatisk pengene tilbage.

  • Lager pr. maskine

    Hver fysisk maskine har sit eget lager, som fyldes op automatisk. Admins kan fylde alle maskiner med /restockvending.

  • Discord-logs

    Køb og mistænkelige forespørgsler kan logges til en Discord-webhook.

  • Ekstra placeringer

    Sæt flere maskiner op hvor som helst fra configen.

  • Dansk og engelsk

    Begge sprog følger med, og det er nemt at tilføje flere.

  • Preview i browseren

    Åbn web/index.html i Chrome eller Edge, og klik dig igennem alle maskiner uden at starte spillet.

Krav

Ingen krævede dependencies ud over dit framework og dit inventory.

Framework (et af dem)
qbx_core · qb-core · es_extended · eller standalone med ox_inventory
Inventory
ox_inventory, qb-inventory (og forks) eller ESX' standard-inventory
Valgfrit
ox_target / qb-target, ox_lib (notifikationer og text UI)
Server
OneSync slået til (bruges til afstandstjek på serveren)

Installation

Fra download til en fungerende maskine på et par minutter.

  1. Download

    Download ZIP-filen og pak den ud.

    Download gratis
  2. Læg den i resources

    Omdøb mappen til kd-vendingmachine, og læg den i din resources-mappe.

  3. Tilføj varerne

    Tilføj varerne til dit inventory. Se tabellen nedenfor.

  4. Start resourcen

    Tilføj den til server.cfg efter dit framework, inventory og target:

    cfg
    ensure kd-vendingmachine
  5. Admin-adgang (valgfrit)

    Giv admins adgang til at fylde maskinerne op:

    cfg
    add_ace group.admin kdvending.admin allow
  6. Genstart

    Genstart serveren. Konsollen skriver dette, og varer der mangler i dit inventory, bliver vist som en advarsel:

    console
    [kd-vendingmachine] v1.0.0 loaded · framework: qbox · inventory: ox_inventory

Varer

Standard-configen sælger omkring 30 varer. Definitioner, der er klar til at indsætte, ligger i mappen /install.

InventoryFilHvor den skal hen
ox_inventory (QBox / ESX / standalone)install/ox_inventory.luaox_inventory/data/items.lua. Med animationer, props og status-værdier.
qb-inventoryinstall/qb-core.luaqb-core/shared/items.lua
ESX default inventoryinstall/esx.sqlKør den mod din database

Har du allerede water, coffee, sandwich eller lighter? Så spring dem over. Du kan også få enhver maskine til at sælge dine egne varer ved at ændre name i configen.

Kører det på din server?

Kan du lide scriptet? Giv det en ⭐ på GitHub. Det er gratis og hjælper andre med at finde det.

Giv en stjerne på GitHub

Konfiguration

To config-filer. Den ene deles med klienten, den anden bliver kun på serveren.

FilIndholdSendt til klienten?
config/config.luaMaskiner, varer, priser, UI, animationer og interaktionJa
config/server.luaWebhook, maks afstand, admin-ace og loggingNej

Generelt

lua
Config.Locale      = 'en'     -- 'en' | 'da'
Config.Framework   = 'auto'   -- 'auto' | 'qbox' | 'qbcore' | 'esx' | 'standalone'
Config.Inventory   = 'auto'   -- 'auto' | 'ox_inventory' | 'framework'
Config.Interaction = 'auto'   -- 'auto' | 'ox_target' | 'qb-target' | 'textui' | 'native'
Config.Notify      = 'auto'   -- 'auto' | 'ox_lib' | 'framework' | 'native'

Config.InteractDistance = 1.6
Config.AlignPlayer      = true   -- walk up to the machine before the UI opens
Config.NetworkedProps   = true   -- others can see the product in your hand
Config.Cooldown         = 1500   -- ms between purchases (server enforced)

Betaling og lager

lua
Config.Payment = { cash = true, bank = true }   -- default, override per machine

Config.Stock = {
    enabled        = true,
    default        = 12,   -- per slot, override with `stock = n` on an item
    restockMinutes = 30,
}

Lageret holdes pr. fysisk maskine: to eCola-maskiner ved siden af hinanden har hver deres lager.

Interface

lua
Config.UI = {
    currency    = '$',
    sound       = true,
    volume      = 0.35,
    showBalance = true,      -- show cash / bank under the payment modules
    autoTake    = 8000,      -- auto-grab after X ms if the player doesn't click the tray (0 = off)
    images      = 'drawn',   -- 'drawn' | 'inventory' | 'nui://my-images/%s.png'
}
imagesResultat
'drawn'Stiliserede CSS-varer (dåser, flasker, barer, chips, kopper, pakker) i varens farver. Virker uden opsætning og passer til maskinerne.
'inventory'Bruger dit inventorys billeder (ox, qb, ps og lj bliver fundet automatisk). Falder tilbage til tegnede varer, hvis et billede mangler.
egen tekstEn vilkårlig URL-skabelon med %s, som bliver erstattet med varens navn.

Tilføj eller ret en maskine

lua
Config.Machines.mymachine = {
    label     = 'Energy Machine',          -- target label / notifications
    brand     = 'Junk',                    -- printed on the machine
    tagline   = 'The quick fix',
    layout    = 'soda',                    -- 'soda' | 'glass' | 'coffee' | 'retro'
    theme     = 'sprunk',                  -- 'ecola' | 'sprunk' | 'raine' | 'snack' | 'coffee' | 'redwood'
    models    = { 'prop_vend_soda_02' },   -- each model can only belong to one machine
    animation = 'tray_low',                -- key from Config.Animations
    icon      = 'fa-solid fa-bolt',
    payment   = { cash = true, bank = false },   -- optional
    items = {
        {
            name   = 'junk_energy',  -- inventory item
            label  = 'Junk Energy',
            price  = 6,
            kind   = 'can',          -- drawn shape: can | bottle | bar | bag | candy | cup | pack
            color  = '#1b1b1b',      -- main colour
            accent = '#b6ff00',      -- label / stripe colour
            prop   = 'can',          -- hand prop, key from Config.Props
            stock  = 20,             -- optional
            -- image    = 'https://...',          -- optional, overrides Config.UI.images
            -- metadata = { quality = 100 },      -- optional, ox_inventory metadata
        },
    },
}

Kaffemaskiner kan have størrelser, som ganger prisen (tjekkes på serveren):

lua
sizes = {
    { label = 'S', name = 'Small',  multiplier = 1.0 },
    { label = 'M', name = 'Medium', multiplier = 1.25 },
    { label = 'L', name = 'Large',  multiplier = 1.5 },
},

Animationer

Hver maskine bruger et animations-preset, som du kan ændre eller lave flere af. Hånd-props står i Config.Props og bruges ved navn fra varerne. Ugyldige modeller bliver sprunget over med en advarsel i konsollen, så intet går i stykker.

lua
Config.Animations.tray_low = {
    align  = vec3(0.0, -0.78, 0.0),   -- where the player stands (machines face -Y)
    browse = { dict = 'anim@heists@keypad@', clip = 'idle_a', flag = 49 },        -- loop while UI is open
    press  = { dict = 'anim@heists@keypad@', clip = 'exit',   flag = 48 },        -- confirm purchase
    grab   = { dict = 'pickup_object', clip = 'pickup_low', flag = 0,
               propAt = 0.36,   -- anim phase where the product appears in the hand
               stopAt = 0.92,   -- anim phase where the grab ends
               hold   = 900 },  -- ms the product stays in hand afterwards
}

Ekstra placeringer

lua
Config.Placements = {
    { machine = 'coffee', coords = vec4(-1199.61, -884.82, 12.81, 124.0) },
    { machine = 'snacks', coords = vec4(441.32, -979.64, 29.69, 180.0), model = 'prop_vend_snak_01_tu' },
}

API

Exports og events, så du kan bygge videre på det fra dine egne scripts.

Client exports

lua
-- Open the UI for a machine entity (e.g. from your own target / interaction script)
exports['kd-vendingmachine']:OpenMachine(entity)

-- Is the UI currently open?
local open = exports['kd-vendingmachine']:IsOpen()

-- Force close (the player still grabs anything they paid for)
exports['kd-vendingmachine']:CloseMachine()

Server exports

lua
-- Refill every machine
exports['kd-vendingmachine']:Restock()

-- Current stock of a specific machine
local stock = exports['kd-vendingmachine']:GetStock('ecola', vec3(x, y, z))

Server events

lua
-- Fired after every successful purchase
AddEventHandler('kd-vendingmachine:purchased', function(source, data)
    -- data.machine, data.item, data.price, data.payment, data.coords
end)

Kommandoer

KommandoTilladelseBeskrivelse
/restockvendingkdvending.admin (eller serverkonsollen)Fyld alle maskiner op

Sikkerhed

Klienten bestemmer aldrig noget, der betyder noget. Ved hvert køb gør serveren følgende:

  • tjekker, at spilleren er inden for ServerConfig.MaxDistance af maskinen
  • tjekker, at varen hører til maskinen, og tager prisen fra configen, aldrig fra klienten
  • tjekker betalingsmetode og kopstørrelse
  • tjekker lager, plads i inventory og saldo
  • trækker pengene først, giver så varen, og betaler tilbage, hvis det fejler
  • håndhæver en cooldown pr. spiller
  • logger alt mistænkeligt i konsollen og eventuelt til en Discord-webhook

FAQ

De mest almindelige spørgsmål. Mangler du svar, så skriv på Discord.

Der sker ingenting, når jeg targeter en maskine

Sørg for, at kd-vendingmachine starter efter din target-resource. Med Config.Debug = true skriver F8-konsollen, hvilken interaktion der blev valgt.

"Ikke nok penge" eller "Du kan ikke bære det", selv om jeg kan

Tjek, at varen findes i dit inventory. Manglende varer bliver vist, når resourcen starter. Ukendte varer fejler tjekket for plads.

Spilleren står ikke rigtigt foran maskinen

Ret align i animations-presettet. y er afstanden foran maskinen (negativ = foran). Du kan også slå det fra med Config.AlignPlayer = false.

Kan jeg bruge mine egne vending machine props eller MLO-maskiner?

Ja. Tilføj modelnavnet til en maskines models-liste, eller lav en ny maskine. Alle props virker.

Virker UI'et uden internet (fonts)?

Fonts hentes fra Google Fonts. Uden internet bruger UI'et systemets fonts og virker stadig.

Må jeg ændre det og bruge det på min server?

Ja. Scriptet er MIT-licenseret: brug det, ændr det, og del det. Kredit er værdsat, men ikke et krav.

Klar til en tår?

Gratis og open source under MIT-licensen. Brug det, ændr det, del det. Har du brug for noget custom, så skriv på Discord. Kan du lide scriptet? Giv det en ⭐ på GitHub. Det er gratis og hjælper andre med at finde det.