2019独角兽企业重金招聘Python工程师标准>>>

21点游戏 v0.1.0

这是一个纸牌的赌博游戏。

这个游戏的规则：每个玩家分别与庄家比点数，但是又不能超过21点。这是最原始，最简单的规则。但是发展到现代。游戏的规则已经变得复杂了很多。比如双倍下注、分牌、五龙等这样例牌的出现。

具体规则可以在维基百科上搜索“21点”。

架构目标

它们的架构与功能是完全独立的。这意味着我们在构建系统时，应该选择最符合当前需求的架构，并在该架构的框架下实现功能。——《恰如其分的软件架构》

虽然这个21点看似简单，其实不然。当然，如果你只是想实现一个只有最简单21点游戏，而不考虑可扩展性、可维护性，你大可使用一个大大的if-else实现。这也算是一种架构。

如果你的目标是：当QQ游戏需要添加21点游戏时，只要在你21点游戏底层库上做些配置就可以直接用了（在写本文时，我真不知道QQ游戏到底有没21点游戏）。或者某家在线赌博网站想运营一个21点游戏，拿来你的21点游戏底层库，在上面进行配置或扩展，就可以直接用了。

说得再细一些。有些赌场对于Blackjack是3倍赔率，而有些是2倍。有些赌场允许分牌后再分，有些则不允许。有些赌场只允许在首两张牌时进行加注，而有些赌场允许在任何时候进行加注。

而敝人也希望这个底层库尽可能实现所有的场景。

难点及解决方案

难点在于21点游戏的规则没有标准，每个赌场的规则都可能不同。而我们写出的程序必须应对所有的变化。

解决方案是

实现21点游戏的领域特定语言，各个赌场只需要修改领域特定语言就可以，而不需要关心具体实现技术
将游戏中相关稳定的部分（如游戏流程，开牌每人手上都会有两张牌）固化下来，使用java实现。而游戏中变化的部分使用动态语言实现。

而我采用的是第二种解决方案。

分析与设计

首先要知道21点的游戏流程是不会变的，而变的则是例牌的设置、例牌的赔率，而且同一例牌的规则也可能会不同。

所以，游戏流程可以写死，而例牌方面直接使用动态语言Groovy来实现。

设计中有几个重要的概念需要介绍，这样有利于了解我的设计与架构：

玩家(player)：首先庄家有可能是人，也有可能是机器。所以，不论机器或人，在赌桌上所有的人、机器都是玩家。当赌局里的庄家是随机的时候，意味着所有的玩家都可能做庄家。

玩家代理(playerProxy)：有些规则是允许一个玩家下多门注的。所以，我们抽象出玩家代理这个概念。实际掌握手上牌和赌注的是玩家代理。玩家的所有的操作实际上都是由玩家代理执行。这样就可以解决一个玩家有多门注，及分牌的问题。

庄家代理(dealerProxy)：当一个玩家做了庄家，那么他在赌局中实际是通过庄家代理来完成操作。

牌型(cardCategory)：牌型指的是手上牌所符合的模式。比如首两张牌组成21点，那么这手牌的牌型就是Blackjack。由于赔率很大程度与牌型及玩家操作决定，而且每个赌场的规则又不一样。所以，这部分使用Groovy实现。

玩家操作(playerAction)：玩家在游戏中只有有限的几个操作：要牌（hit），停牌（stand）等。所以，这部分，直接使用java实现。

银行(bank)：这是对赌场中钱的管理人的一个抽象。统一管理所有的钱、判断玩家是否还有足够的钱进行加注等。

赌桌(tables)：玩家加入赌桌进行赌博。而赌桌则是所有玩家玩牌的接口。

使用Groovy来实现的好处有：

实时修改游戏规则（例牌等），不需要重启服务器
提高程序的可扩展性
提高游戏的可配置性

为什么不使用XML来配置呢？

鉴于很多人喜欢使用XML做配置文件，我的想法如下：

XML对于游戏规则的表达力不够
还需要自己写解释器，注意，这个解释器并不是JDOM这样的库，而是指语义解释器。而且，使用java处理XML，你懂的～
为什么还有多一层解释呢？配置即执行不多好？目前ROR，Gradle，Vagrant也都是配置即执行。
本人不喜欢XML的哆嗦

当然，如果你希望实现一个使用XML配置的，那也可以。本库的扩展非常好。只需要改WinnerLoserCalculateEngine这个输赢计算引擎就可以了。

关于例牌

