【17173模型组】一键换装还原工具 v2.0.7 2016-09-29

xenojoshua · 发表于 2014-6-6 15:11:24

以后我废话就更新在最上面了，方便查看

2015-03-16
2014年年中开始就非常忙，基本上没顾上开发什么新功能，后续的更新我还是会跟进，不至于没新衣服换，不过武器之类的就无限期了，大家懂得
2015-08-11
应组里要求，更新一版数据库。因为电信抽风，最近访问国外网站比较困难，从github上下载截图比较困难。今后我都会随软件上传一份图片资料库到百度盘里，大家记得自取。图片资料没密码的
2015-08-21
有一个已知的BUG，我一直都没修，这里简单描述下如何手动避免，暂时我就不动程序了。
问题：第一次下载工具，没有修改游戏地址的配置，打开工具后工具直接卡死闪退
解决：
1. 打开工具文件夹，找到根目录下的 config/setting.json
2. 编辑 path => game，将这部分的内容改成你硬盘上的游戏地址就好了
3. 记得文件夹的地址中，反斜线“\”都必须写两遍“\\”
2015-11-10
老样子继续更新数据库
2015-11-11
发现这次的版本更新有个问题，这次客户端解析使用的客户端在我的机器上安装时间比较长了，又跑了好多次脚本，里面貌似有部分UPK不是很正确。
部分的人族UPK解析有问题，且部分的饰品解析也受到了污染。我现在开始下一份最新的完整官方客户端，后续等我下载安装完毕我会再发一个版本，预计本周末可以发布上线。
临时的解决方案：大家可以兼着使用2.0.4和2.0.5两个版本。
2015-11-13
更新完成，修正了10号发布版本里的客户端污染问题
2016-09-29
更新版本v2.0.7：更新数据库，添加数据库更新教程。查看教程可以学会如何在没有官方更新的情况下自行更新工具

1. 效果
效果1：
效果展示，注意看装备栏内已装备的道具及服装：

万魂换白鸟，暗蓝换白口罩：

人女默认36号头发换47号头发：

冲角团换纯白青狼：

效果2：

2. 分流文件夹：百度网盘，下面找BladeSoulTool_vx.x.x.zip，后面序列数字越大版本越新，压缩包都有加密，密码在最下面，回复可见

3. 安装

解压缩下载的压缩包
安装.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

4. 使用
执行根目录下的 BladeSoulTool.bat ，打开软件界面

4.0 预览

物品列表中的部分物品，因为不是玩家可用的模型，所以是没有官方icon的，这种物品，软件会给与默认的icon：
此外，所有的icon及物品2D截图都是从网络下载的，如果下载失败，会显示失败的icon：

4.1 替换

在物品列表中选中一项物品，点击中间下方的`选为原始模型`按钮，设定原始模型
在物品列表中选中一项不同的物品，点击中间下方的`选为目标模型`按钮，设定目标模型
点击中间上方的`将左边的替换为右边的`按钮
确认弹出的对话框
等待`操作执行完成`对话框弹出
进游戏看效果

4.2 还原

点击面板顶端种族选择框旁边的`全部还原`按钮
等待`操作执行完成`对话框弹出
进游戏看效果

4.3 预览2D截图

点击顶部两个`预览模型截图`按钮

4.4 预览3D模型

点击顶部两个及中间下部的`预览3D模型`按钮

4.5 关于灵族

灵族的服装中，大量衣服都男女使用一个相同的骨骼
在2.0版本之前（男女分开），你会发现很多衣服在灵女的分类内是找不到的
2.0版本之后，我把这两个种族分类合并成了一个大的“灵族”，方便模型查找及替换

4.6 模型搜索

2.0版本之后添加模型搜索功能，只要你知道模型的短码，就能直接找到模型
模型搜索功能只会从当前选中的模型，或者当前所在的模型行开始向下搜索，所以最好在搜索开始之前选中第一行模型

4.7 mod文件位置

2.0版本之后，模型补丁文件统一放在tencent文件夹下的mod子文件夹内：
在某些情况下，全部恢复失败的时候，可以直接删除该文件夹来恢复所有的mod修改

4.8 图片资源下载

所有的icon及模型截图的图片都是从网络下载的，软件包内并未包含，在预览的时候下载有的时候会影响用户体验
2.0版本之后添加了一个下载所有图片的功能：
此外，在我的百度盘分享文件夹内，现在添加一个系列的zip包：BladeSoulTool_ImageResources_vx.x.x.zip
同软件版本命名规则，后续数字越大说明版本越新
下载该zip包，解压到 BladeSoulTool/VS_GUI/BladeSoulTool/tmp

4.9 模型冲突

在某些时候，游戏客户端会提示：
这是因为2.0版本之后的mod文件都放在子文件夹内，不会覆盖原来的客户端upk文件了，那么就有可能出现多个同名upk同时存在在客户端内
进入游戏的时候客户端会报告有重名文件
这里不影响正常游戏，点击确定即可

4.10 报告改模错误

在模型修改界面的最右上角现在添加了“报告错误”按钮
请在正常的改模步骤之后点击该按钮，软件将会向服务器发送一条错误报告
正常的改模步骤：选择原始模型，选择目标模型，点击替换按钮，等待成功提示框弹出

5. 如何更新工具数据库
5.1 前言
因个人原因，我对项目的维护周期间隔会比较长，无法很好兼顾到剑灵每一个版本的更新。某些急需服装数据的玩家就有自行更新数据库的需求，以获得第一时间的换装数据。因此我会在这里附上如何进行该工具的数据更新的教程，以便有需求的玩家可以自行操作。

但该工具的更新工作我没有做比较友好的界面封装，都是执行原始的命令行脚本，因此强烈建议没有程序经验的玩家不要自行更新。如果一定要更新的话，请备份好database文件夹下的所有内容，以便出了问题可以还原。

5.2 文件结构
所有和数据及截图相关的内容都存放在工具根目录的database文件夹下：

attach：饰品
costume：服装
icon：图标
upk：unreal模型数据
weapon：武器

5.3 文件结构
该软件的实际操作行为都以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包

记住这些名字和用途，后面有用

5.4 更新操作

更新剑灵客户端到最新版本，或重新安装客户端
保证客户端里的所有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这步）。使用的时候请自行改动脚本内的路径地址。

6. 申明
发布申明：
作者：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许可发布分享，他人修改代码后不得闭源，且新增代码必须使用相同的许可证。

7. FAQ & Tips