> ## Documentation Index
> Fetch the complete documentation index at: https://pumpkings.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Slots 777: Place and Configure the Slot Machine Game
> Place a physical Slots 777 machine in your world, configure prize tiers with custom multipliers and weights, and trigger jackpot broadcasts on big wins.
Slots 777 places a real, interactive block entity inside your Minecraft world that players walk up to and right-click to open. Once inside the GUI, players choose their wager, watch three animated reels spin in real time, and instantly receive their payout — or the server-wide jackpot broadcast — the moment all three symbols lock in.
## Placing and Removing a Machine
Face the block in your world where the slot machine should appear — the machine spawns on the block you are looking at (within 5 blocks range).
```
/slots setup
```
The machine is now active and clickable by any player with the required permission.
Stand near the machine you want to remove and run:
```
/slots delete
```
This removes the nearest slot machine entity and frees its location.
Only administrators with the appropriate permission node can place or delete machines. Regular players only need the right-click interaction permission to play.
***
## How Players Use the Machine
When a player right-clicks the physical slot machine entity, a 3-row inventory GUI opens automatically. The three central slots (12, 13, 14) act as the spinning reels and display a `?` block while idle.
Use the four colored dye buttons in the bottom row to fine-tune your wager:
| Button | Material | Effect |
| ------ | -------- | ---------------------- |
| `-10k` | Red Dye | Decrease bet by 10,000 |
| `-1k` | Red Dye | Decrease bet by 1,000 |
| `+1k` | Lime Dye | Increase bet by 1,000 |
| `+10k` | Lime Dye | Increase bet by 10,000 |
Alternatively, click the **Custom Amount** paper icon (slot 4) to close the GUI and type an exact value in chat.
Click the **🎰 SPIN!** button (Tripwire Hook, slot 22). Your bet is withdrawn immediately, and the three reels begin animating. Each reel locks in sequence — reel 1 at 20 ticks, reel 2 at 40 ticks, reel 3 at 60 ticks — accompanied by anvil-land sound effects.
If all three reels show the same symbol and it has a multiplier above `0`, your payout is deposited automatically. An **Amethyst Shard** "Try Again?" button appears so you can spin immediately without re-opening the machine.
The bet is clamped to your current balance. If you don't have enough for the minimum bet the machine plays a villager "no" sound and no spin occurs.
***
## Prize Tiers
Prizes are drawn with weighted random selection — higher weight means the symbol appears more often. To win, all three reels must land on the **same** symbol. A multiplier of `0.0` means you receive nothing for that combination.
| Symbol | Display Name | Payout Multiplier | Weight |
| ---------------------- | --------------- | ----------------- | ------ |
| Enchanted Golden Apple | 🎰 JACKPOT 777! | 100× | 1 |
| Netherite Block | NETHERITE! | 25× | 5 |
| Diamond | DIAMOND! | 10× | 15 |
| Emerald | EMERALD! | 5× | 30 |
| Gold Ingot | GOLD! | 3× | 50 |
| Iron Ingot | IRON! | 1.5× | 70 |
| Golden Apple | Golden Apple | 1× | 80 |
| Apple | Apple | 0.5× | 100 |
| Dirt | Dirt | 0× | 120 |
| Rotten Flesh | Rotten Flesh | 0× | 120 |
| Stick | Stick | 0× | 120 |
| Dead Bush | Dead Bush | 0× | 120 |
You can modify every entry — material, display name, multiplier, and weight — directly in `config.yml` under `slots.prizes`.
***
## Bet Limits and Daily Uses
Configure minimum/maximum bets and per-day spin limits in `config.yml`:
```yaml theme={null}
slots:
active: true
bet:
default:
min: 100.0
max: 100000.0
ranks:
vip:
permission: "casinoliric.bet.vip"
max: 500000.0
admin:
permission: "casinoliric.bet.admin"
max: 10000000.0
uses:
default:
max-uses-per-day: 20
ranks:
vip:
permission: "casinoliric.uses.vip"
max-uses-per-day: 100
admin:
permission: "casinoliric.uses.admin"
max-uses-per-day: -1 # -1 = unlimited
```
***
## Luck Boosters
Grant players a weighted luck multiplier via permission nodes. A booster of `2.0` doubles the effective weight of every prize tier for that player, shifting the random distribution toward better outcomes.
| Permission Node | Luck Multiplier |
| ----------------------- | --------------- |
| `casino.suerte.hero` | 1.5× |
| `casino.suerte.elite` | 2.0× |
| `casino.suerte.leyenda` | 3.5× |
| `casino.suerte.dios` | 4.0× |
Add or rename boosters freely in `config.yml`:
```yaml theme={null}
slots:
luck-boosters:
casino.suerte.hero: 1.5
casino.suerte.elite: 2.0
casino.suerte.leyenda: 3.5
casino.suerte.dios: 4.0
```
***
## Jackpot Broadcasts
When a player lands three **Enchanted Golden Apple** symbols, the plugin:
1. Awards the full `100×` payout to the player.
2. Broadcasts a server-wide message to every online player.
3. Fires a Discord webhook event tagged `jackpot` (if a webhook URL is configured).
4. Plays `UI_TOAST_CHALLENGE_COMPLETE` for the winner.
Non-jackpot big wins also trigger a Discord webhook (`sendBigWin`). If you do not want win announcements on Discord, leave the webhook URL blank in your configuration.
***
## Tax Integration
If the global tax system is enabled, a percentage of gross winnings is deducted before the payout is deposited:
```yaml theme={null}
taxes:
enabled: true
slots: 0.05 # 5% of the gross win is deducted
```
With `enabled: false` (the default), players receive the full multiplied amount.
***
## Admin Command Reference
| Command | Description |
| --------------- | ---------------------------------------------------- |
| `/slots setup` | Spawn a slot machine on the block you are looking at |
| `/slots delete` | Remove the nearest slot machine |
| `/slots purge` | Remove all slot machines in the current world |