MineGames

MineGames

MineGames is a Paper 1.21+ casino plugin with four game types:

1. MineGame: reveal safe blocks, avoid mines, cash out at your chosen point.

1. Roulette: perpetual rounds where players bet on red/black/green.

1. Slots: lever-driven reels with configurable widths, rows, frames, and payouts.

1. Fights: wager on randomly equipped mobs battling inside a protected arena.

All games use Vault economy, support per-station cosmetics, holograms, and casino frame animations.

Requirements

• Java 21
• Paper 1.21+
• Vault (for example VaultUnlocked)
• A Vault-compatible economy plugin (for example EconomyProvider by ilius)

Install

1. Place minegames-1.x.x.jar in plugins/.
2. Ensure Vault + economy plugin are installed.
3. Start/restart server.
4. Edit plugins/MineGames/config.yml as needed.
5. Create stations:
6. MineGame station: stand on your station block and run /minegameadmin create
7. Roulette station: stand at board center and run /rouletteadmin create
8. Slots station: stand where you want the machine and run /slotsadmin create [3-8] [1|2]
9. Fights station: stand at the arena origin and run /fightadmin create [odd-size] [fighters]

Casino Settings GUI

Operators can open the inventory-based settings menu with:

/casinogui

The GUI includes MineGame, Roulette, Slots, and Fights. Select a game to edit global settings, browse its stations, and edit supported per-station overrides. Global changes override existing station settings. Previous/Next navigate settings pages, and Back/Stations provide navigation.

Gameplay

Mines

1. Stand on a MineGame station block.
2. Start a game: /minegame <mines> <wager>
3. Break/click tiles to reveal safe blocks.
4. Cash out with /minegame cashout or by breaking a frame block.
5. Lose by hitting a mine or timeout, win by clearing all safe tiles.

Roulette

1. Stand near a Roulette station.
2. Place bet: /roulette <red|black|green> <amount>
3. Bets close when countdown ends, then spin/result phase resolves.
4. Payouts apply automatically for winning color bets.
5. Round resets and repeats continuously.

Slots

1. Stand near a Slots station.
2. Pull the lever to spin and pay the configured wager.
3. Reels animate for a few seconds and then stop from left to right.
4. Matching the winning block pays out based on how many appear or which payline lands.
5. The station can be customized with outer frame, inner frame, winning block, row count, and lever-side frame animation.

Fights

1. Stand near a Fights station.
2. Place a bet: /fighter <fighter-number> <amount>.
3. The first accepted bet opens the countdown; fighters spawn only when betting closes.
4. Two fighters run as a duel. Three or more fighters run as a free-for-all.
5. Fighters receive random weapons, armor, enchantments, colors, and supported variants, then fight until one remains. The pool includes zombie, husk, drowned, zombie villager, skeleton, stray, bogged, wither skeleton, pillager, piglin, piglin brute, and zombified piglin fighters. Winning bets pay automatically, losing bettors are notified, and the winner is celebrated with fireworks.
6. Set fights.show-bettor-name-on-fighter to show the bettor in the mob nameplate. Set fights.fireworks-for-winning-bettors to true (the default) to add fireworks from all four arena corners for winning bets.
7. All rolled weapons, including tridents, use armor- and enchantment-aware damage calculations.

Winner Math & RNG

1. MineGame

   • Mine positions are generated once when the round starts with Math.random(), using generateMines(mines, gridSize * gridSize).
   • Mines are placed uniformly without replacement, so the same cell cannot become a mine twice.
   • The player wins by revealing enough safe tiles before hitting a mine or timing out.
   • Payout is based on revealed safe tiles. If minegame.game.max-multiplier is set above 0, the multiplier scales linearly from 1x up to the configured max. Otherwise, it uses the inverse of the survival probability with a house-edge factor applied.
   • The survival math uses combinations: surviveProbability = C(safe, revealed) / C(total, revealed).

