ブロック解説

下記のコードで実装できる。

import net.minecraft.block.Block;

import cpw.mods.fml.common.registry.GameRegistry;

public static void Test()

{

Block block = GameRegistry.findBlock(modId, name);

}

下記のコードで実装できる。

import net.minecraft.block.Block;

import net.minecraft.block.BlockFire;

public static void InitFireInfo()

{

BlockFire fire = Blocks.fire;

fire.setFireInfo(block, 5, 20); // block に任意のブロックインスタンスを代入

}

TileEntity があるブロックには、特殊レンダーを登録することができる。TileEntity のクラスオブジェクト (java 風に言うなら Class <? extends TileEntity > )を引数に登録するため、同じ TileEntity クラスに複数の特殊レンダーを登録することはできない。

特殊レンダーは TileEntitySpecialRenderer クラスを継承する。

特殊レンダーの登録は ClientRegistryクラスの bindTileEntitySpecialRenderer(Class <? extends TileEntity> tileEntityClass, TileEntitySpecialRenderer specialRenderer) を使用するか、同等の実装を行う。

バニラの特殊レンダーと、上記の方法で登録した特殊レンダーの取得は TileEntityRendererDispatcher クラスの instance を使用し、getSpecialRenderer(TileEntity entity) メソッドで対応する TileEntitySpecialRenderer インスタンスを取得する。

レンダーは、取得した TileEntitySpecialRenderer オブジェクトの renderTileEntityAt(TileEntity entity, double x, double y, double z, float partialTickTime) メソッドを使用するか、 TileEntityRendererDispatcher クラスの instance を使用し、renderTileEntityAt(TileEntity entity, double x, double y, double z, float partialTickTime) メソッドを使用する。

import net.minecraft.client.renderer.tileentity.TileEntityRendererDispatcher;

import net.minecraft.client.renderer.tileentity.TileEntitySpecialRenderer;

import net.minecraft.tileentity.TileEntity;

public static void bindTileEntitySpecialRenderer(Class <? extends TileEntity> tileEntityClass, TileEntitySpecialRenderer specialRenderer)

{

TileEntityRendererDispatcher.instance.mapSpecialRenderers.put(tileEntityClass, specialRenderer);

specialRenderer.func_147497_a(TileEntityRendererDispatcher.instance);

}

サバイバルモードで、石炭やダイヤモンドなどのように、採掘した時にドロップするアイテムを変えたい場合がある。

ドロップするアイテムを取得するメソッドは、Block クラスの getItemDropped(int meta, Random rand, int fortune) である。

ドロップするアイテムのダメージ値を取得するメソッドは、Block クラスの damageDropped(int meta) である。

ドロップするアイテムの数を取得するメソッドは、Block クラスの quantityDropped(int meta, int  fortune, Random random) である。必要な引数が幸運レベルのみの場合は quantityDroppedWithBonus(fortune, random) メソッド、random のみで十分な場合は quantityDropped(Random random) メソッドと使い分けると良い。

NBTTagなどを付与する場合は getDrops(World world, int x, int y, int z, int metadata, int fortune) メソッドをオーバーライドしよう。

Block クラスのコード抜粋

package net.minecraft.block;

import java.util.ArrayList;

import java.util.Random;

import net.minecraft.item.Item;

import net.minecraft.item.ItemStack;

import net.minecraft.world.World;

public class Block

