《魔兽世界插件》教程---21点扑克游戏 Blackjack

1.效果图

因为我是新手，只能做一个非常简单的插件，21点扑克游戏。比较有趣吧，插件也可以做一个游戏？游戏中的游戏！

2.编写魔兽世界插件准备

1. 首先你要一个最新的魔兽世界客户端，我的有26G大小。记得要申请一个试玩账户，试玩账户不会消耗游戏时间，可不能用正常账户，那调试代码烧点卡烧的厉害！
2. 用什么编辑器呢？魔兽世界插件大部分是Lua,一部分是XML，SciTE比较适合Lua，但我感觉用NotePad++比较好。前期可能要用下一个大型的编辑器叫"AddOn Studio for World of Warcraft",有点像VS。它用来调试XML不错。
3. 还要准备3个第三方魔兽世界插件来帮助我们!BugGrabber,BugSack,TinyPad。前面两个是调试用的，如果我们写的插件有错误的话会提示第几行，什么错误。TinyPad是一个游戏内记事本功能的插件，可以在里面写Lua脚本，直接游戏运行，当我们要测试少量的wow API比较有用
   
4. 看完《Programming in Lua, 3rd Edition》和《Beginning Lua with World of Warcraft Add-ons》(真的看完就不用往下看这篇教程了=。=，对英语阅读有一定要求，但不难)
5. 比较有用的网站,www.google.com, www.wowwiki.com。暴雪是没有公布插件API的，只能google了。

总结下跟一般的编程一样的。

运行效果查看:魔兽世界客户端+试玩账户

编辑器：首推NotePad++,SciTE，AddOn Studio

调试：!BugGrabber,BugSack,TinyPad + print("") ,print 可以在游戏中打印日志，我们可以打印变量来调试。

教程：《Beginning Lua with World of Warcraft Add-ons》 

当然不能每次重启魔兽世界客户端来看修改效果，我们可以做一个简单的宏来重载所有UI，当你修改了你的插件的XML或者Lua文件时，可以重载所有UI来看到修改效果。当然Shift+点击BugSack也有同样的效果。修改toc或者新增图片，音乐资源是不能靠重载UI来生效的，要重启魔兽世界客户端。

3.还是先写一个插件版的Hello World吧

把上面提到的三个插件!BugGrabber,BugSack,TinyPad，google下，都下载下来。拷贝到\Interface\AddOns 目录下。进入游戏，输入/pad 就可以打开TinyPad了，我们输入print("Hello World"),再点击上面的菜单有个功能是run this page as a script，就可以看到效果了。

4.写一个简单插件界面吧

点击Click按钮就会调用我们一个Lua函数，点击Close，整个界面就会隐藏。

这次是一个完整的插件，名字叫testButton，包括三个文件:

Frame.lua  -- 用来存放脚本

Frame       -- 用来描述界面,以XML编写

testButton.toc -- 用来描述我们的插件，比如插件支持的魔兽世界版本，插件名字，插件作者，插件包含文件等等。

先来看下testButton.toc

## Author: Walle
## Interface: 50400
## Title: testButton
## Version: 1.0
Frame.xml
Frame.lua

<Ui xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.blizzard.com/wow/ui/">

	<Frame name="Frame1" parent="UIParent" toplevel="true" enableMouse="true" movable="true" clampedToScreen="true">
		<Size>
			<AbsDimension x="200" y="200" />
		</Size>
		<Anchors>
			<Anchor point="CENTER">
				<Offset x="-35" y="34" />
			</Anchor>
		</Anchors>
		<Backdrop bgFile="Interface\DialogFrame\UI-DialogBox-Background" edgeFile="Interface\DialogFrame\UI-DialogBox-Border" tile="true">
			<BackgroundInsets>
				<AbsInset left="11" right="12" top="12" bottom="11" />
			</BackgroundInsets>
			<TileSize>
				<AbsValue val="32" />
			</TileSize>
			<EdgeSize>
				<AbsValue val="32" />
			</EdgeSize>
		</Backdrop>
		<Frames>
			<Button name="BtnClose" inherits="UIPanelButtonTemplate" text="Close">
				<Size>
					<AbsDimension x="75" y="23" />
				</Size>
				<Anchors>
					<Anchor point="TOPLEFT">
						<Offset x="69" y="-134" />
					</Anchor>
				</Anchors>
				<Scripts>
				   <OnClick>
					  self:GetParent():Hide()
				   </OnClick>
				</Scripts>
			</Button>
			
			<Button name="BtnClick" inherits="UIPanelButtonTemplate" text="Click">
				<Size>
					<AbsDimension x="75" y="23" />
				</Size>
				<Anchors>
					<Anchor point="TOPLEFT">
						<Offset x="69" y="-100" />
					</Anchor>
				</Anchors>
				<Scripts>
				   <OnClick>
				      BtnClick()
				   </OnClick>
				</Scripts>
			</Button>
		</Frames>
		<Scripts>
		    <OnLoad>
			    self:RegisterForDrag("LeftButton")
			</OnLoad>
            <OnDragStart>
			    self:StartMoving()
			</OnDragStart>
			<OnDragStop>
			    self:StopMovingOrSizing()
			</OnDragStop>
		</Scripts>
	</Frame>
	
