Developer

Overview

ML Tattoos exposes server exports for the uses economy, a client export to open the shop, and override hooks in open/. Mutating use exports are restricted to the resources listed in Config.AllowedConsumerResources; read exports are open.

Server Exports

All under exports.ml_tattoos:<Name>(...). identifier is the player's framework id; ctype is 'solo', 'faction' or 'ytd'.

• GrantTattooCredit(identifier, ctype, amount, reason?): Grants uses to a player (capped per type). Caller must be an allowed resource. Returns ok, granted
• GetTattooCredits(identifier): Returns the player's balances: { solo, faction, ytd, total_granted, total_consumed }. Open to any resource
• ConsumeTattooCredit(identifier, ctype): Consumes one use of a type. Caller must be an allowed resource. Returns ok, reason?
• RefundTattooCredit(identifier, ctype, reason?): Refunds one use of a type (capped). Caller must be an allowed resource

Two server exports are reserved for the Tebex hub and are called only by the ml_tebex dispatcher: OnTebexPackage(ev) (grants the package's uses) and OnTebexRefund(ev) (reverses a refunded transaction, returning { status, detail }). You do not call these yourself.

Client Exports

• openShop(opts): Opens the tattoo shop. opts may carry mode ('shop' / 'item'), a limit, and preset filters (zones, categories, hashes, allowCustom, customOnly). Returns false if the shop is already open

open/ Handlers

Override these in the open/ files. They are not escrowed.

Client

1function OpenClient.BeforeOpenShop(shopData)
2    return true
3end
4
5function OpenClient.OnTattooPurchased(tattoos)
6end

Server

1function OpenServer.OnCheckout(src, tattoos, totalCost)
2end
3
4function OpenServer.OnCustomApproved(src, data)
5    return true
6end

Shared

1function OpenShared.CanBuyTattoo(tattooHash, tattooDlc)
2    return true
3end

Client Export

• MLAdminOpen(): opens the admin panel, permission checked, for a staff menu

Examples

1local identifier = exports.ml_bridge:GetPlayerId(src)
2local ok, granted = exports.ml_tattoos:GrantTattooCredit(identifier, 'solo', 1, 'coin_redeem')
3if ok then
4    print(('granted %d solo use(s)'):format(granted))
5end

1local identifier = exports.ml_bridge:GetPlayerId(src)
2local bal = exports.ml_tattoos:GetTattooCredits(identifier)
3print(('solo=%d faction=%d ytd=%d'):format(bal.solo, bal.faction, bal.ytd))

1function OpenShared.CanBuyTattoo(tattooHash, tattooDlc)
2    if tattooDlc == 'mpluxe2_overlays' then return false end
3    return true
4end

1exports.ml_tattoos:openShop({ mode = 'shop' })
2
3exports.ml_tattoos:openShop({
4    mode = 'item', limit = 1,
5    zones = { 'ZONE_LEFT_ARM' }, allowCustom = false,
6})

1function OpenServer.OnCheckout(src, tattoos, totalCost)
2    if totalCost > 0 then
3        print(('player %d paid %d for %d tattoo(s)'):format(src, totalCost, #tattoos))
4    end
5end