Siki_Unity_7-4_高自由度沙盘游戏地图生成_MineCraft_Uniblocks插件（可拓展）

Unity 7-4 高自由度沙盘游戏地图生成 MineCraft
(插件Uniblocks)

任务1&2&3&4 素材 && 课程演示 && 课程简介

使用插件Uniblocks Voxel Terrain v1.4.1 -- 专用于生成方块地图 （该插件目前在AssetStore中不可用）
　　讲解博客：https://blog.csdn.net/qq_37125419/article/details/78339771
　　官方地址：
　　　　https://forum.unity.com/threads/uniblocks-cube-based-infinite-voxel-terrain-engine.226014/

课程内容：
　　生成地形
　　创建新的方块
　　摆放/删除方块元素
　　地图数据的保存/加载
　　后续开发的扩展

任务5：创建工程 导入插件

将Uniblocks Voxel Terrain v1.4.1.unitypackage导入新建工程MineCraftMapGenerator

删除多余文件（高亮）
Standard Assets -- 角色控制
Uniblocks -- 地形生成
　　UniblocksAssets -- DemoScene, Models, Meshes, Textures, Materials等
　　UniblocksDocumentation -- 文档
　　UniblocksObjects -- Prefabs: 比如blocks，Engine，Chunks等
　　UniblocksScripts -- Scripts

打开Demo.unity
　　

Uniblocks Dude -- 主角
Engine -- 游戏启动核心
SimpleSun -- 太阳光
selected block graphics -- 选中的方块
crosshair -- 十字准心

游戏操作：

空格：跳跃； WASD：行走

任务6：Uniblock中对方块生成的组织管理方式

对方块的管理方式：
　　Engine引擎-->ChunkManager大块管理器　　Chunk大块　　VoxelInfo小块
　　每一个Block是一个小块，多个小块构成一个Chunk大块
　　　　小块不是单个游戏物体，Chunk才是
　　　　　　-- 如果每个小块都是单独的游戏物体，都需要进行渲染：耗费性能
　　　　　　https://blog.csdn.net/qq_30109815/article/details/53769393

Engine物体中有三个脚本
　　Engine.cs -- 配置生成地图所需要的信息
　　ChunkManager.cs -- 存放一个集合，管理所有的Chunk，Chunk负责各自内部的VoxelInfo小块
　　ConnectionInitializer.cs -- 多人游戏

Voxel.cs -- 每种小块的共同属性
VoxelInfo.cs -- 一个大块下的小块们的信息（如位置等）
　　详见任务19

任务7：Block、Voxel和VoxelInfo的区别与联系、禁用抗锯齿

Block是小块，没有对应类，但是有对应的Prefab（block0~block9)

每一个Block的prefab中都被添加了一个Voxel.cs的脚本 -- 确定了方块的种类
　　Voxel：体素，体素是体积元素（Volume Pixel）的简称

当一个Block在Scene中被创建出来的时候，就多了一个VoxelInfo.cs的脚本，用于表示在Chunk中的位置

抗锯齿：
　　Console中的警告：
　　Uniblocks: Anti-aliasing is enabled. This may cause seam lines to appear between blocks. If you see lines between blocks, try disabling anti-aliasing, switching to deferred rendering path, or adding some texture padding in the engine settings.

我们会发现，在有的地方，方块之间会出现一条白线，这是渲染造成的问题
解决方法：Edit->Project Settings->Quality->Anti-Aliasing = Disabled; 关闭抗锯齿即可

任务8：最简单的地图生成方式

创建文件夹Scenes，创建简单的场景Simple

1. 在scene中创建Uniblocks->UniblocksObjects->_DROPTHISINTHESCENE->Engine

2. 创建空物体，添加脚本ChunkLoader.cs
　　ChunkLoader的作用为 启用Engine（相当于开始发动的驾驶员）
　　地形是围绕ChunkLoader的位置生成的（与y坐标无关）
　　很多时候ChunkLoader游戏物体为角色本身，因为需要将围绕角色生成地形
　　　　地形的高度不会超过48，因此可以将角色的高度调至48以上，表示生成时角色在地图上方

任务9：地图生成大小的设置 + Chunk的产生和销毁
&10：Chunk生成的变化高度和大小
&11：大块贴图、网格、碰撞器的设置
&12：数据保存和加载

在菜单栏Window中会发现两个新增的选项：
　　UniBlocks-BlockEditor
　　UniBlocks-EngineSettings

这两个选项分别对应UniblocksScripts->Editor中的两个脚本BlockEditor.cs和EngineSettings.cs

WorldName：与自动创建的Worlds文件夹下的TextWorld文件夹对应，
　　每一个WorldName会对应一个文件夹，里面保存着世界的数据

Chunk相关：
ChunkSpawnDistance=8：地图大小，以ChunkLoader为中心分别朝四周扩展8个Chunk
　　当ChunlLoader移动时，会保证四周都有8个Chunk（新生成chunk补上）
ChunkDespawnDistance=3：销毁已生成的远距离(超过该距离8+3=11)的Chunk--基于性能考虑

ChunkHeightRange=3：整个地图中最高和最低不超过3个chunk的高度 (每个高度为ChunkSizeRange)
　　因此高度为48~-48之间变化
ChunkSideLength=16：每个Chunk管理16*16*16m的一个区域(高度不一定为16，但肯定不超过16)

