魔卡幻想online

一、前置环境与资源准备

1.1 安装Java运行环境

魔卡幻想Online服务端基于Java8开发，必须安装对应版本才能运行，操作步骤如下：

• 点击链接直接下载64位Windows版OpenJDK8：https://cdn.azul.com/zulu/bin/zulu8.68.0.21-ca-jdk8.0.362-win_x64.zip
• 下载后将压缩包内所有内容解压到D:\jdk8路径，路径不能包含中文和空格
• 右键此电脑 → 属性 → 高级系统设置 → 环境变量，在系统变量区域点击新建
• 变量名输入JAVA_HOME，变量值输入D:\jdk8，点击确定
• 找到系统变量中的Path变量，点击编辑，新建两条记录分别填入：%JAVA_HOME%\bin、%JAVA_HOME%\jre\bin
• 依次确定保存所有设置，按Win+R输入cmd打开命令提示符，执行java -version，输出版本号即配置成功

1.2 下载服务端与客户端安装包

本文使用开源怀旧版魔卡幻想Online服务端，直接点击链接下载即可：

• 服务端源码压缩包：https://github.com/CandyChang/MoCardFantasy/archive/refs/heads/master.zip
• 安卓客户端安装包：https://github.com/CandyChang/MoCardFantasy/releases/download/v1.0/mocrad-android.apk

将服务端压缩包解压后，把所有内容放到D:\mocrad路径，注意不要出现多层嵌套文件夹，确保打开D:\mocrad直接能看到pom.xml文件。

1.3 安装配置MySQL数据库

服务端需要MySQL存储游戏数据，操作步骤如下：

• 下载Windows版MySQL8压缩包：https://cdn.mysql.com/Downloads/MySQL-8.0/mysql-8.0.33-winx64.zip
• 解压到D:\mysql8路径，打开cmd，执行cd D:\mysql8\bin切换目录
• 执行.\mysqld --initialize --console，复制输出末尾的临时密码保存好
• 依次执行以下命令完成安装启动：.\mysqld --install → net start mysql
• 执行mysql -u root -p，粘贴刚才的临时密码回车登录
• 登录后执行以下命令修改密码并创建游戏数据库：

  ```
  ALTER USER 'root'@'localhost' IDENTIFIED BY '123456';
  create database mocrad default character set utf8mb4;
  exit;
  ```
  

二、服务端配置与启动

2.1 修改数据库配置文件

打开D:\mocrad\src\main\resources\application.properties，用记事本打开，删除原有所有内容，直接复制粘贴以下完整配置：

```
server.port=8080
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/mocrad?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=123456
spring.jpa.hibernate.ddl-auto=update
logging.level.org.hibernate=error
```

注意：如果你修改了MySQL的root密码，只需要修改上述配置中最后第二行的password值，其他内容不需要改动。

2.2 打包启动服务端

打开cmd，依次执行以下命令：

• cd D:\mocrad 切换到服务端目录
• .\mvnw.cmd clean package 打包项目，等待执行完成，出现BUILD SUCCESS即为打包成功
• java -jar target/mocrad-1.0.jar 启动服务端

第一次启动会自动创建数据库表，等待1-2分钟，命令行输出Started MoCardFantasyApplication即代表服务端启动成功，不要关闭该命令行窗口。

三、客户端配置与进入游戏

3.1 配置服务器地址

将下载好的安卓客户端安装包传到手机/电脑安卓模拟器中，完成安装后打开，操作如下：

• 点击登录页右下角的设置按钮，进入服务器配置页
• 手机真机：需要保证手机和电脑连接同一个WiFi，按Win+R打开cmd，执行ipconfig，找到你当前联网网卡的IPv4地址，比如192.168.1.10，在配置栏输入你的IPv4地址:8080，比如192.168.1.10:8080
• 电脑安卓模拟器：直接在配置栏输入10.0.2.2:8080即可
• 点击保存配置返回登录页

3.2 常见问题排查

• 无法连接服务器：关闭电脑系统防火墙，检查手机和电脑是否同WiFi，确认服务端已经正常启动，IP地址输入正确
• 打包失败：检查JAVA_HOME环境变量配置是否正确，切换稳定网络重新执行打包命令
• 启动报错：检查3306端口是否被其他程序占用，检查数据库密码是否和配置文件一致

四、开始游戏体验

在客户端登录页输入任意用户名和密码，点击注册即可自动登录进入游戏，原版魔卡幻想Online的所有卡牌、副本、竞技场均可正常使用，本地搭建后可自定义调整钻石、卡牌等级，完全离线也可正常游玩。