Cosmic开源项目安装与配置指南

Cosmic开源项目安装与配置指南

Cosmic MapleStory Global v83 server emulator 项目地址: https://gitcode.com/gh_mirrors/cosmic9/Cosmic

1. 项目基础介绍

Cosmic是一个开源的服务器模拟器，旨在模拟全球MapleStory（GMS）版本83的游戏服务器。这个项目始于2021年，基于多年的服务器模拟器代码发展而来。主要使用的编程语言是Java，同时项目中还包含了一些JavaScript编写的脚本。

2. 项目使用的关键技术和框架

• Java：项目的主要编程语言，用于实现游戏逻辑和服务器功能。
• JavaScript：用于编写一些辅助脚本。
• Maven：作为项目管理和构建的工具，用于自动化构建过程和依赖管理。
• GitHub Actions：用于实现持续集成，自动化运行测试和构建过程。
• Docker：提供容器化支持，便于部署和运行服务器。
• MySQL：用于存储游戏数据，如账户、角色和物品等。

3. 项目安装和配置准备工作

在开始安装和配置前，请确保您的系统中已安装以下软件：

• Java Development Kit (JDK) 21：Java的软件开发工具包，用于编译和运行Java程序。
• Git：版本控制系统，用于从GitHub上克隆项目代码。
• MySQL Community Server 8+：数据库服务器，用于存储游戏数据。
• HeidiSQL：图形化的MySQL客户端，用于数据库操作。
• IntelliJ IDEA 或其他Java IDE（可选）：用于更方便地开发Java程序。
• Docker Desktop（可选）：如果需要使用Docker来运行服务器。

安装步骤

步骤 1：安装MySQL和HeidiSQL

1. 下载并安装MySQL Community Server。
2. 设置root密码，并确保记住它。
3. 下载并安装HeidiSQL。

步骤 2：准备数据库

1. 使用HeidiSQL连接到MySQL数据库。
2. 运行项目database/sql目录下的四个SQL脚本，以创建和配置数据库。

步骤 3：克隆项目代码

1. 使用Git克隆项目代码到本地：

   git clone https://github.com/P0nk/Cosmic.git
   

2. 在IntelliJ IDEA或其他IDE中打开克隆的项目。

步骤 4：配置项目

1. 打开config.yaml文件。
2. 设置DB_PASS为您的MySQL root用户密码。

步骤 5：构建和运行项目

1. 在项目根目录下运行以下命令来构建项目：

   ./mvnw.cmd clean package
   

2. 运行launch.bat文件或在IDE中运行net.server.Server类的主方法来启动服务器。

步骤 6：运行Docker容器（可选）

1. 在项目根目录下运行以下命令来启动Docker容器：

   docker compose up
   

2. 如果需要重新构建容器，运行：

   docker compose up --build
   

步骤 7：安装和配置游戏客户端

1. 从官方源下载并安装MapleStory游戏客户端。
2. 删除客户端安装目录下的HShield文件夹、ASPLnchr.exe、MapleStory.exe和Patcher.exe。
3. 下载项目的WZ文件并替换安装目录下的对应文件。
4. 下载并放置HeavenMS-localhost-WINDOW.exe到游戏安装目录。

完成以上步骤后，您应该可以成功运行Cosmic服务器，并使用修改过的客户端连接到您的本地服务器。祝您游戏愉快！

Cosmic MapleStory Global v83 server emulator 项目地址: https://gitcode.com/gh_mirrors/cosmic9/Cosmic