BlocksData解析¶

本教程由百度贴吧-销锋镝铸、大王派、freeze丶果果编写

前言¶

在之前的Content解析中，提到：

BlocksData.txt存储了所有方块的大部分属性的类csv文件（以纯文本形式存储表格数据，使用特定的符号分隔字段），可直接用文本编辑器打开并编辑

本教程将详细讲解该文件的文件结构和内容

文件结构¶

该csv文件可以看作是一张表格，以文本行分割表格横行，以;分割表格纵列
例：现有部分文件内容如下：

Class Name;DefaultDisplayName;DefaultCategory
;;
AirBlock;Air;Terrain
BedrockBlock;Bedrock;Terrain

可以看作是以下表格：

其中第一行是表头，指明表格每一列是方块的什么属性，之后每一非空行是一个个方块的具体数据，而非空白行一般用来分开DefaultCategory（默认类别）不同的方块

数据类型¶

在游戏的“源代码”中指定了方块的每一个属性的数据类型，使用到的数据类型如下：

方块属性¶

启发例子¶

方块发光¶

要让放置在地图的方块像火把一样发光，需要修改该方块的EmittedLightAmount(发光强度)为9~22，LightAttenuation(光衰减)大于0

铁砂掌¶

修改所有方块的DigResilience为0,。可参考正则表达式教程教程批量替换，或者使用Blocksdata编辑器

基岩综合¶

基岩可挖掘，拾取，创造模式提供
修改BedrockBlock(基岩)的IsPlaceable(是否可放置)、IsGatherable(是否可收集)为TRUE，DefaultCreativeData(默认创造模式数据)、DigResilience(挖掘抗性)为0

撸树¶

破坏树干时上面的树干也会被破坏
给OakWoodBlock(橡木)、BirchWoodBlock(桦木)、SpruceWoodBlock(杉木)的Behaviors加上, GraveBlockBehavior

方块行为¶

为方便说明，以下是SubsystemBlockBehavior(子系统方块行为)的简要“源码”，先看看方块行为能做些什么

abstract class SubsystemBlockBehavior : Subsystem
{
    abstract int[] HandledBlocks { get; } //直接从“源码”掌控的方块Value列表（Value，常被称作ID）
    void OnChunkInitialized(){} //当区块初始化时处于该区块内的该方块执行
    void OnChunkDiscarding(){} //当区块从视野消失时处于该区块内的该方块执行
    void OnBlockGenerated(){} //当方块从地图中加载时执行
    void OnBlockAdded(){} //当方块被添加到地图时执行
    void OnBlockRemoved(){} //当方块从地图中被移除时执行
    void OnBlockModified(){} //当方块被编辑\/改变时执行
    void OnNeighborBlockChanged(){} //当该方块的周边方块被改变时执行
    bool OnUse(){} //当方块被使用时执行
    bool OnInteract(){} //当方块被交互时执行
    bool OnAim(){} //当方块要被投掷处于瞄准状态时执行
    bool OnEditBlock(){} //当在地图中的(电路)方块被编辑时执行
    bool OnEditInventoryItem(){} //当编辑在背包中的(电路)方块时执行
    void OnItemPlaced(){} //当可编辑方块被添加到地图时执行
    void OnItemHarvested(){} //当流体方块冲击方块时执行（注：不是被冲击）
    void OnCollide(){} //当实体与方块发生碰撞时执行
    void OnExplosion(){} //当方块被炸时执行
    void OnFiredAsProjectile(){} //当方块作为投掷物被发射时执行
    bool OnHitAsProjectile(){} //当方块作为投掷物击中方块或实体时执行
    void OnHitByProjectile(){} //当方块被投掷物击中时执行
    int GetProcessInventoryItemCapacity(){} //用于获取例如枪弓弩需要按顺序填装的方块此时应被填装的方块
    void ProcessInventoryItem(){} //当例如枪弓弩的方块被填装时执行
    void Load(){} //当进入世界时执行
}

各种方块行为inherits(继承)以上SubsystemBlockBehavior(子系统方块行为)后，override(重写)其中的Method(方法)，最后让指定方块拥有对应的方块行为，就能在游戏中起作用了
让方块拥有方块行为有两种方式：

