Minecraft Forge编程入门二 “工艺和食谱”
从现在开始我们就要开始真正写代码了,还没有来得及配置环境的同学可以参考Minecraft Forge编程入门一 “环境搭建”这篇文章来进行环境搭建。
工艺(Craft)和食谱(Recepe)
所谓的工艺和食谱是指在Minecraft中物品的合成和合成表。
-
工艺:指由一种或几种物品合成出另外一种物品,
如常见的火把的合成:
-
食谱:泛指物品合成的摆放顺序。有有形和无形两种,其中有形要求合成时物品间的相对位置不能变即形状不变,无形则只要求物品满足条件即可对形状没要求。
如指南针的合成是有形的:
稍微改变一下任何一个物品的顺序就无法合成了:
无形的食谱较少,当合成材料是一个的时候,可以说他是有形也可以说是无形。
或者
合成前的基础知识
ItemStack
在Minecraft中每种类型的方块和物品都不是多实例的,可以理解为你看到的土块在游戏内存中只是一个实例而已。这样做的目的显而易见,就是为了减少内存占用。
那如果我要表示一块土块要怎么做呢?
ItemStack dirtStack = new ItemStack(Blocks.dirt);
n块土块呢?
ItemStack dirtStack = new ItemStack(Blocks.dirt,n);
那如果不是土块而是羊毛呢?大家都知道羊毛是有颜色之分的?
ItemStack woolStack = new ItemStack(Blocks.wool, 2, 15);
ItemStack的构造方法大只就这三种,总结一下起语法:
ItemStack stack = new ItemStack((Object)ItemType,[(int)Stack Size],[(Object) Metadata]);
其中ItemType
是必须的,另外的Size
和Metadata
是可选的。
- ItemType表示物品或方块的类型,在forge中使用
Blocks
和Items
表示。 - Size表示物品或方块的数量。
- Metadata表示ItemType对应物品或方块的附加属性。
如果ItemType是羊毛Blocks.wool的话,Metadata就表示羊毛的颜色,Metadata取十进制Dec行的值。羊毛颜色如下:
由于在后面可能大量用到不同种类的ItemStack,这里我们定义一个java类,专门用来提供一些常用的ItemStack。
package com.zql.mc.zmod.itemstack;
import net.minecraft.block.Block;
import net.minecraft.init.Blocks;
import net.minecraft.init.Items;
import net.minecraft.item.Item;
import net.minecraft.item.ItemStack;
/**
*
* @author scott 定义一些常用的物品组
*/
public class ArticleStacks {
/**
* 钻石 * 1
*/
public final static ItemStack DIAMOND_STACK_1 = getItemStack(Items.diamond, 1);
/**
* 土块 * 1
*/
public final static ItemStack DIRT_STACK_1 = getItemStack(Blocks.dirt, 1);
/**
* 沙子 * 1
*/
public final static ItemStack SAND_STACK_1 = getItemStack(Blocks.sand, 1);
/**
* 羊毛 * 1 橙色
*/
public final static ItemStack WOOL_ORANGE_1 = getItemStack(Blocks.wool, 1, 1);
/**
* 羊毛 * 1 黄色
*/
public final static ItemStack WOOL_YELLOW_1 = getItemStack(Blocks.wool, 1, 4);
/**
* 羊毛 * 1 黑色
*/
public final static ItemStack WOOL_BLACK_1 = getItemStack(Blocks.wool, 1, 15);
/**
*
* @param item
* 物品
* @param count
* 物品数量
* @return
*/
public static ItemStack getItemStack(Item item, int count) {
return new ItemStack(item, count);
}
/**
*
* @param block
* 方块
* @param count
* 方块数量
* @return
*/
public static ItemStack getItemStack(Block block, int count) {
return new ItemStack(block, count);
}
/**
*
* @param block
* 方块
* @param count
* 方块数量
* @param metaData
* 元数据,如方块是羊毛Wool的话,metaData的值是0~15,表示不同的颜色。
* @return
*/
public static ItemStack getItemStack(Block block, int count, int metaData) {
return new ItemStack(block, count, metaData);
}
}
读者也可以根据自己的需求往里面加不同的ItemStack。
无形合成配方
无形合成配方对物品或方块的顺序位置没有要求。
首先看一下添加无形合成配方的语法:
GameRegistry.addShapelessRecipe(ItemStack result, Object... recipe);
其中result
表示合成结果,... recipe
表示配方数组。
下面我们看一个简单的例子,用一个土块和一个沙块来合成一个钻石,😄是不是不符合逻辑,没关系,我们要的就是这种效果。
@Mod(modid = ZMod.MODID, version = ZMod.VERSION, name = ZMod.MOD_NAME)
public class ZMod
{
public static final String MODID = "ZMod";
public static final String VERSION = "1.0";
public static final String MOD_NAME = "Z Mod";
@Instance(value = ZMod.MODID) //Tell Forge what instance to use.
public static ZMod instance;
@EventHandler
public void init(FMLInitializationEvent event)
{
//这句是关键,ArticleStacks是我们在上面定义的工具类,用于提供ItemStack,这句代码的意思是使用一块土块和一块沙块合成一颗钻石,并且是无需的合成配方。
GameRegistry.addShapelessRecipe(ArticleStacks.DIAMOND_STACK_1, ArticleStacks.DIRT_STACK_1,ArticleStacks.SAND_STACK_1);
}
}
运行结果:
这就是无形合成配方,你看懂了吗?
有形合成配方
与无形合成配方比较,有形的合成配方在代码书写上稍微有些复杂,我们来看有形合成配方的语法:
GameRegistry.addRecipe(ItemStack result,String row1, [String row2[,String row3]],char itemType1, ItemStack itemStackType1[, ... char itemTypeN, ItemStack itemStackTypeN]);
语法看着比较晦涩,还是看几个实际的例子吧。
- 还是土和沙合成钻石,只不过这次的合成配方类似:
| |A|B|
|A| |B|
其中A表示土块,B表示沙块,代码如下:
@EventHandler
public void init(FMLInitializationEvent event)
{
GameRegistry.addShapedRecipe(ArticleStacks.DIAMOND_STACK_1,
" AB",
"A B",
'A',ArticleStacks.DIRT_STACK_1,
'B',ArticleStacks.SAND_STACK_1);
}
运行结果如下:
结合图片,这段代码应该不难理解了,在配方只有两行的情况下,两行的位置可以是1,2两行或者2,3两行,但不能是2,3两行。即他们之间的相对位置不能变。当然字母可以是其它任何你喜欢的字母。
配方中如有空格子,用英文状态下的空格表示。
- 再看一个三行配方的例子,这次是土块和羊毛合成钻石,配方形状如下:
|A| | |
| | | |
| | |B|
A是土块,B是羊毛
代码如下:
@EventHandler
public void init(FMLInitializationEvent event)
{
GameRegistry.addShapedRecipe(ArticleStacks.DIAMOND_STACK_1,
"A ",
" ",
" B",
'A',ArticleStacks.DIRT_STACK_1,
'B',ArticleStacks.WOOL_BLACK_1);
}
运行结果如下:
有形的合成配方是不是也是比较简单的?期待你们能想出更多好玩的配方😄。
熔炼
在Minecraft中有这么一个叫做熔炼
的概念,那何谓熔炼呢?
熔炼指的就是提炼物质,在Minecraft中熔炼包括:melting, baking, cooking, burning, drying, or producing。其实就是常见的烤面包,烤土豆,制作蛋糕等操作。
其语法是:
GameRegistry.addSmelting(Object inputItem, ItemStack result, float experience);
inputItem表示熔炼前的物品,可以是Item也可以是Block更可以是ItemStack,result表示熔炼后的物品。experience表示熔炼获得的经验值。
这部分我尝试了将土块熔炼成钻石的操作,结果不起作用。可能这里的熔炼需要物品间有一定的联系。
这里等后面具体讲Blocks和Items的时候在做分析。
总结
那么Minecraft的合成部分就讲这么多,后面开始教大家怎么自定义Blocks和Items,谢谢。
----------------华丽丽的分割线---------------------
扫描加微信我微信订阅号,文章更新第一时间提醒。
参考资料
http://www.minecraftforge.net/wiki/Crafting_and_Smelting
http://minecraft.gamepedia.com/Smelting