由于例牌是21点中最大的变化，而且各类繁多。所以，我有必要在这里说明一下，哪些例牌是我已经实现并测试了的。

已经实现了的

保险保险与玩家下的筹码是独立的。是单独结算的。 所以分牌时，保险金不会分
Blackjack：开牌后就得到了21点（一张面牌为10的牌，一张A）
分牌(split) ：玩家首两张牌的点数相同，则可以选择分牌，并须加注。分出的每门的下注金额须与原注相同。 注：有些赌场可分牌后再分，有些则不能
双倍下注: 发牌后，玩家手上两张牌的点数加起来有11点，就可以进行双倍下注。但是双倍下注后，只能要一张牌。
过五龙：玩家或庄家手上的牌超过了5张，但还没有爆牌的情况。
同花顺: 玩家手上有三张牌：牌色相同，面值分别是6,7,8的情况。

实际上，你可以发挥你的想像来实现你的例牌。比如，当庄家为Blackjack而玩家为五龙，则为打平等等。

未实现的操作

投降(surrender) 首两张牌可以投降，其他情况不可以投降。投降后，玩家只可以拿回原来赌注的一半。
Ace分牌(AceSplit)：这是分牌的特例。当玩家首两张牌都是A牌时，可以选择分牌，但是分牌后只能得到一张牌。
退出

分层

在这里，你看不到什么MVC这样的分层方式。是因为我们这个库目前做的事情就是21点最核心的业务。所以MVC这样的分层方式不适合。目前，你也看不到关于持久化的内容。因为，一持久化是客户的事情，二我目前还没有时间写一个默认的实现。

Blackjack-core 核心包

这是一个核。实现目标是将21点游戏的业务逻辑集中在这个核内。

它可以做什么：

技术上：
1. 提供方便，简单的接口
2. 可自定义你的例牌及赔率，并且是实时的，不需要重启服务器
3. 洗牌算法的可替换
业务上：
1. 庄家可以是真人，也可以是机器
2. 支持一个玩家可以下多注
3. 未限定投注大小，注的限额，我觉得不是21点游戏的核心问题，所以，不实现。
4. 可以设置保险的赔率

它不可以做什么：

不可以持久化:玩家数据，金钱数据都存在内存里
不提供界面
发牌时的那种一张牌，一张牌的显示的那样的效果。那不应该是核心业务问题。

Blackjack-server 服务器端

目前还没时间做

关于持久化

目前，关于持久化的工作几乎为0。因为我在游戏开发方面没有经验，有一些问题没有想清楚。

游戏过程的数据是否需要持久？游戏过程是指记录下玩家的每张出牌，每次的操作。这个过程，我觉得1.完全没有必要；2.性能上的问题。
游戏中的金钱问题关于钱的数据当然要持久化了。而且，在设计上要求非常的高。在这方面的我经验也不足。需要从别人系统学习后再设计。

要解决的问题

如何实现全自动化测试？也就是不需要任何的mock。玩家自动玩牌。
如果没有实现自动化测试，那么也就没有测试并发情况也会发生什么。
Groovy脚本配置的带来的安全问题

如何阅读代码

有一个CasinoTest测试类。测试类模拟的是一场简单的赌博。从中可以看出如何使用此核心库。