{

/**

* ブロック破壊時にドロップするアイテムの数量を返します。

*/

public int quantityDropped(Random random)

{

return1;

}

/**

* ブロックによってドロップされる通常の数量に 1 のボーナスを加えた値を 'i' (両端を含む) で返します。

*/

public int quantityDroppedWithBonus(int fortune, Random random)

{

return this.quantityDropped(fortune);

}

/**

* メタデータと幸運レベルに敏感なバージョン。

* これは、1.1 の古い (int meta, Random rand) バージョンを置き換えます。

*

* @param meta ブロックメタデータ

* @param fortune 現在のアイテムの幸運レベル

* @param random 乱数発生器

* @return ドロップするアイテムの数

*/

public int quantityDropped(int meta, int  fortune, Random random)

{

/**

* ブロックによってドロップされる通常の数量に 1 のボーナスを加えた値を 'i' (両端を含む) で返します。

*/

return quantityDroppedWithBonus(fortune, random);

}

/**

* これにより、このブロックからドロップされたアイテムの完全なリストが返されます。

*

* @param world 現在の世界

* @param x X 位置

* @param y Y 位置

* @param z Z 位置

* @param metadata 現在のメタデータ

* @param fortune 採掘道具の幸運レベル

* @return このブロックがドロップするすべての要素を含む ArrayList

*/

public ArrayList<ItemStack> getDrops(World world, int x, int y, int z, int metadata, int fortune)

{

ArrayList<ItemStack> ret = new ArrayList<ItemStack>();

int count = quantityDropped(metadata, fortune, world.rand);

for(int i = 0; i < count; i++)

{

Item item = getItemDropped(metadata, world.rand, fortune);

if (item != null)

{

ret.add(new ItemStack(item, 1, damageDropped(metadata)));

}

}

return ret;

}

}

クリエイティブモードでは、ホイールクリックすると対象のブロックをアイテムとして取得する機能がある。

基本的にはそのままでも機能するが、時には意図的に取得するアイテムを変えたい場合がある。

ホイールクリックでアイテムを取得するメソッドは、Block クラスの getPickBlock(MovingObjectPosition target, World world, int x, int y, int z, EntityPlayer player) である。

取得するアイテムのダメージ値だけを変えたい場合は getDamageValue(World world, int x, int y, int z) メソッドをオーバーライドしよう。

TileEntity などに応じて取得するアイテムを変える場合や、NBTTag を付与する場合はgetPickBlock(MovingObjectPosition target, World world, int x, int y, int z, EntityPlayer player) メソッドをオーバーライドしよう。

また、target 変数を使用することで、見ている箇所に応じて取得するアイテムを変えることができる。

Block クラスのコード抜粋

package net.minecraft.block;

import net.minecraft.item.Item;

import net.minecraft.item.ItemBlock;

import net.minecraft.item.ItemStack;

import net.minecraft.util.MovingObjectPosition;

import net.minecraft.world.World;

import net.minecraft.entity.player.EntityPlayer;

public class Block

{

/**

* ユーザーがこのブロックでクリエイティブ選択ブロック ボタンを使用すると呼び出されます。

*

* @param target プレイヤーが見ている完全なターゲット

* @return プレイヤーのインベントリに追加するItemStack。何も追加しない場合はNull。

*/

public ItemStack getPickBlock(MovingObjectPosition target, World world, int x, int y, int z, EntityPlayer player)

{

return getPickBlock(target, world, x, y, z);

}

@Deprecated

public ItemStack getPickBlock(MovingObjectPosition target, World world, int x, int y, int z)

{

Item item = getItem(world, x, y, z);

if (item == null)

{

return null;

}

Block block = item instanceof ItemBlock && !isFlowerPot() ? Block.getBlockFromItem(item) : this;

return new ItemStack(item, 1, block.getDamageValue(world, x, y, z));

}

/**

* ブロックのダメージ値を取得します（ピックブロックで使用）。

*/

public int getDamageValue(World world, int x, int y, int z)

{

return this.damageDropped(world.getBlockMetadata(x, y, z));

}

}

シルクタッチでアイテムを取得するメソッドは、Block クラスの createStackedBlock(int meta) で実装している。

デフォルトでは、対応する ItemBlock クラスで getHasSubtypes() が false を返す場合は meta の値を無視する。

変える場合はこのメソッドをオーバーライドしよう。

なお、この方法では TileEntity には対応できない。

対応する場合はかなり手間だが Block クラスの harvestBlock(World world, EntityPlayer player, int x, int y, int z, int meta) メソッドをオーバーライドしよう。

Block クラスのコード抜粋

package net.minecraft.block;

import net.minecraft.item.Item;

import net.minecraft.item.ItemStack;

public class Block

{

/**

* 現在のブロック タイプの単一インスタンスを含む項目スタックを返します。

* 「meta」はブロックのサブタイプ/ダメージであり、サブタイプをサポートしないブロックでは無視されます。

* 収集できないブロックは null を返す必要があります。

*/

protected ItemStack createStackedBlock(int meta)

{

int j = 0;

Item item = Item.getItemFromBlock(this);

if (item != null && item.getHasSubtypes())

{

j = meta;

}

return new ItemStack(item, 1, j);

}

}

