COSMOSBOX手遊制作手册（Word备份）

20140712版

版本号

Version

日期

Date

作者

Author

变更主要原因描述

Brief Description

1.0

2014-4-26

陈霈霖

初稿

2.0

1. 前言

本手册撰写目的是整体上的介绍整个制作流程，并不过多详述细节，具体功能要咨询具体人员。

2. COSMOSBOX工程目录解析

2.1 目录解析

工程目录

工程由两个库组成，

SVN库(https://cosmosbox/svn/cosmosbox/trunk) SVN库存放代码、零散美术源文件、策划内容，使用SVN上传；

l cb-scheme策划库,cb-client客户端, cb-product产品

l AIStudio  AI编辑器

l ArtResources 美术资源，未整理的零散资源

l Cb-product 产品库、编译的客户端、服务器

l Tools 工具脚本，忽略

Cb-art美术工程库：存放用于正式产品使用的Unity序列化游戏对象，使用Unity的Asset Server进行资源管理上传；从Unity Asset Server取cb-art美术库到svn库内(如果Unity安装在C盘双击”_首次来这里安我”会自动完成)，最终工作目录如右图

游戏运行时程序、策划、美术的结合

正式的游戏客户端，读取策划表，根据填表内容布置关卡（关卡是一个美术资源）、放置怪物（怪物是一个美术资源）、施放技能（技能是填在表里的）。

Spine源文件的转变方式

SVN的ArtResources里的SpineProject是美术制作的源文件，cb-art美术工程库会读取这个目录，生成Unity直接可用的Prefab和图集，然后经由打包，供客户端使用。

定时打包机制

每天凌晨，服务器会自动执行cb-art的打包程序，将Unity美术Prefab打包成AssetBundles，同时将游戏客户端打包成ipa、apk和exe程序，第二天回来就能测试昨天的工作是否有问题。

如何运行游戏PC版

运行cb-product目录ClientX86D_640_960.bat，这是640*960像素的客户端，模拟iPhone 4的屏幕大小。

如何安装iOS/Android手机版游戏

在cb-product目录下的ClientIOS.ipa是iOS客户端；在cb-product目录下的Client.apk是Android客户端；怎么装入手机你懂的。。。

游戏配置表

在cb-scheme目录下的setting/目录里的excel表全是游戏配置表

3.
软件环境推荐

3.1 基础软件

3.1.1 常用网址

共享文件路径：\\COSMOSBOX\Share

SVN地址(https://cosmosbox/svn/cosmosbox/trunk)

3.1.2 必备基础工具

WPS 或Office2013+OfficeTab

Beyond Compare

Total Commander程序开发环境推荐

TortoiseSVN 版本控制

3.2 程序开发环境推荐

3.2.1 开发环境（以下工具安装到默认路径，即C盘为主）

Windows7 x64 SP1

VisualStudio 2012（打最新版Update补丁，目前是Update3）

Unity3D 4.5.1 + UnityVS1.2

AndroidSDK_x86

WebStorm 8.0.1

3.2.2 VisualStudio中C#开发设置

4. 常用英语单词

规范日常沟通用的英语单词，最崇高的目标是：会英语就会看我们的程序代码。

英文

中文

英文

中文

Id

配置表的编号，只在策划填表时用

ObjectId

程序类实例ID

TypeId

原型ID，配置表ID

LogicId

服务器/客户端通讯对象编号

UId

User ID，用户编号，非UniqueID

Rank

玩家（人）等级

Actor

怪物，NPC，非玩家

Obstalce

障碍 (本质是一个Actor)

Hero

玩家英雄

Trap

陷阱，一种Actor，触发功能

Effect

特效

Player

玩家本人

Boss

关卡大佬

Skill

技能

Map/Level

地图/关卡 （制作时常混用，程序实现会自动加以区分）

Bullet

子弹，技能发出的碰撞物

UI

用户界面

Buff

游戏中的状态魔法

Coin

游戏币

Trigger

程序里的触发器，有一系列特殊函数

Gem

宝石

Money

人民币

Texture

纹理，实质就是图片!(不用Picture)

Scene

场景，少用

Sprite

精灵，游戏里的一个图片单元

Weapon

武器/饰物/装备

Battle

战役，关卡里的一小段

Level

关卡，包含许多战役

Hit

被击，非撞击，包括远程子弹击中

Strike

撞击

Power Up

强化

Evolution

进化

Fusion

合成

Team

队伍

Member

队伍的成员

5. 明确工作职责

策划

美术

程序

机器人

关卡制作

美术设计

维护游戏核心demo

美术资源自动产品化

资源/物品

命名规范制定

美术资源

命名与入库

开发游戏客户端

策划表资源自动产品化

系统设定文档

UI面板拼接

开发游戏服务器

代码自动产品化

数值调整

动画制作

开发自动化机器人

UI面板自动产品化

6. 美术制作说明

6.1 基准说明

标准作图像素：640*960

项目使用到的游戏引擎与工具

2D Toolkit （Unity3D 2D插件，内置自动图集生成功能，内置帧动画制作工具）

NGUI (Unity3D UI插件， 内置自动图集生成功能，大量UI控件）

Texture Packer 图片集生成器，供上述插件共享图库

Spine 骨骼动画制作工具，兼用作制作帧动画特效

图片类型

图片规范

Q版武器

单图，用Texture Packer打包成图片集

Q版主角

游戏场景、UI显示、两个图片集

卡牌/大武器

单张图片（规格一样 640 * 960），独立

UI图片

各元素各自一样图片，大小不一样，NGUI自我打包图片集

武器图标背景

NGUI自我打包图片集

怪

2D Toolkit图片集 或 Spine动画

场景

2D Toolkit图片集

6.2 工具、插件使用教程

Unity是一个极具延伸性的游戏引擎，无数的第三方开发者为其贡献力量，开发插件，因此也有各种专业的插件诞生，像我们使用NGUI、2D Toolkit等插件。

在美术制作过程中，需要使用到的一般是Spin动画软件和NGUI。

Spine官方快速入门（必须掌握）：http://zh.esotericsoftware.com/spine-quickstart ，官网内附带视频教学资源。

NGUI基础（不用细看，多问程序）：http://blog.csdn.net/we000636/article/details/7418413

6.3 美术资源目录

SVN目录里的ArtResrouces是美术零散资源大目录，其中 “SpineProject” 是使用Spine制作动画的目录，必须按照命名规范使用和分布，其余的均为零散资源，可自行创建目录进行psd等资源备份。

6.3.1 Spine动画工程目录命名规范

程序会根据命名规范自动产品化所有动画

每一个目录对应一个图集（所有图片会聚合成一张图片），优化性能和空间大小

每个目录里都有一个Textures(翻译:纹理)文件夹放置所有图片

Common目录比较特殊，目录对应一个图集，里面再有子文件夹放置Spine动画(同时需要Textures)

6.3.2 Cb-art美术工程库常用目录

放置所有整理过的产品化美术资源(Unity3D直接可用的），该库不能通过svn拿到，需要通过Unity的Version Control版本控制取得。

l cb-art\Assets\Product目录是所有打包元素

l Product\Actor代表地图怪物

l Product\Audio代表打包的音效

l Product\Card代表大卡牌图片

l Product\Effect代表所有游戏特效

l Product\Hero代表英雄角色

l Product\Map代表地图关卡

l Product\Spine代表上文的SpineProject目录转化成的Unity3D可用资源

l UI就是拼凑UI的界面

l Weapon是打包好的武器图标

l Scene，Actor-Bones，UI2是历史遗留，漠视

自动化机器人在执行时，会把cb-art\Assets\Product目录下的元素针对性地逐个打包出去，供客户端读取。

策划在填充表格时，只要使用Product下的相对路径就可以使用特效了（举例，策划使用一个子弹特效时，填写“Effect/Skill/CastBullet”。

6.3.3 如何编辑地图

修改地图

Product\Map目录下是所有的关卡地图，双击打开。

新建地图

打开cb-art Unity工程，从菜单上选择Game->创建新关卡场景，然后保存在Product/Map目录下（必须这个目录下，否则不能自动编译）。

地图编辑原理

一个关卡，由“Battle”和“Actor”组成的，附带一些场景对象（图片）。

可通过右上角的菜单来编辑地图功能。

6.3.4 如何编辑、预览特效

搜集的第三方粒子特效包

Cb-art库中，搜集了一些第三方的粒子特效，放在Assets\Effect下，以Prefab形式保存。比如，使用Cartoon Fx包的特效，展开目录Assets\Effect\JMO Assets\Cartoon FX\Prefab(Mobile)，把里面的蓝色图标的Prefab拖到场景里。

使用Unity内置的粒子系统

Unity的粒子系统名叫Shuriken Particle System，网上资料较多，不过多叙述。

参考：http://game.ceeger.com/Components/class-ParticleSystem.html

参考：http://game.ceeger.com/Manual/ParticleSystemGrouping.html

6.4 Actor敌人怪物制作规范

机枪球类：机枪球、警卫

Spine制作，三个方向的图片

三个Skeleton,   “body” Skeleton，“gun_front” Skeleton，“gun_back” Skeleton

向前，左侧右侧时显示gun_front；向后时显示gun_back

坦克车类: 战车坦克、狙击手

Spine制作，两个方向的图片

两个Skeleton， BodySkeleton, Gun Skeleton

UFO类: UFO、飞机

Spine制作，一个Skeleton，静止旋转

特效子弹方向朝上

带有方向的子弹，制作时默认方向向上(怪物不同，怪物默认朝下)

6.5 图片资源命名规范

6.5.1 Spine动画（Animation）命名

像战车怪，具有两个方向，那么，它有两个移动动画：move_01 / move_05，和两个攻击动画skill_01 / skill_05，代表不同朝向下使用的动画。

静态怪物，如机关、金币等，默认使用move动画。

常用动画：move | move01~move05 | skill01~skill05 | death | show

6.5.2 设计 Spine换肤的命名

参考SpineProject/MachineGun的命名规范，如gunball_001_gun_003_01，意思是gunbal_（机枪球类），_001（1号皮肤），gun_（炮台），003_（炮台类型：中间或两侧），_01（朝向）

6.6 策划表ID编号规则

6.6.1 技能ID

假设技能100号，那么它调用的子弹就是100号，Buff就是100号

如果技能101是组合技能，它的子技能ID建议分别是1011,1012,1013；如是子技能复用的，用回默认编号。

6.6.2 Actor ID

5000-5999是场景物品，100-199是机枪球类怪，200-299是战车类怪，300-399是炮塔类怪，400-499是UFO类怪，500-599是警卫类怪，600-699是狙击手类怪，700-799是布雷机类怪，1000-1099是功能机类，1100-1199是惊雷怪，1299-1299是芯片怪。

2000-2999是BOSS。

6.7
Spine使用技巧、潜规则

欲练神功，先自摸Spine到中级阶段。

Setup模式中可移动Slot，Animate模式中不行

在装配模式(Setup)中，可设置图片偏移，而在动画模式中，对图片(Slot)做偏移相当于对其上的Bone做偏移，因此，Bone一定程度可理解成动画组：当要对图片做动画，就建一个Bone。

概括一下：

对Attachment(图片)进行偏移，实质对Slot偏移，图片是无偏移的

Setup模式中，Slot可进行偏移(Translate)，Bone可进行偏移

Animate模式中，对Slot进行偏移(Translate)，无效，相当于Bone偏移

动画中带动旋转问题

父节点进行旋转动画，子节点偏移动画，在客户端会有计算误差问题。

解决方案将偏移动画的子节点移出去。

帧图片隐藏，而不是Slot和Order隐藏

动画中，要把一张图片隐藏，要把Attachment(附件图片)左边圆点点上，而不是将Draw Order和Slot左边圆点

动画中谨慎对待颜色修改和图片显隐

可视为Spine运行库的BUG；比如动画A对图片K进行淡出（透明度到10%），此时切换动画B，图片K将保持透明度10%的状态，因此动画B的第一帧务必设置图片K关键帧，透明度100%。

PS：现基本可忽略这个问题，项目中屏蔽动画缓动，每个动画播放前都会把骨架重置到最初状态。

7. 策划配置说明

7.1 策划配置表的作用

策划把配置表都是Excel表组成的，游戏里的关卡列表、怪物列表、技能列表、AI参数、游戏数值等都由配置表控制。可以说策划配置表的存在构成了整个游戏。

它的好处是，把一些常用的配置脱离程序代码，供策划进行配置、修改游戏，不用编译进去游戏程序，更加灵活

7.2 Excel表放置位置

策划配置表放在SVN目录里的cb-scheme/setting里，经过编译后，会被放到产品库cb-product/setting里。

编译前，编译后的文件都可以用Excel打开的哦。

7.3 Excel表编译

首先理解，Excel表编译本质上是将Excel表转成制表符（Tab）分隔的文本文件。

在配置有KKScriptHelper小程序的电脑上，按“Alt + ~”快捷键，就会弹出快捷窗口，按一下策划表编译就可以了。

如果按快捷键没反应，双击svn目录里的tools/excel2tab.bat文件。

7.4 技能配置详解

7.4.1 理解技能机制

技能由技能、子弹、Buff、Trigger四个模块相互交集组成的。

7.4.2 技能填表举例

填表，本质就是对技能逻辑的描述。

假设一个怪物技能，发出一个球攻击敌人，要蓄气吗？蓄气5秒；蓄气时有特效吗？有；蓄气后扔出的子弹就是球，球有特效吗？有；球有速度会移动吗？会；球有特效吗？有；球打中敌人后有效果吗？有，Buff；打中敌人的效果是怎样的？Buff里的Trigger。

填表：

技能蓄气5秒，发出球体：填表时，技能ReadyTime 5秒，填一个蓄气特效，Bullet 填1号；

子弹就是球体，向前移动：填表时，Bullet 1号，Speed 5，填一个子弹的特效，那么技能在ReadyTime结束后就会发出子弹；Buff填1。

Buff就是中弹后的效果，Buff是跟一个人物相关的，加载一个人物身上（可能是怪，也可能是玩家英雄）：填表时，Buff 1号，Trigger 的FuncName写Hurt，Arg1写1；

Trigger就是函数集，由程序代码组成，程序写好，由Buff调用，不用策划额外填表；

比如上面Buff 1写了Hurt，对应程序函数Hurt，参数1是系数，那么Buff 1的效果就是，对Buff人伤害倍数1的血。

7.5 音效配置

l Actor.xls表中的StrikeSound可配置每个怪被碰撞后的个别音效

7.6 多语言系统使用

7.6.1 原理

多语言编译器，自动搜索程序代码、游戏配置Excel表的Name字段和Description字段的字符串，认为是进行翻译的字符串，生成一个关键字Excel表。

比如，你有武器表(weapon.xls)，里面有字段Name,那么Name下所有的字符串都会输出到“翻译表”（自动排出重复），让你直接进行翻译。

7.6.2 翻译

使用快捷键“Ctrl+~”，点击编译多语言表，就会生成一些语言Excel表放在cb-scheme/setting/l10n里面，Excel打开即可进行翻译。

8.
程序开发规范

8.1 代码规范

l 局部变量小写开头单词分割首字母大写：startIndex，windowBorderStyle

l 成员变量、成员属性、成员函数用大写字母开头：Name，MapIndex，RecoverLife()

l 常量\枚举值用大写

l 每个类如果有成员变量，在声明处应直接赋初值，复杂情况的初值在构造函数中处理，非赋值的初始化工作在Init函数中处理

l 继承自Mono的类不允许使用构造函数，用Awake(); 初始化尽量用自定义Init函数，不然烦死你

l Code Is Poetry 代码如诗，大家都看得懂的代码才是好代码

8.1.1 注释

每一个方法，都要尽可能的在方法头注释。

如果能按照注解规范最好（不强制要求）； 参考网址 http://www.tmser.com/?post=34

8.1.2 多语言L10N.Get(string)

程序中，凡是需要多语言翻译的字符串，使用L10N.Get(string)方法。编译器会自动字符串搜索，来生成翻译关键字。（参照策划“多语言系统”使用）

8.2 技巧

8.2.1 需要用到大量循环的地方，考虑用协程

Unity的协程，其实类似于NodeJS的异步IO，熟练使用你会爱不惜手，既使用方便，性能又好

8.2.2 事件驱动编程

使用事件驱动编程，避免在每一次循环里对象状态；比如：一个技能结束后，通知发射者可以走动；  而不是： Update里判断技能是否结束，如果结束了，发射者可以走动状态。

8.2.3 尽量使用英语命名

装一个《有道词典》使用英语，尽量不使用汉语拼音去命名。一来所有人都能理解这个单词，二来提高自身英语水平。阅读英语文档的能力，一定程度决定了一个程序开发者解决难题的能力。

8.2.4 使用代码编辑器Sublime Text 2 / Notepad++

多点用文字编辑器，不要过度依赖Visual Studio等大型IDE。

Sublime Text装常用插件ConvertToUTF-8才能支持GBK。常用快捷键Ctrl+D,Ctrl+R,Ctrl+P。

8.2.5 使用自动化偷懒

时刻思考有什么工作能自动化，减少的重复工作。

举个游戏工程里常见的浪费时间的流程：美术 找 策划 使用 程序 写的工具导出游戏场景；可简化成：美术上传，机器人自动识别并导出游戏场景。

8.2.6 用搜索引擎解决问题

提出技术问题之前，先去百度搜一下，再去Google搜一下，实在没有，Bing也要搜一下，都解决不了，可以去StackOverflow提问

8.2.7 消灭重复

编程的最高最难最大的目标，就是让重复功能的代码不要出现

8.2.8 爱上重构

没有什么比重构更能提高技术水平了； 菜鸟的特点是，写完代码后，都不敢去看自己之前的代码。

8.3 某些注意事项

8.3.1 模块之间的依赖

举例，UI、玩法模块依赖网络；但是，网络是独立的，不依赖UI，因此千万不要出现在网络里使用UI的函数等情况，使用事件驱动编程，网络里触发事件，UI绑定网络的事件。

使用事件驱动编程，在某种程度来说，会加大程序的可读性，但会大幅度的提高模块之间的松耦合。

比如说，现在要做一个新游戏，哦，整个网络模块拷过去是不会报错的。因为没有对其它模块进行依赖。

8.3.2 松散代码

某些特别的情况下，如教学关剧情，某个BOSS剧情等，使用配置表已经无法满足特殊功能需求了，这些需要进行一些硬编码。

针对特殊功能的硬编码，需要特别的谨慎，尽量不影响一些共用代码，如CMap, CActor这些公用类。

以下几个模块，最初就设计成放置特别松散的代码，它们的特点是，几乎无依赖顾忌地调用程序里的其它模块：

CTrigger_xxx.cs：Trigger函数，根据项目的需要而添加；

CSpineEventFunc.cs： Spine动画的事件函数，Spine动画的Event标签都分别对应其中；

AiFunc.cs：AI节点，函数集合；

另外，CxxxActor在某些情况下也无可避免的要硬编码，如Boss特殊技能、Boss触发剧情等，但务必尽最大可能，不要将这些特殊功能写到公用层（如CMap.cs、CActor.cs等），否则随着特殊功能的增多，整个项目会混乱不堪。