Blackjack

Minecraft 版本： 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2

平台： bukkit paper purpur spigot

标签： adventure economy minigame

? 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

? 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