Перейти к содержимому
Mineforgian

Blackjack

A physical blackjack table plugin for Minecraft servers that creates interactive card tables in the game world. Players can join tables, place bets, and play blackjack with realistic 3D card displays.

Загрузки
2K
Подписчики
19
Обновлён
19 мая 2026 г.
Лицензия
MIT

Опубликован 25 мая 2025 г.

Исходный кодСообщить об ошибке

🃏 Blackjack Plugin

A premium physical blackjack table plugin for Minecraft servers

Create interactive card tables in your game world with realistic 3D card displays

Blackjack multiplayer gameplay image

✨ Features

🎮 Immersive Gameplay

  • Physical Card Tables: Place interactive blackjack tables anywhere in your world
  • 3D Card Displays: Realistic card animations with custom resource pack support
  • Multi-Player Support: Up to 4 players per table with seamless turn management
  • Smart Game Logic: Professional blackjack rules with dealer AI

💰 Economy Integration

  • EssentialsX Compatible: Seamless integration with your server's economy
  • Flexible Betting: Configurable bet limits and cooldown periods
  • Secure Transactions: Anti-cheat measures and bet validation

📊 Player Statistics

  • Comprehensive Tracking: Wins, losses, pushes, and streaks
  • Performance Metrics: Track your best winning streaks and total earnings
  • Persistent Data: Statistics saved across server restarts

🎨 Visual & Audio

  • Colorized Chat: Suit-based card colors (Red ♥♦, Dark Gray ♠♣)
  • Particle Effects: Customizable win/lose particle displays
  • Sound Effects: Immersive audio feedback for game events
  • Compact Interface: Clean, spam-free chat with essential information

Chat based betting for the plugin

🚀 Quick Start

Installation

  1. Download the latest Blackjack.jar from releases
  2. Place the jar in your server's plugins folder
  3. Install the required @playing_cards resource pack
  4. Restart your server
  5. Configure settings in config.yml (optional)