贴图相关：
Uniblocks->UniblocksObjects->ChunkObjects->Chunk -- Prefab
　　生成Chunk的时候，根据这个prefab来生成Chunk，Chunk中的小块blocks再通过Mesh进行渲染
　　Mesh中有很多小格，需要给每个小格贴图--Chunk中的MeshRenderer.material=texture sheet指定贴图
　　每个小格的贴图都是从texture sheet中取得的
　　　　  -- 贴图可以以其他方式显示，如正方形
　　　　贴图的整体如图：
　　　　　　
　　　　　　贴图分成了 8*8 个小格，将所有小格的贴图存放在同一个贴图中 -- 性能优化（贴图越少性能越好）
　　　　　　增加小贴图，直接修改psd文件在空白处增加即可

TextureUnit=0.125：由于贴图分成8*8个小格，0.125即1/8
TexturePadding=0：小格与小格之间的空隙，比如空隙为1个pixel，值就是1/512
　　没有空隙的坏处是：由于美工裁剪的不精确，有可能出现把其他小格的部分也包括了，变成细缝

注意：Chunk是可以添加多个材质MeshRenderer.materials的，要求是这些材质的大小必须相同（便于裁剪成小格）

其他设置：

Generate Meshes: 是否生成Mesh网格
Generate Colliders: 是否生成碰撞体
Show Border Faces: 略，默认为false

事件有关：

Send Camera Look Events: 聚焦在Camera视野的中心 (十字准心 CrossHair)
Send Cursor Events: 聚焦在鼠标的位置

数据的保存和加载：

Save/ Load Voxel Data: 取消勾选时，重新加载场景的时候，会重新生成地图
　　如果勾选，在加载场景的时候，则会先判断本地是否有地图数据，如果有则加载。
　　-- 保存: 需要手动调用Engine中保存的方法；
　　-- 加载: 如果勾选时，会自动在开始场景的时候进行加载

在DemoScene中会有自动保存功能
　　

Multiplayer设置：

与地图同步有关，地图在Server端同步，Client从Server端得到数据

任务13：Block的有关设置（创建、修改、复制、删除）
&14&15&16：Block的Mesh、贴图、透明度和碰撞器设置

Window -> Uniblocks -> Block Editor

BlocksPath: 存储blocks的prefab的路径
　　之前说Chunk是生成单位，每个block并不会生成对应的游戏物体 -- 性能优化
　　那么这里的blocks的prefab是用来干什么的呢？
　　　　用来保存每一种blocks的属性，并不是用来实例化的

empty：每一个chunk由长*宽*高个blocks组成，那些空的部分就是由empty blocks填充的
　　比如一个chunk，除了表面显示的那部分blocks，下面的是dirt或其他blocks，上面的就是empty blocks了

创建：点击New block，修改属性即可
删除：直接删除在Project中的对应prefab即可
复制：直接修改需要复制的block的id值，按Apply，就能得到一个新的id的block，原来的block不变

block的属性：

id -- 每一种block的id是不同的，是identity

Mesh相关：
Custom mesh -- 默认的mesh是立方体，比如door和tall grass就是自定义的
Mesh -- 勾选了Custom Mesh后，需要指定自定义的mesh
Mesh Rotation -- 勾选了Custom Mesh后，可以选择Mesh Rotation，表示mesh的旋转 (None/ Back/ Right/ Left)
　　比如door：如果mesh rotation=back，则门是创建在格子的另一边

贴图相关：
当勾选了CustomMesh后，贴图就会使用默认的贴图 -- 在创建模型时就处理好贴图；
若没有勾选CustomMesh，则可以在这里选择Texture属性
　　Texture: 上面对texture sheet进行了讲解，它是一个 8*8的贴图，从左下角开始为 (0, 0)
　　　　之前在EngineSettings中设定了TextureUnit=0.125，
　　　　这里以坐标的方式指定贴图 (x, y)（横向为x轴，纵向为y轴），即可获取对应格子位置的贴图
　　Define Side Texture: 每个立方体有六个面，如果六个面的Texture不同，则需要勾选
　　　　比如grass：
　　　　　　grass的四周是半dirt半grass的显示，上方为grass，下方为dirt
　　　　　　所以 -- Top: (0,2); Bottom: (0,0); Right/ Left/ Forward/ Back: (0,1)

Material Index: 如果Chunk的MeshRenderer.material中有多个材质，则可以指定当前为第index个材质

透明度设置：

Transparency: Solid 不透明/ Semi Transparent 半透明/ Transparent 全透明
　　leave/ grass/ door为半透明
　　半透明和全透明的区别：
　　　　全透明会使中间部分没有显示，而半透明会显示中间部分，如：
　　　　
　　　　　　左图为全透明，右图为半透明，很明显，右图显示的更密集，因为把中间部分的叶子也显示出来了
　　　　　　上图为Scene视图，Game视图更加明显，也可以观察影子对比。

　　对于Solid的方块而言，若六面都有其他方块包裹，则Chunk会将其mesh删除，不再渲染 -- 性能优化

碰撞器设置：

