Skip to content

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.

License

Notifications You must be signed in to change notification settings

DefectiveVortex/Blackjack

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🃏 Blackjack Plugin

A premium physical blackjack table plugin for Minecraft servers

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

✨ 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

  • Vault Compatible: Works with any Vault-supported economy plugin (EssentialsX, EconomyAPI, CMI, etc.)
  • 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)

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

Customize your blackjack experience:

# Betting & Game Settings
betting:
  min-bet: 10
  max-bet: 10000
  cooldown-ms: 2000

table:
  max-players: 4
  max-join-distance: 10.0

# Audio & Visual Effects
sounds:
  enabled: true
particles:
  enabled: true

🎲 Game Features

  • 🃏 3D Card Displays: Realistic card animations with custom resource pack
  • 🎯 Professional Rules: Standard blackjack with configurable dealer behavior
  • 🏆 Smart Payouts: Blackjack 3:2, Regular wins 2:1, automatic economy integration
  • � Statistics: Track wins, losses, streaks, and total winnings

🔧 Requirements

  • Minecraft Version: 1.20 or higher
  • Server Software: Spigot, Paper, or compatible forks
  • Java Version: 21 or higher
  • Dependencies: Vault + any economy plugin (EssentialsX, EconomyAPI, CMI, etc.)
  • 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 to us:

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


About

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.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages