====== Lớp Khối ======

Lớp cho giao diện Khối

[[developer_center:developer_editor:script|Trở về trang trước]]
------
==== Cách Viết Sự Kiện =====
<code> ScriptSupportEvent:registerEvent([[Tên Sự Kiện]],tên_hàm_thực_thi) </code>

==== Ví Dụ ====
<code>function Placed (e)

local blockid = e.blockid
local x,y,z = e.x,e.y,e.z

end

ScriptSupportEvent:registerEvent([[Block.Add]],Placed) 

</code>

===== Danh Sách Sự Kiện =====
^  Tên Sự Kiện  ^  Giá Trị Nhận Được  ^  Miêu Tả  ^
| Block.Add | blockid, x, y, z |Được kích hoạt khi một khối với loại khối được chỉ định được thêm vào ở tọa độ đã cho (x, y, z).|
| Block.DestroyBy | eventobjid, blockid, x, y, z |Sự kiện xảy ra khi các khối cục bộ của loại được chỉ định bị phá hủy.Nó cung cấp thông tin về người chơi sự kiện (EventObjid), loại khối (blockid) và tọa độ (x, y, z) của khối bị phá hủy.|
| Block.Dig.Begin | eventobjid, blockid, x, y, z |Được kích hoạt khi bất kỳ khối được khai thác.Nó cung cấp thông tin về người chơi sự kiện (EventObjid), loại khối được khai thác (blockid) và tọa độ (x, y, z) của khối được khai thác.|
| Block.Dig.Cancel | eventobjid, blockid, x, y, z |Sự kiện xảy ra khi hành động khai thác trên một khối bị hủy.Nó cung cấp thông tin về người chơi sự kiện (EventObjid), loại khối được khai thác (blockid) và tọa độ (x, y, z) của khối được khai thác.|
| Block.Dig.End | eventobjid, blockid, x, y, z |Được kích hoạt khi một khối được khai thác thành công.Nó cung cấp thông tin về người chơi sự kiện (EventObjid), loại khối được khai thác (blockid) và tọa độ (x, y, z) của khối khai thác.|
| Block.Remove | blockid, x, y, z |Sự kiện xảy ra khi một khối với loại khối được chỉ định được loại bỏ ở tọa độ đã cho (x, y, z).|
| Block.Trigger | eventobjid, blockid, x, y, z |Sự kiện xảy ra khi một khối với loại khối được chỉ định được kích hoạt và trở nên hoạt động hoặc được cấp nguồn.Nó cung cấp thông tin về người chơi sự kiện (EventObjid), loại khối (blockid) và tọa độ (x, y, z) của khối được kích hoạt.|

===== Danh Sách API =====
^  API  ^  Giá Trị Trả Về  ^  Miêu Tả  ^
| Block:isSolidBlock(x, y, z: kiểu số) | ErrorCode.OK, isSolid: boolean |Kiểm tra xem nó có phải là một khối rắn không|
| Block:isLiquidBlock(x, y, z: kiểu số) | ErrorCode.OK, isLiquid: boolean |Kiểm tra xem nó có phải là một khối chất lỏng không|
| Block:isAirBlock(x, y, z: kiểu số) | ErrorCode.OK, isAir: boolean |Kiểm tra xem đó có phải là một khối không khí không|
| Block:getBlockID(x, y, z: kiểu số) | ErrorCode.OK, id: kiểu số |Nhận ID khối tại vị trí được chỉ định|
| Block:setBlockAll(x, y, z: kiểu số, blockid: kiểu số, data: kiểu số) | ErrorCode.OK |Đặt dữ liệu khối và cập nhật + thông báo|
| Block:getBlockData(x, y, z: kiểu số) | ErrorCode.OK, data: kiểu số |Nhận dữ liệu khối|
| Block:destroyBlock(x, y, z: kiểu số, dropitem: boolean) | ErrorCode.OK |Phá hủy khối bằng một tùy chọn để thả các mục (mặc định sai, không thả)|
| Block:placeBlock(blockid: kiểu số, x, y, z: kiểu số, face: kiểu số, color: kiểu số) | ErrorCode.OK |Đặt khối|
| Block:replaceBlock(blockid: kiểu số, x, y, z: kiểu số, face: kiểu số, color: kiểu số) | ErrorCode.OK |Thay thế khối|
| Block:setBlockAllForUpdate(x, y, z: kiểu số, blockid: kiểu số) | ErrorCode.OK |Đặt dữ liệu khối để thông báo cho các khối xung quanh|
| Block:setBlockAllForNotify(x, y, z: kiểu số, blockid: kiểu số) | ErrorCode.OK |Đặt dữ liệu khối để cập nhật khối vị trí hiện tại|
| Block:setBlockSettingAttState(blockid: kiểu số, attrtype: BLOCKATTR_ENABLE, switch: boolean) | ErrorCode.OK |Đặt trạng thái thuộc tính của khối|
| Block:getBlockSettingAttState(blockid: kiểu số, attrtype: BLOCKATTR_ENABLE) | ErrorCode.OK, switch: boolean |Nhận trạng thái thuộc tính của khối|
| Block:getBlockSwitchStatus(pos: kiểu bảng{x, y, z}) | ErrorCode.OK, isactive: boolean |Nhận trạng thái chuyển đổi của khối chức năng|
| Block:setBlockSwitchStatus(pos: kiểu bảng{x, y, z}, isactive: boolean) | ErrorCode.OK |Đặt trạng thái chuyển đổi của khối chức năng|
| Block:getBlockDataByDir(blockid: kiểu số, dir: kiểu số) | ErrorCode.OK, data: kiểu số |Nhận giá trị dữ liệu khối dựa trên hướng|
| Block:getBlockPowerStatus(pos: kiểu bảng{x, y, z}) | ErrorCode.OK, isactive: boolean |Nhận trạng thái bật nguồn của khối|
| Block:randomBlockID() | ErrorCode.OK, blockid: kiểu số |Nhận ID khối ngẫu nhiên|
| Block:GetBlockDefName(blockid: kiểu số) | ErrorCode.OK, name: kiểu chuỗi |Lấy tên của khối|
| Block:GetBlockDefDesc(blockid: kiểu số) | ErrorCode.OK, desc: kiểu chuỗi |Nhận mô tả về khối|
| Block:GetBlockFacade(blockid: kiểu số) | ErrorCode.OK, faced: kiểu số |Có được sự xuất hiện của khối|
| Block:PlayAct(x, y, z: kiểu số, animid: kiểu số, playmode: kiểu số) | ErrorCode.OK |Chơi hoạt ảnh cho khối lập phương thu nhỏ|
| Block:ReplaceBluePrint(x, y, z: kiểu số, blueprint: kiểu chuỗi, angle: kiểu số, mirror: boolean, placeMode: boolean) | ErrorCode.OK |Đặt bản thiết kế tại vị trí được chỉ định|