# ms079

**Repository Path**: netherworld/ms079

## Basic Information

- **Project Name**: ms079
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-24
- **Last Updated**: 2026-09-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

ms079
=====

冒险岛 v079 版本，是大巨变前最经典的版本。

---

## 一、环境准备

**所有环境**，必须安装数据库：

- [MySQL 5.7.30+][3] （提取码：6ifn）
  - 注意，原版本在 MySQL 4.x 环境下运行，我自己的服务器，使用阿里云的 5.7.32-log 版本，可以正常运行

### 1.1 开发环境

- [JDK 1.8][1]：用于本地编译，项目仍以 Java 8 作为编译目标
- [JDK 21][8]：当前服务端运行时使用 Java 21，配合 `nashorn-core` 执行旧版 js 脚本
- [IntelliJ IDEA][2]：推荐使用的开发工具

启动入口是 `server.Start` 的 `main` 方法。

### 1.2 运行环境

手工运行当前版本必须安装 [JDK 21][8] 运行环境；测试环境由 Docker 运行镜像提供 Java 21，不要求 Jenkins 宿主机直接安装 Java。

必须设置 `JAVA_HOME` 环境变量。

Linux 服务器参考 `启动服务器-命令行.bat` 逐一执行命令即可启动，有时间我再翻译为 `.sh` 脚本。

Windows 系统或服务器，启动脚本二选其一。

## 二、如何编译？

通常使用 IDEA 工具或 [Maven][4] 插件进行编译操作。

**更新：目前已加入 assembly 编译插件，可以同时打包 `wz` 和 `脚本` 以及其他资源到 `ms079-[version]-dist.zip` 压缩文件中。**

**提示：此压缩文件可以作为发布包使用，只需要解压出来，安装运行环境，以及初始化数据库，然后运行即可。**

### 2.1 IDEA 工具

以下方式任选其一：

1. 不想使用 Maven 的话，参考 `Build Artifacts` 教程，它可以将所有依赖库添加到 jar 包中，因此可以通过 `java -jar xxxx.jar` 方式直接运行
2. 点击工具上方的 `Build` 菜单，生成编译文件
3. 使用 `Ctrl + F9` 快捷键，执行 `Build` 命令，生成编译文件
4. 展开工具右侧栏 Maven 菜单中的 Lifecycle 选项，双击 `compile` 命令，生成编译文件

**需要打包为 `ms079-[version].jar` 的话，在第四种方式中，替换 `compile` 为 `package` 即可。**

### 2.2 Maven 插件

在项目根目录下打开 CMD 工具（需要安装 Maven 插件）：

- 编译命令：`mvn clean compile`
- 打包命令：`mvn clean package`

**注意，Maven 命令也可以从 IDEA 中运行，使用 `Alt + F12` 快捷键（内置 Maven 插件）即可。**

### 2.3 测试环境 Jenkins + Harbor 发布

测试环境不再直接把开发机的编译目录复制到服务器，而是由 Jenkins 在测试机上完成以下流水线：

```text
其它机器修改代码
    ↓ push 到 Gitee master
Jenkins webhook 触发流水线
    ↓ Maven assembly 编译并生成发布包
构建 Docker 镜像
    ↓ 推送 Harbor：127.0.0.1/ms079/ms079-server:<构建标签>
拉取不可变镜像并重建 ms079-server 容器
    ↓ 检查 9595、7576、7577、7578、8600 端口
测试环境发布完成
```

仓库中的 `Dockerfile` 会在 Java 8/Maven 构建镜像中执行 `mvn clean package`，再把 assembly 发布包放入 Java 21 运行镜像。这样既保持 Java 8 的目标字节码，又满足当前 Nashorn 兼容依赖的 Java 11+ 运行要求。测试环境的 `服务端配置.ini` 和日志目录留在宿主机，通过 `deploy/docker-compose.test.yml` 挂载，因此数据库密码不会写入镜像或 Jenkinsfile。

测试机首次配置：

1. 在 Harbor 创建项目 `ms079`，并让 Jenkins 使用有推送权限的 Harbor 凭据登录 `127.0.0.1`。
2. 在 Jenkins 创建“Pipeline script from SCM”任务，仓库使用 `git@gitee.com:netherworld/ms079.git`，分支使用 `*/master`，脚本路径使用 `Jenkinsfile`。Jenkins 节点需要具备 Docker、Docker Compose、Java 8/Java 21 基础镜像和访问本机 Harbor 的权限。
3. 复制 `deploy/test.env.example` 为测试机上的 `/home/lizhijie/.config/ms079/test.env`，确认 `MS079_CONFIG_PATH` 指向测试环境实际配置文件，并确保该文件不被提交到 Git。
4. 在 Gitee 仓库配置 Push Webhook，指向 Jenkins 的 Generic Webhook Trigger 地址；在 Jenkins 任务中设置 webhook token，并将分支过滤为 `refs/heads/master`。token 只放在 Jenkins 任务配置中，不要写进仓库。
5. 第一次发布前确认测试机上的配置文件、Harbor 项目和 Docker 权限均已准备好，再由 Jenkins 手工执行一次流水线。之后每次 push 到 `master` 都会自动编译、推送和发布。

