added methods in Block to send a fake update packet, moved Packet cla…

…ss to packet package, adds BlockChangePacket, updates to .gitignore, README, and pom

.gitignore

@@ -8,7 +8,7 @@
 /target/
 *.prefs
 *.sw?
-dependency-reduced-pom.xml
 /bin
 /docs
-/javadoc-gen.xml
+/.idea/
+*.iml

README.md

@@ -1,8 +1,8 @@
 CanaryLib
 =========
 
-[Last Build](http://build.canarymod.net/job/CanaryLib/lastBuild/net.canarymod$CanaryLib/) ![Build Status](http://build.canarymod.net/job/CanaryLib/badge/icon)  
-[Last Successful Build](http://build.canarymod.net/job/CanaryLib/lastSuccessfulBuild/net.canarymod$CanaryLib/)  
+[Last Build](http://build.canarymod.net/job/CanaryLib/lastBuild/net.canarymod$CanaryLib/)
+[Last Successful Build](http://build.canarymod.net/job/CanaryLib/lastSuccessfulBuild/net.canarymod$CanaryLib/)
 [ChangeLog](http://build.canarymod.net/job/CanaryLib/changes)  
 
 CanaryMod is a Minecraft Server wrapper and library with built-in data  
@@ -33,7 +33,7 @@ Maven
         </dependency>  
 
 
-*Unoffical repository (until the official one is setup):*
+*Repository:*
 
         <repository>  
             <id>vi-repo</id>  
@@ -45,7 +45,7 @@ Maven
 Non-Maven
 ------------- 
 
-  Add CanaryLib and VIUtils 1.0.4 to the build path of your Plugin project. 
+  Add CanaryLib (unshaded or shaded) and VIUtils 1.1.1 (if using unshaded) to the build path of your Plugin project.
   VIUtils downloads can be found at [http://wiki.visualillusionsent.net/VIUtils](http://wiki.visualillusionsent.net/VIUtils) or [http://repo.visualillusionsent.net/net/visualillusionsent/viutils/](http://repo.visualillusionsent.net/net/visualillusionsent/viutils/)  
 
 Java Docs
@@ -65,7 +65,7 @@ http://docs.visualillusionsent.net/VIUtils/
 Pull Requests
 =============
 
-It helps us when others take the time to submit fixes rather than just pointing out bugs/inconsistancies.  
+It helps us when others take the time to submit fixes rather than just pointing out bugs/inconsistencies.
 However, We have standards for the sources we have. Things like formatting  
 and generally following the [Sun/Oracle coding standards](http://www.oracle.com/technetwork/java/javase/documentation/codeconvtoc-136057.html)  
 
@@ -80,5 +80,18 @@ Source Formatting and requirements
     If you’re on a Windows machine, set it to true — this converts LF endings into CRLF when you check out code. (git config --global core.autocrlf true)  
   * Eclipse: http://stackoverflow.com/a/11596227/532590
   * NetBeans: http://stackoverflow.com/a/1866385/532590
+  * IntelliJ: http://stackoverflow.com/a/9872584
 * JavaDocs well written (as necessary)
-* Matching how we format statements
+* Matching how we format statements
+
+        public class MyClass { //note the whitespace
+            public void function() {
+                if (something) {
+                    // do stuff
+                } else if (somethingElse) {
+                    // do other stuff
+                } else {
+                    // do else stuff
+                }
+            }
+        }

pom.xml

@@ -89,7 +89,7 @@
     <dependency>
     <groupId>org.xerial</groupId>
     <artifactId>sqlite-jdbc</artifactId>
-   </dependency>
+    </dependency>
     <dependency>
       <groupId>net.visualillusionsent</groupId>
       <artifactId>viutils</artifactId>

src/main/java/net/canarymod/api/ConfigurationManager.java

@@ -2,6 +2,7 @@
 
 import java.util.ArrayList;
 import net.canarymod.api.entity.living.humanoid.Player;
+import net.canarymod.api.packet.Packet;
 import net.canarymod.api.world.DimensionType;
 import net.canarymod.api.world.World;
 import net.canarymod.api.world.blocks.Block;
@@ -20,7 +21,7 @@ public interface ConfigurationManager {
      * @param world
      *            the {@link World} name
      * @param packet
-     *            the {@link Packet} to be sent
+     *            the {@link net.canarymod.api.packet.Packet} to be sent
      */
     public void sendPacketToAllInWorld(String world, Packet packet);
 

src/main/java/net/canarymod/api/EntityTracker.java

@@ -3,6 +3,7 @@
 import java.util.ArrayList;
 import net.canarymod.api.entity.Entity;
 import net.canarymod.api.entity.living.humanoid.Player;
+import net.canarymod.api.packet.Packet;
 import net.canarymod.api.world.World;
 
 /**
@@ -50,12 +51,12 @@ public interface EntityTracker {
     public World getAttachedDimension();
 
     /**
-     * Send a {@link Packet} to a tracked {@link Player}
+     * Send a {@link net.canarymod.api.packet.Packet} to a tracked {@link Player}
      * 
      * @param player
-     *            the {@link Player} to send the {@link Packet}
+     *            the {@link Player} to send the {@link net.canarymod.api.packet.Packet}
      * @param packet
-     *            the {@link Packet} to be sent
+     *            the {@link net.canarymod.api.packet.Packet} to be sent
      */
     public void sendPacketToTrackedPlayer(Player player, Packet packet);
 

src/main/java/net/canarymod/api/NetServerHandler.java

@@ -1,6 +1,7 @@
 package net.canarymod.api;
 
 import net.canarymod.api.entity.living.humanoid.Player;
+import net.canarymod.api.packet.Packet;
 
 /**
  * NetServerHandler wrapper
@@ -14,7 +15,7 @@ public interface NetServerHandler {
      * It will be sent when it's polled form the queue
      * 
      * @param packet
-     *            the {@link Packet} to be sent
+     *            the {@link net.canarymod.api.packet.Packet} to be sent
      */
     public void sendPacket(Packet packet);
 

src/main/java/net/canarymod/api/entity/living/humanoid/Player.java

@@ -2,7 +2,7 @@
 
 import net.canarymod.api.GameMode;
 import net.canarymod.api.NetServerHandler;
-import net.canarymod.api.Packet;
+import net.canarymod.api.packet.Packet;
 import net.canarymod.api.PlayerListEntry;
 import net.canarymod.api.inventory.Inventory;
 import net.canarymod.api.world.blocks.Sign;

src/main/java/net/canarymod/api/factory/Factory.java

@@ -44,4 +44,11 @@ public interface Factory {
      */
     public NBTFactory getNBTFactory();
 
+    /**
+     * Gets the {@link PacketFactory} instance
+     *
+     * @return {@link PacketFactory}
+     */
+    public PacketFactory getPacketFactory();
+
 }

src/main/java/net/canarymod/api/factory/PacketFactory.java

@@ -0,0 +1,13 @@
+package net.canarymod.api.factory;
+
+/**
+ * Packet Factory
+ *
+ * @author Jason (darkdiplomat)
+ */
+public interface PacketFactory {
+
+    // IMPLEMENTATIONS PENDING
+
+
+}

src/main/java/net/canarymod/api/packet/BlockChangePacket.java

@@ -0,0 +1,133 @@
+package net.canarymod.api.packet;
+
+import net.canarymod.api.world.blocks.Block;
+import net.canarymod.api.world.blocks.BlockType;
+import net.canarymod.api.world.position.Position;
+
+/**
+ * Packet #53 BlockChange
+ *
+ * @author Jason (darkdiplomat)
+ */
+public interface BlockChangePacket extends Packet {
+
+    /**
+     * Gets the X coordinate
+     *
+     * @return X coordinate
+     */
+    public int getX();
+
+    /**
+     * Sets the X coordinate
+     *
+     * @param x
+     *         the X coordinate
+     */
+    public void setX(int x);
+
+    /**
+     * Gets the Y coordinate
+     *
+     * @return Y coordinate
+     */
+    public int getY();
+
+    /**
+     * Sets the Y coordinate
+     *
+     * @param y
+     *         the Y coordinate
+     */
+    public void setY(int y);
+
+    /**
+     * Gets the Z coordinate
+     *
+     * @return Z coordinate
+     */
+    public int getZ();
+
+    /**
+     * Sets the Z coordinate
+     *
+     * @param z
+     *         the Z coordinate
+     */
+    public void setZ(int z);
+
+    /**
+     * Gets the {@link Position}
+     *
+     * @return the {@link Position}
+     */
+    public Position getPosition();
+
+    /**
+     * Sets the {@link Position}
+     *
+     * @param position
+     *         the {@link Position} to set
+     */
+    public void setPosition(Position position);
+
+    /**
+     * Gets the {@link BlockType}
+     *
+     * @return the {@link BlockType}
+     */
+    public BlockType getType();
+
+    /**
+     * Sets the {@link BlockType} (id and data)
+     *
+     * @param type
+     *         the {@link BlockType} to set
+     */
+    public void setType(BlockType type);
+
+    /**
+     * Gets the Type ID
+     *
+     * @return the Type ID
+     */
+    public int getTypeId();
+
+    /**
+     * Sets the Type Id
+     *
+     * @param id
+     *         the Type ID
+     */
+    public void setTypeId(int id);
+
+    /**
+     * Gets the Block Data value
+     *
+     * @return the data
+     */
+    public int getData();
+
+    /**
+     * Sets the Block data value
+     *
+     * @param data
+     *         the Block data
+     */
+    public void setData(int data);
+
+    /**
+     * Gets the {@link Block}
+     *
+     * @return the {@link Block}
+     */
+    public Block getBlock();
+
+    /**
+     * Sets the {@link Block}
+     *
+     * @param block
+     * the {@link Block}
+     */
+    public void setBlock(Block block);
+}

src/main/java/net/canarymod/api/Packet.java → src/main/java/net/canarymod/api/packet/Packet.java

@@ -1,4 +1,4 @@
-package net.canarymod.api;
+package net.canarymod.api.packet;
 
 /**
  * Packet interface.