🃏 Blackjack Plugin

✨ 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

🚀 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

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

• Discord: @vortexunwanted
• GitHub Issues: Report bugs/requests