Skip to content

Latest commit

 

History

History
205 lines (116 loc) · 9.16 KB

README_QuickStart.md

File metadata and controls

205 lines (116 loc) · 9.16 KB

CrazyCar

视频教程

一、前端环境 视频

二、服务端环境

2.1 数据库 视频

2.2 Java环境 视频

2.3 VSCode 视频

三、后台环境 视频

运行

  1. 用Unity(2021.3.9及以上)打开CrazyCar -> CrazyCarClient项目；

  2. 在Unity中设置Login场景中的NetworkController，设置成Local(当然你不愿意部署服务器，也可以使用Remote，那就可以跳过下面所有的步骤)；

  3. 启动Mysql，并运行CrazyCar -> CrazyCarDB中的CrazyCar.sql脚本，部署数据库，注意Mysql账号和密码需要和配置文件保持一致

  4. 配置Java环境(JDK17)：官网下载JDK17 (win10请下载exe,Mac下载dmg不要下载zip自己配置)-->配置系统环境变量 详细教程

  5. 配置Maven环境：官网下载 --> 配置环境变量 详细教程

  6. VScode安装Spring Boot开发插件：Extension Pack for Java、Spring Initializr Java Support、Maven for Java、Community Server Connectors(原Tomcat)、Lombok

  7. VS code配置Java和Maven路径*(此路径为在Editor运行时的加载路径，打包时需要本地环境变量配置好maven与jdk相关路径)*，Mac 和Windows示例如下：

  8. 使用VScode打开文件夹：CrazyCarServer，F5启动项目

  9. 服务端运行成功后，即可运行Unity客户端；

  1. 如果你是第一次部署服务器，可能会出现Mysql运行脚本、VScode配置Java、Maven环境加载失败等问题，请自行Google！
  2. 游戏支持单机模式，如果你没有服务器，也可以进行打版测试(直接Build出版本就行)
  3. Apifox接口测试分享
  1. 安装nodejs，使用VScode打开文件夹：CrazyCarBackground，然后在终端运行npm install安装依赖，最后使用npm run dev运行即可 (此模块按需求部署即可，详细操作文档)

环境版本

  1. Unity 2021.3.12
  2. VS 2019
  3. JDK 17
  4. MySQL 8.0.26
  5. Tomcat 8.0.52
  6. Nginx 1.20.1
  7. Nodejs 16.16.0

环境配置

  • 服务器配置流程（windows）

    graph LR
start-->购买服务器-->配置Java环境-->配置Web服务器(Tomcat)-->配置Mysql
    Loading

  • 客户端配置流程（Windows/Mac）

    graph LR
start-->配置Java环境-->配置Maven环境-->配置Web服务器(Tomcat)-->配置Mysql-->配置VScode开发环境-->安装Unity
    Loading

  • 配置服务器基本属性a

    1. 购买云服务器 华为云

    2. 设置云服务的安全组入口 ，华为云初始化会有三个安全组，其中有一个Web Server组是用来做Web开发的，它已经把80、443等网络端口开放，当然也可以自己去设定比如开放8080(Tomcat)、8081(Spring Boot服务端)、50001(KCP设置端口)、3389(Mysql)

游戏引擎

Unity 2021.3.12 及以上

添加新的热更类型

以添加新类型Medal(勋章)为例

  1. CrazyCar\CrazyCar\Assets\AB文件夹下添加新的文件夹Medal
  2. 相应的资源放入此文件夹
  3. 打开Windows -> Asset Management -> Groups窗口
  4. 点击Create创建新的Group，命名为Medal
  5. 将资源拖入此分组
  6. 点击Build -> New Build，进行生成增量包 (请自行百度Addressable了解生成新包和增量包的区别)
  7. 将CrazyCar\CrazyCar\Assets\StreamingAssets下生成的包放入CrazyCar\CrazyCarServer\src\main\webapp重新生成War/Jar包发布到服务端即可
  8. 具体分组的参数设置可以查看此文章

