tprPix 是一个跨平台的,2D生存向沙盒游戏项目。
项目基于: C++17/OpenGL/SQLite3.
(注意,tprPix 是项目的名称, 而非游戏本身的名称 (我还没想好hhh...) )
直接下载 Branch:master 即可。
- Win10
- MacOSX (10.12 或更高版本)
- Ubuntu (16.04 或更高版本)
也许可以支持各平台的较早版本,但我尚未测试。
Clang 是最推荐的编译器,即便是在 Win10 平台。 请确保你所下载和安装的 Clang 版本,支持 C++17。
在 Mac 平台的安装非常简单。
首先,确保你已经成功安装如下程序:
- CMake (3.1 或更高版本; 若想使用PCH,Unity-builds 技术加速编译,推荐 3.16 或更高版本)
- Clang (足以支持 C++17 的较新版本)
- OpenGL 相关的库
然后,打开 终端(terminal),"cd" 至 本项目的根目录:
$ cd .../appRootDir/
(注意,此处的 "appRootDir" 应替换为实际的根目录名字)
接着,运行一份 shell 脚本程序:
$ ./unix_release.sh
脚本 unix_release.sh
将会自动化地帮我们完成程序的 build 和本地化部署工作。
你也可以选择运行另一份脚本:unix_debug.sh
, 正如名字所示,它将生成一份 DEBUG 版的程序。在 DEBUG 模式下,游戏的运行性能会显著下降。想要试玩的朋友,请尽可能调用 release 模式。
现在,所有的安装工作都已经 完成 了!!!
你可以在目录: .../appRootDir/build/publish/ 中找到可执行文件:tprpix。 双击它,开始我们的游戏!!! (注意,此处的 "appRootDir" 应替换为实际的根目录名字)
在 Ubuntu 上的安装与 Mac OS X 十分相似。
首先,请确保你已经安装如下程序:
CMake (3.1 或更高版本; 若想使用PCH,Unity-builds 技术加速编译,推荐 3.16 或更高版本):
$ sudo apt-get install cmake
Clang (足以支持 C++17 的较新版本):
$ sudo apt-get install llvm
$ sudo apt-get install clang
重设系统默认的 C/C++编译器:
$ sudo update-alternatives --config c++
$ sudo update-alternatives --config cc
再安装几个与图形有关的第三方库:
$ sudo apt-get install libx11-dev
$ sudo apt-get install libglfw3-dev
$ sudo apt-get install libsdl2-dev
现在,打开 终端(terminal),"cd" 至 本项目的根目录:
$ cd .../appRootDir/
(注意,此处的 "appRootDir" 应替换为实际的根目录名字)
接着,运行一份 shell 脚本程序:
$ ./unix_release.sh
脚本 unix_release.sh
将会自动化地帮我们完成程序的 build 和本地化部署工作。
你也可以选择运行另一份脚本:unix_debug.sh
, 正如名字所示,它将生存一份 DEBUG 版的程序。在 DEBUG 模式下,游戏的运行性能会显著下降。想要试玩的朋友,请尽可能调用 release 模式。
现在,所有的安装工作都已经 完成 了!!!
你可以在目录: .../appRootDir/build/publish/ 中找到可执行文件:tprpix。 (注意,此处的 "appRootDir" 应替换为实际的根目录名字)
在 终端 中启动它:
$ build/publish/tprpix
开始我们的游戏!!!
为了支持 Win10 中的 Clang,我们首先要安装 Visual Studio 2019。
同时,确保你的 Visual Studio 中也安装了如下组件:
然后,启动 Visual Studio 2019,点选初始界面中的 Open a local folder
按钮,在弹出的窗口中,选择本程序的根目录 ->
进入主界面后,VS 会主动识别出一份根目录下的配置文件:CMakeSettings.json
,并且根据这份文件内的描述,自动创建一份名为 x64-Clang-Release
的 配置方案(configurations)。此时你会看到 VS: Output 面板中 正在做有关 cmake Cache 的解析和生成工作。 稍等数秒后,你会在 Output 面板 中看到:
CMake generation finished.
这表明 cmake Cache 生成成功了!
注意: 如果在这一过程中发生错误,请阅读 这份文章,学习如何以 手动配置 的方式,来生成 cmake Cache。
在 cmake Cache 生成成功后。在 Visual Studio 2019 左上方的 Build
菜单中,找到 Build All
按钮,点击它,开始正式的 Build 工作。(也可以使用快捷键:F7
) ->
Build 工作 将会持续数分钟,直到我们在下方的 Output 面板中看到 Build All succeeded.
的信息。这表示,Build 成功。我们在 Visual Studio 2019
中的工作就全部结束了。
最后的最后,回到本项目所在的根目录。寻找并双击一份名为 win.bat
的脚本文件。
它将帮助我们执行本地化部署工作。
现在,安装正式完成!!!
你可以在目录 .../appRootDir/build/publish/ 中,找到可执行文件 tprpix.exe, 它就是我们的程序本体。 (注意,此处的 "appRootDir" 应替换为实际的根目录名字)
双击此文件,开始我们的游戏!!!
不管在任何平台编译,最终的生成包是统一的:.../appRootDir/build/publish/, 你可以将这个 publich 文件夹, 复制到任何位置,都不会影响文件夹内 可执行文件 的运行。可执行文件需要的一切资源,都被集成在了 publish 目录内。
本游戏同时支持 键盘 和 绝大部分 游戏手柄 输入。 考虑到这是一款动作类游戏,作者更推荐大家使用手柄来游戏。( Xbox360 或其他山寨版都支持 )
-
左摇杆: 控制角色移动。
-
按键:A: 确认键。 在游戏世界中,玩家可以按压 按键:A 来提升 玩家所操作角色的 移动速度。 (其实这是提供给开发者 Debug 用的功能)
-
按键:B: 降低 玩家所操作角色的 移动速度。
-
按键:X/Y: 在 终端 中打印一些数据,供开发者 Debug 用。
- 按键:W/A/S/D: 控制角色移动。
- 按键::Enter: 确认键。
- 按键::H/J/K/L: 功能对应游戏手柄中的 'A/B/X/Y' 键.
请注意,当系统输入法为中文模式时,游戏将无法识别键盘按键。请务必切换到英文输入法模式。
在目前版本中,一旦玩家进入游戏世界,可以控制一只小鸡四处游览世界。通过按下 键盘键:H 或者 游戏手柄键:A,可以让小鸡速度加快甚至飞行。这原本是提供给开发者来检视 世界生成效果用的。
鉴于本游戏的剩余部分仍在开发中,所以还请体验者们耐心等待。
现阶段暂不支持 全屏模式。改写窗口尺寸的配置文件,放置在 .../publish/jsons/windowConfig.json 文件中。如图所示:
如果你想调整你的 窗口尺寸,请修改变量:windowPixW, windowPixH
(单位为像素)。正如变量:recommend:windowPixW, recommend:windowPixH
所示,推荐的尺寸是 1920,1200。(事实上,你可以将变量 windowPixW, windowPixH
改写成任意整形数值(integer),只要记得别超出你的显示器限制。程序会自动照顾好窗口长宽比。)
请勿修改变量 recommend:windowPixW, recommend:windowPixH
,它们对程序不起任何作用,仅仅是一份提示。
请保持变量 isFullScreen
值为 false
。 针对它的修改将使程序启动失败。
在修改完参数后,保存文件。再次运行 app,就能获得对应效果。无需再次编译。
如果您在运行程序时,遭遇以下问题,请勿惊慌:
这个 bug 有较小的几率被触发。 当遇到这个问题时,推荐您先强制退出程序。然后直接删除 .../appRootDir/build/publish/dataBase/ 文件夹。对,整个删除即可。这是程序的 存档文件夹。请放心粗暴地随意删除之。
目前的游戏尚未实现完整的 UI系统,就连 存档系统 也是残缺的。 如果存档已满,还是请直接删除 .../appRootDir/build/publish/dataBase/ 文件夹。
您可以将闪退后的命令行信息提交到issues处,或者直接通过下方的联系方式传达给我。这将帮助我更好地完成程序。
...
版权协议遵守 BSD 3-Clause
本游戏的剩余部分仍在开发中,如果您有任何反馈或建议,都可以通过下方联系方式联系开发者本人。
- E-mail: [email protected]
- QQ: 651700603
- 微信:turesnake