KCN

下载

请从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版本太高。

  1. 请卸载计算机当前版本的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. 如果一切正常，请检查您的网络，这可能是网络服务商导致的网络问题。由用户反馈的信息，校园网可能无法正确代理游戏，目前暂不知道原因与解决方法，猜测可能是对网关进行了某些限制。

端口占用

  如果你的报错信息和下面给出的示例类似，那么这个解决方法适合你：端口被占用。

  适用于专业模式用户的解决方法：

  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. 点击确定，完成设置。