添加头像

  1. 将头像放入Assets -> AB -> Avatar 文件夹
  2. 将新头像拖入Windows -> Asset Management -> Groups窗口，中的Avatar分组
  3. 在数据库avatar_name表中添加新的头像信息，ID字段为头像名
  4. 运行Unity，进行查看
  5. 点击Build -> New Build，进行生成新包
  6. 将CrazyCar\CrazyCar\ServerData下生成的包放入CrazyCar\CrazyCarServer\src\main\webapp重新生成War/Jar包发布到服务端即可

自动化打版

  1. Android、PC和IOS都是直接点击Build -->Local(过程中会让你选择目标文件夹)，进行打版，Remote为使用线上服务器。
  2. 如果没有服务器，游戏支持单机模式，但是只能使用主功能，直接使用File --> BuildSettings --> Build即可。

添加装备

  1. 复制一个CrazyCar --> CrazyCar --> Assets --> AB --> Equip--> Items文件夹下个任意一个Prefab ，并重命名
  2. 将你的装备的Icon、Material、Mesh放入CrazyCar --> CrazyCar --> Assets --> AB --> Equip对应的文件夹
  3. 双击开你的Prefab修改Prefab对应的信息，在复制好的基础上进行处理你要添加你的装备(当然你也可以重新制作一个新的，最后将EquipResource脚本放在根节点，并填好信息即可)
  4. 将新装备prefab拖入Windows -> Asset Management -> Groups窗口，中的Equip分组
  5. 在数据库all_equip表中添加装备信息
  6. 运行Unity，进行查看
  7. 点击Build -> New Build，进行生成新包
  8. 将CrazyCar\CrazyCar\ServerData下生成的包放入CrazyCar\CrazyCarServer\src\main\webapp重新生成War/Jar包发布到服务端即可

增加TimeTrial关卡

  1. 在数据库time_trial_class表中添加关卡信息即可

    map_id为0-4，因为现在就5张图

增加比赛

  1. 在数据库match_class表中添加关卡信息即可

map_id为0-4，因为现在就5张图

添加地图

  1. 在Unity中打开MapController.prefab，添加你的地图

  2. 将新图拖入到MapController中的MapsGO中

  3. 从Map0中复制一份CheckpointController，到新地图，并将CheckpointController里面的Checkpoint和EndSign，移动到相应的位置

  4. 从Map0中复制一份MiniMap，到新地图，将MiniMap下Plane中的Material换成新地图的素材

  5. 打开Game场景，将新地图的Scale调整的和现有地图大小相似

  6. 地图的起点位置为，Game场景中StartPos所在的位置

  7. 添加路线

    • 添加Path空物体

    • 在Path空物体下添加空物体PathCreator

    • 给PathCreator添加PathCreator组件

    • 通过Shift+左鼠标键添加节点，Ctrl+左鼠标键删除节点，制作地图路线

      详情操作可以查看Path Creator - Google 文档

  8. 可以在TimeTrial添加相应的关卡进行测试

添加多语言

  1. 打开Tools --> Translate窗口

    Guidance0

  2. 输入要翻译的文案数量以及内容，点击显示翻译按钮

  3. 查看翻译内容是否合适

  4. 点击添加翻译按钮，文案就会自动添加到CrazyCar\CrazyCar\Assets\Resources\Language\Locales对应的文件里

添加新手教程

  1. 在需要添加新手教程的页面添加Guidance预制体

    Guidance0

  2. 设置Guidance参数

    Guidance0

    • CanvasType Guidance组件需要提供UI所在的父物体Canvas组件，在Index场景是通过UIController脚本管理所以页面，如果新增页面，有新的Canvas，需要在GuidanceSystem脚本进行添加并赋值，可以参考UIController操作过程

    • GuidanceType

      可以设置点击区域是圆形还是矩形

    • IsClick

      区域是否需要点击功能，如AvatarUI的这个关闭按钮不需要实现关闭AvatarUI页面功能，则不勾选

    • 每个Guidance都需要新建一个Material(复制一份现有的AvatarGuidanceMat重命名就可以)

    注：完成标识符为UserModel中的IsCompleteGuidance，完成条件为点击计时赛按钮