ブロックの当たり判定を取得するメソッドは、Block クラスの getCollisionBoundingBoxFromPool(World world, int x, int y, int z) で実装している。

このメソッドは単純な四角形の当たり判定しか返せないので注意。

Entity に対しての当たり判定は Block クラスの addCollisionBoxesToList(World world, int x, int y, int z, AxisAlignedBB mask, List list, Entity entiy) で実装している。

複雑な当たり判定を設定するならこのメソッドを使用しよう。

Block クラスのコード抜粋

package net.minecraft.block;

import net.minecraft.world.World;

import net.minecraft.util.AxisAlignedBB;

public class Block

{

/**

* 交差するすべてのコリジョン ボックスをリストに追加します。 (マスクと交差するボックスのみをリストに追加してください。)

* パラメータ: world, x, y, z, mask, list, 衝突 entity

*/

public void addCollisionBoxesToList(World world, int x, int y, int z, AxisAlignedBB mask, List list, Entity entity)

{

//mask は entity の当たり判定です。

//block の当たり判定は list に追加する。

AxisAlignedBB axisalignedbb1 = this.getCollisionBoundingBoxFromPool(world, x, y, z);

if (axisalignedbb1 != null && mask.intersectsWith(axisalignedbb1))

{

list.add(axisalignedbb1);

}

}

/**

* 境界ボックスのプールから境界ボックスを返します (これは、プールが再利用のためにクリアされた後にこのボックスが変更される可能性があることを意味します)

 */

public AxisAlignedBB getCollisionBoundingBoxFromPool(World world, int x, int y, int z)

{

return AxisAlignedBB.getBoundingBox((double)x + this.minX, (double)y + this.minY, (double)z + this.minZ, (double)x + this.maxX, (double)y + this.maxY, (double)z + this.maxZ);

}

}

TileEntityには.updateEntity()があるが、ブロック単体で同じようなことはできないのでしょうか?

もちろんできます(inurokoは最近知った)。作物の成長などで使用してください。

Block.classをextendsしたクラス内に記述

@Override//どれくらいの間隔で実行するか

public int tickRate(World p_149738_1_) {

return 2;

}

@Override//ブロックを設置した際にBlockUpdateのスケジュールを送る。

public int onBlockPlaced(World w, int x, int y, int z, int side, float hX, float　hY, float hZ, int meta) {

world.scheduleBlockUpdate(x, y, z, this, this.tickRate(w));

return super.onBlockPlaced(w, x, y, z, side, hX, hY, hZ, meta);

}

@Override//スケジュールされると定期的に呼ばれるメソッド、このメソッド内でもスケジュールを送ることでループさせる。

     public void updateTick(World w, int x, int y, int z, Random p_149674_5_) { 

//ここに定期的に実行したい内容(植物の成長判定など)を記述する

//再度スケジュールを送る。

world.scheduleBlockUpdate(x, y, z, this, this.tickRate(w));

} 

使用例(一定範囲のコウモリを駆除する撮影用ブロック)

Block.classをextendsしたクラス内に記述

@Override

public int tickRate(World world) {

return 10;

}

@Override

public int onBlockPlaced(World w, int x, int y, int z, int s, float hitX, float hitY, float hitZ, int meta) {

world.scheduleBlockUpdate(x, y, z, this, this.tickRate(w));

return super.onBlockPlaced(w, x, y, z, s, hitX, hitY, hitZ, meta);

}

@Override

public void updateTick(World world, int x, int y, int z, Random random) {

     double d0 = 255;

     AxisAlignedBB axisalignedbb = AxisAlignedBB.getBoundingBox((double)x, (double)y, (double)z, (double)(x + 1), (double)(y + 5), (double)(z + 1)).expand(d0, d0, d0);

         List list = world.getEntitiesWithinAABB(EntityBat.class, axisalignedbb);

         Iterator iterator = list.iterator();

         EntityBat entityBat;

         while (iterator.hasNext()) {

         entityBat = (EntityBat)iterator.next();

         if(entityBat != null) {

         entityBat.setDead();

         }

         }

         world.scheduleBlockUpdate(x, y, z, this, this.tickRate(world));

}