Gambling Balance

SkillDev tools

Preserve Nypsi gambling RTP and volatility when changing Blackjack, Dragon Tower, High-Low, Mines, or gamble multiplier behavior.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Gambling Balance skill

What this skill tells your AI

The instructions your AI receives, as published by mxz7/nypsi in .agents/skills/gambling-balance/SKILL.md and read by ahel’s review.

Blackjack has approximately 98.8% base RTP under sensible no-split play. Dragon Tower uses a depth-weighted RTP curve because its shallow cash-outs are much faster and simpler to repeat, while High-Low targets approximately 95%; both offer larger maximum payouts and bonuses than Blackjack. Gamble multipliers are an earned bonus and apply to the entire winning payout; draws return the bet without a multiplier. Gambling payout multipliers above 5x still pay their full money reward but are treated as 5x by calcEarnedGambleXp() to bound single-game XP awards.

Dragon Tower

All difficulties have nine floors. Their layouts progress by total button count:

  • Easy: 4 safe out of 5
  • Medium: 3 safe out of 4
  • Hard: 2 safe out of 3
  • Expert: 1 safe out of 2

Tower payout calculations must include the expected value of the hidden gem, which adds 3x to the game payout before the gamble multiplier is applied. The rare green-gem inventory reward is globally limited and should not be treated as reliable currency RTP. Gamble multipliers always apply to profitable Tower cash-outs, including after the first floor. First-floor payouts target roughly 80% base RTP so they remain below 100% theoretical RTP with a 25% gamble multiplier. Easy's 0.93x first floor cannot be cashed out without finding the 3x gem; Medium's exact 1x first floor is a draw unless the gem is found. Floors two through nine target approximately 81%, 82%, 83%, 85%, 87%, 90%, 94%, and 97% base RTP. The rising curve rewards deeper, less common runs while keeping fast shallow cash-outs below High-Low and Blackjack. Expert's rounded 500x top is the deliberate exception at about 97.7% base RTP on its 1-in-512 completion path.

High-Low

Equal cards continue the game without increasing the correct-guess count. The first correct guess is an exact 1x draw checkpoint. Later payouts use the cumulative probability of choosing the safer direction from the actual remaining deck and a 95% house return, not an assumed 50% success chance. Payouts never decrease after a correct guess. When the calculated payout reaches at least 100x, award the actual calculated payout and immediately end the game; 100x is a stopping threshold, not a payout cap. Exhausting the deck also ends the game. High-Low professional achievement progress is awarded when a player cashes out after at least seven correct guesses.

Mines

Default Mines randomly chooses 3-6 mines and adds 0.6x per safe selection. RTP analysis must include the 3x diamond and the money bag, which is credited immediately and remains credited if the player later hits a mine. The money bag can overwrite the diamond during board generation.

When a player reveals the money bag, call addBalance() immediately without awaiting or storing its promise. Update the board interaction, then send the follow-up notification so the payout work does not delay acknowledgement.

Signals

GitHub stars
69
Forks
31
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
gambling-balance
Source
github.com/mxz7/nypsi