Collider: 可以选择Cube/ Mesh/ None
　　一般为Cube，door为Mesh，tall grass为None

id=70的door open是后期添加的block，用来和id=7的door配对，开门以后door block就会转换为door open block了

Blocks宏观：
　　每个block的prefab上挂载一个Voxel.cs脚本，用于上述定义该block的属性，比如mesh/ 透明度等 -- 根据这个来渲染
　　　　渲染之后 (在Chunk中)生成脚本VoxelInfo，用于保存该block在该chunk中的位置信息
　　每个prefab上也有其他脚本比如DefaultVoxelEvents.cs，用于实现其他事件操作，比如当人走到该block中时需要怎样
　　在生成prefab

任务17：Block事件类的继承关系

基事件类：VoxelEvents.cs
　　里面是一些virtual的虚方法：-- 需要我们自定义去触发
　　　　Virtual详解：https://blog.csdn.net/songsz123/article/details/7369913
　　　　Virtual与Abstract -- https://www.cnblogs.com/zyj649261718/p/6256327.html
　　public virtual void OnMouseDown/Up/Hold (int mouseButton, VoxelInfo voxelInfo) {} // 当鼠标操作时

　　public virtual void OnLook (VoxelInfo voxelInfo) {} // 十字准心对准的block，会触发OnLook事件
　　　　-- 将selectedBlock的ui放置在十字准心对准的block的位置

　　public virtual void OnBlockPlace/Destroy/Change (VoxelInfo voxelInfo) {} // 放置/销毁/转换一个Block时触发
　　-- OnBlockPlace/Destroy/Change()都有对应的Multiplayer版本的方法
　　　　因为这些方法对环境造成了影响，需要做相应的Server端的同步

　　public virtual void OnBlockEnter/Stay (GameObject entering/stayingObject, VoxelInfo voxelInfo) {}
　　　　// 当player进入或停留在block上的时候会触发

事件脚本的调用是在一个临时的对象里面，所以不能在事件脚本里存储数据

其他事件类：
　　DefaultVoxelEvents
　　VoxelGrass
　　DoorOpenClose

　　其中，DefaultVoxelEvents继承自VoxelEvents类，为它的实现类。
　　　　DefaultVoxelEvents被挂载在普通没有特殊功能的block上
　　　　VoxelGrass和DoorOpenClose均继承自DefaultVoxelEvents
　　　　　　被分别挂载在Grass和Door上

　　DefaultVoxelEvents实现了
　　　　OnMouseDown()
　　　　OnLook()
　　　　OnBlockPlace/ Destroy()
　　　　OnBlockEnter()

　　VoxelGrass只override了一个方法：
　　　　OnBlockPlace()
　　　　　　-- switch to dirt if the block above is not id=0
　　　　　　-- if the block below is grass, change it to dirt

　　DoorOpenClose只override了一个方法：
　　　　OnMouseDown()
　　　　　　-- destroy with left click
　　　　　　-- for right click, if open door, set to closed; if closed door, set to open

任务18&19&20&21：事件的触发
任务18：相机正前方瞄准事件的触发

在Uniblocks Dude的prefab上，添加了许多脚本
　　MouseLook.cs
　　CharacterMotor.cs
　　FPSInputController.cs
　　Debugger.cs
　　ExampleInventory.cs
　　ChunkLoader.cs -- 任务8中详述，这样就以主角为中心，进行chunk的生成和删除
　　CameraEventsSender.cs -- 根据相机的方向进行事件的检测（位于UniblocksScripts->PlayerInteraction）
　　ColliderEventsSender.cs
　　FrameRateDisplay.cs
　　MovementSwitch.cs

CameraEventsSender.cs
　　-- 触发事件
　　　　OnMouseDown/ Up/ Hold()
　　　　OnLook()

成员变量：
public float Range; // 可触及的距离
private GameObject SelectedBlockGraphics; // 处于选中状态的block

方法：
Awake() {
　　// 初始化Range和SelectedBlockGraphics的值
}

Update() {
　　// 判断使用哪一种事件：鼠标或是十字准心
　　if (Engine.SendCameraLookEvents或SendCursorEvents) { CameraLookEvents()或MouseCursorEvents(); }
}

