Skip to content
This repository has been archived by the owner on Jul 18, 2023. It is now read-only.

Strrationalism/Snowing

Repository files navigation

Snowing

弦语蝶梦 第二代游戏引擎 Snowing

基本组件

  • Core - 引擎核心代码
  • Assets - 基本素材与示例素材
  • WindowsImpl - Windows下的实现
  • Bake.Snowing - 素材转换、打包、部署工具(Bake构建系统的插件)
  • TestWindow - Windows下的单元测试
  • TestWindowsInput - Windows下的基本输入设备测试
  • FX11(submodule) - Microsoft Effects 11 框架运行时

插件

  • WindowsSteamSDK - Steam插件
  • TestWindowsSteam - Steam插件的单元测试测试
  • WindowsDInput - 用于手柄输入的DInput插件
  • TestWindowsDInput - DInput插件的单元测试
  • WindowsXInput - 用于手柄输入的XInput插件
  • TestWindowsXInput - XInput插件的单元测试
  • Yukimi - AVG游戏组件库
  • TestYukimi - AVG游戏组件库的单元测试
  • WindowsLive2D - Windows下的Live2D集成
  • TestWindowsLive2D - Windows下的Live2D集成的测试
  • Fyee - 动态BGM系统

范例

  • HelloWorld - 基本范例
  • Particle - 2D粒子范例
  • TextRendering - 2D文本范例
  • XInputControllerVibration - XInput控制器震动特效范例
  • FyeeDemo - Fyee动态BGM系统的Demo

兼容性提示

Microsoft Windows

  • 最低要求:Microsoft Windows 7 SP1
  • 可再分发库要求:
    • Microsoft Visual C++ 2019 Redistributable
    • KB4019990 (用于Microsoft Windows 7的补丁,用于提供D3DCompiler_47.dll)
    • XAudio2.9 Redist(已经集成到WindowsImpl)

FAQ

运行范例时找不到素材

在此之前需要安装Bake构建系统
之后在Assets目录下执行Bake。 如果需要执行Live2D范例,应当额外执行Bake BuildLive2D

对Windows 7兼容性

可支持到Windows 7 SP1,但是更低版本的Windows不再支持。

当我发布游戏时是否需要向玩家提供一些运行库

对于Win7、Win8用户,如果你导入了Live2D支持,则需要确保用户安装了KB4019990补丁,以确保用户拥有D3DCompiler_47.dll。 你可以在Steamworks进行配置,让Steam自动为你的玩家安装Visual C++ 2019可再发行组件包。

关于git-lfs

Clone此项目需要确保安装git-lfs,并已经执行以下命令:

git-lfs install
Bake.Snowing的用法

在Assets目录下执行Bake命令即可构建素材。
在Bake.Snowing目录下执行dotnet publish -c Release即可得到可用于导入的DLL。
如果你需要自己编写Bake Script,应当导入Bake.Snowing.dll以访问素材构建器的功能。

参见Bake构建系统

关于Effects11 SDK错误

使用子模块克隆后,如果提示找不到WinSDK,则需要手动重定向Effects的Windows SDK。 建议使用v142工具链,并使用“8.1”的SDK。

Live2D支持遇到了编译错误

由于Live2D的开发商的要求,我们不能提前做好Live2D的开发环境,如果你不需要Live2D,可以直接右键点击卸载项目。 如果你需要使用Live2D支持,需要确保:

  1. 从Live2D处获取了使用许可,弦语蝶梦团队不提供任何Live2D许可,也没受到Live2D的许可来开发游戏,仅仅做了引擎与Live2D的适配工作。
  2. 如果你尚未获取许可,请前往Live2D官网获取使用许可。
  3. 如果你已经获取许可,请前往SDK下载页面下载“Cubism SDK for Native”。
  4. 将其中的“Core”文件夹解压到WindowsLive2D目录下,使得WindowsLive2D\Core\include\Live2DCubismCore.h及其他文件可用。
  5. 确保这两个Git Submodule可用:CubismNativeFramework、CubismNativeSamples
  6. 编译运行TestWindowsLive2D,使得测试通过。
  7. 在你的项目中引用WindowsLive2D项目。