1 files changed, 26 insertions, 0 deletions
diff --git a/data/help/blackjack.yaml b/data/help/blackjack.yaml
new file mode 100644
index 0000000..3e4c2c8
--- /dev/null
+++ b/data/help/blackjack.yaml
@@ -0,0 +1,26 @@
+name: blackjack
+aliases: [bj]
+category: Interaction
+related: [casino, baccarat, roulette, slots]
+description: |
+  Blackjack quick guide
+
+  play blackjack; bet 10. Beat the dealer's total without exceeding 21.
+  Aces count as 1 or 11; face cards count as 10. Busting loses even if
+  the dealer later busts. Equal totals push (return your stake).
+
+  hit / h       Take a card.     stand / st    Keep your total.
+  double / dd   Add an equal stake, take exactly one card, then stand.
+  split / sp    Add an equal stake and play a pair as separate hands.
+  surrender     If offered, give up the initial hand for half your stake.
+  insurance     Against a dealer ace, stake half your original bet on
+                dealer blackjack; usually pays 2:1. Or type decline.
+
+  Ordinary wins pay 1:1 profit. An original ace + ten-value card is
+  blackjack: normally 3:2, but some tables pay 6:5. Split-hand 21 is
+  normally an ordinary win. For a 10-credit bet, 3:2 returns 25 total.
+  Win chances depend on cards, rules and your decisions, not fixed odds.
+
+  table rules lists the actual blackjack payout, insurance payout,
+  dealer soft-17 rule, splitting restrictions and surrender availability.
+  table help shows controls; help casino explains wagers and returns.