# DayZWorldManager

**Repository Path**: chuangshi96/blink-dayz-world-manager

## Basic Information

- **Project Name**: DayZWorldManager
- **Description**: Dayz开服工具
- **Primary Language**: NodeJS
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-05
- **Last Updated**: 2025-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DayZWorld 系统迁移说明文档

## 项目概述

DayZWorld是一个DayZ服务器管理工具，包含前端界面和后端服务，允许用户通过Web界面配置和管理DayZ服务器。

## 系统要求

### 1. 必备软件

- **Node.js LTS 版本**
  - 下载链接: [https://nodejs.org/](https://nodejs.org/)
  - 安装时务必勾选"Add to PATH"选项
  - 推荐版本: Node.js 18.x 或更高版本

- **DayZ Server**
  - 服务器文件需放置在 `DayZServer` 目录下
  - 确保 `DayZServer_x64.exe` 可执行文件存在

### 2. 项目结构

```
DayZWorld/
├── DayZServer/          # DayZ服务器目录
├── backend/             # 后端服务
├── frontend/            # 前端界面
├── start_system.bat     # 系统启动脚本
├── config.json          # 全局配置文件
```

## 迁移步骤

### 1. 复制项目文件

将整个 `DayZWorld` 文件夹复制到新电脑的任意位置（建议使用英文路径）。

### 2. 安装Node.js

1. 在新电脑上下载并安装Node.js LTS版本
2. 安装完成后，打开命令提示符验证安装:
   ```
   node -v
   npm -v
   ```
   这两个命令应显示Node.js和npm的版本号

### 3. 检查DayZ服务器目录

确保 `DayZServer` 目录结构完整，包含必要的服务器文件。

## 启动系统

### 方法一：使用启动脚本（推荐）

1. 双击 `DayZWorld` 目录下的 `start_system.bat` 文件
2. 脚本会自动：
   - 检查Node.js安装
   - 安装后端依赖
   - 启动后端服务（端口5000）
   - 安装前端依赖
   - 启动前端开发服务器（端口3000）

### 方法二：手动启动（备用）

#### 启动后端服务

1. 打开命令提示符
2. 进入后端目录：
   ```
   cd DayZWorld\backend
   ```
3. 安装依赖：
   ```
   npm install
   ```
4. 启动服务：
   ```
   npm start
   ```

#### 启动前端服务

1. 打开另一个命令提示符
2. 进入前端目录：
   ```
   cd DayZWorld\frontend
   ```
3. 安装依赖：
   ```
   npm install
   ```
4. 启动开发服务器：
   ```
   npm run dev
   ```

## 访问系统

1. 打开浏览器
2. 访问前端界面：[http://localhost:3000](http://localhost:3000)
3. 后端API服务运行在：[http://localhost:5000](http://localhost:5000)

## 常见问题及解决方案

### 1. Node.js未找到错误

- 确保已正确安装Node.js
- 检查环境变量中是否包含Node.js路径
- 重新启动命令提示符或计算机

### 2. 端口占用问题

- 如果端口5000被占用，可以修改 `backend/server.js` 中的 `PORT` 常量
- 如果端口3000被占用，可以修改 `frontend/package.json` 中的启动脚本

### 3. 依赖安装失败

- 确保网络连接正常
- 尝试使用管理员权限运行命令提示符
- 清理npm缓存后重试：
  ```
  npm cache clean --force
  npm install
  ```

### 4. DayZ服务器连接问题

- 确保 `DayZServer` 目录路径正确
- 检查 `config.json` 中的服务器配置是否正确
- 确保服务器端口未被防火墙阻止

## 项目依赖说明

### 后端依赖
- Express.js - Web服务器框架
- CORS - 跨域资源共享中间件
- Node.js内置模块(fs, path, child_process等)

### 前端依赖
- React - 前端UI库
- Bootstrap/React-Bootstrap - UI组件库
- Vite - 构建工具
- Axios - HTTP客户端
- React Toastify - 通知组件

## 注意事项

1. 首次运行时，系统会自动创建默认的 `config.json` 配置文件
2. 建议定期备份 `DayZServer` 目录下的服务器配置和数据
3. 修改配置后，可能需要重启后端服务才能生效
4. 如需构建生产版本的前端代码，请在前端目录执行 `npm run build`

## 技术支持

如有其他问题，请检查日志文件或联系系统管理员。

---

本文档最后更新时间: 2024年