下载
请从GitHub仓库的[Releases](https://github.com/JDDKCN/KCN-GenshinServer/releases/) 中下载最新发行版程序。
开始使用
1. 解压从 Releases 下载的压缩包，运行 `KCN-GenshinServer_GC一键端.exe` 。
2. 初次运行程序，请选择您需要的模式。若您是初次接触，建议选择基础模式，这对新手来说很友好。若您想使用启动器的高级功能或开服/联机，请选择专业模式。
下面对两种模式分开讲解。
基础模式
1. 点击 `启动游戏` 按钮。如果你还没有选择原神客户端路径，请在弹出的对话框内选择【Yuanshen.exe程序所在目录】。
2. 您可以开始游戏了。
3. 在结束游玩后，请先关闭游戏，接着点击 `结束服务` 。这会关闭后台服务进程、关闭系统代理以及恢复游戏客户端至官服。请一定点击此按钮，否则可能出现网络无法连接，无法游玩官服等问题。
专业模式
1. 选择你的原神客户端路径。
2. 点击 `一键启动服务` 按钮。这会启动数据库以及服务端进程。
3. 点击 `启动游戏` 按钮。这会启动代理进程及游戏。
4. 您可以开始游戏了。Enjoy it😊
说明：
如果程序没有在您的计算机上检测到mitmproxy的CA证书(一般为第一次启动时)，程序将会打开安装程序。请您在弹出的安装证书对话框中点击安装。
联机功能
此功能仅专业模式可用。下面以专业模式界面为例讲解。
本地-开服联机
1. 在面板左侧-基础信息-左上角，选中联机模式按钮。
2. 在面板左侧-基础信息-服务器IP文本框中，填入本机内网/公网IP地址(或域名)。如果您不知道IP，请点击查看IP按钮，将IP地址复制到文本框中。
3. 在面板左侧-客户端代理-服务器IP/域名文本框中，填入刚才复制的IP地址。一般来说，无需勾选 `使用SSL` 单选框。本端默认为HTTP协议，若在没有正确SSL证书的情况下勾选，会导致服务端无法连接。若要设置自己服务器的SSL证书，请在顶部工具栏-设置选项卡-网络安全证书(SSL)工具中设置自己的SSL安全证书与密码。
4. 点击 `一键启动服务` 按钮，此时你已经可以在局域网/公网中联机了。
5. 在面板左侧-客户端代理中，点击 `测试连接` 按钮。如果服务启动成功，您会看到连接成功的提示。
6. 点击 `启动游戏` 按钮，这会自动开启代理、注入补丁并进入游戏。
非本地-连接外部服务器
1. 在面板左侧-基础信息-左上角，选中联机模式按钮。
2. 在面板左侧-客户端代理中，输入要连接的远程服务端IP/域名(不要输入http(s)://)。如果您的服务器是Https连接，那么请勾选 `使用SSL` 单选框。如果您的服务器是Http连接，请不要勾选。
3. 点击 `测试连接` 按钮。如果远程服务器可用，您会看到连接成功的提示。
4. 点击 `启动游戏` 按钮。这会自动开启代理、注入补丁并进入游戏。
GM工具
请前往[GrasscutterTools](https://github.com/jie65535/GrasscutterCommandGenerator)项目查看具体使用方法。
1. 在单机模式下连接时，服务器地址请填写 `http://127.0.0.1:443` 。连接玩家账号时，玩家必须在线。
2. 当游戏内/控制台提示：`你没有权限执行此命令` 时，请在顶部工具栏-设置选项卡-解锁账号权限输入你要解锁的UID，账号即开放所有权限。
注入Mod(3dmigoto)
不知道Mod去哪里下载？请去免费的 [GameBanana](https://gamebanana.com/games/8552) 网站，你可以找到众多优质资源。
1. 请在顶部工具栏-设置选项卡-Mod(3dmigoto)工具中点击 `一键注入` 按钮。程序将启动注入程序及原神主程序。如果在启动后看见程序上下边栏出现绿色的字母/数字，则说明注入成功。
2. 请在顶部工具栏-设置选项卡-Mod(3dmigoto)工具中点击 `打开mod文件夹` 按钮，把解压好的mod放入文件夹中，重启游戏即可生效。
疑难解答
Java问题
Java导致的服务端启动出错
如果你的报错信息和下面给出的示例类似，那么这个解决方法适合你：可能是计算机上安装的Java版本太高。
Error: A JNI error has occurred, please check your installation and try again Exception in thread "main" java. lang. UnsupportedClassVersionError: emu/grasscutter/Grasscutter has been compiled by a more recent version of the Java Runtime (class file version 61.0), this version of the Java Runtime only recognizes class
file versions up to 52.01. 请卸载计算机当前版本的Java。卸载完成后以管理员身份运行程序，点击一键启动服务，安装jdk17。注意安装路径下请不要有中文字符。
2. 服务端启动成功后，会显示"加载完成！"字样。
无法安装Java & 以下开关中存在错误
1. 将软件关闭，右键-以管理员身份运行
2. 重新安装，安装路径下请不要有中文字符。
3. 如果还是无法安装，请自行打开软件根目录下的Server\plugin\jdk17.exe程序安装。
安装好Java后仍旧提示找不到Java
1. 这种情况一般是因为安装程序没有修改Path(环境变量)。
2. 要更改Path，请前往Windows设置-系统-系统信息-高级系统设置-右下角环境变量中设置。打开环境变量设置，你应该会在上半边的列表中找到Path。点击编辑-新建，在文字编辑框内填入你刚才安装的Java的路径。注意，要填写java.exe所在路径，一般在bin文件夹中。
代理问题
游戏中提示：网络超时，请稍后再试。
1. 这种情况大概率是未正确安装CA证书造成的错误。点击左上角设置-手动安装CA证书，提示安装完成后重启游戏即可。
2. 如果仍然不可行/提示安装错误，请自行运行代理程序，接着在装有Windows系统的盘符根目录下找到用户(users)文件夹，进入并找到自己的账户文件夹，接着找到.mitmproxy文件夹，安装文件夹内的mitmproxy-ca.p12证书文件。
和其他软件冲突
使用经典代理时，必须开启系统代理，使其代理网络请求。这导致会和某些同样需要代理的软件冲突(如Clash、V2、游戏加速器等)。所以，您需要在结束游戏后重新开启一遍这类程序。
游戏结束后无法联网
这是由于没有结束系统代理导致的问题。请点击 `一键结束服务` 按钮，程序会自动清空系统代理。
网络问题
服务器通讯错误
1. 请先开启服务端，等待服务端启动完毕后再测试连接。
2. 查看IP是否填写正确，SSL选项是否勾选错误。一般来说，本地服务使用的是HTTP服务，不需勾选SSL选项。
3. 如果仍旧报错，查看服务端是否启动成功。如果服务端未正确启动，可能是端口占用问题或者Java版本问题，请查看上述条目。服务端启动成功后，会显示"加载完成！"字样。
游戏里提示：网络超时，请稍后再试。
1. 请先确保您的服务端正确启动，代理正确启动。
2. 如果一切正常，请检查您的网络，这可能是网络服务商导致的网络问题。由用户反馈的信息，校园网可能无法正确代理游戏，目前暂不知道原因与解决方法，猜测可能是对网关进行了某些限制。
端口占用
如果你的报错信息和下面给出的示例类似，那么这个解决方法适合你：端口被占用。
Exception in thread "main" io.javalin.util.JavalinBindException: Port already in use. Make sure no other process is using port 443 and try again.适用于专业模式用户的解决方法：
1. 如果您正处于 `单机模式` ，请切换至 `联机模式` 。
2. 在 `基础信息` 和 `客户端代理` 中的 `服务器IP` 输入框中填入 `127.0.0.1`(单机模式) 或您电脑的局域网/公网IP(联机模式)。
3. 替换被占用的端口(一般是dispatch的443端口)，将dispatch改成8081即可。如果仍占用，改为其它数字重试。客户端代理的端口号同dispatch端口号。在连接GM工具时，请把链接后面的数字改成dispatch端口号(如`http://127.0.0.1:8081`)。
适用于基础模式用户的解决方法：
1. 在左侧的游戏端口中，直接选择 `8081` 端口或其它自定义端口，重启服务。
2. 同理，在连接GM工具时，需要把链接后面的数字改为dispatch端口号(`http://127.0.0.1:8081`)。
账号问题
游戏登录时提示找不到UID或者账户不存在
1. 可以点击左上角设置-开启自动创建账号功能，这样服务端会自动给不存在的用户名创建新账号。
2. 也可以在服务端控制台中使用命令创建账号。使用[account create {你想要的用户名} {UID}]命令。举例：account create KCN 10001 就是创建用户名为KCN，UID为10001的账号。登录时请填入你的用户名而不是UID。【输命令的时候不要加括号！】
3. 密码：没密码，密码框随便输就行，别空着。
路径问题
找不到xxx组件
1. 这个错误一般是移动了文件夹位置/未完整解压缩文件导致的。请仔细检查是否完整的解压了一键端所有文件。
2. 如果一键端文件完整，请把一键端根目录下的config.json文件删除，然后重新打开程序，使其重新生成。
客户端问题
数据异常，请完全卸载游戏，并从官方渠道重新下载安装(错误码 31-4302)
1. 这个错误一般是在YuanShen.exe游戏目录下移动复制了其它文件所导致的。
2. 要解决这个错误，请删除YusnShen.exe游戏目录下多余的文件(补丁文件除外)。
GM工具问题
你没有权限执行此命令。
快捷方法：
1. 请在一键端设置选项卡-解锁账号权限输入你要解锁的UID，账号即开放所有权限。
其它方法：
1. 请在GM工具中点击"管理"选项，在权限管理一栏中，输入你目前账号的UID，选择 `*` (开放该账号所有权限)，点击添加。
2. 请把生成的命令复制到服务端的命令行窗口中，回车执行。这样，你的账号就可以使用所有命令了。【服务端不是GM工具，是黑色的命令提示符窗口】
3. 你也可以直接输入以下命令(在服务端窗口内)：permission add @10001 * 【10001处换为你的UID】。
无法连接到服务器
1. 这大概率是你的服务端启动失败或IP地址没有输对。请参照上述条目解决。
工具教程
卡池工具
介绍
1. 此工具用于替换服务端内卡池文件。您可以自定义卡池。
使用方法
1. 请打开设置-卡池设置页面。
2. 列表中包含了到目前为止所有版本UP池(不包括CB版本)，选中想要的卡池，点击替换。重启服务即可生效。
数据库工具
介绍
1. 此工具用于数据库的备份、还原及删库。
2. 需要开启数据库服务才能使用此工具。
使用方法
1. 点击 `备份数据库` ，选择存档数据的保存路径和文件名，数据库数据会以 `.gz` 格式储存。
2. 点击 `还原数据库` ，选择备份的数据包，游戏存档即可恢复至存档时的数据。
3. 点击 `清空数据库` ，数据库的数据会完全删除，请做好备份后使用。
网络安全证书(SSL)工具
介绍
1. 此工具用于SSL证书的添加及SSL功能的使用。
2. SSL证书是实现https安全加密传输的证书文件。普通用户无需设置此项，您使用的是HTTP传输协议。若使用了无效SSL证书，您的服务端将无法连接。
使用方法
1. 选择您的有效SSL证书，支持.pfx和.p12格式。如果您的证书是其它类型，请去SSL证书签发机构获取支持，或使用转换器转换为支持类型。
2. 输入证书密码。
3. 您可以选择是否开启SSL功能。
4. 点击确定，完成设置。
