Joselito

Vassal
Customer

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:​


  1. Player opens Blackjack
  2. Chooses bet amount
  3. Receives 2 cards
  4. Can choose:

  • Hit → draw card
  • Stand → finish turn
  • Double Down → double bet + 1 card
  • Surrender → give up and get half bet back

  1. Dealer plays automatically
  2. 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
 

Attachments

Ідея безкоштовного доступу це добре, але тільки не за допомогою ШІ... Це навіть не тестувалося на сервері з понад 100 гравцями... Будь ласка, перш ніж робити такі очевидні речі, спочатку проведи тестування не тільки на своєму сервері, а й на серверах із реальними людьми. І припини спамити єдине, що я бачу на форумі, це дописи, створені ШІ. Створи щось своє.
 
Ідея безкоштовного доступу це добре, але тільки не за допомогою ШІ... Це навіть не тестувалося на сервері з понад 100 гравцями... Будь ласка, перш ніж робити такі очевидні речі, спочатку проведи тестування не тільки на своєму сервері, а й на серверах із реальними людьми. І припини спамити єдине, що я бачу на форумі, це дописи, створені ШІ. Створи щось своє.
A ideia de acesso gratuito é válida, e é exatamente isso que estou oferecendo com responsabilidade.
Esse mod não surgiu do nada. A primeira versão foi entregue em outubro de 2024 e vem sendo testado e evoluído desde então. Dizer que não foi testado não condiz com a realidade.
Sobre o uso de IA, trata-se apenas de uma ferramenta. O resultado final, a validação e a responsabilidade são meus. Utilizar IA não invalida o trabalho, apenas otimiza o processo para entregar algo útil à comunidade.
Se houver críticas técnicas específicas, como desempenho com mais de 100 players ou algum cenário concreto, fico totalmente aberto a discutir e melhorar. Generalizações e acusações de spam não agregam.
Meu objetivo aqui é compartilhar conteúdo funcional e gratuito. Quem quiser contribuir tecnicamente é bem-vindo, isso sim fortalece a comunidade.
 
Independentemente da forma como o código foi desenvolvido, iniciativas como essa contribuem para manter o ecossistema ativo e estimulam a experimentação dentro da pack Lucera. Nem sempre um recurso publicado precisa ser uma solução final ou perfeita; muitas vezes ele serve justamente como ponto de partida para novas ideias, melhorias e adaptações.

Acho que os russos poderiam considerar e compartilhar mais conhecimento com a comunidade.

Joselito, agradeco a contribuição
 
Back
Top