/* * The FML Forge Mod Loader suite. Copyright (C) 2012 cpw * * This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free * Software Foundation; either version 2.1 of the License, or any later version. * * This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR * A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 * Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA */ package net.minecraft.server; import java.util.List; import java.util.logging.Logger; import cpw.mods.fml.common.FMLCommonHandler; import cpw.mods.fml.common.Loader; import cpw.mods.fml.common.ReflectionHelper; import cpw.mods.fml.common.modloader.ModLoaderHelper; import cpw.mods.fml.common.modloader.ModLoaderModContainer; import cpw.mods.fml.common.registry.FMLRegistry; import cpw.mods.fml.server.FMLBukkitHandler; public class ModLoader { /** * Not used on the server. * * @param achievement * @param name * @param description */ public static void addAchievementDesc(Achievement achievement, String name, String description) { } /** * This method is a call in hook from modified external code. Implemented elsewhere. * * {@link FMLBukkitHandler#fuelLookup(int, int)} * @param id * @param metadata * @return */ @Deprecated public static int addAllFuel(int id, int metadata) { return 0; } /** * This method is unimplemented in server versions to date. * * @param armor * @return */ @Deprecated public static int addArmor(String armor) { return 0; } /** * This method does not work. Creation of a BiomeGenBase is sufficient to populate this array. Using this method will likely corrupt worlds. * * @param biome */ @Deprecated public static void addBiome(BiomeBase biome) { } /** * Unimplemented on the server as it does not generate names * @param key * @param value */ @Deprecated public static void addLocalization(String key, String value) { } /** * Unimplemented on the server as it does not generate names * @param key * @param lang * @param value */ @Deprecated public static void addLocalization(String key, String lang, String value) { } /** * Unimplemented on the server as it does not generate names * @param instance * @param name */ @Deprecated public static void addName(Object instance, String name) { } /** * Unimplemented on the server as it does not generate names * @param instance * @param lang * @param name */ @Deprecated public static void addName(Object instance, String lang, String name) { } /** * Unimplemented on the server as it does not render textures * @param fileToOverride * @param fileToAdd * @return */ @Deprecated public static int addOverride(String fileToOverride, String fileToAdd) { return 0; } /** * Unimplemented on the server as it does not render textures * @param path * @param overlayPath * @param index */ @Deprecated public static void addOverride(String path, String overlayPath, int index) { } /** * Add a Shaped Recipe * @param output * @param params */ public static void addRecipe(ItemStack output, Object... params) { FMLRegistry.addRecipe(output, params); } /** * Add a shapeless recipe * @param output * @param params */ public static void addShapelessRecipe(ItemStack output, Object... params) { FMLRegistry.addShapelessRecipe(output, params); } /** * Add a new product to be smelted * @param input * @param output */ public static void addSmelting(int input, ItemStack output) { FMLRegistry.addSmelting(input, output); } /** * Add a mob to the spawn list * @param entityClass * @param weightedProb * @param min * @param max * @param spawnList */ public static void addSpawn(Class entityClass, int weightedProb, int min, int max, EnumCreatureType spawnList) { FMLRegistry.addSpawn(entityClass, weightedProb, min, max, spawnList, FMLBukkitHandler.instance().getDefaultOverworldBiomes()); } /** * Add a mob to the spawn list * @param entityClass * @param weightedProb * @param min * @param max * @param spawnList * @param biomes */ public static void addSpawn(Class entityClass, int weightedProb, int min, int max, EnumCreatureType spawnList, BiomeBase... biomes) { FMLRegistry.addSpawn(entityClass, weightedProb, min, max, spawnList, biomes); } /** * Add a mob to the spawn list * @param entityName * @param weightedProb * @param min * @param max * @param spawnList */ public static void addSpawn(String entityName, int weightedProb, int min, int max, EnumCreatureType spawnList) { FMLRegistry.addSpawn(entityName, weightedProb, min, max, spawnList, FMLBukkitHandler.instance().getDefaultOverworldBiomes()); } /** * Add a mob to the spawn list * @param entityName * @param weightedProb * @param min * @param max * @param spawnList * @param biomes */ public static void addSpawn(String entityName, int weightedProb, int min, int max, EnumCreatureType spawnList, BiomeBase... biomes) { FMLRegistry.addSpawn(entityName, weightedProb, min, max, spawnList, biomes); } /** * This method is a call in hook from modified external code. Implemented elsewhere. * {@link FMLBukkitHandler#tryDispensingEntity(World, double, double, double, byte, byte, ItemStack)} * @param world * @param x * @param y * @param z * @param xVel * @param zVel * @param item * @return */ @Deprecated public static boolean dispenseEntity(World world, double x, double y, double z, int xVel, int zVel, ItemStack item) { return false; } /** * Remove a container and drop all the items in it on the ground around * @param world * @param x * @param y * @param z */ public static void genericContainerRemoval(World world, int x, int y, int z) { TileEntity te = world.getTileEntity(x, y, z); if (!(te instanceof IInventory)) { return; } IInventory inv = (IInventory)te; for (int l = 0; l < inv.getSize(); l++) { ItemStack itemstack = inv.getItem(l); if (itemstack == null) { continue; } float f = world.random.nextFloat() * 0.8F + 0.1F; float f1 = world.random.nextFloat() * 0.8F + 0.1F; float f2 = world.random.nextFloat() * 0.8F + 0.1F; while (itemstack.count > 0) { int i1 = world.random.nextInt(21) + 10; if (i1 > itemstack.count) { i1 = itemstack.count ; } itemstack.count -= i1; EntityItem entityitem = new EntityItem(world, (float)te.x + f, (float)te.y + f1, (float)te.z + f2, new ItemStack(itemstack.id, i1, itemstack.getData())); float f3 = 0.05F; entityitem.motX = (float)world.random.nextGaussian() * f3; entityitem.motY = (float)world.random.nextGaussian() * f3 + 0.2F; entityitem.motZ = (float)world.random.nextGaussian() * f3; if (itemstack.hasTag()) { entityitem.itemStack.setTag((NBTTagCompound)itemstack.getTag().clone()); } world.addEntity(entityitem); } } } /** * Get a list of all BaseMod loaded into the system * {@link ModLoaderModContainer#findAll} * @return */ public static List getLoadedMods() { return ModLoaderModContainer.findAll(BaseMod.class); } /** * Get a logger instance * {@link FMLBukkitHandler#getFMLLogger()} * @return */ public static Logger getLogger() { return FMLCommonHandler.instance().getFMLLogger(); } /** * Get a value from a field using reflection * {@link ReflectionHelper#getPrivateValue(Class, Object, int)} * @param instanceclass * @param instance * @param fieldindex * @return */ public static T getPrivateValue(Class instanceclass, E instance, int fieldindex) { return ReflectionHelper.getPrivateValue(instanceclass, instance, fieldindex); } /** * Get a value from a field using reflection * {@link ReflectionHelper#getPrivateValue(Class, Object, String)} * @param instanceclass * @param instance * @param field * @return */ public static T getPrivateValue(Class instanceclass, E instance, String field) { return ReflectionHelper.getPrivateValue(instanceclass, instance, field); } /** * Get a new unique entity id * {@link Entity#getNextId()} * @return */ public static int getUniqueEntityId() { return Entity.getNextId(); } /** * Is the named mod loaded? * {@link Loader#isModLoaded(String)} * @param modname * @return */ public static boolean isModLoaded(String modname) { return Loader.isModLoaded(modname); } /** * This method is a call in hook from modified external code. Implemented elsewhere. * {@link FMLBukkitHandler#handlePacket250(Packet250CustomPayload, EntityHuman)} * @param packet */ @Deprecated public static void receivePacket(Packet250CustomPayload packet) { } /** * Register a new block * @param block */ public static void registerBlock(Block block) { FMLRegistry.registerBlock(block); } /** * Register a new block * @param block * @param itemclass */ public static void registerBlock(Block block, Class itemclass) { FMLRegistry.registerBlock(block, itemclass); } /** * Register a new entity ID * @param entityClass * @param entityName * @param id */ public static void registerEntityID(Class entityClass, String entityName, int id) { FMLRegistry.registerEntityID(entityClass, entityName, id); } /** * Register a new entity ID * @param entityClass * @param entityName * @param id * @param background * @param foreground */ public static void registerEntityID(Class entityClass, String entityName, int id, int background, int foreground) { FMLRegistry.registerEntityID(entityClass, entityName, id, background, foreground); } /** * Register the mod for packets on this channel. This only registers the channel with Forge Mod Loader, not * with clients connecting- use BaseMod.onClientLogin to tell them about your custom channel * {@link FMLCommonHandler#registerChannel(cpw.mods.fml.common.ModContainer, String)} * @param mod * @param channel */ public static void registerPacketChannel(BaseMod mod, String channel) { FMLCommonHandler.instance().registerChannel(ModLoaderModContainer.findContainerFor(mod), channel); } /** * Register a new tile entity class * @param tileEntityClass * @param id */ public static void registerTileEntity(Class tileEntityClass, String id) { FMLRegistry.registerTileEntity(tileEntityClass, id); } /** * Remove a biome. This code will probably not work correctly and will likely corrupt worlds. * @param biome */ @Deprecated public static void removeBiome(BiomeBase biome) { FMLRegistry.removeBiome(biome); } /** * Remove a spawn * @param entityClass * @param spawnList */ public static void removeSpawn(Class entityClass, EnumCreatureType spawnList) { FMLRegistry.removeSpawn(entityClass, spawnList, FMLBukkitHandler.instance().getDefaultOverworldBiomes()); } /** * Remove a spawn * @param entityClass * @param spawnList * @param biomes */ public static void removeSpawn(Class entityClass, EnumCreatureType spawnList, BiomeBase... biomes) { FMLRegistry.removeSpawn(entityClass, spawnList, biomes); } /** * Remove a spawn * @param entityName * @param spawnList */ public static void removeSpawn(String entityName, EnumCreatureType spawnList) { FMLRegistry.removeSpawn(entityName, spawnList, FMLBukkitHandler.instance().getDefaultOverworldBiomes()); } /** * Remove a spawn * @param entityName * @param spawnList * @param biomes */ public static void removeSpawn(String entityName, EnumCreatureType spawnList, BiomeBase... biomes) { FMLRegistry.removeSpawn(entityName, spawnList, biomes); } /** * Configuration is handled elsewhere * {@link ModLoaderModContainer} */ @Deprecated public static void saveConfig() { } /** * This method is unimplemented on the server: it is meant for clients to send chat to the server * {@link FMLBukkitHandler#handleChatPacket(Packet3Chat, EntityHuman)} * @param text */ @Deprecated public static void serverChat(String text) { } /** * Indicate that you want to receive ticks * * @param mod * receiving the events * @param enable * indicates whether you want to recieve them or not * @param useClock * Not used in server side: all ticks are sent on the server side (no render subticks) */ public static void setInGameHook(BaseMod mod, boolean enable, boolean useClock) { ModLoaderHelper.updateStandardTicks(mod, enable, useClock); } /** * Set a private field to a value using reflection * {@link ReflectionHelper#setPrivateValue(Class, Object, int, Object)} * @param instanceclass * @param instance * @param fieldindex * @param value */ public static void setPrivateValue(Class instanceclass, T instance, int fieldindex, E value) { ReflectionHelper.setPrivateValue(instanceclass, instance, fieldindex, value); } /** * Set a private field to a value using reflection * {@link ReflectionHelper#setPrivateValue(Class, Object, String, Object)} * @param instanceclass * @param instance * @param field * @param value */ public static void setPrivateValue(Class instanceclass, T instance, String field, E value) { ReflectionHelper.setPrivateValue(instanceclass, instance, field, value); } /** * This method is a call in hook from modified external code. Implemented elsewhere. * {@link FMLBukkitHandler#onItemCrafted(EntityHuman, ItemStack, IInventory)} * @param player * @param item * @param matrix */ @Deprecated public static void takenFromCrafting(EntityHuman player, ItemStack item, IInventory matrix) { } /** * This method is a call in hook from modified external code. Implemented elsewhere. * {@link FMLBukkitHandler#onItemSmelted(EntityHuman, ItemStack)} * @param player * @param item */ @Deprecated public static void takenFromFurnace(EntityHuman player, ItemStack item) { } /** * Throw the offered exception. Likely will stop the game. * {@link FMLBukkitHandler#raiseException(Throwable, String, boolean)} * @param message * @param e */ public static void throwException(String message, Throwable e) { FMLBukkitHandler.instance().raiseException(e, message, true); } /** * Get the minecraft server instance * {@link FMLBukkitHandler#getServer()} * @return */ public static MinecraftServer getMinecraftServerInstance() { return FMLBukkitHandler.instance().getServer(); } /** * To properly implement packet 250 protocol you should always check your channel * is active prior to sending the packet * * @param player * @param channel * @return */ public static boolean isChannelActive(EntityHuman player, String channel) { return FMLCommonHandler.instance().isChannelActive(channel, player); } /** * Stubbed method on the server to return a unique model id * */ @Deprecated public static int getUniqueBlockModelID(BaseMod mod, boolean flag) { return 0; } }