private void CameraLookEvents() {
　　// 需要得到当前视野前方的体素
　　// 从camera处向视角正前方发出射线，长度为Range
　　// 最后一个false为IgnoreTransparent，是否忽略透明的block -- 不忽略
　　// 返回的是VoxelInfo对象，表示当前视野正前方的小方块的属性
　　VoxelInfo raycast = Engine.VoxelRaycast(Camera.main.transform.position,
　　　　Camera.main.transform.forward, Range, false);

　　// draw the ray -- 在Scene模式可以把射线看得更清楚
　　Debug.DrawLine(Camera.main.transform.position, Camera.main.transform.position +
　　　　Camera.main.transform.forward * Range, Color.red);

　　// 当视野范围range内可以接触到方块时
　　if(raycast!=null) ...

　　// create a local copy of the hit voxel so we can call functions on it
　　GameObject voxelObject = Instantiate(Engine.GetVoxelGameObject(raycast.GetVoxel())) as GameObject;
　　// raycast为VoxelInfo对象，VoxelInfo.GetVoxel()返回的是Chunk.GetVoxel(index);
　　// 解释：每一个体素都属于一个Chunk，在VoxelInfo中会保留一个Chunk的引用，表示属于该chunk
　　// ...
　　// raycast.GetVoxel() 返回的是十字准心对准的block的id -- 方块类型

　　// 通过Engine.GetVoxelGameObject(id) 得到该类型block的prefab

　　// 通过Instantiate(prefab) as GameObject 得到实例voxelObject
　　-- 得到了实例化的block，现在就能够进行事件的触发了
　　-- 这种事件触发方式效率比较低，因为需要先实例化block，才能进行事件的触发

　　// 开始事件处理
　　// 如果该block有挂载VoxelEvents，则调用VoxelEvents.OnLook(raycast)事件
　　// 并将当前正在看的体素传递过去
　　if(voxelObject.GetComponent<VoxelEvents>() != null) {
　　　　voxelObject.GetComponent<VoxelEvents>().OnLook(raycast);

// 检测鼠标按键事件
if(int i = 0~2) { // 分别表示三个鼠标按键
　　if(Input.GetMouseButton/Down/Up(i)) {
　　　　voxelObject.GetComponent<VoxelEvents>().OnMouseDown/Up/Hold(i, raycast);
　　　　// 传递了十字准心瞄准的block，和按的哪个键
}}

}
// 销毁生成的实例化block
Destroy(voxelObject);

} else {
　　// 在视野前方没有范围内的block
　　// 需要disable selectedBlock
　　if(SelectedBlockGraphics != null) {
　　　　SelectedBlockGraphics.GetComponent<Renderer>().enable = false;

}}}

代码 -- public class CameraEventsSender : MonoBehaviour {} -- 

public float Range; // 可触及的距离
private GameObject SelectedBlockGraphics; // 选中状态的block

public void Awake() {
    if (Range <= 0) {
        Debug.LogWarning("Range must be greater than 0");
        Range = 5.0f;
    }
    SelectedBlockGraphics = GameObject.Find("selected block graphics");
}

public void Update() {
    // 判断使用哪一种事件，鼠标或是十字准心
    if (Engine.SendCameraLookEvents) { CameraLookEvents(); }
    if (Engine.SendCursorEvents) { MouseCursorEvents(); }
}

private void CameraLookEvents() {
    // first person camera
    VoxelInfo raycast = Engine.VoxelRaycast
        (Camera.main.transform.position,
        Camera.main.transform.forward, Range, false);
    // 从camera处向视角正前方发出的射线，长度为range
    // 最后一个false为IgnoreTransparent，是否忽略透明的block -- 不忽略
    // 返回的VoxelInfo对象，为当前视野正前方的小方块的属性

    // draw the ray -- 在Scene模式可以把射线看得更清楚
    Debug.DrawLine(Camera.main.transform.position,
        Camera.main.transform.position +
        Camera.main.transform.forward * Range, Color.red);

    if (raycast != null) { // 视野范围range内接触到方块
        // create a local copy of the hit voxel so we can call functions on it
        GameObject voxelObject = Instantiate(
            Engine.GetVoxelGameObject(raycast.GetVoxel())) as GameObject;

        // only execute this if the voxel actually has any voxel events
        if (voxelObject.GetComponent<VoxelEvents>() != null) {
            voxelObject.GetComponent<VoxelEvents>().OnLook(raycast);

            // for all mouse buttons, send events
            for (int i = 0; i < 3; i++) {
                if (Input.GetMouseButtonDown(i)) {
                    voxelObject.GetComp<VoxelEvents>().OnMouseDown(i, raycast);
                }
                if (Input.GetMouseButtonUp(i)) {
                    voxelObject.GetComp<VoxelEvents>().OnMouseUp(i, raycast);
                }
                if (Input.GetMouseButton(i)) {
                    voxelObject.GetComp<VoxelEvents>().OnMouseHold(i, raycast);
                }
            }
        }
        Destroy(voxelObject);
    } else {
        // disable selected block ui when no block is hit
        if (SelectedBlockGraphics != null) {
            SelectedBlockGraphics.GetComponent<Renderer>().enabled = false;
}}}
        

private void MouseCursorEvents() { // cursor position
    //Vector3 pos=new Vector3(Input.mousePosition.x,Input.mousePos.y,10.0f);
    VoxelInfo raycast = Engine.VoxelRaycast(Camera.main.ScreenPointToRay
        (Input.mousePosition), Range, false);

    if (raycast != null) {
        // create a local copy of the hit voxel so we can call functions on it
        // ...实例化

        // only execute this if the voxel actually has any events
        // ...
        Destroy(voxelObject);
    } else {
        // disable selected block ui when no block is hit...
    }
}

任务19：VoxelInfo和Chunk类的API介绍（之间的关系）

VoxelInfo类：表示当一个block在一个Chunk中存在时，block的属性

成员变量：
public Index index; -- 表示该方块存在chunk中的位置
public Index adjacentIndex;
public Chunk chunk;  -- 该方块属于的chunk的引用

-- Index类
　　有x, y, z三个成员变量
　　如何表示在chunk中的位置呢？
　　　　x轴正方向 == Direction.right
　　　　y轴正方向 == Direction.up
　　　　z轴正方向 == Direction.forward
　　计量单位为block个数，而不是距离

