StikSurvival

StikSurvival is a Paper/Spigot plugin with crafted books for casino games and market-style item exchanges.

For in-game items only. Do not connect wagers or payouts to real money.

Build

Requires JDK 17+ and Maven.

mvn package

Move target/StikSurvival-0.2.1.jar to your server's plugins/ folder and restart.

Admin Command

/stiksurvival reload
/stiksurvival recipes

GUI

Players must craft a reusable Gambling Menu book and right-click it to open the casino menu:

Book + Gold Nugget

Flow:

Choose game -> choose block -> choose amount -> play

Exchange Book

Players can craft an Exchange Ledger book and right-click it to trade resources through a server market:

Book + Paper

Everything is exchangeable by default, with guardrails for valuables. Exchange costs are dynamic: each material has a value, and the menu calculates the cost from the item you give and the item you receive. Restricted outputs like diamonds are only available when trading from restricted inputs. StikSurvival's special books are protected so they are not accidentally traded away as plain books.

Wagers

Players bet blocks from their inventory.

• Loss: wager is removed
• Push: wager is returned
• Win: payout uses the same block type

Default payouts:

Blackjack win:       2x
Blackjack natural:   2.5x
Roulette even money: 2x
Roulette number:     36x

Blackjack wagers are automatically refunded if the server crashes or shuts down unexpectedly.

Config

Edit plugins/StikSurvival/config.yml.

Example:

min-bet: 1
max-bet: 64

allow-all-blocks: true
blocked-blocks:
  - BEDROCK
  - BARRIER

gui:
  sign-tables-enabled: false
  menu-book:
    enabled: true
    name: "&6Gambling Menu"

books:
  use-cooldown-seconds: 1

exchange:
  allow-all-items: true
  base-rate: 4
  output-amount: 1
  # Used only if allow-all-items is false.
  materials:
    - OAK_LOG
    - BRICKS
    - WHITE_WOOL
    - WHEAT
    - IRON_INGOT
  values:
    OAK_LOG: 1
    DIAMOND: 16
    IRON_INGOT: 2
  restricted-outputs:
    - DIAMOND
    - DIAMOND_BLOCK
  restricted-inputs:
    - DIAMOND
    - DIAMOND_BLOCK

blackjack:
  natural-payout-multiplier: 2.5

Permissions:

stiksurvival.casino     use the casino book
stiksurvival.exchange   use the exchange book
stiksurvival.admin      reload config