📔
TerraCraft
  • TerraCraft
  • English
    • Mod Document
      • Mod Dev Official Tutorial
      • Mod API Document
        • Data Types and Enums
        • JSON
        • Entity
        • NPC
  • 简体中文(旧版教程)
    • 模组文档
      • Engine API
        • App
        • AssetBundle
        • AtlasInfo
        • AtlasTextureManager
        • Audio
        • Bytes
        • File
        • GameObject
        • GlobalHook
        • Graphics
        • Hotfix
        • Image
        • ImageInfo
        • IntegratedClient : IntegratedEnv
        • IntegratedEnv
        • JsonUtil
        • Log
        • MathHelper
        • Matrix
        • Path
        • Random
        • Rect
        • Rigidbody
        • TextureLocation
        • TextureManager
        • Transform
        • Vector2
        • Vector3
        • Vector4
      • Game API
        • Attack
        • ArrayList<T>
        • EffectUtils
        • Entity
        • LightingUtils
        • ModNpc
        • ModProjectile
        • Npc : Entity
        • NpcUtils
        • Projectile : Entity
        • ProjectileUtils
        • Reg
        • SoundUtils
        • Utils
      • 模组API文档
        • 数据类型、枚举类型
        • JSON API
        • 引用API
        • 注册信息API
        • 语言API
        • 通用API
        • 物品API
        • 实体API
        • 特效API
        • 抛射物API
        • 状态效果API
        • 附魔API
        • 玩家API
        • NPC API
        • 骨骼模型API
        • 光照API
        • 音效API
        • 方块API
        • 方块实体API
        • 地图API
        • 渲染API
        • 指令API
        • 用户图形界面UI
        • 其他API
      • 模组开发官方教程
        • ExampleMod源代码仓库
        • 1.0 教程对应游戏版本(Indev 1.1)
        • 1.1 开始
        • 1.2 安装Visual Studio Code
        • 1.3 配置模组环境
        • 1.4 认识模组路径
        • 1.5 认识JSON数据表
        • 1.6 第一个物品
        • 1.7 认识地图元素
        • 1.8 第一个图块TODO
        • 1.9 第一个家具TODO
        • 1.10 加入合成表TODO
        • 未完待续……
      • 模组数据表文档
        • 基本JSON类型
        • 模组配置表(tcmod.json)
        • 物品表(contents/items/...)
        • 物品配置表
        • 弹药表(ammos.json)
        • 状态效果表(buffs.json)
        • 音效配置表(sound_config.json)
        • 音效表(sounds.json)
        • 背景表(backgrounds.json)
        • 皮肤表(skins.json)
        • 着色器表(shaders.json)
  • 新版教程
    • 1 基础部分
      • 1.1 安装集成开发环境
      • 1.2 获取TerraCraft源码
      • 1.3 认识Lua
      • 1.4 Mod架构
      • 1.5 游戏主生命周期和主状态机
      • 1.6 Lua实战
      • 1.7 第一个物品
      • 1.8 本地化翻译
      • 1.9 配方系统初探和矿物字典
Powered by GitBook
On this page
  • 钩子函数(方块预设脚本:contents/block_presets/...)
  • void OnPlayerCollide(int xi, int yi, Player player, Direction collisionDirection)
  • void OnPlayerOverlap(int xi, int yi, Player player)
  • void OnRandomTick(int xi, int yi)
  • void OnPlaced(int xi, int yi, PlaceParameter placeParameter)
  • void OnDestroy(int xi, int yi, DestroyParameter destroyParameter)
  • void OnClicked(int xi, int yi, ClickParameter clickParameter)
  • void OnSignal(int xi, int yi, bool isActivated)
  • void UpdateScreen(int xi, int yi)
  • void RenderFurniture(int xi, int yi, int tickTime)
  • void PreRenderFurniture(int xi, int yi, int tickTime)
  • void PostRenderFurniture(int xi, int yi, int tickTime)
  • 方块通用模块(BlockUtils)

