用户手册

此手册旨在指导一位刚刚接触bpm的新人如何正确使用bpm。然而bpm是个命令行程序，很明显，它根本不是为计算机小白准备的，请确认您的计算机认知，然后再考虑阅读此手册。

我会用我能说出的最直白的语言告诉你如何操作，如果您仍然无法理解操作过程，您可以向其他已经知道如何使用bpm的人进行更详细的咨询。

配置与安装

bpm与大多数软件一样，需要进行安装，您可以在bpm的Github开源页面中的Release板块找到最新的编译版本并下载。下载务必完全解压到一个空白文件夹中，然后我们就得到了bpm本体，但是此时bpm是无法运行的，此时需要根据您的计算机的操作系统类型进行选择。对于大多数用户来说，请阅读下面的Windows章节。

Windows

如果你只会通过双击程序来启动程序，并且拒绝学习任何新方法用于启动程序，建议立即关闭这个文档并删除所有bpm内容。

配置安装环境

先来安装安装环境，点击这里前往.Net Core下载网址，并下载对应的 Windows 安装包（下载 Runtime 即可）

验证安装正确

使用搜索功能（Windows 7在开始菜单下方，Windows 10请使用Cortana）搜索Cmd，找到后右键-以管理员身份运行。

然后前往你放有bpm的文件夹，复制这个文件夹的地址，它看起来可能比较像D:\MySoftware\bpm，我们把这堆文本记为xxx。

然后在你刚刚打开的 Cmd 窗口中输入指令cd /d xxx，其中xxx是你刚刚复制的文件夹地址，然后回车

然后输入bpm help并回车，如果能输出一串帮助文档，则表明没有问题了。如果没有输出，请再次检查您的设置是否正确，如果仍然一头雾水，可以尝试咨询其他人。

全局配置

上面执行bpm的方法似乎有些麻烦，因为步骤太过烦琐了，我想直接敲bpm命令就能执行怎么办？我们可以将bpm配置为全局命令。

右键此电脑（Windows 10是此电脑，Windows 7是计算机），选择属性，在打开的窗口的左侧选择高级系统设置，点击高级选项卡中的环境变量。

在用户变量中选中PATH（如果不存在请创建一个），还记得之前我们记住的xxx吗？把它添加进去（Windows 10的添加较为直观，Windows 7的添加请注意不要忘记各个路径之间用以区分的分号）

此后，我们在任意地方开启Cmd，都可以直接执行bpm了。（必须要开Cmd否则你拿什么来显示内容呢？）

Linux

我们默认使用 Linux 的您掌握了一切基础的计算机知识。

配置安装环境

请先前往.Net Core 下载网址查阅如何配置.Net Core环境

验证安装正确

在bpm所在文件夹打开终端模拟器

您可以输入bpm.sh help并回车来验证环境的配置正确。

全局配置

至于如何让 bpm 成为一个全局命令，我相信您一定会操作（我才不会说是我懒了）

使用须知

bpm.sh这个脚本我实际上并没有在任何Linux系统上跑过，里面可能会有一些问题（例如执行目录的问题），碍于我的能力限制，我暂时无法在短时间内修复它，如果您可以分享您的启动脚本，请不要吝啬PullRequest

macOS

自己动手，丰衣足食。待完善。

命令输入

bpm采用的是参数输入的方式来工作的，也就是说程序运行一次只能执行一次命令，有多少个命令就会启动程序多少次。

命令的格式大致为bpm 命令名 参数1 参数2 ...，请在终端或者Cmd中直接输入即可。对于输入参数的UTF-8支持暂时未知，至少我在Windows 10下用PowerShell的时候是完全OK的。

命令详解

list

• list：列出当前安装的包信息

update

• update：与远程服务器同步包数据库

show

• show 包名：输出指定包的详细信息，包名需要指定版本号

search

• search 单词1 单词2 ...：从数据库中搜索与所提供单词有关的包，会搜索包名与包别名。可指定多个搜索单词，单词数量不受限制

install

• install 包名：安装指定包，包名可以不指定版本号（默认安装最高版本）

remove

• remove 包名：移除指定包，包名可以不指定版本号（默认删除全部版本）

guide

• guide 包名：展示指定包的帮助，大多都是帮助您确认deploy参数，包名需要指定版本号

deploy

• deploy 包名 参数：配置包，用于地图，背景等各类资源包的配置，包名需要指定版本号

clean

• clean：删除所有缓存文件（下载zip以及依赖json）
• clean 包名：删除指定包的缓存文件，包名可以不指定版本号（默认删除全部版本）

config

• config：列出所有设置项及其值
• config 设置名：列出指定设置项的值
• config 设置名 新值：修改指定设置项的值

注意事项

• 第一次启动bpm会自动建立一系列文件夹，在任何时候都请勿删除这些文件夹
• 执行bpm update之后会在本地得到一个package.db，请在任何时候都不要删除这个文件
• 在安装任意一个包之后，会在本地得到一个InstallRecord.db，也请在任何时候都不要删除这个文件
• bpm不会自动识别您已安装的 Ballance。相反，我们反而建议您在一台没有安装 Ballance 的计算机上先安装 bpm，或者是卸载现在安装过的 Ballance 转而安装 bpm，然后由 bpm 安装 Ballance，这样可使 bpm 得以管理一切。您需要使用bpm config GamePath xxx先指定你想安装Ballance的文件夹，bpm 会将所有游戏文件存储在那。如果您坚持使用您自己安装的 Ballance，也是可以的，您只需要使用bpm config GamePath xxx将游戏地址设置为您的Ballance根目录即可，但请务必确保您的Ballance是英文原版，没有任何修改，否则任何命令执行时的错误，我都不会给予帮助支持。使用bpm安装 Ballance 的命令是bpm install ballance@v1.13
• 针对上面一条，由于bpm现在处于公开测试阶段，暂时不提供Ballance本体下载操作，故请您务必安装一个完全原版的Ballance然后再使用bpm config GamePath xxx设置游戏地址
• 默认语言为英语，使用bpm config Language zh-cn设置中文
• 默认连接到 Ballance 资源总服务器，如果需要连接其它服务器，使用bpm config Sources IP:Port进行设置
• 第一次启动后，需要执行bpm update更新包数据库后才能执行大部分操作
• Windows下执行bpm命令，最好以管理员运行，尤其是你的游戏安装在系统盘符下的时候。因为bpm需要对游戏进行操作；如果是在安装游戏时，还需要操作注册表以注册Ballance。不足的权限会导致一些不必要的，难以解释的错误。如果未按此操作进行，造成的后果不会提供任何技术支持。
• Linux下*应该*不需要使用root权限执行，不过在安装Ballance的时候，在wine中注册注册表的时候不清楚是否需要权限。