📦 创建神岛地图代码项目

在 ArenaPro 插件中，你可以在本地电脑上创建和管理神岛地图代码，不再需要直接在 Arena 地图编辑器中编写代码。一个本地项目文件夹可以包含一张或多张扩展地图的全部代码。

🚀 创建步骤

1️⃣ 准备项目文件夹

首先，在你的电脑上创建一个新的空文件夹，用于存放地图项目代码。

📋 文件夹命名规则

警告

⚠️ 重要提示：项目名称及路径必须使用纯英文字母、数字和下划线，不能包含中文、空格或特殊符号，否则可能导致编译错误。

命名示例：

游戏中文名	项目文件夹名
瓶盖人大乱斗	bottleMan（使用英文）

2️⃣ 在 VS Code 中打开项目

1. 打开 VS Code
2. 点击菜单栏的 文件(File) → 打开文件夹(Open Folder)
3. 选择你刚才创建的空文件夹

打开后，VS Code 会显示空文件夹的内容：

3️⃣ 初始化 Arena-Ts 项目

🔄 启动创建向导

快速操作：点击链接快速调用创建功能 👉 新建 Arena-Ts 项目

或 手动调用创建文件功能：

1. 按下快捷键 F1 或 Shift+Ctrl+P（Mac 上是 Shift+Cmd+P）打开命令面板
2. 在命令面板中输入 arena-ts
3. 选择 新建Arena-Ts项目(Create new Arena-Ts Project) 选项

📦 安装依赖

系统会自动开始创建项目和安装依赖包：

危险

⚠️ 注意：在安装过程中，如果看到 Ok to proceed? 提示，请输入 y 后按 Enter 键确认。不要输入其他内容，否则可能导致安装失败。

⚙️ 配置项目

1. 选择项目类型，选择 神岛地图项目

   

2. 根据需求选择是否安装以下工具（多人协作项目建议安装）：

   工具	作用
   ESLint	代码检查工具
   Husky	Git 钩子工具
   Lint-Staged	代码提交前检查工具
   Prettier	代码格式化工具

提示

💡 提示：如果你是团队开发，建议安装这些工具以保持代码风格一致。详情可参考：前端工程化介绍

✅ 完成创建

按 Enter 键确认配置后，系统会自动完成项目创建。

如果一切顺利，你会看到以下项目结构：

警告

❓ 遇到问题？：如果安装过程中出现错误，可以参考 NodeJS 部署 Arena-Ts 问题解决方案

4️⃣ 验证项目

为确保项目创建成功，可以进行一次构建测试：

快速操作：点击链接快速构建项目 👉 完整构建项目

或 手动调用编译功能：

1. 点击 VS Code 左下角状态栏中的 完整构建项目 按钮
2. 观察终端窗口中的输出信息

如果看到以下提示，说明项目创建成功：

信息

📚 了解更多：想了解 Arena-Ts 项目的架构设计，请参考 Arena-Ts 地图项目架构