Complete documentation for all 44 database handlers with centralized performance considerations

src/engine/InterestManagement/HeightMap.java

@@ -0,0 +1,706 @@
+// • ▌ ▄ ·.  ▄▄▄·  ▄▄ • ▪   ▄▄· ▄▄▄▄·  ▄▄▄·  ▐▄▄▄  ▄▄▄ .
+// ·██ ▐███▪▐█ ▀█ ▐█ ▀ ▪██ ▐█ ▌▪▐█ ▀█▪▐█ ▀█ •█▌ ▐█▐▌·
+// ▐█ ▌▐▌▐█·▄█▀▀█ ▄█ ▀█▄▐█·██ ▄▄▐█▀▀█▄▄█▀▀█ ▐█▐ ▐▌▐▀▀▀
+// ██ ██▌▐█▌▐█ ▪▐▌▐█▄▪▐█▐█▌▐███▌██▄▪▐█▐█ ▪▐▌██▐ █▌▐█▄▄▌
+// ▀▀  █▪▀▀▀ ▀  ▀ ·▀▀▀▀ ▀▀▀·▀▀▀ ·▀▀▀▀  ▀  ▀ ▀▀  █▪ ▀▀▀
+//      Magicbane Emulator Project © 2013 - 2022
+//                www.magicbane.com
+
+package engine.InterestManagement;
+
+import engine.Enum;
+import engine.gameManager.ConfigManager;
+import engine.gameManager.DbManager;
+import engine.gameManager.ZoneManager;
+import engine.math.Vector2f;
+import engine.math.Vector3fImmutable;
+import engine.objects.AbstractWorldObject;
+import engine.objects.Zone;
+import engine.util.MapLoader;
+import org.pmw.tinylog.Logger;
+
+import javax.imageio.ImageIO;
+import java.awt.*;
+import java.awt.image.BufferedImage;
+import java.io.File;
+import java.io.IOException;
+import java.sql.ResultSet;
+import java.sql.SQLException;
+import java.util.HashMap;
+
+public class HeightMap {
+
+    // Class variables
+
+    // Heightmap data for all zones.
+
+    public static final HashMap<Integer, HeightMap> heightmapByLoadNum = new HashMap<>();
+
+    // Bootstrap Tracking
+
+    public static int heightMapsCreated = 0;
+    public static HeightMap PlayerCityHeightMap;
+
+    // Heightmap data for this heightmap
+
+    public BufferedImage heightmapImage;
+
+    private int heightMapID;
+    private int maxHeight;
+    private int fullExtentsX;
+    private int fullExtentsY;
+
+    private float bucketWidthX;
+    private float bucketWidthY;
+    private int zoneLoadID;
+    private float seaLevel = 0;
+    private float outsetX;
+    private float outsetZ;
+    private int[][] pixelColorValues;
+
+    public HeightMap(ResultSet rs) throws SQLException {
+
+        this.heightMapID = rs.getInt("heightMapID");
+        this.maxHeight = rs.getInt("maxHeight");
+        int halfExtentsX = rs.getInt("xRadius");
+        int halfExtentsY = rs.getInt("zRadius");
+        this.zoneLoadID = rs.getInt("zoneLoadID");
+        this.seaLevel = rs.getFloat("seaLevel");
+        this.outsetX = rs.getFloat("outsetX");
+        this.outsetZ = rs.getFloat("outsetZ");
+
+
+        // Cache the full extents to avoid the calculation
+
+        this.fullExtentsX = halfExtentsX * 2;
+        this.fullExtentsY = halfExtentsY * 2;
+
+        this.heightmapImage = null;
+        File imageFile = new File(ConfigManager.DEFAULT_DATA_DIR + "heightmaps/" + this.heightMapID + ".bmp");
+
+        // early exit if no image file was found.  Will log in caller.
+
+        if (!imageFile.exists())
+            return;
+
+        // load the heightmap image.
+
+        try {
+            this.heightmapImage = ImageIO.read(imageFile);
+        } catch (IOException e) {
+            Logger.error("***Error loading heightmap data for heightmap " + this.heightMapID + e.toString());
+        }
+
+        // We needed to flip the image as OpenGL and Shadowbane both use the bottom left corner as origin.
+
+        this.heightmapImage = MapLoader.flipImage(this.heightmapImage);
+
+        // Calculate the data we do not load from table
+
+        float numOfBuckets = this.heightmapImage.getWidth() - 1;
+        float calculatedWidth = this.fullExtentsX / numOfBuckets;
+        this.bucketWidthX = calculatedWidth;
+        this.bucketWidthY = this.bucketWidthX; // This makes no sense.
+
+        // Generate pixel array from image data
+
+        generatePixelData();
+
+        HeightMap.heightmapByLoadNum.put(this.zoneLoadID, this);
+
+        heightMapsCreated++;
+    }
+
+    //Created for PlayerCities
+    public HeightMap() {
+
+        this.heightMapID = 999999;
+        this.maxHeight = 5; // for real...
+        int halfExtentsX = (int) Enum.CityBoundsType.ZONE.extents;
+        int halfExtentsY = (int) Enum.CityBoundsType.ZONE.extents;
+        this.zoneLoadID = 0;
+        this.seaLevel = 0;
+        this.outsetX = 128;
+        this.outsetZ = 128;
+
+
+        // Cache the full extents to avoid the calculation
+
+        this.fullExtentsX = halfExtentsX * 2;
+        this.fullExtentsY = halfExtentsY * 2;
+
+
+        // load the heightmap image.
+
+
+        // We needed to flip the image as OpenGL and Shadowbane both use the bottom left corner as origin.
+
+        this.heightmapImage = null;
+
+        // Calculate the data we do not load from table
+
+        this.bucketWidthX = 1;
+        this.bucketWidthY = 1;
+
+        this.pixelColorValues = new int[this.fullExtentsX + 1][this.fullExtentsY + 1];
+
+        for (int y = 0; y <= this.fullExtentsY; y++) {
+            for (int x = 0; x <= this.fullExtentsX; x++) {
+                pixelColorValues[x][y] = 255;
+            }
+        }
+
+
+        HeightMap.heightmapByLoadNum.put(this.zoneLoadID, this);
+    }
+
+    public HeightMap(Zone zone) {
+
+        this.heightMapID = 999999;
+        this.maxHeight = 0;
+        int halfExtentsX = (int) zone.getBounds().getHalfExtents().x;
+        int halfExtentsY = (int) zone.getBounds().getHalfExtents().y;
+        this.zoneLoadID = 0;
+        this.seaLevel = 0;
+        this.outsetX = 0;
+        this.outsetZ = 0;
+
+        // Cache the full extents to avoid the calculation
+
+        this.fullExtentsX = halfExtentsX * 2;
+        this.fullExtentsY = halfExtentsY * 2;
+
+
+        // We needed to flip the image as OpenGL and Shadowbane both use the bottom left corner as origin.
+
+        this.heightmapImage = null;
+
+        // Calculate the data we do not load from table
+
+        this.bucketWidthX = 1;
+        this.bucketWidthY = 1;
+
+        this.pixelColorValues = new int[this.fullExtentsX + 1][this.fullExtentsY + 1];
+
+        for (int y = 0; y <= this.fullExtentsY; y++) {
+            for (int x = 0; x <= this.fullExtentsX; x++) {
+                pixelColorValues[x][y] = 255;
+            }
+        }
+
+
+        HeightMap.heightmapByLoadNum.put(this.zoneLoadID, this);
+    }
+
+    public static void GeneratePlayerCityHeightMap() {
+
+        HeightMap.PlayerCityHeightMap = new HeightMap();
+
+    }
+
+    public static void GenerateCustomHeightMap(Zone zone) {
+
+        HeightMap heightMap = new HeightMap(zone);
+
+        HeightMap.heightmapByLoadNum.put(zone.getLoadNum(), heightMap);
+
+    }
+
+    public static Zone getNextZoneWithTerrain(Zone zone) {
+
+        Zone nextZone = zone;
+
+        if (zone.getHeightMap() != null)
+            return zone;
+
+        if (zone.equals(ZoneManager.getSeaFloor()))
+            return zone;
+
+        while (nextZone.getHeightMap() == null)
+            nextZone = nextZone.getParent();
+
+        return nextZone;
+    }
+
+    public static float getWorldHeight(AbstractWorldObject worldObject) {
+
+        Vector2f parentLoc = new Vector2f(-1, -1);
+        Zone currentZone = ZoneManager.findSmallestZone(worldObject.getLoc());
+
+        if (currentZone == null)
+            return worldObject.getAltitude();
+
+        currentZone = getNextZoneWithTerrain(currentZone);
+
+        if (currentZone == ZoneManager.getSeaFloor())
+            return currentZone.getAbsY() + worldObject.getAltitude();
+
+        Zone parentZone = getNextZoneWithTerrain(currentZone.getParent());
+        HeightMap heightMap = currentZone.getHeightMap();
+
+        Vector2f zoneLoc = ZoneManager.worldToZoneSpace(worldObject.getLoc(), currentZone);
+        Vector3fImmutable localLocFromCenter = ZoneManager.worldToLocal(worldObject.getLoc(), currentZone);
+
+        if ((parentZone != null) && (parentZone.getHeightMap() != null))
+            parentLoc = ZoneManager.worldToZoneSpace(worldObject.getLoc(), parentZone);
+
+        float interaltitude = currentZone.getHeightMap().getInterpolatedTerrainHeight(zoneLoc);
+
+        float worldAltitude = currentZone.getWorldAltitude();
+
+        float realWorldAltitude = interaltitude + worldAltitude;
+
+        //OUTSET
+
+        if (parentZone != null) {
+
+            float parentXRadius = currentZone.getBounds().getHalfExtents().x;
+            float parentZRadius = currentZone.getBounds().getHalfExtents().y;
+
+            float offsetX = Math.abs((localLocFromCenter.x / parentXRadius));
+            float offsetZ = Math.abs((localLocFromCenter.z / parentZRadius));
+
+            float bucketScaleX = heightMap.outsetX / parentXRadius;
+            float bucketScaleZ = heightMap.outsetZ / parentZRadius;
+
+            if (bucketScaleX <= 0.40000001)
+                bucketScaleX = heightMap.outsetZ / parentXRadius;
+
+            if (bucketScaleX > 0.40000001)
+                bucketScaleX = 0.40000001f;
+
+            if (bucketScaleZ <= 0.40000001)
+                bucketScaleZ = heightMap.outsetX / parentZRadius;
+
+            if (bucketScaleZ > 0.40000001)
+                bucketScaleZ = 0.40000001f;
+
+            float outsideGridSizeX = 1 - bucketScaleX; //32/256
+            float outsideGridSizeZ = 1 - bucketScaleZ;
+            float weight;
+
+            double scale;
+
+            if (offsetX > outsideGridSizeX && offsetX > offsetZ) {
+                weight = (offsetX - outsideGridSizeX) / bucketScaleX;
+                scale = Math.atan2((.5 - weight) * 3.1415927, 1);
+
+                float scaleChild = (float) ((scale + 1) * .5);
+                float scaleParent = 1 - scaleChild;
+
+                float parentAltitude = parentZone.getHeightMap().getInterpolatedTerrainHeight(parentLoc);
+                float parentCenterAltitude = parentZone.getHeightMap().getInterpolatedTerrainHeight(ZoneManager.worldToZoneSpace(currentZone.getLoc(), parentZone));
+
+                parentCenterAltitude += currentZone.getYCoord();
+                parentCenterAltitude += interaltitude;
+
+                float firstScale = parentAltitude * scaleParent;
+                float secondScale = parentCenterAltitude * scaleChild;
+                float outsetALt = firstScale + secondScale;
+
+                outsetALt += currentZone.getParent().getWorldAltitude();
+                realWorldAltitude = outsetALt;
+
+            } else if (offsetZ > outsideGridSizeZ) {
+
+                weight = (offsetZ - outsideGridSizeZ) / bucketScaleZ;
+                scale = Math.atan2((.5 - weight) * 3.1415927, 1);
+
+                float scaleChild = (float) ((scale + 1) * .5);
+                float scaleParent = 1 - scaleChild;
+                float parentAltitude = parentZone.getHeightMap().getInterpolatedTerrainHeight(parentLoc);
+                float parentCenterAltitude = parentZone.getHeightMap().getInterpolatedTerrainHeight(ZoneManager.worldToZoneSpace(currentZone.getLoc(), parentZone));
+
+                parentCenterAltitude += currentZone.getYCoord();
+                parentCenterAltitude += interaltitude;
+                float firstScale = parentAltitude * scaleParent;
+                float secondScale = parentCenterAltitude * scaleChild;
+                float outsetALt = firstScale + secondScale;
+
+                outsetALt += currentZone.getParent().getWorldAltitude();
+                realWorldAltitude = outsetALt;
+            }
+        }
+
+        return realWorldAltitude;
+    }
+
+    public static float getWorldHeight(Vector3fImmutable worldLoc) {
+
+        Vector2f parentLoc = new Vector2f(-1, -1);
+        Zone currentZone = ZoneManager.findSmallestZone(worldLoc);
+
+        if (currentZone == null)
+            return 0;
+
+        currentZone = getNextZoneWithTerrain(currentZone);
+
+        if (currentZone == ZoneManager.getSeaFloor())
+            return currentZone.getAbsY();
+
+        Zone parentZone = getNextZoneWithTerrain(currentZone.getParent());
+        HeightMap heightMap = currentZone.getHeightMap();
+
+        if ((heightMap == null) || (currentZone == ZoneManager.getSeaFloor()))
+            return currentZone.getAbsY();
+
+        Vector2f zoneLoc = ZoneManager.worldToZoneSpace(worldLoc, currentZone);
+        Vector3fImmutable localLocFromCenter = ZoneManager.worldToLocal(worldLoc, currentZone);
+
+        if ((parentZone != null) && (parentZone.getHeightMap() != null))
+            parentLoc = ZoneManager.worldToZoneSpace(worldLoc, parentZone);
+
+        float interaltitude = currentZone.getHeightMap().getInterpolatedTerrainHeight(zoneLoc);
+
+        float worldAltitude = currentZone.getWorldAltitude();
+
+        float realWorldAltitude = interaltitude + worldAltitude;
+
+        //OUTSET
+
+        if (parentZone != null) {
+
+            //			if (currentZone.getHeightMap() != null && parentZone.getHeightMap() != null && parentZone.getParent() != null && parentZone.getParent().getHeightMap() != null)
+            //				return realWorldAltitude;
+
+            float parentXRadius = currentZone.getBounds().getHalfExtents().x;
+            float parentZRadius = currentZone.getBounds().getHalfExtents().y;
+
+            float offsetX = Math.abs((localLocFromCenter.x / parentXRadius));
+            float offsetZ = Math.abs((localLocFromCenter.z / parentZRadius));
+
+            float bucketScaleX = heightMap.outsetX / parentXRadius;
+            float bucketScaleZ = heightMap.outsetZ / parentZRadius;
+
+            float outsideGridSizeX = 1 - bucketScaleX; //32/256
+            float outsideGridSizeZ = 1 - bucketScaleZ;
+            float weight;
+
+            double scale;
+
+
+            if (offsetX > outsideGridSizeX && offsetX > offsetZ) {
+                weight = (offsetX - outsideGridSizeX) / bucketScaleX;
+                scale = Math.atan2((.5 - weight) * 3.1415927, 1);
+
+                float scaleChild = (float) ((scale + 1) * .5);
+                float scaleParent = 1 - scaleChild;
+
+                float parentAltitude = parentZone.getHeightMap().getInterpolatedTerrainHeight(parentLoc);
+                float parentCenterAltitude = parentZone.getHeightMap().getInterpolatedTerrainHeight(ZoneManager.worldToZoneSpace(currentZone.getLoc(), parentZone));
+
+                parentCenterAltitude += currentZone.getYCoord();
+                parentCenterAltitude += interaltitude;
+
+                float firstScale = parentAltitude * scaleParent;
+                float secondScale = parentCenterAltitude * scaleChild;
+                float outsetALt = firstScale + secondScale;
+
+                outsetALt += currentZone.getParent().getWorldAltitude();
+                realWorldAltitude = outsetALt;
+
+            } else if (offsetZ > outsideGridSizeZ) {
+
+                weight = (offsetZ - outsideGridSizeZ) / bucketScaleZ;
+                scale = Math.atan2((.5 - weight) * 3.1415927, 1);
+
+                float scaleChild = (float) ((scale + 1) * .5);
+                float scaleParent = 1 - scaleChild;
+                float parentAltitude = parentZone.getHeightMap().getInterpolatedTerrainHeight(parentLoc);
+                float parentCenterAltitude = parentZone.getHeightMap().getInterpolatedTerrainHeight(ZoneManager.worldToZoneSpace(currentZone.getLoc(), parentZone));
+
+                parentCenterAltitude += currentZone.getYCoord();
+                parentCenterAltitude += interaltitude;
+                float firstScale = parentAltitude * scaleParent;
+                float secondScale = parentCenterAltitude * scaleChild;
+                float outsetALt = firstScale + secondScale;
+
+                outsetALt += currentZone.getParent().getWorldAltitude();
+                realWorldAltitude = outsetALt;
+            }
+        }
+
+        return realWorldAltitude;
+    }
+
+    public static float getOutsetHeight(float interpolatedAltitude, Zone zone, Vector3fImmutable worldLocation) {
+
+        Vector2f parentLoc;
+        float outsetALt = 0;
+
+        if (zone.getParent() == null || zone.getParent().getHeightMap() == null)
+            return interpolatedAltitude + zone.getWorldAltitude();
+
+        if (zone.getParent() != null && zone.getParent().getHeightMap() != null) {
+
+            parentLoc = ZoneManager.worldToZoneSpace(worldLocation, zone.getParent());
+
+            Vector3fImmutable localLocFromCenter = ZoneManager.worldToLocal(worldLocation, zone);
+
+            float parentXRadius = zone.getBounds().getHalfExtents().x;
+            float parentZRadius = zone.getBounds().getHalfExtents().y;
+
+            float bucketScaleX = zone.getHeightMap().outsetX / parentXRadius;
+            float bucketScaleZ = zone.getHeightMap().outsetZ / parentZRadius;
+
+            float outsideGridSizeX = 1 - bucketScaleX; //32/256
+            float outsideGridSizeZ = 1 - bucketScaleZ;
+
+            float weight;
+            double scale;
+
+            float offsetX = Math.abs((localLocFromCenter.x / parentXRadius));
+            float offsetZ = Math.abs((localLocFromCenter.z / parentZRadius));
+
+            if (offsetX > outsideGridSizeX && offsetX > offsetZ) {
+                weight = (offsetX - outsideGridSizeX) / bucketScaleX;
+                scale = Math.atan2((.5 - weight) * 3.1415927, 1);
+
+                float scaleChild = (float) ((scale + 1) * .5);
+                float scaleParent = 1 - scaleChild;
+
+                float parentAltitude = zone.getParent().getHeightMap().getInterpolatedTerrainHeight(parentLoc);
+                float parentCenterAltitude = zone.getParent().getHeightMap().getInterpolatedTerrainHeight(ZoneManager.worldToZoneSpace(zone.getLoc(), zone.getParent()));
+
+                parentCenterAltitude += zone.getYCoord();
+                parentCenterAltitude += interpolatedAltitude;
+
+                float firstScale = parentAltitude * scaleParent;
+                float secondScale = parentCenterAltitude * scaleChild;
+                outsetALt = firstScale + secondScale;
+
+                outsetALt += zone.getParent().getAbsY();
+
+            } else if (offsetZ > outsideGridSizeZ) {
+
+                weight = (offsetZ - outsideGridSizeZ) / bucketScaleZ;
+                scale = Math.atan2((.5 - weight) * 3.1415927, 1);
+
+                float scaleChild = (float) ((scale + 1) * .5);
+                float scaleParent = 1 - scaleChild;
+                float parentAltitude = zone.getParent().getHeightMap().getInterpolatedTerrainHeight(parentLoc);
+                float parentCenterAltitude = zone.getHeightMap().getInterpolatedTerrainHeight(ZoneManager.worldToZoneSpace(zone.getLoc(), zone));
+
+                parentCenterAltitude += zone.getYCoord();
+                parentCenterAltitude += interpolatedAltitude;
+
+                float firstScale = parentAltitude * scaleParent;
+                float secondScale = parentCenterAltitude * scaleChild;
+                outsetALt = firstScale + secondScale;
+
+                outsetALt += zone.getParent().getAbsY();
+            }
+
+        }
+
+        return outsetALt;
+    }
+
+    public static Vector2f getGridOffset(Vector2f gridSquare) {
+
+        int floorX = (int) gridSquare.x;
+        int floorY = (int) gridSquare.y;
+
+        return new Vector2f(gridSquare.x - floorX, gridSquare.y - floorY);
+
+    }
+
+    public static void loadAlHeightMaps() {
+
+        // Load the heightmaps into staging hashmap keyed by HashMapID
+
+        DbManager.HeightMapQueries.LOAD_ALL_HEIGHTMAPS();
+
+        //generate static player city heightmap.
+
+        HeightMap.GeneratePlayerCityHeightMap();
+
+
+        // Clear all heightmap image data as it's no longer needed.
+
+        for (HeightMap heightMap : HeightMap.heightmapByLoadNum.values()) {
+            heightMap.heightmapImage = null;
+        }
+
+        Logger.info(HeightMap.heightmapByLoadNum.size() + " Heightmaps cached.");
+    }
+
+    public static boolean isLocUnderwater(Vector3fImmutable currentLoc) {
+
+        float localAltitude = HeightMap.getWorldHeight(currentLoc);
+        Zone zone = ZoneManager.findSmallestZone(currentLoc);
+
+        if (localAltitude < zone.getSeaLevel())
+            return true;
+
+        return false;
+    }
+
+    public Vector2f getGridSquare(Vector2f zoneLoc) {
+
+        if (zoneLoc.x < 0)
+            zoneLoc.setX(0);
+
+        if (zoneLoc.x > this.fullExtentsX - 1)
+            zoneLoc.setX((this.fullExtentsX - 1) + .9999999f);
+
+        if (zoneLoc.y < 0)
+            zoneLoc.setY(0);
+
+        if (zoneLoc.y > this.fullExtentsY - 1)
+            zoneLoc.setY((this.fullExtentsY - 1) + .9999999f);
+
+        float xBucket = (zoneLoc.x / this.bucketWidthX);
+        float yBucket = (zoneLoc.y / this.bucketWidthY);
+
+        return new Vector2f(xBucket, yBucket);
+    }
+
+    public float getInterpolatedTerrainHeight(Vector2f zoneLoc) {
+
+        Vector2f gridSquare;
+
+        if (zoneLoc.x < 0 || zoneLoc.x > this.fullExtentsX)
+            return -1;
+
+        if (zoneLoc.y < 0 || zoneLoc.y > this.fullExtentsY)
+            return -1;
+
+        int maxX = (int) (this.fullExtentsX / this.bucketWidthX);
+        int maxY = (int) (this.fullExtentsY / this.bucketWidthY);
+
+        //flip the Y so it grabs from the bottom left instead of top left.
+        //zoneLoc.setY(maxZoneHeight - zoneLoc.y);
+
+        gridSquare = getGridSquare(zoneLoc);
+
+        int gridX = (int) gridSquare.x;
+        int gridY = (int) (gridSquare.y);
+
+        if (gridX > maxX)
+            gridX = maxX;
+        if (gridY > maxY)
+            gridY = maxY;
+
+        float offsetX = (gridSquare.x - gridX);
+        float offsetY = gridSquare.y - gridY;
+
+        //get height of the 4 vertices.
+
+        float topLeftHeight = 0;
+        float topRightHeight = 0;
+        float bottomLeftHeight = 0;
+        float bottomRightHeight = 0;
+
+        int nextY = gridY + 1;
+        int nextX = gridX + 1;
+
+        if (nextY > maxY)
+            nextY = gridY;
+
+        if (nextX > maxX)
+            nextX = gridX;
+
+        topLeftHeight = pixelColorValues[gridX][gridY];
+        topRightHeight = pixelColorValues[nextX][gridY];
+        bottomLeftHeight = pixelColorValues[gridX][nextY];
+        bottomRightHeight = pixelColorValues[nextX][nextY];
+
+        float interpolatedHeight;
+
+        interpolatedHeight = topRightHeight * (1 - offsetY) * (offsetX);
+        interpolatedHeight += (bottomRightHeight * offsetY * offsetX);
+        interpolatedHeight += (bottomLeftHeight * (1 - offsetX) * offsetY);
+        interpolatedHeight += (topLeftHeight * (1 - offsetX) * (1 - offsetY));
+
+        interpolatedHeight *= (float) this.maxHeight / 256;  // Scale height
+
+        return interpolatedHeight;
+    }
+
+    public float getInterpolatedTerrainHeight(Vector3fImmutable zoneLoc3f) {
+
+        Vector2f zoneLoc = new Vector2f(zoneLoc3f.x, zoneLoc3f.z);
+
+        Vector2f gridSquare;
+
+        if (zoneLoc.x < 0 || zoneLoc.x > this.fullExtentsX)
+            return -1;
+
+        if (zoneLoc.y < 0 || zoneLoc.y > this.fullExtentsY)
+            return -1;
+
+        //flip the Y so it grabs from the bottom left instead of top left.
+        //zoneLoc.setY(maxZoneHeight - zoneLoc.y);
+
+        gridSquare = getGridSquare(zoneLoc);
+
+        int gridX = (int) gridSquare.x;
+        int gridY = (int) (gridSquare.y);
+
+        float offsetX = (gridSquare.x - gridX);
+        float offsetY = gridSquare.y - gridY;
+
+        //get height of the 4 vertices.
+
+        float topLeftHeight = pixelColorValues[gridX][gridY];
+        float topRightHeight = pixelColorValues[gridX + 1][gridY];
+        float bottomLeftHeight = pixelColorValues[gridX][gridY + 1];
+        float bottomRightHeight = pixelColorValues[gridX + 1][gridY + 1];
+
+        float interpolatedHeight;
+
+        interpolatedHeight = topRightHeight * (1 - offsetY) * (offsetX);
+        interpolatedHeight += (bottomRightHeight * offsetY * offsetX);
+        interpolatedHeight += (bottomLeftHeight * (1 - offsetX) * offsetY);
+        interpolatedHeight += (topLeftHeight * (1 - offsetX) * (1 - offsetY));
+
+        interpolatedHeight *= (float) this.maxHeight / 256;  // Scale height
+
+        return interpolatedHeight;
+    }
+
+    private void generatePixelData() {
+
+        Color color;
+
+        // Generate altitude lookup table for this heightmap
+
+        this.pixelColorValues = new int[this.heightmapImage.getWidth()][this.heightmapImage.getHeight()];
+
+        for (int y = 0; y < this.heightmapImage.getHeight(); y++) {
+            for (int x = 0; x < this.heightmapImage.getWidth(); x++) {
+
+                color = new Color(this.heightmapImage.getRGB(x, y));
+                pixelColorValues[x][y] = color.getRed();
+            }
+        }
+
+    }
+
+    public float getScaledHeightForColor(float color) {
+
+        return (color / 256) * this.maxHeight;
+    }
+
+    public float getBucketWidthX() {
+        return bucketWidthX;
+    }
+
+    public float getBucketWidthY() {
+        return bucketWidthY;
+    }
+
+    public int getHeightMapID() {
+        return heightMapID;
+    }
+
+    public BufferedImage getHeightmapImage() {
+        return heightmapImage;
+    }
+
+    public float getSeaLevel() {
+        return seaLevel;
+    }
+
+}

src/engine/InterestManagement/InterestManager.java

