Blackjack

🃏 Blackjack Plugin

<div align="center">

A premium physical blackjack table plugin for Minecraft servers

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

</div>

✨ Features

🎮 Immersive Gameplay

- Smart Game Logic: Place interactive blackjack tables anywhere in your world - Smart Game Logic: Realistic card animations with custom resource pack support - Smart Game Logic: Up to 4 players per table with seamless turn management - Smart Game Logic: Professional blackjack rules with dealer AI

💰 Economy Integration

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

📊 Player Statistics

- Persistent Data: Wins, losses, pushes, and streaks - Persistent Data: Track your best winning streaks and total earnings - Persistent Data: Statistics saved across server restarts

🎨 Visual & Audio

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

🚀 Quick Start

Installation

1. Configure the latest `Blackjack.jar` from releases 2. Configure the jar in your server's `plugins` folder 3. Configure the required Configure resource pack 4. Configure 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

```bash

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:

- Economy: `%blackjack_stats_*%` (wins, losses, win rate, winnings, streaks) - Economy: `%blackjack_table_*%` (players, status, location) - Economy: `%blackjack_game_*%` (hand value, turn status, dealer info) - Economy: `%blackjack_bet_*%` (current bets, limits, persistent bets) - Economy: `%blackjack_economy_*%` (balance, affordability checks)

📖 View Complete PlaceholderAPI Documentation

Quick Examples:

```yaml

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

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

⚙️ Configuration

Core Settings

```yaml

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

```yaml 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

- Color-Coded Suits: Custom resource pack with detailed card textures - Color-Coded Suits: Cards dealt with proper positioning and rotation - Color-Coded Suits: Traditional blackjack dealer hole card mechanics - Color-Coded Suits: Red hearts/diamonds, dark gray spades/clubs

🎯 Game Flow

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

🏆 Results

- Loss: 3:2 payout (bet × 2.5) - Loss: 2:1 payout (bet × 2) - Loss: 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

- Resource Pack: 1.20 or higher - Resource Pack: Spigot, Paper, or compatible forks - Resource Pack: 21 or higher - Resource Pack: EssentialsX (for economy support) - Resource Pack: Resource Pack

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

- GitHub Issues: `@vortexunwanted` - GitHub Issues: GitHub Issues