2. Roulette

   • Each round builds a full board pattern from the configured color percentages: roulette.red-percent, roulette.black-percent, and roulette.green-percent.
   • The counts are normalized to the board size, then green cells are assigned randomly and the remaining cells are shuffled with Java Random.
   • When the spin resolves, the selector lands on a random board index and the color stored at that index becomes the winning color.
   • Payout uses the configured color multiplier, then applies the house-edge factor: effectiveMultiplier = rawMultiplier * (1 - houseEdgePercent / 100).

3. Slots

   • Each reel cell is filled independently from slots.blocks.reel-options using Java Random.
   • The configured winning block is always included in the symbol pool, even if it is omitted from the config.
   • A win is counted by matching the station's slots.blocks.winning material across the final grid.
   • For single-row stations, the total number of matching symbols is used directly. For two-row stations, the code checks top line, bottom line, diagonal, reverse diagonal, full screen, and mixed line patterns.
   • Payout is wager * multiplier, where the multiplier comes from slots.payout-multipliers and is then scaled by station size and the detected pattern.

4. Fights

   • Each fighter is selected independently from the supported zombie, skeleton, pillager, and piglin variants at round reset.
   • Weapons and armor are selected independently from the configured in-code pools. Leather armor receives a random color.
   • Each rolled item receives a random set of compatible enchantments (up to three), with a random level up to the enchantment maximum.
   • Weapon base damage, Sharpness/Smite, Power, Impaling, Fire Aspect, armor points, Protection, Projectile Protection, and Thorns all influence combat damage or retaliation.
   • Ranged attacks, including tridents, use the same isolated fighter damage path and apply armor/enchantment mitigation before health is reduced.
   • A winning bet pays bet * fights.payout-multiplier * (fighter-count / 2). The configured multiplier and fighter count determine the potential payout shown on the hologram.

5. RNG notes

   • MineGame uses Math.random() for mine placement.
   • Roulette and Slots use a shared java.util.Random instance.
   • Fighter types, equipment materials, leather colors, enchantment choices, and enchantment levels use Java ThreadLocalRandom (with compatible enchantments shuffled before selection).
   • The random rolls are generated when fighters are spawned and equipped; they are not seeded for replayable outcomes.
   • None of the games use seeded or cryptographic RNG, so results are game-random rather than replay-deterministic.

Commands

Player Commands

• Mines:

1. /minegame <mines 1-24> <wager>
2. /minegame cashout

• MineGame aliases: /mine, /mines
• Roulette:

1. /roulette <red|black|green> <amount>

• Fights:

1. /fighter <fighter-number> <amount>

MineGame Admin (mine.admin)

Primary command: /minegameadmin (legacy alias: /mineadmin)

• Station lifecycle:

1. /minegameadmin create
2. /minegameadmin remove
3. /minegameadmin regen
4. /minegameadmin list
5. /minegameadmin reload

• House accounting:

1. /minegameadmin housebalance
2. /minegameadmin housewithdraw <amount|all>

• Toggles:

1. /minegameadmin holo <on|off>
2. /minegameadmin debug <on|off>

• Public result announcements:

1. /rouletteadmin set global announcements.broadcast-win <true|false>
2. /rouletteadmin set global announcements.broadcast-loss <true|false>
3. /slotsadmin set global announcements.broadcast-win <true|false>
4. /slotsadmin set global announcements.broadcast-loss <true|false>

• Global config:

1. /minegameadmin set [global] <path> <value>
2. /minegameadmin set [global] <path> (shows current value)

• Per-station cosmetics (or all stations):

1. /minegameadmin setframe [all] <BLOCK|reset>
2. /minegameadmin sethidden [all] <BLOCK|reset>
3. /minegameadmin setsafe [all] <BLOCK|reset>
4. /minegameadmin setmine [all] <BLOCK|reset>

• Per-station casino frame (or all stations):

1. /minegameadmin casinoframe [all] <BLOCK> <pattern 1-10>
2. /minegameadmin casinoframe [all] mode <idle_only|always>
3. /minegameadmin casinoframe [all] <off|reset>

Roulette Admin (roulette.admin)

• Station lifecycle:

1. /rouletteadmin create
2. /rouletteadmin remove
3. /rouletteadmin regen
4. /rouletteadmin list
5. /rouletteadmin reload

