Phixos 在线模拟器技术文档

概览

Phixos 是一个基于 JavaScript 和 Canvas 的在线模拟器，旨在模仿 Phigros 游戏的界面和体验。此项目作为个人爱好与学习之用，由 lchz3473 开发并维护，采用了Vite进行驱动，确保快速且现代的前端构建体验。请注意，由于持续的模块化重构，您可能会遇到代码结构的变化。

安装指南

开发环境准备

1. Node.js: 确保您的系统已安装 Node.js v14 或更高版本。
2. Git: 安装 Git 用于克隆仓库。

克隆项目

打开终端，执行以下命令以克隆项目到本地：

git clone https://github.com/lchzh3473/sim-phi.git
cd sim-phi

安装依赖并启动

安装项目所需依赖，并通过 Vite 启动开发服务器：

npm install
npm run dev

浏览器会自动打开 http://localhost:3000，展示模拟器的运行效果。

项目的使用说明

一旦开发服务器运行，您可以直接在浏览器中交互体验模拟器功能。若需自定义游戏逻辑或查看内部细节，打开项目目录，在相应的 .js 文件中进行修改后重新启动服务器查看变化。

项目API使用文档

目前，具体的API文档正在 docs.lchz.net/project/sim-phi-core 上积极构建中。这些文档将详细介绍如何与模拟器的核心组件交互，包括但不限于初始化模拟器实例、添加自定义谱面逻辑等。请定期检查该链接以获取最新文档。

项目构建方式

要构建生产环境版本，请执行以下命令：

npm run build

这将在 dist 目录下生成一个生产就绪的文件，可用于部署至静态服务器。

注意事项

• 本项目仅供学习交流，不包含原始游戏的任何实际内容，也不支持商业用途。
• 遵循 GPL-3.0 许可证，对代码进行修改或分发时，请遵循相应规则。
• 如遇问题，可通过电子邮件与 lchz3473 联系：[e-mail]。

本技术文档旨在帮助开发者了解、定制和部署 Phixos 模拟器。随着项目的发展，相关内容可能需要适时更新。祝您探索愉快！