浩然游戏引擎开发文档.doc

浩然游戏引擎开发文档实现windows平台下基于的2d游戏开发引擎.名称:Knight(骑士)c#开发,RUBY作为脚本语言首先你需要一个良好的编辑器这里推荐Notepad+5，网上可以下载.它内置多种语言的高亮方案,这里我们选择”XML”,点击语言,选择下面的XML.如果愿意你可以下载XML Notepad 2007,英文版,可以提供XML的树形结构.使用方法(手工方式):新建工程1.从Knight目录下的bin文件夹中复制game.exe至你要新建的工程目录下2.新建data文件夹,新建文本文档,改名为” config.xml”或”配置.xml”,用它作为配置文件 注意!两个文件只可以包含一个,否则,将会以” config.xml”当做配置文件.3.配置文件的内容为你的游戏名称你的游戏编号工程密码将用于游戏生成同样的,”main”、”name”、”password”、”ID”也可以分别用”主要”、”名字”、”密码”、”编号”来代替. 注意!游戏数据采用XML格式文件,区分大小写! 为XML声明必须出现在文件首部,且不可以以中文替代提示:虽然我们为您提供了中文的方式,但是我们仍鼓励您使用英文标注,且不希望同一个文件中同时使用中文与英文两种方式标注.你的工程密码与ID从Hawran工作室获取,用于发布与调试,错误的密码将无法完成调试.你的生成过程同样由hawran工作室完成,提交你的工程密码、ID与配置文件夹,我们会完成您游戏的生成.到这里一个工程就新建完了,运行一下吧!您看到了一个窗口,标题栏写着您的游戏名称,但内容却是一片空白,为什么会这样呢?请看下一节.地图1.在data文件夹内新建map文件夹2.mp文件夹内新建 文本文件 命名为( “map”+编号+”.xml”)的形式,内容为你的地图名称你的游戏编号你的地图底层文件名你的地图遮罩层文件名你的地图通行层文件名运行试试,如你所见还是一片黑,应该怎么办呢?打开”config.xml”在与添加”你的地图ID“.再次运行我们发现游戏画面已经出现了一张地图.注意,地图文件要放在” Graphics/maps”文件夹中让我们为游戏增加主角.Data文件夹中新建 actors.xml,内容为 你的角色名称 你的角色行走图文件名你的角色头像文件名修改你的地图ID为你的地图ID再次运行,你的角色就出现在地图上了,并且可以使用方向键与鼠标控制.NPC与事件打开地图文件,修改代码你的地图名称你的游戏编号你的地图底层文件名你的地图遮罩层文件名你的地图通行层文件名 你的npc名字你的npc行走图文件名 event “message”,”hello,world!”运行游戏,地图上出现了NPC,走过去按空格或用鼠标点击它,就出现了对话框”hello,world”,那么如何才能有两个事件页呢?请看实例代码test0btth npcnDef n_ com() If (得到某物品) #这是伪代码Return “0”ElseReturm “1”Endend event “message”,”hello,world!” event “message”,”goodbye,world!”程序每次都会运行 NPC名字_com这个方法,根据他的返回值来决定运行那个事件页,特别的,com事件无需设置事件页.这段代码的意思是说,如果获得了某物品,那么就执行事件页1，也就是显示”goodby,world!”否则就执行事件页0，也就是显示”hello,world!”event “message”,”goodbye,world!”我们知道上面这行脚本的作用是显示对话,那么具体是怎么回事呢?下面为您分析”事件指令解析器”.事件指令解析器机制为了游戏的安全性与开发者的方便性已经可扩展性,Knight引擎不直接使用ruby方法来执行事件指令,而是采用事件指令解析器机制,该机制调用引擎内部函数来完成事件指令的运行.事件指令解析器的调用 方法为 event 指令,参数1，参数2,参数n其中 指令与参数均为字符串(型string),返回值为布尔型(bool)即返回一个true或false,参数是可选的,同时也不限定参数的数量.上文提到的event “message”,”goodbye,world!”即表示运行”message”指令,参数为”goodbye,world!”再看一个例子event “setActor”,”hp”,”+”,”100”这个事件指令的意思是设置角色的hp增加100。,它有3个参数,分别对应要修改的属性(“hp”)、修改方式(“+”)和修改值(“100”),其实刚才那个event “message”,”goodbye,world!”也不仅仅这么点功能,他的完整声明是event “message”,对话内容,对话者姓名,头像文件名,位置,是否透明它应当有5个参数,但是我们却只给