mirror of
https://github.com/MinecraftForge/MinecraftForge.git
synced 2026-11-20 04:09:51 +00:00
Improve JavaDoc links, fix some broken JavaDocs (#2833)
Improve JavaDoc links, fix broken JavaDocs
This commit is contained in:
1 parent
9bb927dc64
commit
86baf7462f
62 files changed
+353
-163
No files matched your search
@@ -1694,18 +1694,18 @@ public class GuiConfigEntries extends GuiListExtended
|
||||
public boolean enabled();
|
||||
|
||||
/**
|
||||
* Handles user keystrokes for any GuiTextField objects in this entry. Call {@code GuiTextField.keyTyped()} for any GuiTextField
|
||||
* Handles user keystrokes for any GuiTextField objects in this entry. Call {@link GuiTextField#textboxKeyTyped(char, int)} for any GuiTextField
|
||||
* objects that should receive the input provided.
|
||||
*/
|
||||
public void keyTyped(char eventChar, int eventKey);
|
||||
|
||||
/**
|
||||
* Call {@code GuiTextField.updateCursorCounter()} for any GuiTextField objects in this entry.
|
||||
* Call {@link GuiTextField#updateCursorCounter()} for any GuiTextField objects in this entry.
|
||||
*/
|
||||
public void updateCursorCounter();
|
||||
|
||||
/**
|
||||
* Call {@code GuiTextField.mouseClicked()} for and GuiTextField objects in this entry.
|
||||
* Call {@link GuiTextField#mouseClicked(int, int, int)} for and GuiTextField objects in this entry.
|
||||
*/
|
||||
public void mouseClicked(int x, int y, int mouseEvent);
|
||||
|
||||
|
||||
@@ -31,14 +31,26 @@ public interface IConfigElement
|
||||
public boolean isProperty();
|
||||
|
||||
/**
|
||||
* This method returns a class that implements {@code IConfigEntry} or null. This class MUST
|
||||
* provide a constructor with the following parameter types: {@code GuiConfig}, {@code GuiConfigEntries}, {@code IConfigElement}
|
||||
* This method returns a class that implements {@link IConfigEntry} or null. This class MUST
|
||||
* provide a constructor with the following parameter types: {@link GuiConfig}, {@link GuiConfigEntries}, {@link IConfigElement}
|
||||
*
|
||||
* @see GuiConfigEntries.ListEntryBase
|
||||
* @see GuiConfigEntries.StringEntry
|
||||
* @see GuiConfigEntries.BooleanEntry
|
||||
* @see GuiConfigEntries.DoubleEntry
|
||||
* @see GuiConfigEntries.IntegerEntry
|
||||
*/
|
||||
public Class<? extends IConfigEntry> getConfigEntryClass();
|
||||
|
||||
/**
|
||||
* This method returns a class that implements {@code IArrayEntry}. This class MUST provide a constructor with the
|
||||
* following parameter types: {@code GuiEditArray}, {@code GuiEditArrayEntries}, {@code IConfigElement}, {@code Object}
|
||||
* This method returns a class that implements {@link IArrayEntry}. This class MUST provide a constructor with the
|
||||
* following parameter types: {@link GuiEditArray}, {@link GuiEditArrayEntries}, {@link IConfigElement}, {@link Object}
|
||||
*
|
||||
* @see GuiEditArrayEntries.BaseEntry
|
||||
* @see GuiEditArrayEntries.StringEntry
|
||||
* @see GuiEditArrayEntries.BooleanEntry
|
||||
* @see GuiEditArrayEntries.DoubleEntry
|
||||
* @see GuiEditArrayEntries.IntegerEntry
|
||||
*/
|
||||
public Class<? extends IArrayEntry> getArrayEntryClass();
|
||||
|
||||
|
||||
@@ -49,9 +49,6 @@ public class RenderingRegistry
|
||||
* Register an entity rendering handler. This will, after mod initialization, be inserted into the main
|
||||
* render map for entities.
|
||||
* Call this during Preinitialization phase.
|
||||
*
|
||||
* @param entityClass
|
||||
* @param renderer
|
||||
*/
|
||||
public static <T extends Entity> void registerEntityRenderingHandler(Class<T> entityClass, IRenderFactory<? super T> renderFactory)
|
||||
{
|
||||
|
||||
@@ -942,10 +942,12 @@ public class Loader
|
||||
* Fire a FMLMissingMappingsEvent to let mods determine how blocks/items defined in the world
|
||||
* save, but missing from the runtime, are to be handled.
|
||||
*
|
||||
* @param missing Map containing missing names with their associated id, blocks need to come before items for remapping.
|
||||
* @param missingBlocks Map containing the missing block names with their associated id. Remapped blocks will be removed from it.
|
||||
* @param missingItems Map containing the missing block names with their associated id. Remapped items will be removed from it.
|
||||
* @param isLocalWorld Whether this is executing for a world load (local/server) or a client.
|
||||
* @param gameData GameData instance where the new map's config is to be loaded into.
|
||||
* @return List with the mapping results.
|
||||
* @param remapBlocks Returns a map containing the remapped block names and an array containing the original and new id for the block.
|
||||
* @param remapItems Returns a map containing the remapped item names and an array containing the original and new id for the item.
|
||||
* @return List with the names of the failed remappings.
|
||||
*/
|
||||
public List<String> fireMissingMappingEvent(Map<ResourceLocation, Integer> missingBlocks, Map<ResourceLocation, Integer> missingItems, boolean isLocalWorld, Map<ResourceLocation, Integer[]> remapBlocks, Map<ResourceLocation, Integer[]> remapItems)
|
||||
{
|
||||
|
||||
@@ -9,7 +9,7 @@ import net.minecraftforge.fml.relauncher.Side;
|
||||
|
||||
/**
|
||||
* A method annotated with this will be called when a remote network connection is offered.
|
||||
* The method should have two parameters, of types {@link Map<String,String>} and {@link Side}. It should return a boolean
|
||||
* The method should have two parameters, of types Map<String,String> and {@link Side}. It should return a boolean
|
||||
* true indicating that the remote party is acceptable, or false if not.
|
||||
*
|
||||
* <p>
|
||||
|
||||
@@ -110,7 +110,7 @@ public enum NetworkRegistry
|
||||
* <ul>
|
||||
* <li> {@link #newSimpleChannel(String)} provides {@link SimpleNetworkWrapper}, a simple implementation of a netty handler, suitable for those who don't
|
||||
* wish to dive too deeply into netty.
|
||||
* <li> {@link #newEventChannel(String)} provides {@link FMLEventChannel} an event driven implementation, with lower level
|
||||
* <li> {@link #newEventDrivenChannel(String)} (String)} provides {@link FMLEventChannel} an event driven implementation, with lower level
|
||||
* access to the network data stream, for those with advanced bitbanging needs that don't wish to poke netty too hard.
|
||||
* <li> Alternatively, simply use the netty features provided here and implement the full power of the netty stack.
|
||||
* </ul>
|
||||
@@ -124,7 +124,7 @@ public enum NetworkRegistry
|
||||
*
|
||||
* The first handler in the pipeline is special and should not be removed or moved from the head - it transforms
|
||||
* packets from the outbound of this pipeline into custom packets, based on the current {@link AttributeKey} value
|
||||
* {@link NetworkRegistry#FML_MESSAGETARGET} and {@link NetworkRegistry#FML_MESSAGETARGETARGS} set on the channel.
|
||||
* {@link FMLOutboundHandler#FML_MESSAGETARGET} and {@link FMLOutboundHandler#FML_MESSAGETARGETARGS} set on the channel.
|
||||
* For the client to server channel (source side : CLIENT) this is fixed as "TOSERVER". For SERVER to CLIENT packets,
|
||||
* several possible values exist.
|
||||
*
|
||||
@@ -132,7 +132,7 @@ public enum NetworkRegistry
|
||||
* a utility codec, {@link FMLIndexedMessageToMessageCodec} that transforms from {@link FMLProxyPacket} to a mod
|
||||
* message using a message discriminator byte. This is optional, but highly recommended for use.
|
||||
*
|
||||
* Note also that the handlers supplied need to be {@link ChannelHandler.Shareable} - they are injected into two
|
||||
* Note also that the handlers supplied need to be {@link ChannelHandler.Sharable} - they are injected into two
|
||||
* channels.
|
||||
*
|
||||
* @param name
|
||||
@@ -258,7 +258,7 @@ public enum NetworkRegistry
|
||||
* @param x X coord
|
||||
* @param y Y coord
|
||||
* @param z Z coord
|
||||
* @return The client side GUI object (An instance of {@link GUI})
|
||||
* @return The client side GUI object (An instance of {@link net.minecraft.client.gui.Gui})
|
||||
*/
|
||||
public Object getLocalGuiContainer(ModContainer mc, EntityPlayer player, int modGuiId, World world, int x, int y, int z)
|
||||
{
|
||||
|
||||
@@ -2,8 +2,8 @@ package net.minecraftforge.fml.common.network.simpleimpl;
|
||||
|
||||
|
||||
/**
|
||||
* A message handler based on {@link IMessage}. Implement and override {@link #onMessage(IMessage)} to
|
||||
* process your packet. Supply the class to {@link SimpleNetworkWrapper#registerMessage(Class, Class, byte, net.minecraftforge.fml.relauncher.Side)}
|
||||
* A message handler based on {@link IMessage}. Implement and override {@link #onMessage(IMessage, MessageContext)} to
|
||||
* process your packet. Supply the class to {@link SimpleNetworkWrapper#registerMessage(Class, Class, int, net.minecraftforge.fml.relauncher.Side)}
|
||||
* to register both the message type and it's associated handler.
|
||||
*
|
||||
* @author cpw
|
||||
|
||||
+3
-2
@@ -16,6 +16,7 @@ import net.minecraft.network.INetHandler;
|
||||
import net.minecraft.network.Packet;
|
||||
import net.minecraft.tileentity.TileEntity;
|
||||
import net.minecraftforge.fml.common.FMLLog;
|
||||
import net.minecraftforge.fml.common.event.FMLInitializationEvent;
|
||||
import net.minecraftforge.fml.common.event.FMLPreInitializationEvent;
|
||||
import net.minecraftforge.fml.common.network.FMLEmbeddedChannel;
|
||||
import net.minecraftforge.fml.common.network.FMLOutboundHandler;
|
||||
@@ -32,7 +33,7 @@ import net.minecraftforge.fml.relauncher.Side;
|
||||
* Usage is simple:<ul>
|
||||
* <li>construct, and store, an instance of this class. It will automatically register and configure your underlying netty channel.
|
||||
*
|
||||
* <li>Then, call {@link #registerMessage(Class, Class, byte, Side)} for each message type you want to exchange
|
||||
* <li>Then, call {@link #registerMessage(Class, Class, int, Side)} for each message type you want to exchange
|
||||
* providing an {@link IMessageHandler} implementation class as well as an {@link IMessage} implementation class. The side parameter
|
||||
* to that method indicates which side (server or client) the <em>message processing</em> will occur on. The discriminator byte
|
||||
* should be unique for this channelName - it is used to discriminate between different types of message that might
|
||||
@@ -193,7 +194,7 @@ public class SimpleNetworkWrapper {
|
||||
|
||||
/**
|
||||
* Construct a minecraft packet from the supplied message. Can be used where minecraft packets are required, such as
|
||||
* {@link TileEntity#func_145844_m}.
|
||||
* {@link TileEntity#getDescriptionPacket()}.
|
||||
*
|
||||
* @param message The message to translate into packet form
|
||||
* @return A minecraft {@link Packet} suitable for use in minecraft APIs
|
||||
|
||||
@@ -12,7 +12,7 @@ import net.minecraftforge.fml.common.registry.VillagerRegistry.VillagerProfessio
|
||||
/**
|
||||
* A class that exposes static references to all vanilla and Forge registries.
|
||||
* Created to have a central place to access the registries directly if modders need.
|
||||
* It is still advised that if you are registering things to go through {@link GameRegistry.register} but queries and iterations can use this.
|
||||
* It is still advised that if you are registering things to go through {@link GameRegistry} register methods, but queries and iterations can use this.
|
||||
*/
|
||||
public class ForgeRegistries
|
||||
{
|
||||
|
||||
+1
-1
@@ -32,7 +32,7 @@ public interface IEntityAdditionalSpawnData
|
||||
* Called by the client when it receives a Entity spawn packet.
|
||||
* Data should be read out of the stream in the same way as it was written.
|
||||
*
|
||||
* @param data The packet data stream
|
||||
* @param additionalData The packet data stream
|
||||
*/
|
||||
public void readSpawnData(ByteBuf additionalData);
|
||||
}
|
||||
@@ -14,7 +14,7 @@ import com.google.common.base.Throwables;
|
||||
|
||||
|
||||
/**
|
||||
* Internal class used in tracking {@link ItemStackHolder} references
|
||||
* Internal class used in tracking {@link GameRegistry.ItemStackHolder} references
|
||||
*
|
||||
* @author cpw
|
||||
*
|
||||
|
||||
Reference in new issue
Block a user