Skip to main content

Documentation Index

Fetch the complete documentation index at: https://pumpkings.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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

1

Look at the block where you want the 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).
2

Run the setup command

/slots setup
The machine is now active and clickable by any player with the required permission.
3

Remove a machine when needed

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.
1

Adjust your bet

Use the four colored dye buttons in the bottom row to fine-tune your wager:
ButtonMaterialEffect
-10kRed DyeDecrease bet by 10,000
-1kRed DyeDecrease bet by 1,000
+1kLime DyeIncrease bet by 1,000
+10kLime DyeIncrease bet by 10,000
Alternatively, click the Custom Amount paper icon (slot 4) to close the GUI and type an exact value in chat.
2

Spin the reels

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.
3

Collect your winnings

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.
SymbolDisplay NamePayout MultiplierWeight
Enchanted Golden Apple🎰 JACKPOT 777!100×1
Netherite BlockNETHERITE!25×5
DiamondDIAMOND!10×15
EmeraldEMERALD!30
Gold IngotGOLD!50
Iron IngotIRON!1.5×70
Golden AppleGolden Apple80
AppleApple0.5×100
DirtDirt120
Rotten FleshRotten Flesh120
StickStick120
Dead BushDead Bush120
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:
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 NodeLuck Multiplier
casino.suerte.hero1.5×
casino.suerte.elite2.0×
casino.suerte.leyenda3.5×
casino.suerte.dios4.0×
Add or rename boosters freely in config.yml:
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:
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

CommandDescription
/slots setupSpawn a slot machine on the block you are looking at
/slots deleteRemove the nearest slot machine
/slots purgeRemove all slot machines in the current world