public Index GetAdjacentIndex ( Direction direction ) {
    if (direction == Direction.down)    return new Index(x,y-1,z);
    else if (direction == Direction.up)    return new Index(x,y+1,z);
    else if (direction == Direction.left)    return new Index(x-1,y,z);
    else if (direction == Direction.right)    return new Index(x+1,y,z);
    else if (direction == Direction.back)    return new Index(x,y,z-1);
    else if (direction == Direction.forward)    return new Index(x,y,z+1);
    else return null;
}

 -- Chunk类

成员变量：
public ushort[] VoxelData; // new ushort[SideLength * SideLength * SideLength]; 即16*16*16
　　// 存储的为block的id -- 表示每个位置分别为什么类型的block
　　// 通过GetVoxel(index)的方法，在任务18中，返回视野指向的block的id
public Index chunkIndex;
public Chunk[] NeighborChunks;
public bool Empty;
...

任务20：OnBlockEnter()和OnBlockStay()的触发

Uniblocks Dude的脚本ColliderEventSender.cs
　　触发事件OnBlockEnter/ Stay()

成员变量：
private Index LastIndex;
private Chunk LastChunk;

Update() {
　　// 得到当前角色所在Chunk
　　GameObject chunkObject = Engine.PositionToChunk(transform.position);
　　// 因为ColliderEventSender挂载在角色物体，将角色位置transform.position传入Engine.PositionToChunk()
　　// 得到该位置对应的chunk

　　// 当返回的chunk为空时，如角色在空中时，就不检测碰撞了
　　if(chunk == null) return;

　　// 得到当前位置的voxelIndex
　　Chunk chunk = chunkObject.GetComponent<Chunk>();
　　Index voxelIndoex = chunk.PositionToVoxelIndex(transform.position);
　　// 通过传递当前位置给chunk.PositionToVoxelIndex()
　　　　-- Chunk.PositionToVoxelIndex(position)
　　　　　　Vector3 point = transform.InverseTransformPoint(position);
　　　　　　// 将世界坐标变换为局部坐标
　　　　　　...通过Mathf.RoundToInt()给返回值Index赋值 -- 求得角色当前所在体素的index，而不是脚下的体素

　　// 通过voxelIndex得到当前voxelInfo -- 因为是角色当前所在的体素，所以id一直为0
　　// Bug ...
　　// ---- 怎么改bug呢？
　　// 可以从当前位置向下发射射线，将碰撞到的collider的位置转换为Index
　　// 或可以直接通过Index.y - 1的方法
　　VoxelInfo voxelInfo = new VoxelInfo(voxelIndex, chunk);
　　// 并实例化该voxel
　　GameObject voxelObject = Instantiate(Engine.GetVoxelGameObject(voxelInfo.GetVoxel())) as GameObject;
　　VoxelEvents voxelEvents = voxelObject.GetComponent<VoxelEvents>();

　　// 得到事件后，触发OnBlockEnter/Stay()事件
　　if(events != null) {
　　　　// 因为上面得到的block的id恒为0，而0号block并没有挂载任何VoxelEvents脚本，因此不会进行事件检测
　　　　// OnBlockEnter -- 当当前chunk变动，或voxelIndex变动
　　　　if(chunk != LastChunk || voxelIndex.IsEqual(LastIndex) == false ) {
　　　　　　voxelEvents.OnBlockEnter(this.gameObject, voxelInfo);
　　　　} else { // OnBlockStay
　　　　　　voxelEvents.OnBlockStay(this.gameObject, voxelInfo);
　　}}

　　!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
　　　　这个时候我反应过来。源代码是没有错的，老师讲解的角度错了。
　　　　我想到的OnBlockStay/ Enter() 是作用在比如压力板、草地、水之类的block上的
　　　　而普通的草地之类的是不需要触发类似事件的
　　　　有因为草地、水这些可以近似看作没有占据物理空间，player是可以进入该体素的
　　　　因此player所在的voxelIndex就是草地、压力板所在的voxelIndex
　　!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

　　// 销毁刚才实例化的block，并更新当前chunk和voxelIndex
　　Destroy(voxelObject);
　　LastChunk = chunk;
　　LastIndex = voxelIndex;
}

任务21：voxel其他事件的触发

OnBlockPlace()
OnBlockDestroy()
OnBlockChange()

在DefaultVoxelEvents.cs中

public override void OnMouseDown ( int mouseButton, VoxelInfo voxelInfo ) {
    if ( mouseButton == 0 ) { // destroy a block with LMB
        Voxel.DestroyBlock (voxelInfo); 
    } else if ( mouseButton == 1 ) { // place a block with RMB
        if ( voxelInfo.GetVoxel() == 8 ) { 
            // if we're looking at a tall grass block, replace it with the held block
            Voxel.PlaceBlock (voxelInfo, ExampleInventory.HeldBlock);
        }
        else { // else put the block next to the one we're looking at
            VoxelInfo newInfo=new VoxelInfo (voxelInfo.adjacentIndex, voxelInfo.chunk); 
            // use adjacentIndex to place the block
            Voxel.PlaceBlock (newInfo, ExampleInventory.HeldBlock);
}}}

