入门
本指南解释了设置和运行kRPC服务器的基础知识,以及编写与游戏交互的基本Python脚本。
本翻译基于 [kRPC 官方文档](https://krpc.github.io/krpc),遵循 LGPL v3 许可。 部分内容可能受 GPLv3 或 MIT 许可约束,详见原始仓库。 Copyright 2015-2023 kRPC Org.
服务器插件
安装
1.从以下位置之一下载并安装kRPC服务器插件:
- Githubhttps://github.com/krpc/krpc/releaseshttps://github.com/krpc/krpc/releases
https://github.com/krpc/krpc/releases
- SpaceDockhttps://spacedock.info/mod/69/kRPChttps://spacedock.info/mod/69/kRPC
https://spacedock.info/mod/69/kRPC
- Cursehttps://mods.curse.com/ksp-mods/kerbal/220219-krpc-control-the-game-using-c-c-java-lua-pythonhttps://mods.curse.com/ksp-mods/kerbal/220219-krpc-control-the-game-using-c-c-java-lua-python
https://mods.curse.com/ksp-mods/kerbal/220219-krpc-control-the-game-using-c-c-java-lua-python
- CKANhttps://forum.kerbalspaceprogram.com/index.php?/topic/90246-the-comprehensive-kerbal-archive-network-ckan-package-manager-v1180-19-june-2016/https://forum.kerbalspaceprogram.com/index.php?/topic/90246-the-comprehensive-kerbal-archive-network-ckan-package-manager-v1180-19-june-2016/
https://forum.kerbalspaceprogram.com/index.php?/topic/90246-the-comprehensive-kerbal-archive-network-ckan-package-manager-v1180-19-june-2016/
2.启动KSP并加载已保存的游戏。
3.您应该会看到这样的服务器窗口:
4.点击“Start server(开启服务器)”可以用来,呃。。。当然是用来开启服务器啦!如果进展顺利,左上角那盏灯将会变成令人愉悦的绿色。
5.您可以通过点击右上角的关闭按钮来隐藏窗口,当然,单击屏幕右侧的图标也可以显示/隐藏窗口:
当服务器在线时,这个图标也会变绿。
配置
通过单击游戏中显示的窗口上的“edit(编辑)”来配置服务器:
- 协议:这是服务器使用的协议。这会影响客户端可以连接到服务器的类型。对于Python和大多数其他通过TCP/IP通信的客户端,您希望选择“Protobuf over TCP”。
- 地址:这是服务器将监听的IP地址。如果只允许来自本地计算机的连接,请选择“localhost”(默认值)。如果允许通过网络连接,请选择计算机的本地IP地址,或选择“手动”并手动输入本地IP地址。
- RPC和流端口号(Stream port numbers):这些端口号需要被设置为计算机上可用的端口号。在大多数情况下,它们可以保留为默认值。
还有几个高级设置,默认情况下它们是隐藏的,可以通过选中“Show advanced settings(显示高级设置)”来显示:
- Auto-start server(自动启动服务器):启用后,服务器将在游戏加载时自动启动。
- Auto-accept new clients(自动接受新客户端):启用后,将自动允许新的客户端连接。禁用后,每次连接时,将弹出一个窗口,询问是否允许新的客户端连接。
其他高级设置用于控制服务器的性能。
Python客户端
Windows系统
- 如果您还没有安装python,请下载python安装程序并运行它,安装地址:https://www.python.org/downloads/windows运行安装程序时,请确保您也安装了pip。
- 打开命令提示符并运行命令:pip install krpc.安装kRPC python模块.
运行Python IDLE(或您最喜欢的编辑器)并开始编码!
Linux系统
- 您的Linux发行版可能已经安装了python。如果没有,请使用您最喜欢的包管理器安装python,或从这里获取:Download Python | Python.org
- 您还需要使用您的包管理器,或从这里安装pip:pip · PyPI。
- 在终端中运行命令:pip install krpc 安装krpcPython模块
- 您可以开始编码了!
“Hello World”脚本
运行KSP并使用默认设置启动服务器。然后运行以下python脚本。
import krpc
conn = krpc.connect(name='Hello World')
vessel = conn.space_center.active_vessel
print(vessel.name)
以下内容将被依次执行:
第一行加载krpc Python模块
第二行打开到服务器的新链接
第三行获取航天器
第四行在屏幕上输出航天器的名称
您将在游戏界面看到:
恭喜您!您已经写下了您的第一个与《坎巴拉太空计划》交互的脚本!