Was this helpful?

  1. 简体中文(旧版教程)
  2. 模组文档
  3. 模组API文档

方块API

钩子函数(方块预设脚本:contents/block_presets/...)

void OnPlayerCollide(int xi, int yi, Player player, Direction collisionDirection)

function OnPlayerCollide(xi, yi, player, collisionDirection)
    
end

玩家与当前方块发生碰撞时执行该函数。

  • xi表示当前方块所在格子横坐标。

  • yi表示当前方块所在格子纵坐标。

  • player表示与当前方块碰撞的玩家。

void OnPlayerOverlap(int xi, int yi, Player player)

function OnPlayerOverlap(xi, yi, player)
    
end

玩家与当前方块发生重叠时执行该函数。

  • xi表示当前方块所在格子横坐标。

  • yi表示当前方块所在格子纵坐标。

  • player表示与当前方块重叠的玩家。

void OnRandomTick(int xi, int yi)

function OnRandomTick(xi, yi)
    
end

【仅服务端调用】当前方块在服务端被随机刻选中时执行。

  • xi表示当前方块所在格子横坐标。

  • yi表示当前方块所在格子纵坐标。

void OnPlaced(int xi, int yi, PlaceParameter placeParameter)

function OnPlaced(xi, yi, placeParameter)
    
end

【仅服务端调用】当前方块在服务端被放置时执行。

  • xi表示当前方块所在格子横坐标。

  • yi表示当前方块所在格子纵坐标。

  • placeParameter表示放置方块附加的信息参数。

void OnDestroy(int xi, int yi, DestroyParameter destroyParameter)

function OnDestroy(xi, yi, destroyParameter)
    
end

【仅服务端调用】当前方块在服务端被破坏前执行。

  • xi表示当前方块所在格子横坐标。

  • yi表示当前方块所在格子纵坐标。

  • destroyParameter表示破坏方块附加的信息参数。

void OnClicked(int xi, int yi, ClickParameter clickParameter)

function OnClicked(xi, yi, clickParameter)
    
end

【仅服务端调用】当前方块在服务端被玩家右键点击时执行。

  • xi表示当前方块所在格子横坐标。

  • yi表示当前方块所在格子纵坐标。

  • placeParameter表示右键点击方块附加的信息参数。

void OnSignal(int xi, int yi, bool isActivated)

function OnSignal(xi, yi, isActivated)
    
end

【仅服务端调用】当前方块在服务端被红石信号触发时执行。

  • xi表示当前方块所在格子横坐标。

  • yi表示当前方块所在格子纵坐标。

  • isActivated表示红石信号是否为激活信号,若为否,表示反激活信号。

void UpdateScreen(int xi, int yi)

function UpdateScreen(xi, yi)
    
end

【仅客户端调用】当前方块在客户端的屏幕内时执行。

  • xi表示当前方块所在格子横坐标。

  • yi表示当前方块所在格子纵坐标。

void RenderFurniture(int xi, int yi, int tickTime)

function RenderFurniture(int xi, int yi, tickTime)
    
end

【仅客户端调用】当前家具在客户端被绘制时调用该函数,用来决定家具的绘制方式。

  • xi表示当前方块所在格子横坐标。

  • yi表示当前方块所在格子纵坐标。

  • tickTime表示客户端全局渲染时间。

void PreRenderFurniture(int xi, int yi, int tickTime)

function PreRenderFurniture(int xi, int yi, tickTime)
    
end

【仅客户端调用】允许在绘制家具前绘制自定义内容。

void PostRenderFurniture(int xi, int yi, int tickTime)

function PostRenderFurniture(int xi, int yi, tickTime)
    
end

【仅客户端调用】允许在绘制家具后绘制自定义内容。

方块通用模块(BlockUtils)

数值函数

函数

返回值

描述

Block.GetGroupID(int blockID)

int

返回指定方块ID的方块组ID。

Block.GetSubGroupID(int blockID)

int

返回指定方块ID的方块子组ID。

Previous音效APINext方块实体API

Last updated 4 years ago

Was this helpful?