mirror of
https://github.com/araxiaonline/AIO-Blackjack.git
synced 2026-06-13 03:02:26 -04:00
118 lines
4.0 KiB
Markdown
118 lines
4.0 KiB
Markdown
# 🎲 AIO-Blackjack - Araxia
|
||
|
||
[](https://github.com/azerothcore/eluna)
|
||
[](https://github.com/azerothcore/azerothcore-wotlk)
|
||
|
||
|
||
---
|
||
|
||
## 📖 Overview
|
||
|
||
This project implements a custom **Blackjack game** for [AzerothCore](https://www.azerothcore.org/) using **Eluna** and **Rochet2’s AIO** framework.
|
||
The game is hosted by an NPC named **Lord Foldemort**, and players can challenge him to Blackjack directly inside the game client.
|
||
|
||
---
|
||
|
||
## 🛠 Requirements
|
||
|
||
To run this module, you’ll need:
|
||
|
||
- [AzerothCore Server](https://www.azerothcore.org/) with [mod-eluna](https://github.com/azerothcore/mod-eluna) installed
|
||
- [Rochet2 AIO](https://github.com/Rochet2/AIO)
|
||
|
||
---
|
||
|
||
## 📦 Installation
|
||
|
||
### 1. Copy Files
|
||
|
||
#### Lua Scripts
|
||
Place both Lua scripts in your server’s `lua_scripts/` folder:
|
||
|
||
```
|
||
lua_scripts/BlackjackServer.lua
|
||
lua_scripts/BlackjackClient.lua
|
||
```
|
||
|
||
|
||
## Installation
|
||
|
||
### 1. Files to Copy
|
||
|
||
#### Lua Scripts
|
||
|
||
Copy the following Lua scripts to the appropriate directories in your server:
|
||
|
||
- **Server Script:** `BlackjackServer.lua`
|
||
- **Client Script:** `BlackjackClient.lua`
|
||
|
||
#### SQL File
|
||
|
||
Copy the provided SQL file to your server's database. This file includes the necessary entries to add the Blackjack Dealer NPC to your game world.
|
||
|
||
- **SQL File:** `Blackjack-Gambler.sql`
|
||
|
||
### 2. How to Install
|
||
|
||
1. **Place the Lua Scripts:**
|
||
- Copy the `BlackjackServer.lua` script into your server's `scripts` directory (typically found in `lua_scripts` or a similar directory).
|
||
- Copy the `BlackjackClient.lua` script into your rver's `scripts` directory (typically found in `lua_scripts` or a similar directory).
|
||
-
|
||
*NOTE: I Personally have both of my scripts in my `lua_scripts` folder.*
|
||
|
||
|
||
2. **Run the SQL Script:**
|
||
- Execute the `BlackjackDealer.sql` file on your WoW server database to add the Blackjack Dealer NPC to the game.
|
||
|
||
### 3. How the Game Works
|
||
|
||
1. **Interacting with the NPC:**
|
||
- Players can approach the NPC with ID `1000000` and select one of two options: Play Blackjack or view the Rules of Blackjack.
|
||
|
||
2. **Playing the Game:**
|
||
- Players pay an entry fee of 500 gold to start the game.
|
||
- Players can place additional bets before drawing their second card, up to a maximum of 4 cards.
|
||
- The game follows standard Blackjack rules, where the goal is to get as close to 21 as possible without going over.
|
||
|
||
3. **Winning and Losing:**
|
||
- If the player wins, they receive their bet back along with an additional 500 gold.
|
||
- If the player loses, they forfeit their bet and the game cost.
|
||
|
||
### 4. Custom Assets
|
||
|
||
This project includes custom assets (card images, sounds, etc.) inside the **`MPQ/`** folder in this repository.
|
||
|
||
#### Installation
|
||
1. Take the provided **MPQ folder** and pack it into a custom patch file (e.g. `patch-A.MPQ`).
|
||
2. Place the MPQ into your WoW client’s `Data` directory.
|
||
~~~
|
||
World of Warcraft\Data\patch-A.MPQ
|
||
~~~
|
||
3. The MPQ already contains the correct directory structure:
|
||
~~~
|
||
Interface\Cards\
|
||
Sound\Blackjack\
|
||
~~~
|
||
So you don’t need to rearrange anything.
|
||
|
||
#### Notes
|
||
- You may rename the MPQ (`patch-A`, `patch-B`, etc.) but ensure it doesn’t conflict with existing patches.
|
||
- Without this MPQ installed, card textures and sounds will not appear in-game.
|
||
|
||
|
||
|
||
|
||
### 5. Credits
|
||
|
||
- **Custom NPC Script:** Manmadedrummer, Araxia Devs
|
||
- **Assets and Sounds:** Custom Assets made by Manmadedrummer with ChatGPT
|
||
- **Annotation in scripts by _ChatGPT (I was too lazy to write them lol)_**
|
||
|
||
## 🛠 Tech Stack
|
||
|
||
- [AzerothCore](https://www.azerothcore.org/) – Open-source MMO framework
|
||
- [Eluna](https://github.com/azerothcore/mod-eluna) – Lua engine for AzerothCore
|
||
- [AIO by Rochet2](https://github.com/Rochet2/AIO) – Client-Server communication for WoW
|
||
|
||
|