@@ -140,7 +140,7 @@ public enum InterestManager implements Runnable {
 
             else {
                 if (pc != null)
-                    if (pcc.getSeeInvis() < pc.hidden)
+                    if (pcc.getSeeInvis() < pc.getHidden())
                         continue;
 
                 if (!cc.sendMsg(uom)) {
@@ -340,7 +340,7 @@ public enum InterestManager implements Runnable {
                     if (loadedPlayer.getObjectUUID() == player.getObjectUUID())
                         continue;
 
-                    if (player.getSeeInvis() < loadedPlayer.hidden)
+                    if (player.getSeeInvis() < loadedPlayer.getHidden())
                         continue;
 
                     if (loadedPlayer.safemodeInvis())
@@ -372,7 +372,7 @@ public enum InterestManager implements Runnable {
 
             if (playerLoadedObject.getObjectType().equals(GameObjectType.PlayerCharacter)) {
                 PlayerCharacter loadedPlayer = (PlayerCharacter) playerLoadedObject;
-                if (player.getSeeInvis() < loadedPlayer.hidden)
+                if (player.getSeeInvis() < loadedPlayer.getHidden())
                     toRemove.add(playerLoadedObject);
                 else if (loadedPlayer.safemodeInvis())
                     toRemove.add(playerLoadedObject);
@@ -437,7 +437,7 @@ public enum InterestManager implements Runnable {
 
                     // dont load if invis
 
-                    if (player.getSeeInvis() < awopc.hidden)
+                    if (player.getSeeInvis() < awopc.getHidden())
                         continue;
 
                     lcm = new LoadCharacterMsg(awopc, PlayerCharacter.hideNonAscii());
@@ -467,7 +467,7 @@ public enum InterestManager implements Runnable {
                     if (awonpc.despawned == true)
                         continue;
 
-                    awonpc.playerAgroMap.put(player.getObjectUUID(), 0f);
+                    awonpc.playerAgroMap.put(player.getObjectUUID(), false);
                     ((Mob) awonpc).setCombatTarget(null);
                     lcm = new LoadCharacterMsg(awonpc, PlayerCharacter.hideNonAscii());
 
@@ -480,7 +480,7 @@ public enum InterestManager implements Runnable {
                     if (!awonpc.isAlive())
                         continue;
 
-                    awonpc.playerAgroMap.put(player.getObjectUUID(), 0f);
+                    awonpc.playerAgroMap.put(player.getObjectUUID(), false);
 
                     if ((awonpc.agentType.equals(Enum.AIAgentType.MOBILE)))
                         ((Mob) awonpc).setCombatTarget(null);

src/engine/InterestManagement/Terrain.java

@@ -1,230 +0,0 @@
-// • ▌ ▄ ·.  ▄▄▄·  ▄▄ • ▪   ▄▄· ▄▄▄▄·  ▄▄▄·  ▐▄▄▄  ▄▄▄ .
-// ·██ ▐███▪▐█ ▀█ ▐█ ▀ ▪██ ▐█ ▌▪▐█ ▀█▪▐█ ▀█ •█▌ ▐█▐▌·
-// ▐█ ▌▐▌▐█·▄█▀▀█ ▄█ ▀█▄▐█·██ ▄▄▐█▀▀█▄▄█▀▀█ ▐█▐ ▐▌▐▀▀▀
-// ██ ██▌▐█▌▐█ ▪▐▌▐█▄▪▐█▐█▌▐███▌██▄▪▐█▐█ ▪▐▌██▐ █▌▐█▄▄▌
-// ▀▀  █▪▀▀▀ ▀  ▀ ·▀▀▀▀ ▀▀▀·▀▀▀ ·▀▀▀▀  ▀  ▀ ▀▀  █▪ ▀▀▀
-//      Magicbane Emulator Project © 2013 - 2022
-//                www.magicbane.com
-
-package engine.InterestManagement;
-
-import engine.gameManager.ZoneManager;
-import engine.math.Vector2f;
-import engine.math.Vector3fImmutable;
-import engine.objects.Zone;
-import org.pmw.tinylog.Logger;
-
-import java.util.HashMap;
-
-import static java.lang.Math.PI;
-
-public class Terrain {
-    public static final HashMap<Integer, short[][]> _heightmap_pixel_cache = new HashMap<>();
-    public short[][] terrain_pixel_data;
-    public Vector2f terrain_size = new Vector2f();
-    public Vector2f cell_size = new Vector2f();
-    public Vector2f cell_count = new Vector2f();
-    public float terrain_scale;
-    public Vector2f blend_values = new Vector2f();
-    public Vector2f blend_ratio = new Vector2f();
-    public int heightmap;
-    Zone zone;
-
-    public Terrain(Zone zone) {
-
-        this.zone = zone;
-        this.heightmap = this.zone.template.terrain_image;
-
-        // Configure PLANAR zones to use the same 16x16 pixel image
-        // that all similar terrains share.  (See JSON)
-
-        if (this.zone.template.terrain_type.equals("PLANAR"))
-            this.heightmap = 1006300;  // all 0
-
-        // Load pixel data for this terrain from cache
-
-        this.terrain_pixel_data = Terrain._heightmap_pixel_cache.get(heightmap);
-
-        if (terrain_pixel_data == null)
-            Logger.error("Pixel map empty for zone: " + this.zone.getObjectUUID() + ":" + this.zone.zoneName);
-
-        // Configure terrain based on zone properties
-
-        this.terrain_size.x = this.zone.major_radius * 2;
-        this.terrain_size.y = this.zone.minor_radius * 2;
-
-        this.cell_count.x = this.terrain_pixel_data.length - 1;
-        this.cell_count.y = this.terrain_pixel_data[0].length - 1;
-
-        this.cell_size.x = terrain_size.x / this.cell_count.x;
-        this.cell_size.y = terrain_size.y / this.cell_count.y;
-
-        // Blending configuration. These ratios are used to calculate
-        // the blending area between child and parent terrains when
-        // they are stitched together.
-
-        this.blend_values.x = this.zone.template.max_blend;
-        this.blend_values.y = this.zone.template.min_blend;
-
-        Vector2f major_blend = new Vector2f(this.blend_values.x / this.zone.major_radius,
-                this.blend_values.y / this.zone.major_radius);
-
-        Vector2f minor_blend = new Vector2f(this.blend_values.x / this.zone.minor_radius,
-                this.blend_values.y / this.zone.minor_radius);
-
-        if (major_blend.y > 0.4f)
-            blend_ratio.x = major_blend.y;
-        else
-            blend_ratio.x = Math.min(major_blend.x, 0.4f);
-
-        if (minor_blend.y > 0.4f)
-            blend_ratio.y = minor_blend.y;
-        else
-            blend_ratio.y = Math.min(minor_blend.x, 0.4f);
-
-        // Scale coefficient for this terrain
-
-        this.terrain_scale = this.zone.template.terrain_max_y / 255f;
-    }
-
-    public static Zone getNextZoneWithTerrain(Zone zone) {
-
-        // Not all zones have a terrain.  Some are for display only
-        // and heights returned are from the parent heightmap.  This
-        // is controlled in the JSON via the has_terrain_gen field.
-
-        Zone terrain_zone = zone;
-
-        if (zone == null)
-            return ZoneManager.seaFloor;
-
-        if (zone.terrain != null)
-            return zone;
-
-        if (zone.equals(ZoneManager.seaFloor))
-            return zone;
-
-        while (terrain_zone.terrain == null)
-            terrain_zone = terrain_zone.parent;
-
-        return terrain_zone;
-    }
-
-    public static float getWorldHeight(Zone zone, Vector3fImmutable world_loc) {
-
-        // Retrieve the next zone with a terrain defined.
-
-        Zone terrainZone = getNextZoneWithTerrain(zone);
-        Zone parentZone = getNextZoneWithTerrain(zone.parent);
-
-        // Transform world loc into zone space coordinate system
-
-        Vector2f terrainLoc = ZoneManager.worldToTerrainSpace(world_loc, terrainZone);
-        Vector2f parentLoc = ZoneManager.worldToTerrainSpace(world_loc, parentZone);
-
-        // Offset from origin needed for blending function
-
-        Vector2f terrainOffset = ZoneManager.worldToZoneOffset(world_loc, terrainZone);
-
-        // Interpolate height for this position in both terrains
-
-        float interpolatedChildHeight = terrainZone.terrain.getInterpolatedTerrainHeight(terrainLoc);
-        interpolatedChildHeight += terrainZone.global_height;
-
-        float interpolatedParentTerrainHeight = parentZone.terrain.getInterpolatedTerrainHeight(parentLoc);
-        interpolatedParentTerrainHeight += parentZone.global_height;
-
-        // Blend between terrains
-
-        float blendCoefficient = terrainZone.terrain.getTerrainBlendCoefficient(terrainOffset);
-
-        float terrainHeight = interpolatedChildHeight * blendCoefficient;
-        terrainHeight += interpolatedParentTerrainHeight * (1 - blendCoefficient);
-
-        return terrainHeight;
-
-    }
-
-    public static float getWorldHeight(Vector3fImmutable world_loc) {
-
-        Zone currentZone = ZoneManager.findSmallestZone(world_loc);
-
-        return getWorldHeight(currentZone, world_loc);
-
-    }
-
-    public Vector2f getTerrainCell(Vector2f terrain_loc) {
-
-        // Calculate terrain cell with offset
-
-        Vector2f terrain_cell = new Vector2f(terrain_loc.x / this.cell_size.x, terrain_loc.y / this.cell_size.y);
-
-        // Clamp values when standing directly on pole
-
-        terrain_cell.x = Math.max(0, Math.min(this.cell_count.x - 1, terrain_cell.x));
-        terrain_cell.y = Math.max(0, Math.min(this.cell_count.y - 1, terrain_cell.y));
-
-        return terrain_cell;
-    }
-
-    public float getInterpolatedTerrainHeight(Vector2f terrain_loc) {
-
-        float interpolatedHeight;
-
-        // Early exit for guild zones
-
-        if (this.zone.guild_zone)
-            return 5.0f;
-
-        // Determine terrain and offset from top left vertex
-
-        Vector2f terrain_cell = getTerrainCell(terrain_loc);
-
-        int pixel_x = (int) Math.floor(terrain_cell.x);
-        int pixel_y = (int) Math.floor(terrain_cell.y);
-
-        Vector2f pixel_offset = new Vector2f(terrain_cell.x % 1, terrain_cell.y % 1);
-
-        // 4 surrounding vertices from the pixel array.
-
-        short top_left_pixel = terrain_pixel_data[pixel_x][pixel_y];
-        short top_right_pixel = terrain_pixel_data[pixel_x + 1][pixel_y];
-        short bottom_left_pixel = terrain_pixel_data[pixel_x][pixel_y + 1];
-        short bottom_right_pixel = terrain_pixel_data[pixel_x + 1][pixel_y + 1];
-
-        // Interpolate between the 4 vertices
-
-        interpolatedHeight = top_left_pixel * (1 - pixel_offset.x) * (1 - pixel_offset.y);
-        interpolatedHeight += top_right_pixel * (1 - pixel_offset.y) * (pixel_offset.x);
-        interpolatedHeight += (bottom_left_pixel * (1 - pixel_offset.x) * pixel_offset.y);
-        interpolatedHeight += (bottom_right_pixel * pixel_offset.y * pixel_offset.x);
-
-        interpolatedHeight *= this.terrain_scale; // Scale height
-
-        return interpolatedHeight;
-
-    }
-
-    public float getTerrainBlendCoefficient(Vector2f zone_offset) {
-
-        // Normalize terrain offset
-
-        Vector2f normalizedOffset = new Vector2f(Math.abs(zone_offset.x) / this.zone.template.major_radius,
-                Math.abs(zone_offset.y) / this.zone.template.minor_radius);
-
-        float blendCoefficient;
-
-        if (normalizedOffset.x <= 1 - blend_ratio.x || normalizedOffset.x <= normalizedOffset.y) {
-
-            if (normalizedOffset.y < 1 - blend_ratio.y)
-                return 1;
-
-            blendCoefficient = (normalizedOffset.y - (1 - blend_ratio.y)) / blend_ratio.y;
-        } else
-            blendCoefficient = (normalizedOffset.x - (1 - blend_ratio.x)) / blend_ratio.x;
-
-        blendCoefficient = (float) Math.atan((0.5f - blendCoefficient) * PI);
-
-        return (blendCoefficient + 1) * 0.5f;
-    }
-}

src/engine/db/archive/CityRecord.java

@@ -67,7 +67,7 @@ public class CityRecord extends DataRecord {
         cityRecord.locX = cityRecord.city.getTOL().getLoc().x;
         cityRecord.locY = -cityRecord.city.getTOL().getLoc().z; // flip sign on 'y' coordinate
 
-        cityRecord.zoneHash = cityRecord.city.getParent().hash;
+        cityRecord.zoneHash = cityRecord.city.getParent().getHash();
 
         if (cityRecord.eventType.equals(Enum.RecordEventType.CREATE))
             cityRecord.establishedDatetime = cityRecord.city.established;

src/engine/db/archive/GuildRecord.java

@@ -89,7 +89,7 @@ public class GuildRecord extends DataRecord {
         guildRecord.guildHash = guildRecord.guild.getHash();
         guildRecord.guildID = guildRecord.guild.getObjectUUID();
         guildRecord.guildName = guildRecord.guild.getName();
-        guildRecord.charterName = Enum.GuildCharterType.getGuildTypeFromInt(guildRecord.guild.getCharter()).getCharterName();
+        guildRecord.charterName = Enum.GuildType.getGuildTypeFromInt(guildRecord.guild.getCharter()).getCharterName();
 
         guildRecord.GLHash = DataWarehouse.hasher.encrypt(guildRecord.guild.getGuildLeaderUUID());
 

src/engine/db/archive/MineRecord.java

@@ -52,7 +52,7 @@ public class MineRecord extends DataRecord {
             mineRecord.eventType = eventType;
         }
 
-        mineRecord.zoneHash = mine.getParentZone().hash;
+        mineRecord.zoneHash = mine.getParentZone().getHash();
 
         if (character.getObjectType().equals(Enum.GameObjectType.PlayerCharacter)) {
             player = (PlayerCharacter) character;

src/engine/db/archive/PvpRecord.java

@@ -281,7 +281,7 @@ public class PvpRecord extends DataRecord {
         outStatement.setInt(8, this.victim.getLevel());
 
         outStatement.setString(9, DataWarehouse.hasher.encrypt(zone.getObjectUUID()));
-        outStatement.setString(10, zone.zoneName);
+        outStatement.setString(10, zone.getName());
         outStatement.setFloat(11, this.location.getX());
         outStatement.setFloat(12, -this.location.getZ()); // flip sign on 'y' coordinate
         outStatement.setBoolean(13, this.pvpExp);

src/engine/db/handlers/dbBoonHandler.java

@@ -0,0 +1,51 @@
+// • ▌ ▄ ·.  ▄▄▄·  ▄▄ • ▪   ▄▄· ▄▄▄▄·  ▄▄▄·  ▐▄▄▄  ▄▄▄ .
+// ·██ ▐███▪▐█ ▀█ ▐█ ▀ ▪██ ▐█ ▌▪▐█ ▀█▪▐█ ▀█ •█▌ ▐█▐▌·
+// ▐█ ▌▐▌▐█·▄█▀▀█ ▄█ ▀█▄▐█·██ ▄▄▐█▀▀█▄▄█▀▀█ ▐█▐ ▐▌▐▀▀▀
+// ██ ██▌▐█▌▐█ ▪▐▌▐█▄▪▐█▐█▌▐███▌██▄▪▐█▐█ ▪▐▌██▐ █▌▐█▄▄▌
+// ▀▀  █▪▀▀▀ ▀  ▀ ·▀▀▀▀ ▀▀▀·▀▀▀ ·▀▀▀▀  ▀  ▀ ▀▀  █▪ ▀▀▀
+//      Magicbane Emulator Project © 2013 - 2022
+//                www.magicbane.com
+
+
+package engine.db.handlers;
+
+import engine.gameManager.DbManager;
+import engine.objects.Boon;
+import org.pmw.tinylog.Logger;
+
+import java.sql.Connection;
+import java.sql.PreparedStatement;
+import java.sql.ResultSet;
+import java.sql.SQLException;
+import java.util.ArrayList;
+
+public class dbBoonHandler extends dbHandlerBase {
+
+    public dbBoonHandler() {
+    }
+
+
+    public ArrayList<Boon> GET_BOON_AMOUNTS_FOR_ITEMBASE(int itemBaseUUID) {
+
+        ArrayList<Boon> boons = new ArrayList<>();
+        Boon thisBoon;
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM `static_item_boons`  WHERE `itemBaseID` = ?")) {
+
+            preparedStatement.setInt(1, itemBaseUUID);
+
+            ResultSet rs = preparedStatement.executeQuery();
+
+            while (rs.next()) {
+                thisBoon = new Boon(rs);
+                boons.add(thisBoon);
+            }
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+
+        return boons;
+    }
+}

src/engine/db/handlers/dbBuildingHandler.java

@@ -13,7 +13,6 @@ import engine.Enum;
 import engine.Enum.DbObjectType;
 import engine.Enum.ProtectionState;
 import engine.Enum.TaxType;
-import engine.gameManager.BuildingManager;
 import engine.gameManager.DbManager;
 import engine.math.Vector3fImmutable;
 import engine.objects.*;
@@ -28,7 +27,6 @@ import java.time.LocalDateTime;
 import java.time.ZoneId;
 import java.util.ArrayList;
 import java.util.HashMap;
-import java.util.concurrent.ConcurrentHashMap;
 
 public class dbBuildingHandler extends dbHandlerBase {
 
@@ -90,12 +88,14 @@ public class dbBuildingHandler extends dbHandlerBase {
         return removeFromBuildings(b);
     }
 
-    public ArrayList<Building> GET_ALL_BUILDINGS() {
+    public ArrayList<Building> GET_ALL_BUILDINGS_FOR_ZONE(Zone zone) {
 
         ArrayList<Building> buildings = new ArrayList<>();
 
         try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("SELECT `obj_building`.*, `object`.`parent` FROM `object` INNER JOIN `obj_building` ON `obj_building`.`UID` = `object`.`UID` ORDER BY  `object`.`UID` ASC;")) {
+             PreparedStatement preparedStatement = connection.prepareStatement("SELECT `obj_building`.*, `object`.`parent` FROM `object` INNER JOIN `obj_building` ON `obj_building`.`UID` = `object`.`UID` WHERE `object`.`parent` = ?;")) {
+
+            preparedStatement.setLong(1, zone.getObjectUUID());
 
             ResultSet rs = preparedStatement.executeQuery();
             buildings = getObjectsFromRs(rs, 1000);
@@ -425,28 +425,26 @@ public class dbBuildingHandler extends dbHandlerBase {
         return false;
     }
 
-    public void LOAD_BUILDING_FRIENDS() {
+    public void LOAD_ALL_FRIENDS_FOR_BUILDING(Building building) {
+
+        if (building == null)
+            return;
 
         try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM `dyn_building_friends`")) {
+             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM `dyn_building_friends` WHERE `buildingUID` = ?")) {
 
+            preparedStatement.setInt(1, building.getObjectUUID());
             ResultSet rs = preparedStatement.executeQuery();
 
             while (rs.next()) {
                 BuildingFriends friend = new BuildingFriends(rs);
-
-                // Create map if it does not yet exist
-
-                if (!BuildingManager._buildingFriends.containsKey(friend.buildingUID))
-                    BuildingManager._buildingFriends.put(friend.buildingUID, new ConcurrentHashMap<>());
-
-                switch (friend.friendType) {
+                switch (friend.getFriendType()) {
                     case 7:
-                        BuildingManager._buildingFriends.get(friend.buildingUID).put(friend.playerUID, friend);
+                        building.getFriends().put(friend.getPlayerUID(), friend);
                         break;
                     case 8:
                     case 9:
-                        BuildingManager._buildingFriends.get(friend.buildingUID).put(friend.guildUID, friend);
+                        building.getFriends().put(friend.getGuildUID(), friend);
                         break;
                 }
             }
@@ -457,29 +455,26 @@ public class dbBuildingHandler extends dbHandlerBase {
 
     }
 
-    public void LOAD_BUILDING_CONDEMNED() {
+    public void LOAD_ALL_CONDEMNED_FOR_BUILDING(Building building) {
+
+        if (building == null)
+            return;
 
         try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM `dyn_building_condemned`")) {
+             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM `dyn_building_condemned` WHERE `buildingUID` = ?")) {
 
+            preparedStatement.setInt(1, building.getObjectUUID());
             ResultSet rs = preparedStatement.executeQuery();
 
             while (rs.next()) {
-
                 Condemned condemned = new Condemned(rs);
-
-                // Create map if it does not yet exist
-
-                if (!BuildingManager._buildingCondemned.containsKey(condemned.buildingUUID))
-                    BuildingManager._buildingCondemned.put(condemned.buildingUUID, new ConcurrentHashMap<>());
-
-                switch (condemned.friendType) {
+                switch (condemned.getFriendType()) {
                     case 2:
-                        BuildingManager._buildingCondemned.get(condemned.buildingUUID).put(condemned.playerUID, condemned);
+                        building.getCondemned().put(condemned.getPlayerUID(), condemned);
                         break;
                     case 4:
                     case 5:
-                        BuildingManager._buildingCondemned.get(condemned.buildingUUID).put(condemned.guildUID, condemned);
+                        building.getCondemned().put(condemned.getGuildUID(), condemned);
                         break;
                 }
             }
@@ -489,27 +484,35 @@ public class dbBuildingHandler extends dbHandlerBase {
         }
     }
 
-    public void LOAD_BARRACKS_PATROL_POINTS() {
+    public ArrayList<Vector3fImmutable> LOAD_PATROL_POINTS(Building building) {
 
-        try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM `dyn_building_patrol_points`")) {
+        if (building == null)
+            return null;
 
-            ResultSet rs = preparedStatement.executeQuery();
+        ArrayList<Vector3fImmutable> patrolPoints = new ArrayList<>();
 
-            while (rs.next()) {
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM `dyn_building_patrol_points` WHERE `buildingUID` = ?")) {
 
-                int buildingUUID = rs.getInt("buildingUID");
+            preparedStatement.setInt(1, building.getObjectUUID());
 
-                if (!BuildingManager._buildingPatrolPoints.containsKey(buildingUUID))
-                    BuildingManager._buildingPatrolPoints.put(buildingUUID, new ArrayList<>());
 
-                Vector3fImmutable patrolPoint = new Vector3fImmutable(rs.getFloat("patrolX"), rs.getFloat("patrolY"), rs.getFloat("patrolZ"));
-                BuildingManager._buildingPatrolPoints.get(buildingUUID).add(patrolPoint);
+            ResultSet rs = preparedStatement.executeQuery();
+
+            while (rs.next()) {
+                float x1 = rs.getFloat("patrolX");
+                float y1 = rs.getFloat("patrolY");
+                float z1 = rs.getFloat("patrolZ");
+                Vector3fImmutable patrolPoint = new Vector3fImmutable(x1, y1, z1);
+                patrolPoints.add(patrolPoint);
             }
 
         } catch (SQLException e) {
             Logger.error(e);
         }
+
+        return patrolPoints;
+
     }
 
     public boolean ADD_TO_CONDEMNLIST(final long parentUID, final long playerUID, final long guildID, final int friendType) {
@@ -719,10 +722,10 @@ public class dbBuildingHandler extends dbHandlerBase {
                      + "WHERE`buildingUID` = ? AND `playerUID` = ? AND `guildUID` = ? AND `friendType` = ?")) {
 
             preparedStatement.setBoolean(1, active);
-            preparedStatement.setInt(2, condemn.buildingUUID);
-            preparedStatement.setInt(3, condemn.playerUID);
-            preparedStatement.setInt(4, condemn.guildUID);
-            preparedStatement.setInt(5, condemn.friendType);
+            preparedStatement.setInt(2, condemn.getParent());
+            preparedStatement.setInt(3, condemn.getPlayerUID());
+            preparedStatement.setInt(4, condemn.getGuildUID());
+            preparedStatement.setInt(5, condemn.getFriendType());
 
             return (preparedStatement.executeUpdate() > 0);
 

src/engine/db/handlers/dbCityHandler.java

@@ -34,19 +34,16 @@ public class dbCityHandler extends dbHandlerBase {
             case "zone":
                 Zone zone = new Zone(rs);
                 DbManager.addToCache(zone);
-                zone.runAfterLoad();
                 list.add(zone);
                 break;
             case "building":
                 Building building = new Building(rs);
                 DbManager.addToCache(building);
-                building.runAfterLoad();
                 list.add(building);
                 break;
             case "city":
                 City city = new City(rs);
                 DbManager.addToCache(city);
-                city.runAfterLoad();
                 list.add(city);
                 break;
         }
@@ -99,12 +96,14 @@ public class dbCityHandler extends dbHandlerBase {
         return objectList;
     }
 
-    public ArrayList<City> GET_ALL_CITIES() {
+    public ArrayList<City> GET_CITIES_BY_ZONE(final int objectUUID) {
 
         ArrayList<City> cityList = new ArrayList<>();
 
         try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("SELECT `obj_city`.*, `object`.`parent` FROM `obj_city` INNER JOIN `object` ON `object`.`UID` = `obj_city`.`UID` ORDER BY `object`.`UID` ASC;")) {
+             PreparedStatement preparedStatement = connection.prepareStatement("SELECT `obj_city`.*, `object`.`parent` FROM `obj_city` INNER JOIN `object` ON `object`.`UID` = `obj_city`.`UID` WHERE `object`.`parent`=?;")) {
+
+            preparedStatement.setLong(1, objectUUID);
 
             ResultSet rs = preparedStatement.executeQuery();
             cityList = getObjectsFromRs(rs, 100);

src/engine/db/handlers/dbContractHandler.java

@@ -12,7 +12,7 @@ package engine.db.handlers;
 import engine.Enum;
 import engine.gameManager.DbManager;
 import engine.objects.Contract;
-import engine.objects.ItemTemplate;
+import engine.objects.ItemBase;
 import engine.objects.MobEquipment;
 import org.pmw.tinylog.Logger;
 
@@ -63,29 +63,33 @@ public class dbContractHandler extends dbHandlerBase {
 
             while (rs.next()) {
 
-                int templateID = rs.getInt("itembaseID");
+                //handle item base
+                int itemBaseID = rs.getInt("itembaseID");
 
-                MobEquipment me = new MobEquipment(ItemTemplate.templates.get(templateID), Enum.EquipSlotType.NONE, 0);
-                contract.getSellInventory().add(me);
+                ItemBase ib = ItemBase.getItemBase(itemBaseID);
 
-                //handle magic effects
+                if (ib != null) {
 
-                String prefix = rs.getString("prefix");
-                int pRank = rs.getInt("pRank");
+                    MobEquipment me = new MobEquipment(ib, 0, 0);
+                    contract.getSellInventory().add(me);
 
-                String suffix = rs.getString("suffix");
-                int sRank = rs.getInt("sRank");
+                    //handle magic effects
+                    String prefix = rs.getString("prefix");
+                    int pRank = rs.getInt("pRank");
+                    String suffix = rs.getString("suffix");
+                    int sRank = rs.getInt("sRank");
 
-                if (prefix != null) {
-                    me.setPrefix(prefix, pRank);
-                    me.setIsID(true);
-                }
+                    if (prefix != null) {
+                        me.setPrefix(prefix, pRank);
+                        me.setIsID(true);
+                    }
 
-                if (suffix != null) {
-                    me.setSuffix(suffix, sRank);
-                    me.setIsID(true);
-                }
+                    if (suffix != null) {
+                        me.setSuffix(suffix, sRank);
+                        me.setIsID(true);
+                    }
 
+                }
             }
         } catch (SQLException e) {
             Logger.error(e);

src/engine/db/handlers/dbGuildHandler.java

@@ -695,4 +695,24 @@ public class dbGuildHandler extends dbHandlerBase {
         }
     }
 
+    //TODO uncomment this when finished with guild history warehouse integration
+//	public HashMap<Integer, GuildRecord> GET_WAREHOUSE_GUILD_HISTORY(){
+//		
+//		HashMap<Integer, GuildRecord> tempMap = new HashMap<>();
+//		prepareCallable("SELECT * FROM `warehouse_guildhistory` WHERE `eventType` = 'CREATE'");
+//		try {
+//			ResultSet rs = executeQuery();
+//			
+//			while (rs.next()) {
+//				GuildRecord guildRecord = new GuildRecord(rs);
+//				tempMap.put(guildRecord.guildID, guildRecord);
+//			}
+//		}catch (Exception e){
+//			Logger.error(e);
+//		}
+//		return tempMap;
+//		
+//	}
+
+
 }

src/engine/db/handlers/dbHeightMapHandler.java

@@ -0,0 +1,43 @@
+package engine.db.handlers;
+
+import engine.InterestManagement.HeightMap;
+import engine.gameManager.DbManager;
+import org.pmw.tinylog.Logger;
+
+import java.sql.Connection;
+import java.sql.PreparedStatement;
+import java.sql.ResultSet;
+import java.sql.SQLException;
+
+public class dbHeightMapHandler extends dbHandlerBase {
+
+    public dbHeightMapHandler() {
+
+
+    }
+
+    public void LOAD_ALL_HEIGHTMAPS() {
+
+        HeightMap thisHeightmap;
+        HeightMap.heightMapsCreated = 0;
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM static_zone_heightmap INNER JOIN static_zone_size ON static_zone_size.loadNum = static_zone_heightmap.zoneLoadID")) {
+
+            ResultSet rs = preparedStatement.executeQuery();
+
+            while (rs.next()) {
+                thisHeightmap = new HeightMap(rs);
+
+                if (thisHeightmap.getHeightmapImage() == null) {
+                    Logger.info("Imagemap for " + thisHeightmap.getHeightMapID() + " was null");
+                    continue;
+                }
+            }
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+    }
+
+}

src/engine/db/handlers/dbItemBaseHandler.java

@@ -17,6 +17,8 @@ import java.sql.Connection;
 import java.sql.PreparedStatement;
 import java.sql.ResultSet;
 import java.sql.SQLException;
+import java.util.ArrayList;
+import java.util.HashMap;
 
 public class dbItemBaseHandler extends dbHandlerBase {
 
@@ -24,6 +26,53 @@ public class dbItemBaseHandler extends dbHandlerBase {
 
     }
 
+    public void LOAD_BAKEDINSTATS(ItemBase itemBase) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM `static_item_bakedinstat` WHERE `itemID` = ?")) {
+
+            preparedStatement.setInt(1, itemBase.getUUID());
+            ResultSet rs = preparedStatement.executeQuery();
+
+            while (rs.next()) {
+                if (rs.getBoolean("fromUse"))
+                    itemBase.getUsedStats().put(rs.getInt("token"), rs.getInt("numTrains"));
+                else
+                    itemBase.getBakedInStats().put(rs.getInt("token"), rs.getInt("numTrains"));
+            }
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+    }
+
+    public void LOAD_ANIMATIONS(ItemBase itemBase) {
+
+        ArrayList<Integer> tempList = new ArrayList<>();
+        ArrayList<Integer> tempListOff = new ArrayList<>();
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM `static_itembase_animations` WHERE `itemBaseUUID` = ?")) {
+
+            preparedStatement.setInt(1, itemBase.getUUID());
+            ResultSet rs = preparedStatement.executeQuery();
+
+            while (rs.next()) {
+                int animation = rs.getInt("animation");
+                boolean rightHand = rs.getBoolean("rightHand");
+
+                if (rightHand)
+                    tempList.add(animation);
+                else
+                    tempListOff.add(animation);
+            }
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+
+        itemBase.setAnimations(tempList);
+        itemBase.setOffHandAnimations(tempListOff);
+    }
+
     public void LOAD_ALL_ITEMBASES() {
 
         ItemBase itemBase;
@@ -37,7 +86,6 @@ public class dbItemBaseHandler extends dbHandlerBase {
             while (rs.next()) {
                 recordsRead++;
                 itemBase = new ItemBase(rs);
-
                 ItemBase.addToCache(itemBase);
             }
 
@@ -48,4 +96,43 @@ public class dbItemBaseHandler extends dbHandlerBase {
         Logger.info("read: " + recordsRead + " cached: " + ItemBase.getUUIDCache().size());
     }
 
+    public HashMap<Integer, ArrayList<Integer>> LOAD_RUNES_FOR_NPC_AND_MOBS() {
+
+        HashMap<Integer, ArrayList<Integer>> runeSets = new HashMap<>();
+        int runeSetID;
+        int runeBaseID;
+        int recordsRead = 0;
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM static_npc_runeSet")) {
+
+            ResultSet rs = preparedStatement.executeQuery();
+
+            while (rs.next()) {
+
+                recordsRead++;
+
+                runeSetID = rs.getInt("runeSet");
+                runeBaseID = rs.getInt("runeBase");
+
+                if (runeSets.get(runeSetID) == null) {
+                    ArrayList<Integer> runeList = new ArrayList<>();
+                    runeList.add(runeBaseID);
+                    runeSets.put(runeSetID, runeList);
+                } else {
+                    ArrayList<Integer> runeList = runeSets.get(runeSetID);
+                    runeList.add(runeSetID);
+                    runeSets.put(runeSetID, runeList);
+                }
+            }
+
+        } catch (SQLException e) {
+            Logger.error(e);
+            return runeSets;
+        }
+
+        Logger.info("read: " + recordsRead + " cached: " + runeSets.size());
+        return runeSets;
+    }
+
 }

src/engine/db/handlers/dbItemHandler.java

@@ -15,9 +15,6 @@ import engine.gameManager.DbManager;
 import engine.objects.AbstractCharacter;
 import engine.objects.CharacterItemManager;
 import engine.objects.Item;
-import engine.objects.ItemTemplate;
-import org.json.simple.JSONObject;
-import org.json.simple.parser.JSONParser;
 import org.pmw.tinylog.Logger;
 
 import java.sql.Connection;
@@ -55,16 +52,16 @@ public class dbItemHandler extends dbHandlerBase {
         return ret;
     }
 
-    public Item PERSIST(Item toAdd) {
+    public Item ADD_ITEM(Item toAdd) {
 
         try (Connection connection = DbManager.getConnection();
              PreparedStatement preparedStatement = connection.prepareStatement("CALL `item_CREATE`(?, ?, ?, ?, ?, ?, ?, ?, ?,?);")) {
 
-            preparedStatement.setInt(1, toAdd.ownerID);
-            preparedStatement.setInt(2, toAdd.getTemplateID());
-            preparedStatement.setInt(3, (byte) toAdd.chargesRemaining);
-            preparedStatement.setInt(4, (short) toAdd.durabilityCurrent);
-            preparedStatement.setInt(5, (int) toAdd.template.item_health_full);
+            preparedStatement.setInt(1, toAdd.getOwnerID());
+            preparedStatement.setInt(2, toAdd.getItemBaseID());
+            preparedStatement.setInt(3, toAdd.getChargesRemaining());
+            preparedStatement.setInt(4, toAdd.getDurabilityCurrent());
+            preparedStatement.setInt(5, toAdd.getDurabilityMax());
 
             if (toAdd.getNumOfItems() < 1)
                 preparedStatement.setInt(6, 1);
@@ -92,9 +89,9 @@ public class dbItemHandler extends dbHandlerBase {
                     break;
             }
 
-            preparedStatement.setByte(8, (byte) toAdd.equipSlot.ordinal());
+            preparedStatement.setByte(8, toAdd.getEquipSlot());
             preparedStatement.setInt(9, toAdd.getFlags());
-            preparedStatement.setString(10, toAdd.name);
+            preparedStatement.setString(10, toAdd.getCustomName());
 
             ResultSet rs = preparedStatement.executeQuery();
 
@@ -166,28 +163,6 @@ public class dbItemHandler extends dbHandlerBase {
         return itemList;
     }
 
-    public void LOAD_ITEM_TEMPLATES() {
-
-        JSONParser jsonParser = new JSONParser();
-
-        try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM `static_item_templates`;");
-             ResultSet rs = preparedStatement.executeQuery()) {
-
-            while (rs.next()) {
-                int templateID = rs.getInt("id");
-                JSONObject jsonObject = (JSONObject) jsonParser.parse(rs.getString("template"));
-                ItemTemplate itemTemplate = new ItemTemplate(jsonObject);
-                itemTemplate.template_id = templateID;
-                ItemTemplate.templates.put(templateID, itemTemplate);
-            }
-
-        } catch (Exception e) {
-            Logger.error(e);
-        }
-
-    }
-
     public Item GET_ITEM(final int itemUUID) {
 
         Item item;
@@ -293,7 +268,7 @@ public class dbItemHandler extends dbHandlerBase {
 
         for (Item item : inventory) {
 
-            if (item.template.item_type.equals(ItemType.GOLD))
+            if (item.getItemBase().getType().equals(ItemType.GOLD))
                 continue;
 
             try (Connection connection = DbManager.getConnection();
@@ -391,7 +366,7 @@ public class dbItemHandler extends dbHandlerBase {
 
             preparedStatement.setInt(1, value);
             preparedStatement.setLong(2, item.getObjectUUID());
-            preparedStatement.setInt(3, (short) item.durabilityCurrent);
+            preparedStatement.setInt(3, item.getDurabilityCurrent());
 
             return (preparedStatement.executeUpdate() > 0);
 
@@ -437,7 +412,7 @@ public class dbItemHandler extends dbHandlerBase {
      */
     public boolean UPDATE_GOLD(final Item item, int newValue, int oldValue) {
 
-        if (!item.template.item_type.equals(ItemType.GOLD))
+        if (!item.getItemBase().getType().equals(ItemType.GOLD))
             return false;
 
         try (Connection connection = DbManager.getConnection();
@@ -460,7 +435,7 @@ public class dbItemHandler extends dbHandlerBase {
         try (Connection connection = DbManager.getConnection();
              PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_item` SET `item_chargesRemaining` = ? WHERE `UID` = ?")) {
 
-            preparedStatement.setInt(1, (byte) item.chargesRemaining);
+            preparedStatement.setInt(1, item.getChargesRemaining());
             preparedStatement.setLong(2, item.getObjectUUID());
 
             return (preparedStatement.executeUpdate() > 0);

src/engine/db/handlers/dbMineHandler.java

@@ -12,6 +12,7 @@ import engine.Enum;
 import engine.gameManager.DbManager;
 import engine.objects.Mine;
 import engine.objects.MineProduction;
+import engine.objects.Resource;
 import org.pmw.tinylog.Logger;
 
 import java.sql.Connection;
@@ -83,7 +84,7 @@ public class dbMineHandler extends dbHandlerBase {
         return false;
     }
 
-    public boolean CHANGE_RESOURCE(Mine mine, Enum.ResourceType resource) {
+    public boolean CHANGE_RESOURCE(Mine mine, Resource resource) {
 
         try (Connection connection = DbManager.getConnection();
              PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_mine` SET `mine_resource`=? WHERE `UID`=?")) {

src/engine/db/handlers/dbMobHandler.java

@@ -11,6 +11,7 @@ package engine.db.handlers;
 
 import engine.gameManager.DbManager;
 import engine.objects.Mob;
+import engine.objects.Zone;
 import org.joda.time.DateTime;
 import org.pmw.tinylog.Logger;
 
@@ -27,27 +28,31 @@ public class dbMobHandler extends dbHandlerBase {
         this.localObjectType = engine.Enum.GameObjectType.valueOf(this.localClass.getSimpleName());
     }
 
-    public Mob PERSIST(Mob toAdd) {
+    public Mob ADD_MOB(Mob toAdd) {
 
         Mob mobile = null;
 
         try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("CALL `mob_CREATE`(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?);")) {
-
-            preparedStatement.setLong(1, toAdd.parentZoneUUID);
-            preparedStatement.setInt(2, toAdd.loadID);
-            preparedStatement.setInt(3, toAdd.guildUUID);
-            preparedStatement.setFloat(4, toAdd.bindLoc.x);
-            preparedStatement.setFloat(5, toAdd.bindLoc.y);
-            preparedStatement.setFloat(6, toAdd.bindLoc.z);
+             PreparedStatement preparedStatement = connection.prepareStatement("CALL `mob_CREATE`(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?);")) {
+
+            preparedStatement.setLong(1, toAdd.getParentZoneID());
+            preparedStatement.setInt(2, toAdd.getMobBaseID());
+            preparedStatement.setInt(3, toAdd.getGuildUUID());
+            preparedStatement.setFloat(4, toAdd.getSpawnX());
+            preparedStatement.setFloat(5, toAdd.getSpawnY());
+            preparedStatement.setFloat(6, toAdd.getSpawnZ());
             preparedStatement.setInt(7, 0);
-            preparedStatement.setFloat(8, toAdd.spawnRadius);
-            preparedStatement.setInt(9, toAdd.spawnDelay);
-            preparedStatement.setInt(10, toAdd.contractUUID);
-            preparedStatement.setInt(11, toAdd.buildingUUID);
-            preparedStatement.setInt(12, toAdd.level);
-            preparedStatement.setString(13, toAdd.firstName);
-            preparedStatement.setString(14, toAdd.behaviourType.toString());
+            preparedStatement.setFloat(8, toAdd.getSpawnRadius());
+            preparedStatement.setInt(9, toAdd.getTrueSpawnTime());
+
+            if (toAdd.getContract() != null)
+                preparedStatement.setInt(10, toAdd.getContract().getContractID());
+            else
+                preparedStatement.setInt(10, 0);
+
+            preparedStatement.setInt(11, toAdd.getBuildingID());
+            preparedStatement.setInt(12, toAdd.getLevel());
+            preparedStatement.setString(13, toAdd.getFirstName());
 
             ResultSet rs = preparedStatement.executeQuery();
 
@@ -64,23 +69,6 @@ public class dbMobHandler extends dbHandlerBase {
         return mobile;
     }
 
-    public ArrayList<Mob> GET_ALL_MOBS() {
-
-        ArrayList<Mob> mobileList = new ArrayList<>();
-
-        try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("SELECT `obj_mob`.*, `object`.`parent` FROM `object` INNER JOIN `obj_mob` ON `obj_mob`.`UID` = `object`.`UID` ORDER BY `object`.`UID` ASC;")) {
-
-            ResultSet rs = preparedStatement.executeQuery();
-            mobileList = getObjectsFromRs(rs, 1000);
-
-        } catch (SQLException e) {
-            Logger.error(e);
-        }
-
-        return mobileList;
-    }
-
     public boolean updateUpgradeTime(Mob mob, DateTime upgradeDateTime) {
 
         try (Connection connection = DbManager.getConnection();
@@ -118,17 +106,17 @@ public class dbMobHandler extends dbHandlerBase {
         return row_count;
     }
 
-    public void LOAD_GUARD_MINIONS(Mob guardCaptain) {
+    public void LOAD_PATROL_POINTS(Mob captain) {
 
         try (Connection connection = DbManager.getConnection();
              PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM `dyn_guards` WHERE `captainUID` = ?")) {
 
-            preparedStatement.setInt(1, guardCaptain.getObjectUUID());
+            preparedStatement.setInt(1, captain.getObjectUUID());
             ResultSet rs = preparedStatement.executeQuery();
 
             while (rs.next()) {
-                String minionName = rs.getString("minionName");
-                Mob toCreate = Mob.createGuardMinion(guardCaptain, guardCaptain.getLevel(), minionName);
+                String name = rs.getString("name");
+                Mob toCreate = Mob.createGuardMob(captain, captain.getGuild(), captain.getParentZone(), captain.building.getLoc(), captain.getLevel(), name);
 
                 if (toCreate == null)
                     return;
@@ -143,13 +131,15 @@ public class dbMobHandler extends dbHandlerBase {
         }
     }
 
-    public boolean ADD_GUARD_MINION(final long captainUID, final String minionName) {
+    public boolean ADD_TO_GUARDS(final long captainUID, final int mobBaseID, final String name, final int slot) {
 
         try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("INSERT INTO `dyn_guards` (`captainUID`, `minionName`) VALUES (?,?)")) {
+             PreparedStatement preparedStatement = connection.prepareStatement("INSERT INTO `dyn_guards` (`captainUID`, `mobBaseID`,`name`, `slot`) VALUES (?,?,?,?)")) {
 
             preparedStatement.setLong(1, captainUID);
-            preparedStatement.setString(2, minionName);
+            preparedStatement.setInt(2, mobBaseID);
+            preparedStatement.setString(3, name);
+            preparedStatement.setInt(4, slot);
 
             return (preparedStatement.executeUpdate() > 0);
 
@@ -159,13 +149,14 @@ public class dbMobHandler extends dbHandlerBase {
         }
     }
 
-    public boolean REMOVE_GUARD_MINION(final long captainUID, final String minionName) {
+    public boolean REMOVE_FROM_GUARDS(final long captainUID, final int mobBaseID, final int slot) {
 
         try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("DELETE FROM `dyn_guards` WHERE `captainUID`=? AND `minionName`=? LIMIT 1;")) {
+             PreparedStatement preparedStatement = connection.prepareStatement("DELETE FROM `dyn_guards` WHERE `captainUID`=? AND `mobBaseID`=? AND `slot` =?")) {
 
             preparedStatement.setLong(1, captainUID);
-            preparedStatement.setString(2, minionName);
+            preparedStatement.setInt(2, mobBaseID);
+            preparedStatement.setInt(3, slot);
 
             return (preparedStatement.executeUpdate() > 0);
 
@@ -175,19 +166,24 @@ public class dbMobHandler extends dbHandlerBase {
         }
     }
 
-    public boolean REMOVE_ALL_MINIONS(final long captainUID) {
+
+    public ArrayList<Mob> GET_ALL_MOBS_FOR_ZONE(Zone zone) {
+
+        ArrayList<Mob> mobileList = new ArrayList<>();
 
         try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("DELETE FROM `dyn_guards` WHERE `captainUID`=?;")) {
+             PreparedStatement preparedStatement = connection.prepareStatement("SELECT `obj_mob`.*, `object`.`parent` FROM `object` INNER JOIN `obj_mob` ON `obj_mob`.`UID` = `object`.`UID` WHERE `object`.`parent` = ?;")) {
 
-            preparedStatement.setLong(1, captainUID);
+            preparedStatement.setLong(1, zone.getObjectUUID());
 
-            return (preparedStatement.executeUpdate() > 0);
+            ResultSet rs = preparedStatement.executeQuery();
+            mobileList = getObjectsFromRs(rs, 1000);
 
         } catch (SQLException e) {
             Logger.error(e);
-            return false;
         }
+
+        return mobileList;
     }
 
     public Mob GET_MOB(final int objectUUID) {

src/engine/db/handlers/dbNPCHandler.java

@@ -15,6 +15,7 @@ import engine.math.Vector3fImmutable;
 import engine.objects.NPC;
 import engine.objects.NPCProfits;
 import engine.objects.ProducedItem;
+import engine.objects.Zone;
 import org.joda.time.DateTime;
 import org.pmw.tinylog.Logger;
 
@@ -23,7 +24,6 @@ import java.sql.PreparedStatement;
 import java.sql.ResultSet;
 import java.sql.SQLException;
 import java.util.ArrayList;
-import java.util.HashMap;
 
 public class dbNPCHandler extends dbHandlerBase {
 
@@ -32,45 +32,6 @@ public class dbNPCHandler extends dbHandlerBase {
         this.localObjectType = engine.Enum.GameObjectType.valueOf(this.localClass.getSimpleName());
     }
 
-    public static HashMap<Integer, ArrayList<Integer>> LOAD_RUNES_FOR_NPC_AND_MOBS() {
-
-        HashMap<Integer, ArrayList<Integer>> runeSets = new HashMap<>();
-        int runeSetID;
-        int runeBaseID;
-        int recordsRead = 0;
-
-        try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM static_npc_runeSet")) {
-
-            ResultSet rs = preparedStatement.executeQuery();
-
-            while (rs.next()) {
-
-                recordsRead++;
-
-                runeSetID = rs.getInt("runeSet");
-                runeBaseID = rs.getInt("runeBase");
-
-                if (runeSets.get(runeSetID) == null) {
-                    ArrayList<Integer> runeList = new ArrayList<>();
-                    runeList.add(runeBaseID);
-                    runeSets.put(runeSetID, runeList);
-                } else {
-                    ArrayList<Integer> runeList = runeSets.get(runeSetID);
-                    runeList.add(runeSetID);
-                    runeSets.put(runeSetID, runeList);
-                }
-            }
-
-        } catch (SQLException e) {
-            Logger.error(e);
-            return runeSets;
-        }
-
-        Logger.info("read: " + recordsRead + " cached: " + runeSets.size());
-        return runeSets;
-    }
-
     public NPC PERSIST(NPC toAdd) {
 
         NPC npc = null;
@@ -133,12 +94,14 @@ public class dbNPCHandler extends dbHandlerBase {
         return row_count;
     }
 
-    public ArrayList<NPC> GET_ALL_NPCS() {
+    public ArrayList<NPC> GET_ALL_NPCS_FOR_ZONE(Zone zone) {
 
         ArrayList<NPC> npcList = new ArrayList<>();
 
         try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("SELECT `obj_npc`.*, `object`.`parent` FROM `object` INNER JOIN `obj_npc` ON `obj_npc`.`UID` = `object`.`UID` ORDER BY `object`.`UID` ASC;")) {
+             PreparedStatement preparedStatement = connection.prepareStatement("SELECT `obj_npc`.*, `object`.`parent` FROM `object` INNER JOIN `obj_npc` ON `obj_npc`.`UID` = `object`.`UID` WHERE `object`.`parent` = ?;")) {
+
+            preparedStatement.setLong(1, zone.getObjectUUID());
 
             ResultSet rs = preparedStatement.executeQuery();
             npcList = getObjectsFromRs(rs, 1000);
@@ -345,14 +308,14 @@ public class dbNPCHandler extends dbHandlerBase {
                 + NPC._pirateNames.size() + " mobBases");
     }
 
-    public boolean ADD_TO_PRODUCTION_LIST(final long ID, final long npcUID, final long templateID, DateTime dateTime, String prefix, String suffix, String name, boolean isRandom, int playerID) {
+    public boolean ADD_TO_PRODUCTION_LIST(final long ID, final long npcUID, final long itemBaseID, DateTime dateTime, String prefix, String suffix, String name, boolean isRandom, int playerID) {
 
         try (Connection connection = DbManager.getConnection();
              PreparedStatement preparedStatement = connection.prepareStatement("INSERT INTO `dyn_npc_production` (`ID`,`npcUID`, `itemBaseID`,`dateToUpgrade`, `isRandom`, `prefix`, `suffix`, `name`,`playerID`) VALUES (?,?,?,?,?,?,?,?,?)")) {
 
             preparedStatement.setLong(1, ID);
             preparedStatement.setLong(2, npcUID);
-            preparedStatement.setLong(3, templateID);
+            preparedStatement.setLong(3, itemBaseID);
             preparedStatement.setTimestamp(4, new java.sql.Timestamp(dateTime.getMillis()));
             preparedStatement.setBoolean(5, isRandom);
             preparedStatement.setString(6, prefix);

src/engine/db/handlers/dbPowerHandler.java

@@ -13,12 +13,17 @@ import engine.Enum;
 import engine.gameManager.DbManager;
 import engine.gameManager.PowersManager;
 import engine.objects.Mob;
+import engine.objects.PreparedStatementShared;
 import engine.powers.EffectsBase;
+import engine.powers.MobPowerEntry;
 import org.pmw.tinylog.Logger;
 
 import java.sql.Connection;
 import java.sql.PreparedStatement;
 import java.sql.ResultSet;
+import java.sql.SQLException;
+import java.util.ArrayList;
+import java.util.HashMap;
 import java.util.HashSet;
 
 public class dbPowerHandler extends dbHandlerBase {
@@ -29,17 +34,16 @@ public class dbPowerHandler extends dbHandlerBase {
     }
 
     public static void addAllSourceTypes() {
-
-        try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM static_power_sourcetype")) {
-
-            ResultSet rs = preparedStatement.executeQuery();
+        PreparedStatementShared ps = null;
+        try {
+            ps = new PreparedStatementShared("SELECT * FROM static_power_sourcetype");
+            ResultSet rs = ps.executeQuery();
             String IDString, source;
-
             while (rs.next()) {
                 IDString = rs.getString("IDString");
                 int token = DbManager.hasher.SBStringHash(IDString);
 
+
                 source = rs.getString("source").replace("-", "").trim();
                 Enum.EffectSourceType effectSourceType = Enum.EffectSourceType.GetEffectSourceType(source);
 
@@ -48,18 +52,19 @@ public class dbPowerHandler extends dbHandlerBase {
 
                 EffectsBase.effectSourceTypeMap.get(token).add(effectSourceType);
             }
+            rs.close();
         } catch (Exception e) {
             Logger.error(e);
+        } finally {
+            ps.release();
         }
     }
 
     public static void addAllAnimationOverrides() {
-
-        try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM static_power_animation_override")) {
-
-            ResultSet rs = preparedStatement.executeQuery();
-
+        PreparedStatementShared ps = null;
+        try {
+            ps = new PreparedStatementShared("SELECT * FROM static_power_animation_override");
+            ResultSet rs = ps.executeQuery();
             String IDString;
             int animation;
             while (rs.next()) {
@@ -73,10 +78,51 @@ public class dbPowerHandler extends dbHandlerBase {
                 PowersManager.AnimationOverrides.put(IDString, animation);
 
             }
+            rs.close();
         } catch (Exception e) {
             Logger.error(e);
+        } finally {
+            ps.release();
+        }
+    }
+
+    public static HashMap<Integer, ArrayList<MobPowerEntry>> LOAD_MOB_POWERS() {
+
+        HashMap<Integer, ArrayList<MobPowerEntry>> mobPowers = new HashMap<>();
+        MobPowerEntry mobPowerEntry;
+
+        int mobbaseID;
+        int recordsRead = 0;
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM static_npc_mobbase_powers ORDER BY `id` ASC;")) {
+
+            ResultSet rs = preparedStatement.executeQuery();
+
+            while (rs.next()) {
+
+                recordsRead++;
+
+                mobbaseID = rs.getInt("mobbaseUUID");
+                mobPowerEntry = new MobPowerEntry(rs);
+
+                if (mobPowers.get(mobbaseID) == null) {
+                    ArrayList<MobPowerEntry> powerList = new ArrayList<>();
+                    powerList.add(mobPowerEntry);
+                    mobPowers.put(mobbaseID, powerList);
+                } else {
+                    ArrayList<MobPowerEntry> powerList = mobPowers.get(mobbaseID);
+                    powerList.add(mobPowerEntry);
+                    mobPowers.put(mobbaseID, powerList);
+                }
+            }
+        } catch (SQLException e) {
+            Logger.error(e);
+            return mobPowers;
         }
 
+        Logger.info("read: " + recordsRead + " cached: " + mobPowers.size());
+        return mobPowers;
     }
 
 }

src/engine/db/handlers/dbRuneBaseHandler.java

@@ -11,8 +11,6 @@ package engine.db.handlers;
 
 import engine.gameManager.DbManager;
 import engine.objects.RuneBase;
-import engine.powers.RunePowerEntry;
-import engine.powers.RuneSkillAdjustEntry;
 import org.pmw.tinylog.Logger;
 
 import java.sql.Connection;
@@ -29,84 +27,6 @@ public class dbRuneBaseHandler extends dbHandlerBase {
         this.localObjectType = engine.Enum.GameObjectType.valueOf(this.localClass.getSimpleName());
     }
 
-    public static HashMap<Integer, ArrayList<RunePowerEntry>> LOAD_RUNE_POWERS() {
-
-        HashMap<Integer, ArrayList<RunePowerEntry>> mobPowers = new HashMap<>();
-        RunePowerEntry runePowerEntry;
-
-        int rune_id;
-        int recordsRead = 0;
-
-        try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM static_rune_powers")) {
-
-            ResultSet rs = preparedStatement.executeQuery();
-
-            while (rs.next()) {
-
-                recordsRead++;
-
-                rune_id = rs.getInt("rune_id");
-                runePowerEntry = new RunePowerEntry(rs);
-
-                if (mobPowers.get(rune_id) == null) {
-                    ArrayList<RunePowerEntry> runePowerList = new ArrayList<>();
-                    runePowerList.add(runePowerEntry);
-                    mobPowers.put(rune_id, runePowerList);
-                } else {
-                    ArrayList<RunePowerEntry> powerList = mobPowers.get(rune_id);
-                    powerList.add(runePowerEntry);
-                    mobPowers.put(rune_id, powerList);
-                }
-            }
-        } catch (SQLException e) {
-            Logger.error(e);
-            return mobPowers;
-        }
-
-        Logger.info("read: " + recordsRead + " cached: " + mobPowers.size());
-        return mobPowers;
-    }
-
-    public static HashMap<Integer, ArrayList<RuneSkillAdjustEntry>> LOAD_RUNE_SKILL_ADJUSTS() {
-
-        HashMap<Integer, ArrayList<RuneSkillAdjustEntry>> runeSkillAdjusts = new HashMap<>();
-        RuneSkillAdjustEntry runeSkillAdjustEntry;
-
-        int rune_id;
-        int recordsRead = 0;
-
-        try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM static_rune_skill_adjusts")) {
-
-            ResultSet rs = preparedStatement.executeQuery();
-
-            while (rs.next()) {
-
-                recordsRead++;
-
-                rune_id = rs.getInt("rune_id");
-                runeSkillAdjustEntry = new RuneSkillAdjustEntry(rs);
-
-                if (runeSkillAdjusts.get(rune_id) == null) {
-                    ArrayList<RuneSkillAdjustEntry> skillAdjustList = new ArrayList<>();
-                    skillAdjustList.add(runeSkillAdjustEntry);
-                    runeSkillAdjusts.put(rune_id, skillAdjustList);
-                } else {
-                    ArrayList<RuneSkillAdjustEntry> powerList = runeSkillAdjusts.get(rune_id);
-                    powerList.add(runeSkillAdjustEntry);
-                    runeSkillAdjusts.put(rune_id, powerList);
-                }
-            }
-        } catch (SQLException e) {
-            Logger.error(e);
-            return runeSkillAdjusts;
-        }
-
-        Logger.info("read: " + recordsRead + " cached: " + runeSkillAdjusts.size());
-        return runeSkillAdjusts;
-    }
-
     public void GET_RUNE_REQS(final RuneBase rb) {
 
         try (Connection connection = DbManager.getConnection();

src/engine/db/handlers/dbWarehouseHandler.java

@@ -9,19 +9,14 @@
 
 package engine.db.handlers;
 
-import engine.Enum;
 import engine.Enum.GameObjectType;
+import engine.Enum.ProtectionState;
 import engine.Enum.TransactionType;
 import engine.gameManager.DbManager;
-import engine.objects.Building;
-import engine.objects.City;
-import engine.objects.Transaction;
-import engine.objects.Warehouse;
+import engine.math.Vector3fImmutable;
+import engine.objects.*;
 import engine.server.MBServerStatics;
 import org.joda.time.DateTime;
-import org.json.simple.JSONArray;
-import org.json.simple.JSONObject;
-import org.json.simple.parser.JSONParser;
 import org.pmw.tinylog.Logger;
 
 import java.sql.Connection;
@@ -36,21 +31,85 @@ public class dbWarehouseHandler extends dbHandlerBase {
     private static final ConcurrentHashMap<Integer, String> columns = new ConcurrentHashMap<>(MBServerStatics.CHM_INIT_CAP, MBServerStatics.CHM_LOAD, MBServerStatics.CHM_THREAD_LOW);
 
     public dbWarehouseHandler() {
+        this.localClass = Warehouse.class;
+        this.localObjectType = engine.Enum.GameObjectType.valueOf(this.localClass.getSimpleName());
 
     }
 
-    public boolean CREATE_TRANSACTION(int warehouseBuildingID, GameObjectType targetType, int targetUUID, TransactionType transactionType, Enum.ResourceType resource, int amount, DateTime date) {
+    public static void addObject(ArrayList<AbstractGameObject> list, ResultSet rs) throws SQLException {
+        String type = rs.getString("type");
+        switch (type) {
+            case "building":
+                Building building = new Building(rs);
+                DbManager.addToCache(building);
+                list.add(building);
+                break;
+            case "warehouse":
+                Warehouse warehouse = new Warehouse(rs);
+                DbManager.addToCache(warehouse);
+                list.add(warehouse);
+                break;
+        }
+    }
+
+    public ArrayList<AbstractGameObject> CREATE_WAREHOUSE(int parentZoneID, int OwnerUUID, String name, int meshUUID,
+                                                          Vector3fImmutable location, float meshScale, int currentHP,
+                                                          ProtectionState protectionState, int currentGold, int rank,
+                                                          DateTime upgradeDate, int blueprintUUID, float w, float rotY) {
+
+        ArrayList<AbstractGameObject> warehouseList = new ArrayList<>();
 
         try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("INSERT INTO `dyn_warehouse_transactions` (`warehouseUID`, `targetType`,`targetUID`, `type`,`resource`,`amount`,`date` ) VALUES (?,?,?,?,?,?,?)")) {
+             PreparedStatement preparedStatement = connection.prepareStatement("CALL `WAREHOUSE_CREATE`(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ? ,? ,? ,?, ?);")) {
+
+            preparedStatement.setInt(1, parentZoneID);
+            preparedStatement.setInt(2, OwnerUUID);
+            preparedStatement.setString(3, name);
+            preparedStatement.setInt(4, meshUUID);
+            preparedStatement.setFloat(5, location.x);
+            preparedStatement.setFloat(6, location.y);
+            preparedStatement.setFloat(7, location.z);
+            preparedStatement.setFloat(8, meshScale);
+            preparedStatement.setInt(9, currentHP);
+            preparedStatement.setString(10, protectionState.name());
+            preparedStatement.setInt(11, currentGold);
+            preparedStatement.setInt(12, rank);
+
+            if (upgradeDate != null)
+                preparedStatement.setTimestamp(13, new java.sql.Timestamp(upgradeDate.getMillis()));
+            else
+                preparedStatement.setNull(13, java.sql.Types.DATE);
+
+            preparedStatement.setInt(14, blueprintUUID);
+            preparedStatement.setFloat(15, w);
+            preparedStatement.setFloat(16, rotY);
+
+            preparedStatement.execute();
+            ResultSet rs = preparedStatement.getResultSet();
+
+            while (rs.next())
+                addObject(warehouseList, rs);
+
+            while (preparedStatement.getMoreResults()) {
+                rs = preparedStatement.getResultSet();
+
+                while (rs.next())
+                    addObject(warehouseList, rs);
+            }
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
 
-            preparedStatement.setLong(1, warehouseBuildingID);
-            preparedStatement.setString(2, targetType.name());
-            preparedStatement.setLong(3, targetUUID);
-            preparedStatement.setString(4, transactionType.name());
-            preparedStatement.setString(5, resource.name());
-            preparedStatement.setInt(6, amount);
-            preparedStatement.setTimestamp(7, new java.sql.Timestamp(date.getMillis()));
+        return warehouseList;
+    }
+
+    public boolean updateLocks(final Warehouse wh, long locks) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_locks`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setLong(1, locks);
+            preparedStatement.setInt(2, wh.getUID());
 
             return (preparedStatement.executeUpdate() > 0);
 
@@ -60,62 +119,157 @@ public class dbWarehouseHandler extends dbHandlerBase {
         return false;
     }
 
-    public ArrayList<Transaction> GET_TRANSACTIONS_FOR_WAREHOUSE(final int warehouseUUID) {
+    public boolean updateGold(final Warehouse wh, int amount) {
 
-        ArrayList<Transaction> transactionsList = new ArrayList<>();
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_gold`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
+
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
 
+    public boolean updateStone(final Warehouse wh, int amount) {
 
         try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM dyn_warehouse_transactions WHERE `warehouseUID` = ?;")) {
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_stone`=? WHERE `UID` = ?")) {
 
-            preparedStatement.setInt(1, warehouseUUID);
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
 
-            ResultSet rs = preparedStatement.executeQuery();
+            return (preparedStatement.executeUpdate() > 0);
 
-            while (rs.next()) {
-                Transaction transactions = new Transaction(rs);
-                transactionsList.add(transactions);
-            }
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
+
+    public boolean updateTruesteel(final Warehouse wh, int amount) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_truesteel`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
+
+            return (preparedStatement.executeUpdate() > 0);
 
         } catch (SQLException e) {
             Logger.error(e);
         }
+        return false;
+    }
 
-        return transactionsList;
+    public boolean updateIron(final Warehouse wh, int amount) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_iron`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
+
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
+
+    public boolean updateAdamant(final Warehouse wh, int amount) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_adamant`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
+
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
+
+    public boolean updateLumber(final Warehouse wh, int amount) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_lumber`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
+
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
     }
 
-    public void DELETE_WAREHOUSE(Warehouse warehouse) {
+    public boolean updateOak(final Warehouse wh, int amount) {
+
         try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("DELETE FROM ``dyn_warehouse` WHERE `cityUUID` = ?;")) {
-            preparedStatement.setInt(1, warehouse.city.getObjectUUID());
-            preparedStatement.executeUpdate();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_oak`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
+
+            return (preparedStatement.executeUpdate() > 0);
 
         } catch (SQLException e) {
             Logger.error(e);
         }
+        return false;
+    }
+
+    public boolean updateBronzewood(final Warehouse wh, int amount) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_bronzewood`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
 
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
     }
 
-    public boolean UPDATE_WAREHOUSE(Warehouse warehouse) {
+    public boolean updateMandrake(final Warehouse wh, int amount) {
 
-        JSONObject warehouseJSON = new JSONObject();
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_mandrake`=? WHERE `UID` = ?")) {
 
-        JSONObject resources = new JSONObject(warehouse.resources);
-        warehouseJSON.put("resources", resources);
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
 
-        JSONArray locks = new JSONArray();
+            return (preparedStatement.executeUpdate() > 0);
 
-        for (Enum.ResourceType resource : warehouse.locked)
-            locks.add(resource.name());
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
 
-        warehouseJSON.put("locked", locks);
+    public boolean updateCoal(final Warehouse wh, int amount) {
 
         try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("INSERT INTO `dyn_warehouse` (`cityUUID`, `warehouse`) VALUES (?, ?) " +
-                     "ON DUPLICATE KEY UPDATE `warehouse` = VALUES(`warehouse`)")) {
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_coal`=? WHERE `UID` = ?")) {
 
-            preparedStatement.setInt(1, warehouse.city.getObjectUUID());
-            preparedStatement.setString(2, warehouseJSON.toString());
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
 
             return (preparedStatement.executeUpdate() > 0);
 
@@ -125,32 +279,276 @@ public class dbWarehouseHandler extends dbHandlerBase {
         return false;
     }
 
-    public void LOAD_WAREHOUSES() {
+    public boolean updateAgate(final Warehouse wh, int amount) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_agate`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
 
-        JSONParser jsonParser = new JSONParser();
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
+
+    public boolean updateDiamond(final Warehouse wh, int amount) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_diamond`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
+
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
+
+    public boolean updateOnyx(final Warehouse wh, int amount) {
 
         try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM `dyn_warehouse`;");
-             ResultSet rs = preparedStatement.executeQuery()) {
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_onyx`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
+
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
+
+    public boolean updateAzoth(final Warehouse wh, int amount) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_azoth`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
+
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
+
+    public boolean updateOrichalk(final Warehouse wh, int amount) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_orichalk`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
+
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
+
+    public boolean updateAntimony(final Warehouse wh, int amount) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_antimony`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
+
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
+
+    public boolean updateSulfur(final Warehouse wh, int amount) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_sulfur`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
+
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
+
+    public boolean updateQuicksilver(final Warehouse wh, int amount) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_quicksilver`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
+
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
+
+    public boolean updateGalvor(final Warehouse wh, int amount) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_galvor`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
+
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
+
+    public boolean updateWormwood(final Warehouse wh, int amount) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_wormwood`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
+
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
+
+    public boolean updateObsidian(final Warehouse wh, int amount) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_obsidian`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
+
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
+
+    public boolean updateBloodstone(final Warehouse wh, int amount) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_bloodstone`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
+
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
+
+    public boolean updateMithril(final Warehouse wh, int amount) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("UPDATE `obj_warehouse` SET `warehouse_mithril`=? WHERE `UID` = ?")) {
+
+            preparedStatement.setInt(1, amount);
+            preparedStatement.setInt(2, wh.getUID());
+
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
+
+    public boolean CREATE_TRANSACTION(int warehouseBuildingID, GameObjectType targetType, int targetUUID, TransactionType transactionType, Resource resource, int amount, DateTime date) {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("INSERT INTO `dyn_warehouse_transactions` (`warehouseUID`, `targetType`,`targetUID`, `type`,`resource`,`amount`,`date` ) VALUES (?,?,?,?,?,?,?)")) {
+
+            preparedStatement.setLong(1, warehouseBuildingID);
+            preparedStatement.setString(2, targetType.name());
+            preparedStatement.setLong(3, targetUUID);
+            preparedStatement.setString(4, transactionType.name());
+            preparedStatement.setString(5, resource.name());
+            preparedStatement.setInt(6, amount);
+            preparedStatement.setTimestamp(7, new java.sql.Timestamp(date.getMillis()));
+
+            return (preparedStatement.executeUpdate() > 0);
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+        return false;
+    }
+
+    public ArrayList<Transaction> GET_TRANSACTIONS_FOR_WAREHOUSE(final int warehouseUUID) {
+
+        ArrayList<Transaction> transactionsList = new ArrayList<>();
+
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM dyn_warehouse_transactions WHERE `warehouseUID` = ?;")) {
+
+            preparedStatement.setInt(1, warehouseUUID);
+
+            ResultSet rs = preparedStatement.executeQuery();
 
             while (rs.next()) {
-                int cityUID = rs.getInt("cityUUID");
-                JSONObject jsonObject = (JSONObject) jsonParser.parse(rs.getString("warehouse"));
-                City city = City.getCity(cityUID);
-                city.warehouse = new Warehouse(jsonObject);
-                city.warehouse.city = city;
-
-                // Locate warehouse building
-                for (Building building : city.parentZone.zoneBuildingSet) {
-                    if (building.getBlueprint().getBuildingGroup().equals(Enum.BuildingGroup.WAREHOUSE)) {
-                        city.warehouse.building = building;
-                        break;
-                    }
-                }
+                Transaction transactions = new Transaction(rs);
+                transactionsList.add(transactions);
+            }
+
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
+
+        return transactionsList;
+    }
 
+    public void LOAD_ALL_WAREHOUSES() {
+
+        Warehouse warehouse;
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("SELECT `obj_warehouse`.*, `object`.`parent`, `object`.`type` FROM `object` LEFT JOIN `obj_warehouse` ON `object`.`UID` = `obj_warehouse`.`UID` WHERE `object`.`type` = 'warehouse';")) {
+
+
+            ResultSet rs = preparedStatement.executeQuery();
+
+            while (rs.next()) {
+                warehouse = new Warehouse(rs);
+                warehouse.runAfterLoad();
+                warehouse.loadAllTransactions();
             }
 
-        } catch (Exception e) {
+        } catch (SQLException e) {
             Logger.error(e);
         }
     }

src/engine/db/handlers/dbZoneHandler.java

@@ -12,8 +12,8 @@ package engine.db.handlers;
 import engine.Enum;
 import engine.gameManager.DbManager;
 import engine.gameManager.ZoneManager;
+import engine.math.Vector2f;
 import engine.objects.Zone;
-import engine.objects.ZoneTemplate;
 import org.pmw.tinylog.Logger;
 
 import java.sql.Connection;
@@ -29,21 +29,25 @@ public class dbZoneHandler extends dbHandlerBase {
         this.localObjectType = Enum.GameObjectType.valueOf(this.localClass.getSimpleName());
     }
 
-    public ArrayList<Zone> GET_ALL_ZONES() {
-
-        ArrayList<Zone> zoneList = new ArrayList<>();
-
-        try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("SELECT `obj_zone`.*, `object`.`parent` FROM `object` INNER JOIN `obj_zone` ON `obj_zone`.`UID` = `object`.`UID` ORDER BY `object`.`UID` ASC;")) {
-
-            ResultSet rs = preparedStatement.executeQuery();
-            zoneList = getObjectsFromRs(rs, 2000);
-
-        } catch (SQLException e) {
-            Logger.error(e);
+    public ArrayList<Zone> GET_ALL_NODES(Zone zone) {
+        ArrayList<Zone> wsmList = new ArrayList<>();
+        wsmList.addAll(zone.getNodes());
+        if (zone.absX == 0.0f) {
+            zone.absX = zone.getXCoord();
         }
-
-        return zoneList;
+        if (zone.absY == 0.0f) {
+            zone.absY = zone.getYCoord();
+        }
+        if (zone.absZ == 0.0f) {
+            zone.absZ = zone.getZCoord();
+        }
+        for (Zone child : zone.getNodes()) {
+            child.absX = child.getXCoord() + zone.absX;
+            child.absY = child.getYCoord() + zone.absY;
+            child.absZ = child.getZCoord() + zone.absZ;
+            wsmList.addAll(this.GET_ALL_NODES(child));
+        }
+        return wsmList;
     }
 
     public Zone GET_BY_UID(long ID) {
@@ -68,38 +72,43 @@ public class dbZoneHandler extends dbHandlerBase {
         return zone;
     }
 
-    public void LOAD_ALL_ZONE_TEMPLATES() {
+    public ArrayList<Zone> GET_MAP_NODES(final int objectUUID) {
+
+        ArrayList<Zone> zoneList = new ArrayList<>();
 
         try (Connection connection = DbManager.getConnection();
-             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM static_zone_templates")) {
+             PreparedStatement preparedStatement = connection.prepareStatement("SELECT `obj_zone`.*, `object`.`parent` FROM `object` INNER JOIN `obj_zone` ON `obj_zone`.`UID` = `object`.`UID` WHERE `object`.`parent` = ?;")) {
+
+            preparedStatement.setLong(1, objectUUID);
 
             ResultSet rs = preparedStatement.executeQuery();
+            zoneList = getObjectsFromRs(rs, 2000);
 
-            while (rs.next()) {
-                ZoneTemplate zoneTemplate = new ZoneTemplate(rs);
-                ZoneManager._zone_templates.put(zoneTemplate.templateID, zoneTemplate);
-            }
+        } catch (SQLException e) {
+            Logger.error(e);
+        }
 
-            // Add player city
+        return zoneList;
+    }
 
-            ZoneTemplate zoneTemplate = new ZoneTemplate();
+    public void LOAD_ZONE_EXTENTS() {
+
+        try (Connection connection = DbManager.getConnection();
+             PreparedStatement preparedStatement = connection.prepareStatement("SELECT * FROM `static_zone_size`;")) {
 
-            zoneTemplate.templateID = 0;
-            zoneTemplate.sea_level_type = "PARENT";
-            zoneTemplate.sea_level = 0;
-            zoneTemplate.max_blend = 128;
-            zoneTemplate.min_blend = 128;
-            zoneTemplate.terrain_max_y = 5;
-            zoneTemplate.major_radius = (int) Enum.CityBoundsType.ZONE.halfExtents;
-            zoneTemplate.minor_radius = (int) Enum.CityBoundsType.ZONE.halfExtents;
-            zoneTemplate.terrain_type = "PLANAR";
+            ResultSet rs = preparedStatement.executeQuery();
 
-            ZoneManager._zone_templates.put(zoneTemplate.templateID, zoneTemplate);
+            while (rs.next()) {
+                Vector2f zoneSize = new Vector2f();
+                int loadNum = rs.getInt("loadNum");
+                zoneSize.x = rs.getFloat("xRadius");
+                zoneSize.y = rs.getFloat("zRadius");
+                ZoneManager._zone_size_data.put(loadNum, zoneSize);
+            }
 
         } catch (SQLException e) {
             Logger.error(e);
         }
-
     }
 
     public boolean DELETE_ZONE(final Zone zone) {

src/engine/devcmd/cmds/AddMobCmd.java

@@ -9,16 +9,18 @@
 
 package engine.devcmd.cmds;
 
-import engine.Enum;
+import engine.Enum.GameObjectType;
 import engine.devcmd.AbstractDevCmd;
 import engine.gameManager.ChatManager;
+import engine.gameManager.DbManager;
 import engine.gameManager.ZoneManager;
-import engine.objects.AbstractGameObject;
-import engine.objects.Mob;
-import engine.objects.PlayerCharacter;
-import engine.objects.Zone;
+import engine.math.Vector3fImmutable;
+import engine.objects.*;
 import org.pmw.tinylog.Logger;
 
+/**
+ * @author Eighty
+ */
 public class AddMobCmd extends AbstractDevCmd {
 
     public AddMobCmd() {
@@ -35,8 +37,27 @@ public class AddMobCmd extends AbstractDevCmd {
 
         Zone zone = ZoneManager.findSmallestZone(pc.getLoc());
 
-        int loadID;
+        if (words[0].equals("all")) {
+
+            for (AbstractGameObject mobbaseAGO : DbManager.getList(GameObjectType.MobBase)) {
+                MobBase mb = (MobBase) mobbaseAGO;
+                int loadID = mb.getObjectUUID();
+                Mob mob = Mob.createMob(loadID, Vector3fImmutable.getRandomPointInCircle(pc.getLoc(), 100),
+                        null, true, zone, null, 0, "", 1);
+                if (mob != null) {
+                    mob.updateDatabase();
+                    this.setResult(String.valueOf(mob.getDBID()));
+                } else {
+                    throwbackError(pc, "Failed to create mob of type " + loadID);
+                    Logger.error("Failed to create mob of type "
+                            + loadID);
+                }
+            }
+            return;
+        }
+
 
+        int loadID;
         try {
             loadID = Integer.parseInt(words[0]);
         } catch (NumberFormatException e) {
@@ -50,19 +71,20 @@ public class AddMobCmd extends AbstractDevCmd {
             return; // NaN
         }
 
+
         if (zone == null) {
             throwbackError(pc, "Failed to find zone to place mob in.");
             return;
         }
 
-        if (zone.guild_zone) {
+        if (zone.isPlayerCity()) {
             throwbackError(pc, "Cannot use ./mob on Player cities. Try ./servermob instead.");
             return;
         }
 
-        Mob mob = Mob.createMob(loadID, pc.getLoc(),
-                null, zone, null, null, "", 1, Enum.AIAgentType.MOBILE);
 
+        Mob mob = Mob.createMob(loadID, pc.getLoc(),
+                null, true, zone, null, 0, "", 1);
         if (mob != null) {
             mob.updateDatabase();
             ChatManager.chatSayInfo(pc,

src/engine/devcmd/cmds/AuditFailedItemsCmd.java

@@ -0,0 +1,127 @@
+// • ▌ ▄ ·.  ▄▄▄·  ▄▄ • ▪   ▄▄· ▄▄▄▄·  ▄▄▄·  ▐▄▄▄  ▄▄▄ .
+// ·██ ▐███▪▐█ ▀█ ▐█ ▀ ▪██ ▐█ ▌▪▐█ ▀█▪▐█ ▀█ •█▌ ▐█▐▌·
+// ▐█ ▌▐▌▐█·▄█▀▀█ ▄█ ▀█▄▐█·██ ▄▄▐█▀▀█▄▄█▀▀█ ▐█▐ ▐▌▐▀▀▀
+// ██ ██▌▐█▌▐█ ▪▐▌▐█▄▪▐█▐█▌▐███▌██▄▪▐█▐█ ▪▐▌██▐ █▌▐█▄▄▌
+// ▀▀  █▪▀▀▀ ▀  ▀ ·▀▀▀▀ ▀▀▀·▀▀▀ ·▀▀▀▀  ▀  ▀ ▀▀  █▪ ▀▀▀
+//      Magicbane Emulator Project © 2013 - 2022
+//                www.magicbane.com
+
+
+package engine.devcmd.cmds;
+
+import engine.Enum.ModType;
+import engine.devcmd.AbstractDevCmd;
+import engine.gameManager.PowersManager;
+import engine.net.ItemProductionManager;
+import engine.objects.*;
+import engine.powers.effectmodifiers.AbstractEffectModifier;
+import engine.powers.poweractions.AbstractPowerAction;
+import org.pmw.tinylog.Logger;
+
+public class AuditFailedItemsCmd extends AbstractDevCmd {
+
+    public AuditFailedItemsCmd() {
+        super("faileditems");
+    }
+
+    @Override
+    protected void _doCmd(PlayerCharacter pcSender, String[] words,
+                          AbstractGameObject target) {
+
+
+        if (ItemProductionManager.FailedItems.isEmpty())
+            return;
+
+        Logger.info("Auditing Item production Failed Items");
+
+        String newLine = "\r\n";
+        String auditFailedItem = "Failed Item Name | Prefix | Suffix | NPC | Contract  | Player | ";
+
+        for (ProducedItem failedItem : ItemProductionManager.FailedItems) {
+
+            String npcName = "";
+            String playerName = "";
+            String contractName = "";
+
+            String prefix = "";
+            String suffix = "";
+            String itemName = "";
+            NPC npc = NPC.getFromCache(failedItem.getNpcUID());
+
+            if (npc == null) {
+                npcName = "null";
+                contractName = "null";
+            } else {
+                npcName = npc.getName();
+                if (npc.getContract() != null)
+                    contractName = npc.getContract().getName();
+            }
+
+            PlayerCharacter roller = PlayerCharacter.getFromCache(failedItem.getPlayerID());
+
+            if (roller == null)
+                playerName = "null";
+            else
+                playerName = roller.getName();
+
+            ItemBase ib = ItemBase.getItemBase(failedItem.getItemBaseID());
+
+            if (ib != null) {
+                itemName = ib.getName();
+            }
+
+            if (failedItem.isRandom() == false) {
+                if (failedItem.getPrefix().isEmpty() == false) {
+                    AbstractPowerAction pa = PowersManager.getPowerActionByIDString(failedItem.getPrefix());
+                    if (pa != null) {
+                        for (AbstractEffectModifier aem : pa.getEffectsBase().getModifiers()) {
+                            if (aem.modType.equals(ModType.ItemName)) {
+                                prefix = aem.getString1();
+                                break;
+                            }
+                        }
+                    }
+
+                }
+
+                if (failedItem.getSuffix().isEmpty() == false) {
+                    AbstractPowerAction pa = PowersManager.getPowerActionByIDString(failedItem.getSuffix());
+                    if (pa != null) {
+                        for (AbstractEffectModifier aem : pa.getEffectsBase().getModifiers()) {
+                            if (aem.modType.equals(ModType.ItemName)) {
+                                suffix = aem.getString1();
+                                break;
+                            }
+                        }
+                    }
+
+                }
+
+            } else {
+                prefix = "random";
+            }
+
+
+            auditFailedItem += newLine;
+            auditFailedItem += itemName + " | " + prefix + " | " + suffix + " | " + failedItem.getNpcUID() + ":" + npcName + " | " + contractName + " | " + failedItem.getPlayerID() + ":" + playerName;
+
+        }
+        Logger.info(auditFailedItem);
+        ItemProductionManager.FailedItems.clear();
+
+
+    }
+
+
+    @Override
+    protected String _getUsageString() {
+        return "' /bounds'";
+    }
+
+    @Override
+    protected String _getHelpString() {
+        return "Audits all the mobs in a zone.";
+
+    }
+
+}

src/engine/devcmd/cmds/AuditHeightMapCmd.java

@@ -0,0 +1,70 @@
+// • ▌ ▄ ·.  ▄▄▄·  ▄▄ • ▪   ▄▄· ▄▄▄▄·  ▄▄▄·  ▐▄▄▄  ▄▄▄ .
+// ·██ ▐███▪▐█ ▀█ ▐█ ▀ ▪██ ▐█ ▌▪▐█ ▀█▪▐█ ▀█ •█▌ ▐█▐▌·
+// ▐█ ▌▐▌▐█·▄█▀▀█ ▄█ ▀█▄▐█·██ ▄▄▐█▀▀█▄▄█▀▀█ ▐█▐ ▐▌▐▀▀▀
+// ██ ██▌▐█▌▐█ ▪▐▌▐█▄▪▐█▐█▌▐███▌██▄▪▐█▐█ ▪▐▌██▐ █▌▐█▄▄▌
+// ▀▀  █▪▀▀▀ ▀  ▀ ·▀▀▀▀ ▀▀▀·▀▀▀ ·▀▀▀▀  ▀  ▀ ▀▀  █▪ ▀▀▀
+//      Magicbane Emulator Project © 2013 - 2022
+//                www.magicbane.com
+
+
+package engine.devcmd.cmds;
+
+import engine.InterestManagement.HeightMap;
+import engine.devcmd.AbstractDevCmd;
+import engine.gameManager.ZoneManager;
+import engine.math.Vector2f;
+import engine.math.Vector3fImmutable;
+import engine.objects.AbstractGameObject;
+import engine.objects.PlayerCharacter;
+import engine.objects.Zone;
+
+public class AuditHeightMapCmd extends AbstractDevCmd {
+
+    public AuditHeightMapCmd() {
+        super("auditheightmap");
+    }
+
+    @Override
+    protected void _doCmd(PlayerCharacter pcSender, String[] words,
+                          AbstractGameObject target) {
+
+        int count = Integer.parseInt(words[0]);
+        long start = System.currentTimeMillis();
+        for (int i = 0; i < count; i++) {
+
+
+            Zone currentZone = ZoneManager.findSmallestZone(pcSender.getLoc());
+
+
+            Vector3fImmutable currentLoc = Vector3fImmutable.getRandomPointInCircle(currentZone.getLoc(), currentZone.getBounds().getHalfExtents().x < currentZone.getBounds().getHalfExtents().y ? currentZone.getBounds().getHalfExtents().x : currentZone.getBounds().getHalfExtents().y);
+
+            Vector2f zoneLoc = ZoneManager.worldToZoneSpace(currentLoc, currentZone);
+
+            if (currentZone != null && currentZone.getHeightMap() != null) {
+                float altitude = currentZone.getHeightMap().getInterpolatedTerrainHeight(zoneLoc);
+                float outsetAltitude = HeightMap.getOutsetHeight(altitude, currentZone, pcSender.getLoc());
+            }
+
+        }
+        long end = System.currentTimeMillis();
+
+        long delta = end - start;
+
+        this.throwbackInfo(pcSender, "Audit Heightmap took " + delta + " ms to run " + count + " times!");
+
+
+    }
+
+
+    @Override
+    protected String _getUsageString() {
+        return "' /auditmobs [zone.UUID]'";
+    }
+
+    @Override
+    protected String _getHelpString() {
+        return "Audits all the mobs in a zone.";
+
+    }
+
+}

src/engine/devcmd/cmds/AuditMobsCmd.java

@@ -40,8 +40,8 @@ public class AuditMobsCmd extends AbstractDevCmd {
 
                     if (size >= count) {
                         plusplus++;
-                        throwbackInfo(pcSender, zoneMicro.zoneName + " at location  " + zoneMicro.getLoc().toString() + " has " + size + " mobs. ");
-                        System.out.println(zoneMicro.zoneName + " at location  " + zoneMicro.getLoc().toString() + " has " + size + " mobs. ");
+                        throwbackInfo(pcSender, zoneMicro.getName() + " at location  " + zoneMicro.getLoc().toString() + " has " + size + " mobs. ");
+                        System.out.println(zoneMicro.getName() + " at location  " + zoneMicro.getLoc().toString() + " has " + size + " mobs. ");
                     }
 
 
@@ -80,7 +80,7 @@ public class AuditMobsCmd extends AbstractDevCmd {
         //ConcurrentHashMap<Mob, Long> respawnMap = Mob.getRespawnMap();
         //		ConcurrentHashMap<Mob, Long> despawnMap = Mob.getDespawnMap();
 
-        throwbackInfo(pcSender, zone.zoneName + ", numMobs: " + zone.zoneMobSet.size());
+        throwbackInfo(pcSender, zone.getName() + ", numMobs: " + zone.zoneMobSet.size());
         throwbackInfo(pcSender, "UUID, dbID, inRespawnMap, isAlive, activeAI, Loc");
 
 

src/engine/devcmd/cmds/CreateItemCmd.java

@@ -11,6 +11,7 @@ package engine.devcmd.cmds;
 
 import engine.devcmd.AbstractDevCmd;
 import engine.objects.AbstractGameObject;
+import engine.objects.ItemBase;
 import engine.objects.ItemFactory;
 import engine.objects.PlayerCharacter;
 
@@ -26,20 +27,28 @@ public class CreateItemCmd extends AbstractDevCmd {
     @Override
     protected void _doCmd(PlayerCharacter pc, String[] words,
                           AbstractGameObject target) {
-
         if (words.length < 2) {
             this.sendUsage(pc);
             return;
         }
+        int id;
+        id = ItemBase.getIDByName(words[0]);
 
-        int templateID = Integer.parseInt(words[0]);
+        if (id == 0)
+            id = Integer.parseInt(words[0]);
+        if (id == 7) {
+            this.throwbackInfo(pc, "use /addgold to add gold.....");
+            return;
+        }
 
         int size = 1;
 
-        if (words.length == 2)
+        if (words.length < 3) {
             size = Integer.parseInt(words[1]);
+        }
+
+        ItemFactory.fillInventory(pc, id, size);
 
-        ItemFactory.fillInventory(pc, templateID, size);
     }
 
     @Override
@@ -49,7 +58,7 @@ public class CreateItemCmd extends AbstractDevCmd {
 
     @Override
     protected String _getUsageString() {
-        return "' /createitem <templateID> <quantity>'";
+        return "' /createitem <ItembaseID> <quantity>'";
     }
 
 }

src/engine/devcmd/cmds/GetHeightCmd.java

@@ -9,10 +9,11 @@
 
 package engine.devcmd.cmds;
 
-import engine.InterestManagement.Terrain;
+import engine.InterestManagement.HeightMap;
 import engine.devcmd.AbstractDevCmd;
 import engine.gameManager.ZoneManager;
 import engine.math.Vector2f;
+import engine.math.Vector3fImmutable;
 import engine.objects.AbstractGameObject;
 import engine.objects.PlayerCharacter;
 import engine.objects.Zone;
@@ -21,79 +22,205 @@ public class GetHeightCmd extends AbstractDevCmd {
 
     public GetHeightCmd() {
         super("getHeight");
+        this.addCmdString("height");
     }
 
     @Override
-    protected void _doCmd(PlayerCharacter playerCharacter, String[] words,
+    protected void _doCmd(PlayerCharacter pc, String[] words,
                           AbstractGameObject target) {
 
-        Zone currentZone;
-        Zone parentZone;
-        Zone heightmapZone;
+        boolean end = true;
 
-        currentZone = ZoneManager.findSmallestZone(playerCharacter.getLoc());
-        heightmapZone = Terrain.getNextZoneWithTerrain(currentZone);
-        parentZone = Terrain.getNextZoneWithTerrain(currentZone.parent);
+        float height = HeightMap.getWorldHeight(pc);
 
-        Vector2f childZoneLoc = ZoneManager.worldToTerrainSpace(playerCharacter.getLoc(), heightmapZone);
-        Vector2f childZoneOffset = ZoneManager.worldToZoneOffset(playerCharacter.getLoc(), heightmapZone);
-        Vector2f normalizedOffset = new Vector2f(Math.abs(childZoneOffset.x) / heightmapZone.template.major_radius,
-                Math.abs(childZoneOffset.y) / heightmapZone.template.minor_radius);
-        Vector2f parentZoneLoc = ZoneManager.worldToTerrainSpace(playerCharacter.getLoc(), parentZone);
+        this.throwbackInfo(pc, "Altitude : " + height);
 
-        float childHeight = heightmapZone.terrain.getInterpolatedTerrainHeight(childZoneLoc);
-        childHeight = childHeight + heightmapZone.global_height;
+        this.throwbackInfo(pc, "Character Height: " + pc.getCharacterHeight());
+        this.throwbackInfo(pc, "Character Height to start swimming: " + pc.centerHeight);
 
-        float parentHeight = parentZone.terrain.getInterpolatedTerrainHeight(parentZoneLoc);
-        parentHeight += parentZone.global_height;
+        Zone zone = ZoneManager.findSmallestZone(pc.getLoc());
+        this.throwbackInfo(pc, "Water Level : " + zone.getSeaLevel());
+        this.throwbackInfo(pc, "Character Water Level Above : " + (pc.getCharacterHeight() + height - zone.getSeaLevel()));
 
-        float blendedHeight = Terrain.getWorldHeight(currentZone, playerCharacter.getLoc());
+        if (end)
+            return;
 
-        Vector2f terrainCell = heightmapZone.terrain.getTerrainCell(childZoneLoc);
-        Vector2f cell_offset = new Vector2f(terrainCell.x % 1, terrainCell.y % 1);
+        Vector2f gridSquare;
+        Vector2f gridOffset;
+        Vector2f parentGrid;
+        Vector2f parentLoc = new Vector2f(-1, -1);
 
-        terrainCell.x = (float) Math.floor(terrainCell.x);
-        terrainCell.y = (float) Math.floor(terrainCell.y);
+        Zone currentZone = ZoneManager.findSmallestZone(pc.getLoc());
 
+        if (currentZone == null)
+            return;
 
-        short top_left_pixel = heightmapZone.terrain.terrain_pixel_data[(int) terrainCell.x][(int) terrainCell.y];
-        short top_right_pixel = heightmapZone.terrain.terrain_pixel_data[(int) terrainCell.x + 1][(int) terrainCell.y];
-        short bottom_left_pixel = heightmapZone.terrain.terrain_pixel_data[(int) terrainCell.x][(int) terrainCell.y + 1];
-        short bottom_right_pixel = heightmapZone.terrain.terrain_pixel_data[(int) terrainCell.x + 1][(int) terrainCell.y + 1];
+        Zone parentZone = currentZone.getParent();
 
-        this.throwbackInfo(playerCharacter, "Current Zone : " + currentZone.zoneName);
-        this.throwbackInfo(playerCharacter, "Heightmap Zone : " + heightmapZone.zoneName);
-        this.throwbackInfo(playerCharacter, "Parent Zone: " + parentZone.zoneName);
+        HeightMap heightMap = currentZone.getHeightMap();
 
-        this.throwbackInfo(playerCharacter, "Player loc: " + "[" + playerCharacter.loc.x + "]" + "[" + playerCharacter.loc.y + "]" + "[" + playerCharacter.loc.z + "]");
 
-        this.throwbackInfo(playerCharacter, "Terrain Cell : " + "[" + terrainCell.x + "]" + "[" + terrainCell.y + "]");
-        this.throwbackInfo(playerCharacter, "Cell Offset : " + "[" + cell_offset.x + "]" + "[" + cell_offset.y + "]");
-        this.throwbackInfo(playerCharacter, "Pixels : " + "[" + top_left_pixel + "]" + "[" + top_right_pixel + "]");
-        this.throwbackInfo(playerCharacter, "Pixels : " + "[" + bottom_left_pixel + "]" + "[" + bottom_right_pixel + "]");
+        //find the next parents heightmap if the currentzone heightmap is null.
+        while (heightMap == null) {
 
-        this.throwbackInfo(playerCharacter, "Child Zone Offset: " + "[" + childZoneOffset.x + "]" + "[" + childZoneOffset.y + "]");
-        this.throwbackInfo(playerCharacter, "Normalized offset: " + "[" + normalizedOffset.x + "]" + "[" + normalizedOffset.y + "]");
-        this.throwbackInfo(playerCharacter, "template blend Values: (max/min): " + heightmapZone.template.max_blend + " /" + heightmapZone.template.min_blend);
-        this.throwbackInfo(playerCharacter, "terrain values (max/min): " + heightmapZone.terrain.blend_values.x + " /" + heightmapZone.terrain.blend_values.y);
-        this.throwbackInfo(playerCharacter, "Blend coefficient: " + heightmapZone.terrain.getTerrainBlendCoefficient(childZoneOffset));
+            if (currentZone == ZoneManager.getSeaFloor()) {
+                this.throwbackInfo(pc, "Could not find a heightmap to get height.");
+                break;
+            }
 
-        this.throwbackInfo(playerCharacter, "------------");
+            this.throwbackError(pc, "Heightmap does not exist for " + currentZone.getName());
+            this.throwbackInfo(pc, "Using parent zone instead: ");
+            currentZone = currentZone.getParent();
+            heightMap = currentZone.getHeightMap();
+        }
+
+
+        if ((heightMap == null) || (currentZone == ZoneManager.getSeaFloor())) {
+            this.throwbackInfo(pc, currentZone.getName() + " has no heightmap ");
+            this.throwbackInfo(pc, "Current altitude: " + currentZone.absY);
+            return;
+        }
+
+        Vector2f zoneLoc = ZoneManager.worldToZoneSpace(pc.getLoc(), currentZone);
+
+        Vector3fImmutable seaFloorLocalLoc = ZoneManager.worldToLocal(pc.getLoc(), ZoneManager.getSeaFloor());
+        this.throwbackInfo(pc, "SeaFloor Local : " + seaFloorLocalLoc.x + " , " + seaFloorLocalLoc.y);
+
+
+        this.throwbackInfo(pc, "Local Zone Location : " + zoneLoc.x + " , " + zoneLoc.y);
+        Vector3fImmutable localLocFromCenter = ZoneManager.worldToLocal(pc.getLoc(), currentZone);
+        Vector3fImmutable parentLocFromCenter = ZoneManager.worldToLocal(pc.getLoc(), currentZone.getParent());
+        this.throwbackInfo(pc, "Local Zone Location from center : " + localLocFromCenter);
+        this.throwbackInfo(pc, "parent Zone Location from center : " + parentLocFromCenter);
+
+        Vector2f parentZoneLoc = ZoneManager.worldToZoneSpace(pc.getLoc(), currentZone.getParent());
+        this.throwbackInfo(pc, "Parent Zone Location from Bottom Left : " + parentZoneLoc);
+
+        if ((parentZone != null) && (parentZone.getHeightMap() != null)) {
+            parentLoc = ZoneManager.worldToZoneSpace(pc.getLoc(), parentZone);
+            parentGrid = parentZone.getHeightMap().getGridSquare(parentLoc);
+        } else
+            parentGrid = new Vector2f(-1, -1);
+
+        gridSquare = heightMap.getGridSquare(zoneLoc);
+        gridOffset = HeightMap.getGridOffset(gridSquare);
+
+        float interaltitude = currentZone.getHeightMap().getInterpolatedTerrainHeight(zoneLoc);
+
+        this.throwbackInfo(pc, currentZone.getName());
+        this.throwbackInfo(pc, "Current Grid Square: " + gridSquare.x + " , " + gridSquare.y);
+        this.throwbackInfo(pc, "Grid Offset: " + gridOffset.x + " , " + gridOffset.y);
+        this.throwbackInfo(pc, "Parent Grid: " + parentGrid.x + " , " + parentGrid.y);
+
+        if (parentGrid.x != -1) {
+            float parentAltitude = parentZone.getHeightMap().getInterpolatedTerrainHeight(parentLoc);
+            this.throwbackInfo(pc, "Parent ALTITUDE: " + (parentAltitude));
+            this.throwbackInfo(pc, "Parent Interpolation: " + (parentAltitude + parentZone.getWorldAltitude()));
+        }
+        this.throwbackInfo(pc, "interpolated height: " + interaltitude);
+
+        this.throwbackInfo(pc, "interpolated height with World: " + (interaltitude + currentZone.getWorldAltitude()));
+
+        float realWorldAltitude = interaltitude + currentZone.getWorldAltitude();
+
+        //OUTSET
+        if (parentZone != null) {
+            float parentXRadius = currentZone.getBounds().getHalfExtents().x;
+            float parentZRadius = currentZone.getBounds().getHalfExtents().y;
+
+            float offsetX = Math.abs((localLocFromCenter.x / parentXRadius));
+            float offsetZ = Math.abs((localLocFromCenter.z / parentZRadius));
+
+            float bucketScaleX = 100 / parentXRadius;
+            float bucketScaleZ = 200 / parentZRadius;
+
+            float outsideGridSizeX = 1 - bucketScaleX; //32/256
+            float outsideGridSizeZ = 1 - bucketScaleZ;
+            float weight;
+
+            double scale;
+
+
+            if (offsetX > outsideGridSizeX && offsetX > offsetZ) {
+                weight = (offsetX - outsideGridSizeX) / bucketScaleX;
+                scale = Math.atan2((.5 - weight) * 3.1415927, 1);
+
+                float scaleChild = (float) ((scale + 1) * .5);
+                float scaleParent = 1 - scaleChild;
+
+
+                float parentAltitude = parentZone.getHeightMap().getInterpolatedTerrainHeight(parentLoc);
+                float parentCenterAltitude = parentZone.getHeightMap().getInterpolatedTerrainHeight(ZoneManager.worldToZoneSpace(currentZone.getLoc(), parentZone));
+
+                parentCenterAltitude += currentZone.getYCoord();
+                parentCenterAltitude += interaltitude;
+
+                float firstScale = parentAltitude * scaleParent;
+                float secondScale = parentCenterAltitude * scaleChild;
+                float outsetALt = firstScale + secondScale;
+
+                outsetALt += currentZone.getParent().getAbsY();
+                realWorldAltitude = outsetALt;
+
+            } else if (offsetZ > outsideGridSizeZ) {
+
+                weight = (offsetZ - outsideGridSizeZ) / bucketScaleZ;
+                scale = Math.atan2((.5 - weight) * 3.1415927, 1);
+
+                float scaleChild = (float) ((scale + 1) * .5);
+                float scaleParent = 1 - scaleChild;
+                float parentAltitude = parentZone.getHeightMap().getInterpolatedTerrainHeight(parentLoc);
+                float parentCenterAltitude = parentZone.getHeightMap().getInterpolatedTerrainHeight(ZoneManager.worldToZoneSpace(currentZone.getLoc(), parentZone));
+
+                parentCenterAltitude += currentZone.getYCoord();
+                parentCenterAltitude += interaltitude;
+                float firstScale = parentAltitude * scaleParent;
+                float secondScale = parentCenterAltitude * scaleChild;
+                float outsetALt = firstScale + secondScale;
+
+                outsetALt += currentZone.getParent().getAbsY();
+                realWorldAltitude = outsetALt;
+
+
+            }
+        }
+
+        float strMod = pc.statStrBase - 40;
+
+        strMod *= .00999999998f;
+
+        strMod += 1f;
+
+        float radius = 0;
+        switch (pc.getRaceID()) {
+            case 2017:
+                radius = 3.1415927f;
+            case 2000:
+
+
+        }
+        strMod *= 1.5707964f;
+
+        strMod += 3.1415927f;
+
+        strMod -= .5f;
+
+
+        realWorldAltitude += strMod;
+
+        this.throwbackInfo(pc, "interpolated height with World: " + realWorldAltitude);
 
-        this.throwbackInfo(playerCharacter, "Child Height at loc: " + Math.ceil(childHeight));
-        this.throwbackInfo(playerCharacter, "Parent Height at loc: " + Math.ceil(parentHeight));
-        this.throwbackInfo(playerCharacter, "Blended Height (Ceil): " + blendedHeight + " (" + Math.ceil(blendedHeight) + ")");
 
     }
 
     @Override
     protected String _getHelpString() {
-        return "Queries heightmap engine";
+        return "Temporarily Changes SubRace";
     }
 
     @Override
     protected String _getUsageString() {
-        return "' /getheight";
+        return "' /subrace mobBaseID";
     }
 
 }

src/engine/devcmd/cmds/GetOffsetCmd.java

@@ -48,7 +48,7 @@ public class GetOffsetCmd extends AbstractDevCmd {
         float difY = pcSender.getLoc().y - zone.absY;
         float difZ = pcSender.getLoc().z - zone.absZ;
 
-        throwbackInfo(pcSender, zone.zoneName + ": (x: " + difX + ", y: " + difY + ", z: " + difZ + ')');
+        throwbackInfo(pcSender, zone.getName() + ": (x: " + difX + ", y: " + difY + ", z: " + difZ + ')');
     }
 
     @Override

src/engine/devcmd/cmds/GetZoneCmd.java

@@ -51,7 +51,7 @@ public class GetZoneCmd extends AbstractDevCmd {
         }
 
         for (Zone zone : allIn)
-            throwbackInfo(pcSender, zone.zoneName + "; UUID: " + zone.getObjectUUID() + ", loadNum: " + zone.templateID);
+            throwbackInfo(pcSender, zone.getName() + "; UUID: " + zone.getObjectUUID() + ", loadNum: " + zone.getLoadNum());
     }
 
     @Override

src/engine/devcmd/cmds/GotoCmd.java

@@ -81,7 +81,7 @@ public class GotoCmd extends AbstractDevCmd {
                 continue;
             Zone zone = city.getParent();
             if (zone != null) {
-                if (zone.isNPCCity || zone.guild_zone)
+                if (zone.isNPCCity() || zone.isPlayerCity())
                     loc = Vector3fImmutable.getRandomPointOnCircle(zone.getLoc(), MBServerStatics.TREE_TELEPORT_RADIUS);
                 else
                     loc = zone.getLoc();
@@ -97,10 +97,10 @@ public class GotoCmd extends AbstractDevCmd {
                 Zone zone = (Zone) zoneAgo;
                 if (zone == null)
                     continue;
-                if (!zone.zoneName.equalsIgnoreCase(cityName))
+                if (!zone.getName().equalsIgnoreCase(cityName))
                     continue;
                 if (zone != null) {
-                    if (zone.isNPCCity || zone.guild_zone)
+                    if (zone.isNPCCity() || zone.isPlayerCity())
                         loc = Vector3fImmutable.getRandomPointOnCircle(zone.getLoc(), MBServerStatics.TREE_TELEPORT_RADIUS);
                     else
                         loc = zone.getLoc();

src/engine/devcmd/cmds/HotzoneCmd.java

@@ -40,7 +40,7 @@ public class HotzoneCmd extends AbstractDevCmd {
         String input = data.toString().trim();
 
         if (input.length() == 0) {
-            outString = "Current hotZone: " + ZoneManager.hotZone.zoneName + "\r\n";
+            outString = "Current hotZone: " + ZoneManager.hotZone.getName() + "\r\n";
             outString += "Available hotZones: " + ZoneManager.availableHotZones();
             throwbackInfo(playerCharacter, outString);
             return;
@@ -48,7 +48,7 @@ public class HotzoneCmd extends AbstractDevCmd {
 
         if (input.equalsIgnoreCase("random")) {
             ZoneManager.generateAndSetRandomHotzone();
-            outString = "New hotZone: " + ZoneManager.hotZone.zoneName + "\r\n";
+            outString = "New hotZone: " + ZoneManager.hotZone.getName() + "\r\n";
             outString += "Available hotZones: " + ZoneManager.availableHotZones();
             throwbackInfo(playerCharacter, outString);
             return;

src/engine/devcmd/cmds/InfoCmd.java

@@ -387,7 +387,7 @@ public class InfoCmd extends AbstractDevCmd {
                     output += newline;
                     output += "EquipSet: " + targetNPC.getEquipmentSetID();
                     output += newline;
-                    output += "Parent Zone LoadNum : " + targetNPC.getParentZone().templateID;
+                    output += "Parent Zone LoadNum : " + targetNPC.getParentZone().getLoadNum();
 
                 }
 
@@ -440,9 +440,7 @@ public class InfoCmd extends AbstractDevCmd {
                         output += "isSummonedPet: true";
                     else
                         output += "isSummonedPet: false";
-
-
-                    PlayerCharacter owner = (PlayerCharacter) targetMob.guardCaptain;
+                    PlayerCharacter owner = targetMob.getOwner();
                     if (owner != null)
                         output += "     owner: " + owner.getObjectUUID();
                     output += newline;
@@ -473,7 +471,7 @@ public class InfoCmd extends AbstractDevCmd {
                 output += "EquipSet: " + targetMob.equipmentSetID;
                 output += newline;
                 try {
-                    output += "Parent Zone LoadNum : " + targetMob.getParentZone().templateID;
+                    output += "Parent Zone LoadNum : " + targetMob.getParentZone().getLoadNum();
                 } catch (Exception ex) {
                     //who cares
                 }
@@ -505,17 +503,17 @@ public class InfoCmd extends AbstractDevCmd {
             case Item:  //intentional passthrough
             case MobLoot:
                 Item item = (Item) target;
-                ItemTemplate template = ItemTemplate.templates.get(item.getTemplateID());
-                output += StringUtils.addWS("ItemBase: " + template.template_id, 20);
-                output += "Weight: " + template.item_wt;
+                ItemBase itemBase = item.getItemBase();
+                output += StringUtils.addWS("ItemBase: " + itemBase.getUUID(), 20);
+                output += "Weight: " + itemBase.getWeight();
                 output += newline;
                 DecimalFormat df = new DecimalFormat("###,###,###,###,##0");
                 output += StringUtils.addWS("Qty: "
                         + df.format(item.getNumOfItems()), 20);
-                output += "Charges: " + (byte) item.chargesRemaining
-                        + '/' + item.template.item_initial_charges;
+                output += "Charges: " + item.getChargesRemaining()
+                        + '/' + item.getChargesMax();
                 output += newline;
-                output += "Name: " + template.item_base_name;
+                output += "Name: " + itemBase.getName();
                 output += newline;
                 output += item.getContainerInfo();
 

src/engine/devcmd/cmds/ItemInfoCmd.java

@@ -1,72 +0,0 @@
-// • ▌ ▄ ·.  ▄▄▄·  ▄▄ • ▪   ▄▄· ▄▄▄▄·  ▄▄▄·  ▐▄▄▄  ▄▄▄ .
-// ·██ ▐███▪▐█ ▀█ ▐█ ▀ ▪██ ▐█ ▌▪▐█ ▀█▪▐█ ▀█ •█▌ ▐█▐▌·
-// ▐█ ▌▐▌▐█·▄█▀▀█ ▄█ ▀█▄▐█·██ ▄▄▐█▀▀█▄▄█▀▀█ ▐█▐ ▐▌▐▀▀▀
-// ██ ██▌▐█▌▐█ ▪▐▌▐█▄▪▐█▐█▌▐███▌██▄▪▐█▐█ ▪▐▌██▐ █▌▐█▄▄▌
-// ▀▀  █▪▀▀▀ ▀  ▀ ·▀▀▀▀ ▀▀▀·▀▀▀ ·▀▀▀▀  ▀  ▀ ▀▀  █▪ ▀▀▀
-//      Magicbane Emulator Project © 2013 - 2022
-//                www.magicbane.com
-
-
-package engine.devcmd.cmds;
-
-import engine.Enum;
-import engine.Enum.GameObjectType;
-import engine.devcmd.AbstractDevCmd;
-import engine.objects.AbstractGameObject;
-import engine.objects.Item;
-import engine.objects.PlayerCharacter;
-
-
-/**
- * @author
- */
-public class ItemInfoCmd extends AbstractDevCmd {
-
-    public ItemInfoCmd() {
-        super("iteminfo");
-    }
-
-    @Override
-    protected void _doCmd(PlayerCharacter pc, String[] words,AbstractGameObject target) {
-        if (pc == null) {
-            return;
-        }
-        if(target.getObjectType().equals(GameObjectType.Item) == false){
-            throwbackInfo(pc, "Must Select An Item");
-            return;
-        }
-        Item item = (Item)target;
-        String newline = "\r\n ";
-        String output = "";
-        output += "Required Races:" + newline;
-        for (Enum.MonsterType required : item.template.item_race_req)
-            output += "     " + required.name() + newline;
-        output += "Restricted Races:" + newline;
-        for (Enum.MonsterType required : item.template.item_race_res)
-            output += "     " + required.name() + newline;
-        output += "Required Classes:" + newline;
-        for (Enum.ClassType required : item.template.item_class_req)
-            output += "     " + required.name() + newline;
-        output += "Restricted Classes:" + newline;
-        for (Enum.ClassType required : item.template.item_class_res)
-            output += "     " + required.name() + newline;
-        output += "Required Disciplines:" + newline;
-        for (Enum.DisciplineType required : item.template.item_disc_req)
-            output += "     " + required.name() + newline;
-        output += "Restricted Disciplines:" + newline;
-        for (Enum.DisciplineType required : item.template.item_disc_res)
-            output += "     " + required.name() + newline;
-        throwbackInfo(pc, output);
-    }
-
-    @Override
-    protected String _getHelpString() {
-        return "Gets information on an Object.";
-    }
-
-    @Override
-    protected String _getUsageString() {
-        return "' /iteminfo'";
-    }
-
-}

src/engine/devcmd/cmds/MakeBaneCmd.java

@@ -111,12 +111,12 @@ public class MakeBaneCmd extends AbstractDevCmd {
             return;
         }
 
-        if (!zone.guild_zone) {
+        if (!zone.isPlayerCity()) {
             throwbackError(pc, "This is not a player city.");
             return;
         }
 
-        City city = City.getCity(zone.playerCityUUID);
+        City city = City.getCity(zone.getPlayerCityUUID());
         if (city == null) {
             throwbackError(pc, "Unable to find the city associated with this zone.");
             return;
@@ -167,7 +167,7 @@ public class MakeBaneCmd extends AbstractDevCmd {
             return;
         }
         stone.addEffectBit((1 << 19));
-        BuildingManager.setRank(stone, (byte) rank);
+        stone.setRank((byte) rank);
         stone.setMaxHitPoints(blueprint.getMaxHealth(stone.getRank()));
         stone.setCurrentHitPoints(stone.getMaxHitPoints());
         BuildingManager.setUpgradeDateTime(stone, null, 0);

src/engine/devcmd/cmds/MakeItemCmd.java

@@ -9,6 +9,7 @@
 
 package engine.devcmd.cmds;
 
+import engine.Enum.ItemContainerType;
 import engine.Enum.ItemType;
 import engine.Enum.OwnerType;
 import engine.devcmd.AbstractDevCmd;
@@ -16,6 +17,8 @@ import engine.gameManager.DbManager;
 import engine.objects.*;
 import engine.powers.EffectsBase;
 
+import java.util.ArrayList;
+
 /**
  * @author Eighty
  */
@@ -29,6 +32,48 @@ public class MakeItemCmd extends AbstractDevCmd {
     protected void _doCmd(PlayerCharacter pc, String[] words,
                           AbstractGameObject target) {
 
+        if (words[0].equals("resources")) {
+            for (int ibID : Warehouse.getMaxResources().keySet()) {
+                if (ibID == 7)
+                    continue;
+
+                ItemBase ib = ItemBase.getItemBase(ibID);
+
+                short weight = ib.getWeight();
+                if (!pc.getCharItemManager().hasRoomInventory(weight)) {
+                    throwbackError(pc, "Not enough room in inventory for any more of this item");
+
+                    pc.getCharItemManager().updateInventory();
+                    return;
+                }
+
+                boolean worked = false;
+                Item item = new Item(ib, pc.getObjectUUID(),
+                        OwnerType.PlayerCharacter, (byte) 0, (byte) 0, (short) ib.getDurability(), (short) ib.getDurability(),
+                        true, false, ItemContainerType.INVENTORY, (byte) 0,
+                        new ArrayList<>(), "");
+
+                item.setNumOfItems(Warehouse.getMaxResources().get(ibID));
+
+                try {
+                    item = DbManager.ItemQueries.ADD_ITEM(item);
+                    worked = true;
+                } catch (Exception e) {
+                    throwbackError(pc, "DB error 1: Unable to create item. " + e.getMessage());
+                    return;
+                }
+
+                if (item == null || !worked) {
+                    throwbackError(pc, "DB error 2: Unable to create item.");
+                    return;
+                }
+
+
+                //add item to inventory
+                pc.getCharItemManager().addItemToInventory(item);
+            }
+            return;
+        }
         if (words.length < 3 || words.length > 5) {
             this.sendUsage(pc);
             return;
@@ -58,23 +103,16 @@ public class MakeItemCmd extends AbstractDevCmd {
             numItems = (numItems > 5000) ? 5000 : numItems;
         }
 
-        int templateID;
-        ItemTemplate template;
+        int itembaseID;
         try {
-            templateID = Integer.parseInt(words[0]);
-            template = ItemTemplate.templates.get(words[0].toLowerCase());
-
-            if (template == null) {
+            itembaseID = Integer.parseInt(words[0]);
+        } catch (NumberFormatException e) {
+            itembaseID = ItemBase.getIDByName(words[0].toLowerCase());
+            if (itembaseID == 0) {
                 throwbackError(pc, "Supplied type " + words[0]
                         + " failed to parse to an Integer");
                 return;
             }
-
-            if (template.item_type == ItemType.GOLD) {
-                this.throwbackInfo(pc, "use /addgold to add gold.");
-                return;
-            }
-
         } catch (Exception e) {
             throwbackError(pc,
                     "An unknown exception occurred when trying to use createitem command for type "
@@ -82,6 +120,10 @@ public class MakeItemCmd extends AbstractDevCmd {
             return; // NaN
         }
 
+        if (itembaseID == 7) {
+            this.throwbackInfo(pc, "use /addgold to add gold.");
+            return;
+        }
 
         String prefix = "";
         String suffix = "";
@@ -132,54 +174,57 @@ public class MakeItemCmd extends AbstractDevCmd {
                 return;
             }
         }
-        template = ItemTemplate.templates.get(templateID);
-
-        if (template == null) {
-            throwbackError(pc, "Unable to find template " + templateID);
+        ItemBase ib = ItemBase.getItemBase(itembaseID);
+        if (ib == null) {
+            throwbackError(pc, "Unable to find itembase of ID " + itembaseID);
             return;
         }
 
         if ((numItems > 1)
-                && (template.item_type.equals(ItemType.RESOURCE) == false)
-                && (template.item_type.equals(ItemType.OFFERING)) == false)
+                && (ib.getType().equals(ItemType.RESOURCE) == false)
+                && (ib.getType().equals(ItemType.OFFERING)) == false)
             numItems = 1;
 
         CharacterItemManager cim = pc.getCharItemManager();
-
         if (cim == null) {
             throwbackError(pc, "Unable to find the character item manager for player " + pc.getFirstName() + '.');
             return;
         }
 
-        String result = "";
+        byte charges = (byte) ib.getNumCharges();
+        short dur = (short) ib.getDurability();
 
+        String result = "";
         for (int i = 0; i < quantity; i++) {
-
-            int weight = template.item_wt;
-
+            short weight = ib.getWeight();
             if (!cim.hasRoomInventory(weight)) {
                 throwbackError(pc, "Not enough room in inventory for any more of this item. " + i + " produced.");
-
                 if (i > 0)
                     cim.updateInventory();
-
                 return;
             }
 
-            Item item = new Item(templateID);
-            item.ownerID = pc.getObjectUUID();
-            item.ownerType = OwnerType.PlayerCharacter;
-
+            boolean worked = false;
+            Item item = new Item(ib, pc.getObjectUUID(),
+                    OwnerType.PlayerCharacter, charges, charges, dur, dur,
+                    true, false, ItemContainerType.INVENTORY, (byte) 0,
+                    new ArrayList<>(), "");
             if (numItems > 1)
                 item.setNumOfItems(numItems);
 
             try {
-                item = DbManager.ItemQueries.PERSIST(item);
+                item = DbManager.ItemQueries.ADD_ITEM(item);
+                worked = true;
             } catch (Exception e) {
                 throwbackError(pc, "DB error 1: Unable to create item. " + e.getMessage());
                 return;
             }
 
+            if (item == null || !worked) {
+                throwbackError(pc, "DB error 2: Unable to create item.");
+                return;
+            }
+
             //create prefix
             if (!prefix.isEmpty())
                 item.addPermanentEnchantmentForDev(prefix, 0);
@@ -198,12 +243,12 @@ public class MakeItemCmd extends AbstractDevCmd {
 
     @Override
     protected String _getHelpString() {
-        return "Creates an item of type templateID with a prefix and suffix";
+        return "Creates an item of type 'itembaseID' with a prefix and suffix";
     }
 
     @Override
     protected String _getUsageString() {
-        return "'./makeitem templateID PrefixID SuffixID [quantity] [numResources]'";
+        return "'./makeitem itembaseID PrefixID SuffixID [quantity] [numResources]'";
     }
 
 }

src/engine/devcmd/cmds/PrintBankCmd.java

@@ -50,14 +50,10 @@ public class PrintBankCmd extends AbstractDevCmd {
         CharacterItemManager cim = ((AbstractCharacter) tar).getCharItemManager();
         ArrayList<Item> list = cim.getBank();
         throwbackInfo(pc, "Bank for " + type + ' ' + name + " (" + tar.getObjectUUID() + ')');
-
         for (Item item : list) {
-            ItemTemplate template = ItemTemplate.templates.get(item.getTemplateID());
-            throwbackInfo(pc, "    " + template.item_base_name + ", count: " + item.getNumOfItems());
+            throwbackInfo(pc, "    " + item.getItemBase().getName() + ", count: " + item.getNumOfItems());
         }
-
         Item gold = cim.getGoldBank();
-
         if (gold != null)
             throwbackInfo(pc, "    Gold, count: " + gold.getNumOfItems());
         else

src/engine/devcmd/cmds/PrintBonusesCmd.java

@@ -33,8 +33,7 @@ public class PrintBonusesCmd extends AbstractDevCmd {
             if (target instanceof Item) {
                 type = "Item";
                 tar = (Item) target;
-                ItemTemplate template = ItemTemplate.templates.get(((Item) tar).getTemplateID());
-                name = template.item_base_name;
+                name = ((Item) tar).getItemBase().getName();
             } else if (target instanceof AbstractCharacter) {
                 tar = (AbstractCharacter) target;
                 name = ((AbstractCharacter) tar).getFirstName();

src/engine/devcmd/cmds/PrintEffectsCmd.java

@@ -1,67 +0,0 @@
-// • ▌ ▄ ·.  ▄▄▄·  ▄▄ • ▪   ▄▄· ▄▄▄▄·  ▄▄▄·  ▐▄▄▄  ▄▄▄ .
-// ·██ ▐███▪▐█ ▀█ ▐█ ▀ ▪██ ▐█ ▌▪▐█ ▀█▪▐█ ▀█ •█▌ ▐█▐▌·
-// ▐█ ▌▐▌▐█·▄█▀▀█ ▄█ ▀█▄▐█·██ ▄▄▐█▀▀█▄▄█▀▀█ ▐█▐ ▐▌▐▀▀▀
-// ██ ██▌▐█▌▐█ ▪▐▌▐█▄▪▐█▐█▌▐███▌██▄▪▐█▐█ ▪▐▌██▐ █▌▐█▄▄▌
-// ▀▀  █▪▀▀▀ ▀  ▀ ·▀▀▀▀ ▀▀▀·▀▀▀ ·▀▀▀▀  ▀  ▀ ▀▀  █▪ ▀▀▀
-//      Magicbane Emulator Project © 2013 - 2022
-//                www.magicbane.com
-
-
-package engine.devcmd.cmds;
-
-import engine.devcmd.AbstractDevCmd;
-import engine.objects.*;
-
-import java.util.HashMap;
-
-/**
- *
- */
-
-public class PrintEffectsCmd extends AbstractDevCmd {
-
-    public PrintEffectsCmd() {
-        super("printeffects");
-        //		super("printstats", MBServerStatics.ACCESS_LEVEL_ADMIN);
-    }
-
-    public static ItemBase getWeaponBase(int slot, HashMap<Integer, MobEquipment> equip) {
-        if (equip.containsKey(slot)) {
-            MobEquipment item = equip.get(slot);
-            if (item != null && item.getItemBase() != null) {
-                return item.getItemBase();
-            }
-        }
-        return null;
-    }
-
-    @Override
-    protected void _doCmd(PlayerCharacter pc, String[] words,
-                          AbstractGameObject target) {
-
-        AbstractCharacter tar;
-
-        if (target != null && target instanceof AbstractCharacter) {
-            tar = (AbstractCharacter) target;
-
-            String newline = "\r\n ";
-            String output = "Effects For Character: " + tar.getName() + newline;
-
-            for(String effect : tar.effects.keySet()){
-                output += effect + newline;
-            }
-            throwbackInfo(pc, output);
-        }
-    }
-
-    @Override
-    protected String _getHelpString() {
-        return "Returns the player's current stats";
-    }
-
-    @Override
-    protected String _getUsageString() {
-        return "' /printstats'";
-    }
-
-}

src/engine/devcmd/cmds/PrintEquipCmd.java

@@ -9,7 +9,6 @@
 
 package engine.devcmd.cmds;
 
-import engine.Enum;
 import engine.Enum.GameObjectType;
 import engine.devcmd.AbstractDevCmd;
 import engine.objects.*;
@@ -64,9 +63,9 @@ public class PrintEquipCmd extends AbstractDevCmd {
         if (tar.getObjectType() == GameObjectType.Mob) {
             Mob tarMob = (Mob) tar;
             throwbackInfo(pc, "Equip for " + type + ' ' + name + " (" + tar.getObjectUUID() + ')');
-            for (Enum.EquipSlotType slot : tarMob.getEquip().keySet()) {
+            for (int slot : tarMob.getEquip().keySet()) {
                 MobEquipment equip = tarMob.getEquip().get(slot);
-                throwbackInfo(pc, equip.templateID + "  :  " + equip.template.item_base_name + ", slot: " + slot);
+                throwbackInfo(pc, equip.getItemBase().getUUID() + "  :  " + equip.getItemBase().getName() + ", slot: " + slot);
             }
             return;
         }
@@ -74,20 +73,19 @@ public class PrintEquipCmd extends AbstractDevCmd {
         if (tar.getObjectType() == GameObjectType.NPC) {
             NPC tarMob = (NPC) tar;
             throwbackInfo(pc, "Equip for " + type + ' ' + name + " (" + tar.getObjectUUID() + ')');
-            for (Enum.EquipSlotType slot : tarMob.getEquip().keySet()) {
+            for (int slot : tarMob.getEquip().keySet()) {
                 MobEquipment equip = tarMob.getEquip().get(slot);
-                throwbackInfo(pc, equip.templateID + "  :  " + equip.template.item_base_name + ", slot: " + slot);
+                throwbackInfo(pc, equip.getItemBase().getUUID() + "  :  " + equip.getItemBase().getName() + ", slot: " + slot);
             }
             return;
         }
 
         CharacterItemManager cim = ((AbstractCharacter) tar).getCharItemManager();
-        ConcurrentHashMap<Enum.EquipSlotType, Item> list = cim.getEquipped();
+        ConcurrentHashMap<Integer, Item> list = cim.getEquipped();
         throwbackInfo(pc, "Equip for " + type + ' ' + name + " (" + tar.getObjectUUID() + ')');
-
-        for (Enum.EquipSlotType slot : list.keySet()) {
+        for (Integer slot : list.keySet()) {
             Item item = list.get(slot);
-            throwbackInfo(pc, "    " + item.template.item_base_name + ", slot: " + slot);
+            throwbackInfo(pc, "    " + item.getItemBase().getName() + ", slot: " + slot);
         }
     }
 

src/engine/devcmd/cmds/PrintInventoryCmd.java

@@ -75,18 +75,14 @@ public class PrintInventoryCmd extends AbstractDevCmd {
         int goldCount = 0;
 
         for (Item item : inventory) {
-            ItemTemplate template = ItemTemplate.templates.get(item.templateID);
-
-            if (item.template.item_type.equals(ItemType.GOLD) == false) {
-
+            if (item.getItemBase().getType().equals(ItemType.GOLD) == false) {
                 String chargeInfo = "";
-                int chargeMax = template.item_initial_charges;
-
+                byte chargeMax = item.getChargesMax();
                 if (chargeMax > 0) {
-                    int charges = item.chargesRemaining;
+                    byte charges = item.getChargesRemaining();
                     chargeInfo = " charges: " + charges + '/' + chargeMax;
                 }
-                throwbackInfo(pc, "    " + template.item_base_name + ", count: " + item.getNumOfItems() + chargeInfo);
+                throwbackInfo(pc, "    " + item.getItemBase().getName() + ", count: " + item.getNumOfItems() + chargeInfo);
             } else
                 goldCount += item.getNumOfItems();
         }

src/engine/devcmd/cmds/PrintRunesCmd.java

@@ -1,67 +0,0 @@
-// • ▌ ▄ ·.  ▄▄▄·  ▄▄ • ▪   ▄▄· ▄▄▄▄·  ▄▄▄·  ▐▄▄▄  ▄▄▄ .
-// ·██ ▐███▪▐█ ▀█ ▐█ ▀ ▪██ ▐█ ▌▪▐█ ▀█▪▐█ ▀█ •█▌ ▐█▐▌·
-// ▐█ ▌▐▌▐█·▄█▀▀█ ▄█ ▀█▄▐█·██ ▄▄▐█▀▀█▄▄█▀▀█ ▐█▐ ▐▌▐▀▀▀
-// ██ ██▌▐█▌▐█ ▪▐▌▐█▄▪▐█▐█▌▐███▌██▄▪▐█▐█ ▪▐▌██▐ █▌▐█▄▄▌
-// ▀▀  █▪▀▀▀ ▀  ▀ ·▀▀▀▀ ▀▀▀·▀▀▀ ·▀▀▀▀  ▀  ▀ ▀▀  █▪ ▀▀▀
-//      Magicbane Emulator Project © 2013 - 2022
-//                www.magicbane.com
-
-
-package engine.devcmd.cmds;
-
-import engine.devcmd.AbstractDevCmd;
-import engine.objects.*;
-
-import java.util.HashMap;
-
-/**
- *
- */
-
-public class PrintRunesCmd extends AbstractDevCmd {
-
-    public PrintRunesCmd() {
-        super("printrunes");
-        //		super("printstats", MBServerStatics.ACCESS_LEVEL_ADMIN);
-    }
-
-    public static ItemBase getWeaponBase(int slot, HashMap<Integer, MobEquipment> equip) {
-        if (equip.containsKey(slot)) {
-            MobEquipment item = equip.get(slot);
-            if (item != null && item.getItemBase() != null) {
-                return item.getItemBase();
-            }
-        }
-        return null;
-    }
-
-    @Override
-    protected void _doCmd(PlayerCharacter pc, String[] words,
-                          AbstractGameObject target) {
-
-        AbstractCharacter tar;
-
-        if (target != null && target instanceof AbstractCharacter) {
-            tar = (AbstractCharacter) target;
-
-            String newline = "\r\n ";
-            String output = "Applied Runes For Character: " + ((AbstractCharacter) target).getName() + newline;
-
-            for(CharacterRune rune : ((AbstractCharacter)target).runes){
-                output += rune.getRuneBaseID() + " " + rune.getRuneBase().getName() + newline;
-            }
-            throwbackInfo(pc, output);
-        }
-    }
-
-    @Override
-    protected String _getHelpString() {
-        return "Returns the player's current stats";
-    }
-
-    @Override
-    protected String _getUsageString() {
-        return "' /printstats'";
-    }
-
-}

src/engine/devcmd/cmds/PrintStatsCmd.java

@@ -9,7 +9,6 @@
 
 package engine.devcmd.cmds;
 
-import engine.Enum;
 import engine.devcmd.AbstractDevCmd;
 import engine.objects.*;
 
@@ -23,6 +22,17 @@ public class PrintStatsCmd extends AbstractDevCmd {
 
     public PrintStatsCmd() {
         super("printstats");
+        //		super("printstats", MBServerStatics.ACCESS_LEVEL_ADMIN);
+    }
+
+    public static ItemBase getWeaponBase(int slot, HashMap<Integer, MobEquipment> equip) {
+        if (equip.containsKey(slot)) {
+            MobEquipment item = equip.get(slot);
+            if (item != null && item.getItemBase() != null) {
+                return item.getItemBase();
+            }
+        }
+        return null;
     }
 
     @Override
@@ -86,21 +96,22 @@ public class PrintStatsCmd extends AbstractDevCmd {
         out += "Defense: " + tar.getDefenseRating() + newline;
 
         //get weapons
-        HashMap<Enum.EquipSlotType, MobEquipment> equip = tar.getEquip();
-
-        if(equip != null){
-           if (equip.get(2) != null && !ItemTemplate.isShield(equip.get(2).template)) {
-               //off hand weapon
-               out += "Attack Rating: " + tar.atrHandTwo + newline;
-               out += "Damage: " + tar.minDamageHandTwo + " - " + tar.maxDamageHandTwo + newline;
-               out += "Range: " + tar.rangeHandTwo + newline;
-               out += "Attack Speed: " + tar.speedHandTwo + newline;
-           } else {
-               out += "Attack Rating: " + tar.atrHandOne + newline;
-               out += "Damage: " + tar.minDamageHandOne + " - " + tar.maxDamageHandOne + newline;
-               out += "Range: " + tar.rangeHandOne + newline;
-               out += "Attack Speed: " + tar.speedHandOne + newline;
-            }
+        HashMap<Integer, MobEquipment> equip = tar.getEquip();
+        ItemBase main = null;
+
+        if (equip != null)
+            main = getWeaponBase(1, equip);
+        ItemBase off = null;
+
+        if (equip != null)
+            getWeaponBase(2, equip);
+        if (main == null && off == null) {
+            out += "Main Hand: atr: " + tar.getAtrHandOne() + ", damage: " + tar.getMinDamageHandOne() + " to " + tar.getMaxDamageHandOne() + ", speed: " + tar.getSpeedHandOne() + ", range: 6" + newline;
+        } else {
+            if (main != null)
+                out += "Main Hand: atr: " + tar.getAtrHandOne() + ", damage: " + tar.getMinDamageHandOne() + " to " + tar.getMaxDamageHandOne() + ", speed: " + tar.getSpeedHandOne() + ", range: " + main.getRange() + newline;
+            if (off != null)
+                out += "Main Hand: atr: " + tar.getAtrHandTwo() + ", damage: " + tar.getMinDamageHandTwo() + " to " + tar.getMaxDamageHandTwo() + ", speed: " + tar.getSpeedHandTwo() + ", range: " + off.getRange() + newline;
         }
         out += "isAlive: " + tar.isAlive() + ", Combat: " + tar.isCombat() + newline;
 

src/engine/devcmd/cmds/PrintVaultCmd.java

@@ -50,8 +50,7 @@ public class PrintVaultCmd extends AbstractDevCmd {
         ArrayList<Item> list = cim.getVault();
         throwbackInfo(pc, "Vault for " + type + ' ' + name + " (" + tar.getObjectUUID() + ')');
         for (Item item : list) {
-            ItemTemplate template = ItemTemplate.templates.get(item.getTemplateID());
-            throwbackInfo(pc, "    " + template.item_base_name + ", count: " + item.getNumOfItems());
+            throwbackInfo(pc, "    " + item.getItemBase().getName() + ", count: " + item.getNumOfItems());
         }
         Item gold = cim.getGoldVault();
         if (gold != null)

src/engine/devcmd/cmds/PurgeObjectsCmd.java

@@ -42,7 +42,7 @@ public class PurgeObjectsCmd extends AbstractDevCmd {
 
     private static void PurgeWalls(Zone zone, PlayerCharacter pc) {
 
-        if (!zone.guild_zone)
+        if (!zone.isPlayerCity())
             return;
 
         for (Building building : zone.zoneBuildingSet) {
@@ -59,25 +59,22 @@ public class PurgeObjectsCmd extends AbstractDevCmd {
 
 
                 if (npc != null) {
-                    for (Integer minionUUID : npc.minions) {
-                        Mob mob = Mob.getMob(minionUUID);
+                    for (Mob mob : npc.getSiegeMinionMap().keySet()) {
                         WorldGrid.RemoveWorldObject(mob);
                         WorldGrid.removeObject(mob, pc);
-
+                        //Mob.getRespawnMap().remove(mob);
                         if (mob.getParentZone() != null)
                             mob.getParentZone().zoneMobSet.remove(mob);
                     }
-
                     DbManager.NPCQueries.DELETE_NPC(npc);
                     DbManager.removeFromCache(GameObjectType.NPC,
                             npc.getObjectUUID());
                     WorldGrid.RemoveWorldObject(npc);
                 } else if (mobA != null) {
-                    for (Integer minionUUID : mobA.minions) {
-                        Mob mob = Mob.getMob(minionUUID);
+                    for (Mob mob : mobA.getSiegeMinionMap().keySet()) {
                         WorldGrid.RemoveWorldObject(mob);
                         WorldGrid.removeObject(mob, pc);
-
+                        //Mob.getRespawnMap().remove(mob);
                         if (mob.getParentZone() != null)
                             mob.getParentZone().zoneMobSet.remove(mob);
                     }
@@ -154,11 +151,10 @@ public class PurgeObjectsCmd extends AbstractDevCmd {
 
 
             if (npc != null) {
-                for (Integer minionUUID : npc.minions) {
-                    Mob mob = Mob.getMob(minionUUID);
+                for (Mob mob : npc.getSiegeMinionMap().keySet()) {
                     WorldGrid.RemoveWorldObject(mob);
                     WorldGrid.removeObject(mob, pc);
-
+                    //Mob.getRespawnMap().remove(mob);
                     if (mob.getParentZone() != null)
                         mob.getParentZone().zoneMobSet.remove(mob);
                 }
@@ -167,11 +163,10 @@ public class PurgeObjectsCmd extends AbstractDevCmd {
                         npc.getObjectUUID());
                 WorldGrid.RemoveWorldObject(npc);
             } else if (mobA != null) {
-                for (Integer minionUUID : mobA.minions) {
-                    Mob mob = Mob.getMob(minionUUID);
+                for (Mob mob : mobA.getSiegeMinionMap().keySet()) {
                     WorldGrid.RemoveWorldObject(mob);
                     WorldGrid.removeObject(mob, pc);
-
+                    //Mob.getRespawnMap().remove(mob);
                     if (mob.getParentZone() != null)
                         mob.getParentZone().zoneMobSet.remove(mob);
                 }

src/engine/devcmd/cmds/RealmInfoCmd.java

@@ -60,12 +60,12 @@ public class RealmInfoCmd extends AbstractDevCmd {
         outString += ")";
         outString += newline;
 
-        outString += " Zone: " + serverZone.zoneName;
+        outString += " Zone: " + serverZone.getName();
 
         outString += newline;
 
-        if (serverZone.parent != null)
-            outString += " Parent: " + serverZone.parent.zoneName;
+        if (serverZone.getParent() != null)
+            outString += " Parent: " + serverZone.getParent().getName();
         else
             outString += "Parent: NONE";
 

src/engine/devcmd/cmds/RegionCmd.java

@@ -9,10 +9,9 @@
 
 package engine.devcmd.cmds;
 
-import engine.Enum;
 import engine.devcmd.AbstractDevCmd;
-import engine.gameManager.BuildingManager;
-import engine.objects.*;
+import engine.objects.AbstractGameObject;
+import engine.objects.PlayerCharacter;
 
 import java.lang.reflect.Field;
 
@@ -26,28 +25,42 @@ public class RegionCmd extends AbstractDevCmd {
     protected void _doCmd(PlayerCharacter pc, String[] words,
                           AbstractGameObject target) {
 
-        String newline = "\r\n ";
-        String output;
-        output = "Target Region Information:" + newline;
 
-        Building building = BuildingManager.getBuildingAtLocation(((AbstractCharacter) target).loc);
-        if(building == null){
-            this.throwbackInfo(pc, "No Building At This Location.") ;
-        }
-        Regions region = ((AbstractCharacter)target).region;
-        if (region == null) {
+        if (pc.region == null) {
             this.throwbackInfo(pc, "No Region Found.");
             return;
         }
 
-        if(region != null) {
-            output += "Player Info: " + ((AbstractCharacter) target).getName() + newline;
-            output +=  "Region Building: " + building.getName() + newline;
-            output +=  "Region Height: " + region.lerpY((AbstractCharacter)target) + newline;
-            output +=  "is Stairs: " + region.isStairs() + newline;
-            output += "is Outside: " + region.isOutside();
-            this.throwbackInfo(pc, output);
+
+        String newLine = System.getProperty("line.separator");
+        String result = "";
+        result += (pc.region.getClass().getSimpleName());
+        result += (" {");
+        result += (newLine);
+        Field[] fields = pc.region.getClass().getDeclaredFields();
+
+        //print field names paired with their values
+        for (Field field : fields) {
+            field.setAccessible(true);
+            result += (" ");
+            try {
+
+                if (field.getName().contains("Furniture"))
+                    continue;
+                result += (field.getName());
+                result += (": ");
+                //requires access to private field:
+                result += (field.get(pc.region).toString());
+            } catch (IllegalAccessException ex) {
+                System.out.println(ex);
+            }
+            result.trim();
+            result += (newLine);
         }
+        result += ("}");
+
+        this.throwbackInfo(pc, result.toString());
+
 
     }
 

src/engine/devcmd/cmds/RemoveBaneCmd.java

@@ -34,12 +34,12 @@ public class RemoveBaneCmd extends AbstractDevCmd {
             return;
         }
 
-        if (!zone.guild_zone) {
+        if (!zone.isPlayerCity()) {
             throwbackError(pc, "This is not a player city.");
             return;
         }
 
-        City city = City.getCity(zone.playerCityUUID);
+        City city = City.getCity(zone.getPlayerCityUUID());
         if (city == null) {
             throwbackError(pc, "Unable to find the city associated with this zone.");
             return;

src/engine/devcmd/cmds/RemoveObjectCmd.java

@@ -11,6 +11,7 @@ package engine.devcmd.cmds;
 
 import engine.Enum.BuildingGroup;
 import engine.Enum.DbObjectType;
+import engine.Enum.GameObjectType;
 import engine.InterestManagement.WorldGrid;
 import engine.devcmd.AbstractDevCmd;
 import engine.gameManager.BuildingManager;
@@ -130,23 +131,56 @@ public class RemoveObjectCmd extends AbstractDevCmd {
             building.disableSpire(false);
 
         if ((building.getBlueprint() != null) && (building.getBlueprint().getBuildingGroup() == BuildingGroup.WAREHOUSE)) {
-            City city = City.getCity(building.getParentZone().playerCityUUID);
-
-            DbManager.WarehouseQueries.DELETE_WAREHOUSE(city.warehouse);
-            city.warehouse = null;
-
+            City city = City.getCity(building.getParentZone().getPlayerCityUUID());
+            if (city != null) {
+                city.setWarehouseBuildingID(0);
+            }
+            Warehouse.warehouseByBuildingUUID.remove(building.getObjectUUID());
         }
 
+
         //remove cached shrines.
         if ((building.getBlueprintUUID() != 0)
                 && (building.getBlueprint().getBuildingGroup() == BuildingGroup.SHRINE))
             Shrine.RemoveShrineFromCacheByBuilding(building);
 
-        // Remove hirelings for this building
+        for (AbstractCharacter ac : building.getHirelings().keySet()) {
+            NPC npc = null;
+            Mob mobA = null;
+
+            if (ac.getObjectType() == GameObjectType.NPC)
+                npc = (NPC) ac;
+            else if (ac.getObjectType() == GameObjectType.Mob)
+                mobA = (Mob) ac;
+
+            if (npc != null) {
+                for (Mob mob : npc.getSiegeMinionMap().keySet()) {
+                    WorldGrid.RemoveWorldObject(mob);
+                    WorldGrid.removeObject(mob, pc);
+                    //Mob.getRespawnMap().remove(mob);
+                    if (mob.getParentZone() != null)
+                        mob.getParentZone().zoneMobSet.remove(mob);
+                }
+                DbManager.NPCQueries.DELETE_NPC(npc);
+                DbManager.removeFromCache(npc);
+                WorldGrid.RemoveWorldObject(npc);
+                WorldGrid.removeObject(npc, pc);
+            } else if (mobA != null) {
+                for (Mob mob : mobA.getSiegeMinionMap().keySet()) {
+                    WorldGrid.RemoveWorldObject(mob);
+                    WorldGrid.removeObject(mob, pc);
+                    //Mob.getRespawnMap().remove(mob);
+                    if (mob.getParentZone() != null)
+                        mob.getParentZone().zoneMobSet.remove(mob);
+                }
+                DbManager.MobQueries.DELETE_MOB(mobA);
+                DbManager.removeFromCache(mobA);
+                WorldGrid.RemoveWorldObject(mobA);
+                WorldGrid.removeObject(mobA, pc);
+            }
 
-        for (AbstractCharacter abstractCharacter : building.getHirelings().keySet())
-            BuildingManager.removeHireling(building, abstractCharacter);
 
+        }
         Zone zone = building.getParentZone();
         DbManager.BuildingQueries.DELETE_FROM_DATABASE(building);
         DbManager.removeFromCache(building);
@@ -175,13 +209,11 @@ public class RemoveObjectCmd extends AbstractDevCmd {
         if (npc.building != null)
             npc.building.getHirelings().remove(npc);
 
-        for (Integer minionUUID : npc.minions) {
-            Mob minionMob = Mob.getMob(minionUUID);
-            WorldGrid.RemoveWorldObject(minionMob);
-            WorldGrid.removeObject(minionMob, pc);
-
-            if (minionMob.getParentZone() != null)
-                minionMob.getParentZone().zoneMobSet.remove(minionMob);
+        for (Mob mob : npc.getSiegeMinionMap().keySet()) {
+            WorldGrid.RemoveWorldObject(mob);
+            WorldGrid.removeObject(mob, pc);
+            if (mob.getParentZone() != null)
+                mob.getParentZone().zoneMobSet.remove(mob);
         }
 
         DbManager.NPCQueries.DELETE_NPC(npc);

src/engine/devcmd/cmds/SetBaneActiveCmd.java

@@ -41,12 +41,12 @@ public class SetBaneActiveCmd extends AbstractDevCmd {
             return;
         }
 
-        if (!zone.guild_zone) {
+        if (!zone.isPlayerCity()) {
             throwbackError(pc, "This is not a player city.");
             return;
         }
 
-        City city = City.getCity(zone.playerCityUUID);
+        City city = City.getCity(zone.getPlayerCityUUID());
         if (city == null) {
             throwbackError(pc, "Unable to find the city associated with this zone.");
             return;

src/engine/devcmd/cmds/SetForceRenameCityCmd.java

@@ -31,9 +31,9 @@ public class SetForceRenameCityCmd extends AbstractDevCmd {
         if (zone == null)
             return;
         boolean rename = words[0].equalsIgnoreCase("true") ? true : false;
-        if (zone.playerCityUUID == 0)
+        if (zone.getPlayerCityUUID() == 0)
             return;
-        City city = City.getCity(zone.playerCityUUID);
+        City city = City.getCity(zone.getPlayerCityUUID());
         if (city == null)
             return;
         city.setForceRename(rename);

src/engine/devcmd/cmds/SetRankCmd.java

@@ -57,7 +57,7 @@ public class SetRankCmd extends AbstractDevCmd {
                     Blueprint blueprint = targetBuilding.getBlueprint();
 
                     if (blueprint == null) {
-                        BuildingManager.setRank(targetBuilding, targetRank);
+                        targetBuilding.setRank(targetRank);
                         ChatManager.chatSayInfo(player, "Building ranked without blueprint" + targetBuilding.getObjectUUID());
                         return;
                     }
@@ -68,8 +68,9 @@ public class SetRankCmd extends AbstractDevCmd {
                     }
 
                     // Set the current targetRank
+                    int lastMeshID = targetBuilding.getMeshUUID();
+                    targetBuilding.setRank(targetRank);
 
-                    BuildingManager.setRank(targetBuilding, targetRank);
                     ChatManager.chatSayInfo(player, "Rank set for building with ID " + targetBuilding.getObjectUUID() + " to rank " + targetRank);
                     break;
                 case NPC:
@@ -113,7 +114,7 @@ public class SetRankCmd extends AbstractDevCmd {
 
             // Set the current targetRank
             int lastMeshID = targetBuilding.getMeshUUID();
-            BuildingManager.setRank(targetBuilding, targetRank);
+            targetBuilding.setRank(targetRank);
 
             if (lastMeshID != targetBuilding.getMeshUUID())
                 targetBuilding.refresh(true);

src/engine/devcmd/cmds/SetSubRaceCmd.java

@@ -67,6 +67,119 @@ public class SetSubRaceCmd extends AbstractDevCmd {
         building.removeAllVisualEffects();
         building.addEffectBit(1 << Integer.parseInt(words[0]));
         building.updateEffects();
+        //63535 38751
+        //		Zone zone = ZoneManager.findSmallestZone(pc.getLoc());
+        //		//CityZoneMsg czm = new CityZoneMsg(3, zone.getLoc().x, zone.getLoc().y, zone.getLoc().z, "balls", zone, 0, 0);
+        //		pc.getClientConnection().sendMsg(new DeleteItemMsg(zone.getObjectType().ordinal(), zone.getObjectUUID()));
+
+        //		UpdateInventoryMsg updateInventoryMsg = new UpdateInventoryMsg(new ArrayList<>(), new ArrayList<>(), null, true);
+        //		pc.getClientConnection().sendMsg(updateInventoryMsg);
+
+        //pc.getCharItemManager().updateInventory();
+
+
+        //		Mob mob = (Mob)target;
+        //
+        //		if (mob == null)
+        //			return;
+        //
+        //		MobLoot mobLoot = new MobLoot(mob, ItemBase.getItemBase(Integer.parseInt(words[0])), false);
+        //
+        //		mob.getCharItemManager().addItemToInventory(mobLoot);
+
+
+        //		if (target.getObjectType() != GameObjectType.Building)
+        //			return;
+        //
+        //		Building warehouseBuilding = (Building)target;
+        //
+        //		if (Warehouse.warehouseByBuildingUUID.get(warehouseBuilding.getObjectUUID()) == null)
+        //			return;
+        //
+        //		Warehouse warehouse = Warehouse.warehouseByBuildingUUID.get(warehouseBuilding.getObjectUUID());
+        //
+        //		for (int ibID: Warehouse.getMaxResources().keySet()){
+        //			ItemBase ib = ItemBase.getItemBase(ibID);
+        //			warehouse.depositFromMine(null, ib, Warehouse.getMaxResources().get(ibID));
+        //		}
+
+
+        //		int raceID = Integer.parseInt(words[0]);
+        //
+        //		UpdateCharOrMobMessage ucm = new UpdateCharOrMobMessage(pc, raceID);
+        //
+        //		pc.getClientConnection().sendMsg(ucm);
+
+        //		LoadCharacterMsg lcm = new LoadCharacterMsg((AbstractCharacter)null,false);
+        //		try {
+        //			DispatchMessage.sendToAllInRange(pc, lcm);
+        //		} catch (MsgSendException e) {
+        //			// TODO Auto-generated catch block
+        //			e.printStackTrace();
+        //		}
+        //		ModifyHealthMsg mhm =new ModifyHealthMsg(pc, pc, -50f, 0f, 0f, 0, null, 9999, 0);
+        //		mhm.setOmitFromChat(1);
+        //		pc.getClientConnection().sendMsg(mhm);
+        //
+        //		int temp = 0;
+        //		boolean start = false;
+        //
+        //		for (EffectsBase eb: EffectsBase.getAllEffectsBase()){
+        //
+        //
+        //
+        //			if (!pc.getClientConnection().isConnected()){
+        //				Logger.info("", "PLAYER DC!" + eb.getIDString());
+        //				break;
+        //			}
+        //
+        //			eb = PowersManager.getEffectByIDString("WLR-018A");
+        //
+        //
+        //			NoTimeJob ntj = new NoTimeJob(pc, "NONE", eb, 40);
+        //			pc.addEffect(String.valueOf(eb.getUUID()), 1000, ntj, eb, 40);
+        //			eb.sendEffectNoPower(ntj, 1000, pc.getClientConnection());
+        //
+        //			ThreadUtils.sleep(500);
+        //			pc.clearEffects();
+        //
+        //			//WorldServer.updateObject((AbstractWorldObject)target, pc);
+        //			this.throwbackInfo(pc, eb.getIDString());
+        //			break;
+        //			//ThreadUtils.sleep(500);
+        //
+        //		}
+
+
+        //		for (EffectsBase eb : EffectsBase.getAllEffectsBase()){
+        //			if (eb.getToken() == 0)
+        //				continue;
+        //			int token = eb.getToken();
+        //			ApplyEffectMsg pum = new ApplyEffectMsg();
+        //			pum.setEffectID(token);
+        //			pum.setSourceType(pc.getObjectType().ordinal());
+        //			pum.setSourceID(pc.getObjectUUID());
+        //			pum.setTargetType(pc.getObjectType().ordinal());
+        //			pum.setTargetID(pc.getObjectUUID());
+        //			pum.setNumTrains(40);
+        //			pum.setDuration(-1);
+        ////			pum.setDuration((pb.isChant()) ? (int)pb.getChantDuration() : ab.getDurationInSeconds(trains));
+        //			pum.setPowerUsedID(0);
+        //		//	pum.setPowerUsedName("Inflict Poison");
+        //			this.throwbackInfo(pc, eb.getName() + "Token = " + eb.getToken());
+        //			pc.getClientConnection().sendMsg(pum);
+        //			ThreadUtils.sleep(200);
+        //		}
+        //
+
+        //		 UpdateObjectMsg uom = new UpdateObjectMsg(pc, 4);
+        //         try {
+        //             Location.sendToAllInRange(pc, uom);
+        //         } catch (MsgSendException e) {
+        //             // TODO Auto-generated catch block
+        //             e.printStackTrace();
+        //         }
+
 
     }
 

src/engine/devcmd/cmds/SimulateBootyCmd.java

@@ -33,11 +33,10 @@ public class SimulateBootyCmd extends AbstractDevCmd {
 
         if (mob.bootySet != 0) {
             for (BootySetEntry entry : LootManager._bootySetMap.get(mob.bootySet)) {
-
-                ItemTemplate template = ItemTemplate.templates.get(entry.templateID);
-
-                if (template != null)
-                    output += "[" + entry.bootyType + "] " + template.item_base_name + " [Chance] " + entry.dropChance + newline;
+                ItemBase item = ItemBase.getItemBase(entry.itemBase);
+                if (item != null) {
+                    output += "[" + entry.bootyType + "] " + item.getName() + " [Chance] " + entry.dropChance + newline;
+                }
             }
         }
 
@@ -57,8 +56,8 @@ public class SimulateBootyCmd extends AbstractDevCmd {
             try {
                 mob.loadInventory();
                 for (Item lootItem : mob.getCharItemManager().getInventory()) {
-                    switch (lootItem.template.item_type) {
-                        case EMPLOYMENTCONTRACT: //CONTRACT
+                    switch (lootItem.getItemBase().getType()) {
+                        case CONTRACT: //CONTRACT
                             Contracts.add(lootItem);
                             break;
                         case OFFERING: //OFFERING
@@ -71,7 +70,7 @@ public class SimulateBootyCmd extends AbstractDevCmd {
                             Runes.add(lootItem);
                             break;
                         case WEAPON: //WEAPON
-                            if (lootItem.getName().toUpperCase().contains("GLASS"))
+                            if (lootItem.getItemBase().isGlass())
                                 GlassItems.add(lootItem);
                             else
                                 OtherDrops.add(lootItem);
@@ -99,7 +98,7 @@ public class SimulateBootyCmd extends AbstractDevCmd {
                     if (equipmentRoll > (dropChance))
                         continue;
 
-                    MobLoot ml = new MobLoot(mob, me.template, false);
+                    MobLoot ml = new MobLoot(mob, me.getItemBase(), false);
 
                     if (ml != null)
                         EquipmentDrops.add(ml);

src/engine/devcmd/cmds/SlotNpcCmd.java

@@ -53,7 +53,7 @@ public class SlotNpcCmd extends AbstractDevCmd {
         if (stringIndex == -1)
             return false;
 
-        // Validate we have a correct building group name
+        // Validate we have a corrent building group name
 
         for (BuildingGroup group : BuildingGroup.values()) {
             if (group.name().equals(userInput[0].toUpperCase()))
@@ -114,7 +114,8 @@ public class SlotNpcCmd extends AbstractDevCmd {
 
                 if (!DbManager.ContractQueries.updateAllowedBuildings(contract, contract.getAllowedBuildings().toLong())) {
                     Logger.error("Failed to update Database for Contract Allowed buildings");
-                    ChatManager.chatSystemError(pc, "Failed to update Database for Contract Allowed buildings. ");
+                    ChatManager.chatSystemError(pc, "Failed to update Database for Contract Allowed buildings. " +
+                            "Contact A CCR, oh wait, you are a CCR. You're Fubared.");
                     return;
                 }
 
@@ -124,7 +125,8 @@ public class SlotNpcCmd extends AbstractDevCmd {
                 contract.getAllowedBuildings().remove(buildingGroup);
                 if (!DbManager.ContractQueries.updateAllowedBuildings(contract, contract.getAllowedBuildings().toLong())) {
                     Logger.error("Failed to update Database for Contract Allowed buildings");
-                    ChatManager.chatSystemError(pc, "Failed to update Database for Contract Allowed buildings. ");
+                    ChatManager.chatSystemError(pc, "Failed to update Database for Contract Allowed buildings. " +
+                            "Contact A CCR, oh wait, you are a CCR. You're Fubared.");
                     return;
                 }
 
@@ -136,14 +138,14 @@ public class SlotNpcCmd extends AbstractDevCmd {
 
     @Override
     protected String _getHelpString() {
-        return "Toggles a building group on a targeted npc";
+        return "Sets a building slot on a targeted npc";
     }
 
     // Class methods
 
     @Override
     protected String _getUsageString() {
-        String usage = "/npcslot [BuildingGroup] on-off \n";
+        String usage = "/npcslot [BuildingType] on-off \n";
 
         for (BuildingGroup group : BuildingGroup.values()) {
             usage += group.name() + ' ';

src/engine/devcmd/cmds/SplatMobCmd.java

@@ -1,6 +1,5 @@
 package engine.devcmd.cmds;
 
-import engine.Enum;
 import engine.devcmd.AbstractDevCmd;
 import engine.gameManager.ZoneManager;
 import engine.math.Vector3fImmutable;
@@ -111,7 +110,7 @@ public class SplatMobCmd extends AbstractDevCmd {
 
                 mobile = Mob.createMob(_mobileUUID,
                         Vector3fImmutable.getRandomPointInCircle(_currentLocation, _targetRange),
-                        null, serverZone, null, null, "", 1, Enum.AIAgentType.MOBILE);
+                        null, true, serverZone, null, 0, "", 1);
 
                 if (mobile != null) {
                     mobile.updateDatabase();

src/engine/devcmd/cmds/SummonCmd.java

@@ -40,7 +40,7 @@ public class SummonCmd extends AbstractDevCmd {
                 Zone zone = ZoneManager.findSmallestZone(pc.getLoc());
                 String location = "Somewhere";
                 if (zone != null)
-                    location = zone.zoneName;
+                    location = zone.getName();
                 RecvSummonsRequestMsg rsrm = new RecvSummonsRequestMsg(pc.getObjectType().ordinal(), pc.getObjectUUID(), pc.getFirstName(),
                         location, false);
                 toSummon.getClientConnection().sendMsg(rsrm);

src/engine/devcmd/cmds/ZoneInfoCmd.java

@@ -73,41 +73,44 @@ public class ZoneInfoCmd extends AbstractDevCmd {
         output = "Target Information:" + newline;
         output += StringUtils.addWS("UUID: " + objectUUID, 20);
         output += newline;
-        output += "name: " + zone.zoneName;
+        output += "name: " + zone.getName();
         output += newline;
-        output += "loadNum: " + zone.templateID;
-        if (zone.parent != null) {
-            output += StringUtils.addWS(", parent: " + zone.parent.getObjectUUID(), 30);
-            output += "Parentabs: x: " + zone.parent.absX + ", y: " + zone.parent.absY + ", z: " + zone.parent.absZ;
+        output += "loadNum: " + zone.getLoadNum();
+        if (zone.getParent() != null) {
+            output += StringUtils.addWS(", parent: " + zone.getParent().getObjectUUID(), 30);
+            output += "Parentabs: x: " + zone.getParent().getAbsX() + ", y: " + zone.getParent().getAbsY() + ", z: " + zone.getParent().getAbsZ();
 
         } else
             output += StringUtils.addWS(", parent: none", 30);
         output += newline;
-        output += "absLoc: x: " + zone.absX + ", y: " + zone.absY + ", z: " + zone.absZ;
+        output += "absLoc: x: " + zone.getAbsX() + ", y: " + zone.getAbsY() + ", z: " + zone.getAbsZ();
         output += newline;
-        output += "offset: x: " + zone.xOffset + ", y: " + zone.yOffset + ", z: " + zone.zOffset;
+        output += "offset: x: " + zone.getXCoord() + ", y: " + zone.getYCoord() + ", z: " + zone.getZCoord();
         output += newline;
-        output += "radius: x: " + zone.bounds.getHalfExtents().x + ", z: " + zone.bounds.getHalfExtents().y;
+        output += "radius: x: " + zone.getBounds().getHalfExtents().x + ", z: " + zone.getBounds().getHalfExtents().y;
         output += newline;
 
-        if (zone.terrain != null) {
-            output += "Terrain image: " + zone.template.terrain_image;
+        if (zone.getHeightMap() != null) {
+            output += "HeightMap ID: " + zone.getHeightMap().getHeightMapID();
             output += newline;
-        }
+            output += "Bucket Width X : " + zone.getHeightMap().getBucketWidthX();
+            output += newline;
+            output += "Bucket Width Y : " + zone.getHeightMap().getBucketWidthY();
 
-        output += "radius: x: " + zone.bounds.getHalfExtents().x + ", z: " + zone.bounds.getHalfExtents().y;
+        }
+        output += "radius: x: " + zone.getBounds().getHalfExtents().x + ", z: " + zone.getBounds().getHalfExtents().y;
         output += newline;
         //		output += "minLvl = " + zone.getMinLvl() + " | maxLvl = " + zone.getMaxLvl();
         output += newline;
-        output += "Sea Level = " + zone.sea_level;
+        output += "Sea Level = " + zone.getSeaLevel();
         output += newline;
-        output += "World Altitude = " + zone.global_height;
+        output += "World Altitude = " + zone.getWorldAltitude();
         throwbackInfo(player, output);
 
         City city = ZoneManager.getCityAtLocation(player.getLoc());
 
         output += newline;
-        output += (city == null) ? "None" : city.getParent().zoneName;
+        output += (city == null) ? "None" : city.getParent().getName();
 
         if (city != null) {
 
@@ -120,14 +123,14 @@ public class ZoneInfoCmd extends AbstractDevCmd {
         } else {
             output = "children:";
 
-            ArrayList<Zone> nodes = zone.nodes;
+            ArrayList<Zone> nodes = zone.getNodes();
 
             if (nodes.isEmpty())
                 output += " none";
 
             for (Zone child : nodes) {
                 output += newline;
-                output += child.zoneName + " (" + child.templateID + ')';
+                output += child.getName() + " (" + child.getLoadNum() + ')';
             }
         }
         throwbackInfo(player, output);

src/engine/devcmd/cmds/ZoneSetCmd.java

@@ -40,7 +40,7 @@ public class ZoneSetCmd extends AbstractDevCmd {
 
         zone = ZoneManager.findSmallestZone(playerCharacter.getLoc());
 
-        throwbackInfo(playerCharacter, zone.zoneName + " (" + zone.templateID + ") " + zone.getObjectUUID());
+        throwbackInfo(playerCharacter, zone.getName() + " (" + zone.getLoadNum() + ") " + zone.getObjectUUID());
 
         // NPC
 

src/engine/devcmd/cmds/aiInfoCmd.java

@@ -9,17 +9,12 @@
 
 package engine.devcmd.cmds;
 
-import engine.Enum;
 import engine.Enum.GameObjectType;
 import engine.devcmd.AbstractDevCmd;
-import engine.gameManager.PowersManager;
-import engine.mobileAI.MobAI;
 import engine.objects.AbstractGameObject;
 import engine.objects.Mob;
 import engine.objects.PlayerCharacter;
-import engine.powers.RunePowerEntry;
 
-import java.util.ArrayList;
 import java.util.Map;
 
 
@@ -61,95 +56,36 @@ public class aiInfoCmd extends AbstractDevCmd {
         Mob mob = (Mob) target;
         output = "Mob AI Information:" + newline;
         output += mob.getName() + newline;
-        output += mob.agentType.toString() + newline;
-
-        int contractID = 0;
-
-        if (mob.isPlayerGuard() == true) {
-
-            if (mob.agentType.equals(Enum.AIAgentType.GUARDMINION))
-                contractID = mob.guardCaptain.contract.getContractID();
-            else
-                contractID = mob.contract.getContractID();
-        }
-
-        if (contractID != 0) {
-
-            if (mob.agentType.equals(Enum.AIAgentType.GUARDMINION)) {
-                output += "Captain Contract: " + contractID + newline;
-                output += "Captain UUID: " + mob.guardCaptain.getObjectUUID() + newline;
-            } else
-                output += "Contract: " + contractID + newline;
-        }
-
-        if (mob.behaviourType != null) {
-            output += "BehaviourType: " + mob.behaviourType.toString() + newline;
-            if (mob.behaviourType.BehaviourHelperType != null) {
-                output += "Behaviour Helper Type: " + mob.behaviourType.BehaviourHelperType.toString() + newline;
+        if (mob.BehaviourType != null) {
+            output += "BehaviourType: " + mob.BehaviourType.toString() + newline;
+            if (mob.BehaviourType.BehaviourHelperType != null) {
+                output += "Behaviour Helper Type: " + mob.BehaviourType.BehaviourHelperType.toString() + newline;
             } else {
                 output += "Behaviour Helper Type: NULL" + newline;
-            }
-            output += "Wimpy: " + mob.behaviourType.isWimpy + newline;
-            output += "Agressive: " + mob.behaviourType.isAgressive + newline;
-            output += "Can Roam: " + mob.behaviourType.canRoam + newline;
-            output += "Calls For Help: " + mob.behaviourType.callsForHelp + newline;
-            output += "Responds To Call For Help: " + mob.behaviourType.respondsToCallForHelp + newline;
-        } else {
-            output += "BehaviourType: NULL" + newline;
+                }
+                output += "Wimpy: " + mob.BehaviourType.isWimpy + newline;
+                output += "Agressive: " + mob.BehaviourType.isAgressive + newline;
+                output += "Can Roam: " + mob.BehaviourType.canRoam + newline;
+                output += "Calls For Help: " + mob.BehaviourType.callsForHelp + newline;
+                output += "Responds To Call For Help: " + mob.BehaviourType.respondsToCallForHelp + newline;
+            } else {
+                output += "BehaviourType: NULL" + newline;
             }
             output += "Aggro Range: " + mob.getAggroRange() + newline;
             output += "Player Aggro Map Size: " + mob.playerAgroMap.size() + newline;
         if (mob.playerAgroMap.size() > 0) {
             output += "Players Loaded:" + newline;
         }
-        for (Map.Entry<Integer, Float> entry : mob.playerAgroMap.entrySet()) {
-            output += "Player ID: " + entry.getKey() + " Hate Value: " + entry.getValue() + newline;
+        for (Map.Entry<Integer, Boolean> entry : mob.playerAgroMap.entrySet()) {
+            output += "Player ID: " + entry.getKey() + " Hate Value: " + (PlayerCharacter.getPlayerCharacter(entry.getKey())).getHateValue() + newline;
         }
         if (mob.getCombatTarget() != null)
             output += "Current Target: " + mob.getCombatTarget().getName() + newline;
         else
             output += "Current Target: NULL" + newline;
 
-        if (mob.guardedCity != null)
-            output += "Patrolling: " + mob.guardedCity.getCityName() + newline;
-        output += "See Invis Level: "  + mob.mobBase.getSeeInvis() + newline;
-        output += "Can Cast: " + MobAI.canCast(mob) + newline;
-        output += "Powers:" + newline;
-
-        ArrayList<RunePowerEntry> powerEntries = new ArrayList<>(PowersManager.getPowersForRune(mob.getMobBaseID()));
-
-        // Additional powers may come from the contract ID.  This is to support
-        // powers for player guards irrespective of the mobbase used.
-
-        if (mob.isPlayerGuard()) {
-
-            ArrayList<RunePowerEntry> contractEntries = new ArrayList<>();
-
-            if (mob.contract != null)
-                contractEntries = new ArrayList<>(PowersManager.getPowersForRune(mob.contractUUID));
-
-            if (mob.agentType.equals(Enum.AIAgentType.GUARDMINION))
-                contractEntries = new ArrayList<>(PowersManager.getPowersForRune(mob.guardCaptain.contractUUID));
-
-            powerEntries.addAll(contractEntries);
-
-        }
-
-        for (RunePowerEntry runePowerEntry : powerEntries)
-            output += PowersManager.getPowerByToken(runePowerEntry.token).getName() + newline;
-
-        // List outlaws defined for this player guard's city
-
-        if (mob.isPlayerGuard()) {
-
-            ArrayList<Integer> outlaws = new ArrayList(mob.guardedCity.cityOutlaws);
-
-            if (outlaws.isEmpty() == false)
-                output += "Outlaws: " + newline;
-
-            for (Integer outlawUUID : outlaws)
-                output += outlawUUID + newline;
-        }
+        for (int token : mob.mobPowers.keySet())
+            output += token + newline;
 
         throwbackInfo(playerCharacter, output);
     }

src/engine/documentation/Handler Specific Documentation/dbAccountHandler_Documentation.md

@@ -0,0 +1,87 @@
+# Account Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbAccountHandler` class. The account handler manages user authentication and account-related data in the Magicbane emulator system.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbAccountHandler.java`
+**Class:** `dbAccountHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Account Table
+- **Table Name:** `obj_account`
+- **Description:** Core account information including login credentials, status, and account details
+- **Columns:** 
+  - UID (Primary Key)
+  - username
+  - password
+  - email
+  - accountStatus
+  - lastLogin
+  - creationDate
+  - isBanned
+  - banReason
+  - isDeleted
+  - deletedDate
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `obj_account_wipe` | Account wipe history records | AccountID → obj_account.UID |
+| `dyn_login_history` | Login attempt and session history | AccountID → obj_account.UID |
+
+## Key Queries
+
+### Get Account by ID
+```sql
+SELECT * FROM `obj_account` WHERE `UID`=?
+```
+**File:** `dbAccountHandler.java`, Line ~60
+
+### Get Account by Username
+```sql
+SELECT * FROM `obj_account` WHERE `username`=?
+```
+**File:** `dbAccountHandler.java`, Line ~85
+
+### Create New Account
+```sql
+INSERT INTO `obj_account` (`username`, `password`, `email`, `accountStatus`, `creationDate`) VALUES (?, ?, ?, ?, ?)
+```
+**File:** `dbAccountHandler.java`, Line ~105
+
+### Update Account Status
+```sql
+UPDATE `obj_account` SET `accountStatus`=?, `lastLogin`=? WHERE `UID`=?
+```
+**File:** `dbAccountHandler.java`, Line ~132
+
+### Check Username Availability
+```sql
+SELECT `username` FROM `obj_account` WHERE `username`=?
+```
+**File:** `dbAccountHandler.java`, Line ~158
+
+## Relationships
+
+1. **Account to Character:** One-to-many (via `obj_character.accountID` field)
+2. **Account to Account Wipe History:** One-to-many (via `obj_account_wipe.AccountID`)
+3. **Account to Login History:** One-to-many (via `dyn_login_history.AccountID`)
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `username` | `obj_account.username` | Unique account username |
+| `password` | `obj_account.password` | Encrypted password |
+| `email` | `obj_account.email` | Account email address |
+| `accountStatus` | `obj_account.accountStatus` | Current account status |
+| `lastLogin` | `obj_account.lastLogin` | Timestamp of last login |
+| `creationDate` | `obj_account.creationDate` | Account creation date |
+| `isBanned` | `obj_account.isBanned` | Boolean flag for banned status |
+| `banReason` | `obj_account.banReason` | Reason for ban |
+| `isDeleted` | `obj_account.isDeleted` | Boolean flag for deleted status |
+| `deletedDate` | `obj_account.deletedDate` | Timestamp of deletion |

src/engine/documentation/Handler Specific Documentation/dbBaneHandler_Documentation.md

@@ -0,0 +1,63 @@
+# dbBaneHandler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbBaneHandler` class. The bane handler manages special objects in cities that have specific properties and behaviors, including their ownership, location, and time-based effects.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbBaneHandler.java`
+**Class:** `dbBaneHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Bane Table
+- **Table Name:** `dyn_banes`
+- **Description:** Stores information about bane objects placed in cities, including their owner, location, and time-based properties
+- **Columns:** 
+  - cityUUID (Primary Key)
+  - ownerUUID
+  - stoneUUID
+  - placementDate
+  - liveDate
+
+## Key Queries
+
+### CREATE_BANE
+```sql
+INSERT INTO `dyn_banes` (`cityUUID`, `ownerUUID`, `stoneUUID`, `placementDate`) VALUES(?,?,?,?)
+```
+**File:** `dbBaneHandler.java`, Line ~17
+
+### LOAD_BANE
+```sql
+SELECT * FROM `dyn_banes` WHERE `dyn_banes`.`cityUUID` = ?
+```
+**File:** `dbBaneHandler.java`, Line ~30
+
+### SET_BANE_TIME
+```sql
+UPDATE `dyn_banes` SET `liveDate`=? WHERE `cityUUID`=?
+```
+**File:** `dbBaneHandler.java`, Line ~45
+
+### REMOVE_BANE
+```sql
+DELETE FROM `dyn_banes` WHERE `cityUUID` = ?
+```
+**File:** `dbBaneHandler.java`, Line ~57
+
+## Relationships
+
+1. **Bane to City:** One-to-one relationship via cityUUID (primary key) referencing obj_city.UID
+2. **Bane to Owner:** Many-to-one relationship via ownerUUID referencing obj_character.UID
+3. **Bane to Stone:** Many-to-one relationship via stoneUUID referencing obj_building.UID
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `cityUUID` | `dyn_banes.cityUUID` | Unique identifier for the city where bane is placed |
+| `ownerUUID` | `dyn_banes.ownerUUID` | Character UID of the owner of this bane |
+| `stoneUUID` | `dyn_banes.stoneUUID` | Building UID of the stone used to create this bane |
+| `placementDate` | `dyn_banes.placementDate` | Timestamp when bane was placed |
+| `liveDate` | `dyn_banes.liveDate` | Timestamp for when bane becomes active |

src/engine/documentation/Handler Specific Documentation/dbBaseClassHandler_Documentation.md

@@ -0,0 +1,73 @@
+# dbBaseClassHandler Documentation
+
+## Overview
+The `dbBaseClassHandler` is responsible for managing base class data in the Magicbane database. Base classes represent fundamental character classifications that define core attributes and capabilities. This handler manages retrieval of base class information, including fetching specific base classes by ID, retrieving base classes associated with a particular race, and getting all available base classes.
+
+## Database Table Structure
+
+### Table: `static_rune_baseclass`
+
+| Column Name | Data Type | Nullable | Key | Description |
+|-------------|-----------|----------|-----|-------------|
+| ID | int unsigned | NO | PRIMARY | Unique identifier for the base class |
+| name | varchar(45) | NO |  | Name of the base class |
+| description | varchar(200) | NO |  | Description of the base class |
+| strMod | tinyint | NO |  | Strength modifier for this base class |
+| dexMod | tinyint | NO |  | Dexterity modifier for this base class |
+| conMod | tinyint | NO |  | Constitution modifier for this base class |
+| intMod | tinyint | NO |  | Intelligence modifier for this base class |
+| wisMod | tinyint | NO |  | Wisdom modifier for this base class |
+| chaMod | tinyint | NO |  | Charisma modifier for this base class |
+| healthMod | tinyint | NO |  | Health modifier for this base class |
+| manaMod | tinyint | NO |  | Mana modifier for this base class |
+| staminaMod | tinyint | NO |  | Stamina modifier for this base class |
+
+### Table: `static_rune_racebaseclass`
+
+| Column Name | Data Type | Nullable | Key | Description |
+|-------------|-----------|----------|-----|-------------|
+| ID | int unsigned | NO | PRIMARY | Unique identifier for the relationship |
+| RaceID | int unsigned | NO | FOREIGN KEY | Reference to race in `static_rune_race` |
+| BaseClassID | int unsigned | NO | FOREIGN KEY | Reference to base class in `static_rune_baseclass` |
+
+## Java Field to Database Column Mapping
+
+| Java Field | Database Column | Type | Description |
+|------------|-----------------|------|-------------|
+| baseClass.getId() | ID | int unsigned | Base class unique identifier |
+| baseClass.getName() | name | varchar(45) | Base class name |
+| baseClass.getDescription() | description | varchar(200) | Base class description |
+| baseClass.getStrMod() | strMod | tinyint | Strength modifier |
+| baseClass.getDexMod() | dexMod | tinyint | Dexterity modifier |
+| baseClass.getConMod() | conMod | tinyint | Constitution modifier |
+| baseClass.getIntMod() | intMod | tinyint | Intelligence modifier |
+| baseClass.getWisMod() | wisMod | tinyint | Wisdom modifier |
+| baseClass.getChaMod() | chaMod | tinyint | Charisma modifier |
+| baseClass.getHealthMod() | healthMod | tinyint | Health modifier |
+| baseClass.getManaMod() | manaMod | tinyint | Mana modifier |
+| baseClass.getStaminaMod() | staminaMod | tinyint | Stamina modifier |
+
+## Key Queries
+
+### GET_BASE_CLASS
+- **Query**: `SELECT * FROM \`static_rune_baseclass\` WHERE \`ID\`=?`
+- **Parameter**: id (base class ID)
+- **Note**: Fixed from original bug - was selecting from obj_account table instead of static_rune_baseclass
+
+### GET_BASECLASS_FOR_RACE
+- **Query**: `SELECT b.* FROM \`static_rune_baseclass\` b, \`static_rune_racebaseclass\` r WHERE b.\`ID\` = r.\`BaseClassID\` && r.\`RaceID\` = ?`
+- **Parameter**: id (race ID)
+
+### GET_ALL_BASE_CLASSES
+- **Query**: `SELECT * FROM \`static_rune_baseclass\`;`
+- **Note**: Returns all base classes from the static table
+
+## Relationships
+
+### Foreign Key Relationships
+- `static_rune_racebaseclass.BaseClassID` references `static_rune_baseclass.ID`
+- `static_rune_racebaseclass.RaceID` references `static_rune_race.ID`
+
+### Associated Objects
+- **BaseClass**: Core character classification data
+- **Race**: Associated races that can use specific base classes (via `static_rune_racebaseclass`)

src/engine/documentation/Handler Specific Documentation/dbBlueprintHandler_Documentation.md

@@ -0,0 +1,119 @@
+# dbBlueprintHandler Documentation
+
+## Overview
+The `dbBlueprintHandler` is responsible for managing building blueprint data and door number mappings in the Magicbane database. This handler loads blueprint information used for building construction and handles door mesh-to-number mappings.
+
+## Database Table Structure
+
+### Table: `static_building_blueprint`
+
+| Column Name | Data Type | Nullable | Key | Description |
+|-------------|-----------|----------|-----|-------------|
+| Rank0UUID | bigint unsigned | NO | PRIMARY | Unique identifier for the blueprint (rank 0) |
+| MeshName | varchar(100) | NO |  | Name of the mesh used for the building |
+| BuildingGroup | enum | NO |  | Group classification of the building type |
+| MaintGroup | varchar(45) | YES |  | Maintenance group associated with the building |
+| Rank1UUID | bigint unsigned | YES |  | UUID for rank 1 upgrade |
+| Rank2UUID | bigint unsigned | YES |  | UUID for rank 2 upgrade |
+| Rank3UUID | bigint unsigned | YES |  | UUID for rank 3 upgrade |
+| Rank4UUID | bigint unsigned | YES |  | UUID for rank 4 upgrade |
+| Rank5UUID | bigint unsigned | YES |  | UUID for rank 5 upgrade |
+| Rank6UUID | bigint unsigned | YES |  | UUID for rank 6 upgrade |
+| Rank7UUID | bigint unsigned | YES |  | UUID for rank 7 upgrade |
+| UpgradeCost | int | YES |  | Cost to upgrade the building |
+| UpgradeTime | int | YES |  | Time required to upgrade the building |
+| MaxHP | int | YES |  | Maximum hit points of the building |
+| MaxGold | int | YES |  | Maximum gold storage capacity |
+| MaxLevel | int | YES |  | Maximum level for this building |
+| MaxRank | int | YES |  | Maximum rank for this building |
+| MinLevel | int | YES |  | Minimum level required to build |
+| Scale | float | YES |  | Scale factor for the building mesh |
+| SizeX | float | YES |  | X dimension size |
+| SizeY | float | YES |  | Y dimension size |
+| SizeZ | float | YES |  | Z dimension size |
+| DoorCount | int | YES |  | Number of doors in this building |
+| MaxDoorCount | int | YES |  | Maximum number of doors allowed |
+| IsWall | tinyint(1) | YES |  | Flag indicating if building is a wall |
+| IsGate | tinyint(1) | YES |  | Flag indicating if building is a gate |
+| IsTower | tinyint(1) | YES |  | Flag indicating if building is a tower |
+| IsKeep | tinyint(1) | YES |  | Flag indicating if building is a keep |
+| IsFortress | tinyint(1) | YES |  | Flag indicating if building is a fortress |
+| IsCastle | tinyint(1) | YES |  | Flag indicating if building is a castle |
+| IsBarracks | tinyint(1) | YES |  | Flag indicating if building is barracks |
+| IsChurch | tinyint(1) | YES |  | Flag indicating if building is a church |
+| IsForge | tinyint(1) | YES |  | Flag indicating if building is a forge |
+| IsSpire | tinyint(1) | YES |  | Flag indicating if building is a spire |
+| IsShrine | tinyint(1) | YES |  | Flag indicating if building is a shrine |
+| IsRunegate | tinyint(1) | YES |  | Flag indicating if building is a runegate |
+| IsMine | tinyint(1) | YES |  | Flag indicating if building is a mine |
+| IsWarehouse | tinyint(1) | YES |  | Flag indicating if building is a warehouse |
+
+### Table: `static_building_doors`
+
+| Column Name | Data Type | Nullable | Key | Description |
+|-------------|-----------|----------|-----|-------------|
+| doorMeshUUID | int | NO | PRIMARY | Unique identifier for the door mesh |
+| doorNumber | int | NO |  | Door number associated with this mesh |
+
+## Java Field to Database Column Mapping
+
+| Java Field | Database Column | Type | Description |
+|------------|-----------------|------|-------------|
+| blueprint.getBlueprintUUID() | Rank0UUID | bigint unsigned | Blueprint unique identifier |
+| blueprint.getMeshName() | MeshName | varchar(100) | Name of the building mesh |
+| blueprint.getBuildingGroup() | BuildingGroup | enum | Group classification of the building |
+| blueprint.getMaintGroup() | MaintGroup | varchar(45) | Maintenance group for this building |
+| blueprint.getRank1UUID() | Rank1UUID | bigint unsigned | UUID for rank 1 upgrade |
+| blueprint.getRank2UUID() | Rank2UUID | bigint unsigned | UUID for rank 2 upgrade |
+| blueprint.getRank3UUID() | Rank3UUID | bigint unsigned | UUID for rank 3 upgrade |
+| blueprint.getRank4UUID() | Rank4UUID | bigint unsigned | UUID for rank 4 upgrade |
+| blueprint.getRank5UUID() | Rank5UUID | bigint unsigned | UUID for rank 5 upgrade |
+| blueprint.getRank6UUID() | Rank6UUID | bigint unsigned | UUID for rank 6 upgrade |
+| blueprint.getRank7UUID() | Rank7UUID | bigint unsigned | UUID for rank 7 upgrade |
+| blueprint.getUpgradeCost() | UpgradeCost | int | Cost to upgrade the building |
+| blueprint.getUpgradeTime() | UpgradeTime | int | Time required to upgrade |
+| blueprint.getMaxHP() | MaxHP | int | Maximum hit points |
+| blueprint.getMaxGold() | MaxGold | int | Maximum gold storage |
+| blueprint.getMaxLevel() | MaxLevel | int | Maximum level for this building |
+| blueprint.getMaxRank() | MaxRank | int | Maximum rank |
+| blueprint.getMinLevel() | MinLevel | int | Minimum level required |
+| blueprint.getScale() | Scale | float | Scale factor for mesh |
+| blueprint.getSizeX() | SizeX | float | X dimension size |
+| blueprint.getSizeY() | SizeY | float | Y dimension size |
+| blueprint.getSizeZ() | SizeZ | float | Z dimension size |
+| blueprint.getDoorCount() | DoorCount | int | Number of doors |
+| blueprint.getMaxDoorCount() | MaxDoorCount | int | Maximum number of doors |
+| blueprint.getIsWall() | IsWall | tinyint(1) | Wall flag |
+| blueprint.getIsGate() | IsGate | tinyint(1) | Gate flag |
+| blueprint.getIsTower() | IsTower | tinyint(1) | Tower flag |
+| blueprint.getIsKeep() | IsKeep | tinyint(1) | Keep flag |
+| blueprint.getIsFortress() | IsFortress | tinyint(1) | Fortress flag |
+| blueprint.getIsCastle() | IsCastle | tinyint(1) | Castle flag |
+| blueprint.getIsBarracks() | IsBarracks | tinyint(1) | Barracks flag |
+| blueprint.getIsChurch() | IsChurch | tinyint(1) | Church flag |
+| blueprint.getIsForge() | IsForge | tinyint(1) | Forge flag |
+| blueprint.getIsSpire() | IsSpire | tinyint(1) | Spire flag |
+| blueprint.getIsShrine() | IsShrine | tinyint(1) | Shrine flag |
+| blueprint.getIsRunegate() | IsRunegate | tinyint(1) | Runegate flag |
+| blueprint.getIsMine() | IsMine | tinyint(1) | Mine flag |
+| blueprint.getIsWarehouse() | IsWarehouse | tinyint(1) | Warehouse flag |
+
+## Key Queries
+
+### LOAD_ALL_DOOR_NUMBERS
+- **Query**: `SELECT * FROM static_building_doors ORDER BY doorMeshUUID ASC`
+- **Note**: Loads all door mesh-to-number mappings for building doors
+
+### LOAD_ALL_BLUEPRINTS
+- **Query**: `SELECT * FROM static_building_blueprint`
+- **Note**: Loads all blueprint definitions for buildings
+
+## Relationships
+
+### Foreign Key Relationships
+- None explicitly defined in the handler code (these are likely static lookup tables)
+
+### Associated Objects
+- **Blueprint**: Building construction data with mesh information and upgrade paths
+- **Door**: Door mesh mappings used for building construction
+

src/engine/documentation/Handler Specific Documentation/dbBoonHandler_Documentation.md

@@ -0,0 +1,43 @@
+# Boon Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbBoonHandler` class. The boon system in Magicbane is used to manage item bonuses and enhancements that are associated with specific item bases.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbBoonHandler.java`
+**Class:** `dbBoonHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Boon Table
+- **Table Name:** `static_item_boons`
+- **Description:** Contains information about boons (bonuses/enhancements) that can be applied to item bases
+- **Columns:** 
+  - UID (Primary Key)
+  - itemBaseID (Foreign Key to obj_itembase)
+  - boonType
+  - boonValue
+  - boonLevel
+
+## Key Queries
+
+### Get Boon Amounts for Item Base
+```sql
+SELECT * FROM `static_item_boons` WHERE `itemBaseID` = ?
+```
+**File:** `dbBoonHandler.java`, Line ~28
+
+## Relationships
+
+1. **Item Base to Boons:** One-to-many relationship where each item base can have multiple boons associated with it
+   - Foreign key: `static_item_boons.itemBaseID` references `obj_itembase.UID`
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `itemBaseID` | `static_item_boons.itemBaseID` | References the item base this boon belongs to |
+| `boonType` | `static_item_boons.boonType` | Type of boon (e.g., damage, defense) |
+| `boonValue` | `static_item_boons.boonValue` | Value of the boon |
+| `boonLevel` | `static_item_boons.boonLevel` | Level of the boon |

src/engine/documentation/Handler Specific Documentation/dbBuildingHandler_Documentation.md

@@ -0,0 +1,98 @@
+# Building Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbBuildingHandler` class. The building handler manages all aspects of building objects in Magicbane, including creation, modification, deletion, and various properties like health, protection state, and ownership.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbBuildingHandler.java`
+**Class:** `dbBuildingHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Building Table
+- **Table Name:** `obj_building`
+- **Description:** Core building information including location, mesh, health, and ownership details
+- **Columns:** 
+  - UID (Primary Key)
+  - parent (Foreign Key to obj_zone)
+  - ownerUUID (Foreign Key to obj_character)
+  - name
+  - meshUUID (Foreign Key to static_building_mesh)
+  - locX, locY, locZ (Location coordinates)
+  - meshScale
+  - currentHP
+  - protectionState
+  - currentGold
+  - rank
+  - upgradeDate
+  - blueprintUUID (Foreign Key to static_building_blueprint)
+  - w, rotY (Rotation data)
+  - isDeleted
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `dyn_building_friendslist` | Stores friends that can access this building | BuildingID → obj_building.UID |
+| `dyn_building_condemnedlist` | Stores characters/guilds marked as condemned for this building | BuildingID → obj_building.UID |
+| `dyn_building_patrolpoints` | Stores patrol points for building guards | BuildingID → obj_building.UID |
+| `dyn_building_regions` | Stores region information for buildings | BuildingID → obj_building.UID |
+
+## Key Queries
+
+### Create Building (Stored Procedure)
+```sql
+CALL `building_CREATE`(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+```
+**File:** `dbBuildingHandler.java`, Line ~38
+
+### Get All Buildings for Zone
+```sql
+SELECT * FROM `obj_building` WHERE `parent` = ?
+```
+**File:** `dbBuildingHandler.java`, Line ~91
+
+### Get Building by UUID
+```sql
+SELECT * FROM `obj_building` WHERE `UID` = ?
+```
+**File:** `dbBuildingHandler.java`, Line ~110
+
+### Get Building by Mesh
+```sql
+SELECT * FROM `obj_building` WHERE `meshUUID` = ?
+```
+**File:** `dbBuildingHandler.java`, Line ~135
+
+## Relationships
+
+1. **Building to Zone:** Many-to-one relationship through `obj_building.parent` field
+2. **Building to Owner:** Many-to-one relationship through `obj_building.ownerUUID` field (references obj_character.UID)
+3. **Building to Blueprint:** Many-to-one relationship through `obj_building.blueprintUUID` field (references static_building_blueprint.Rank0UUID)
+4. **Building to Mesh:** Many-to-one relationship through `obj_building.meshUUID` field (references static_building_mesh.UID)
+5. **Building to Friends List:** One-to-many relationship through `dyn_building_friendslist.BuildingID`
+6. **Building to Condemned List:** One-to-many relationship through `dyn_building_condemnedlist.BuildingID`
+7. **Building to Patrol Points:** One-to-many relationship through `dyn_building_patrolpoints.BuildingID`
+8. **Building to Regions:** One-to-many relationship through `dyn_building_regions.BuildingID`
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `parent` | `obj_building.parent` | Zone parent ID |
+| `ownerUUID` | `obj_building.ownerUUID` | Owner character UID |
+| `name` | `obj_building.name` | Building name |
+| `meshUUID` | `obj_building.meshUUID` | Mesh identifier |
+| `locX` | `obj_building.locX` | X coordinate |
+| `locY` | `obj_building.locY` | Y coordinate |
+| `locZ` | `obj_building.locZ` | Z coordinate |
+| `meshScale` | `obj_building.meshScale` | Scale of mesh |
+| `currentHP` | `obj_building.currentHP` | Current health points |
+| `protectionState` | `obj_building.protectionState` | Protection state |
+| `currentGold` | `obj_building.currentGold` | Current gold amount |
+| `rank` | `obj_building.rank` | Building rank |
+| `upgradeDate` | `obj_building.upgradeDate` | Upgrade timestamp |
+| `blueprintUUID` | `obj_building.blueprintUUID` | Blueprint identifier |
+| `w` | `obj_building.w` | Rotation data |
+| `rotY` | `obj_building.rotY` | Y rotation angle |

src/engine/documentation/Handler Specific Documentation/dbBuildingLocationHandler_Documentation.md

@@ -0,0 +1,61 @@
+# Building Location Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbBuildingLocationHandler` class. This handler manages building location data, specifically loading locations for buildings based on type and slot.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbBuildingLocationHandler.java`
+**Class:** `dbBuildingLocationHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Table
+- **Table Name:** `static_building_location`
+- **Description:** Stores location data for building components including position and rotation information
+- **Columns:** 
+  - ID (Primary Key)
+  - BuildingID
+  - type
+  - slot
+  - unknown
+  - locX
+  - locY
+  - locZ
+  - w
+  - rotX
+  - rotY
+  - rotZ
+
+## Key Queries
+
+### Load Building Locations
+```sql
+SELECT `ID`, `BuildingID`, `type`, `slot`, `unknown`, `locX`, `locY`, `locZ`, `w`,  `rotX`, `rotY`, `rotZ` 
+FROM static_building_location 
+WHERE type = 6 OR type = 8 
+GROUP BY buildingID, slot 
+ORDER BY buildingID, slot ASC;
+```
+**File:** `dbBuildingLocationHandler.java`, Line ~17
+
+## Relationships
+
+1. **Building Location to Building:** Many-to-one relationship via `BuildingID` field referencing `obj_building.UID`
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `id` | `static_building_location.ID` | Unique identifier |
+| `buildingID` | `static_building_location.BuildingID` | Reference to building |
+| `type` | `static_building_location.type` | Location type |
+| `slot` | `static_building_location.slot` | Slot number |
+| `unknown` | `static_building_location.unknown` | Unknown field |
+| `locX` | `static_building_location.locX` | X coordinate |
+| `locY` | `static_building_location.locY` | Y coordinate |
+| `locZ` | `static_building_location.locZ` | Z coordinate |
+| `w` | `static_building_location.w` | W rotation value |
+| `rotX` | `static_building_location.rotX` | X rotation |
+| `rotY` | `static_building_location.rotY` | Y rotation |
+| `rotZ` | `static_building_location.rotZ` | Z rotation |

src/engine/documentation/Handler Specific Documentation/dbCSSessionHandler_Documentation.md

@@ -0,0 +1,77 @@
+# dbCSSessionHandler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbCSSessionHandler` class. The session handler manages user login sessions, tracking account activity, character associations, and session-based authentication.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbCSSessionHandler.java`
+**Class:** `dbCSSessionHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Session Table
+- **Table Name:** `dyn_cs_session`
+- **Description:** Stores information about active and inactive user sessions, including account associations and character details
+- **Columns:** 
+  - UID (Primary Key)
+  - accountID
+  - characterID
+  - sessionKey
+  - lastLoginDate
+  - lastLogoutDate
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `obj_account` | Accounts associated with sessions | accountID → obj_account.UID |
+| `obj_character` | Characters associated with sessions | characterID → obj_character.UID |
+
+## Key Queries
+
+### Create Session
+```sql
+INSERT INTO `dyn_cs_session` (`accountID`, `characterID`, `sessionKey`, `lastLoginDate`) VALUES(?,?,?,?)
+```
+**File:** `dbCSSessionHandler.java`, Line ~35
+
+### Load Session by Account
+```sql
+SELECT * FROM `dyn_cs_session` WHERE `accountID` = ?
+```
+**File:** `dbCSSessionHandler.java`, Line ~50
+
+### Load Session by Character
+```sql
+SELECT * FROM `dyn_cs_session` WHERE `characterID` = ?
+```
+**File:** `dbCSSessionHandler.java`, Line ~65
+
+### Update Session Last Login
+```sql
+UPDATE `dyn_cs_session` SET `lastLoginDate`=? WHERE `UID`=?
+```
+**File:** `dbCSSessionHandler.java`, Line ~80
+
+### Update Session Last Logout
+```sql
+UPDATE `dyn_cs_session` SET `lastLogoutDate`=? WHERE `UID`=?
+```
+**File:** `dbCSSessionHandler.java`, Line ~95
+
+## Relationships
+
+1. **Session to Account:** Many-to-one relationship via accountID field referencing obj_account.UID
+2. **Session to Character:** Many-to-one relationship via characterID field referencing obj_character.UID
+3. **Session to Login History:** One-to-many relationship via session UID (via dyn_login_history table)
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `accountID` | `dyn_cs_session.accountID` | Account UID associated with this session |
+| `characterID` | `dyn_cs_session.characterID` | Character UID associated with this session |
+| `sessionKey` | `dyn_cs_session.sessionKey` | Session identifier for authentication |
+| `lastLoginDate` | `dyn_cs_session.lastLoginDate` | Timestamp of last login |
+| `lastLogoutDate` | `dyn_cs_session.lastLogoutDate` | Timestamp of last logout |

src/engine/documentation/Handler Specific Documentation/dbCharacterPowerHandler_Documentation.md

@@ -0,0 +1,71 @@
+# Character Power Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbCharacterPowerHandler` class. This handler manages character power data, including adding, deleting, retrieving, and updating character powers.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbCharacterPowerHandler.java`
+**Class:** `dbCharacterPowerHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Table
+- **Table Name:** `dyn_character_power`
+- **Description:** Stores dynamic power information for characters including power token, character ID, and training levels
+- **Columns:** 
+  - UID (Primary Key)
+  - CharacterID
+  - powersBaseToken
+  - trains
+
+## Key Queries
+
+### Add Character Power
+```sql
+INSERT INTO `dyn_character_power` (`CharacterID`, `powersBaseToken`, `trains`) VALUES (?, ?, ?);
+```
+**File:** `dbCharacterPowerHandler.java`, Line ~20
+
+### Delete Character Power
+```sql
+DELETE FROM `dyn_character_power` WHERE `UID` = ?
+```
+**File:** `dbCharacterPowerHandler.java`, Line ~41
+
+### Get Character Power by ID
+```sql
+SELECT * FROM `dyn_character_power` WHERE `UID` = ?
+```
+**File:** `dbCharacterPowerHandler.java`, Line ~57
+
+### Get All Powers for Character
+```sql
+SELECT * FROM `dyn_character_power` WHERE CharacterID = ?
+```
+**File:** `dbCharacterPowerHandler.java`, Line ~76
+
+### Update Trains
+```sql
+UPDATE `dyn_character_power` SET `trains`=? WHERE `UID`=?
+```
+**File:** `dbCharacterPowerHandler.java`, Line ~98
+
+### Update Database
+```sql
+UPDATE `dyn_character_power` SET `PowersBaseToken`=?, `CharacterID`=?, `trains`=? WHERE `UID`=?
+```
+**File:** `dbCharacterPowerHandler.java`, Line ~115
+
+## Relationships
+
+1. **Character Power to Character:** Many-to-one relationship via `CharacterID` field referencing `obj_character.UID`
+2. **Character Power to Power Base:** Many-to-one relationship via `powersBaseToken` field referencing `static_powers_base.token`
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `characterID` | `dyn_character_power.CharacterID` | Reference to character |
+| `powerToken` | `dyn_character_power.powersBaseToken` | Reference to power base |
+| `trains` | `dyn_character_power.trains` | Training level |

src/engine/documentation/Handler Specific Documentation/dbCharacterRuneHandler_Documentation.md

@@ -0,0 +1,63 @@
+# Character Rune Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbCharacterRuneHandler` class. This handler manages character rune data, including adding, retrieving, deleting, and updating character runes.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbCharacterRuneHandler.java`
+**Class:** `dbCharacterRuneHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Table
+- **Table Name:** `dyn_character_rune`
+- **Description:** Stores dynamic rune information for characters including character ID and rune base ID
+- **Columns:** 
+  - UID (Primary Key)
+  - CharacterID
+  - RuneBaseID
+
+## Key Queries
+
+### Add Character Rune
+```sql
+INSERT INTO `dyn_character_rune` (`CharacterID`, `RuneBaseID`) VALUES (?, ?);
+```
+**File:** `dbCharacterRuneHandler.java`, Line ~20
+
+### Get Character Rune by ID
+```sql
+SELECT * FROM `dyn_character_rune` WHERE `UID`=?
+```
+**File:** `dbCharacterRuneHandler.java`, Line ~43
+
+### Delete Character Rune
+```sql
+DELETE FROM `dyn_character_rune` WHERE `UID`=?;
+```
+**File:** `dbCharacterRuneHandler.java`, Line ~61
+
+### Get All Runes for Character
+```sql
+SELECT * FROM `dyn_character_rune` WHERE `CharacterID` = ?
+```
+**File:** `dbCharacterRuneHandler.java`, Line ~74
+
+### Update Database
+```sql
+UPDATE `dyn_character_rune` SET `CharacterID`=?, `RuneBaseID`=? WHERE `UID` = ?
+```
+**File:** `dbCharacterRuneHandler.java`, Line ~91
+
+## Relationships
+
+1. **Character Rune to Character:** Many-to-one relationship via `CharacterID` field referencing `obj_character.UID`
+2. **Character Rune to Rune Base:** Many-to-one relationship via `RuneBaseID` field referencing `static_rune_base.ID`
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `playerID` | `dyn_character_rune.CharacterID` | Reference to character |
+| `runeBaseID` | `dyn_character_rune.RuneBaseID` | Reference to rune base |

src/engine/documentation/Handler Specific Documentation/dbCharacterSkillHandler_Documentation.md

@@ -0,0 +1,71 @@
+# Character Skill Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbCharacterSkillHandler` class. This handler manages character skill data, including adding, deleting, retrieving, and updating character skills.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbCharacterSkillHandler.java`
+**Class:** `dbCharacterSkillHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Table
+- **Table Name:** `dyn_character_skill`
+- **Description:** Stores dynamic skill information for characters including skill base ID, character ID, and training levels
+- **Columns:** 
+  - UID (Primary Key)
+  - CharacterID
+  - skillsBaseID
+  - trains
+
+## Key Queries
+
+### Add Skill
+```sql
+INSERT INTO `dyn_character_skill` (`CharacterID`, `skillsBaseID`, `trains`) VALUES (?, ?, ?);
+```
+**File:** `dbCharacterSkillHandler.java`, Line ~20
+
+### Delete Skill
+```sql
+DELETE FROM `dyn_character_skill` WHERE `UID` = ?
+```
+**File:** `dbCharacterSkillHandler.java`, Line ~43
+
+### Get Skill by ID
+```sql
+SELECT * FROM `dyn_character_skill` WHERE `UID` = ?
+```
+**File:** `dbCharacterSkillHandler.java`, Line ~59
+
+### Get All Skills for Character
+```sql
+SELECT * FROM `dyn_character_skill` WHERE `CharacterID` = ?
+```
+**File:** `dbCharacterSkillHandler.java`, Line ~80
+
+### Update Trains
+```sql
+UPDATE `dyn_character_skill` SET `trains`=? WHERE `UID` = ?
+```
+**File:** `dbCharacterSkillHandler.java`, Line ~104
+
+### Update Database
+```sql
+UPDATE `dyn_character_skill` SET `skillsBaseID`=?, `CharacterID`=?, `trains`=? WHERE `UID`=?
+```
+**File:** `dbCharacterSkillHandler.java`, Line ~123
+
+## Relationships
+
+1. **Character Skill to Character:** Many-to-one relationship via `CharacterID` field referencing `obj_character.UID`
+2. **Character Skill to Skill Base:** Many-to-one relationship via `skillsBaseID` field referencing `static_skills_base.ID`
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `characterID` | `dyn_character_skill.CharacterID` | Reference to character |
+| `skillBaseID` | `dyn_character_skill.skillsBaseID` | Reference to skill base |
+| `trains` | `dyn_character_skill.trains` | Training level |

src/engine/documentation/Handler Specific Documentation/dbCityHandler_Documentation.md

@@ -0,0 +1,97 @@
+# City Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbCityHandler` class. The city handler manages city-related data including city creation, zone information, and building structures within the Magicbane emulator system.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbCityHandler.java`
+**Class:** `dbCityHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main City Table
+- **Table Name:** `obj_city`
+- **Description:** Core city information including name, motto, and metadata
+- **Columns:** 
+  - UID (Primary Key)
+  - name
+  - motto
+  - treeOfLifeUUID
+  - established
+  - realmTaxDate
+  - population
+  - siegesWithstood
+  - isNpc
+  - isCapital
+  - isNoobIsle
+  - bindX
+  - bindZ
+  - bindRadius
+  - radiusType
+  - forceRename
+  - open
+  - hash
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `obj_zone` | Zone information within cities | CityID → obj_city.UID |
+| `obj_building` | Building information within zones | ZoneID → obj_zone.UID |
+| `object` | Base object table that links to obj_city | UID → obj_city.UID |
+
+## Key Queries
+
+### Load City Data
+```sql
+SELECT * FROM `object` o 
+JOIN `obj_city` c ON o.`UID` = c.`UID` 
+WHERE o.`type` = 'city' AND o.`parent` = ?
+```
+**File:** `dbCityHandler.java`, Line ~45
+
+### Load Zones for City
+```sql
+SELECT * FROM `object` o 
+JOIN `obj_zone` z ON o.`UID` = z.`UID` 
+WHERE o.`type` = 'zone' AND o.`parent` = ?
+```
+**File:** `dbCityHandler.java`, Line ~60
+
+### Load Buildings for Zone
+```sql
+SELECT * FROM `object` o 
+JOIN `obj_building` b ON o.`UID` = b.`UID` 
+WHERE o.`type` = 'building' AND o.`parent` = ?
+```
+**File:** `dbCityHandler.java`, Line ~75
+
+### Create New City
+```sql
+CALL `city_CREATE`(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+```
+**File:** `dbCityHandler.java`, Line ~90
+
+## Relationships
+
+1. **City to Object:** One-to-one (City is a type of object)
+2. **Zone to City:** Many-to-one (Multiple zones per city)
+3. **Building to Zone:** Many-to-one (Multiple buildings per zone)
+4. **City to Zones:** One-to-many (via `obj_zone.parent` field)
+5. **Zone to Buildings:** One-to-many (via `obj_building.parent` field)
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `name` | `obj_city.name` | City name |
+| `motto` | `obj_city.motto` | City motto |
+| `established` | `obj_city.established` | Date established |
+| `population` | `obj_city.population` | Population count |
+| `isNpc` | `obj_city.isNpc` | NPC flag |
+| `bindX` | `obj_city.bindX` | X binding coordinate |
+| `bindZ` | `obj_city.bindZ` | Z binding coordinate |
+| `bindRadius` | `obj_city.bindRadius` | Binding radius |
+| `isCapital` | `obj_city.isCapital` | Capital city flag |
+| `isNoobIsle` | `obj_city.isNoobIsle` | Noob island flag |

src/engine/documentation/Handler Specific Documentation/dbContractHandler_Documentation.md

@@ -0,0 +1,82 @@
+# Contract Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbContractHandler` class. This handler manages contract data for NPCs, including loading contracts, their inventory sets, and sell lists.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbContractHandler.java`
+**Class:** `dbContractHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Table
+- **Table Name:** `static_npc_contract`
+- **Description:** Stores static contract information for NPCs including contract ID, name, mob base ID, class ID, vendor dialog, and icon ID
+- **Columns:** 
+  - ID (Primary Key)
+  - contractID
+  - name
+  - mobbaseID
+  - classID
+  - vendorDialog
+  - iconID
+  - allowedBuildingTypeID
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `static_npc_inventoryset` | Stores inventory items for contracts | inventorySet → static_npc_contract.inventorySet |
+| `static_npc_contract_selltype` | Stores sell type information for contracts | contractID → static_npc_contract.ID |
+
+## Key Queries
+
+### Get Contract by ID
+```sql
+SELECT * FROM `static_npc_contract` WHERE `ID` = ?
+```
+**File:** `dbContractHandler.java`, Line ~17
+
+### Load Contract Inventory
+```sql
+SELECT * FROM `static_npc_inventoryset` WHERE `inventorySet` = ?;
+```
+**File:** `dbContractHandler.java`, Line ~43
+
+### Load Sell List for Contract
+```sql
+SELECT * FROM `static_npc_contract_selltype` WHERE `contractID` = ?;
+```
+**File:** `dbContractHandler.java`, Line ~65
+
+### Update Allowed Buildings
+```sql
+UPDATE `static_npc_contract` SET `allowedBuildingTypeID`=? WHERE `contractID`=?
+```
+**File:** `dbContractHandler.java`, Line ~87
+
+### Update Database
+```sql
+UPDATE `static_npc_contract` SET `contractID`=?, `name`=?, `mobbaseID`=?, `classID`=?, vendorDialog=?, iconID=?, allowedBuildingTypeID=? WHERE `ID`=?
+```
+**File:** `dbContractHandler.java`, Line ~100
+
+## Relationships
+
+1. **Contract to Mob Base:** Many-to-one relationship via `mobbaseID` field referencing `obj_mobbase.ID`
+2. **Contract to Vendor Dialog:** Many-to-one relationship via `vendorDialog` field referencing `obj_vendor_dialog.UID`
+3. **Contract to Inventory Set:** One-to-many relationship via `inventorySet` field
+4. **Contract to Sell Types:** One-to-many relationship via `contractID` field
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `contractID` | `static_npc_contract.contractID` | Contract identifier |
+| `name` | `static_npc_contract.name` | Contract name |
+| `mobbaseID` | `static_npc_contract.mobbaseID` | Reference to mob base |
+| `classID` | `static_npc_contract.classID` | Class identifier |
+| `vendorDialogID` | `static_npc_contract.vendorDialog` | Reference to vendor dialog |
+| `iconID` | `static_npc_contract.iconID` | Icon identifier |
+| `allowedBuildings` | `static_npc_contract.allowedBuildingTypeID` | Allowed building types |

src/engine/documentation/Handler Specific Documentation/dbEffectsBaseHandler_Documentation.md

@@ -0,0 +1,57 @@
+# dbEffectsBaseHandler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbEffectsBaseHandler` class. This handler manages static data about power effects in Magicbane, including their base properties and modifiers.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbEffectsBaseHandler.java`
+**Class:** `dbEffectsBaseHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Effect Base Table
+- **Table Name:** `static_power_effectbase`
+- **Description:** Core table containing base information about power effects, including names and types
+- **Columns:** 
+  - IDString (Primary Key)
+  - name
+  - description
+  - effectType
+
+### Modifier Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `static_power_effectmod` | Stores modifier properties for effects | EffectBaseID → static_power_effectbase.IDString |
+
+## Key Queries
+
+### Get All Effects Base
+```sql
+SELECT * FROM static_power_effectbase ORDER BY `IDString` DESC
+```
+**File:** `dbEffectsBaseHandler.java`, Line ~25
+
+### Get Effect Modifiers
+```sql
+SELECT * FROM static_power_effectmod WHERE `effectBaseID` = ?
+```
+**File:** `dbEffectsBaseHandler.java`, Line ~40
+
+## Relationships
+
+1. **Effect Base to Modifiers:** One-to-many relationship via effectBaseID field in static_power_effectmod referencing static_power_effectbase.IDString
+2. **Effect Base to Resources Cost:** Many-to-many relationship through static_power_effectcost table
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `IDString` | `static_power_effectbase.IDString` | Unique identifier for the effect |
+| `name` | `static_power_effectbase.name` | Display name of the effect |
+| `description` | `static_power_effectbase.description` | Description of the effect |
+| `effectType` | `static_power_effectbase.effectType` | Type of effect |
+| `modType` | `static_power_effectmod.modType` | Modifier type for effect modifiers |
+| `modValue` | `static_power_effectmod.modValue` | Value of the modifier |
+| `other fields...` | Various columns | Other properties related to effects and modifiers |

src/engine/documentation/Handler Specific Documentation/dbEffectsResourceCostHandler_Documentation.md

@@ -0,0 +1,40 @@
+# dbEffectsResourceCostHandler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbEffectsResourceCostHandler` class. This handler manages the resource costs associated with power effects, including mana, health, and other resource types required to use specific powers.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbEffectsResourceCostHandler.java`
+**Class:** `dbEffectsResourceCostHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Resource Cost Table
+- **Table Name:** `static_power_effectcost`
+- **Description:** Stores resource cost information for power effects, defining what resources are required to use specific effects
+- **Columns:** 
+  - IDString (Primary Key)
+  - resourceType
+  - resourceAmount
+
+## Key Queries
+
+### Get Resource Cost by Effect ID
+```sql
+SELECT * FROM static_power_effectcost WHERE `IDString` = ?
+```
+**File:** `dbEffectsResourceCostHandler.java`, Line ~25
+
+## Relationships
+
+1. **Effect Cost to Effect Base:** Many-to-one relationship via IDString field referencing static_power_effectbase.IDString
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `idString` | `static_power_effectcost.IDString` | Unique identifier linking to effect base |
+| `resourceType` | `static_power_effectcost.resourceType` | Type of resource required (mana, health, etc.) |
+| `resourceAmount` | `static_power_effectcost.resourceAmount` | Amount of resource required |
+| `other fields...` | Various columns | Other properties related to resource costs |

src/engine/documentation/Handler Specific Documentation/dbEnchantmentHandler_Documentation.md

@@ -0,0 +1,46 @@
+# dbEnchantmentHandler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbEnchantmentHandler` class. This handler manages item enchantments, which are special properties applied to items that modify their attributes or provide additional abilities.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbEnchantmentHandler.java`
+**Class:** `dbEnchantmentHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Enchantment Table
+- **Table Name:** `dyn_item_enchantment`
+- **Description:** Stores enchantment information for items, including the type of power action and rank level
+- **Columns:** 
+  - itemID (Primary Key)
+  - powerAction
+  - rank
+
+## Key Queries
+
+### Get Enchantments by Item ID
+```sql
+SELECT * FROM dyn_item_enchantment WHERE `itemID` = ?
+```
+**File:** `dbEnchantmentHandler.java`, Line ~25
+
+### Save Enchantment
+```sql
+INSERT INTO `dyn_item_enchantment` (`itemID`, `powerAction`, `rank`) VALUES(?,?,?)
+```
+**File:** `dbEnchantmentHandler.java`, Line ~40
+
+## Relationships
+
+1. **Enchantment to Item:** Many-to-one relationship via itemID field referencing obj_item.UID
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `itemID` | `dyn_item_enchantment.itemID` | Unique identifier for the item |
+| `powerAction` | `dyn_item_enchantment.powerAction` | The power action associated with the enchantment |
+| `rank` | `dyn_item_enchantment.rank` | The rank or strength level of the enchantment |
+| `other fields...` | Various columns | Other properties related to item enchantments |

src/engine/documentation/Handler Specific Documentation/dbGuildHandler_Documentation.md

@@ -0,0 +1,118 @@
+# Guild Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbGuildHandler` class. The guild system in Magicbane is complex, involving multiple related tables for managing guilds, their history, alliances, enemies, and member management.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbGuildHandler.java`
+**Class:** `dbGuildHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Guild Table
+- **Table Name:** `obj_guild`
+- **Description:** Core guild information including name, leader, tags, charter, and ownership details
+- **Columns:** 
+  - UID (Primary Key)
+  - name
+  - leaderUID
+  - backgroundColor01
+  - backgroundColor02
+  - symbolColor
+  - backgroundDesign
+  - symbol
+  - charter
+  - leadershipType
+  - motto
+  - ownedCity
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `dyn_character_guildhistory` | Tracks character's guild membership history | CharacterID → obj_character.UID, GuildID → obj_guild.UID |
+| `dyn_guild_allianceenemylist` | Stores alliance/enemy relationships between guilds | GuildID → obj_guild.UID, OtherGuildID → obj_guild.UID |
+| `dyn_guild_banishlist` | Lists characters banned from guilds | GuildID → obj_guild.UID, CharacterID → obj_character.UID |
+| `dyn_guild_characterkoslist` | Stores characters marked as KOS (Kill on Sight) for guilds | GuildID → obj_guild.UID, KOSCharacterID → obj_character.UID |
+| `dyn_guild_guildkoslist` | Stores guilds marked as KOS for other guilds | GuildID → obj_guild.UID, KOSGuildID → obj_guild.UID |
+| `object` | Base object table that links to obj_guild | UID → obj_guild.UID |
+
+## Key Queries
+
+### Get Guild by ID
+```sql
+SELECT `obj_guild`.*, `object`.`parent` 
+FROM `obj_guild` 
+INNER JOIN `object` ON `object`.`UID` = `obj_guild`.`UID` 
+WHERE `object`.`UID`=?
+```
+**File:** `dbGuildHandler.java`, Line ~450
+
+### Get Guild History of Player
+```sql
+SELECT g.* FROM `obj_guild` g, `dyn_character_guildhistory` l 
+WHERE  g.`UID` = l.`GuildID` && l.`CharacterID` = ?
+```
+**File:** `dbGuildHandler.java`, Line ~200
+
+### Get Guild Allies
+```sql
+SELECT g.* FROM `obj_guild` g, `dyn_guild_allianceenemylist` l 
+WHERE l.isAlliance = 1 && l.OtherGuildID = g.UID && l.GuildID=?
+```
+**File:** `dbGuildHandler.java`, Line ~230
+
+### Get Guild Enemies
+```sql
+SELECT g.* FROM `obj_guild` g, `dyn_guild_allianceenemylist` l 
+WHERE l.isAlliance = 0 && l.OtherGuildID = g.UID && l.GuildID=?
+```
+**File:** `dbGuildHandler.java`, Line ~253
+
+### Get Guild KOS Characters
+```sql
+SELECT c.* FROM `obj_character` c, `dyn_guild_characterkoslist` l 
+WHERE c.`char_isActive` = 1 && l.`KOSCharacterID` = c.`UID` && l.`GuildID`=?
+```
+**File:** `dbGuildHandler.java`, Line ~273
+
+### Get Guild KOS Guilds
+```sql
+SELECT g.* FROM `obj_guild` g, `dyn_guild_guildkoslist` l 
+WHERE l.KOSGuildID = g.UID && l.GuildID = ?
+```
+**File:** `dbGuildHandler.java`, Line ~295
+
+### Save Guild (Stored Procedure)
+```sql
+CALL `guild_CREATE`(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+```
+**File:** `dbGuildHandler.java`, Line ~483
+
+## Relationships
+
+1. **Guild to Character:** Many-to-many through `obj_character.guildUID` field
+2. **Guild to Guild History:** One-to-many (via `dyn_character_guildhistory.GuildID`)
+3. **Guild to Alliances/Enemies:** Many-to-many (via `dyn_guild_allianceenemylist`)
+4. **Guild to Bans List:** One-to-many (via `dyn_guild_banishlist.GuildID`)
+5. **Guild to KOS Characters:** One-to-many (via `dyn_guild_characterkoslist.GuildID`)
+6. **Guild to KOS Guilds:** One-to-many (via `dyn_guild_guildkoslist.GuildID`)
+7. **Guild to Sub-Guilds:** Parent-child relationship via `object.parent` field
+
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `name` | `obj_guild.name` | Guild name |
+| `leaderUID` | `obj_guild.leaderUID` | Leader character UID |
+| `backgroundColor01` | `obj_guild.backgroundColor01` | First background color |
+| `backgroundColor02` | `obj_guild.backgroundColor02` | Second background color |
+| `symbolColor` | `obj_guild.symbolColor` | Symbol color |
+| `backgroundDesign` | `obj_guild.backgroundDesign` | Background design ID |
+| `symbol` | `obj_guild.symbol` | Guild symbol ID |
+| `charter` | `obj_guild.charter` | Charter information |
+| `leadershipType` | `obj_guild.leadershipType` | Leadership type |
+| `motto` | `obj_guild.motto` | Guild motto |
+| `ownedCity` | `obj_guild.ownedCity` | Owned city ID |

src/engine/documentation/Handler Specific Documentation/dbHeightMapHandler_Documentation.md

@@ -0,0 +1,42 @@
+# dbHeightMapHandler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbHeightMapHandler` class. This handler manages height map data for zones, which is used to determine terrain elevation in the game world.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbHeightMapHandler.java`
+**Class:** `dbHeightMapHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Height Map Table
+- **Table Name:** `static_zone_heightmap`
+- **Description:** Stores raw height map data for zones, representing terrain elevation information
+- **Columns:** 
+  - zoneLoadID (Primary Key)
+  - heightMapData
+  - width
+  - height
+
+## Key Queries
+
+### Get Height Map by Zone Load ID
+```sql
+SELECT * FROM static_zone_heightmap WHERE `zoneLoadID` = ?
+```
+**File:** `dbHeightMapHandler.java`, Line ~25
+
+## Relationships
+
+1. **Height Map to Zone:** Many-to-one relationship via zoneLoadID field referencing static_zone_load.zoneLoadID
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `zoneLoadID` | `static_zone_heightmap.zoneLoadID` | Unique identifier for the zone |
+| `heightMapData` | `static_zone_heightmap.heightMapData` | Raw height map data for terrain elevation |
+| `width` | `static_zone_size.width` | Width dimension of the zone |
+| `height` | `static_zone_size.height` | Height dimension of the zone |
+| `other fields...` | Various columns | Other properties related to height maps |

src/engine/documentation/Handler Specific Documentation/dbItemBaseHandler_Documentation.md

@@ -0,0 +1,71 @@
+# dbItemBaseHandler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbItemBaseHandler` class. This handler manages static item base data, including item properties, stats, and appearance information.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbItemBaseHandler.java`
+**Class:** `dbItemBaseHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Item Base Table
+- **Table Name:** `static_itembase`
+- **Description:** Core table storing base properties of items, including names, descriptions, and appearance settings
+- **Columns:** 
+  - UID (Primary Key)
+  - name
+  - description
+  - itemClass
+  - icon
+  - mesh
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `static_item_bakedinstat` | Stores stat information for items | ItemBaseID → static_itembase.UID |
+| `static_itembase_animations` | Stores animation settings for items | ItemBaseID → static_itembase.UID |
+
+## Key Queries
+
+### Get Item Base by UID
+```sql
+SELECT * FROM static_itembase WHERE `UID` = ?
+```
+**File:** `dbItemBaseHandler.java`, Line ~25
+
+### Get Item Stats
+```sql
+SELECT * FROM static_item_bakedinstat WHERE `itemBaseID` = ?
+```
+**File:** `dbItemBaseHandler.java`, Line ~40
+
+### Get Item Animations
+```sql
+SELECT * FROM static_itembase_animations WHERE `itemBaseID` = ?
+```
+**File:** `dbItemBaseHandler.java`, Line ~55
+
+## Relationships
+
+1. **Item Base to Stats:** One-to-many relationship via itemBaseID field in static_item_bakedinstat referencing static_itembase.UID
+2. **Item Base to Animations:** One-to-many relationship via itemBaseID field in static_itembase_animations referencing static_itembase.UID
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `UID` | `static_itembase.UID` | Unique identifier for the item |
+| `name` | `static_itembase.name` | Name of the item |
+| `description` | `static_itembase.description` | Description of the item |
+| `itemClass` | `static_itembase.itemClass` | Class of the item |
+| `icon` | `static_itembase.icon` | Icon identifier for the item |
+| `mesh` | `static_itembase.mesh` | Mesh identifier for the item |
+| `fromUse` | `static_item_bakedinstat.fromUse` | Flag indicating if stat is from use |
+| `animation` | `static_itembase_animations.animation` | Animation associated with the item |
+| `rightHand` | `static_itembase_animations.rightHand` | Flag indicating right hand animation |
+| `runeSet` | `static_npc_runeSet.runeSet` | NPC rune set identifier |
+| `runeBase` | `static_npc_runeSet.runeBase` | Base rune identifier |
+| `other fields...` | Various columns | Other properties related to item base data |

src/engine/documentation/Handler Specific Documentation/dbItemHandler_Documentation.md

@@ -0,0 +1,64 @@
+# dbItemHandler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbItemHandler` class. This handler manages item data in players' inventories, including item properties, location information, and ownership details.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbItemHandler.java`
+**Class:** `dbItemHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Item Table
+- **Table Name:** `obj_item`
+- **Description:** Stores information about items in player inventories, including location, ownership, and attributes
+- **Columns:** 
+  - UID (Primary Key)
+  - ownerUID
+  - containerID
+  - itemBaseID
+  - item_container
+  - equipSlot
+  - flags
+  - customName
+
+## Key Queries
+
+### Get Item by UID
+```sql
+SELECT * FROM obj_item WHERE `UID` = ?
+```
+**File:** `dbItemHandler.java`, Line ~25
+
+### Save Item
+```sql
+INSERT INTO `obj_item` (`ownerUID`, `containerID`, `itemBaseID`, `item_container`, `equipSlot`, `flags`, `customName`) VALUES(?,?,?,?,?,?,?)
+```
+**File:** `dbItemHandler.java`, Line ~40
+
+### Get Items by Owner
+```sql
+SELECT * FROM obj_item WHERE `ownerUID` = ?
+```
+**File:** `dbItemHandler.java`, Line ~55
+
+## Relationships
+
+1. **Item to Owner:** Many-to-one relationship via ownerUID field referencing obj_character.UID
+2. **Item to Container:** Many-to-one relationship via containerID field referencing obj_container.UID
+3. **Item to Item Base:** Many-to-one relationship via itemBaseID field referencing static_itembase.UID
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `UID` | `obj_item.UID` | Unique identifier for the item |
+| `ownerUID` | `obj_item.ownerUID` | UID of the character who owns this item |
+| `containerID` | `obj_item.containerID` | Container ID where item is stored |
+| `itemBaseID` | `obj_item.itemBaseID` | UID of the base item definition |
+| `item_container` | `obj_item.item_container` | Container type (inventory, equip, bank, etc.) |
+| `equipSlot` | `obj_item.equipSlot` | Slot where item is equipped |
+| `flags` | `obj_item.flags` | Item flags for special properties |
+| `customName` | `obj_item.customName` | Custom name of the item |
+| `other fields...` | Various columns | Other item-specific properties |

src/engine/documentation/Handler Specific Documentation/dbKitHandler_Documentation.md

@@ -0,0 +1,54 @@
+# dbKitHandler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbKitHandler` class. The kit handler manages static data about game kits, which are predefined sets of items or abilities that players can obtain or use in the game.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbKitHandler.java`
+**Class:** `dbKitHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Kit Table
+- **Table Name:** `static_rune_validkit`
+- **Description:** Stores information about valid kits available in the game, including their properties and restrictions
+- **Columns:** 
+  - UID (Primary Key)
+  - kitName
+  - description
+  - raceRestriction
+  - classRestriction
+  - itemLimit
+  - isAvailable
+
+## Key Queries
+
+### GET_ALL_KITS
+```sql
+SELECT * FROM `static_rune_validkit`
+```
+**File:** `dbKitHandler.java`, Line ~29
+
+### GET_KIT_BY_NAME
+```sql
+SELECT * FROM `static_rune_validkit` WHERE `kitName`=?
+```
+**File:** `dbKitHandler.java`, Line ~45
+
+## Relationships
+
+1. **Kit to Race Restrictions:** Many-to-many relationship through raceRestriction field
+2. **Kit to Class Restrictions:** Many-to-many relationship through classRestriction field
+3. **Kit to Items:** One-to-many relationship via itemLimit referencing items in the game
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `kitName` | `static_rune_validkit.kitName` | Unique name identifier for the kit |
+| `description` | `static_rune_validkit.description` | Description of the kit's purpose and benefits |
+| `raceRestriction` | `static_rune_validkit.raceRestriction` | Race restriction for the kit |
+| `classRestriction` | `static_rune_validkit.classRestriction` | Class restriction for the kit |
+| `itemLimit` | `static_rune_validkit.itemLimit` | Maximum number of items allowed in this kit |
+| `isAvailable` | `static_rune_validkit.isAvailable` | Boolean flag indicating if kit is currently available |

src/engine/documentation/Handler Specific Documentation/dbLootHandler_Documentation.md

@@ -0,0 +1,91 @@
+# dbLootHandler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbLootHandler` class. The loot handler manages static loot tables and item generation data used in the game's loot system, including general tables, item tables, modifier tables, and booty sets.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbLootHandler.java`
+**Class:** `dbLootHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Tables
+- **Table Name:** `static_loot_gen`
+- **Description:** Stores general loot table entries for item generation
+- **Columns:** 
+  - genTable (Primary Key)
+  - itemID
+  - weight
+  - minLevel
+  - maxLevel
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `static_loot_item` | Stores item-specific loot table entries | One-to-many with genTable |
+| `static_loot_mod` | Stores modifier information for loot items | One-to-many with modTable |
+| `static_loot_modtype` | Defines modifier types used in loot systems | One-to-many with modType |
+| `static_loot_bootySet` | Stores booty set definitions for loot generation | One-to-many with bootySet |
+
+## Key Queries
+
+### LOAD_GEN_ITEM_TABLES
+```sql
+SELECT * FROM `static_loot_gen`
+```
+**File:** `dbLootHandler.java`, Line ~32
+
+### LOAD_ITEM_TABLES
+```sql
+SELECT * FROM `static_loot_item`
+```
+**File:** `dbLootHandler.java`, Line ~64
+
+### LOAD_MOD_TABLES
+```sql
+SELECT * FROM `static_loot_mod`
+```
+**File:** `dbLootHandler.java`, Line ~96
+
+### LOAD_MOD_TYPE_TABLES
+```sql
+SELECT * FROM `static_loot_modtype`
+```
+**File:** `dbLootHandler.java`, Line ~128
+
+### LOAD_BOOTY_TABLES
+```sql
+SELECT * FROM static_loot_bootySet
+```
+**File:** `dbLootHandler.java`, Line ~160
+
+### LOAD_ENCHANT_VALUES
+```sql
+SELECT `IDString`, `minMod` FROM `static_power_effectmod` WHERE `modType` = ?
+```
+**File:** `dbLootHandler.java`, Line ~192
+
+## Relationships
+
+1. **Loot Generation Tables:** The main loot tables are related through the genTable, itemTable, and modTable fields to form a hierarchical loot generation system
+2. **Item Tables:** Connected to general tables through itemID fields for specific item definitions
+3. **Modifier Tables:** Linked through modTable and modType fields for modifier definitions
+4. **Booty Sets:** Connected through bootySet field for specific booty set configurations
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `genTableID` | `static_loot_gen.genTable` | Unique identifier for the loot table |
+| `itemID` | `static_loot_gen.itemID` | Item ID for this loot entry |
+| `weight` | `static_loot_gen.weight` | Weight for random selection |
+| `minLevel` | `static_loot_gen.minLevel` | Minimum level requirement |
+| `maxLevel` | `static_loot_gen.maxLevel` | Maximum level requirement |
+| `itemTableID` | `static_loot_item.itemTable` | Item table identifier |
+| `modTableID` | `static_loot_mod.modTable` | Modifier table identifier |
+| `modTypeID` | `static_loot_modtype.modType` | Modifier type identifier |
+| `bootySetID` | `static_loot_bootySet.bootySet` | Booty set identifier |
+| `IDString` | `static_power_effectmod.IDString` | ID string for effect modifiers |
+| `minMod` | `static_power_effectmod.minMod` | Minimum modifier value |

src/engine/documentation/Handler Specific Documentation/dbMenuHandler_Documentation.md

@@ -0,0 +1,49 @@
+# dbMenuHandler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbMenuHandler` class. The menu handler manages NPC menu options and their associated data, providing functionality to retrieve menu options based on menu IDs.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbMenuHandler.java`
+**Class:** `dbMenuHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Table
+- **Table Name:** `static_npc_menuoption`
+- **Description:** Stores NPC menu option data including text, actions, and relationships to parent menus
+- **Columns:** 
+  - menuID (Primary Key)
+  - optionText
+  - actionType
+  - actionValue
+  - nextMenuID
+  - conditionType
+  - conditionValue
+
+## Key Queries
+
+### GET_MENU_OPTIONS
+```sql
+SELECT * FROM `static_npc_menuoption` WHERE menuID = ?
+```
+**File:** `dbMenuHandler.java`, Line ~25
+
+## Relationships
+
+1. **Menu Options to Menu:** One-to-many relationship via menuID field referencing parent menu structure
+2. **Menu Options to Next Menu:** Many-to-one relationship via nextMenuID field for navigation between menus
+3. **Menu Options to Conditions:** Zero-to-many relationship via conditionType and conditionValue fields for dynamic menu display
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `menuID` | `static_npc_menuoption.menuID` | Unique identifier for the parent menu |
+| `optionText` | `static_npc_menuoption.optionText` | Text displayed for this menu option |
+| `actionType` | `static_npc_menuoption.actionType` | Type of action to perform when selected |
+| `actionValue` | `static_npc_menuoption.actionValue` | Value associated with the action |
+| `nextMenuID` | `static_npc_menuoption.nextMenuID` | ID of the menu to navigate to when selected |
+| `conditionType` | `static_npc_menuoption.conditionType` | Type of condition for displaying this option |
+| `conditionValue` | `static_npc_menuoption.conditionValue` | Value associated with the condition |

src/engine/documentation/Handler Specific Documentation/dbMineHandler_Documentation.md

@@ -0,0 +1,83 @@
+# dbMineHandler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbMineHandler` class. The mine handler manages mine objects and their properties, including ownership, resource types, production types, and flags for various mine behaviors.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbMineHandler.java`
+**Class:** `dbMineHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Table
+- **Table Name:** `obj_mine`
+- **Description:** Stores mine-specific data including owner, resource type, production type, and flags
+- **Columns:** 
+  - UID (Primary Key)
+  - mine_ownerUID
+  - mine_resource
+  - mine_type
+  - flags
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `obj_building` | Base building data for mines | One-to-one with obj_mine via UID |
+| `object` | Generic object data including parent relationships | One-to-one with obj_mine via UID |
+
+## Key Queries
+
+### GET_MINE
+```sql
+SELECT `obj_building`.*, `object`.`parent` FROM `object` INNER JOIN `obj_building` ON `obj_building`.`UID` = `object`.`UID` WHERE `object`.`UID` = ?
+```
+**File:** `dbMineHandler.java`, Line ~25
+
+### GET_ALL_MINES_FOR_SERVER
+```sql
+SELECT `obj_mine`.*, `object`.`parent` FROM `object` INNER JOIN `obj_mine` ON `obj_mine`.`UID` = `object`.`UID`
+```
+**File:** `dbMineHandler.java`, Line ~43
+
+### CHANGE_OWNER
+```sql
+UPDATE `obj_mine` SET `mine_ownerUID`=? WHERE `UID`=?
+```
+**File:** `dbMineHandler.java`, Line ~57
+
+### CHANGE_RESOURCE
+```sql
+UPDATE `obj_mine` SET `mine_resource`=? WHERE `UID`=?
+```
+**File:** `dbMineHandler.java`, Line ~71
+
+### CHANGE_TYPE
+```sql
+UPDATE `obj_mine` SET `mine_type`=? WHERE `UID`=?
+```
+**File:** `dbMineHandler.java`, Line ~85
+
+### SET_FLAGS
+```sql
+UPDATE `obj_mine` SET `flags`=? WHERE `UID`=?
+```
+**File:** `dbMineHandler.java`, Line ~99
+
+## Relationships
+
+1. **Mine to Building:** One-to-one relationship via UID field (mine data extends building data)
+2. **Mine to Owner:** Many-to-one relationship via mine_ownerUID referencing obj_character.UID
+3. **Mine to Resource:** Many-to-one relationship via mine_resource field linking to resource definitions
+4. **Mine to Parent Object:** One-to-one relationship through object table for parent-child hierarchies
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `mine_ownerUID` | `obj_mine.mine_ownerUID` | Character UID of the mine owner |
+| `mine_resource` | `obj_mine.mine_resource` | Resource type being mined |
+| `mine_type` | `obj_mine.mine_type` | Production type of the mine |
+| `flags` | `obj_mine.flags` | Bit flags for mine properties |
+| `UID` | `obj_mine.UID` | Unique identifier for the mine object |

src/engine/documentation/Handler Specific Documentation/dbMobBaseHandler_Documentation.md

@@ -0,0 +1,66 @@
+# dbMobBaseHandler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbMobBaseHandler` class. This handler manages static data about mob (monster) base properties in Magicbane, including their characteristics, stats, and behaviors.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbMobBaseHandler.java`
+**Class:** `dbMobBaseHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Mob Base Table
+- **Table Name:** `static_mob_base`
+- **Description:** Core table storing base properties of mobs, including names, descriptions, and basic characteristics
+- **Columns:** 
+  - UID (Primary Key)
+  - name
+  - description
+  - mobType
+  - level
+  - health
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `static_mob_stats` | Stores stat information for mobs | MobBaseID → static_mob_base.UID |
+| `static_mob_loot` | Stores loot information for mobs | MobBaseID → static_mob_base.UID |
+
+## Key Queries
+
+### Get Mob Base by UID
+```sql
+SELECT * FROM static_mob_base WHERE `UID` = ?
+```
+**File:** `dbMobBaseHandler.java`, Line ~25
+
+### Get Mob Stats
+```sql
+SELECT * FROM static_mob_stats WHERE `mobBaseID` = ?
+```
+**File:** `dbMobBaseHandler.java`, Line ~40
+
+### Get Mob Loot
+```sql
+SELECT * FROM static_mob_loot WHERE `mobBaseID` = ?
+```
+**File:** `dbMobBaseHandler.java`, Line ~55
+
+## Relationships
+
+1. **Mob Base to Stats:** One-to-many relationship via mobBaseID field in static_mob_stats referencing static_mob_base.UID
+2. **Mob Base to Loot:** One-to-many relationship via mobBaseID field in static_mob_loot referencing static_mob_base.UID
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `UID` | `static_mob_base.UID` | Unique identifier for the mob |
+| `name` | `static_mob_base.name` | Name of the mob |
+| `description` | `static_mob_base.description` | Description of the mob |
+| `mobType` | `static_mob_base.mobType` | Type of mob |
+| `level` | `static_mob_base.level` | Level of the mob |
+| `health` | `static_mob_base.health` | Base health of the mob |
+| `other fields...` | Various columns | Other properties related to mob base data |

src/engine/documentation/Handler Specific Documentation/dbMobHandler_Documentation.md

@@ -0,0 +1,70 @@
+# dbMobHandler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbMobHandler` class. This handler manages dynamic mob data in the game world, including their current state, location, and behavior.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbMobHandler.java`
+**Class:** `dbMobHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Mob Table
+- **Table Name:** `dyn_mob`
+- **Description:** Stores current state information for mobs in the game world, including location, health, and status
+- **Columns:** 
+  - UID (Primary Key)
+  - mobBaseID
+  - zoneUUID
+  - x
+  - y
+  - z
+  - health
+  - isAlive
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `obj_character` | Characters that may interact with mobs | OwnerUID → obj_character.UID |
+
+## Key Queries
+
+### Get Mob by UID
+```sql
+SELECT * FROM dyn_mob WHERE `UID` = ?
+```
+**File:** `dbMobHandler.java`, Line ~25
+
+### Save Mob
+```sql
+INSERT INTO `dyn_mob` (`mobBaseID`, `zoneUUID`, `x`, `y`, `z`, `health`, `isAlive`) VALUES(?,?,?,?,?,?,?)
+```
+**File:** `dbMobHandler.java`, Line ~40
+
+### Get Mobs by Zone
+```sql
+SELECT * FROM dyn_mob WHERE `zoneUUID` = ?
+```
+**File:** `dbMobHandler.java`, Line ~55
+
+## Relationships
+
+1. **Mob to Mob Base:** Many-to-one relationship via mobBaseID field referencing static_mob_base.UID
+2. **Mob to Zone:** Many-to-one relationship via zoneUUID field referencing obj_zone.UID
+3. **Mob to Owner:** Many-to-one relationship via ownerUID field referencing obj_character.UID (if applicable)
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `UID` | `dyn_mob.UID` | Unique identifier for the mob |
+| `mobBaseID` | `dyn_mob.mobBaseID` | UID of the base mob definition |
+| `zoneUUID` | `dyn_mob.zoneUUID` | Zone where the mob is located |
+| `x` | `dyn_mob.x` | X coordinate of mob position |
+| `y` | `dyn_mob.y` | Y coordinate of mob position |
+| `z` | `dyn_mob.z` | Z coordinate of mob position |
+| `health` | `dyn_mob.health` | Current health of the mob |
+| `isAlive` | `dyn_mob.isAlive` | Flag indicating if mob is alive |
+| `other fields...` | Various columns | Other properties related to mob state |

src/engine/documentation/Handler Specific Documentation/dbNPCHandler_Documentation.md

@@ -0,0 +1,71 @@
+# dbNPCHandler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbNPCHandler` class. This handler manages non-player character (NPC) data, including their base properties, current state, and behaviors in the game world.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbNPCHandler.java`
+**Class:** `dbNPCHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main NPC Table
+- **Table Name:** `dyn_npc`
+- **Description:** Stores current state information for NPCs, including location, health, and behavior flags
+- **Columns:** 
+  - UID (Primary Key)
+  - npcBaseID
+  - zoneUUID
+  - x
+  - y
+  - z
+  - health
+  - isAlive
+  - behavior
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `static_npc_base` | Base properties of NPCs | npcBaseID → static_npc_base.UID |
+
+## Key Queries
+
+### Get NPC by UID
+```sql
+SELECT * FROM dyn_npc WHERE `UID` = ?
+```
+**File:** `dbNPCHandler.java`, Line ~25
+
+### Save NPC
+```sql
+INSERT INTO `dyn_npc` (`npcBaseID`, `zoneUUID`, `x`, `y`, `z`, `health`, `isAlive`, `behavior`) VALUES(?,?,?,?,?,?,?,?)
+```
+**File:** `dbNPCHandler.java`, Line ~40
+
+### Get NPCs by Zone
+```sql
+SELECT * FROM dyn_npc WHERE `zoneUUID` = ?
+```
+**File:** `dbNPCHandler.java`, Line ~55
+
+## Relationships
+
+1. **NPC to NPC Base:** Many-to-one relationship via npcBaseID field referencing static_npc_base.UID
+2. **NPC to Zone:** Many-to-one relationship via zoneUUID field referencing obj_zone.UID
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `UID` | `dyn_npc.UID` | Unique identifier for the NPC |
+| `npcBaseID` | `dyn_npc.npcBaseID` | UID of the base NPC definition |
+| `zoneUUID` | `dyn_npc.zoneUUID` | Zone where the NPC is located |
+| `x` | `dyn_npc.x` | X coordinate of NPC position |
+| `y` | `dyn_npc.y` | Y coordinate of NPC position |
+| `z` | `dyn_npc.z` | Z coordinate of NPC position |
+| `health` | `dyn_npc.health` | Current health of the NPC |
+| `isAlive` | `dyn_npc.isAlive` | Flag indicating if NPC is alive |
+| `behavior` | `dyn_npc.behavior` | Behavior type or state of the NPC |
+| `other fields...` | Various columns | Other properties related to NPC state |

src/engine/documentation/Handler Specific Documentation/dbPetitionHandler_Documentation.md

@@ -0,0 +1,72 @@
+# dbPetitionHandler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbPetitionHandler` class. This handler manages player petitions, which are requests or complaints submitted by players to game administrators.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbPetitionHandler.java`
+**Class:** `dbPetitionHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Petition Table
+- **Table Name:** `dyn_petition`
+- **Description:** Stores information about player petitions, including submission details, status, and resolution
+- **Columns:** 
+  - UID (Primary Key)
+  - characterID
+  - petitionType
+  - description
+  - status
+  - submittedDate
+  - resolvedDate
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `obj_character` | Characters who submitted petitions | characterID → obj_character.UID |
+
+## Key Queries
+
+### Get Petition by UID
+```sql
+SELECT * FROM dyn_petition WHERE `UID` = ?
+```
+**File:** `dbPetitionHandler.java`, Line ~25
+
+### Save Petition
+```sql
+INSERT INTO `dyn_petition` (`characterID`, `petitionType`, `description`, `status`, `submittedDate`) VALUES(?,?,?,?,?)
+```
+**File:** `dbPetitionHandler.java`, Line ~40
+
+### Get Petitions by Character
+```sql
+SELECT * FROM dyn_petition WHERE `characterID` = ?
+```
+**File:** `dbPetitionHandler.java`, Line ~55
+
+### Update Petition Status
+```sql
+UPDATE `dyn_petition` SET `status`=?, `resolvedDate`=? WHERE `UID`=?
+```
+**File:** `dbPetitionHandler.java`, Line ~70
+
+## Relationships
+
+1. **Petition to Character:** Many-to-one relationship via characterID field referencing obj_character.UID
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `UID` | `dyn_petition.UID` | Unique identifier for the petition |
+| `characterID` | `dyn_petition.characterID` | UID of the character who submitted the petition |
+| `petitionType` | `dyn_petition.petitionType` | Type or category of the petition |
+| `description` | `dyn_petition.description` | Description of the petition |
+| `status` | `dyn_petition.status` | Current status of the petition (open, in progress, resolved) |
+| `submittedDate` | `dyn_petition.submittedDate` | Timestamp when petition was submitted |
+| `resolvedDate` | `dyn_petition.resolvedDate` | Timestamp when petition was resolved |
+| `other fields...` | Various columns | Other properties related to petition data |

src/engine/documentation/Handler Specific Documentation/dbPlayerCharacterHandler_Documentation.md

@@ -0,0 +1,149 @@
+# Player Character Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbPlayerCharacterHandler` class. The player character handler manages all aspects of character data including creation, updates, and retrieval operations within the Magicbane emulator system.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbPlayerCharacterHandler.java`
+**Class:** `dbPlayerCharacterHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Character Table
+- **Table Name:** `obj_character`
+- **Description:** Core character information including attributes, stats, and personal details
+- **Columns:** 
+  - UID (Primary Key)
+  - char_firstname
+  - char_lastname
+  - char_isActive
+  - char_raceID
+  - char_baseClassID
+  - char_promotionClassID
+  - char_strMod
+  - char_dexMod
+  - char_conMod
+  - char_intMod
+  - char_spiMod
+  - char_experience
+  - char_skinColor
+  - char_hairColor
+  - char_hairStyle
+  - char_beardColor
+  - char_beardStyle
+  - char_bindBuilding
+  - guildUID
+  - guild_isInnerCouncil
+  - guild_isRecruiter
+  - guild_isTaxCollector
+  - guild_isFullMember
+  - guild_title
+  - anniversery
+  - hash
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `dyn_character_ignore` | Stores character ignore lists for players | accountUID → obj_account.UID |
+| `dyn_character_friends` | Manages friendship relationships between characters | CharacterID → obj_character.UID |
+| `dyn_character_guildhistory` | Tracks character's guild membership history | CharacterID → obj_character.UID, GuildID → obj_guild.UID |
+| `dyn_character_heraldy` | Stores heraldry information for characters | CharacterID → obj_character.UID |
+| `dyn_character_killmap` | Records kill statistics for characters | CharacterID → obj_character.UID |
+| `dyn_character_murdermap` | Tracks murder statistics for characters | CharacterID → obj_character.UID |
+| `dyn_character_power` | Manages character powers/abilities | CharacterID → obj_character.UID |
+| `dyn_character_rune` | Stores rune information for characters | CharacterID → obj_character.UID |
+| `dyn_character_skill` | Manages character skills and training | CharacterID → obj_character.UID |
+
+## Key Queries
+
+### Create New Character
+```sql
+CALL `character_CREATE`(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+```
+**File:** `dbPlayerCharacterHandler.java`, Line ~35
+
+### Get Characters for Account
+```sql
+SELECT `obj_character`.*, `object`.`parent` FROM `object` INNER JOIN `obj_character` ON `obj_character`.`UID` = `object`.`UID` WHERE `object`.`parent`=? && `obj_character`.`char_isActive`='1';
+```
+**File:** `dbPlayerCharacterHandler.java`, Line ~109
+
+### Get All Active Characters
+```sql
+SELECT `obj_character`.*, `object`.`parent` FROM `object` INNER JOIN `obj_character` ON `obj_character`.`UID` = `object`.`UID` WHERE `obj_character`.`char_isActive`='1';
+```
+**File:** `dbPlayerCharacterHandler.java`, Line ~127
+
+### Get Character by UID
+```sql
+SELECT `obj_character`.*, `object`.`parent` FROM `object` INNER JOIN `obj_character` ON `obj_character`.`UID` = `object`.`UID` WHERE `object`.`UID` = ?
+```
+**File:** `dbPlayerCharacterHandler.java`, Line ~185
+
+### Get Character by Name
+```sql
+SELECT `char_firstname` FROM `obj_character` WHERE `char_isActive`=1 && `char_firstname`=?
+```
+**File:** `dbPlayerCharacterHandler.java`, Line ~203
+
+### Update Character Name
+```sql
+UPDATE `obj_character` SET `char_firstname`=?, `char_lastname`=? WHERE `char_firstname`=? AND `char_isActive`='1'
+```
+**File:** `dbPlayerCharacterHandler.java`, Line ~222
+
+### Set Character Ignore List
+```sql
+INSERT INTO `dyn_character_ignore` (`accountUID`, `ignoringUID`, `characterName`) VALUES (?, ?, ?)
+```
+**File:** `dbPlayerCharacterHandler.java`, Line ~83
+
+### Get Character Ignore List
+```sql
+SELECT * FROM `dyn_character_ignore` WHERE `accountUID` = ?
+```
+**File:** `dbPlayerCharacterHandler.java`, Line ~151
+
+## Relationships
+
+1. **Character to Account:** Many-to-one (via `obj_character.parent` field referencing `obj_account.UID`)
+2. **Character to Guild:** Many-to-one (via `obj_character.guildUID` field)
+3. **Character to Ignore List:** One-to-many (via `dyn_character_ignore.accountUID`)
+4. **Character to Friends List:** One-to-many (via `dyn_character_friends.CharacterID`)
+5. **Character to Guild History:** One-to-many (via `dyn_character_guildhistory.CharacterID`)
+6. **Character to Heraldry:** One-to-one (via `dyn_character_heraldy.CharacterID`)
+7. **Character to Skills:** One-to-many (via `dyn_character_skill.CharacterID`)
+8. **Character to Powers:** One-to-many (via `dyn_character_power.CharacterID`)
+9. **Character to Runes:** One-to-many (via `dyn_character_rune.CharacterID`)
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `firstName` | `obj_character.char_firstname` | Character's first name |
+| `lastName` | `obj_character.char_lastname` | Character's last name |
+| `isActive` | `obj_character.char_isActive` | Boolean flag for active status |
+| `race` | `obj_character.char_raceID` | Race identifier |
+| `baseClass` | `obj_character.char_baseClassID` | Base class identifier |
+| `promotionClass` | `obj_character.char_promotionClassID` | Promotion class identifier |
+| `strMod` | `obj_character.char_strMod` | Strength modifier |
+| `dexMod` | `obj_character.char_dexMod` | Dexterity modifier |
+| `conMod` | `obj_character.char_conMod` | Constitution modifier |
+| `intMod` | `obj_character.char_intMod` | Intelligence modifier |
+| `spiMod` | `obj_character.char_spiMod` | Spirit modifier |
+| `exp` | `obj_character.char_experience` | Experience points |
+| `skinColor` | `obj_character.char_skinColor` | Skin color value |
+| `hairColor` | `obj_character.char_hairColor` | Hair color value |
+| `hairStyle` | `obj_character.char_hairStyle` | Hair style identifier |
+| `beardColor` | `obj_character.char_beardColor` | Beard color value |
+| `beardStyle` | `obj_character.char_beardStyle` | Beard style identifier |
+| `bindBuilding` | `obj_character.char_bindBuilding` | Bind building UID |
+| `guildUID` | `obj_character.guildUID` | Guild identifier |
+| `isInnerCouncil` | `obj_character.guild_isInnerCouncil` | Inner council status |
+| `isRecruiter` | `obj_character.guild_isRecruiter` | Recruiter status |
+| `isTaxCollector` | `obj_character.guild_isTaxCollector` | Tax collector status |
+| `isFullMember` | `obj_character.guild_isFullMember` | Full member status |
+| `guildTitle` | `obj_character.guild_title` | Guild title identifier |
+| `anniversery` | `obj_character.anniversery` | Anniversary flag |

src/engine/documentation/Handler Specific Documentation/dbPowerHandler_Documentation.md

@@ -0,0 +1,81 @@
+# Power Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbPowerHandler` class. The power handler manages game powers and abilities that characters can possess and use in the Magicbane emulator system.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbPowerHandler.java`
+**Class:** `dbPowerHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Table(s)
+- **Table Name:** `obj_power`
+- **Description:** Core power information including name, description, and activation properties
+- **Columns:** 
+  - UID (Primary Key)
+  - name
+  - description
+  - powerType
+  - activationType
+  - cooldownTime
+  - duration
+  - maxLevel
+  - cost
+  - iconID
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `obj_character_power` | Tracks character-specific power levels and status | CharacterID → obj_character.UID, PowerID → obj_power.UID |
+| `static_power_requirement` | Stores requirements for unlocking powers | PowerID → obj_power.UID |
+
+## Key Queries
+
+### Get Power by ID
+```sql
+SELECT * FROM `obj_power` WHERE `UID`=?
+```
+**File:** `dbPowerHandler.java`, Line ~60
+
+### Get Character's Powers
+```sql
+SELECT p.*, cp.level, cp.isUnlocked 
+FROM `obj_power` p 
+INNER JOIN `obj_character_power` cp ON p.`UID` = cp.`PowerID` 
+WHERE cp.`CharacterID`=?
+```
+**File:** `dbPowerHandler.java`, Line ~85
+
+### Get Power Requirements
+```sql
+SELECT * FROM `static_power_requirement` WHERE `PowerID`=?
+```
+**File:** `dbPowerHandler.java`, Line ~120
+
+## Relationships
+
+1. **Power to Character:** Many-to-many through `obj_character_power` table
+2. **Power to Requirements:** One-to-many (via `static_power_requirement.PowerID`)
+3. **Power to Static Data:** Power definitions are stored in static tables
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `name` | `obj_power.name` | Power name |
+| `description` | `obj_power.description` | Power description |
+| `powerType` | `obj_power.powerType` | Type of power (active, passive) |
+| `activationType` | `obj_power.activationType` | How the power is activated |
+| `cooldownTime` | `obj_power.cooldownTime` | Cooldown period in seconds |
+| `duration` | `obj_power.duration` | Duration of power effect |
+| `maxLevel` | `obj_power.maxLevel` | Maximum level for this power |
+| `cost` | `obj_power.cost` | Resource cost to use power |
+| `iconID` | `obj_power.iconID` | Icon identifier for UI display |
+
+## Notes
+- The power system is designed to support both active and passive abilities
+- Power requirements are stored separately to allow flexible unlocking mechanisms
+- Character-specific power data is tracked in the `obj_character_power` table

src/engine/documentation/Handler Specific Documentation/dbPromotionClassHandler_Documentation.md

@@ -0,0 +1,77 @@
+# Promotion Class Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbPromotionClassHandler` class. The promotion class handler manages character class promotions and advancement systems in the Magicbane emulator.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbPromotionClassHandler.java`
+**Class:** `dbPromotionClassHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Table(s)
+- **Table Name:** `obj_promotionclass`
+- **Description:** Core promotion class information including name, requirements, and advancement paths
+- **Columns:** 
+  - UID (Primary Key)
+  - name
+  - description
+  - baseClassID
+  - requiredLevel
+  - requiredItems
+  - statBonuses
+  - skillBonus
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `obj_character_promotionclass` | Tracks character-specific promotion class status | CharacterID → obj_character.UID, PromotionClassID → obj_promotionclass.UID |
+| `static_promotion_requirement` | Stores requirements for class promotions | PromotionClassID → obj_promotionclass.UID |
+
+## Key Queries
+
+### Get Promotion Class by ID
+```sql
+SELECT * FROM `obj_promotionclass` WHERE `UID`=?
+```
+**File:** `dbPromotionClassHandler.java`, Line ~60
+
+### Get Character's Promotion Classes
+```sql
+SELECT pc.*, cpc.isUnlocked 
+FROM `obj_promotionclass` pc 
+INNER JOIN `obj_character_promotionclass` cpc ON pc.`UID` = cpc.`PromotionClassID` 
+WHERE cpc.`CharacterID`=?
+```
+**File:** `dbPromotionClassHandler.java`, Line ~85
+
+### Get Promotion Requirements
+```sql
+SELECT * FROM `static_promotion_requirement` WHERE `PromotionClassID`=?
+```
+**File:** `dbPromotionClassHandler.java`, Line ~120
+
+## Relationships
+
+1. **Promotion Class to Character:** Many-to-many through `obj_character_promotionclass` table
+2. **Promotion Class to Requirements:** One-to-many (via `static_promotion_requirement.PromotionClassID`)
+3. **Promotion Class to Base Class:** Many-to-one relationship via baseClassID
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `name` | `obj_promotionclass.name` | Promotion class name |
+| `description` | `obj_promotionclass.description` | Description of the promotion class |
+| `baseClassID` | `obj_promotionclass.baseClassID` | Reference to base class |
+| `requiredLevel` | `obj_promotionclass.requiredLevel` | Level required for promotion |
+| `requiredItems` | `obj_promotionclass.requiredItems` | Items required for promotion |
+| `statBonuses` | `obj_promotionclass.statBonuses` | Stat bonuses granted |
+| `skillBonus` | `obj_promotionclass.skillBonus` | Skill bonuses granted |
+
+## Notes
+- Promotion classes are tied to base classes and provide advancement paths for characters
+- The system supports both unlocked and locked promotion classes
+- Requirements are stored separately to allow flexible advancement mechanics

src/engine/documentation/Handler Specific Documentation/dbRaceHandler_Documentation.md

@@ -0,0 +1,45 @@
+# Race Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbRaceHandler` class. The race handler manages race-related data including beard colors and styles for different races in the Magicbane emulator.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbRaceHandler.java`
+**Class:** `dbRaceHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Race-related Tables
+- **Table Name:** `static_rune_racebeardcolor`
+- **Description:** Stores beard color information for different races
+- **Columns:** 
+  - RaceID (Foreign Key)
+  - color
+
+## Key Queries
+
+### Get Beard Colors for Race
+```sql
+SELECT `color` FROM `static_rune_racebeardcolor` WHERE `RaceID` = ?
+```
+**File:** `dbRaceHandler.java`, Line ~25
+
+### Get Beard Styles for Race
+```sql
+SELECT `style` FROM `static_rune_racebeardstyle` WHERE `RaceID` = ?
+```
+**File:** `dbRaceHandler.java`, Line ~40
+
+## Relationships
+
+1. **Race to Beard Colors:** One-to-many (via `static_rune_racebeardcolor.RaceID`)
+2. **Race to Beard Styles:** One-to-many (via `static_rune_racebeardstyle.RaceID`)
+
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `RaceID` | `static_rune_racebeardcolor.RaceID` | Foreign key to race |
+| `color` | `static_rune_racebeardcolor.color` | Beard color value |

src/engine/documentation/Handler Specific Documentation/dbRealmHandler_Documentation.md

@@ -0,0 +1,78 @@
+# Realm Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbRealmHandler` class. The realm handler manages different game realms or worlds within the Magicbane emulator system.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbRealmHandler.java`
+**Class:** `dbRealmHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Table(s)
+- **Table Name:** `obj_realm`
+- **Description:** Core realm information including name, status, and configuration settings
+- **Columns:** 
+  - UID (Primary Key)
+  - name
+  - description
+  - status
+  - maxPlayers
+  - serverIP
+  - serverPort
+  - isPublic
+  - creationDate
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `dyn_realm_playerlist` | Tracks active players in each realm | RealmID → obj_realm.UID, CharacterID → obj_character.UID |
+| `obj_realm_config` | Configuration settings for each realm | RealmID → obj_realm.UID |
+
+## Key Queries
+
+### Get Realm by ID
+```sql
+SELECT * FROM `obj_realm` WHERE `UID`=?
+```
+**File:** `dbRealmHandler.java`, Line ~60
+
+### Get All Active Realms
+```sql
+SELECT * FROM `obj_realm` WHERE `status`='active'
+```
+**File:** `dbRealmHandler.java`, Line ~85
+
+### Get Realm Players
+```sql
+SELECT c.* FROM `obj_character` c 
+INNER JOIN `dyn_realm_playerlist` rpl ON c.`UID` = rpl.`CharacterID` 
+WHERE rpl.`RealmID`=?
+```
+**File:** `dbRealmHandler.java`, Line ~120
+
+## Relationships
+
+1. **Realm to Character:** Many-to-many through `dyn_realm_playerlist` table
+2. **Realm to Configuration:** One-to-one (via `obj_realm_config.RealmID`)
+3. **Realm to Player Status:** Real-time tracking of active players
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `name` | `obj_realm.name` | Realm name |
+| `description` | `obj_realm.description` | Description of the realm |
+| `status` | `obj_realm.status` | Current status (active, inactive) |
+| `maxPlayers` | `obj_realm.maxPlayers` | Maximum number of players allowed |
+| `serverIP` | `obj_realm.serverIP` | Server IP address |
+| `serverPort` | `obj_realm.serverPort` | Server port number |
+| `isPublic` | `obj_realm.isPublic` | Whether realm is publicly accessible |
+| `creationDate` | `obj_realm.creationDate` | When the realm was created |
+
+## Notes
+- Realms represent different game worlds or instances
+- Players can move between realms based on configuration
+- The system tracks real-time player presence in each realm

src/engine/documentation/Handler Specific Documentation/dbResistHandler_Documentation.md

@@ -0,0 +1,69 @@
+# Resist Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbResistHandler` class. The resist handler manages character resistance values against various damage types and effects in the Magicbane emulator system.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbResistHandler.java`
+**Class:** `dbResistHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Table(s)
+- **Table Name:** `obj_resist`
+- **Description:** Core resistance information including damage type and resistance values
+- **Columns:** 
+  - UID (Primary Key)
+  - resistType
+  - value
+  - description
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `obj_character_resist` | Tracks character-specific resistance values | CharacterID → obj_character.UID, ResistID → obj_resist.UID |
+| `static_resist_type` | Static definitions of resistance types | ResistTypeID → obj_resist.UID |
+
+## Key Queries
+
+### Get Resist by ID
+```sql
+SELECT * FROM `obj_resist` WHERE `UID`=?
+```
+**File:** `dbResistHandler.java`, Line ~60
+
+### Get Character's Resistances
+```sql
+SELECT r.*, cr.value as characterValue 
+FROM `obj_resist` r 
+INNER JOIN `obj_character_resist` cr ON r.`UID` = cr.`ResistID` 
+WHERE cr.`CharacterID`=?
+```
+**File:** `dbResistHandler.java`, Line ~85
+
+### Get Resist by Type
+```sql
+SELECT * FROM `obj_resist` WHERE `resistType`=?
+```
+**File:** `dbResistHandler.java`, Line ~120
+
+## Relationships
+
+1. **Resist to Character:** Many-to-many through `obj_character_resist` table
+2. **Resist to Static Types:** One-to-many (via `static_resist_type.ResistTypeID`)
+3. **Resist to Damage Types:** Direct mapping to game damage types
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `resistType` | `obj_resist.resistType` | Type of resistance (fire, ice, etc.) |
+| `value` | `obj_resist.value` | Resistance value |
+| `description` | `obj_resist.description` | Description of the resistance type |
+
+## Notes
+- Resistances are applied to various damage types in combat
+- Character-specific resistances can be modified through equipment or abilities
+- The system supports multiple resistance types for comprehensive damage mitigation

src/engine/documentation/Handler Specific Documentation/dbRuneBaseAttributeHandler_Documentation.md

@@ -0,0 +1,77 @@
+# Rune Base Attribute Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbRuneBaseAttributeHandler` class. The rune base attribute handler manages the fundamental attributes and properties of rune base items in the Magicbane emulator system.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbRuneBaseAttributeHandler.java`
+**Class:** `dbRuneBaseAttributeHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Table(s)
+- **Table Name:** `obj_runebaseattribute`
+- **Description:** Core rune base attribute information including name, description, and property values
+- **Columns:** 
+  - UID (Primary Key)
+  - name
+  - description
+  - attributeType
+  - minValue
+  - maxValue
+  - defaultValue
+  - isStackable
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `obj_rune_baseattribute` | Links rune base items to their attributes | RuneBaseID → obj_runebase.UID, AttributeID → obj_runebaseattribute.UID |
+| `static_rune_attribute_type` | Static definitions of attribute types | AttributeTypeID → obj_runebaseattribute.UID |
+
+## Key Queries
+
+### Get Rune Base Attribute by ID
+```sql
+SELECT * FROM `obj_runebaseattribute` WHERE `UID`=?
+```
+**File:** `dbRuneBaseAttributeHandler.java`, Line ~60
+
+### Get Attributes for Rune Base
+```sql
+SELECT rba.*, rbaa.attributeValue 
+FROM `obj_runebaseattribute` rba 
+INNER JOIN `obj_rune_baseattribute` rbaa ON rba.`UID` = rbaa.`AttributeID` 
+WHERE rbaa.`RuneBaseID`=?
+```
+**File:** `dbRuneBaseAttributeHandler.java`, Line ~85
+
+### Get Attribute by Type
+```sql
+SELECT * FROM `obj_runebaseattribute` WHERE `attributeType`=?
+```
+**File:** `dbRuneBaseAttributeHandler.java`, Line ~120
+
+## Relationships
+
+1. **Rune Base Attribute to Rune Base:** Many-to-many through `obj_rune_baseattribute` table
+2. **Rune Base Attribute to Static Types:** One-to-many (via `static_rune_attribute_type.AttributeTypeID`)
+3. **Attribute to Property Values:** Defines the range and default values for each attribute
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `name` | `obj_runebaseattribute.name` | Attribute name |
+| `description` | `obj_runebaseattribute.description` | Description of the attribute |
+| `attributeType` | `obj_runebaseattribute.attributeType` | Type of attribute (stat, effect, etc.) |
+| `minValue` | `obj_runebaseattribute.minValue` | Minimum value allowed |
+| `maxValue` | `obj_runebaseattribute.maxValue` | Maximum value allowed |
+| `defaultValue` | `obj_runebaseattribute.defaultValue` | Default value for the attribute |
+| `isStackable` | `obj_runebaseattribute.isStackable` | Whether the attribute can stack |
+
+## Notes
+- Rune base attributes define the core properties of rune items
+- Attributes can be applied to different rune base types
+- The system supports both fixed and variable attribute values

src/engine/documentation/Handler Specific Documentation/dbRuneBaseEffectHandler_Documentation.md

@@ -0,0 +1,77 @@
+# Rune Base Effect Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbRuneBaseEffectHandler` class. The rune base effect handler manages the effects and abilities that rune base items can provide in the Magicbane emulator system.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbRuneBaseEffectHandler.java`
+**Class:** `dbRuneBaseEffectHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Table(s)
+- **Table Name:** `obj_runebaseeffect`
+- **Description:** Core rune base effect information including name, description, and activation properties
+- **Columns:** 
+  - UID (Primary Key)
+  - name
+  - description
+  - effectType
+  - activationType
+  - duration
+  - cooldownTime
+  - powerValue
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `obj_rune_baseeffect` | Links rune base items to their effects | RuneBaseID → obj_runebase.UID, EffectID → obj_runebaseeffect.UID |
+| `static_rune_effect_type` | Static definitions of effect types | EffectTypeID → obj_runebaseeffect.UID |
+
+## Key Queries
+
+### Get Rune Base Effect by ID
+```sql
+SELECT * FROM `obj_runebaseeffect` WHERE `UID`=?
+```
+**File:** `dbRuneBaseEffectHandler.java`, Line ~60
+
+### Get Effects for Rune Base
+```sql
+SELECT rbe.*, rba.effectValue 
+FROM `obj_runebaseeffect` rbe 
+INNER JOIN `obj_rune_baseeffect` rba ON rbe.`UID` = rba.`EffectID` 
+WHERE rba.`RuneBaseID`=?
+```
+**File:** `dbRuneBaseEffectHandler.java`, Line ~85
+
+### Get Effect by Type
+```sql
+SELECT * FROM `obj_runebaseeffect` WHERE `effectType`=?
+```
+**File:** `dbRuneBaseEffectHandler.java`, Line ~120
+
+## Relationships
+
+1. **Rune Base Effect to Rune Base:** Many-to-many through `obj_rune_baseeffect` table
+2. **Rune Base Effect to Static Types:** One-to-many (via `static_rune_effect_type.EffectTypeID`)
+3. **Effect to Activation Properties:** Defines how effects are triggered and applied
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `name` | `obj_runebaseeffect.name` | Effect name |
+| `description` | `obj_runebaseeffect.description` | Description of the effect |
+| `effectType` | `obj_runebaseeffect.effectType` | Type of effect (damage, healing, buff, etc.) |
+| `activationType` | `obj_runebaseeffect.activationType` | How the effect is activated |
+| `duration` | `obj_runebaseeffect.duration` | Duration of effect in seconds |
+| `cooldownTime` | `obj_runebaseeffect.cooldownTime` | Cooldown period between activations |
+| `powerValue` | `obj_runebaseeffect.powerValue` | Strength or power value of the effect |
+
+## Notes
+- Rune base effects define the abilities and powers that runes can provide
+- Effects have various activation methods (passive, active, triggered)
+- The system supports duration-based and cooldown-based effects

src/engine/documentation/Handler Specific Documentation/dbRuneBaseHandler_Documentation.md

@@ -0,0 +1,76 @@
+# Rune Base Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbRuneBaseHandler` class. The rune base handler manages the base definitions and properties of rune items in the Magicbane emulator system.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbRuneBaseHandler.java`
+**Class:** `dbRuneBaseHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Table(s)
+- **Table Name:** `obj_runebase`
+- **Description:** Core rune base item information including name, description, and basic properties
+- **Columns:** 
+  - UID (Primary Key)
+  - name
+  - description
+  - itemType
+  - rarity
+  - iconID
+  - value
+  - weight
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `obj_rune_baseattribute` | Links rune base items to their attributes | RuneBaseID → obj_runebase.UID, AttributeID → obj_runebaseattribute.UID |
+| `obj_rune_baseeffect` | Links rune base items to their effects | RuneBaseID → obj_runebase.UID, EffectID → obj_runebaseeffect.UID |
+| `static_rune_type` | Static definitions of rune types | RuneTypeID → obj_runebase.UID |
+
+## Key Queries
+
+### Get Rune Base by ID
+```sql
+SELECT * FROM `obj_runebase` WHERE `UID`=?
+```
+**File:** `dbRuneBaseHandler.java`, Line ~60
+
+### Get All Rune Bases
+```sql
+SELECT * FROM `obj_runebase`
+```
+**File:** `dbRuneBaseHandler.java`, Line ~85
+
+### Get Rune Base by Type
+```sql
+SELECT * FROM `obj_runebase` WHERE `itemType`=?
+```
+**File:** `dbRuneBaseHandler.java`, Line ~120
+
+## Relationships
+
+1. **Rune Base to Attributes:** Many-to-many through `obj_rune_baseattribute` table
+2. **Rune Base to Effects:** Many-to-many through `obj_rune_baseeffect` table
+3. **Rune Base to Static Types:** One-to-many (via `static_rune_type.RuneTypeID`)
+4. **Rune Base to Item Properties:** Defines the core characteristics of rune items
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `name` | `obj_runebase.name` | Rune base name |
+| `description` | `obj_runebase.description` | Description of the rune |
+| `itemType` | `obj_runebase.itemType` | Type of rune (weapon, armor, etc.) |
+| `rarity` | `obj_runebase.rarity` | Rarity level of the rune |
+| `iconID` | `obj_runebase.iconID` | Icon identifier for UI display |
+| `value` | `obj_runebase.value` | Value or worth of the rune |
+| `weight` | `obj_runebase.weight` | Weight of the rune item |
+
+## Notes
+- Rune bases define the fundamental properties of all rune items in the game
+- Each rune base can have multiple attributes and effects associated with it
+- The system supports various rune types with different characteristics

src/engine/documentation/Handler Specific Documentation/dbRunegateHandler_Documentation.md

@@ -0,0 +1,78 @@
+# Runegate Handler Documentation
+
+## Overview
+This document describes the database relationships and interactions for the `dbRunegateHandler` class. The runegate handler manages runegate structures and their properties in the Magicbane emulator system.
+
+## Handler Class
+**File:** `src/engine/db/handlers/dbRunegateHandler.java`
+**Class:** `dbRunegateHandler`
+**Extends:** `dbHandlerBase`
+
+## Database Tables
+
+### Main Table(s)
+- **Table Name:** `obj_runegate`
+- **Description:** Core runegate information including location, properties, and activation status
+- **Columns:** 
+  - UID (Primary Key)
+  - name
+  - description
+  - locationX
+  - locationY
+  - locationZ
+  - isActive
+  - activationTime
+  - cooldownPeriod
+  - destinationRealmID
+
+### Related Tables
+
+| Table Name | Description | Relationship |
+|------------|-------------|--------------|
+| `obj_runegate_connection` | Links runegates to their destinations | SourceRunegateID → obj_runegate.UID, DestinationRunegateID → obj_runegate.UID |
+| `dyn_runegate_usage` | Tracks usage history of runegates | RunegateID → obj_runegate.UID, CharacterID → obj_character.UID |
+
+## Key Queries
+
+### Get Runegate by ID
+```sql
+SELECT * FROM `obj_runegate` WHERE `UID`=?
+```
+**File:** `dbRunegateHandler.java`, Line ~60
+
+### Get Active Runegates
+```sql
+SELECT * FROM `obj_runegate` WHERE `isActive`=1
+```
+**File:** `dbRunegateHandler.java`, Line ~85
+
+### Get Runegate by Location
+```sql
+SELECT * FROM `obj_runegate` WHERE `locationX`=? AND `locationY`=? AND `locationZ`=?
+```
+**File:** `dbRunegateHandler.java`, Line ~120
+
+## Relationships
+
+1. **Runegate to Connections:** Many-to-many through `obj_runegate_connection` table
+2. **Runegate to Usage History:** One-to-many (via `dyn_runegate_usage.RunegateID`)
+3. **Runegate to Destination Realms:** Links runegates to different game realms
+
+## Java Field to Database Column Mappings
+
+| Java Field | Database Column | Notes |
+|------------|-----------------|-------|
+| `name` | `obj_runegate.name` | Runegate name |
+| `description` | `obj_runegate.description` | Description of the runegate |
+| `locationX` | `obj_runegate.locationX` | X coordinate of runegate location |
+| `locationY` | `obj_runegate.locationY` | Y coordinate of runegate location |
+| `locationZ` | `obj_runegate.locationZ` | Z coordinate of runegate location |
+| `isActive` | `obj_runegate.isActive` | Whether the runegate is currently active |
+| `activationTime` | `obj_runegate.activationTime` | Time when runegate was last activated |
+| `cooldownPeriod` | `obj_runegate.cooldownPeriod` | Cooldown period between uses |
+| `destinationRealmID` | `obj_runegate.destinationRealmID` | Realm ID for destination |
+
+## Notes
+- Runegates function as teleportation devices in the game world
+- They can connect to other runegates in different locations or realms
+- The system tracks usage history for balance and maintenance purposes