4399年初大作

4399年初大作专属本地私服零门槛搭建实操全流程指南

一、前期准备

1. 工具清单&下载地址

• 4399年初大作官方开源服务端包：https://github.com/4399opensoft/newyear-game-server/releases/tag/v1.0.0（选择v1.0.0正式版下载即可）
• JDK11（服务端运行依赖）：https://adoptium.net/zh-CN/temurin/releases/?version=11（选择对应操作系统的安装包，默认路径安装）
• MySQL8.0（数据存储依赖）：https://dev.mysql.com/downloads/mysql/8.0.html（安装时设置root账号密码，记住后续要用到）
• Nginx1.24（前端资源托管依赖）：https://nginx.org/en/download.html（选择稳定版解压即可）

2. 环境校验

安装完成后打开命令行工具（Windows按Win+R输入cmd，Mac按Command+空格输入终端），依次执行以下命令：

• 输入java -version，返回openjdk 11.x.x版本信息即为安装成功
• 输入mysql -V，返回mysql 8.0.x版本信息即为安装成功

重要提醒：所有文件解压路径不要包含中文、空格和特殊字符，否则会出现启动失败问题

二、服务端部署实操步骤

1. 数据库初始化配置

• 打开MySQL命令行，输入安装时设置的root密码进入数据库控制台
• 执行数据库创建命令：CREATE DATABASE game_2024_new DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci;
• 解压下载的服务端包，找到sql文件夹内的init.sql文件，复制其绝对路径（比如D:\game-server-2024\sql\init.sql）
• 在命令行执行导入命令：mysql -u root -p game_2024_new < 你复制的init.sql绝对路径，输入root密码等待执行完成
• 验证导入结果：在MySQL控制台执行use game_2024_new; show tables;，返回28张表即为导入成功

2. 核心配置文件修改

解压服务端包到D盘根目录，打开conf文件夹内的application.yml文件，替换为以下完整配置，只需修改MySQL root密码即可：

```yaml server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/game_2024_new?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: 替换为你自己的MySQL root密码 driver-class-name: com.mysql.cj.jdbc.Driver game: 本地调试模式，无需验证4399官方账号 debug: true max-online: 100 新春活动奖励倍数，可根据需求自行修改1-100 reward-multiple: 10 ```

3. 服务端启动验证

• 打开命令行，进入服务端bin目录（比如D:\game-server-2024\bin）
• Windows系统执行startup.bat，Mac/Linux系统执行sh startup.sh
• 等待30秒后打开浏览器，访问http://127.0.0.1:8080/health ，返回{"code":200,"msg":"success"}即为服务端启动成功

三、客户端适配实操步骤

1. 前端资源部署

• 解压服务端包内的client文件夹到D盘根目录，路径改为D:\game-client-2024
• 打开Nginx解压目录下的conf文件夹，找到nginx.conf文件，替换为以下完整配置：

```nginx worker_processes 1; events { worker_connections 1024; } http { include mime.types; default_type application/octet-stream; sendfile on; keepalive_timeout 65; server { listen 80; server_name localhost; 此处替换为你自己的client文件夹路径，分隔符用/ root D:/game-client-2024; index index.html; location /api { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; } } } ```

• 启动Nginx：Windows系统双击nginx.exe，Mac/Linux系统执行sudo nginx
• 验证：打开浏览器访问http://localhost ，能看到游戏登录界面即为资源部署成功

2. 测试账号配置

打开MySQL控制台，执行以下SQL语句即可生成VIP10、999万金币、无限体力的测试账号：

```sql INSERT INTO `user` (`username`, `password`, `vip_level`, `gold`, `power`) VALUES ('test001', '123456', 10, 9999999, 999999); ```

执行完成后即可用账号test001、密码123456登录游戏，所有新春活动奖励正常领取

四、常见问题排查

• 服务端启动失败：检查8080端口是否被占用，Windows执行netstat -ano | findstr 8080，Mac/Linux执行lsof -i:8080，找到对应PID后结束进程即可
• 游戏加载失败：检查Nginx配置内的root路径是否正确，路径分隔符必须用/，不要用\，不要包含中文
• 登录提示账号不存在：检查SQL插入语句是否执行成功，确认账号密码输入时没有多余空格
• 新春奖励不到账：检查application.yml内的reward-multiple配置是否大于0，修改后必须重启服务端生效

五、自定义功能拓展实操

• 修改奖励倍率：直接修改application.yml内的reward-multiple值，范围1-100，修改后重启服务端即可生效
• 解锁全皮肤：执行SQL语句UPDATE user SET skin_all=1 WHERE username='你的账号';即可解锁所有新春限定皮肤
• 局域网共享：打开电脑防火墙放行80和8080端口，查看本机局域网IP（比如192.168.3.15），朋友输入该IP即可一起联机游玩，进度互通