下面是跑测试时的输出：

	12:33:54.568 [main] INFO  c.z.blackjack.core.CasinoTest - 三名玩家分别存入赌场
	12:33:54.573 [main] INFO  c.z.blackjack.core.CasinoTest - 甲 存入：400.0
	12:33:54.576 [main] INFO  c.z.blackjack.core.CasinoTest - 乙 存入：400.0
	12:33:54.577 [main] INFO  c.z.blackjack.core.CasinoTest - 丙 存入：400.0
	12:33:54.580 [main] WARN  c.z.blackjack.core.CasinoTest - 三名玩家加入赌桌:1
	12:33:54.584 [main] INFO  c.z.blackjack.core.CasinoTest - 选举出庄家为：甲 
	12:33:54.586 [main] INFO  c.z.blackjack.core.CasinoTest - 玩家乙 下注：20
	12:33:54.586 [main] INFO  c.z.blackjack.core.CasinoTest - 玩家丙 下注：20
	12:33:56.154 [main] INFO  c.z.blackjack.core.CasinoTest - *****开始******
	12:33:56.154 [main] INFO  c.z.blackjack.core.CasinoTest - 乙 手上的牌，点数：[20] 分别为：[{SPADE-Q}, {SPADE-K}]
	12:33:56.154 [main] INFO  c.z.blackjack.core.CasinoTest - 丙 手上的牌，点数：[17] 分别为：[{HEART-J}, {HEART-7}]
	12:33:56.236 [main] INFO  c.z.blackjack.core.CasinoTest - 乙 停牌，点数：20，分别为：[{SPADE-Q}, {SPADE-K}]
	12:33:56.319 [main] INFO  c.z.blackjack.core.CasinoTest - 丙 停牌，点数：17，分别为：[{HEART-J}, {HEART-7}]
	12:33:56.320 [main] INFO  c.z.blackjack.core.CasinoTest - 庄家甲 点数为14不足17点
	12:33:56.474 [main] INFO  c.z.blackjack.core.CasinoTest - 庄家要牌，最后点数：[24] 牌为：[{HEART-6}, {HEART-8}, {DIAMOND-K}]
	12:33:56.474 [main] INFO  c.z.blackjack.core.CasinoTest - **********所有玩家停牌，开始结算
	12:33:56.737 [main] INFO  c.z.blackjack.core.CasinoTest - 乙  下注 20.0 赢家为PLAYER 最后余额：420.0
	12:33:56.817 [main] INFO  c.z.blackjack.core.CasinoTest - 丙  下注 20.0 赢家为PLAYER 最后余额：420.0
	12:33:56.817 [main] INFO  c.z.blackjack.core.CasinoTest - 庄家甲  最后余额:360.0
	12:33:56.818 [main] WARN  c.z.blackjack.core.CasinoTest - *******结束

附录

保险规则配置

配置文件为类路径下：Insurance.groovy

例子

  //玩家赢时将得到的彩金
  winMoney = playerFirstBet * 2

结算相关配置

实质是配置根据玩家的牌型及庄家的牌来计算输赢，并返回赔率
配置文件为类路径下：Settlement.groovy

例子

  //如果玩家赢，赢多少
  winMoney = 0

  switch (playerCardCategory) {
  //同花顺
      case "royal":
          winner = PLAYER
          winMoney = playerBetSum * 3
          break
      case "Blackjack":
          switch (playerLatestAction) {
              case stand:
                  if (isDealerBlackjack) {
                      winner = PUSH
                  } else if (!isDealerBlackjack) {
                      winner = PLAYER
                      winMoney = playerBetSum * 3
                  }
              default:
                  winner = PLAYER
                  winMoney = playerBetSum * 3
                  break
          }
          break
      case "fiveCard":
          winner = PLAYER
          winMoney = playerBetSum * 3
          break
      case "bust":
          winner = DEALER
          break
      default:
          //庄家爆牌
          if (dealerSumPoint > 21) {
              if(playerSumPoint <= 21){
                  winner = PLAYER
                  winMoney = playerBetSum * 1;
                  break
              }

              if (playerSumPoint > 21) {
                  winner = PUSH
                  winMoney = 0
                  break;
              }

          }else{
              if (playerSumPoint > dealerSumPoint) {
                  winner = PLAYER
                  winMoney = playerBetSum * 1
              } else if (playerSumPoint < dealerSumPoint) {
                  winner = DEALER
              } else {
                  winner = PUSH
              }
          }
          break
  }

牌型配置

实质是根据玩家手上的牌，计算出手上牌所属的牌型
配置文件为类路径下：Special.groovy

例子

  switch (_headCard.cardCount) {
      case 2:
          if (_headCard.sumPoint == 21) { // 首两张牌点数为21点时是Blackjack
              name = "Blackjack"
              actions = [_report]
          } else if (_headCard.sumPoint == 11) {  // 首两张下牌点数等于11点时可以双倍下注
              name = "doubleDown"
              actions = [_hit, _stand, _doubleDown]
          } else if (_headCard.isFirstTwoCardPointEquals()) { //首两张牌的面值相同，可进行分牌
              //设置分牌后不可以再分。
              if (_headCard.isSplit()) {
                  return
              }
              name = "split"
              actions = [_hit, _stand, _split]
          }
          break
      case 3:
          // 同花顺
          if (_headCard.containsAllCardFace(6, 7, 8) && _headCard.isCardFaceIdentical()) {
              name = "royal"
              actions = [_report]
          }
          break
      case 5:
          if (_headCard.sumPoint <= 21){
              name = "fiveCard"
              actions = [_report]
          }
          break
  }

  // 爆牌
  if (_headCard.sumPoint > 21) {
      name = "bust"
      actions = [_stop]
  }

