ShockAhPI

Harvest Intercept - show/hide

This part of SAPI allows you to intercept each block harvest.

Using it to change block's drops:
dirt that drops diamonds

public class mod_Example extends BaseMod implements IInterceptHarvest {
	public mod_Example() {
		SAPI.interceptAdd(this);
	}
	
	public boolean canIntercept(World world, EntityPlayer player, Loc loc, int blockID,
				int meta) {
		return blockID == Block.dirt.blockID;
	}
	public void intercept(World world, EntityPlayer player, Loc loc, int blockID, int meta) {
		SAPI.drop(world,loc,new ItemStack(Item.diamond));
	}
	
	public String Version() {
		return "1.0";
	}
}

Block Placing Intercept - show/hide

This part of SAPI allows you to intercept a block placing.

Auto-changing a block into other block:
dirt -> grass

public class mod_Example extends BaseMod implements IInterceptBlockSet {
	public mod_Example() {
		SAPI.interceptAdd(this);
	}
	
	public boolean canIntercept(World world, Loc loc, int blockID) {
		return blockID == Block.dirt.blockID;
	}
	public int intercept(World world, Loc loc, int blockID) {
		return Block.grass.blockID;
	}
	
	public String Version() {
		return "1.0";
	}
}

Reach - show/hide

This part of SAPI allows you to change the item's reach vs entities/blocks.

Greater range vs entities:
2x greater range when holding a stick

public class mod_Example extends BaseMod implements IReachEntity {
	public mod_Example() {
		SAPI.reachAdd(this);
	}
	
	public boolean reachEntityItemMatches(ItemStack stack) {
		if (stack == null) return false;
		return stack.itemID == Item.stick.shiftedIndex;
	}
	public float getReachEntity(ItemStack stack) {
		return 6f; //the default is 3
	}
	
	public String Version() {
		return "1.0";
	}
}

Greater range vs blocks:
2x greater range when holding a gold pickaxe

public class mod_Example extends BaseMod implements IReachBlock {
	public mod_Example() {
		SAPI.reachAdd(this);
	}
	
	public boolean reachBlockItemMatches(ItemStack stack) {
		if (stack == null) return false;
		return stack.itemID == Item.pickaxeGold.shiftedIndex;
	}
	public float getReachBlock(ItemStack stack) {
		return 8f //the default is 4
	}
	
	public String Version() {
		return "1.0";
	}
}

Dungeon - show/hide

This part of SAPI allows you to add new monsters to default Minecraft dungeons and new items in chests found there.

Adding new mob to a spawner:
Creeper

public class mod_Example extends BaseMod {
	public mod_Example() {
		SAPI.dungeonAddMob("Creeper");
	}
	
	public String Version() {
		return "1.0";
	}
}

Adding new items to chests:
torches (1-32 in stack), diamonds (rare)

public class mod_Example extends BaseMod {
	public mod_Example() {
		SAPI.dungeonAddItem(new DungeonLoot(new ItemStack(Block.torch),1,32));
		SAPI.dungeonAddItem(new DungeonLoot(new ItemStack(Item.diamond)),1);
					//default "rarity" is 100
	}
	
	public String Version() {
		return "1.0";
	}
}

Adding guaranteed items to chests:
cooked porkchop

public class mod_Example extends BaseMod {
	public mod_Example() {
		SAPI.dungeonAddGuaranteedItem(new DungeonLoot(new ItemStack(Item.porkCooked)));
	}
	
	public String Version() {
		return "1.0";
	}
}

Other functions:

SAPI.dungeonAddMob(mob,chances); //String,int | default chances = 10
SAPI.dungeonRemoveMob(mob); //String
SAPI.dungeonRemoveAllMobs();
SAPI.dungeonRemoveItem(itemID); //int
SAPI.dungeonRemoveAllItems();

Achievement Pages - show/hide

This part of SAPI allows you to add a separate page for your own achievements.

Adding a page:

public class mod_Example extends BaseMod {
	public mod_Example() {
		Achievement ac1 = new Achievement(12345,"acTest1",0,0,Item.mapItem,null)
					.registerAchievement();
		ModLoader.AddAchievementDesc(ac1,"My 1st achievement","First achievement");
		Achievement ac2 = new Achievement(12346,"acTest2",0,2,Item.mapItem,ac1)
					.registerAchievement();
		ModLoader.AddAchievementDesc(ac2,"My 2nd achievement","Second achievement");

		ACPage myPage = new ACPage("My Page");
		myPage.addAchievements(ac1,ac2);
	}
	
	public String Version() {
		return "1.0";
	}
}

Creating a page with custom background:
All sand

public class mod_Example extends BaseMod {
	public mod_Example() {
		Achievement ac = new Achievement(143523,"acRandom1",0,0,Block.sand,null)
					.registerAchievement();
		ModLoader.AddAchievementDesc(ac1,"Random achievement","An achievement");

		ACPage myPage = new MyOwnACPage("My Page");
		myPage.addAchievements(ac);
	}
	
	public String Version() {
		return "1.0";
	}
}

public class MyOwnACPage extends ACPage {
	public MyOwnACPage(String title) {
		super(title);
	}
	
	public int bgGetSprite(Random random, int x, int y) {
		return Block.sand.blockIndexInTexture;
	}
}

NBT Helper - show/hide

This part of SAPI allows you to save your own NBT files for a world.

Saving a value to a new NBT file:

public class mod_Example extends BaseMod implements INBT {
	public static int value = 0;
	
	public mod_Example() {
		SAPI.interceptAdd(this);
	}
	
	public String getFnameNBT() {
		return "MyNBT.dat";
	}
	public void saveNBT(NBTTagCompound nbtCompound) {
		nbtCompound.setInteger("Value",++value);
	}
	public void loadNBT(NBTTagCompound nbtCompound) {
		value = nbtCompound.getInteger("Value");
	}
	
	public String Version() {
		return "1.0";
	}
}

Difficulty Lock - show/hide

This part of SAPI allows you to lock the current difficulty in played worlds.

Locking the difficulty:

public class mod_Example extends BaseMod {
	public mod_Example() {
		SAPI.lockDifficulty(this);
	}
	
	public String Version() {
		return "1.0";
	}
}

PlayerAPI - show/hide

PlayerAPI was originally a standalone mod made by Flan, but it was meant to be merged with SAPI, but I (Shockah) was on holidays. This part of SAPI allows you to add your own code to methods in EntityPlayerSP class.

Making a little hack - player "always in water material", without water:

public class mod_Example extends BaseMod {
	public mod_Example() {
		SAPI.PAPIregisterPlayerBase(MyPlayerBase.class);
	}
	
	public String Version() {
		return "1.0";
	}
}

public class MyPlayerBase extends PlayerBase {
	public boolean isInsideOfMaterial(Material material, boolean inMaterial) {
		if (material == Material.water) return true;
		return inMaterial;
	}
}