-- Voxel.DestroyBlock(voxelInfo)中
　　// 实例化当前体素
　　GameObject voxelObject = Instantiate(Engine.GetVoxelGameObject(voxelInfo.GetVoxel())) as GameObject;
　　// 得到体素的events，并触发事件OnBlockDestroy()
　　if(voxelObject.GetComponent<VoxelEvents>() != null) {
　　　　voxelObject.GetComponent<VoxelEvents>().OnBlockDestroy(voxelInfo);
　　}
　　voxelInfo.chunk.SetVoxel(voxelInfo.index, 0, true);
　　Destroy(voxelObject);

-- OnBlockDestroy(voxelInfo) 中
　　// if the block above is tall grass, destroy it as well
　　Index indexAbove = ...
　　if(voxelInfo.chunk.GetVoxel(indexAbove) == 8) {
　　　　voxelInfo.chunk.SetVoxel(indexAbove, 0, true);
　　　　// 在indexAbove位置，设置为0号block，并update mesh
　　}

-- Voxel.PlaceBlock(voxelInfo) 中
　　// 两种情况：1. voxelIndex处为tall grass，2. 不为tall grass
　　if(voxelInfo.GetVoxel() == 8) {
　　　　// 直接在当前voxelInfo处PlaceBlock()
　　　　Voxel.PlaceBlock(voxelInfo, ExampleInventory.HeldBlock);
　　} else {
　　　　// 在邻接处的voxelIndex处PlaceBlock()
　　　　VoxelInfo adjacentVoxelInfo = new VoxelInfo(voxelInfo.adjacentIndex, voxelInfo.chunk);
　　　　Voxel.PlaceBlock(adjacentVoxelInfo, ExampleInventory.HeldBlock);
　　}

-- Voxel.PlaceBlock(voxelInfo, data)
　　// 更新当前voxel
　　voxelInfo.chunk.SetVoxel(voxelInfo, data, true);
　　// 实例化，并得到events脚本
　　GameObject voxelObject = Instantiate(Engine.GetVoxelGameObject(data)) as GameObject;
　　if(... != null) {
　　　　voxelObject.GetComponent<VoxelEvents>().OnBlockPlace(voxelInfo);
　　}
　　Destroy(voxelObject);

-- OnBlockPlace(voxelInfo)中
　　-- 如果放置物的下方是grass且当前物体是solid(不是草或其他门等)，则将其自动转换为dirt
　　Index indexBelow = ...;
　　if(voxelInfo.GetVoxelType().VTransparency == Transparency.solid
　　　　&& voxelInfo.chunk.GetVoxel(indexBelow) == 2) {
　　　　voxelInfo.chunk.SetVoxel(indexBelow, 1, true);
　　}

VoxelDoorOpenClose.cs中 -- 门的开关需要触发事件OnBlockChange

public override void OnMouseDown(int mouseButton, VoxelInfo voxelInfo) {
    if (mouseButton == 0) {
        Voxel.DestroyBlock(voxelInfo);  // destroy with left click
    } else if (mouseButton == 1) { // open/close with right click
        if (voxelInfo.GetVoxel() == 70) { // if open door
            Voxel.ChangeBlock(voxelInfo, 7); // set to closed
        } else if (voxelInfo.GetVoxel() == 7) { // if closed door
            Voxel.ChangeBlock(voxelInfo, 70); // set to open
}}}

右键门的时候，如果门的状态为70，则Voxel.ChangeBlock(voxelInfo, 7);
　　　　　　　如果门的状态为7，则Voxel.ChangeBlock(voxelInfo, 70);

-- Voxel.ChangeBlock(voxelInfo, id) 中
　　// 更新当前voxel
　　voxelInfo.chunk.SetVoxel(voxelInfo.index, data, true);
　　// 实例化，并得到VoxelEvents脚本
　　GameObject voxelObject = Instantiate(Engine.GetVoxelGameObject(data))) as GameObject;
　　if( ... != null) {
　　　　voxelObject.GetComponent<VoxelEvents>().OnBlockChange(voxelInfo);
　　}
　　Destroy(voxelObject);

-- 未实现OnBlockChange(voxelInfo)

事件VoxelEvents总结：

public class VoxelEvents : MonoBehaviour {

    public virtual void OnMouseDown/ Up/ Hold(int mouseButton, VoxelInfo voxelInfo) {
        // 鼠标左右键的按键事件
        // 左键进行DestroyBlock
        // 右键触发PlaceBlock
    }

    public virtual void OnLook(VoxelInfo voxelInfo) {
        // selectedBlock在相应位置的显示
    }

    public virtual void OnBlockPlace(VoxelInfo voxelInfo) {
        // if the block below is grass, change it to dirt
    }

    public virtual void OnBlockDestroy(VoxelInfo voxelInfo) {
        // if the block above is tall grass, destroy it as well
    }

    public virtual void OnBlockChange(VoxelInfo voxelInfo) {
    }

    public virtual void OnBlockEnter(GameObject enteringObject, VoxelInfo voxelInfo) {
    }
    public virtual void OnBlockStay(GameObject stayingObject, VoxelInfo voxelInfo) {
    }
}

评价：这种事件的触发比较耗费性能，因为每次触发都需要实例化一个block的prefab，得到events的脚本，再触发事件