在配置脚本中可以使用的变量：

  binding.setVariable("PLAYER", Winner.PLAYER);
  binding.setVariable("DEALER", Winner.DEALER);
  binding.setVariable("PUSH", Winner.PUSH);

  binding.setVariable("playerBetAmounts", playerProxy.getBet().getBetAmounts());
  binding.setVariable("playerFirstBet", playerProxy.getBet().getBetAmounts().get(0));
  binding.setVariable("playerBetSum", playerProxy.getBet().getBetSum());
  binding.setVariable("playerLatestAction", playerProxy.getLatestActionName());
  binding.setVariable("isPlayerBlackjack", playerProxy.isBlackJack());
  binding.setVariable("playerCardCategory", playerProxy.getCardCategoryName());
  binding.setVariable("playerSumPoint", playerProxy.getSumPoint());
  binding.setVariable("playerCardCount", playerProxy.getHeadCard().getCardCount());
  binding.setVariable("dealerCardCategory", dealerProxy.getCardCategoryName());
  binding.setVariable("dealerSumPoint", dealerProxy.getSumPoint());
  binding.setVariable("dealerCardCount", dealerProxy.getHeadCard().getCardCount());
  binding.setVariable("isDealerBlackjack", dealerProxy.isBlackJack());
  binding.setVariable(StandAction._name, StandAction._name);
  binding.setVariable(HitAction._name, HitAction._name);
  binding.setVariable(ReportAction._name, ReportAction._name);
  binding.setVariable(DoubleDownAction._name, DoubleDownAction._name);
  binding.setVariable(SplitAction._name, SplitAction._name);
  binding.setVariable(StopAction._name, StopAction._name);
  binding.setVariable(SurrenderAction._name, SurrenderAction._name);

这是虚拟玩游戏时的打印。运行CasinoTest.java就可以了

12:35:31.278 [main] INFO c.z.blackjack.core.CasinoTest - 三名玩家分别存入赌场 12:35:31.283 [main] INFO c.z.blackjack.core.CasinoTest - 甲存入：400.0 12:35:31.285 [main] INFO c.z.blackjack.core.CasinoTest - 乙存入：400.0 12:35:31.286 [main] INFO c.z.blackjack.core.CasinoTest - 丙存入：400.0 12:35:31.289 [main] WARN c.z.blackjack.core.CasinoTest - 三名玩家加入赌桌:1 12:35:31.292 [main] INFO c.z.blackjack.core.CasinoTest - 选举出庄家为：丙 12:35:31.293 [main] INFO c.z.blackjack.core.CasinoTest - 玩家甲下注：20 12:35:31.293 [main] INFO c.z.blackjack.core.CasinoTest - 玩家乙下注：20 12:35:32.761 [main] INFO c.z.blackjack.core.CasinoTest - 开始* 12:35:32.762 [main] INFO c.z.blackjack.core.CasinoTest - 甲手上的牌，点数：[11] 分别为：[{HEART-2}, {DIAMOND-9}] 12:35:32.762 [main] INFO c.z.blackjack.core.CasinoTest - 乙手上的牌，点数：[15] 分别为：[{DIAMOND-Q}, {SPADE-5}] 12:35:33.092 [main] INFO c.z.blackjack.core.CasinoTest - 甲双倍下注，最后点数：[20]，牌为：[{HEART-2}, {DIAMOND-9}, {DIAMOND-9}] 12:35:33.233 [main] INFO c.z.blackjack.core.CasinoTest - 乙停牌，点数：15，分别为：[{DIAMOND-Q}, {SPADE-5}] 12:35:33.233 [main] INFO c.z.blackjack.core.CasinoTest - 庄家丙点数为11不足17点 12:35:33.322 [main] INFO c.z.blackjack.core.CasinoTest - 庄家要牌，最后点数：[20] 牌为：[{DIAMOND-8}, {SPADE-3}, {DIAMOND-9}] 12:35:33.322 [main] INFO c.z.blackjack.core.CasinoTest - **********所有玩家停牌，开始结算 12:35:33.536 [main] INFO c.z.blackjack.core.CasinoTest - 甲下注 40.0 赢家为PUSH 最后余额：400.0 12:35:33.593 [main] INFO c.z.blackjack.core.CasinoTest - 乙下注 20.0 赢家为DEALER 最后余额：380.0 12:35:33.594 [main] INFO c.z.blackjack.core.CasinoTest - 庄家丙最后余额:420.0 12:35:33.594 [main] WARN c.z.blackjack.core.CasinoTest - *******结束

一个21点游戏的设计与实现