Fushigi 项目常见问题解决方案

Fushigi 项目常见问题解决方案

Fushigi An editor for Super Mario Bros. Wonder. 项目地址: https://gitcode.com/gh_mirrors/fu/Fushigi

项目基础介绍

Fushigi 是一个用于《超级马里奥兄弟：奇迹》游戏的编辑器项目。该项目目前处于开发阶段（WIP），主要使用 C# 和 GLSL 编程语言。C# 是该项目的主要编程语言，用于实现编辑器的核心功能，而 GLSL 则用于图形渲染相关的代码。

新手使用注意事项及解决方案

1. 项目依赖问题

问题描述：新手在尝试构建项目时，可能会遇到依赖缺失的问题，导致无法正常编译和运行。

解决步骤：

• 确保安装 .NET 8：Fushigi 项目依赖于 .NET 8 框架。请确保在构建项目之前，已经安装了 .NET 8 SDK。
• 安装 Git：项目代码需要通过 Git 进行克隆。请确保系统中已经安装了 Git 客户端。
• 克隆项目代码：在命令行中运行以下命令，克隆项目代码到本地：

  git clone https://github.com/shibbo/Fushigi.git
  

• 构建项目：进入项目目录，运行以下命令进行构建：

  cd Fushigi/Fushigi
  dotnet build -c Release
  

2. 文件命名冲突问题

问题描述：项目在运行时会删除名为 "Fushigi" 的文件夹，如果用户在桌面上有同名文件夹，可能会导致数据丢失。

解决步骤：

• 避免使用 "Fushigi" 命名文件夹：在桌面上不要创建任何名为 "Fushigi" 的文件夹或文件，以避免被项目自动删除。
• 备份重要数据：在运行项目之前，确保桌面上没有重要数据存放在名为 "Fushigi" 的文件夹中。
• 运行项目：按照项目文档中的步骤，运行项目：

  cd Desktop
  rm -rf Fushigi
  git clone https://github.com/shibbo/Fushigi.git
  cd Fushigi/Fushigi
  dotnet run -c Release
  

3. 运行时错误问题

问题描述：新手在运行项目时，可能会遇到运行时错误，导致程序无法正常启动。

解决步骤：

• 检查依赖项：确保所有依赖项都已正确安装，特别是 .NET 8 SDK 和 Git。
• 查看日志：如果项目在运行时出现错误，查看命令行输出的错误信息，根据错误提示进行排查。
• 更新项目：如果项目代码有更新，重新克隆项目并运行：

  cd Desktop
  rm -rf Fushigi
  git clone https://github.com/shibbo/Fushigi.git
  cd Fushigi/Fushigi
  dotnet run -c Release
  

通过以上步骤，新手可以更好地理解和使用 Fushigi 项目，避免常见问题的发生。

Fushigi An editor for Super Mario Bros. Wonder. 项目地址: https://gitcode.com/gh_mirrors/fu/Fushigi