任务22&23&24：代码实现地图的生成 && Player移动的改进、地图的更新

新建场景 MineCraft

导入角色 -- 自定义一个角色，不使用插件中的Uniblocks Dude
　　Project -> Import Packages -> Characters -- 从Standard Assets中导入

将Characters->FirstPersonCharacter->Prefabs->FPSController拖入场景
　　这个prefab自带一个Camera，Audio Listener和Flare Layer
　　将场景自带的Camera删除

将Uniblocks中的Engine拖入场景

创建空物体，命名Manager
　　添加脚本MapManager.cs

如何创建地图呢？
　　ChunkManager.SpawnChunks();
　　参数可以为Index或Vector3 pos -- Index既可以表示体素在chunk中的位置，也可以表示chunk在地图中的位置

MapManager.cs中：

因为需要等待Engine中的Engine.cs和ChunkManager.cs初始化完，才可以开始进行其他地图生成操作
// 安全判断
Update() {
　　if(Engine.Initialized == false || ChunkManager.Initialized == false) return;
　　// 如果每帧都调用，会耗费性能，因此定义成员变量
　　-- private bool hasGenerated = false;
　　并把上述判断增加一个条件 || hasGenerated)

　　// 进行地图的生成
　　// 因为要围绕player进行生成
　　-- private Transform playerTrans = GameObject.FindWithTag("Player").transform;
　　ChunkManager.SpawnChunks(playerTrans.position);
　　hasGenerated = true;

}

自此，地图在场景开始会进行创建，并且player的移动控制也都实现了

1. Player控制移动的改进 -- 行走时有晃动的模拟，这里把它取消掉
　　取消勾选FirstPersonController.cs中的Use Fov Kick和Use Head Bob

2. 场景加载刚开始的时候会卡住十几秒 -- 老师的电脑，我自己的不会
　　原因：刚开始就进行资源消耗很大的地图生成代码ChunkManager.SpawnChunks()
　　解决方案：不要一开始就调用，等一段时间再调用
　　　　将生成地图的代码写入方法 private void InitMap() { ... }
　　　　再将该方法在Start中调用
　　　　　　InvokeRepeating("InitMap", 1, 0.02f);
　　　　　　// 一秒钟后开始调用，调用时间间隔为0.02f (即每帧时间间隔，也可写为Time.deltaTime吧)

3. 在2中为什么要使用InvokeRepeating()重复调用InitMap呢
　　因为我们希望地图的生成会随着Player的位置改变而相应变化
　　但是因为hasGenerated的condition，导致InitMap中的生成地图代码的调用只会出现一次

解决方法：
　　当角色的位置发生改变时，就进行InitMap中的生成地图代码
　　private Vector3 lastPlayerPos;
　　当lastPlayerPos与当前位置不同时
　　if(lastPlayerPos != playerTrans.position) {
　　　　ChunkManager.SpawnChunks(playerTrans.position);
　　　　lastPlayerPos = playerTrans.position;
　　}

这么进行地图更新 -- 性能较低
　　因为一旦player进行的移动，就会进行地图更新
　　而事实上并不需要这么频繁地更新
解决方法：
　　当Player进入另外的chunk时，进行更新即可

　　currChunkIndex = Engine.PositionToChunkIndex(playerTrans.position);
　　// 注意在开始的时候需要初始化lastChunkIndex的值
　　if(lastChunkIndex.x!=currChunkIndex.x || ...y || ...z) {
　　　　ChunkManager.SpawnChunks(playerTrans.position);
　　　　lastChunkIndex = currChunkIndex;
　　}

4. 在3的基础上，进一步进行优化
　　调用InitMap()的频率可以低一些，因为player的移动速度是有限的
　　InvokeRepeating("InitMap", 1, 1);

public class MapManager : MonoBehaviour {
    // private bool hasGenerated = false;
    // private Vector3 lastPlayerPos;
    private Transform playerTrans;
    private Index lastChunkIndex = new Index(0, 0, 0);
    private Index currChunkIndex;

    void Start() {
        playerTrans = GameObject.FindWithTag("Player").transform;
        InvokeRepeating("InitMap", 1, 1);
    }

    private void InitMap() {
        // 安全判断Engine和ChunkManager是否初始化完成
        if (!Engine.Initialized || !ChunkManager.Initialized) {
            return;  // 等待加载完成
        }

        /*
        // 每当角色位置更新，就进行SpawnChunks
        if (lastPlayerPos != playerTrans.position) {
            ChunkManager.SpawnChunks(playerTrans.position);
            lastPlayerPos = playerTrans.position;
            // hasGenerated = true;
        }
        */

        // 当Player进入另外的Chunk时，进行SpawnChunks
        currChunkIndex = Engine.PositionToChunkIndex(playerTrans.position);
        if (lastChunkIndex.x != currChunkIndex.x
            || lastChunkIndex.y != currChunkIndex.y
            || lastChunkIndex.z != currChunkIndex.z) {
            ChunkManager.SpawnChunks(playerTrans.position);
            lastChunkIndex = currChunkIndex;
}}}

任务25&26&27：创建十字准心和获得瞄准的VoxelInfo && Block的放置功能
&& 显示十字准心瞄准的效果、添加简单水资源