• House accounting:

1. /rouletteadmin housebalance
2. /rouletteadmin housewithdraw <amount|all>

• Global config:

1. /rouletteadmin set [global] <path> <value>
2. /rouletteadmin set [global] <path> (shows current value)
3. Global settings override existing station overrides; for example, /rouletteadmin set global announcements.broadcast-win true

• Per-station board cosmetics (or all stations):

1. /rouletteadmin setframe [all] <BLOCK|reset>
2. /rouletteadmin setred [all] <BLOCK|reset>
3. /rouletteadmin setblack [all] <BLOCK|reset>
4. /rouletteadmin setgreen [all] <BLOCK|reset>
5. /rouletteadmin setselector [all] <BLOCK|reset>

• Per-station board size:

1. /rouletteadmin set board-size <value> while standing near a station changes that station only

• Per-station casino frame (or all stations):

1. /rouletteadmin casinoframe [all] <BLOCK> <pattern 1-10>
2. /rouletteadmin casinoframe [all] mode <always|betting_only>
3. /rouletteadmin casinoframe [all] <off|reset>

Slots Admin (slots.admin)

• Station lifecycle:

1. /slotsadmin create [3-8] [1|2]
2. /slotsadmin remove
3. /slotsadmin regen
4. /slotsadmin list
5. /slotsadmin reload

• House accounting:

1. /slotsadmin housebalance
2. /slotsadmin housewithdraw <amount|all>

• Global config:

1. /slotsadmin set [global] <path> <value>
2. /slotsadmin set [global] <path> (shows current value)
3. Global settings override existing station overrides; for example, /slotsadmin set global announcements.broadcast-win true

• Per-station cosmetics (or all stations):

1. /slotsadmin setouterframe [all] <BLOCK|reset>
2. /slotsadmin setinnerframe [all] <BLOCK|reset>
3. /slotsadmin setwinning [all] <BLOCK|reset>

• Per-station price:

1. /slotsadmin set cost-per-spin <value> while standing near a station changes that station only

• Per-station casino frame (or all stations):

1. /slotsadmin casinoframe [all] <BLOCK> <pattern 1-10>
2. /slotsadmin casinoframe [all] mode <idle_only|always>
3. /slotsadmin casinoframe [all] <off|reset>

Fights Admin (fights.admin)

Primary command: /fightadmin

• Station lifecycle:

1. /fightadmin create [odd-size] [fighters]
2. /fightadmin fighters <arena-number> <2-16>
3. /fightadmin move <arena-number> or /fightadmin move <arena-number> <x> <y> <z> (relative block offset)
4. /fightadmin remove <arena-number>
5. /fightadmin regen [arena-number]
6. /fightadmin list
7. /fightadmin holo <arena-number> [reset]

• Global Fights config:

1. /fightadmin set <path> <value>
2. Important paths include fights.max-fighters, fights.betting-seconds, fights.payout-multiplier, fights.arena-style, fights.blocks.*, fights.casino-frame-animation.*, and fights.hologram.bet-display-mode.

Join Gift

• /minegamesjoin true|false enables or disables the first-join gift.
• /minegamesjoin set <amount> changes the welcome payout.
• Seen players are stored in join_rewards.yml, so each player only receives the gift once.
• The welcome message is editable under messages.join-gift.welcome in config.yml.

Permissions

• mine.admin (default: op)
• roulette.admin (default: op)
• slots.admin (default: op)
• fights.admin (default: op)

Config Layout

• Mines:

1. board.*
2. game.*
3. announcements.*
4. effects.*
5. hologram.*
6. messages.*
7. frame-animation.*

• MineGame frame height toggle:

1. board.frame-one-higher
2. true = frame/grid one block above beacon
3. false = frame/grid at beacon level

• Roulette:

1. roulette.*
2. roulette-frame-animation.*

• Fights:

1. fights.*
2. fights.blocks.*
3. fights.casino-frame-animation.*

Distance / Activation / Hologram Settings

• Global casino frame activation distance (used by both game types):