To merge with an existing resource pack:

  1. Download Resourceloader. (You'd be supporting me!)
  2. Merge your existing pack with the playing cards pack using the /merge feature

Basic Usage

# Create a table (Admin)
/createtable

# Join and play
/join          # Join nearest table
/bet 100       # Place your bet
/start         # Start the game
/hit           # Take another card
/stand         # End your turn
/stats         # View your statistics

🎯 Commands & Permissions

Command Description Permission
/createtable Create a new blackjack table blackjack.admin
/removetable Remove the nearest table blackjack.admin
/join Join the nearest table blackjack.play
/leave Leave your current table blackjack.play
/bet <amount> Place or change your bet blackjack.play
/hit / /stand Game actions blackjack.play
/stats [player] View statistics blackjack.play

🔌 PlaceholderAPI Integration

Blackjack includes 40+ PlaceholderAPI placeholders for extensive integration with other plugins:

  • Player Statistics: %blackjack_stats_*% (wins, losses, win rate, winnings, streaks)
  • Table Information: %blackjack_table_*% (players, status, location)
  • Game State: %blackjack_game_*% (hand value, turn status, dealer info)
  • Betting: %blackjack_bet_*% (current bets, limits, persistent bets)
  • Economy: %blackjack_economy_*% (balance, affordability checks)

📖 View Complete PlaceholderAPI Documentation

Quick Examples:

# Scoreboard integration
- "&fWin Rate: &b%blackjack_stats_win_rate%%"
- "&fAt Table: %blackjack_table_at_table%"
- "&fCurrent Bet: &6%blackjack_bet_current_formatted%"

🔌 Plugin Integration

Economy & Features

  • Vault Compatible: Works with any Vault-supported economy plugin
  • GSit Support: Auto-sit at tables when GSit is installed
  • Version Checking: Automatic update notifications for admins

⚙️ Configuration

Core Settings

# Betting Configuration
betting:
  min-bet: 10
  max-bet: 10000
  cooldown-ms: 2000

# Table Settings
table:
  max-players: 4
  max-join-distance: 10.0
  table-material: GREEN_TERRACOTTA
  chair-material: DARK_OAK_STAIRS

# Game Rules
game:
  hit-soft-17: false

# Display Settings
display:
  card:
    scale: 0.35
    spacing: 0.25

Audio & Visual

sounds:
  enabled: true
  card-deal:
    sound: BLOCK_WOODEN_BUTTON_CLICK_ON
    volume: 1.0
    pitch: 1.2

particles:
  enabled: true
  win:
    type: HAPPY_VILLAGER
  lose:
    type: ANGRY_VILLAGER

🎲 Gameplay Features

Blackjack multiplayer gameplay image 2

🃏 Card Display

  • Realistic 3D Cards: Custom resource pack with detailed card textures
  • Smooth Animations: Cards dealt with proper positioning and rotation
  • Hidden Dealer Card: Traditional blackjack dealer hole card mechanics
  • Color-Coded Suits: Red hearts/diamonds, dark gray spades/clubs

🎯 Game Flow

  1. Join Table: Players approach and join available seats
  2. Place Bets: Set your wager before the game begins
  3. Deal Cards: Each player receives 2 cards, dealer gets 1 up + 1 down
  4. Player Turns: Hit or stand to reach 21 without busting
  5. Dealer Play: Dealer follows standard rules (hits on 16, stands on 17)
  6. Payouts: Automatic economy integration with instant payouts

🏆 Results

  • Blackjack: 3:2 payout (bet × 2.5)
  • Regular Win: 2:1 payout (bet × 2)
  • Push (Tie): Bet returned
  • Loss: Bet forfeited

📈 Statistics Tracking

Track your performance with detailed statistics:

┌─────────────────────────────────────┐
│              Your Stats             │
├─────────────────────────────────────┤
│ Hands Played: 127                   │
│ Wins: 58 (45.7%)                    │
│ Losses: 51 (40.2%)                  │
│ Pushes: 18 (14.2%)                  │
│ Current Streak: 3 wins              │
│ Best Streak: 7 wins                 │
│ Total Winnings: $2,450              │
└─────────────────────────────────────┘

🔧 Requirements

  • Minecraft Version: 1.20 or higher
  • Server Software: Spigot, Paper, or compatible forks
  • Java Version: 21 or higher
  • Dependencies: EssentialsX (for economy support)
  • Resource Pack: @playing_cards

🤝 Contributing

We welcome contributions! Please feel free to:

  • Report bugs via GitHub Issues
  • Suggest new features
  • Submit pull requests
  • Improve documentation

📞 Support

Need help? Reach out:

Ченджлог

2.4Релиз26.1, 26.1.1, 26.1.2 · 19 мая 2026 г.

Blackjack 2.4

Includes all changes since the published 2.3 release.

Added

  • Per-table settings for min bet, max bet, max players, and join distance.
  • /bj createtable options for per-table settings.
  • /bj settable <setting> <value> to edit the nearest table.
  • Automatic config.yml and messages.yml updates on startup and /bj reload, with .pre-update.bak backups.
  • Full PlaceholderAPI documentation covering stats, table, game, betting, and economy placeholders.
  • /bj version and /bj tab completion.

Changed

  • All plugin commands now require /bj or /blackjack.
  • Removed standalone commands like /join, /leave, /hit, /bet, /stats, and /bjversion.
  • Updated help text, messages, clickable buttons, README examples, and plugin.yml for namespaced commands.
  • Bet limits, max players, and join distance now respect per-table overrides.
  • Improved Vault e...
2.3Релиз1.21.8, 1.21.9, 1.21.10 · 29 июля 2025 г.

Updated messages.yml

  • Every message by the plugin can now FULLY be fully translated or changed in any way!

Added automatic table leaving

  • If a player is inactive too long on a table with other players OR if they move far enough away from the table, they automatically leave the table without having to press the Leave Table button!

Added PlaceholderAPI support!

  • Several placeholders have been created for the plugin which will be listed in the plugin description!

Fixed critical bugs

  • Fixed game logic where players were losing on 21 when the dealer showed 19.
  • Fixed duplicate hardcoded messages when translation was attempted.
2.2Релиз1.21.6, 1.21.7, 1.21.8 · 20 июля 2025 г.

Added messages.yml

  • All plugin messages are now fully customizable in messages.yml allowing for easier plugin translation.

Decluttered plugin

  • Unnecessary messages and config values removed

Updated Table Leaving

  • Players can now simply walk away from tables to leave them.
  • Disconnected players also leave the table.
  • All player bets are refunded if the table is prematurely left.
  • Server owners can decide if bets should be refunded or not if a player leaves the table mid-game.

Refresh config.yml for updated keys!

2.1Релиз1.21.6, 1.21.7, 1.21.8 · 18 июля 2025 г.

Double Down added

Players can now double down on their first two cards to win (or lose) twice the amount of money they placed their bet with!

Betting GUI removed

Betting is now entirely in the chat itself without needing a GUI of any sort.

Version checker added

Admins are now notified when a new release for this plugin is released.

GSit support included

Players are now automatically seated on the chairs if GSit is detected.

Customizable quick bet amounts

Quick bet amounts in chat are now customizable in the config.yml.

Bugfixes

  • Illegal character console message no longer shows
  • Players now face the right way when joining a table
2.0Релиз1.21.6, 1.21.7, 1.21.8 · 18 июля 2025 г.

Major Features

  • Colorized Chat System - Red hearts/diamonds, dark spades/clubs with bold hand values
  • Enhanced Result Display - Clear win/loss messages with color-coded payouts

Gameplay Improvements

  • Dealer Hand Revelation - See complete dealer final hand: Dealer: ♠K ♥7 | 17
  • Smooth Game Flow - Fixed infinite loops and stuck game states
  • Bold Hand Values - Gold for 21, red for bust, green for good hands
  • Proper State Management - Clean transitions between games

Visual Enhancements

  • Suit Color Coding - Red ♥♦ and dark gray ♠♣ for instant recognition
  • Compact Messages - Essential info without spam
  • Result Highlights - PLAYER WINS! +$100 with emojis and colors
  • Professional UI - Clean, readable game interface
1.0Релиз1.21.5, 1.21.6, 1.21.7 · 25 мая 2025 г.

Blackjack

A physical blackjack table plugin for Minecraft servers that creates interactive card tables in the game world. Players can join tables, place bets, and play blackjack with realistic 3D card displays.

Features

  • Physical card tables in the game world
  • Interactive 3D card displays using custom resource pack
  • Multiple player support (up to 4 players per table)
  • Integration with EssentialsX economy
  • Player statistics tracking
  • Configurable settings
  • Particle and sound effects
  • Betting system with cooldowns

Requirements

  • Spigot/Paper 1.21.3 or higher
  • EssentialsX (for economy support)
  • Custom resource pack (@playing_cards)

Installation

  1. Place the Blackjack.jar in your server's plugins folder
  2. Install the required @playing_cards resource pack
  3. Restart your server
  4. Configure the plugin in config.yml if desired

Commands

  • /createtable - Create a new blackjack table (Admin)
  • /removetable - Remove the nearest table (Admin)
  • /join - Join the nearest table
  • /leave - Leave your current table
  • /start - Start a new game
  • /hit - Take another card
  • /stand - End your turn
  • /bet <amount> - Place or change your bet
  • /stats - View your statistics

Permissions

  • blackjack.admin - Access to admin commands (default: op)
  • blackjack.play - Access to player commands (default: true)

Configuration

The plugin is highly configurable through config.yml. You can adjust:

  • Betting limits and cooldowns
  • Table settings and materials
  • Card display positions and scaling
  • Sound and particle effects
  • Custom messages

Statistics

The plugin tracks player statistics including:

  • Hands won/lost/pushed
  • Current and best streaks
  • Total winnings

Комментарии

Загружаем…