「既存のブロックの動作を変更する」を編集中

<div style="border:double 4px red;background:#ffeeee;margin:1em;padding:1ex 1em;">このMODの動作確認は、<b>Minecraft1.2.5　forge3.3.8_152</b> で行っています。</div>
{{前提MOD|reqmod=<br>"ModLoader及びMinecraftForge"<br>}}
=既存ブロックの動作を変更する=
ここでは例として、本棚を壊した際、そのまま回収できるようにするMODを作成します。

==作成するファイル==
*BlockNewBookshelf.java　　新しい本棚クラス
*mod_DropedBookshelf.java　前提MODから呼び出されるクラス

==ソースファイル全文==
;BlockNewBookshelf.java
<source lang="java">
package net.minecraft.src;

import java.util.Random;

public class BlockNewBookshelf extends BlockBookshelf
{
	public BlockNewBookshelf(int par1, int par2)
	{
		super(par1, par2);
	}

	public int idDropped(int par1, Random par2Random, int par3)
	{
		return blockID;
	}

	public int quantityDropped(Random par1Random)
	{
		return 1;
	}
}
</source>

;mod_DropedBookshelf.java
<source lang="java">
package net.minecraft.src;

public class mod_DropedBookshelf extends BaseMod
{
	public String getVersion()
	{
		return "1.2.5-1";
	}

	public void load()
	{
		Block.blocksList[47] = null;
		Block NewBookshelf = (new BlockNewBookshelf(47, 35)).setHardness(1.5F)
		.setStepSound(Block.soundWoodFootstep).setBlockName("bookshelf");
	}

}
</source>