</Ui>

这个XML看起来有点复杂，可以用Addon Studio 建一个项目，拖个按钮进去，玩玩。就大致了解上面的东西了。无论是Frame还是Button等都有大小用下面的来表示一个200x200的。

 </Size>

Anchors 来表示位置。point可以设置CENTER,TOP,LEFT等等，下面的Offset是偏移量,比如你设置了CENTER,那么-35就是中心偏左35。

<Anchors>
            <Anchor point="CENTER">
                <Offset x="-35" y="34" />
            </Anchor>
        </Anchors>

Backdrop表示Fram的边框，直接从Addon Studio抄下来。

我们注意到Button有个属性是inherits,继承的意思

inherits="UIPanelButtonTemplate" 这里表示简单的继承了WOW原生的按钮样式，按钮可以设置非常复杂的样式，这里不再赘述，大家可以参考WOW API。

XML中都可以加脚本，比如这里：

<Scripts>
                   <OnClick>
                      self:GetParent():Hide()
                   </OnClick>
  </Scripts>

它的效果就是简单的使整个都隐藏起来。

我们对整个Frame还增加了拖动效果。

还有必须说明的是一般用XML能实现的，直接用Lua代码也可以的。

比如设置宽度，高度，可以这样写：

Frame1:SetWidth(500)

Frame1:SetHeight(500)

大家可以在tinypad中，执行看下效果。不单单是改变属性，创建一个按钮也可以用Lua代码的。大家可以去Google。

最后看下Frame.lua

它里面就是一个简单的function：

function BtnClick()
    print ("BtnClick")
end

testbutton项目下载： http://www.waitingfy.com/?attachment_id=1058

function GetTotalValue(cards)
   local containAce = false              --//变量用local关键词,没有local就是全局变量
   local totalValue = 0
   local anotherTotalValue = 0
   for i, v in ipairs(cards) do          --//for 循环
       totalValue = totalValue + v.value
	   if v.value == 1 then          --//if 列子
	      containAce = true
	   end                           --//if 结束
   end                                   --//for 循环结束
   if containAce then
      anotherTotalValue = totalValue + 10 --// change Ace's value to 11
   end
   
   if containAce and anotherTotalValue <= 21 then 
      return anotherTotalValue
   end
   
   return totalValue
end

POKER_CARD_NAME = "%s of %s"
POKER_CARDS = {            --//Table好像内部是一个hashtable，所以可以这样用。这样POKER_CARDS["K"] 就== "King"了
	K = "King",
	Q = "Queen",
	J = "Jack",
	["10"] = "Ten",
	["9"] = "Nine",
	["8"] = "Eight",
	["7"] = "Seven",
	["6"] = "Six",
	["5"] = "Five",
	["4"] = "Four",
	["3"] = "Three",
	["2"] = "Two",
	A = "Ace",
}
POKER_SUITS = {
	H = "Hearts",
	D = "Diamonds",
	C = "Clubs",
	S = "Spades",
}
local ranks = {"K", "Q", "J", "10", "9", "8", "7", "6", "5", "4", "3", "2", "A"} --//也可以直接初始话这样，index是用1开始的比较奇怪。
local suits = {"H", "D", "C", "S"}
local cards = {}
local cardsByRank = {}

local value = 10
for i, r in ipairs(ranks) do
	cardsByRank[r] = {}
	for i, s in ipairs(suits) do
		cards[#cards + 1] = {  --// #cards可以得到cards这个table的长度，这里每个card又是一个table
			rank = POKER_CARDS[r],
			suit = POKER_SUITS[s],
			name = POKER_CARD_NAME:format(POKER_CARDS[r], POKER_SUITS[s]), --//string类型中有简单的format语法
			code = r..s,
			value = value
		}
		cardsByRank[r][s] = cards[#cards]
	end
	if i >= 4 then
	   value = value - 1
	end
	
end