【17173模型组】一键换装还原工具，再也不用担心没衣服穿了
- 效果1：
- 效果展示，注意看装备栏内已装备的道具及服装：
- 万魂换白鸟，暗蓝换白口罩：
- 人女默认36号头发换47号头发：
- 冲角团换纯白青狼：
- 效果2：
- 分流文件夹：百度网盘，下面找BladeSoulTool_vx.x.x.zip，后面序列数字越大版本越新，压缩包都有加密
- 解压缩下载的压缩包
- 安装.net2.0：
- win7用户不需要安装，系统自带的
- 已经安装过的用户直接跳过这步
- 32位操作系统的请执行
resources/dotnet/dotnetfx20.exe，一路默认 - 64位操作系统的请下载安装：Microsoft .NET Framework 2.0 版可再发行组件包 (x64)
- 安装nodejs：执行
resources/nodejs/node-v0.10.26-x*.msi，如果你是32位操作系统，就执行x86，如果是64位就执行x64，一路默认 
- 执行安装脚本：执行
resources/nodejs/install.bat- 如果脚本最上面显示的是：
- 说明之前安装的nodejs成功了
- 如果显示的文本是：
Command node not found, please install it first.- 说明nodejs安装未成功，或者需要重启来生效
- 一般来说安装完nodejs是不需要重启的，偶尔有例外会没有即时生效
- 如果脚本最上面显示的是：
- 当屏幕上显示的如下图内容的时候，说明install脚本运行结束了：
- 执行根目录下的
BladeSoulTool.bat，切换到工具页面，点击选择按钮，选择游戏安装目录 
- 选这层文件夹：
- 安装完请务必备份下原始的客户端资源，如上图，contents文件夹复制下就OK
执行根目录下的BladeSoulTool.bat，打开软件界面
- 物品列表中的部分物品，因为不是玩家可用的模型，所以是没有官方icon的，这种物品，软件会给与默认的icon：
- 此外，所有的icon及物品2D截图都是从网络下载的，如果下载失败，会显示失败的icon：
- 在物品列表中选中一项物品，点击中间下方的
选为原始模型按钮，设定原始模型 - 在物品列表中选中一项不同的物品，点击中间下方的
选为目标模型按钮，设定目标模型 - 点击中间上方的
将左边的替换为右边的按钮 - 确认弹出的对话框
- 等待
操作执行完成对话框弹出 - 进游戏看效果
- EDIT：
- 2.0版本之后，服装替换功能添加了多换多功能，原始模型不再局限于col1的模型
- 2.0版本之后，饰品也能替换了，记住一点，带发型的饰品不能同时有多个，否则会破相
- 点击面板顶端种族选择框旁边的
全部还原按钮 - 等待
操作执行完成对话框弹出 - 进游戏看效果
- 点击顶部两个
预览模型截图按钮 
- 点击顶部两个及中间下部的
预览3D模型按钮 
- 灵族的服装中，大量衣服都男女使用一个相同的骨骼
- 在2.0版本之前（男女分开），你会发现很多衣服在灵女的分类内是找不到的
- 2.0版本之后，我把这两个种族分类合并成了一个大的“灵族”，方便模型查找及替换
- 2.0版本之后添加模型搜索功能，只要你知道模型的短码，就能直接找到模型
- 模型搜索功能只会从当前选中的模型，或者当前所在的模型行开始向下搜索，所以最好在搜索开始之前选中第一行模型
- 2.0版本之后，模型补丁文件统一放在tencent文件夹下的mod子文件夹内：
- 在某些情况下，全部恢复失败的时候，可以直接删除该文件夹来恢复所有的mod修改
- 所有的icon及模型截图的图片都是从网络下载的，软件包内并未包含，在预览的时候下载有的时候会影响用户体验
- 2.0版本之后添加了一个下载所有图片的功能：
- 此外，在我的百度盘分享文件夹内，现在添加一个系列的zip包：BladeSoulTool_ImageResources_vx.x.x.zip
- 同软件版本命名规则，后续数字越大说明版本越新
- 下载该zip包，解压到
BladeSoulTool/VS_GUI/BladeSoulTool/tmp
- 在某些时候，游戏客户端会提示：
- 这是因为2.0版本之后的mod文件都放在子文件夹内，不会覆盖原来的客户端upk文件了，那么就有可能出现多个同名upk同时存在在客户端内
- 进入游戏的时候客户端会报告有重名文件
- 这里不影响正常游戏，点击确定即可
- 在模型修改界面的最右上角现在添加了“报告错误”按钮
- 请在正常的改模步骤之后点击该按钮，软件将会向服务器发送一条错误报告
- 正常的改模步骤：选择原始模型，选择目标模型，点击替换按钮，等待成功提示框弹出
因个人原因，我对项目的维护周期间隔会比较长，无法很好兼顾到剑灵每一个版本的更新。某些急需服装数据的玩家就有自行更新数据库的需求，以获得第一时间的换装数据。因此我会在这里附上如何进行该工具的数据更新的教程，以便有需求的玩家可以自行操作。
但该工具的更新工作我没有做比较友好的界面封装，都是执行原始的命令行脚本，因此强烈建议没有程序经验的玩家不要自行更新。如果一定要更新的话，请备份好database文件夹下的所有内容，以便出了问题可以还原。
所有和数据及截图相关的内容都存放在工具根目录的database文件夹下：
- attach：饰品
- data：数据资料
- pics：模型截图，半成品阶段，未压缩（一般是空的）
- pics-cps：模型截图，成品，压缩完成
- costume：服装
- data：数据资料
- pics：模型截图，半成品阶段，未压缩（一般是空的）
- pics-cps：模型截图，成品，压缩完成
- icon：图标
- png 图标，半成品，未压缩（一般是空的）
- png-cps 图标，成品，压缩完成
- tga 从客户端解包出来的 tga格式图标文件（一般是空的）
- upk：unreal模型数据
- data：模型解包整理后的数据
- log：模型解包分析的原始数据
- weapon：武器
- data：数据资料
- pics：模型截图，半成品阶段，未压缩（一般是空的）
- pics-cps：模型截图，成品，压缩完成
该软件的实际操作行为都以JavaScript编写，使用Grunt作为运行执行容器，目前可执行的操作行为有以下：
- build_preparer：删除老的截图（pics文件夹），创建截图文件夹
- icon_dumper：将游戏中的icon解包，并将资源从tga转换成png，这一步中不对图片进行压缩
- upk_preparer：将腾讯文件夹下的资源文件拷贝到韩版的主目录下，保证后续只需要读一个文件夹，然后解包xml.dat
- upk_scanner：扫描所有的客户端upk资源文件，并将解析的内容输出成log格式文件，一个UPK一个日志
- upk_parser：分析之前扫描出来的客户端upk日志文件，将内容整理分类，写成数据库json
- shooter：将模型拍照，生成缩略图（pics文件夹）
- png_optimizer：将之前拍照的缩略图和图标图像文件进行压缩，缩减体积（pics-cps文件夹）
- compress：打包工具成zip包
记住这些名字和用途，后面有用
- 更新剑灵客户端到最新版本，或重新安装客户端
- 保证客户端里的所有upk模型文件都是原始的，不要保留任何已经修改的模型，否则会污染后面做的数据库
- 可能的话，备份剑灵游戏根目录的
contents文件夹 - 使用剑灵神灯去秋裤
- 编辑工具根目录的
run.bat文件 - 将
grunt %action% --stack --verbose & pause > nul中的%action%改成5.3所列的操作名 - 按5.3列出的顺序一步步执行
- 将图片资料拷贝到VS文件夹下（这样本地才可见）
- 拷贝
database/attach/pics-cps下的文件到VS_GUI/BladeSoulTool/tmp/attach - 拷贝
database/costume/pics-cps下的文件到VS_GUI/BladeSoulTool/tmp/costume - 拷贝
database/weapon/pics-cps下的文件到VS_GUI/BladeSoulTool/tmp/weapon - 拷贝
database/icon/png-cps下的文件到VS_GUI/BladeSoulTool/tmp/icon
- 拷贝
这样本机的更新就完成了，可以使用最新的数据库了
另，如果有Linux/Unix机器的话，可以使用根目录的bladesoultool_optipng.sh脚本进行png图片的压缩工作，效率会更高（免去png_optimizer这步）。使用的时候请自行改动脚本内的路径地址。
- build_preparer：
- icon_dumper：
- upk_preparer：
- upk_scanner：
- upk_parser：
- shooter：无，只要以
Done, without errors.结尾即表示无错 - png_optimizer：无，只要以
Done, without errors.结尾即表示无错
这里简单列下如果需要进行发布的话，需要做些什么：
- 首先完成5.4所列的所有内容
- 编辑README文档，更新改动内容描述
- 更新
config/setting.json文件中的version（客户端的版本号） - 在命令行下运行
grunt compress创建工具的压缩包，解压并附带上密码重新压缩一遍，命名为BladeSoulTool_vx.x.x.zip - 将
VS_GUI/BladeSoulTool/tmp文件夹压缩，命名为BladeSoulTool_ImageResources_vx.x.x.zip - 将这两个文件上传到网盘上
- 更新网站帖子，更新改动内容描述
- 编辑
VERSION.txt文件内的版本号，并提交到git - 在上面这步完成后，客户端就会收到通知（正式发布行为），因此需要确定好上面的所有内容之后才执行这步操作
发布申明：
作者：Jonathan，论坛id：xenojoshua，支持团队：17173剑灵模型组
我只会在17173发布，其他任何地方提供的下载皆为转载！
17173剑灵模型替换讨论版地址：http://bbs.17173.com/forum-9665-1.html
17173发布帖地址：http://bbs.17173.com/thread-8018028-1-1.html
后续的更新我也会持续发布在这个帖子里。
转载申明：
该软件是我秉着对剑灵这款游戏的爱而制作的，初衷是为了让更多玩家能体验剑灵装扮的玩法。因此我不会禁止软件的转载，但是请尊重作者的劳动，需要转载的请到17173私信我，谢谢。
此外，因为我的初衷是为了帮助玩家，任何转载或是使用我的脚本、数据的二次开发者，不得使用以虚拟币、论坛币等方式限制玩家的下载、传播的做法。最多允许回复可见。
License：
该软件以GPLv2许可发布分享，他人修改代码后不得闭源，且新增代码必须使用相同的许可证。
- 不要使用那些col为col20的模型
- 添加收藏列表，方便快速查找自己需要、常用的模型
- 2014-06-06：发布版本v1.0.0
- 2014-06-06：更新版本v1.0.1：修复3D模型预览的log文件未打包问题
- 2014-06-11：更新版本v1.0.2：添加新版本通知功能，修正滚动条问题
- 2014-06-11：更新版本v1.0.3：添加国际化
- 2014-06-21：更新版本v1.0.4：修正数据库分类算法，完善数据库。这一版的数据库是从客户端的upk分析出来的。修正icon不存在以及下载失败的提示。
- 2014-07-03：更新版本v2.0.1：
- 添加服装多色换多色功能
- 添加饰品换装功能
- 添加下载所有图片资源功能
- 添加模型查找功能
- 添加报告改模错误功能
- 灵男灵女分类合一
- 换装算法更新，更少的更改，更少的文件，不动贴图文件
- 所有换装mod文件都放在tencent下的mod文件夹内
- 所有提示窗和弹出窗都做成模态，不会被忽略
- 修正备份恢复功能，备份文件会一并删除，不再留下垃圾
- 2014-12-08：更新版本v2.0.2：更新数据库，含最新的枫情万种，替换功能等同前版本，无变化
- 2015-03-16：更新版本v2.0.3：更新数据库
- 2015-08-11：更新版本v2.0.4：更新数据库
- 2015-11-10：更新版本v2.0.5：更新数据库
- 2015-11-13：更新版本v2.0.6：更新数据库，修正上一个版本被污染的客户端导致的问题
- 2016-09-29：更新版本v2.0.7：更新数据库，添加数据库更新教程