创建十字准心
　　UI->Image，位于正中心，SourceImage: None，黑色，调节宽高成一个横条
　　创建子物体Image，调节宽高成一个竖条，即可
　　
　　不需要进行事件监测：
　　　　取消勾选raycast target
　　　　删除EventSystem
　　　　删除Canvas->Graphic Raycaster(Scripte)

　　发现，在游戏视野中，可以看到Canvas的边框 -- 白线
　　如何消除：http://tieba.baidu.com/p/5138227264
　　　　直接重新打开一个Game窗口即可
　　　　Unity的坑

实现摆放、生成、删除block功能

Manager添加脚本BlockManager.cs

获得十字准心瞄准的体素
-- Engine.VoxelRaycast(ray, range, ignoreTransparent)

在Update中

Engine.VoxelRaycast(Camera.main.transform.position, camera.main.trasnform.forward, range, false);
// 通过Camera.main获得的相机需要tag="MainCamera"
// 起点，方向，可触及距离，是否忽略透明物体
// 返回值为VoxelInfo类型，赋值给VoxelInfo targetVoxelInfo

// 判断鼠标按键的按下事件
if(voxelInfo != null) {

显示十字准心瞄准的位置：
　　-- UniblocksObject->Other->selected block graphics
　　这是一个prefab，正好比体素大一点，可以作为一个外框显示出来

// 得到该组件
-- private Transform selectedBlockEffect;

// 初始化
-- selectedBlockEffect = GameObject.Find("selected block graphics").transform;
-- selectedBlockEffect.gameObject.SetActive(false);

// 显示该边框
selectedBlockEffect.position = voxelInfo.chunk.VoxelIndexToPosition(voxelInfo.index);
selectedBlockEffect.gameObject.SetActive(true);

　　if(Input.GetMouseButtonDown(0) {
　　　　// 鼠标左键按下，删除Block功能
　　　　Voxel.DestroyBlock(voxelInfo);
　　　　VoxelInfo.chunk.SetVoxel(
　　　　// ---------运行发现，当player很靠近block的时候，无法销毁
　　　　// 这是因为player自身的collider影响了射线的检测
　　　　// 解决方法：将Player的Layer设置到IgnoreRaycast中即可

} else if (Input.GetMouseButtonDown(1) {
　　// 鼠标右键按下，摆放Block功能

　　// 需要知道当前要摆放的是哪一种block
　　-- private ushort currBlockId = 0;
　　private void BlockSelect() {
　　　　if(ushort i = 0; i < 10; i++) {
　　　　　　if(Input.GetKeyDown(i.ToString())) {
　　　　　　　　currBlockId = i;
　　}}}
　　-- 在Update开始，调用SelectBlock() 进行block的选定检测

　　Voxel.PlaceBlock(voxelInfo, currBlockId);
　　// 这么写的结果是什么呢？
　　　　-- 直接替换了视野前方的block，而不是在邻接处增加一个block

　　// 邻接处：voxelInfo.adjacentIndex
　　VoxelInfo adjacentVoxelInfo = new VoxelInfo(voxelInfo.adjacentIndex, voxelInfo.chunk);
　　Voxel.PlaceBlock(adjacentVoxelInfo, currBlockId);
}

} else {  // voxelInfo == null
　　selectedBlockEffect.gameObject.SetActive(false);
}

public class BlockManager : MonoBehaviour {
    private int range = 5;
    private ushort currBlockId = 0;
    private Transform selectedBlockEffect;
    private void Start() {
        selectedBlockEffect = GameObject.Find("selected block graphics").transform;
        selectedBlockEffect.gameObject.SetActive(false);
    }
    private void SelectBlock() {
        for(ushort i = 0; i<10; i++) {
            if(Input.GetKeyDown(i.ToString())) {  currBlockId = i;
    }}}
    void Update () {
        // 得到十字准心对准的体素
        VoxelInfo voxelInfo = Engine.VoxelRaycast(Camera.main.transform.position, 
            Camera.main.transform.forward, range, false);

        SelectBlock();

        // 对voxelInfo的操作
        if (voxelInfo != null) {
            // 显示十字准心对准的效果
            selectedBlockEffect.position = voxelInfo.chunk.VoxelIndexToPosition(voxelInfo.index);
            selectedBlockEffect.gameObject.SetActive(true);

            if(Input.GetMouseButtonDown(0)) {
                // 鼠标左键，删除
                Voxel.DestroyBlock(voxelInfo);
            } else if (Input.GetMouseButtonDown(1)) {
                // 鼠标右键，摆放
                VoxelInfo adjacentVoxelInfo = new VoxelInfo
                    (voxelInfo.adjacentIndex, voxelInfo.chunk);
                Voxel.PlaceBlock(adjacentVoxelInfo, currBlockId);
        }} else {
            selectedBlockEffect.gameObject.SetActive(false);
}}}

添加水资源（Unity内置）：

Project->Import Package->Environment->Water和Water(Basic)

这里我选择了Water->Prefabs->WaterProDayTime

任务28：结束语

数据的保存和加载

加载会自动完成，只要勾选了Engine.Save/Load Voxel Data即会在开始场景时自动读取地图数据

保存：-- Engine.SaveWorld