Space Nerds In Space 技术文档

1. 安装指南

硬件和操作系统要求

本游戏为 Linux 系统，需要一台运行 Linux 的计算机。树莓派等性能较低的设备可能无法满足游戏需求。游戏目前主要在 Mint 17.3 系统上开发。理论上，游戏也可以在 Mac OSX 上编译和运行，但需要自行尝试。

安装依赖

以 root 用户执行以下命令安装构建依赖：

apt-get install build-essential
apt-get install portaudio19-dev
apt-get install libpng-dev
apt-get install libvorbis-dev
apt-get install libsdl2-dev
apt-get install libsdl2-2.0-0
apt-get install liblua5.2-dev
apt-get install libglew-dev
apt-get install libssl-dev
apt-get install libttspico-utils  # 用于文本转语音
apt-get install sox  # 用于 "play" 命令，文本转语音时使用

# 以下为可选安装
apt-get install espeak  # 可选替代 libttspico-utils
apt-get install alsa-utils  # 可选替代 sox，用于 "aplay" 命令
apt-get install openscad  # 可选，仅当你打算 working on 3D 模型时需要
apt-get install git  # 版本控制，对于游戏开发很有用
apt-get install stgit  # 如果你在游戏上做开发，用于制作补丁，类似于 "quilt" 但基于 git

如果需要尝试基于 pocketsphinx 的本地语音识别，还需要安装以下包：

apt-get install pocketsphinx-utils
apt-get install pocketsphinx-lm-en-hub4
apt-get install libpocketsphinx1

下载源代码

源代码位于：Space Nerds In Space GitHub 仓库

使用以下三种方法之一获取源代码：

1. 如果你是 GitHub 注册用户，可以使用：

git clone [e-mail]:smcameron/space-nerds-in-space.git

2. 如果不是 GitHub 用户，可以使用 git 的 HTTPS 方式：

git clone https://github.com/smcameron/space-nerds-in-space.git

3. 也可以直接下载 zip 文件：

下载 zip 文件

下载 zip 文件后，需要解压：

unzip space-nerds-in-space-master.zip
cd space-nerds-in-space-master

编译代码

在游戏顶层目录下（使用 git 获取源码为 "space-nerds-in-space"，下载 zip 文件为 "space-nerds-in-space-master"），执行以下命令：

make

编译 OpenSCAD 模型（可选）

如果你已安装 OpenSCAD，可以执行以下命令编译模型：

make models

下载附加资源

如果跳过了编译 OpenSCAD 模型的步骤，可以在这一步下载模型和其他资源。这需要网络连接。执行以下命令：

make update-assets

2. 使用说明

单机运行

在单机模式下运行游戏，执行以下命令：

./snis_launcher

按照提示选择相应的选项启动服务器和客户端。

3. 项目 API 使用文档

项目提供了 Lua 脚本 API 用于创建任务脚本，API 文档位于：

Space Nerds In Space Lua API

4. 项目安装方式

请参照上述 "安装指南" 部分进行项目的安装。