Lucky Lounge

# Lucky Lounge 🎰

**Build your own casino.** Craft the tables and place them anywhere you like. Casinos are *not* generated in the world, you design your own. Exchange your resources for chips, try your luck at six different tables, and trade your winnings for exclusive prizes, on your own or together with friends on a server.

📖 **New players get a Casino Guide book** that explains the first steps, recipes and every game (craft another from a book + gold nugget).

All results are decided on the server. Chips cannot be converted to real money. This is an in-game economy only.

## 🎲 Games

| Table | How it plays |
|---|---|
| **Slot Machine** | 5 reels × 3 rows, 9 pay lines. Line up 3, 4 or 5 symbols from the left. 3+ Nether Stars anywhere trigger **free spins**. Includes *reach*, *confirmed-win* and *premium* animations, a **Fever mode** (a 7 line or four 7s give 10 boosted spins, can chain) and a rare **Netherite Rush** (the reels glow like lava and all wins are ×5 for 5 spins). (~98% RTP) |
| **Roulette** | European single-zero wheel. Bet on single numbers, **splits, streets and corners** (click the cell edges), red/black, odd/even, halves, dozens and columns, several spots per spin. |
| **Shared Roulette** 👥 | Multiplayer. The first bet starts a 15 s countdown, then **everyone at the table** watches the same spin. Press **Ready** or **Pass** to start right away. See other players' chips on the board. |
| **Chinchiro** | The classic Japanese three-dice game against the house. Pinzoro ×5, triples ×3, 4-5-6 ×2, and 1-2-3 pays double. |
| **Blackjack** | 6 decks, dealer stands on 17, blackjack pays 3:2, double down. |
| **High & Low** | Guess if the next card is higher or lower. The pot grows with every hit. Cash out any time, or lose it all. |

## 🎆 Big wins, jackpot and table settings
- **Fireworks**: big wins launch fireworks above the table (particles only, so no damage, no block breaking, no fire) and nearby players get a congratulation message. Mega wins and jackpots are announced to the whole server.
- **Progressive jackpot**: every paid slot bet adds 1% to a server-wide pot. Any spin can win it all, and bigger bets have a better chance. Check it on the slot screen or with `/casino jackpot`.
- **Table settings 1-6** (for server owners): each game table has a hidden setting from 1 (tight) to 6 (loose). It never changes the pay table, only how lucky the table is. Creative players sneak + right-click a table to view and change it.

## 💰 Chip economy
- **Exchange Machine**: turn items into chips. The accepted items and their rates are listed right in the GUI (e.g. Coal 1, Iron 5, Gold 10, Emerald 20, Diamond 50)
- **Prize Counter**: spend chips on prizes, with a confirmation screen and bulk exchange (up to 64 at once)
- Type any bet amount, or use +/- and MAX
- Personal balance plus **team accounts** with shared deposits and withdrawals
- Send chips to other players with `/casino pay`
- Leaderboard of the richest players

## 🎁 Exclusive prizes
**Charms** work while they are in your inventory:
- **Guard Charm**: 1% to negate any damage
- **Lifesaver Charm**: 5% to survive a lethal hit
- **Iron Wall Pendant**: 5% to gain Absorption V for 60 s when hurt
- **Reaper Dice**: 0.1% to instantly kill what you hit
- **Casino King Ring**: all four effects in one

**Gear:**
- **Gamble Sword**: diamond-tier sword whose damage multiplier is re-rolled on every hit (×0.5 to ×10)
- **Mystery Enchanted Book**: right-click to reveal a random enchanted book (curses included…)
- **Whim Bow**: each shot has a 35% chance to become a random effect arrow

## ⌨️ Commands
| Command | Description |
|---|---|
| `/casino balance` | Show your chips |
| `/casino pay <player> <amount>` | Give chips to a player |
| `/casino top` | Top 10 richest players |
| `/casino jackpot` | Show the current jackpot |
| `/casino team create/invite/join/leave/kick/info` | Manage your team |
| `/casino team deposit/withdraw <amount>` | Team account |
| `/casino admin give/take/set/check` | Admin tools (OP level 2) |

## ⚙️ Configuration
`world/serverconfig/luckylounge-server.toml`: starting chips, min/max bet, exchange rates, prize list and prices, accessory chances, and whether team members may withdraw.

## 📦 Requirements
- Minecraft **1.20.1**, Forge **47.x**
- Install on **both client and server**

We use AI in our production process.
---

## 日本語

台をクラフトして、**自分でカジノを建てる**Modです（ワールドにカジノが自然生成されるわけではありません）。資源をチップに両替し、6種類の台で遊んで、勝ったチップで限定景品と交換できます。マルチサーバーでみんなで遊ぶのがおすすめです。

初めて参加すると**カジノガイド（説明本）**がもらえます。最初にやること、レシピ、各ゲームの遊び方が載っています。

- **スロット**: 5×3・9ライン。フリースピン、確変、ネザライトラッシュ、リーチ演出、確定演出、プレミア演出あり
- **大当たりの花火**: 大当たりすると台の上に花火が上がり、周りのプレイヤーにお祝いメッセージが流れます（見た目と音だけで、ダメージや破壊はありません）
- **ジャックポット**: スロットの賭け金の1%がサーバー共通で積み上がり、スピンのたびに総取りのチャンスがあります
- **台の設定1〜6**（サーバー管理者向け）: 台ごとに当たりやすさを6段階で変えられます。クリエイティブで台をしゃがみ＋右クリック
- **ルーレット** / **みんなでルーレット**: みんなでルーレットは複数人が同じ盤面に同時にベットできます
- **チンチロ** / **ブラックジャック** / **ハイ&ロー**
- **チップ**: 個人口座とチーム口座、送金、長者番付
- **景品**: お守り・指輪などのアクセサリー、ギャンブルソード、ミステリーエンチャント本、気まぐれの弓

チップはゲーム内専用で、現実のお金には交換できません。
制作にAIを使用しています