Claw Machine

Physical Claw Machine arcade cabinet. Players pay chips, move the claw, and drop for a plush. A win grants the configured prize through an editable server hook. Runs through tgg-casino-tables (same ensure as other table games).

lua

ensure tgg-slots-server
ensure tgg-casino-tables

tgg-slots-server (required)
tgg-casino-tables (required)
ox_target or qb-target (same as other table games)

Place cabinets from Casinos → Add placement → Claw Machine.

Supported methods: Spawn a new prop, Use existing prop, Replace prop, and bulk where the creator allows it.

Playable cabinet model: ch_prop_arcade_claw_01a.

Player pays the machine chip cost (no refund on leave / miss / timeout).
Move the claw, then drop.
A centered grab on a remaining plush rolls winRate (chance is 1 / winRate).
On a win, the server calls GiveClawPrize(source, prize) and that slot stays empty until restock.
On a miss, the cabinet is unchanged.

rarity (common / rare) only changes the win sound. It does not change odds. Odds are winRate only.

Nine prize slots (six common, three rare by default)
Per-slot inventory item + world plush model
Per-machine play price (Admin) with a Lua fallback
Occupancy: one player per cabinet
Restock from Admin (edit machine Restock, or machine metrics Refill for claw)

Edit prize rows in:

tgg-casino-tables/config/claw.lua

Each row:

Field	Meaning
`item`	Inventory name passed to `GiveClawPrize`
`model`	World plush prop for that slot
`winRate`	Win when the roll is 0 out of `winRate` (example: `3` ≈ 33%, `12` ≈ 8%)
`rarity`	`common` or `rare` (win sound only)
`count`	Optional item count (default `1`)

Default item names (register these in your inventory):

claw_plush_humpy
claw_plush_methy
claw_plush_saki
claw_plush_sticky
claw_plush_smokey
claw_plush_grindy
claw_plush_princess
claw_plush_wasabi
claw_plush_master

If an item is missing from inventory, the grab can still play as a win and empty the slot, but the player receives nothing. Register the items before going live.

Grant hook - `GiveClawPrize`

When a player wins, the server calls:

lua

GiveClawPrize(source, prize)

Implement or adjust this in:

tgg-casino-tables/server/custom/claw/GiveClawPrize.lua

Arg	Meaning
`source`	Winner server id
`prize`	Winning row from `Config.Claw.prizes` (`item`, `model`, `rarity`, `winRate`, optional `count`)

The default body calls AddItem(source, prize.item, count) through your configured inventory adapter. Return true on success. Replace the body to grant cash, XP, or a different item.

Claw Machine

Resource

Dependencies

Placement

How a play works

Features

Prizes

Grant hook - GiveClawPrize

Configuration

See also

On this page

Grant hook - `GiveClawPrize`