• 一种是本节提到的在“源码”中方块行为的HandledBlocks方法中写入方块的Value(常被称作ID)
• 另一种是在上一节提到的，在Blocksdata.txt里方块的Behaviors属性中写入方块行为，多个方块行为需要用英文逗号,分开。但是很多方块行为无法通过此方法赋予给该方块，可能仍要采用第一种方法

方块行为列表¶

以下是从Database.xml中Database/DatabaseObjects/Folder Name="Abstract"/ProjectTemplate Name="Project"提取的方块行为列表，对应游戏版本2.1

表一¶

可写入方块Behaviors属性的方块行为，以及方块加上该行为后效果

• FertilizerBlockBehavior此方块可作为肥料使用，同时将导致不可放置。发现：TallGrassBlock有此属性时，地形生成时该方块下方的土块会一同消失
• FireBlockBehavior此方块将自燃并消失，并引燃其他可燃物，也可直接点可燃物上表面点燃该物品
• MatchBlockBehavior此方块成为火柴，可点燃可燃物，将不可放置
• RakeBlockBehavior此方块可作为耙子使用
• SaplingBlockBehavior此方块放置到土地上如果条件适合，将长成Oak树，若条件不允许将直接消失。用途示例：让杂草长成树木
• CactusBlockBehavior此方块将从上面长出仙人掌，如果此方块不是沙子，长出的仙人掌将直接破坏并掉落，此方块也将只能放置在沙子和仙人掌上表面。用途示例：长满仙人掌沙漠，沙滩；刷仙人掌机
• RotBlockBehavior此方块将腐败成“源代码”中该方块类GetDamageDestructionValue(受伤破坏后Value)方法中设置的方块，默认0（AirBlock(空气)）
• MagmaBlockBehavior此方块将点燃周围可燃物如果该物品可燃则自己也会燃烧。不一定对所有方块有效
• GraveBlockBehavior将可导致方块只能放到一个方块上表面，下方方块被破坏后上面的此方块将破坏(原版GraveBlock会向下掉落)。用途示例：撸树mod
• SoilBlockBehavior此方块上表面放置实心方块后变成DirtBlock
• GrassBlockBehavior此方块上表面放置实心方块后变成DirtBlock
• IvyBlockBehavior此方块若透明将只能挂在树上(未知原因经常挂不上)，并向下长出此方块。用途示例：刷物品机
• BottomSuckerBlockBehavior此方块将使方块变得难以放置(?)，海胆、海星具有该属性
• TreasureGeneratorBlockBehavior此方块将在周围有方块变为空气时随机掉落宝物
• WaterPlantBlockBehavior此方块将只能像海胆、海星一样放置在水中
• SaddleBlockBehavior此方块将可作为马鞍使用
• BowBlockBehavior有此属性后该方块在物品栏放一个弓箭到上面会变成弓
• BulletBlockBehavior此方块将像子弹一样投掷出后破碎
• WhistleBlockBehavior此方块将可作为哨子使用，并将不可放置
• ThrowableBlockBehavior此方块将可投掷，需要调整其他和投掷有关属性
• FireworksBlockBehavior此方块将像烟花一样投掷出后带火焰尾迹，撞击到方块或动物后破碎，或飞行一段距离后消失
• MagnetBlockBehavior此方块被放置后将相当于一个磁铁
• ExplosivesBlockBehavior此方块将可爆炸，需要调整其他和爆炸有关属性
• ImpactExplosivesBlockBehavior炸弹都有此属性，当该方块作为投掷物撞击到方块或动物时爆炸
• BombBlockBehavior此方块投掷出后可爆炸，附带燃烧引线，同时也会影响Is Stickable
• HammerBlockBehavior此方块将可作为锤子使用

表二¶

不确定

SignBlockBehavior
BatteryBlockBehavior
ElectricBlockBehavior
CampfireBlockBehavior
MusketBlockBehavior
FurnitureBlockBehavior
BucketBlockBehavior
MetersBlockBehavior
CrossbowBlockBehavior
PistonBlockBehavior
MemoryBankBlockBehavior
FenceGateBlockBehavior
FenceBlockBehavior
ArrowBlockBehavior
InWaterBlockBehavior
StairsBlockBehavior
AdjustableDelayGateBlockBehavior
DispenserBlockBehavior
CarpetBlockBehavior
EggBlockBehavior
CollapsingBlockBehavior
BoatBlockBehavior
TruthTableCircuitBlockBehavior
LedBlockBehavior
LadderBlockBehavior
WoodBlockBehavior