第一次 `Deploy test` 会精确接管测试机上现有的 `ms079-server` 同名手工容器；脚本只处理这个固定容器名，不会清理其它服务。

Jenkins 流水线会为每次构建生成 `jenkins-<构建号>-<短提交号>` 镜像标签，同时更新 `test` 标签。失败时可在 Jenkins 中执行回滚任务，或在测试机执行：

```bash
ROLLBACK_IMAGE=127.0.0.1/ms079/ms079-server:<上一个构建标签> \
  bash scripts/jenkins-release.sh rollback
```

完整发布动作也可以在测试机手工执行：

```bash
IMAGE_TAG=jenkins-<构建号>-<短提交号> bash scripts/jenkins-release.sh all
```

该命令会重建测试环境容器，但不会初始化或修改数据库。服务启动和重启应由 Jenkins 发布阶段执行，开发机只负责修改代码并 push。

## 三、初始化数据库

IDEA 社区版不支持数据库操作。

IDEA 旗舰版可以连接数据库，然后找到 `db/ms079.sql` 文件，右键运行。记得先连接数据库，选好默认的 schema 实例。

另外，还可以下载 [Navicat Permium 15][5] 工具（提取码：`j6lt`），来执行操作：

1. 连接本地 MySQL 数据库
2. 创建名为 ms079 的数据库实例，编码为 `utf-8`
3. 在数据库上右键，选择 Execute SQL File...
4. 找到 `db/ms079.sql` 文件，点击开始执行

## 四、如何运行？

运行分两步：首先启动服务端，然后安装客户端进行登录。

### 4.1 启动服务端

**前提是 `JAVA_HOME` 环境变量正常，以及数据库初始化完毕。**

1. 打包（已有 `ms079-[version]-dist.zip` 文件，可忽略此步骤）
   - 展开 IDEA 右侧栏 Maven 菜单中的 `Lifecycle` 选项
   - 双击 `clean` 清理旧文件
   - 双击 `package` 进行打包
   - 确定已生成 `/target/ms079-[version]-dist.zip` 文件
   - 【可选】或者通过 Maven 插件，在根目录下使用 `mvn clean package` 命令进行打包
2. 解压 zip 文件到某一个文件夹
3. 进入文件夹，修改 `服务端配置.ini` 配置文件中的参数（主要是数据库的账号密码）
4. 打开 `启动服务端-GUI.bat`，点击【启动服务端】按钮
5. 【可选】或打开 `启动服务端-命令行.bat`
6. 等待显示【启动成功，可以进入游戏】类似的信息即可

**注意，当前版本通过 `nashorn-core` 提供旧版 js 引擎，运行服务端请使用 Java 21。**

**提示：`ms079-[version]-dist.tar.gz` 文件是 Linux 服务器的压缩文件，目前没有经过 Linux 服务器的测试。**

### 4.2 客户端登录

1. 安装 [冒险岛v079客户端][6]
2. 删除客户端中的 HShield 目录，下载 [079 私服过 HS 文件][7] （提取码：`7i0u`）进行替换
4. 拷贝 `V079登录器.bat` 到客户端下，双击运行
    - 如需联网：请编辑 `服务端配置.ini` 和 `V079登录器.bat` 中的相关 IP 地址和端口
    - 简单起见：仅将所有的 `127.0.0.1` 修改为服务器 IP 地址，端口保持原样
    - **云服务器还需要在安全组中，打开对应的端口授权，切记切记**

---

# 声明

仅供个人学习交流使用，不得用于任何商业途径，请在下载 24 小时后删除。



[1]:https://alywp.net/5whNJG
[2]:https://www.jetbrains.com/idea/
[3]:https://pan.baidu.com/s/1v-2jXg9xqNmo5ww5YjUhQQ
[4]:https://maven.apache.org/download.cgi
[5]:https://pan.baidu.com/s/1kZwb2ZdOjf5ZG_HPkWtwWQ
[6]:https://alywp.net/2bBtbJ
[7]:https://pan.baidu.com/s/1gAOhxhwxd1T4bqX8HSoFNQ
[8]:https://adoptium.net/temurin/releases/?version=21