Overview
This mod adds a fully functional Blackjack mini-game to Lucera, playable via NPC or Community Board.
Players can:
- Place bets using a configurable item (e.g. Adena)
- Play against a dealer with real Blackjack rules
- Use actions like Hit, Stand, Double Down, and Surrender
Key points:
- No edits to Lucera core (runs as ext.jar/mod)
- Fully configurable via .properties
- Thread-safe per-player sessions
- Built-in anti-spam (lock + cooldown)
- Supports multiple simultaneous games
- Uses HTML interface with card icons
Files included (mod)
Place these files into your Gameserver project:
- gameserver/LuceraClassicBlackJack.ext.jar
HTML files:
- data/html-en/mods/blackjack/blackjack_start.htm
- data/html-en/mods/blackjack/blackjack_bet.htm
- data/html-en/mods/blackjack/blackjack_game.htm
- data/html-en/mods/blackjack/blackjack_result.htm
- data/html-en/mods/blackjack/blackjack_rules.htm
Installation (step-by-step)
1) Add Java files
Copy:
"LuceraClassicBlackJack.ext.jar"
Into:
gameserver folder
2) Add config file
Create:
config/custom/black_jack.properties
Example configuration:
Code:
# Enable / Disable mod
BlackJack.Enabled=true
# Debug logs
BlackJack.DebugLog=false
# Deck settings
BlackJack.NumDecks=1
# Bet settings
BlackJack.BetItemId=57
BlackJack.BetItemName=Adena
BlackJack.MinBet=1000
BlackJack.MaxBet=50000
# Rewards
BlackJack.WinMultiplier=2.0
BlackJack.NaturalBlackjackMultiplier=2.5
# Bonus
BlackJack.NaturalBlackjackBonusEnabled=true
BlackJack.BonusItemId=959
BlackJack.BonusItemCount=1
# Dealer rules
BlackJack.DealerStandValue=17
BlackJack.DealerStandOnSoft17=true
# Player options
BlackJack.AllowDoubleDown=true
BlackJack.AllowSurrender=true
# Anti abuse
BlackJack.ActionCooldownMs=500
BlackJack.MaxConcurrentGames=100
3) Add HTML files
Place all HTMLs in:
data/html-en/mods/blackjack/
gameserver/data/html-en/lottery
3) Add CLIENT files
Place all utx in game folder:
yougamefolder/systextures/
5) Bind to NPC or Community Board
Example bypass:
Code:
bypass -h scripts_services.BlackjackService:playBlackjack
Gameplay
Flow:
- Player opens Blackjack
- Chooses bet amount
- Receives 2 cards
- Can choose:
- Hit → draw card
- Stand → finish turn
- Double Down → double bet + 1 card
- Surrender → give up and get half bet back
- Dealer plays automatically
- Result is calculated
Rules
- Closest to 21 wins
- Bust (>21) loses
- Dealer stands at configured value
- Soft 17 configurable
- Natural Blackjack pays bonus
Anti-abuse system
- Per-player lock (prevents double-click exploit)
- Action cooldown (configurable)
- Max concurrent games limit
Strings
No datapack edits required.
All texts are handled directly via HTML and config values.
Notes
- Split and Insurance are already prepared in config (future expansion)
- Safe reload: active sessions are cleared on reload
- Works with multiple decks
Summary
✔ Easy to install
✔ No core edits
✔ Fully configurable
✔ Safe and optimized
✔ Real Blackjack experience inside Lineage 2