1. casino-frame-activation-distance (default 20.0)
2. frame-animation.interval-ticks (MineGame frame animation speed)
3. roulette-frame-animation.interval-ticks (Roulette frame animation speed)

• MineGame hologram visibility:

1. hologram.view-range
2. hologram.behind-beacon-distance
3. hologram.base-height
4. hologram.line-spacing

• Roulette station activation + hologram visibility:

1. roulette.activation-distance-from-frame (players must be near frame for active spinning)
2. roulette.max-bet-distance (max distance to place bets when not standing directly on board)
3. roulette.hologram-view-range
4. roulette.hologram-height
5. roulette.hologram-line-spacing
6. roulette.hologram-title-gap
7. roulette.hologram-section-gap

• Fights arena activation + hologram visibility:

1. fights.activation-distance
2. fights.hologram-view-range
3. fights.hologram-height
4. fights.hologram-line-spacing

Hologram Placement Commands

These commands select a station by the same number shown by the corresponding list command. After running a placement command, right-click the block surface where the hologram should appear.

• MineGame: /minegameadmin hologramsign <number>
• Slots: /slotsadmin hologramsign <number>
• Roulette: /rouletteadmin hologramsign <number>
• Restore the original location: add remove, for example /slotsadmin hologramsign remove 2

Placements are persistent and stored in plugins/MineGames/holograms.yml. Holograms use fixed surface orientation and can be moved by running the assignment command again. Set hologram.see-through-walls to true or false to control wall visibility.

Notes

• set ... commands edit the nearest station when the setting is station-local, unless you use set global ... to force a global default.
• setframe/setred/... and casinoframe commands edit station overrides.
• Adding all applies cosmetic override commands to every station of that game type.
• Mines, roulette, and slots rebaseline their saved footprints when a size change would otherwise leave old blocks behind.
• housebalance/housewithdraw are admin-only (mine.admin / roulette.admin).
• housewithdraw pays the withdrawn amount directly to the admin executing the command.
• MineGame board height is controlled by board.frame-one-higher (settable via /minegameadmin set board.frame-one-higher <true|false>).
• Roulette color defaults are percent-based (48.61 / 48.61 / 2.78) and auto-scale with board size.
• Changing Roulette selector block clears old selector blocks from the selector layer before placing new ones.
• Removing MineGame/Roulette/Slots stations restores original world blocks for stations created on current versions (snapshot-based restore).
• Roulette station creation anchors the board directly under the admin's feet (replaces floor blocks there).
• Holograms are configured with no-wrap text display behavior for more consistent spacing.
• Fights support walls and fence arena styles. Fence mode is the default, uses connected spruce fences, and places the casino frame below them.
• Fights fighters target only fighters in their own arena and are isolated from outside damage, projectiles, potions, mobs, portals, pickups, fire, lava, explosions, and despawning. They drop no items or experience.
• All registered games block non-admin building inside their footprint and in the airspace above it. Lava/water buckets and fluid flow into games are cancelled, and protected game blocks cannot be damaged by explosions.
• Removing Fights stations restores captured original blocks; regen rebuilds the station from current configuration.

Storage

• plugins/MineGames/config.yml (global settings)
• plugins/MineGames/stations.yml (MineGame stations + overrides)
• plugins/MineGames/holograms.yml (per-station hologram placement overrides)
• plugins/MineGames/roulette_stations.yml (Roulette stations + overrides)
• plugins/MineGames/slots_stations.yml (Slots stations + overrides)
• plugins/MineGames/fights_stations.yml (Fights stations)
• plugins/MineGames/mines_restore.yml (MineGame original-block snapshots for restore on station removal)
• plugins/MineGames/roulette_restore.yml (Roulette original-block snapshots for restore on station removal)
• plugins/MineGames/slots_restore.yml (Slots original-block snapshots for restore on station removal)
• plugins/MineGames/fights_restore.yml (Fights original-block snapshots for restore on station removal)
• plugins/MineGames/house_balances.yml (separate MineGame/Roulette house balance + wager/payout totals)

License

GPLv3