=BlockNewBookshelf.javaの解説=
このクラスでは、新しい本棚の動作を定義する。
==Bookshelf型を継承する==
<source lang="java">
public class BlockNewBookshelf extends BlockBookshelf　//既存の本棚を継承
{
	public BlockNewBookshelf(int par1, int par2)
	{
		super(par1, par2);　//継承元のBlockBookshelfメソッドを呼び出す。
	}
</source>
*今回は変更点がドロップアイテムだけなので、BlockBookshelf（既存の本棚）クラスを継承して新しい本棚を作る。
**既存のブロックの動作を変更する場合、既存のクラスを継承して変更点だけ記述する方が楽。
*BlockBookshelf内のsuperとは引数が異なる点に注意。
*BloclBookshelfのsuperはBlockを呼び出すのに対し、BlockNewBookshelfのsuperはBlockBookshelfを呼び出す。
*そのため、superの引数はBlockBookshelfのコンストラクタに合わせる必要がある。
**既存クラスの引継ぎで忘れやすい部分なので注意。

==ドロップするブロックを設定する==
<source lang="java">
	public int idDropped(int par1, Random par2Random, int par3)
	{
		return blockID;
	}
</source>
*idDropped で自分自身をドロップするように変更。
<source lang="java">
	public int quantityDropped(Random par1Random)
	{
		return 1;
	}
</source>
*quantityDropped で落とす個数を1に変更。
**継承元で3に設定されているため、これを指定し忘れると本棚を3つドロップしてしまう。

=mod_DropedBookshelf.javaの解説=
前提MODから呼び出されるクラス。
ここで既存のブロックと入れ替える。
==既存の本棚を削除する==
<source lang="java">
	Block.blocksList[47] = null;
</source>
*ブロックリストから本棚（ID=47）を削除する
*IDは次項でコピーしたものを使用する。
**ID部分は Block.bookshelf.blockID で指定する方法もある。

==新しい本棚を登録する==
<source lang="java">
	Block NewBookshelf = (new BlockNewBookshelf(47, 35)).setHardness(1.5F)
	.setStepSound(Block.soundWoodFootstep).setBlockName("bookshelf");
</source>
*任意のBlockクラスを宣言し、そこに新しい本棚を設定する。
*ブロックリストへの登録は自動的に行われる。
*ブロックの各種設定は、Block.javaから既存の本棚の設定をそのままコピーする。
**.setStepSound のみ注意。このメソッドの設定値はBlock.javaで定義されているので、(Block.soundWoodFootstep)と、明示的にBlockのスコープを与えてやる必要がある。

=応用=
==ブロックの硬さや爆破耐性などを変更する==
ブロックを登録する際に、硬さや明るさを変更できる。
<source lang="java">
	Block NewBookshelf = (new BlockNewBookshelf(47, 35)).setHardness(1.5F)
	.setStepSound(Block.soundWoodFootstep).setBlockName("bookshelf");
</source>
設定できる項目は以下の通り。他にもset～で変更できる値はほぼ変更できる。
{|class="wikitable" style="border-width:1px 1px 1px 1px; border-color:black; border-style:solid; "
|+ style="background:#ddd;text-align:left;padding:0 0 0 2px;"|登録時に設定可能な値の一例
|-
|setHardness(float par1)||ブロックの硬さ
|-
|setResistance(float par1)||爆破耐性（必ず setHaerdness の後に書く事）
|-
|setLightValue(float par1)||ブロックの明るさ0.0F～1.0F（光レベル15で1.0F、7で0.5F）
|-
|setLightOpacity(int par1)||光度減衰量。葉ブロックが1、水が3
|-
|setStepSound(StepSound par1StepSound)||上を歩いた時や破壊した時の音　設定値はBlock.java参照
|-
|setBlockUnbreakable()||ブロックを破壊不可能にする
|}



==シルクタッチで回収可能にする==
本棚は元々シルクタッチでの回収が可能だが、回収不可能なブロックを明示的にシルクタッチ回収可能にするには、MinecraftForge で Blockクラスに追加される canSilkHarvestメソッドを使用する。
<source lang="java">
public boolean canSilkHarvest(World world, EntityPlayer player, int x, int y, int z, int metadata)
{
    return true;
}
</source>
*これで true を返せばシルクタッチで回収可能になる。
*MinecraftForgeを使わない場合、func_50074_q()メソッドで true を返せばよい。
**なおこのメソッドはMinecraftForgeではcanSilkHarvest()に改名されているが、参照されないので注意が必要である。
<source lang="java">
protected boolean func_50074_q()
{
    return true;
}
</source>

==フォーチュンでドロップ数を増やす==
幸運のエンチャント付きツールでブロックを破壊した場合のドロップ数は、quantityDroppedWithBonusメソッドで設定する。<br>
以下に例としてスイカのソースを掲載する。
<source lang="java">
public int quantityDroppedWithBonus(int par1, Random par2Random)
{
    int var3 = this.quantityDropped(par2Random) + par2Random.nextInt(1 + par1);

    if (var3 > 9)
    {
        var3 = 9;
    }

    return var3;
}
</source>
*スイカは元々のドロップ数が3～7で、this.quantityDropped(par2Random) でその数を呼び出している。
*par1 は幸運のエンチャントレベルで、幸運IIIだと 3 になる。
*par2Random.nextInt(1 + par1) で追加するドロップ数を指定（幸運IIIなら0～3）
*9以上は9になるので、最終的なドロップ数は、幸運IIIで3～9になる。

==メソッドの追加などが無い場合==
例えば光レベルの変更や、硬さ、爆破耐性の変更など、メソッドを書き換えたり、追加したりする必要の無い要素のみの変更であれば、代替クラスファイルも不要で簡単に実現できる。<br>
この書き方で変更可能なのは、set～のメソッドで変更可能な値のみなので、ドロップアイテムの変更などは不可能。<br>

例のソースは、黒曜石の硬さ(50.0F)を、丸石と同じ(2.0F)に変更するだけのMOD。
;mod_ChangeHardness.java
<source lang="java">
package net.minecraft.src;

public class mod_ChangeHardness extends BaseMod
{
	public void load()
	{
		Block.obsidian.setHardness(2.0F);
	}

	public String getVersion()
	{
		return "";
	}

}
</source>

<!--
<source lang="java">
</source>

-->