BennyHobo — Tavern Slots + Server Utilities

BennyHobo adds a fast, server-friendly slot machine mini-game for taverns/casinos, plus a small set of optional admin and quality-of-life tools. Players wager server credits, watch three animated “reels” using vanilla blocks, and get paid instantly on three-of-a-kind results. Everything is fully in-world and light on server load.

Features

• In-world Slot Machines — Right-click a button that is attached to a diamond block to spin.
• Weighted RNG & Clear Payouts — See the weights and payout table below.
• Reel Animation — Per-reel offsets, randomized starts, and a short suspense hold on the last reel.
• Boss Bar Feedback — Progress bar shows “Spinning…” during a spin.
• Win Effects — Win chime and a celebratory firework on victory.
• Economy-Agnostic — Uses a simple CreditsHandler. Hook it into your economy or keep standalone.
• Anti-Exploit — Bet locks at spin start; machine locks while in use; safe cleanup on errors/disconnects.
• Placement-Friendly — Default indicator (reel) positions are auto-computed, with optional per-machine overrides.
• Optional Admin Toys — Light-hearted commands like /bully and /torment (cosmetic only, no damage).

How the Slot Machine Works

1. Build:
   • Place a button on a diamond block (this is the machine base).
   • The mod chooses three indicator positions above/behind the base (your 3 “reels”).
   • Advanced: you can override these three positions per machine.
2. Spin: Right-click the button (main hand). The bet is taken immediately and locked for the whole spin.
3. Animation:
   • Each reel starts on a random non-loss symbol and steps with a small, per-reel phase offset.
   • Reels stop one by one; the final reel holds slightly longer for suspense.
4. Resolution:
   • The game rolls one weighted outcome per spin.
   • If it is a symbol (not LOSS), all three reels land on that symbol and you are paid instantly.
   • If it is LOSS, reels end on a non-matching mix (no payout).

Weights & Payouts (Defaults)

Payouts are multipliers of the player’s bet. Weights determine odds (higher weight = more common).

Installation

• Loader: NeoForge 21.1.x
• Minecraft: 1.21.1
• Server: Put the mod .jar in the mods folder and start the server.
• Client: Uses vanilla blocks and server logic. If your server enforces a modlist, clients may also need the jar.

Anti-Exploit & Stability

• Bet locking: Bet is captured at spin start; changing any UI mid-spin does not change payout.
• Machine locking: One user at a time; locks clear safely.
• Server-side logic: Outcomes, animation, and payouts run on the server tick.

FAQ

Do I need this mod on the client?
Most features are server-driven with vanilla blocks/boss bars. If your server uses a strict modlist/handshake, clients may need the jar.

Can players “time” the reels?
No. The outcome is decided at spin start; reels animate toward that result (or a mixed non-win for LOSS).

Can I rebalance the machine?
Yes. Edit the Outcome enum weights and payouts.

Does this change world data?
Only the three indicator block states during a spin (cycling vanilla blocks). No custom blocks/items are added.

Disclaimer: This is a video-game mini-game for entertainment. No real-money gambling.