Update the version number to a1.5.0-pre

Added config to draw always in generation quality (if true the game will crash with  render distance>256)

.gitignore

@@ -22,4 +22,5 @@ eclipse
 run
 
 # Files from Forge MDK
+logs
 forge*changelog.txt

CREDITS.txt

@@ -1,65 +0,0 @@
-Minecraft Forge: Credits/Thank You
-
-Forge is a set of tools and modifications to the Minecraft base game code to assist 
-mod developers in creating new and exciting content. It has been in development for 
-several years now, but I would like to take this time thank a few people who have 
-helped it along it's way.
-
-First, the people who originally created the Forge projects way back in Minecraft 
-alpha. Eloraam of RedPower, and SpaceToad of Buildcraft, without their acceptiance 
-of me taking over the project, who knows what Minecraft modding would be today.
-
-Secondly, someone who has worked with me, and developed some of the core features
-that allow modding to be as functional, and as simple as it is, cpw. For developing
-FML, which stabelized the client and server modding ecosystem. As well as the base
-loading system that allows us to modify Minecraft's code as elegently as possible.
-
-Mezz, who has stepped up as the issue and pull request manager. Helping to keep me
-sane as well as guiding the community into creating better additions to Forge.
-
-Searge, Bspks, Fesh0r, ProfMobious, and all the rest over on the MCP team {of which 
-I am a part}. For creating some of the core tools needed to make Minecraft modding 
-both possible, and as stable as can be.
-  On that note, here is some specific information of the MCP data we use:
-    * Minecraft Coder Pack (MCP) *
-      Forge Mod Loader and Minecraft Forge have permission to distribute and automatically 
-      download components of MCP and distribute MCP data files. This permission is not 
-      transitive and others wishing to redistribute the Minecraft Forge source independently
-      should seek permission of MCP or remove the MCP data files and request their users 
-      to download MCP separately.
-      
-And lastly, the countless community members who have spent time submitting bug reports, 
-pull requests, and just helping out the community in general. Thank you.
-
---LexManos
-
-=========================================================================
-
-This is Forge Mod Loader.
-
-You can find the source code at all times at https://github.com/MinecraftForge/MinecraftForge/tree/1.12.x/src/main/java/net/minecraftforge/fml
-
-This minecraft mod is a clean open source implementation of a mod loader for minecraft servers
-and minecraft clients.
-
-The code is authored by cpw.
-
-It began by partially implementing an API defined by the client side ModLoader, authored by Risugami.
-http://www.minecraftforum.net/topic/75440-
-This support has been dropped as of Minecraft release 1.7, as Risugami no longer maintains ModLoader.
-
-It also contains suggestions and hints and generous helpings of code from LexManos, author of MinecraftForge.
-http://www.minecraftforge.net/
-
-Additionally, it contains an implementation of topological sort based on that 
-published at http://keithschwarz.com/interesting/code/?dir=topological-sort
-
-It also contains code from the Maven project for performing versioned dependency
-resolution. http://maven.apache.org/
-
-It also contains a partial repackaging of the javaxdelta library from http://sourceforge.net/projects/javaxdelta/
-with credit to it's authors.
-
-Forge Mod Loader downloads components from the Minecraft Coder Pack
-(http://mcp.ocean-labs.de/index.php/Main_Page) with kind permission from the MCP team.
-

Readme.txt

@@ -4,17 +4,14 @@ allowing for an increased view distance without harming performance.
 
 Or in other words: this mod let's you see farther without turning your game into a slide show.
 If you want to see a quick demo, check out the video I made here:
-https://youtu.be/v61iOYZQWCs
+https://youtu.be/CCT-3s02tYA
 
 
-Forge version: 1.16.4-35.1.4
+Forge version: 1.16.5-36.1.0
 
 Notes:
-This version has been confirmed to work in Eclipse and retail Minecraft.
-(retail running forge 1.16.4-35.1.37)
-That being said only singleplayer is currently supported; connecting
-to servers (local or otherwise) will cause no LODs to be drawn and
-may cause instibility.
+This version has been confirmed to work in Eclipse and Retail Minecraft.
+(Retail running forge version 1.16.5-36.1.0)
 
 
 ========================
@@ -67,3 +64,7 @@ Note to self
 
 The Minecraft source code is NOT added to your workspace in a editable way. Minecraft is treated like a normal Library. Sources are there for documentation and research purposes only.
 
+Source code uses mcp mappings not Mojangs.
+
+The source code can be 'created' with the ./eclipse command and can be found in the following path:
+minecraft-lod-mod\build\fg_cache\mcp\ VERSION \joined\ RANDOM_STRING \patch\output.jar

build.gradle

@@ -1,11 +1,12 @@
 buildscript {
     repositories {
-        maven { url = 'https://files.minecraftforge.net/maven' }
-        jcenter()
+        maven { url = 'https://files.minecraftforge.net' }
         mavenCentral()
+        // potential replacement in case of problems:
+		// https://dist.creeper.host/Sponge/maven
 		maven { url = 'https://repo.spongepowered.org/maven/' }
-		// potential replacement in case of problems:
-		// https://dist.creeper.host/Sponge/maven 
+		// used to download and compile dependencies from git repos 
+		maven { url 'https://jitpack.io' }
     }
     dependencies {
         classpath group: 'net.minecraftforge.gradle', name: 'ForgeGradle', version: '3.+', changing: true
@@ -18,9 +19,10 @@ apply plugin: 'org.spongepowered.mixin'
 apply plugin: 'eclipse'
 apply plugin: 'maven-publish'
 
-version = 'a1.2'
-group = 'com.backsun.lod'
-archivesBaseName = 'lod_1.16.4'
+version = 'a1.5.0-pre'
+group = 'com.seibel.lod'
+archivesBaseName = 'lod_1.16.5'
+
 
 sourceCompatibility = targetCompatibility = compileJava.sourceCompatibility = compileJava.targetCompatibility = '1.8' // Need this here so eclipse task generates correctly.
 
@@ -31,7 +33,7 @@ minecraft {
     // stable_#            Stables are built at the discretion of the MCP team.
     // Use non-default mappings at your own risk. they may not always work.
     // Simply re-run your setup task after changing the mappings to update your workspace.
-    mappings channel: 'snapshot', version: '20201028-1.16.3'
+	mappings channel: 'official', version: '1.16.5'
 
     // makeObfSourceJar = false // an Srg named sources jar is made by default. uncomment this to disable.
     
@@ -45,9 +47,15 @@ minecraft {
 			arg "-mixin.config=lod.mixins.json"
 
             // Recommended logging data for a userdev environment
-            property 'forge.logging.markers', 'SCAN,REGISTRIES,REGISTRYDUMP'
+            // The markers can be changed as needed. 
+            // "SCAN": For mods scan.
+            // "REGISTRIES": For firing of registry events.
+            // "REGISTRYDUMP": For getting the contents of all registries.
+            property 'forge.logging.markers', 'REGISTRIES'
 
             // Recommended logging level for the console
+            // You can set various levels here.
+            // Please read: https://stackoverflow.com/questions/2031163/when-to-use-the-different-log-levels
             property 'forge.logging.console.level', 'debug'
 
             mods {
@@ -62,9 +70,15 @@ minecraft {
 			arg "-mixin.config=lod.mixins.json"
 			
             // Recommended logging data for a userdev environment
-            property 'forge.logging.markers', 'SCAN,REGISTRIES,REGISTRYDUMP'
+            // The markers can be changed as needed. 
+            // "SCAN": For mods scan.
+            // "REGISTRIES": For firing of registry events.
+            // "REGISTRYDUMP": For getting the contents of all registries.
+            property 'forge.logging.markers', 'REGISTRIES'
 
             // Recommended logging level for the console
+            // You can set various levels here.
+            // Please read: https://stackoverflow.com/questions/2031163/when-to-use-the-different-log-levels
             property 'forge.logging.console.level', 'debug'
 
             mods {
@@ -78,9 +92,15 @@ minecraft {
             workingDirectory project.file('run')
 
             // Recommended logging data for a userdev environment
-            property 'forge.logging.markers', 'SCAN,REGISTRIES,REGISTRYDUMP'
+            // The markers can be changed as needed. 
+            // "SCAN": For mods scan.
+            // "REGISTRIES": For firing of registry events.
+            // "REGISTRYDUMP": For getting the contents of all registries.
+            property 'forge.logging.markers', 'REGISTRIES'
 
             // Recommended logging level for the console
+            // You can set various levels here.
+            // Please read: https://stackoverflow.com/questions/2031163/when-to-use-the-different-log-levels
             property 'forge.logging.console.level', 'debug'
 
             // Specify the modid for data generation, where to output the resulting resource, and where to look for existing resources.
@@ -98,11 +118,52 @@ minecraft {
 // Include resources generated by data generators.
 sourceSets.main.resources { srcDir 'src/generated/resources' }
 
+// this is required so that we can use 
+// jitpack in the dependencies section below 
+repositories {
+    mavenCentral()
+	// used to download and compile dependencies from git repos 
+	maven { url 'https://jitpack.io' }
+}
+
 dependencies {
     // Specify the version of Minecraft to use, If this is any group other then 'net.minecraft' it is assumed
     // that the dep is a ForgeGradle 'patcher' dependency. And it's patches will be applied.
     // The userdev artifact is a special name and will get all sorts of transformations applied to it.
-    minecraft 'net.minecraftforge:forge:1.16.4-35.1.4'
+    minecraft 'net.minecraftforge:forge:1.16.5-36.1.0'
+	
+	// these aren't needed right now
+	//implementation ('com.github.KaptainWutax:TerrainUtils:1.0.0'){
+    //    transitive = false
+    //}
+	//implementation ('com.github.KaptainWutax:BiomeUtils:1.0.0'){
+    //    transitive = false
+    //}
+    //implementation ('com.github.KaptainWutax:SeedUtils:-SNAPSHOT'){
+    //    transitive = false
+    //}
+    //implementation ('com.github.KaptainWutax:MCUtils:1.0.0'){
+    //    transitive = false
+    //}
+    //implementation ('com.github.KaptainWutax:NoiseUtils:1.0.0'){
+    //    transitive = false
+    //}
+    //implementation ('com.github.KaptainWutax:MathUtils:-SNAPSHOT'){
+    //    transitive = false
+    //}
+    
+    // these were added to hopefully allow for cloning
+    // configuredFeatures to allow for safe
+    // multi threaded feature generation. Sadly I couldn't find
+    // a way to duplicate lambda functions (which features use)
+    // so for now I'm not sure what to do.
+    //implementation 'io.github.kostaskougios:cloning:1.10.3'
+    //
+    //implementation ('com.esotericsoftware:kryo:5.1.1') {
+    //  exclude group: "org.objenesis"
+    //}
+    //implementation 'org.objenesis:objenesis:3.2'
+
 
     // You may put jars on which you depend on in ./libs or you may define them like so..
     // compile "some.group:artifact:version:classifier"
@@ -128,10 +189,10 @@ dependencies {
 jar {
     manifest {
         attributes([
-            "Specification-Title": "Levels of Detail",
+            "Specification-Title": "LOD",
             "Specification-Version": "1", // We are version 1 of ourselves
             "Implementation-Title": project.name,
-            "Implementation-Version": "1.0",
+            "Implementation-Version": "1",
             "Implementation-Timestamp": new Date().format("yyyy-MM-dd'T'HH:mm:ssZ"),
 			"MixinConfigs": "lod.mixins.json",
         ])
@@ -159,4 +220,4 @@ publishing {
 
 mixin {
     add sourceSets.main, "lod.refmap.json"
-}
+}

src/main/java/com/seibel/lod/LodMain.java

@@ -1,9 +1,25 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.seibel.lod;
 
+import com.seibel.lod.config.LodConfig;
 import com.seibel.lod.proxy.ClientProxy;
-import com.seibel.lod.util.LodConfig;
 
-import net.minecraft.client.Minecraft;
 import net.minecraftforge.common.MinecraftForge;
 import net.minecraftforge.eventbus.api.SubscribeEvent;
 import net.minecraftforge.fml.ModLoadingContext;
@@ -21,7 +37,7 @@ import net.minecraftforge.fml.javafmlmod.FMLJavaModLoadingContext;
  * check out the ClientProxy.
  * 
  * @author James Seibel
- * @version 02-07-2021
+ * @version 7-3-2021
  */
 @Mod(ModInfo.MODID)
 public class LodMain
@@ -33,8 +49,7 @@ public class LodMain
 	
 	private void init(final FMLCommonSetupEvent event)
 	{
-		Minecraft.getInstance().getFramebuffer().enableStencil();
-		ModLoadingContext.get().registerConfig(ModConfig.Type.CLIENT, LodConfig.clientSpec);
+		ModLoadingContext.get().registerConfig(ModConfig.Type.CLIENT, LodConfig.CLIENT_SPEC);
 	}
 	
 	

src/main/java/com/seibel/lod/Main.java

@@ -0,0 +1,55 @@
+package com.seibel.lod;
+
+import java.util.HashMap;
+import java.util.Map;
+
+import com.seibel.lod.builders.lodTemplates.Box;
+import com.seibel.lod.util.DataPointUtil;
+
+import net.minecraft.util.Direction;
+
+public class Main
+{
+	public static void main(String[] args)
+	{
+		/*
+		try
+		{
+			@SuppressWarnings("serial")
+			Map<Direction, long[]> adjData = new HashMap<Direction, long[]>()
+			{{
+				put(Direction.EAST, new long[]{DataPointUtil.createDataPoint(60, 30, 0, 0, 0, 0), DataPointUtil.createDataPoint(25, 10, 0, 0, 0, 0)});
+				put(Direction.WEST,  new long[]{DataPointUtil.createDataPoint(60, 10, 0, 0, 0, 0)});
+				put(Direction.NORTH,  new long[]{DataPointUtil.createDataPoint(40, 20, 0, 0, 0, 0)});
+				put(Direction.SOUTH,  new long[]{DataPointUtil.createDataPoint(40, 20, 0, 0, 0, 0)});
+			}};
+
+			Box box = new Box();
+			int height = 60;
+			int depth = 20;
+
+			box.set(10, height - depth, 10);
+			box.move(0, depth, 0);
+			box.setAdjData(adjData);
+
+			for(Direction direction : Box.DIRECTIONS)
+			{
+				int adjIndex = 0;
+				while (box.shouldContinue(direction, adjIndex))
+				{
+					System.out.println(direction.toString());
+					for (int i = 0; i < 4; i++)
+					{
+						System.out.println(box.getX(direction, i) + " " + box.getY(direction, i, adjIndex) + " " + box.getZ(direction, i));
+					}
+					adjIndex++;
+				}
+			}
+
+		} catch (Exception e)
+		{
+			e.printStackTrace();
+		}
+		*/
+	}
+}

src/main/java/com/seibel/lod/ModInfo.java

@@ -1,15 +1,32 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.seibel.lod;
 
 /**
  * This file is similar to mcmod.info
  * 
  * @author James Seibel
- * @version 05-31-2021
+ * @version 08-29-2021
  */
 public final class ModInfo
 {	
 	public static final String MODID = "lod";
-	public static final String MODNAME = "Levels of Detail";
+	public static final String MODNAME = "LOD";
 	public static final String MODAPI = "LodAPI";
-	public static final String VERSION = "a1.2";
+	public static final String VERSION = "a1.5.0-pre";
 }

src/main/java/com/seibel/lod/builders/LodBufferBuilder.java

@@ -1,333 +1,601 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.seibel.lod.builders;
+
+import java.nio.ByteBuffer;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.concurrent.Callable;
 import java.util.concurrent.ExecutorService;
 import java.util.concurrent.Executors;
+import java.util.concurrent.Future;
+import java.util.concurrent.locks.ReentrantLock;
 
 import org.lwjgl.opengl.GL11;
+import org.lwjgl.opengl.GL15;
+import org.lwjgl.opengl.GL15C;
 
-import com.seibel.lod.objects.LodChunk;
+import com.seibel.lod.builders.lodTemplates.Box;
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.VerticalQuality;
 import com.seibel.lod.objects.LodDimension;
-import com.seibel.lod.objects.NearFarBuffer;
-import com.seibel.lod.render.LodRender;
-import com.seibel.lod.util.LodConfig;
+import com.seibel.lod.objects.LodRegion;
+import com.seibel.lod.objects.PosToRenderContainer;
+import com.seibel.lod.objects.RegionPos;
+import com.seibel.lod.proxy.ClientProxy;
+import com.seibel.lod.proxy.GlProxy;
+import com.seibel.lod.proxy.GlProxy.GlProxyContext;
+import com.seibel.lod.render.LodRenderer;
+import com.seibel.lod.util.DataPointUtil;
+import com.seibel.lod.util.DetailDistanceUtil;
+import com.seibel.lod.util.LevelPosUtil;
+import com.seibel.lod.util.LodThreadFactory;
+import com.seibel.lod.util.LodUtil;
 
-import net.minecraft.client.Minecraft;
 import net.minecraft.client.renderer.BufferBuilder;
+import net.minecraft.client.renderer.vertex.VertexBuffer;
+import net.minecraft.util.Direction;
+import net.minecraft.util.math.BlockPos;
 import net.minecraft.util.math.ChunkPos;
-import net.minecraftforge.common.WorldWorkerManager;
 
 /**
  * This object is used to create NearFarBuffer objects.
- * 
+ *
  * @author James Seibel
- * @version 05-06-2021
+ * @version 9-22-2021
  */
 public class LodBufferBuilder
 {
-	private Minecraft mc;
+	/**
+	 * This holds the thread used to generate new LODs off the main thread.
+	 */
+	public static ExecutorService mainGenThread = Executors.newSingleThreadExecutor(new LodThreadFactory(LodBufferBuilder.class.getSimpleName() + " - main"));
+	/**
+	 * This holds the threads used to generate buffers.
+	 */
+	public static ExecutorService bufferBuilderThreads = Executors.newFixedThreadPool(LodConfig.CLIENT.threading.numberOfBufferBuilderThreads.get(), new LodThreadFactory(LodBufferBuilder.class.getSimpleName() + " - builder"));
 	
-	/** This holds the thread used to generate new LODs off the main thread. */
-	private ExecutorService genThread = Executors.newSingleThreadExecutor();
+	/**
+	 * The buffers that are used to create LODs using far fog
+	 */
+	public volatile BufferBuilder[][] buildableBuffers;
 	
-	private LodBuilder lodBuilder;
+	/**
+	 * Used when building new VBOs
+	 */
+	public volatile VertexBuffer[][] buildableVbos;
 	
-	/** The buffers that are used to create LODs using near fog */
-	public volatile BufferBuilder buildableNearBuffer;
-	/** The buffers that are used to create LODs using far fog */
-	public volatile BufferBuilder buildableFarBuffer;
+	/**
+	 * VBOs that are sent over to the LodNodeRenderer
+	 */
+	public volatile VertexBuffer[][] drawableVbos;
 	
-	/** if this is true the LOD buffers are currently being
-	 * regenerated. */
-	public volatile boolean generatingBuffers = false;
+	/**
+	 * if this is true the LOD buffers are currently being
+	 * regenerated.
+	 */
+	public boolean generatingBuffers = false;
 	
-	/** if this is true new LOD buffers have been generated 
-	 * and are waiting to be swapped with the drawable buffers*/
-	private volatile boolean switchBuffers = false;
+	/**
+	 * if this is true new LOD buffers have been generated
+	 * and are waiting to be swapped with the drawable buffers
+	 */
+	private boolean switchVbos = false;
 	
-	/** If this is greater than 0 no new chunk generation requests will be made
-	 * this is to prevent chunks from being generated for a long time in an area
-	 * the player is no longer in. */
-	public int numberOfChunksWaitingToGenerate = 0;
+	/**
+	 * Size of the buffer builders in bytes last time we created them
+	 */
+	public int previousBufferSize = 0;
 	
-	/** how many chunks to generate outside of the player's
-	 * view distance at one time. (or more specifically how
-	 * many requests to make at one time) */
-	public int maxChunkGenRequests = 8;
+	/**
+	 * Width of the dimension in regions last time we created the buffers
+	 */
+	public int previousRegionWidth = 0;
 	
+	/**
+	 * this is used to prevent multiple threads creating, destroying, or using the buffers at the same time
+	 */
+	private ReentrantLock bufferLock = new ReentrantLock();
 	
-	public LodBufferBuilder(LodBuilder newLodBuilder)
+	//	private static final int NUMBER_OF_DIRECTION = 4;
+	//in order -x, +x, -z, +z
+	//	private static final int[][] ADJ_VECTOR = new int[][]{{1, 0}, {-1, 0}, {0, 1}, {0, -1}};
+	
+	private volatile Box[][] boxCache;
+	private volatile PosToRenderContainer[][] setsToRender;
+	private volatile RegionPos center;
+	
+	/**
+	 * This is the ChunkPos the player was at the last time the buffers were built.
+	 * IE the center of the buffers last time they were built
+	 */
+	private volatile ChunkPos drawableCenterChunkPos = new ChunkPos(0, 0);
+	private volatile ChunkPos buildableCenterChunkPos = new ChunkPos(0, 0);
+	private volatile boolean firstSetup = true;
+	public LodBufferBuilder()
 	{
-		mc = Minecraft.getInstance();
-		lodBuilder = newLodBuilder;
+		
 	}
 	
-	
-	
-	
-
 	/**
 	 * Create a thread to asynchronously generate LOD buffers
 	 * centered around the given camera X and Z.
 	 * <br>
-	 * This method will write to the drawableNearBuffers and drawableFarBuffers.
+	 * This method will write to the drawable near and far buffers.
 	 * <br>
 	 * After the buildable buffers have been generated they must be
 	 * swapped with the drawable buffers in the LodRenderer to be drawn.
 	 */
-	public void generateLodBuffersAsync(LodRender renderer, LodDimension lodDim,
-			double playerX, double playerZ, int numbChunksWide)
+	public void generateLodBuffersAsync(LodRenderer renderer, LodDimension lodDim,
+			BlockPos playerBlockPos, boolean fullRegen)
 	{
+		
 		// only allow one generation process to happen at a time
 		if (generatingBuffers)
 			return;
 		
-		if (buildableNearBuffer == null || buildableFarBuffer == null)
-			throw new IllegalStateException("generateLodBuffersAsync was called before the buildableNearBuffer and buildableFarBuffer were created.");
-		
-		
+		if (buildableBuffers == null)
+			// setupBuffers hasn't been called yet
+			return;
 		
 		generatingBuffers = true;
 		
+		// round the player's block position down to the nearest chunk BlockPos
+		ChunkPos playerChunkPos = new ChunkPos(playerBlockPos);
+		BlockPos playerBlockPosRounded = playerChunkPos.getWorldPosition();
 		
-		
-		// this seemingly useless math is required,
-		// just using (int) playerX/Z doesn't work
-		int playerXChunkOffset = ((int) playerX / LodChunk.WIDTH) * LodChunk.WIDTH;
-		int playerZChunkOffset = ((int) playerZ / LodChunk.WIDTH) * LodChunk.WIDTH;
-		// this is where we will start drawing squares
-		// (exactly half the total width)
-		int startX = (-LodChunk.WIDTH * (numbChunksWide / 2)) + playerXChunkOffset;
-		int startZ = (-LodChunk.WIDTH * (numbChunksWide / 2)) + playerZChunkOffset;
-		
-		
-		
-		Thread t = new Thread(()->
+		Thread thread = new Thread(() ->
 		{
-			// index of the chunk currently being added to the
-			// generation list
-			int chunkGenIndex = 0;
+			bufferLock.lock();
 			
-			ChunkPos[] chunksToGen = new ChunkPos[maxChunkGenRequests];
-			int minChunkDist = Integer.MAX_VALUE;
-			ChunkPos playerChunkPos = new ChunkPos((int)playerX / LodChunk.WIDTH, (int)playerZ / LodChunk.WIDTH);
-			
-			
-			// generate our new buildable buffers
-			buildableNearBuffer.begin(GL11.GL_QUADS, LodRender.LOD_VERTEX_FORMAT);
-			buildableFarBuffer.begin(GL11.GL_QUADS, LodRender.LOD_VERTEX_FORMAT);
-			
-			// x axis
-			for (int i = 0; i < numbChunksWide; i++)
+			try
 			{
-				// z axis
-				for (int j = 0; j < numbChunksWide; j++)
+				long treeStart = System.currentTimeMillis();
+				long treeEnd = System.currentTimeMillis();
+				
+				long startTime = System.currentTimeMillis();
+				
+				ArrayList<Callable<Boolean>> nodeToRenderThreads = new ArrayList<>(lodDim.getWidth() * lodDim.getWidth());
+				
+				//setupBuffers(lodDim);
+				startBuffers(fullRegen, lodDim);
+				
+				// =====================//
+				//    RENDERING PART    //
+				// =====================//
+				
+				RegionPos playerRegionPos = new RegionPos(playerChunkPos);
+				if (center == null)
+					center = playerRegionPos;
+				
+				if (setsToRender == null)
+					setsToRender = new PosToRenderContainer[lodDim.getWidth()][lodDim.getWidth()];
+				
+				if (setsToRender.length != lodDim.getWidth())
+					setsToRender = new PosToRenderContainer[lodDim.getWidth()][lodDim.getWidth()];
+				
+				if (boxCache == null)
+					boxCache = new Box[lodDim.getWidth()][lodDim.getWidth()];
+				
+				if (boxCache.length != lodDim.getWidth())
+					boxCache = new Box[lodDim.getWidth()][lodDim.getWidth()];
+				
+				// this will be the center of the VBOs once they have been built
+				buildableCenterChunkPos = playerChunkPos;
+				
+				for (int xRegion = 0; xRegion < lodDim.getWidth(); xRegion++)
 				{
-					// skip the middle
-					// (As the player moves some chunks will overlap or be missing,
-					// this is just how chunk loading/unloading works. This can hopefully
-					// be hidden with careful use of fog)
-					int middle = (numbChunksWide / 2);
-					if (isCoordInCenterArea(i, j, middle))
+					for (int zRegion = 0; zRegion < lodDim.getWidth(); zRegion++)
 					{
-						continue;
-					}
-					
-					
-					// set where this square will be drawn in the world
-					double xOffset = (LodChunk.WIDTH * i) + // offset by the number of LOD blocks
-									startX; // offset so the center LOD block is centered underneath the player
-					double yOffset = 0;
-					double zOffset = (LodChunk.WIDTH * j) + startZ;
-					
-					int chunkX = i + (startX / LodChunk.WIDTH);
-					int chunkZ = j + (startZ / LodChunk.WIDTH);
-					
-					LodChunk lod = lodDim.getLodFromCoordinates(chunkX, chunkZ);
-					
-					if (lod == null || lod.isLodEmpty())
-					{
-						// generate a new chunk if no chunk currently exists
-						// and we aren't waiting on any other chunks to generate
-						if (lod == null && numberOfChunksWaitingToGenerate == 0)
+						if (lodDim.isRegionToRegen(xRegion, zRegion) || fullRegen)
 						{
-							ChunkPos pos = new ChunkPos(chunkX, chunkZ);
+							RegionPos regionPos = new RegionPos(
+									xRegion + lodDim.getCenterX() - Math.floorDiv(lodDim.getWidth(), 2),
+									zRegion + lodDim.getCenterZ() - Math.floorDiv(lodDim.getWidth(), 2));
 							
-							// determine if this position is closer to the player
-							// than the previous
-							int newDistance = playerChunkPos.getChessboardDistance(pos);
+							// local position in the vbo and bufferBuilder arrays
+							BufferBuilder currentBuffer = buildableBuffers[xRegion][zRegion];
+							LodRegion region = lodDim.getRegion(regionPos.x, regionPos.z);
 							
-							if (newDistance < minChunkDist)
+							if (region == null)
+								continue;
+							
+							// make sure the buffers weren't
+							// changed while we were running this method
+							if (currentBuffer == null || !currentBuffer.building())
+								return;
+							
+							byte minDetail = region.getMinDetailLevel();
+							
+							
+							final int xR = xRegion;
+							final int zR = zRegion;
+							Callable<Boolean> dataToRenderThread = () ->
 							{
-								// this chunk is closer, clear any previous
-								// positions and update the new minimum distance
-								minChunkDist = newDistance;
+								Map<Direction, long[]> adjData = new HashMap<>();
 								
-								chunkGenIndex = 0;
-								chunksToGen = new ChunkPos[maxChunkGenRequests];
-								chunksToGen[chunkGenIndex] = pos;
-								chunkGenIndex++;
-							}
-							else if (newDistance <= minChunkDist)
-							{
-								// this chunk position is as close or closers than the
-								// minimum distance
-								if(chunkGenIndex < maxChunkGenRequests)
+								// determine how many LODs we can stack vertically
+								int maxVerticalData = 1;
+								if (LodConfig.CLIENT.worldGenerator.lodQualityMode.get() == VerticalQuality.MULTI_LOD)
 								{
-									// we are still under the number of chunks to generate
-									// add this position to the list
-									chunksToGen[chunkGenIndex] = pos;
-									chunkGenIndex++;
+									maxVerticalData = 256;
 								}
-							}
-							
+								
+								// create adjData's arrays
+								for (Direction direction : Box.ADJ_DIRECTIONS)
+								{
+									adjData.put(direction, new long[maxVerticalData]);
+								}
+								
+								//previous setToRender cache
+								if (setsToRender[xR][zR] == null)
+								{
+									setsToRender[xR][zR] = new PosToRenderContainer(minDetail, regionPos.x, regionPos.z);
+								}
+								
+								if (boxCache[xR][zR] == null)
+								{
+									boxCache[xR][zR] = new Box();
+								}
+								PosToRenderContainer posToRender = setsToRender[xR][zR];
+								posToRender.clear(minDetail, regionPos.x, regionPos.z);
+								
+								lodDim.getDataToRender(
+										posToRender,
+										regionPos,
+										playerBlockPosRounded.getX(),
+										playerBlockPosRounded.getZ());
+								
+								byte detailLevel;
+								int posX;
+								int posZ;
+								int xAdj;
+								int zAdj;
+								int chunkXdist;
+								int chunkZdist;
+								
+								// keep a local version so we don't have to worry about indexOutOfBounds Exceptions
+								// if it changes in the LodRenderer while we are working here
+								boolean[][] vanillaRenderedChunks = renderer.vanillaRenderedChunks;
+								short gameChunkRenderDistance = (short) (vanillaRenderedChunks.length / 2 - 1);
+								
+								for (int index = 0; index < posToRender.getNumberOfPos(); index++)
+								{
+									detailLevel = posToRender.getNthDetailLevel(index);
+									posX = posToRender.getNthPosX(index);
+									posZ = posToRender.getNthPosZ(index);
+									
+									// skip any chunks that Minecraft is going to render
+									chunkXdist = LevelPosUtil.getChunkPos(detailLevel, posX) - playerChunkPos.x;
+									chunkZdist = LevelPosUtil.getChunkPos(detailLevel, posZ) - playerChunkPos.z;
+									
+									if (gameChunkRenderDistance >= Math.abs(chunkXdist)
+											&& gameChunkRenderDistance >= Math.abs(chunkZdist)
+											&& detailLevel <= LodUtil.CHUNK_DETAIL_LEVEL
+											&& vanillaRenderedChunks[chunkXdist + gameChunkRenderDistance + 1][chunkZdist + gameChunkRenderDistance + 1])
+									{
+										continue;
+									}
+									
+									// skip any chunks that Minecraft is going to render
+									for (Direction direction : Box.ADJ_DIRECTIONS)
+									{
+										xAdj = posX + direction.getNormal().getX();
+										zAdj = posZ + direction.getNormal().getZ();
+										chunkXdist = LevelPosUtil.getChunkPos(detailLevel, xAdj) - playerChunkPos.x;
+										chunkZdist = LevelPosUtil.getChunkPos(detailLevel, zAdj) - playerChunkPos.z;
+										boolean performFaceCulling = true;
+										if (performFaceCulling
+												&& posToRender.contains(detailLevel, xAdj, zAdj)
+												&& (gameChunkRenderDistance < Math.abs(chunkXdist)
+														|| gameChunkRenderDistance < Math.abs(chunkZdist)
+														|| !vanillaRenderedChunks[chunkXdist + gameChunkRenderDistance + 1][chunkZdist + gameChunkRenderDistance + 1]))
+										{
+											if (!adjData.containsKey(direction) || adjData.get(direction) == null)
+												adjData.put(direction, new long[maxVerticalData]);
+											for (int verticalIndex = 0; verticalIndex < lodDim.getMaxVerticalData(detailLevel, xAdj, zAdj); verticalIndex++)
+											{
+												long data = lodDim.getData(detailLevel, xAdj, zAdj, verticalIndex);
+												adjData.get(direction)[verticalIndex] = data;
+											}
+										} else
+										{
+											adjData.put(direction, null);
+										}
+									}
+									
+									long data;
+									for (int verticalIndex = 0; verticalIndex < lodDim.getMaxVerticalData(detailLevel, posX, posZ); verticalIndex++)
+									{
+										data = lodDim.getData(detailLevel, posX, posZ, verticalIndex);
+										if (DataPointUtil.isItVoid(data) || !DataPointUtil.doesItExist(data))
+											break;
+										LodConfig.CLIENT.graphics.lodTemplate.get().template.addLodToBuffer(currentBuffer, playerBlockPosRounded, data, adjData,
+												detailLevel, posX, posZ, boxCache[xR][zR], renderer.previousDebugMode, renderer.lightMap);
+									}
+									
+									
+								} // for pos to in list to render
+								// the thread executed successfully
+								return true;
+							};
+							nodeToRenderThreads.add(dataToRenderThread);
 						}
-						// don't render this null chunk
-						continue;
-					}
-					
-					
-					BufferBuilder currentBuffer = null;
-					if (isCoordinateInNearFogArea(i, j, numbChunksWide / 2))
-						currentBuffer = buildableNearBuffer;
-					else
-						currentBuffer = buildableFarBuffer;
-					
-					// get the desired LodTemplate and
-					// add this LOD to the buffer
-					LodConfig.CLIENT.lodTemplate.get().template.
-					addLodToBuffer(currentBuffer, lodDim, lod, 
-							xOffset, yOffset, zOffset, renderer.debugging);
-				}
-			}
-			
-			// TODO add a way for a server side mod to generate chunks requested here
-			if(mc.isIntegratedServerRunning())
-			{
-				// start chunk generation
-				for(ChunkPos chunkPos : chunksToGen)
+					} // region z
+				} // region z
+				long renderStart = System.currentTimeMillis();
+				// wait for all threads to finish
+				List<Future<Boolean>> futuresBuffer = bufferBuilderThreads.invokeAll(nodeToRenderThreads);
+				for (Future<Boolean> future : futuresBuffer)
 				{
-					if(chunkPos == null)
-						break;
-					
-					numberOfChunksWaitingToGenerate++;
-					
-					LodChunkGenWorker genWorker = new LodChunkGenWorker(chunkPos, renderer, lodBuilder, this, lodDim);
-					WorldWorkerManager.addWorker(genWorker);
+					// the future will be false if its thread failed
+					if (!future.get())
+					{
+						ClientProxy.LOGGER.warn("LodBufferBuilder ran into trouble and had to start over.");
+						closeBuffers(fullRegen, lodDim);
+						return;
+					}
 				}
+				long renderEnd = System.currentTimeMillis();
+				
+				long endTime = System.currentTimeMillis();
+				@SuppressWarnings("unused")
+				long buildTime = endTime - startTime;
+				@SuppressWarnings("unused")
+				long treeTime = treeEnd - treeStart;
+				@SuppressWarnings("unused")
+				long renderingTime = renderEnd - renderStart;
+				
+				//				ClientProxy.LOGGER.info("Buffer Build time: " + buildTime + " ms" + '\n' +
+				//						                        "Tree cutting time: " + treeTime + " ms" + '\n' +
+				//						                        "Rendering time: " + renderingTime + " ms");
+				
+				// mark that the buildable buffers as ready to swap
+				switchVbos = true;
+			} catch (Exception e)
+			{
+				ClientProxy.LOGGER.warn("\"LodNodeBufferBuilder.generateLodBuffersAsync\" ran into trouble: ");
+				e.printStackTrace();
+			} finally
+			{
+				// regardless of if we successfully created the buffers
+				// we are done generating.
+				generatingBuffers = false;
+				
+				// clean up any potentially open resources
+				if (buildableBuffers != null)
+					closeBuffers(fullRegen, lodDim);
+				
+				// upload the new buffers
+				uploadBuffers(fullRegen, lodDim);
+				bufferLock.unlock();
 			}
 			
-			// finish the buffer building
-			buildableNearBuffer.finishDrawing();
-			buildableFarBuffer.finishDrawing();
-			
-			// mark that the buildable buffers as ready to swap
-			generatingBuffers = false;
-			switchBuffers = true;
 		});
 		
-		genThread.execute(t);
-		
-		return;
+		mainGenThread.execute(thread);
 	}
 	
-	
-	
-	
-	
-	
-	
-	
-	
-	
-	
-	//====================//
-	// generation helpers //
-	//====================//
-	
-	/**
-	 * Returns if the given coordinate is in the loaded area of the world.
-	 * @param centerCoordinate the center of the loaded world
-	 */
-	private boolean isCoordInCenterArea(int i, int j, int centerCoordinate)
-	{
-		return (i >= centerCoordinate - mc.gameSettings.renderDistanceChunks
-				&& i <= centerCoordinate + mc.gameSettings.renderDistanceChunks) 
-				&& 
-				(j >= centerCoordinate - mc.gameSettings.renderDistanceChunks
-				&& j <= centerCoordinate + mc.gameSettings.renderDistanceChunks);
-	}
-	
-	
-	/**
-	 * Find the coordinates that are in the center half of the given
-	 * 2D matrix, starting at (0,0) and going to (2 * lodRadius, 2 * lodRadius).
-	 */
-	private static boolean isCoordinateInNearFogArea(int chunkX, int chunkZ, int lodRadius)
-	{
-		int halfRadius = lodRadius / 2;
-		
-		return (chunkX >= lodRadius - halfRadius 
-				&& chunkX <= lodRadius + halfRadius) 
-				&& 
-				(chunkZ >= lodRadius - halfRadius
-				&& chunkZ <= lodRadius + halfRadius);
-	}
-	
-	
-	
-	
-	
 	//===============================//
 	// BufferBuilder related methods //
 	//===============================//
 	
-	
 	/**
 	 * Called from the LodRenderer to create the
-	 * BufferBuilders at the right size.
-	 * 
-	 * @param bufferMaxCapacity
+	 * BufferBuilders. <br><br>
+	 * <p>
+	 * May have to wait for the bufferLock to open.
 	 */
-	public void setupBuffers(int bufferMaxCapacity)
+	public void setupBuffers(LodDimension lodDimension)
 	{
-		buildableNearBuffer = new BufferBuilder(bufferMaxCapacity);
-		buildableFarBuffer = new BufferBuilder(bufferMaxCapacity);
+		bufferLock.lock();
+		int numbRegionsWide = lodDimension.getWidth();
+		int bufferMaxCapacity;
+		
+		//if(previousRegionWidth != numbRegionsWide || firstSetup)
+		//{
+		firstSetup = false;
+		previousRegionWidth = numbRegionsWide;
+		buildableBuffers = new BufferBuilder[numbRegionsWide][numbRegionsWide];
+		
+		buildableVbos = new VertexBuffer[numbRegionsWide][numbRegionsWide];
+		drawableVbos = new VertexBuffer[numbRegionsWide][numbRegionsWide];
+		//}
+		for (int x = 0; x < numbRegionsWide; x++)
+		{
+			for (int z = 0; z < numbRegionsWide; z++)
+			{
+				//if(lodDimension.isBufferToSetup(x,z))
+				//{
+				bufferMaxCapacity = lodDimension.getMemoryRequired(x, z, LodConfig.CLIENT.graphics.lodTemplate.get());
+				buildableBuffers[x][z] = new BufferBuilder(bufferMaxCapacity);
+				
+				buildableVbos[x][z] = new VertexBuffer(LodRenderer.LOD_VERTEX_FORMAT);
+				drawableVbos[x][z] = new VertexBuffer(LodRenderer.LOD_VERTEX_FORMAT);
+				//}
+			}
+		}
+		
+		bufferLock.unlock();
 	}
 	
 	/**
-	 * Swap the drawable and buildable buffers and return
-	 * the old drawable buffers.
-	 * @param drawableNearBuffer
-	 * @param drawableFarBuffer
+	 * sets the buffers and Vbos to null, forcing them to be recreated. <br><br>
+	 * <p>
+	 * May have to wait for the bufferLock to open.
 	 */
-	public NearFarBuffer swapBuffers(BufferBuilder drawableNearBuffer, BufferBuilder drawableFarBuffer)
+	public void destroyBuffers()
 	{
-		// swap the BufferBuilders
-		BufferBuilder tmp = buildableNearBuffer;
-		buildableNearBuffer = drawableNearBuffer;
-		drawableNearBuffer = tmp;
+		bufferLock.lock();
 		
-		tmp = buildableFarBuffer;
-		buildableFarBuffer = drawableFarBuffer;
-		drawableFarBuffer = tmp;
+		buildableBuffers = null;
+		buildableVbos = null;
+		drawableVbos = null;
 		
+		bufferLock.unlock();
+	}
+	
+	/**
+	 * Calls begin on each of the buildable BufferBuilders.
+	 */
+	private void startBuffers(boolean fullRegen, LodDimension lodDim)
+	{
+		for (int x = 0; x < buildableBuffers.length; x++)
+		{
+			for (int z = 0; z < buildableBuffers.length; z++)
+			{
+				if (fullRegen || lodDim.isRegionToRegen(x, z))
+				{
+					buildableBuffers[x][z].begin(GL11.GL_QUADS, LodRenderer.LOD_VERTEX_FORMAT);
+				}
+			}
+		}
+	}
+	
+	/**
+	 * Calls end on each of the buildable BufferBuilders.
+	 */
+	private void closeBuffers(boolean fullRegen, LodDimension lodDim)
+	{
+		for (int x = 0; x < buildableBuffers.length; x++)
+			for (int z = 0; z < buildableBuffers.length; z++)
+				if (buildableBuffers[x][z] != null && buildableBuffers[x][z].building() && (fullRegen || lodDim.isRegionToRegen(x, z)))
+					buildableBuffers[x][z].end();
+	}
+	
+	/**
+	 * Upload all buildableBuffers to the GPU.
+	 */
+	private void uploadBuffers(boolean fullRegen, LodDimension lodDim)
+	{
+		GlProxy glProxy = GlProxy.getInstance();
 		
-		// the buffers have been swapped
-		switchBuffers = false;
+		try
+		{
+			// make sure we are uploading to a different OpenGL context,
+			// to prevent interference (IE stuttering) with the Minecraft context.
+			glProxy.setGlContext(GlProxyContext.LOD_BUILDER);
+			
+			for (int x = 0; x < buildableVbos.length; x++)
+			{
+				for (int z = 0; z < buildableVbos.length; z++)
+				{
+					if (fullRegen || lodDim.isRegionToRegen(x, z))
+					{
+						ByteBuffer builderBuffer = buildableBuffers[x][z].popNextBuffer().getSecond();
+						vboUpload(buildableVbos[x][z], builderBuffer);
+						lodDim.setRegenByArrayIndex(x, z, false);
+					}
+				}
+			}
+		}
+		catch (IllegalStateException e)
+		{
+			ClientProxy.LOGGER.error(LodBufferBuilder.class.getSimpleName() + " - UploadBuffers failed: " + e.getMessage());
+			e.printStackTrace();
+		}
+		finally
+		{
+			// make sure no buffer is bound
+			if (glProxy.getGlContext() == GlProxyContext.LOD_BUILDER)
+			{
+				GL15C.glBindBuffer(GL15.GL_ARRAY_BUFFER, 0);
+			}
+			
+			// make sure the context is disabled
+			glProxy.setGlContext(GlProxyContext.NONE);
+		}
+	}
+	
+	/**
+	 * Uploads the uploadBuffer into the VBO in GPU memory.
+	 */
+	private void vboUpload(VertexBuffer vbo, ByteBuffer uploadBuffer)
+	{
+		// this shouldn't happen, but just to be safe
+		if (vbo.id != -1 && GlProxy.getInstance().getGlContext() == GlProxyContext.LOD_BUILDER)
+		{
+			// this is how many points will be rendered
+			vbo.vertexCount = (uploadBuffer.remaining() / vbo.format.getVertexSize());
+			
+			GL15C.glBindBuffer(GL15.GL_ARRAY_BUFFER, vbo.id);
+			
+			// subData only works if the memory is allocated beforehand.
+			GL15C.glBufferData(GL15.GL_ARRAY_BUFFER, uploadBuffer.remaining(), GL15C.GL_DYNAMIC_DRAW);
+			
+			// interestingly bufferSubData renders faster than glMapBuffer
+			// even though OpenGLInsights-AsynchronousBufferTransfers says glMapBuffer
+			// is faster for transferring data. They must put the data in different memory
+			// or something.
+			GL15C.glBufferSubData(GL15.GL_ARRAY_BUFFER, 0, uploadBuffer);
+			
+			GL15C.glBindBuffer(GL15.GL_ARRAY_BUFFER, 0);
+		}
+	}
+	
+	/**
+	 * Get the newly created VBOs
+	 */
+	public VertexBuffersAndOffset getVertexBuffers()
+	{
+		// don't wait for the lock to open
+		// since this is called on the main render thread
+		if (bufferLock.tryLock())
+		{
+			VertexBuffer[][] tmpVbo = drawableVbos;
+			drawableVbos = buildableVbos;
+			buildableVbos = tmpVbo;
+			
+			drawableCenterChunkPos = buildableCenterChunkPos;
+			
+			// the vbos have been swapped
+			switchVbos = false;
+			bufferLock.unlock();
+		}
 		
-		return new NearFarBuffer(drawableNearBuffer, drawableFarBuffer);
+		return new VertexBuffersAndOffset(drawableVbos, drawableCenterChunkPos);
+	}
+	
+	/**
+	 * A simple container to pass multiple objects back in the getVertexBuffers method.
+	 */
+	public class VertexBuffersAndOffset
+	{
+		public VertexBuffer[][] vbos;
+		public ChunkPos drawableCenterChunkPos;
+		
+		public VertexBuffersAndOffset(VertexBuffer[][] newVbos, ChunkPos newDrawableCenterChunkPos)
+		{
+			vbos = newVbos;
+			drawableCenterChunkPos = newDrawableCenterChunkPos;
+		}
 	}
 	
 	/**
 	 * If this is true the buildable near and far
 	 * buffers have been generated and are ready to be
-	 * sent to the LodRenderer. 
+	 * sent to the LodRenderer.
 	 */
-	public boolean newBuffersAvaliable() 
+	public boolean newBuffersAvaliable()
 	{
-		return switchBuffers;
+		return switchVbos;
 	}
 	
-	
-	
-	
-}
+}

src/main/java/com/seibel/lod/builders/LodBuilderConfig.java

@@ -0,0 +1,112 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.builders;
+
+import com.seibel.lod.enums.DistanceGenerationMode;
+
+/**
+ * This is used to easily configure how LodChunks are generated.
+ * Generally this will only be used if we want to generate a
+ * LodChunk using a incomplete Chunk, otherwise the defaults
+ * work best for a fully generated chunk (IE has correct surface blocks).
+ *
+ * @author James Seibel
+ * @version 8-14-2021
+ */
+public class LodBuilderConfig
+{
+	/**
+	 * default false
+	 */
+	public boolean useHeightmap;
+	/**
+	 * default false
+	 */
+	public boolean useBiomeColors;
+	/**
+	 * default true
+	 */
+	public boolean useSolidBlocksInColorGen;
+	/**
+	 * default server
+	 */
+	public DistanceGenerationMode distanceGenerationMode;
+
+	/**
+	 * default settings for a normal chunk <br>
+	 * useHeightmap = false <br>
+	 * useBiomeColors = false <br>
+	 * useSolidBlocksInColorGen = true <br>
+	 * generationMode = Server <br>
+	 */
+	public LodBuilderConfig()
+	{
+		useHeightmap = false;
+		useBiomeColors = false;
+		useSolidBlocksInColorGen = true;
+		distanceGenerationMode = DistanceGenerationMode.SERVER;
+	}
+
+	/**
+	 * @param newUseHeightmap               default = false
+	 * @param newUseBiomeColors             default = false
+	 * @param newUseSolidBlocksInBiomeColor default = true
+	 * @param newDistanceGenerationMode     default = Server
+	 */
+	public LodBuilderConfig(boolean newUseHeightmap, boolean newUseBiomeColors,
+	                        boolean newUseSolidBlocksInBiomeColor, DistanceGenerationMode newDistanceGenerationMode)
+	{
+		useHeightmap = newUseHeightmap;
+		useBiomeColors = newUseBiomeColors;
+		useSolidBlocksInColorGen = newUseSolidBlocksInBiomeColor;
+		distanceGenerationMode = newDistanceGenerationMode;
+	}
+
+	/**
+	 * @param newUseHeightmap               default = false
+	 * @param newUseBiomeColors             default = false
+	 * @param newUseSolidBlocksInBiomeColor default = true
+	 * @param newDistanceGenerationMode     default = Server
+	 */
+	public LodBuilderConfig(boolean newUseHeightmap, boolean newUseBiomeColors, boolean newUseSolidBlocksInBiomeColor)
+	{
+		this();
+		useHeightmap = newUseHeightmap;
+		useBiomeColors = newUseBiomeColors;
+		useSolidBlocksInColorGen = newUseSolidBlocksInBiomeColor;
+		if (newUseHeightmap)
+		{
+			distanceGenerationMode = DistanceGenerationMode.BIOME_ONLY_SIMULATE_HEIGHT;
+		} else
+		{
+			distanceGenerationMode = DistanceGenerationMode.BIOME_ONLY;
+		}
+	}
+
+	/**
+	 * @param newUseHeightmap               default = false
+	 * @param newUseBiomeColors             default = false
+	 * @param newUseSolidBlocksInBiomeColor default = true
+	 * @param newDistanceGenerationMode     default = Server
+	 */
+	public LodBuilderConfig(DistanceGenerationMode newDistanceGenerationMode)
+	{
+		this();
+		distanceGenerationMode = newDistanceGenerationMode;
+	}
+}

src/main/java/com/seibel/lod/builders/LodChunkGenWorker.java

@@ -1,125 +0,0 @@
-package com.seibel.lod.builders;
-
-import com.seibel.lod.objects.LodDimension;
-import com.seibel.lod.objects.LodRegion;
-import com.seibel.lod.proxy.ClientProxy;
-import com.seibel.lod.render.LodRender;
-import com.seibel.lod.util.LodUtils;
-
-import net.minecraft.util.math.ChunkPos;
-import net.minecraft.world.chunk.ChunkStatus;
-import net.minecraft.world.chunk.IChunk;
-import net.minecraft.world.server.ServerWorld;
-import net.minecraftforge.common.WorldWorkerManager.IWorker;
-
-/**
- * This is used to generate a LodChunk at a given ChunkPos.
- * 
- * @author James Seibel
- * @version 03-31-2021
- */
-public class LodChunkGenWorker implements IWorker
-{
-    private ServerWorld serverWorld;
-    private ChunkPos pos;
-    private LodDimension lodDim;
-    private LodBuilder lodBuilder;
-    private LodBufferBuilder lodBufferBuilder;
-    private LodRender lodRender;
-    
-    public LodChunkGenWorker(ChunkPos newPos, LodRender newLodRenderer, 
-    		LodBuilder newLodBuilder, LodBufferBuilder newLodBufferBuilder, 
-    		LodDimension newLodDimension)
-    {
-        serverWorld  = LodUtils.getServerWorldFromDimension(newLodDimension.dimension);
-        if (serverWorld == null)
-        	throw new IllegalArgumentException("LodChunkGenWorker must have a non-null ServerWorld"); 
-        	
-        pos = newPos;
-        lodDim = newLodDimension;
-        lodBuilder = newLodBuilder;
-        lodBufferBuilder = newLodBufferBuilder;
-        lodRender = newLodRenderer;
-    }
-    
-    @Override
-    public boolean doWork()
-    {
-        if (pos != null)
-        {
-            int x = pos.x;
-            int z = pos.z;
-            
-            // only generate LodChunks if they can
-            // be added to the current LodDimension
-            if (lodDim.regionIsInRange(pos.x / LodRegion.SIZE, pos.z / LodRegion.SIZE))
-            {
-                IChunk chunk;// = serverWorld.getChunk(x, z, ChunkStatus.EMPTY, true);
-                
-                //long startTime = System.currentTimeMillis();
-                chunk = serverWorld.getChunk(x, z, ChunkStatus.FEATURES);
-                //long endTime = System.currentTimeMillis();
-                //System.out.println(endTime - startTime + "\t" + lodBuilder.hasBlockData(chunk));
-                
-                
-                lodBuilder.generateLodChunkAsync(chunk, ClientProxy.getLodWorld(), serverWorld);
-                // this is called so that the new LOD chunk is drawn
-                // after it is generated
-                lodRender.regenerateLODsNextFrame();
-                
-                
-                // useful for debugging
-//                ClientProxy.LOGGER.info(lodDim.getNumberOfLods());
-                
-//                if (lodDim.getLodFromCoordinates(x, z) != null)
-//                	ClientProxy.LOGGER.info(x + " " + z + " Success!");
-//                else
-//                	ClientProxy.LOGGER.info(x + " " + z);
-            }
-            // can be used for debugging
-            //else
-            //{
-            //	System.out.println("Out of range " + x + " " + z);
-            //}
-            
-            lodBufferBuilder.numberOfChunksWaitingToGenerate--;
-            
-            pos = null;
-        }
-        
-        return false;
-    }
-    
-    @Override
-    public boolean hasWork()
-    {
-        return pos != null;
-    }
-    
-    /*
-     * performance/generation tests related to
-     * serverWorld.getChunk(x, z, ChunkStatus. *** )
-     
-     true/false is whether they generated blocks or not
-     the time is how long it took to generate
-     
-     ChunkStatus.EMPTY					0  - 1  ms	false	(empty, what did you expect? :P)
-     ChunkStatus.STRUCTURE_REFERENCES	1  - 2  ms  false	(no height, only generates some chunks)
-     ChunkStatus.BIOMES 				1  - 10 ms	false	(no height)
-     ChunkStatus.NOISE					4  - 15 ms	true	(all blocks are stone)
-     ChunkStatus.LIQUID_CARVERS			6  - 12 ms	true	(no snow/trees, just grass)
-     ChunkStatus.SURFACE				5  - 15 ms	true	(no snow/trees, just grass)
-     ChunkStatus.CARVERS				5  - 30 ms	true	(no snow/trees, just grass)
-     ChunkStatus.FEATURES				7  - 25 ms	true
-     ChunkStatus.HEIGHTMAPS 			20 - 40 ms	true
-     ChunkStatus.LIGHT					20 - 40 ms	true
-     ChunkStatus.FULL 					30 - 50 ms	true
-     ChunkStatus.SPAWN			   		50 - 80 ms	true
-     
-     
-     At this point I would suggest using FEATURES, as it generates snow and trees
-     (and any other object that is needed to make biomes distinct)
-     
-     Otherwise if snow/trees aren't necessary SURFACE is the next fastest (although not by much)
-     */
-}

src/main/java/com/seibel/lod/builders/lodTemplates/AbstractLodTemplate.java

@@ -1,42 +1,60 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.seibel.lod.builders.lodTemplates;
 
-import java.awt.Color;
+import java.util.Map;
 
-import com.seibel.lod.objects.LodChunk;
-import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.enums.DebugMode;
+import com.seibel.lod.util.ColorUtil;
 
 import net.minecraft.client.renderer.BufferBuilder;
+import net.minecraft.client.renderer.texture.NativeImage;
+import net.minecraft.util.Direction;
+import net.minecraft.util.math.BlockPos;
 
 /**
  * This is the abstract class used to create different
  * BufferBuilders.
- * 
+ *
  * @author James Seibel
- * @version 05-07-2021
+ * @version 8-8-2021
  */
 public abstract class AbstractLodTemplate
 {
-	/** alpha used when drawing chunks in debug mode */
-	protected int debugAlpha = 255; // 0 - 255
-	protected Color debugBlack = new Color(0, 0, 0, debugAlpha);
-	protected Color debugWhite = new Color(255, 255, 255, debugAlpha);
-	
-	
-	public abstract void addLodToBuffer(BufferBuilder buffer, 
-			LodDimension lodDim, LodChunk lod, 
-			double xOffset, double yOffset, double zOffset, 
-			boolean debugging);
-	
-	/** add the given position and color to the buffer */
-	protected void addPosAndColor(BufferBuilder buffer, 
-			double x, double y, double z, 
-			int red, int green, int blue, int alpha)
+
+
+	public abstract void addLodToBuffer(BufferBuilder buffer, BlockPos bufferCenterBlockPos, long data, Map<Direction, long[]> adjData,
+	                                    byte detailLevel, int posX, int posZ, Box box, DebugMode debugging, NativeImage lightMap);
+
+	/**
+	 * add the given position and color to the buffer
+	 */
+	protected void addPosAndColor(BufferBuilder buffer,
+	                              double x, double y, double z,
+	                              int color)
 	{
-		buffer.pos(x, y, z).color(red, green, blue, alpha).endVertex();
+
+		buffer.vertex(x, y, z).color(ColorUtil.getRed(color), ColorUtil.getGreen(color), ColorUtil.getBlue(color), ColorUtil.getAlpha(color)).endVertex();
 	}
-	
-	
-	
-	
-	
+
+	/**
+	 * Returns in bytes how much buffer memory is required
+	 * for one LOD object
+	 */
+	public abstract int getBufferMemoryForSingleNode(int maxVerticalData);
 }

src/main/java/com/seibel/lod/builders/lodTemplates/Box.java

@@ -0,0 +1,448 @@
+package com.seibel.lod.builders.lodTemplates;
+
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.Map;
+
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DebugMode;
+import com.seibel.lod.util.ColorUtil;
+import com.seibel.lod.util.DataPointUtil;
+import com.seibel.lod.wrappers.MinecraftWrapper;
+
+import net.minecraft.util.Direction;
+import net.minecraft.util.math.BlockPos;
+
+
+public class Box
+{
+	
+	public static final int OFFSET = 0;
+	public static final int WIDTH = 1;
+	
+	public static final int X = 0;
+	public static final int Y = 1;
+	public static final int Z = 2;
+	
+	public static final int MIN = 0;
+	public static final int MAX = 1;
+	
+	public static final int VOID_FACE = 0;
+	
+	public static final Direction[] DIRECTIONS = new Direction[]{
+			Direction.UP,
+			Direction.DOWN,
+			Direction.WEST,
+			Direction.EAST,
+			Direction.NORTH,
+			Direction.SOUTH};
+	
+	public static final Direction[] ADJ_DIRECTIONS = new Direction[]{
+			Direction.EAST,
+			Direction.WEST,
+			Direction.SOUTH,
+			Direction.NORTH};
+	
+	@SuppressWarnings("serial")
+	public static final Map<Direction, int[][]> DIRECTION_VERTEX_MAP = new HashMap<Direction, int[][]>()
+	{{
+		put(Direction.UP, new int[][]{
+			{0, 1, 0},
+			{0, 1, 1},
+			{1, 1, 1},
+			{1, 1, 0}});
+		put(Direction.DOWN, new int[][]{
+			{1, 0, 0},
+			{1, 0, 1},
+			{0, 0, 1},
+			{0, 0, 0}});
+		put(Direction.EAST, new int[][]{
+			{1, 1, 0},
+			{1, 1, 1},
+			{1, 0, 1},
+			{1, 0, 0}});
+		put(Direction.WEST, new int[][]{
+			{0, 0, 0},
+			{0, 0, 1},
+			{0, 1, 1},
+			{0, 1, 0}});
+		put(Direction.SOUTH, new int[][]{
+			{1, 0, 1},
+			{1, 1, 1},
+			{0, 1, 1},
+			{0, 0, 1}});
+		put(Direction.NORTH, new int[][]{
+			{0, 0, 0},
+			{0, 1, 0},
+			{1, 1, 0},
+			{1, 0, 0}});
+	}};
+	
+	
+	@SuppressWarnings("serial")
+	public static final Map<Direction, int[]> FACE_DIRECTION = new HashMap<Direction, int[]>()
+	{{
+		put(Direction.UP, new int[]{Y, MAX});
+		put(Direction.DOWN, new int[]{Y, MIN});
+		put(Direction.EAST, new int[]{X, MAX});
+		put(Direction.WEST, new int[]{X, MIN});
+		put(Direction.SOUTH, new int[]{Z, MAX});
+		put(Direction.NORTH, new int[]{Z, MIN});
+	}};
+	
+	@SuppressWarnings("serial")
+	public static final Map<Direction, int[]> DIRECTION_NORMAL_MAP = new HashMap<Direction, int[]>()
+	{{
+		put(Direction.UP, new int[]{0, 1, 0});
+		put(Direction.DOWN, new int[]{0, -1, 0});
+		put(Direction.EAST, new int[]{1, 0, 0});
+		put(Direction.WEST, new int[]{-1, 0, 0});
+		put(Direction.SOUTH, new int[]{0, 0, 1});
+		put(Direction.NORTH, new int[]{0, 0, -1});
+	}};
+	
+	public int[][] box;
+	public long[] order;
+	public Map<Direction, int[]> colorMap;
+	public int debugColor;
+	public Map<Direction, int[][]> adjHeightAndDepth;
+	public Map<Direction, boolean[]> culling;
+	
+	@SuppressWarnings("serial")
+	public Box()
+	{
+		box = new int[2][3];
+		//order = new long[DetailDistanceUtil.getMaxVerticalData(0)];
+		colorMap = new HashMap<Direction, int[]>()
+		{{
+			put(Direction.UP, new int[1]);
+			put(Direction.DOWN, new int[1]);
+			put(Direction.EAST, new int[1]);
+			put(Direction.WEST, new int[1]);
+			put(Direction.SOUTH, new int[1]);
+			put(Direction.NORTH, new int[1]);
+		}};
+		adjHeightAndDepth = new HashMap<Direction, int[][]>()
+		{{
+			put(Direction.EAST, new int[32][2]);
+			put(Direction.WEST, new int[32][2]);
+			put(Direction.SOUTH, new int[32][2]);
+			put(Direction.NORTH, new int[32][2]);
+		}};
+		culling = new HashMap<Direction, boolean[]>()
+		{{
+			put(Direction.UP, new boolean[1]);
+			put(Direction.DOWN, new boolean[1]);
+			put(Direction.EAST, new boolean[1]);
+			put(Direction.WEST, new boolean[1]);
+			put(Direction.SOUTH, new boolean[1]);
+			put(Direction.NORTH, new boolean[1]);
+		}};
+	}
+	
+	public void setColor(int color)
+	{
+		this.debugColor = color;
+		for (Direction direction : DIRECTIONS)
+		{
+			colorMap.get(direction)[0] = ColorUtil.applyShade(color, MinecraftWrapper.INSTANCE.getClientWorld().getShade(direction, true));
+		}
+	}
+	
+	public int getColor(Direction direction)
+	{
+		if (LodConfig.CLIENT.debugging.debugMode.get() != DebugMode.SHOW_DETAIL)
+		{
+			return colorMap.get(direction)[0];
+		}
+		else
+		{
+			return ColorUtil.applyShade(debugColor, MinecraftWrapper.INSTANCE.getClientWorld().getShade(direction, true));
+		}
+	}
+	
+	public void reset()
+	{
+		for (int i = 0; i < box.length; i++)
+		{
+			Arrays.fill(box[i], 0);
+		}
+		
+		for (Direction direction : DIRECTIONS)
+		{
+			colorMap.get(direction)[0] = 0;
+		}
+		
+		//Arrays.fill(order, DataPointUtil.EMPTY_DATA);
+		for (Direction direction : ADJ_DIRECTIONS)
+		{
+			if(isCulled(direction)){
+				continue;
+			}
+			for (int i = 0; i < adjHeightAndDepth.get(direction).length; i++)
+			{
+				adjHeightAndDepth.get(direction)[i][0] = VOID_FACE;
+				adjHeightAndDepth.get(direction)[i][1] = VOID_FACE;
+			}
+		}
+	}
+	
+	public void setUpCulling(int cullingDistance, BlockPos playerPos)
+	{
+		for (Direction direction : DIRECTIONS)
+		{
+			if(direction == Direction.DOWN)
+				culling.get(direction)[0] = playerPos.get(direction.getAxis()) > getFacePos(direction) + cullingDistance;
+				else if(direction == Direction.UP)
+					culling.get(direction)[0] = playerPos.get(direction.getAxis()) < getFacePos(direction) - cullingDistance;
+				else if(direction == Direction.WEST)
+					culling.get(direction)[0] = -playerPos.get(direction.getAxis()) > getFacePos(direction) + cullingDistance;
+					else if(direction == Direction.NORTH)
+						culling.get(direction)[0] = -playerPos.get(direction.getAxis()) > getFacePos(direction) + cullingDistance;
+						else if(direction == Direction.EAST)
+							culling.get(direction)[0] = -playerPos.get(direction.getAxis()) < getFacePos(direction) - cullingDistance;
+						else if(direction == Direction.SOUTH)
+							culling.get(direction)[0] = -playerPos.get(direction.getAxis()) < getFacePos(direction) - cullingDistance;
+		}
+	}
+	
+	public boolean isCulled(Direction direction)
+	{
+		return culling.get(direction)[0];
+	}
+	
+	public void setAdjData(Map<Direction, long[]> adjData)
+	{
+		int height;
+		int depth;
+		int minY = getMinY();
+		int maxY = getMaxY();
+		for (Direction direction : ADJ_DIRECTIONS)
+		{
+			/*if(isCulled(direction)){
+				continue;
+			}*/
+			
+			long[] dataPoint = adjData.get(direction);
+			if (dataPoint == null || DataPointUtil.isItVoid(dataPoint[0]))
+			{
+				adjHeightAndDepth.get(direction)[0][0] = maxY;
+				adjHeightAndDepth.get(direction)[0][1] = minY;
+				adjHeightAndDepth.get(direction)[1][0] = VOID_FACE;
+				adjHeightAndDepth.get(direction)[1][1] = VOID_FACE;
+				continue;
+			}
+			
+			//We order the adj list
+			/**TODO remove this if the order is maintained naturally*/
+			/*order[0] = 0;
+			int count = 0;
+			for (int i = 0; i < dataPoint.length; i++)
+			{
+				int j = i - 1;
+				if(DataPointUtil.isItVoid(dataPoint[i]) || !DataPointUtil.doesItExist(dataPoint[i]))
+				{
+					continue;
+				}
+				while (j >= 0 && DataPointUtil.getHeight(order[j]) < DataPointUtil.getHeight(dataPoint[i]))
+				{
+					order[j + 1] = order[j];
+					j = j - 1;
+				}
+				order[j + 1] = dataPoint[i];
+				count++;
+			}*/
+			
+			int i;
+			int faceToDraw = 0;
+			boolean firstFace = true;
+			boolean toFinish = false;
+			boolean allAbove = true;
+			long singleAdjDataPoint;
+			for (i = 0; i < dataPoint.length; i++)
+			{
+				singleAdjDataPoint = dataPoint[i];
+				/*for (i = 0; i < count; i++)
+			{
+				singleAdjDataPoint = order[i];*/
+				
+				if(DataPointUtil.isItVoid(singleAdjDataPoint) || !DataPointUtil.doesItExist(singleAdjDataPoint))
+				{
+					break;
+				}
+				height = DataPointUtil.getHeight(singleAdjDataPoint);
+				depth = DataPointUtil.getDepth(singleAdjDataPoint);
+				
+				if (depth <= maxY) {
+					allAbove = false;
+					if (height < minY)
+					{//the adj data is lower than the current data
+						//we break since all the other data will be lower
+						
+						if (firstFace)
+						{
+							adjHeightAndDepth.get(direction)[0][0] = getMaxY();
+							adjHeightAndDepth.get(direction)[0][1] = getMinY();
+						} else
+						{
+							adjHeightAndDepth.get(direction)[faceToDraw][1] = getMinY();
+						}
+						faceToDraw++;
+						toFinish = false;
+						break;
+					} else if (depth <= minY && height >= maxY)
+					{//the adj data contains the current
+						//we do not draw the face
+						adjHeightAndDepth.get(direction)[0][0] = VOID_FACE;
+						adjHeightAndDepth.get(direction)[0][1] = VOID_FACE;
+						break;
+					} else if (depth <= minY)//&& height < maxY
+					{//the adj data intersect the lower part of the current data
+						//if this is the only face we use the maxY and break
+						//if there was other face we finish the last one and break
+						if (firstFace)
+						{
+							adjHeightAndDepth.get(direction)[0][0] = getMaxY();
+							adjHeightAndDepth.get(direction)[0][1] = height;
+						} else
+						{
+							adjHeightAndDepth.get(direction)[faceToDraw][1] = height;
+						}
+						toFinish = false;
+						faceToDraw++;
+						break;
+					} else if (height >= maxY)//depth > minY &&
+					{//the adj data intersect the higher part of the current data
+						//we start the creation of a new face
+						adjHeightAndDepth.get(direction)[faceToDraw][0] = depth;
+						firstFace = false;
+						toFinish = true;
+					} else {//if (depth > minY && height < maxY)
+						//the adj data is contained in the current data
+						if (firstFace)
+						{
+							adjHeightAndDepth.get(direction)[0][0] = getMaxY();
+						}
+						adjHeightAndDepth.get(direction)[faceToDraw][1] = height;
+						faceToDraw++;
+						adjHeightAndDepth.get(direction)[faceToDraw][0] = depth;
+						firstFace = false;
+						toFinish = true;
+					}
+				}
+				//else {//the adj data is higher than the current data
+				//we continue since there could be some other data that intersect the current
+				//}
+			}
+			if(allAbove){
+				adjHeightAndDepth.get(direction)[0][0] = getMaxY();
+				adjHeightAndDepth.get(direction)[0][1] = getMinY();
+				faceToDraw++;
+			}
+			else if (toFinish)
+			{
+				adjHeightAndDepth.get(direction)[faceToDraw][1] = minY;
+				faceToDraw++;
+			}
+			adjHeightAndDepth.get(direction)[faceToDraw][0] = VOID_FACE;
+			adjHeightAndDepth.get(direction)[faceToDraw][1] = VOID_FACE;
+		}
+	}
+	
+	public void set(int xWidth, int yWidth, int zWidth)
+	{
+		box[WIDTH][X] = xWidth;
+		box[WIDTH][Y] = yWidth;
+		box[WIDTH][Z] = zWidth;
+	}
+	
+	public void move(int xOffset, int yOffset, int zOffset)
+	{
+		box[OFFSET][X] = xOffset;
+		box[OFFSET][Y] = yOffset;
+		box[OFFSET][Z] = zOffset;
+	}
+	
+	
+	
+	public int getFacePos(Direction direction)
+	{
+		return box[OFFSET][FACE_DIRECTION.get(direction)[0]] + box[WIDTH][FACE_DIRECTION.get(direction)[0]] * FACE_DIRECTION.get(direction)[1];
+	}
+	
+	public int getCoord(Direction direction, int axis, int vertexIndex)
+	{
+		return box[OFFSET][axis] + box[WIDTH][axis] * DIRECTION_VERTEX_MAP.get(direction)[vertexIndex][axis];
+	}
+	
+	public int getX(Direction direction, int vertexIndex)
+	{
+		return box[OFFSET][X] + box[WIDTH][X] * DIRECTION_VERTEX_MAP.get(direction)[vertexIndex][X];
+	}
+	
+	public int getY(Direction direction, int vertexIndex)
+	{
+		return box[OFFSET][Y] + box[WIDTH][Y] * DIRECTION_VERTEX_MAP.get(direction)[vertexIndex][Y];
+	}
+	
+	public int getY(Direction direction, int vertexIndex, int adjIndex)
+	{
+		if (direction == Direction.DOWN || direction == Direction.UP)
+		{
+			return box[OFFSET][Y] + box[WIDTH][Y] * DIRECTION_VERTEX_MAP.get(direction)[vertexIndex][Y];
+		} else
+		{
+			return adjHeightAndDepth.get(direction)[adjIndex][1 - DIRECTION_VERTEX_MAP.get(direction)[vertexIndex][Y]];
+		}
+	}
+	
+	public int getZ(Direction direction, int vertexIndex)
+	{
+		return box[OFFSET][Z] + box[WIDTH][Z] * DIRECTION_VERTEX_MAP.get(direction)[vertexIndex][Z];
+	}
+	
+	/**
+	 * returns true if the given direction should be rendered.
+	 * TODO what does adjIndex represent?
+	 */
+	public boolean shouldRenderFace(Direction direction, int adjIndex)
+	{
+		if (direction == Direction.UP || direction == Direction.DOWN)
+		{
+			return adjIndex == 0;
+		}
+		return !(adjHeightAndDepth.get(direction)[adjIndex][0] == VOID_FACE && adjHeightAndDepth.get(direction)[adjIndex][1] == VOID_FACE);
+		
+	}
+	
+	public int getMinX()
+	{
+		return box[OFFSET][X];
+	}
+	
+	public int getMaxX()
+	{
+		return box[OFFSET][X] + box[WIDTH][X];
+	}
+	
+	public int getMinY()
+	{
+		return box[OFFSET][Y];
+	}
+	
+	public int getMaxY()
+	{
+		return box[OFFSET][Y] + box[WIDTH][Y];
+	}
+	
+	public int getMinZ()
+	{
+		return box[OFFSET][Z];
+	}
+	
+	public int getMaxZ()
+	{
+		return box[OFFSET][Z] + box[WIDTH][Z];
+	}
+	
+}

src/main/java/com/seibel/lod/builders/lodTemplates/CubicLodTemplate.java

@@ -1,22 +1,38 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.seibel.lod.builders.lodTemplates;
 
-import java.awt.Color;
-import java.util.EnumSet;
+import java.util.Map;
 
-import com.seibel.lod.enums.ColorDirection;
-import com.seibel.lod.enums.RelativeChunkPos;
-import com.seibel.lod.objects.LodChunk;
-import com.seibel.lod.objects.LodDimension;
-import com.seibel.lod.util.LodConfig;
+import com.seibel.lod.enums.DebugMode;
+import com.seibel.lod.util.DataPointUtil;
+import com.seibel.lod.util.LodUtil;
 
 import net.minecraft.client.renderer.BufferBuilder;
-import net.minecraft.util.math.AxisAlignedBB;
+import net.minecraft.client.renderer.texture.NativeImage;
+import net.minecraft.util.Direction;
+import net.minecraft.util.math.BlockPos;
 
 /**
  * Builds LODs as rectangular prisms.
- * 
+ *
  * @author James Seibel
- * @version 05-31-2021
+ * @version 8-10-2021
  */
 public class CubicLodTemplate extends AbstractLodTemplate
 {
@@ -26,156 +42,42 @@ public class CubicLodTemplate extends AbstractLodTemplate
 		
 	}
 	
-	
 	@Override
-	public void addLodToBuffer(BufferBuilder buffer,
-			LodDimension lodDim, LodChunk centerLod, 
-			double xOffset, double yOffset, double zOffset, 
-			boolean debugging)
+	public void addLodToBuffer(BufferBuilder buffer, BlockPos bufferCenterBlockPos, long data, Map<Direction, long[]> adjData,
+			byte detailLevel, int posX, int posZ, Box box, DebugMode debugging, NativeImage lightMap)
 	{
-		AxisAlignedBB bbox;
+		int width = 1 << detailLevel;
 		
-		// Add this LOD to the BufferBuilder
-		// using the quality setting set by the config
-		switch(LodConfig.CLIENT.lodDetail.get())
+		int color = DataPointUtil.getLightColor(data, lightMap);
+		if (debugging != DebugMode.OFF)
 		{
-		// add a single LOD object for this chunk
-		case SINGLE:
-			
-			// returns null if the lod is empty at the given location
-			bbox = generateBoundingBox(centerLod.getHeight(), centerLod.getDepth(), LodChunk.WIDTH, xOffset, yOffset, zOffset);
-			
-			if (bbox != null)
-			{
-				addBoundingBoxToBuffer(buffer, bbox, generateLodColors(centerLod, false));
-			}
-			
-			break;
-		
-		// add 4 LOD objects for this chunk
-		case DOUBLE:
-			/*
-			 * This method generates LODs using the LodChunks that
-			 * are adjacent to create an average quarter and thus 
-			 * smooth the transition between chunks.
-			 */
-			
-			// get the adjacent LodChunks
-			LodChunk[] lods = new LodChunk[RelativeChunkPos.values().length];
-			for(RelativeChunkPos pos : RelativeChunkPos.values())
-				lods[pos.index] = lodDim.getLodFromCoordinates(centerLod.x + pos.x, centerLod.z + pos.z);
-			
-			
-			int halfWidth = LodChunk.WIDTH / 2;
-			
-			// use the adjacent chunks to generate quarter sections
-			for(EnumSet<RelativeChunkPos> set : RelativeChunkPos.CORNERS)
-			{
-				int x = 0;
-				int z = 0;
-				
-				// Weight the center LodChunk by this amount
-				// when taking the average.
-				// this should be between 3 and 6; 
-				// if set to 1 (no extra weight)
-				// then the chunks don't appear to be averaged.
-				int centerWeight = 3;
-				
-				// how many LodChunks adjacent to the center
-				// are valid?
-				int validPoints = centerWeight;
-				
-				int avgHeight = centerLod.getHeight() * centerWeight;
-				int avgDepth = centerLod.getDepth() * centerWeight;
-				
-				int[][] colorAverages = new int[ColorDirection.values().length][3];
-				Color[] colorToAdd = generateLodColors(centerLod, debugging);
-				for(int i = 0; i < centerWeight; i++)
-					colorAverages = addColorToColorAverages(colorAverages, colorToAdd);
-				
-				for(RelativeChunkPos cornerPos : set)
-				{
-					// set the x and y location based on which
-					// corner we are working on
-					if (RelativeChunkPos.DIAGONAL.contains(cornerPos))
-					{
-						x = Math.min(cornerPos.x, 0) * halfWidth;
-						z = Math.min(cornerPos.z, 0) * halfWidth;
-					}
-					
-					LodChunk cornerLod = lods[cornerPos.index];
-					if (cornerLod != null && !cornerLod.isLodEmpty())
-					{
-						validPoints++;
-						
-						avgHeight += cornerLod.getHeight();
-						avgDepth += cornerLod.getDepth();
-						
-						// only generate average colors if we aren't debugging
-						// (this is to prevent everything from becoming grey)
-						if (!debugging)
-							colorToAdd = generateLodColors(cornerLod, debugging);
-						else
-							colorToAdd = generateLodColors(centerLod, debugging);
-						// add to the running color average
-						colorAverages = addColorToColorAverages(colorAverages, colorToAdd);
-					}
-				}
-				
-				
-				// convert the heights into actual averages
-				avgHeight /= validPoints;
-				avgDepth /= validPoints;
-				// calculate the average colors
-				Color[] colors = new Color[ColorDirection.values().length];
-				for(ColorDirection dir : ColorDirection.values())
-				{
-					for(int rgbIndex = 0; rgbIndex < 3; rgbIndex++)
-						colorAverages[dir.value][rgbIndex] /= validPoints;
-					colors[dir.value] = new Color(colorAverages[dir.value][0], colorAverages[dir.value][1], colorAverages[dir.value][2]);
-				}
-				
-				
-				// returns null if the lod is empty at the given location
-				bbox = generateBoundingBox(avgHeight, avgDepth, halfWidth, xOffset - (halfWidth / 2) + x + 12, yOffset, zOffset - (halfWidth / 2) + z + 12);
-				
-				if (bbox != null)
-				{
-					addBoundingBoxToBuffer(buffer, bbox, colors);
-				}
-			}
-			break;
-		} // case
-	}
-	
-	
-	private int[][] addColorToColorAverages(int[][] colorAverages, Color[] colorToAdd) 
-	{
-		for(ColorDirection dir : ColorDirection.values())
-		{
-			// convert the colorToAdd to an int array
-			float[] colorCompoments = new float[4];
-			colorCompoments = colorToAdd[dir.value].getColorComponents(colorCompoments);
-			
-			// add each color component to the array
-			for(int rgbIndex = 0; rgbIndex < 3; rgbIndex++)
-			{
-				// * 255 + 0.5 taken from the Color java class
-				colorAverages[dir.value][rgbIndex] += (int) (colorCompoments[rgbIndex] * 255 + 0.5);
-			}
+			color = LodUtil.DEBUG_DETAIL_LEVEL_COLORS[detailLevel].getRGB();
+		}
+		
+		generateBoundingBox(
+				box,
+				DataPointUtil.getHeight(data),
+				DataPointUtil.getDepth(data),
+				width,
+				posX * width,
+				0,
+				posZ * width,
+				bufferCenterBlockPos,
+				adjData,
+				color);
+		
+		if (box != null)
+		{
+			addBoundingBoxToBuffer(buffer, box);
 		}
 		
-		return colorAverages;
 	}
 	
-	
-	
-	
-	private AxisAlignedBB generateBoundingBox(int height, int depth, int width, double xOffset, double yOffset, double zOffset)
+	private void generateBoundingBox(Box box, int height, int depth, int width, double xOffset, double yOffset, double zOffset, BlockPos bufferCenterBlockPos, Map<Direction, long[]> adjData, int color)
 	{
 		// don't add an LOD if it is empty
 		if (height == -1 && depth == -1)
-			return null;
+			return;
 		
 		if (depth == height)
 		{
@@ -184,94 +86,44 @@ public class CubicLodTemplate extends AbstractLodTemplate
 			height++;
 		}
 		
-		return new AxisAlignedBB(0, depth, 0, width, height, width).offset(xOffset, yOffset, zOffset);
+		// offset the AABB by it's x/z position in the world since
+		// it uses doubles to specify its location, unlike the model view matrix
+		// which only uses floats
+		double x = -bufferCenterBlockPos.getX();
+		double z = -bufferCenterBlockPos.getZ();
+		box.reset();
+		box.setColor(color);
+		box.set(width, height - depth, width);
+		box.move((int) (xOffset + x), (int) (depth + yOffset), (int) (zOffset + z));
+		box.setUpCulling(32, bufferCenterBlockPos);
+		box.setAdjData(adjData);
 	}
 	
-	
-	
-	private void addBoundingBoxToBuffer(BufferBuilder buffer, AxisAlignedBB bb, Color[] c)
+	private void addBoundingBoxToBuffer(BufferBuilder buffer, Box box)
 	{
-		// top (facing up)
-		addPosAndColor(buffer, bb.minX, bb.maxY, bb.minZ, c[ColorDirection.TOP.value].getRed(), c[ColorDirection.TOP.value].getGreen(), c[ColorDirection.TOP.value].getBlue(), c[ColorDirection.TOP.value].getAlpha());
-		addPosAndColor(buffer, bb.minX, bb.maxY, bb.maxZ, c[ColorDirection.TOP.value].getRed(), c[ColorDirection.TOP.value].getGreen(), c[ColorDirection.TOP.value].getBlue(), c[ColorDirection.TOP.value].getAlpha());
-		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.maxZ, c[ColorDirection.TOP.value].getRed(), c[ColorDirection.TOP.value].getGreen(), c[ColorDirection.TOP.value].getBlue(), c[ColorDirection.TOP.value].getAlpha());
-		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.minZ, c[ColorDirection.TOP.value].getRed(), c[ColorDirection.TOP.value].getGreen(), c[ColorDirection.TOP.value].getBlue(), c[ColorDirection.TOP.value].getAlpha());
-		// bottom (facing down)
-		addPosAndColor(buffer, bb.maxX, bb.minY, bb.minZ, c[ColorDirection.BOTTOM.value].getRed(), c[ColorDirection.BOTTOM.value].getGreen(), c[ColorDirection.BOTTOM.value].getBlue(), c[ColorDirection.BOTTOM.value].getAlpha());
-		addPosAndColor(buffer, bb.maxX, bb.minY, bb.maxZ, c[ColorDirection.BOTTOM.value].getRed(), c[ColorDirection.BOTTOM.value].getGreen(), c[ColorDirection.BOTTOM.value].getBlue(), c[ColorDirection.BOTTOM.value].getAlpha());
-		addPosAndColor(buffer, bb.minX, bb.minY, bb.maxZ, c[ColorDirection.BOTTOM.value].getRed(), c[ColorDirection.BOTTOM.value].getGreen(), c[ColorDirection.BOTTOM.value].getBlue(), c[ColorDirection.BOTTOM.value].getAlpha());
-		addPosAndColor(buffer, bb.minX, bb.minY, bb.minZ, c[ColorDirection.BOTTOM.value].getRed(), c[ColorDirection.BOTTOM.value].getGreen(), c[ColorDirection.BOTTOM.value].getBlue(), c[ColorDirection.BOTTOM.value].getAlpha());
-
-		// south (facing -Z) 
-		addPosAndColor(buffer, bb.maxX, bb.minY, bb.maxZ, c[ColorDirection.SOUTH.value].getRed(), c[ColorDirection.SOUTH.value].getGreen(), c[ColorDirection.SOUTH.value].getBlue(), c[ColorDirection.SOUTH.value].getAlpha());
-		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.maxZ, c[ColorDirection.SOUTH.value].getRed(), c[ColorDirection.SOUTH.value].getGreen(), c[ColorDirection.SOUTH.value].getBlue(), c[ColorDirection.SOUTH.value].getAlpha());
-		addPosAndColor(buffer, bb.minX, bb.maxY, bb.maxZ, c[ColorDirection.SOUTH.value].getRed(), c[ColorDirection.SOUTH.value].getGreen(), c[ColorDirection.SOUTH.value].getBlue(), c[ColorDirection.SOUTH.value].getAlpha());
-		addPosAndColor(buffer, bb.minX, bb.minY, bb.maxZ, c[ColorDirection.SOUTH.value].getRed(), c[ColorDirection.SOUTH.value].getGreen(), c[ColorDirection.SOUTH.value].getBlue(), c[ColorDirection.SOUTH.value].getAlpha());
-		// north (facing +Z)
-		addPosAndColor(buffer, bb.minX, bb.minY, bb.minZ, c[ColorDirection.NORTH.value].getRed(), c[ColorDirection.NORTH.value].getGreen(), c[ColorDirection.NORTH.value].getBlue(), c[ColorDirection.NORTH.value].getAlpha());
-		addPosAndColor(buffer, bb.minX, bb.maxY, bb.minZ, c[ColorDirection.NORTH.value].getRed(), c[ColorDirection.NORTH.value].getGreen(), c[ColorDirection.NORTH.value].getBlue(), c[ColorDirection.NORTH.value].getAlpha());
-		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.minZ, c[ColorDirection.NORTH.value].getRed(), c[ColorDirection.NORTH.value].getGreen(), c[ColorDirection.NORTH.value].getBlue(), c[ColorDirection.NORTH.value].getAlpha());
-		addPosAndColor(buffer, bb.maxX, bb.minY, bb.minZ, c[ColorDirection.NORTH.value].getRed(), c[ColorDirection.NORTH.value].getGreen(), c[ColorDirection.NORTH.value].getBlue(), c[ColorDirection.NORTH.value].getAlpha());
-
-		// west (facing -X)
-		addPosAndColor(buffer, bb.minX, bb.minY, bb.minZ, c[ColorDirection.WEST.value].getRed(), c[ColorDirection.WEST.value].getGreen(), c[ColorDirection.WEST.value].getBlue(), c[ColorDirection.WEST.value].getAlpha());
-		addPosAndColor(buffer, bb.minX, bb.minY, bb.maxZ, c[ColorDirection.WEST.value].getRed(), c[ColorDirection.WEST.value].getGreen(), c[ColorDirection.WEST.value].getBlue(), c[ColorDirection.WEST.value].getAlpha());
-		addPosAndColor(buffer, bb.minX, bb.maxY, bb.maxZ, c[ColorDirection.WEST.value].getRed(), c[ColorDirection.WEST.value].getGreen(), c[ColorDirection.WEST.value].getBlue(), c[ColorDirection.WEST.value].getAlpha());
-		addPosAndColor(buffer, bb.minX, bb.maxY, bb.minZ, c[ColorDirection.WEST.value].getRed(), c[ColorDirection.WEST.value].getGreen(), c[ColorDirection.WEST.value].getBlue(), c[ColorDirection.WEST.value].getAlpha());
-		// east (facing +X)
-		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.minZ, c[ColorDirection.EAST.value].getRed(), c[ColorDirection.EAST.value].getGreen(), c[ColorDirection.EAST.value].getBlue(), c[ColorDirection.EAST.value].getAlpha());
-		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.maxZ, c[ColorDirection.EAST.value].getRed(), c[ColorDirection.EAST.value].getGreen(), c[ColorDirection.EAST.value].getBlue(), c[ColorDirection.EAST.value].getAlpha());
-		addPosAndColor(buffer, bb.maxX, bb.minY, bb.maxZ, c[ColorDirection.EAST.value].getRed(), c[ColorDirection.EAST.value].getGreen(), c[ColorDirection.EAST.value].getBlue(), c[ColorDirection.EAST.value].getAlpha());
-		addPosAndColor(buffer, bb.maxX, bb.minY, bb.minZ, c[ColorDirection.EAST.value].getRed(), c[ColorDirection.EAST.value].getGreen(), c[ColorDirection.EAST.value].getBlue(), c[ColorDirection.EAST.value].getAlpha());
-	}
-	
-	
-	
-	
-	
-	
-	/**
-	 * Determine the color for each side of this LOD.
-	 */
-	private Color[] generateLodColors(LodChunk lod, boolean debugging)
-	{
-		Color[] colors = new Color[ColorDirection.values().length];
-		
-		if (!debugging)
+		for (Direction direction : Box.DIRECTIONS)
 		{
-			// if NOT debugging, look to the config to determine
-			// how this LOD should be colored
-			switch (LodConfig.CLIENT.lodColorStyle.get())
+			int adjIndex = 0;
+			while (box.shouldRenderFace(direction, adjIndex))
 			{
-			case TOP:
-				// only add the top's color to the array
-				for(ColorDirection dir : ColorDirection.values())
-					colors[dir.value] = lod.getColor(ColorDirection.TOP);
-				break;
-				
-			case INDIVIDUAL_SIDES:
-				// add each direction's color to the array
-				for(ColorDirection dir : ColorDirection.values())
-					colors[dir.value] = lod.getColor(dir);
-				break;
+				for (int vertexIndex = 0; vertexIndex < 4; vertexIndex++)
+				{
+					addPosAndColor(buffer,
+							box.getX(direction, vertexIndex),
+							box.getY(direction, vertexIndex, adjIndex),
+							box.getZ(direction, vertexIndex),
+							box.getColor(direction));
+				}
+				adjIndex++;
 			}
 		}
-		else
-		{
-			// if debugging draw the squares as a black and white checker board
-			if ((lod.x + lod.z) % 2 == 0)
-				for(ColorDirection dir : ColorDirection.values())
-					// have each direction be the same
-					// color if debugging
-					colors[dir.value] = debugWhite;
-			else
-				for(ColorDirection dir : ColorDirection.values())
-					colors[dir.value] = debugBlack;
-		}
-		
-		return colors;
 	}
 	
+	@Override
+	public int getBufferMemoryForSingleNode(int maxVerticalData)
+	{
+		// TODO, someone please comment what these magic numbers mean
+		return 2 * 4 * (3 + 4) + 4 * 4 * Math.max((maxVerticalData+1)/2,1) * (3 + 4);
+	}
 	
-
 }

src/main/java/com/seibel/lod/builders/lodTemplates/DynamicLodTemplate.java

@@ -1,27 +1,53 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.seibel.lod.builders.lodTemplates;
 
-import com.seibel.lod.objects.LodChunk;
-import com.seibel.lod.objects.LodDimension;
+import java.util.Map;
+
+import com.seibel.lod.enums.DebugMode;
+import com.seibel.lod.proxy.ClientProxy;
 
 import net.minecraft.client.renderer.BufferBuilder;
+import net.minecraft.client.renderer.texture.NativeImage;
+import net.minecraft.util.Direction;
+import net.minecraft.util.math.BlockPos;
 
 /**
  * TODO DynamicLodTemplate
  * Chunks smoothly transition between
  * each other, unless a neighboring chunk
  * is at a significantly different height.
- * 
+ *
  * @author James Seibel
- * @version 05-07-2021
+ * @version 06-16-2021
  */
 public class DynamicLodTemplate extends AbstractLodTemplate
 {
 	@Override
-	public void addLodToBuffer(BufferBuilder buffer,
-			LodDimension lodDim, LodChunk lod, 
-			double xOffset, double yOffset, double zOffset, 
-			boolean debugging)
+	public void addLodToBuffer(BufferBuilder buffer, BlockPos bufferCenterBlockPos, long data, Map<Direction, long[]> adjData,
+	                           byte detailLevel, int posX, int posZ, Box box, DebugMode debugging, NativeImage lightMap)
 	{
-		System.err.println("DynamicLodTemplate not implemented!");
+		ClientProxy.LOGGER.error(DynamicLodTemplate.class.getSimpleName() + " is not implemented!");
+	}
+
+	@Override
+	public int getBufferMemoryForSingleNode(int maxVerticalData)
+	{
+		return 0;
 	}
 }

src/main/java/com/seibel/lod/builders/lodTemplates/TriangularLodTemplate.java

@@ -1,25 +1,51 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.seibel.lod.builders.lodTemplates;
 
-import com.seibel.lod.objects.LodChunk;
-import com.seibel.lod.objects.LodDimension;
+import java.util.Map;
+
+import com.seibel.lod.enums.DebugMode;
+import com.seibel.lod.proxy.ClientProxy;
 
 import net.minecraft.client.renderer.BufferBuilder;
+import net.minecraft.client.renderer.texture.NativeImage;
+import net.minecraft.util.Direction;
+import net.minecraft.util.math.BlockPos;
 
 /**
- * TODO TriangularLodTemplate
+ * TODO #21 TriangularLodTemplate
  * Builds each LOD chunk as a singular rectangular prism.
- * 
+ *
  * @author James Seibel
- * @version 05-07-2021
+ * @version 06-16-2021
  */
 public class TriangularLodTemplate extends AbstractLodTemplate
 {
 	@Override
-	public void addLodToBuffer(BufferBuilder buffer,
-			LodDimension lodDim, LodChunk lod, 
-			double xOffset, double yOffset, double zOffset, 
-			boolean debugging)
+	public void addLodToBuffer(BufferBuilder buffer, BlockPos bufferCenterBlockPos, long data, Map<Direction, long[]> adjData,
+	                           byte detailLevel, int posX, int posZ, Box box, DebugMode debugging, NativeImage lightMap)
 	{
-		System.err.println("DynamicLodTemplate not implemented!");
+		ClientProxy.LOGGER.error(DynamicLodTemplate.class.getSimpleName() + " is not implemented!");
+	}
+
+	@Override
+	public int getBufferMemoryForSingleNode(int maxVerticalData)
+	{
+		return 0;
 	}
 }

src/main/java/com/seibel/lod/builders/worldGeneration/LodNodeGenWorker.java

@@ -0,0 +1,664 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.builders.worldGeneration;
+
+import java.util.ConcurrentModificationException;
+import java.util.HashSet;
+import java.util.LinkedList;
+import java.util.List;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+import java.util.function.Supplier;
+
+import com.google.common.util.concurrent.ThreadFactoryBuilder;
+import com.seibel.lod.builders.LodBuilder;
+import com.seibel.lod.builders.LodBuilderConfig;
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.proxy.ClientProxy;
+import com.seibel.lod.util.LodThreadFactory;
+import com.seibel.lod.util.LodUtil;
+
+import net.minecraft.block.Block;
+import net.minecraft.block.BlockState;
+import net.minecraft.util.WeightedList.Entry;
+import net.minecraft.util.math.ChunkPos;
+import net.minecraft.util.palette.UpgradeData;
+import net.minecraft.util.registry.Registry;
+import net.minecraft.world.biome.Biome;
+import net.minecraft.world.chunk.ChunkPrimer;
+import net.minecraft.world.chunk.ChunkStatus;
+import net.minecraft.world.chunk.IChunk;
+import net.minecraft.world.gen.ChunkGenerator;
+import net.minecraft.world.gen.Heightmap;
+import net.minecraft.world.gen.blockstateprovider.WeightedBlockStateProvider;
+import net.minecraft.world.gen.feature.BlockClusterFeatureConfig;
+import net.minecraft.world.gen.feature.ConfiguredFeature;
+import net.minecraft.world.gen.feature.DecoratedFeatureConfig;
+import net.minecraft.world.gen.feature.FeatureSpread;
+import net.minecraft.world.gen.feature.FeatureSpreadConfig;
+import net.minecraft.world.gen.feature.IceAndSnowFeature;
+import net.minecraft.world.gen.feature.NoFeatureConfig;
+import net.minecraft.world.gen.placement.ConfiguredPlacement;
+import net.minecraft.world.gen.placement.DecoratedPlacementConfig;
+import net.minecraft.world.gen.placement.IPlacementConfig;
+import net.minecraft.world.gen.placement.NoiseDependant;
+import net.minecraft.world.server.ServerChunkProvider;
+import net.minecraft.world.server.ServerWorld;
+import net.minecraft.world.server.ServerWorldLightManager;
+import net.minecraftforge.common.WorldWorkerManager.IWorker;
+
+/**
+ * This is used to generate a LodChunk at a given ChunkPos.
+ *
+ * @author James Seibel
+ * @version 9-7-2021
+ */
+public class LodNodeGenWorker implements IWorker
+{
+	public static ExecutorService genThreads = Executors.newFixedThreadPool(LodConfig.CLIENT.threading.numberOfWorldGenerationThreads.get(), new ThreadFactoryBuilder().setNameFormat("Gen-Worker-Thread-%d").build());
+	//public static ExecutorService genThreads = Executors.newFixedThreadPool(LodConfig.CLIENT.threading.numberOfWorldGenerationThreads.get(), new LodThreadFactory(LodNodeGenWorker.class.getSimpleName()));
+
+	private boolean threadStarted = false;
+	private LodChunkGenThread thread;
+	
+	
+	/** If a configured feature fails for whatever reason,
+	 * add it to this list, this is to hopefully remove any
+	 * features that could cause issues down the line. */
+	private static ConcurrentHashMap<Integer, ConfiguredFeature<?, ?>> configuredFeaturesToAvoid = new ConcurrentHashMap<>();
+
+
+
+	public LodNodeGenWorker(ChunkPos newPos, DistanceGenerationMode newGenerationMode,
+							LodBuilder newLodBuilder,
+							LodDimension newLodDimension, ServerWorld newServerWorld)
+	{
+		// just a few sanity checks
+		if (newPos == null)
+			throw new IllegalArgumentException("LodChunkGenWorker must have a non-null ChunkPos");
+
+		if (newLodBuilder == null)
+			throw new IllegalArgumentException("LodChunkGenThread requires a non-null LodChunkBuilder");
+
+		if (newLodDimension == null)
+			throw new IllegalArgumentException("LodChunkGenThread requires a non-null LodDimension");
+
+		if (newServerWorld == null)
+			throw new IllegalArgumentException("LodChunkGenThread requires a non-null ServerWorld");
+
+
+
+		thread = new LodChunkGenThread(newPos, newGenerationMode,
+				newLodBuilder,
+				newLodDimension, newServerWorld);
+	}
+
+	public static void resetGenerator(){
+		ExecutorService genThreads = Executors.newFixedThreadPool(LodConfig.CLIENT.threading.numberOfWorldGenerationThreads.get(), new ThreadFactoryBuilder().setNameFormat("Gen-Worker-Thread-%d").build());
+	}
+
+	@Override
+	public boolean doWork()
+	{
+		if (!threadStarted)
+		{
+			if (LodConfig.CLIENT.worldGenerator.distanceGenerationMode.get() == DistanceGenerationMode.SERVER)
+			{
+				// if we are using SERVER generation that has to be done
+				// synchronously to prevent crashing and harmful
+				// interactions with the normal world generator
+				thread.run();
+			}
+			else
+			{
+				// Every other method can
+				// be done asynchronously
+				Thread newThread = new Thread(thread);
+				newThread.setPriority(5);
+				genThreads.execute(newThread);
+			}
+
+			threadStarted = true;
+
+			// useful for debugging
+//        	ClientProxy.LOGGER.info(thread.lodDim.getNumberOfLods());
+//        	ClientProxy.LOGGER.info(genThreads.toString());
+		}
+
+		return false;
+	}
+
+	@Override
+	public boolean hasWork()
+	{
+		return !threadStarted;
+	}
+
+
+
+
+	private class LodChunkGenThread implements Runnable
+	{
+		public final ServerWorld serverWorld;
+		public final LodDimension lodDim;
+		public final DistanceGenerationMode generationMode;
+		public final LodBuilder lodBuilder;
+
+		private ChunkPos pos;
+
+		public LodChunkGenThread(ChunkPos newPos, DistanceGenerationMode newGenerationMode,
+								 LodBuilder newLodBuilder,
+								 LodDimension newLodDimension, ServerWorld newServerWorld)
+		{
+			pos = newPos;
+			generationMode = newGenerationMode;
+			lodBuilder = newLodBuilder;
+			lodDim = newLodDimension;
+			serverWorld = newServerWorld;
+		}
+
+		@Override
+		public void run()
+		{
+			try
+			{
+				// only generate LodChunks if they can
+				// be added to the current LodDimension
+
+				/**TODO i must disable this if, i will find a way to replace it*/
+				if (lodDim.regionIsInRange(pos.x / LodUtil.REGION_WIDTH_IN_CHUNKS, pos.z / LodUtil.REGION_WIDTH_IN_CHUNKS))
+				{
+//					long startTime = System.currentTimeMillis();
+
+					switch(generationMode)
+					{
+						case NONE:
+							// don't generate
+							break;
+						case BIOME_ONLY:
+						case BIOME_ONLY_SIMULATE_HEIGHT:
+							// fastest
+							generateUsingBiomesOnly();
+							break;
+						case SURFACE:
+							// faster
+							generateUsingSurface();
+							break;
+						case FEATURES:
+							// fast
+							generateUsingFeatures();
+							break;
+						case SERVER:
+							// very slow
+							generateWithServer();
+							break;
+					}
+
+					//lodRenderer.regenerateLODsNextFrame();
+
+/*
+					boolean dataExistence = lodDim.doesDataExist(new LevelPos((byte) 3, pos.x, pos.z));
+					if (dataExistence)
+						ClientProxy.LOGGER.info(pos.x + " " + pos.z + " Success!");
+					else
+						ClientProxy.LOGGER.info(pos.x + " " + pos.z);
+*/
+					// shows the pool size, active threads, queued tasks and completed tasks
+//					ClientProxy.LOGGER.info(genThreads.toString());
+
+//					long endTime = System.currentTimeMillis();
+//					System.out.println(endTime - startTime);
+
+				}// if in range
+				//else{
+
+				//}
+			}
+			catch (Exception e)
+			{
+				//e.printStackTrace();
+			}
+			finally
+			{
+				// decrement how many threads are running
+				LodWorldGenerator.INSTANCE.numberOfChunksWaitingToGenerate.addAndGet(-1);
+				
+				// this position is no longer being generated
+				LodWorldGenerator.INSTANCE.positionWaitingToBeGenerated.remove(pos);
+			}
+
+		}// run
+
+
+
+		/**
+		 * takes about 2-5 ms
+		 */
+		private void generateUsingBiomesOnly()
+		{
+			List<IChunk> chunkList = new LinkedList<>();
+			ChunkPrimer chunk = new ChunkPrimer(pos, UpgradeData.EMPTY);
+			chunkList.add(chunk);
+
+			ServerChunkProvider chunkSource = serverWorld.getChunkSource();
+			ChunkGenerator chunkGen = chunkSource.generator;
+
+			// generate the terrain (this is thread safe)
+			ChunkStatus.EMPTY.generate(serverWorld, chunkGen, serverWorld.getStructureManager(), (ServerWorldLightManager) serverWorld.getLightEngine(), null, chunkList);
+			// override the chunk status so we can run the next generator stage
+			chunk.setStatus(ChunkStatus.STRUCTURE_REFERENCES);
+			chunkGen.createBiomes(serverWorld.registryAccess().registryOrThrow(Registry.BIOME_REGISTRY), chunk);
+			chunk.setStatus(ChunkStatus.STRUCTURE_REFERENCES);
+
+
+
+
+			// generate fake height data for this LOD
+			int seaLevel = serverWorld.getSeaLevel();
+
+			boolean simulateHeight = generationMode == DistanceGenerationMode.BIOME_ONLY_SIMULATE_HEIGHT;
+			boolean inTheEnd = false;
+
+			// add fake heightmap data so our LODs aren't at height 0
+			Heightmap heightmap = new Heightmap(chunk, LodUtil.DEFAULT_HEIGHTMAP);
+			for(int x = 0; x < LodUtil.CHUNK_WIDTH && !inTheEnd; x++)
+			{
+				for(int z = 0; z < LodUtil.CHUNK_WIDTH && !inTheEnd; z++)
+				{
+					if (simulateHeight)
+					{
+						// these heights are of course aren't super accurate,
+						// they are just to simulate height data where there isn't any
+						switch(chunk.getBiomes().getNoiseBiome(x >> 2, seaLevel >> 2, z >> 2).getBiomeCategory())
+						{
+							case NETHER:
+								heightmap.setHeight(x, z, serverWorld.getHeight() / 2);
+								break;
+
+							case EXTREME_HILLS:
+								heightmap.setHeight(x, z, seaLevel + 30);
+								break;
+							case MESA:
+								heightmap.setHeight(x, z, seaLevel + 20);
+								break;
+							case JUNGLE:
+								heightmap.setHeight(x, z, seaLevel + 20);
+								break;
+							case BEACH:
+								heightmap.setHeight(x, z, seaLevel + 5);
+								break;
+							case NONE:
+								heightmap.setHeight(x, z, 0);
+								break;
+
+							case OCEAN:
+							case RIVER:
+								heightmap.setHeight(x, z, seaLevel);
+								break;
+
+							case THEEND:
+								inTheEnd = true;
+								break;
+
+							// DESERT
+							// FOREST
+							// ICY
+							// MUSHROOM
+							// SAVANNA
+							// SWAMP
+							// TAIGA
+							// PLAINS
+							default:
+								heightmap.setHeight(x, z, seaLevel + 10);
+								break;
+						}// heightmap switch
+					}
+					else
+					{
+						// we aren't simulating height
+						// always use sea level
+						heightmap.setHeight(x, z, seaLevel);
+					}
+				}// z
+			}// x
+
+			chunk.setHeightmap(LodUtil.DEFAULT_HEIGHTMAP, heightmap.getRawData());
+
+
+			if (!inTheEnd)
+			{
+				lodBuilder.generateLodNodeFromChunk(lodDim, chunk, new LodBuilderConfig(true, true, false));
+			}
+			else
+			{
+				// if we are in the end, don't generate any chunks.
+				// Since we don't know where the islands are, everything
+				// generates the same and it looks really bad.
+				lodBuilder.generateLodNodeFromChunk(lodDim, chunk, new LodBuilderConfig(true, true, false));
+			}
+
+
+//			long startTime = System.currentTimeMillis();
+//			long endTime = System.currentTimeMillis();
+//			System.out.println(endTime - startTime);
+		}
+
+
+		/**
+		 * takes about 10 - 20 ms
+		 */
+		private void generateUsingSurface()
+		{
+			List<IChunk> chunkList = new LinkedList<>();
+			ChunkPrimer chunk = new ChunkPrimer(pos, UpgradeData.EMPTY);
+			chunkList.add(chunk);
+			LodServerWorld lodServerWorld = new LodServerWorld(serverWorld, chunk);
+
+			ServerChunkProvider chunkSource = serverWorld.getChunkSource();
+			ChunkGenerator chunkGen = chunkSource.generator;
+
+
+			// generate the terrain (this is thread safe)
+			ChunkStatus.EMPTY.generate(serverWorld, chunkGen, serverWorld.getStructureManager(), (ServerWorldLightManager) serverWorld.getLightEngine(), null, chunkList);
+			// override the chunk status so we can run the next generator stage
+			chunk.setStatus(ChunkStatus.STRUCTURE_REFERENCES);
+			chunkGen.createBiomes(serverWorld.registryAccess().registryOrThrow(Registry.BIOME_REGISTRY), chunk);
+			ChunkStatus.NOISE.generate(serverWorld, chunkGen, serverWorld.getStructureManager(), (ServerWorldLightManager) serverWorld.getLightEngine(), null, chunkList);
+			ChunkStatus.SURFACE.generate(serverWorld, chunkGen, serverWorld.getStructureManager(), (ServerWorldLightManager) serverWorld.getLightEngine(), null, chunkList);
+
+			// this feature has been proven to be thread safe
+			// so we will add it
+			IceAndSnowFeature snowFeature = new IceAndSnowFeature(NoFeatureConfig.CODEC);
+			snowFeature.place(lodServerWorld, chunkGen, serverWorld.random, chunk.getPos().getWorldPosition(), null);
+
+			lodBuilder.generateLodNodeFromChunk(lodDim, chunk, new LodBuilderConfig(DistanceGenerationMode.SURFACE));
+
+			/**TODO if we want to use Biome utils and terrain utils for overworld
+			 * lodBuilder.generateLodNodeFromChunk(lodDim, pos ,detailLevel, serverWorld.getSeed());*/
+		}
+
+
+		/**
+		 * takes about 15 - 20 ms
+		 *
+		 * Causes concurrentModification Exceptions,
+		 * which could cause instability or world generation bugs
+		 */
+		private void generateUsingFeatures()
+		{
+			List<IChunk> chunkList = new LinkedList<>();
+			ChunkPrimer chunk = new ChunkPrimer(pos, UpgradeData.EMPTY);
+			chunkList.add(chunk);
+			LodServerWorld lodServerWorld = new LodServerWorld(serverWorld, chunk);
+
+			ServerChunkProvider chunkSource = serverWorld.getChunkSource();
+			ChunkGenerator chunkGen = chunkSource.generator;
+
+
+			// generate the terrain (this is thread safe)
+			ChunkStatus.EMPTY.generate(serverWorld, chunkGen, serverWorld.getStructureManager(), (ServerWorldLightManager) serverWorld.getLightEngine(), null, chunkList);
+			// override the chunk status so we can run the next generator stage
+			chunk.setStatus(ChunkStatus.STRUCTURE_REFERENCES);
+			chunkGen.createBiomes(serverWorld.registryAccess().registryOrThrow(Registry.BIOME_REGISTRY), chunk);
+			ChunkStatus.NOISE.generate(serverWorld, chunkGen, serverWorld.getStructureManager(), (ServerWorldLightManager) serverWorld.getLightEngine(), null, chunkList);
+			ChunkStatus.SURFACE.generate(serverWorld, chunkGen, serverWorld.getStructureManager(), (ServerWorldLightManager) serverWorld.getLightEngine(), null, chunkList);
+
+
+			// get all the biomes in the chunk
+			HashSet<Biome> biomes = new HashSet<>();
+			for (int x = 0; x < LodUtil.CHUNK_WIDTH; x++)
+			{
+				for (int z = 0; z < LodUtil.CHUNK_WIDTH; z++)
+				{
+					Biome biome = chunk.getBiomes().getNoiseBiome(x >> 2, serverWorld.getSeaLevel() >> 2, z >> 2);
+
+					// Issue #35
+					// For some reason Jungle biomes cause incredible lag
+					// the features here must be interacting with each other
+					// in unpredictable ways (specifically tree feature generation).
+					// When generating Features my CPU usage generally hovers around 30 - 40%
+					// when generating Jungles it spikes to 100%.
+					if (biome.getBiomeCategory() != Biome.Category.JUNGLE)
+					{
+						// should probably use the heightmap here instead of seaLevel,
+						// but this seems to get the job done well enough
+						biomes.add(biome);
+					}
+				}
+			}
+
+			boolean allowUnstableFeatures = LodConfig.CLIENT.worldGenerator.allowUnstableFeatureGeneration.get();
+
+			// generate all the features related to this chunk.
+			// this may or may not be thread safe
+			for (Biome biome : biomes)
+			{
+				List<List<Supplier<ConfiguredFeature<?, ?>>>> featuresForState = biome.generationSettings.features();
+
+				for(int featureStateToGenerate = 0; featureStateToGenerate < featuresForState.size(); featureStateToGenerate++)
+				{
+					for(Supplier<ConfiguredFeature<?, ?>> featureSupplier : featuresForState.get(featureStateToGenerate))
+					{
+						ConfiguredFeature<?, ?> configuredFeature = featureSupplier.get();
+
+						if (!allowUnstableFeatures &&
+								configuredFeaturesToAvoid.containsKey(configuredFeature.hashCode()))
+							continue;
+
+
+						try
+						{
+							configuredFeature.place(lodServerWorld, chunkGen, serverWorld.random, chunk.getPos().getWorldPosition());
+						}
+						catch(ConcurrentModificationException e)
+						{
+							// This will happen. I'm not sure what to do about it
+							// except pray that it doesn't effect the normal world generation
+							// in any harmful way.
+							// Update: this can cause crashes and high CPU usage.
+
+							// Issue #35
+							// I tried cloning the config for each feature, but that
+							// path was blocked since I can't clone lambda methods.
+							// I tried using a deep cloning library and discovered
+							// the problem there.
+							// ( https://github.com/kostaskougios/cloning
+							//   and
+							//   https://github.com/EsotericSoftware/kryo )
+
+							if (!allowUnstableFeatures)
+								configuredFeaturesToAvoid.put(configuredFeature.hashCode(), configuredFeature);
+//							ClientProxy.LOGGER.info(configuredFeaturesToAvoid.mappingCount());
+						}
+						catch(UnsupportedOperationException e)
+						{
+							// This will happen when the LodServerWorld
+							// isn't able to return something that a feature
+							// generator needs
+
+							if (!allowUnstableFeatures)
+								configuredFeaturesToAvoid.put(configuredFeature.hashCode(), configuredFeature);
+//							ClientProxy.LOGGER.info(configuredFeaturesToAvoid.mappingCount());
+						}
+						catch(Exception e)
+						{
+							// I'm not sure what happened, print to the log
+
+							System.out.println();
+							System.out.println();
+							e.printStackTrace();
+							System.out.println();
+							System.out.println();
+
+							if (!allowUnstableFeatures)
+								configuredFeaturesToAvoid.put(configuredFeature.hashCode(), configuredFeature);
+//							ClientProxy.LOGGER.info(configuredFeaturesToAvoid.mappingCount());
+						}
+					}
+				}
+			}
+
+			// generate a Lod like normal
+
+			lodBuilder.generateLodNodeFromChunk(lodDim, chunk, new LodBuilderConfig(DistanceGenerationMode.FEATURES));
+		}
+
+
+		/**
+		 * on pre generated chunks 0 - 1 ms
+		 * on un generated chunks 0 - 50 ms
+		 * 	with the median seeming to hover around 15 - 30 ms
+		 * 	and outliers in the 100 - 200 ms range
+		 *
+		 * Note this should not be multithreaded and does cause server/simulation lag
+		 * (Higher lag for generating than loading)
+		 */
+		private void generateWithServer()
+		{
+			lodBuilder.generateLodNodeAsync(serverWorld.getChunk(pos.x, pos.z, ChunkStatus.FEATURES), ClientProxy.getLodWorld(), serverWorld);
+		}
+
+
+
+
+
+
+		//================//
+		// Unused methods //
+		//================//
+
+		// Sadly I wasn't able to get these to work,
+		// they are here for documentation purposes
+
+		@SuppressWarnings({ "rawtypes", "unchecked", "unused" })
+		private DecoratedFeatureConfig cloneDecoratedFeatureConfig(DecoratedFeatureConfig config)
+		{
+			IPlacementConfig placementConfig = null;
+
+			Class oldConfigClass = config.decorator.config().getClass();
+
+			if (oldConfigClass == FeatureSpreadConfig.class)
+			{
+				FeatureSpreadConfig oldPlacementConfig = (FeatureSpreadConfig) config.decorator.config();
+				FeatureSpread oldSpread = oldPlacementConfig.count();
+
+				placementConfig = new FeatureSpreadConfig(oldSpread);
+			}
+			else if(oldConfigClass == DecoratedPlacementConfig.class)
+			{
+				DecoratedPlacementConfig oldPlacementConfig = (DecoratedPlacementConfig) config.decorator.config();
+				placementConfig = new DecoratedPlacementConfig(oldPlacementConfig.inner(), oldPlacementConfig.outer());
+			}
+			else if(oldConfigClass == NoiseDependant.class)
+			{
+				NoiseDependant oldPlacementConfig = (NoiseDependant) config.decorator.config();
+				placementConfig = new NoiseDependant(oldPlacementConfig.noiseLevel, oldPlacementConfig.belowNoise, oldPlacementConfig.aboveNoise);
+			}
+			else
+			{
+//				ClientProxy.LOGGER.debug("unkown decorated placement config: \"" + config.decorator.config().getClass() + "\"");
+				return config;
+			}
+
+
+			ConfiguredPlacement<?> newPlacement = new ConfiguredPlacement(config.decorator.decorator, placementConfig);
+			return new DecoratedFeatureConfig(config.feature, newPlacement);
+		}
+
+
+		@SuppressWarnings("unused")
+		private BlockClusterFeatureConfig cloneBlockClusterFeatureConfig(BlockClusterFeatureConfig config)
+		{
+			WeightedBlockStateProvider provider = new WeightedBlockStateProvider();
+			provider.weightedList.entries.addAll(((WeightedBlockStateProvider) config.stateProvider).weightedList.entries);
+
+			HashSet<Block> whitelist = new HashSet<>(config.whitelist);
+
+			HashSet<BlockState> blacklist = new HashSet<>(config.blacklist);
+
+
+			BlockClusterFeatureConfig.Builder builder = new BlockClusterFeatureConfig.Builder(provider, config.blockPlacer);
+			builder.whitelist(whitelist);
+			builder.blacklist(blacklist);
+			builder.xspread(config.xspread);
+			builder.yspread(config.yspread);
+			builder.zspread(config.zspread);
+			if(config.canReplace) { builder.canReplace(); }
+			if(config.needWater) { builder.needWater(); }
+			if(config.project) { builder.noProjection(); }
+			builder.tries(config.tries);
+
+
+			return builder.build();
+		}
+
+	}
+
+
+	/**
+	 * Stops the current genThreads if they are running
+	 * and then recreates the Executer service. <br><br>
+	 *
+	 * This is done to clear any outstanding tasks
+	 * that may exist after the player leaves their current world.
+	 * If this isn't done unfinished tasks may be left in the queue
+	 * preventing new LodChunks form being generated.
+	 */
+	public static void restartExecuterService()
+	{
+		if (genThreads != null && !genThreads.isShutdown())
+		{
+			genThreads.shutdownNow();
+		}
+		genThreads = Executors.newFixedThreadPool(LodConfig.CLIENT.threading.numberOfWorldGenerationThreads.get(), new LodThreadFactory(LodNodeGenWorker.class.getSimpleName()));
+	}
+
+
+
+
+
+    /*
+     * performance/generation tests related to
+     * serverWorld.getChunk(x, z, ChunkStatus. *** )
+
+     true/false is whether they generated blocks or not
+     the time is how long it took to generate
+
+     ChunkStatus.EMPTY					0  - 1  ms	false	(empty, what did you expect? :P)
+     ChunkStatus.STRUCTURE_REFERENCES	1  - 2  ms  false	(no height, only generates some chunks)
+     ChunkStatus.BIOMES 				1  - 10 ms	false	(no height)
+     ChunkStatus.NOISE					4  - 15 ms	true	(all blocks are stone)
+     ChunkStatus.LIQUID_CARVERS			6  - 12 ms	true	(no snow/trees, just grass)
+     ChunkStatus.SURFACE				5  - 15 ms	true	(no snow/trees, just grass)
+     ChunkStatus.CARVERS				5  - 30 ms	true	(no snow/trees, just grass)
+     ChunkStatus.FEATURES				7  - 25 ms	true
+     ChunkStatus.HEIGHTMAPS 			20 - 40 ms	true
+     ChunkStatus.LIGHT					20 - 40 ms	true
+     ChunkStatus.FULL 					30 - 50 ms	true
+     ChunkStatus.SPAWN			   		50 - 80 ms	true
+
+
+     At this point I would suggest using FEATURES, as it generates snow and trees
+     (and any other object that is needed to make biomes distinct)
+
+     Otherwise if snow/trees aren't necessary SURFACE is the next fastest (although not by much)
+     */
+}

src/main/java/com/seibel/lod/builders/worldGeneration/LodServerWorld.java

@@ -0,0 +1,330 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.builders.worldGeneration;
+
+import java.util.HashMap;
+import java.util.List;
+import java.util.Random;
+import java.util.function.Predicate;
+import java.util.stream.Stream;
+
+import com.seibel.lod.util.LodUtil;
+
+import net.minecraft.block.Block;
+import net.minecraft.block.BlockState;
+import net.minecraft.entity.Entity;
+import net.minecraft.entity.player.PlayerEntity;
+import net.minecraft.fluid.Fluid;
+import net.minecraft.fluid.FluidState;
+import net.minecraft.particles.IParticleData;
+import net.minecraft.tileentity.TileEntity;
+import net.minecraft.util.Direction;
+import net.minecraft.util.SoundCategory;
+import net.minecraft.util.SoundEvent;
+import net.minecraft.util.math.AxisAlignedBB;
+import net.minecraft.util.math.BlockPos;
+import net.minecraft.util.math.SectionPos;
+import net.minecraft.util.registry.DynamicRegistries;
+import net.minecraft.world.DifficultyInstance;
+import net.minecraft.world.DimensionType;
+import net.minecraft.world.EmptyTickList;
+import net.minecraft.world.ISeedReader;
+import net.minecraft.world.ITickList;
+import net.minecraft.world.biome.Biome;
+import net.minecraft.world.biome.BiomeManager;
+import net.minecraft.world.border.WorldBorder;
+import net.minecraft.world.chunk.AbstractChunkProvider;
+import net.minecraft.world.chunk.ChunkStatus;
+import net.minecraft.world.chunk.IChunk;
+import net.minecraft.world.gen.Heightmap;
+import net.minecraft.world.gen.Heightmap.Type;
+import net.minecraft.world.gen.feature.structure.Structure;
+import net.minecraft.world.gen.feature.structure.StructureStart;
+import net.minecraft.world.lighting.WorldLightManager;
+import net.minecraft.world.server.ServerWorld;
+import net.minecraft.world.storage.IWorldInfo;
+
+
+/**
+ * This is a fake ServerWorld used when generating features.
+ * This allows us to keep each LodChunk generation independent
+ * of the actual ServerWorld, allowing us
+ * to multithread generation.
+ *
+ * @author James Seibel
+ * @version 7-26-2021
+ */
+public class LodServerWorld implements ISeedReader
+{
+
+	public HashMap<Heightmap.Type, Heightmap> heightmaps = new HashMap<>();
+
+	public IChunk chunk;
+
+	public ServerWorld serverWorld;
+
+	public LodServerWorld(ServerWorld newServerWorld, IChunk newChunk)
+	{
+		chunk = newChunk;
+		serverWorld = newServerWorld;
+	}
+
+
+	@Override
+	public int getHeight(Type heightmapType, int x, int z)
+	{
+		// make sure the block position is set relative to the chunk
+		x = x % LodUtil.CHUNK_WIDTH;
+		x = (x < 0) ? x + 16 : x;
+
+		z = z % LodUtil.CHUNK_WIDTH;
+		z = (z < 0) ? z + 16 : z;
+
+		return chunk.getOrCreateHeightmapUnprimed(LodUtil.DEFAULT_HEIGHTMAP).getFirstAvailable(x, z);
+	}
+
+	@Override
+	public Biome getBiome(BlockPos pos)
+	{
+		return chunk.getBiomes().getNoiseBiome(pos.getX() >> 2, pos.getY() >> 2, pos.getZ() >> 2);
+	}
+
+	@Override
+	public boolean setBlock(BlockPos pos, BlockState state, int flags, int recursionLeft)
+	{
+		return chunk.setBlockState(pos, state, false) == state;
+	}
+
+	@Override
+	public BlockState getBlockState(BlockPos pos)
+	{
+		return chunk.getBlockState(pos);
+	}
+
+	@Override
+	public FluidState getFluidState(BlockPos pos)
+	{
+		return chunk.getFluidState(pos);
+	}
+
+
+	@Override
+	public boolean isStateAtPosition(BlockPos pos, Predicate<BlockState> state)
+	{
+		return state.test(chunk.getBlockState(pos));
+	}
+
+	@Override
+	public ITickList<Block> getBlockTicks()
+	{
+		return EmptyTickList.empty();
+	}
+
+	@Override
+	public IChunk getChunk(int x, int z, ChunkStatus requiredStatus, boolean nonnull)
+	{
+		return chunk;
+	}
+
+	@Override
+	public Stream<? extends StructureStart<?>> startsForFeature(SectionPos p_241827_1_, Structure<?> p_241827_2_)
+	{
+		return serverWorld.startsForFeature(p_241827_1_, p_241827_2_);
+	}
+
+	@Override
+	public ITickList<Fluid> getLiquidTicks()
+	{
+		return EmptyTickList.empty();
+	}
+
+	@Override
+	public WorldLightManager getLightEngine()
+	{
+		return new WorldLightManager(null, false, false);
+	}
+
+	@Override
+	public long getSeed()
+	{
+		return serverWorld.getSeed();
+	}
+
+	@Override
+	public DynamicRegistries registryAccess()
+	{
+		return serverWorld.registryAccess();
+	}
+
+
+	/**
+	 * All methods below shouldn't be needed
+	 * and thus have been left unimplemented.
+	 */
+
+
+	@Override
+	public Random getRandom()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+	@Override
+	public void playSound(PlayerEntity player, BlockPos pos, SoundEvent soundIn, SoundCategory category, float volume,
+	                      float pitch)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+	@Override
+	public void addParticle(IParticleData particleData, double x, double y, double z, double xSpeed, double ySpeed,
+	                        double zSpeed)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+	@Override
+	public BiomeManager getBiomeManager()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+	@Override
+	public int getSeaLevel()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+	@Override
+	public float getShade(Direction p_230487_1_, boolean p_230487_2_)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+	@Override
+	public WorldBorder getWorldBorder()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+	@Override
+	public boolean removeBlock(BlockPos pos, boolean isMoving)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+	@Override
+	public boolean destroyBlock(BlockPos pos, boolean dropBlock, Entity entity, int recursionLeft)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public ServerWorld getLevel()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public AbstractChunkProvider getChunkSource()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public DifficultyInstance getCurrentDifficultyAt(BlockPos arg0)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public IWorldInfo getLevelData()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public void levelEvent(PlayerEntity arg0, int arg1, BlockPos arg2, int arg3)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+
+	}
+
+
+	@Override
+	public List<Entity> getEntities(Entity arg0, AxisAlignedBB arg1, Predicate<? super Entity> arg2)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public <T extends Entity> List<T> getEntitiesOfClass(Class<? extends T> arg0, AxisAlignedBB arg1,
+	                                                     Predicate<? super T> arg2)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public List<? extends PlayerEntity> players()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public int getSkyDarken()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public Biome getUncachedNoiseBiome(int p_225604_1_, int p_225604_2_, int p_225604_3_)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public boolean isClientSide()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public DimensionType dimensionType()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public TileEntity getBlockEntity(BlockPos p_175625_1_)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+}

src/main/java/com/seibel/lod/builders/worldGeneration/LodWorldGenerator.java

@@ -0,0 +1,198 @@
+package com.seibel.lod.builders.worldGeneration;
+
+import java.util.HashSet;
+import java.util.Set;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+import java.util.concurrent.atomic.AtomicInteger;
+
+import com.seibel.lod.builders.LodBuilder;
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.util.LevelPosUtil;
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.objects.PosToGenerateContainer;
+import com.seibel.lod.render.LodRenderer;
+import com.seibel.lod.util.DetailDistanceUtil;
+import com.seibel.lod.util.LodThreadFactory;
+import com.seibel.lod.util.LodUtil;
+import com.seibel.lod.wrappers.MinecraftWrapper;
+
+import net.minecraft.util.math.ChunkPos;
+import net.minecraft.world.server.ServerWorld;
+import net.minecraftforge.common.WorldWorkerManager;
+
+/**
+ * A singleton that handles all long distance LOD world generation.
+ *
+ * @author James Seibel
+ * @version 8-24-2021
+ */
+public class LodWorldGenerator
+{
+	public MinecraftWrapper mc = MinecraftWrapper.INSTANCE;
+
+	/**
+	 * This holds the thread used to generate new LODs off the main thread.
+	 */
+	private ExecutorService mainGenThread = Executors.newSingleThreadExecutor(new LodThreadFactory(this.getClass().getSimpleName() + " world generator"));
+
+	/**
+	 * we only want to queue up one generator thread at a time
+	 */
+	private boolean generatorThreadRunning = false;
+
+	/**
+	 * how many chunks to generate outside of the player's view distance at one
+	 * time. (or more specifically how many requests to make at one time). I
+	 * multiply by 8 to make sure there is always a buffer of chunk requests, to
+	 * make sure the CPU is always busy and we can generate LODs as quickly as
+	 * possible.
+	 */
+	public int maxChunkGenRequests;
+
+	/**
+	 * This keeps track of how many chunk generation requests are on going. This is
+	 * to limit how many chunks are queued at once. To prevent chunks from being
+	 * generated for a long time in an area the player is no longer in.
+	 */
+	public AtomicInteger numberOfChunksWaitingToGenerate = new AtomicInteger(0);
+
+	public Set<ChunkPos> positionWaitingToBeGenerated = new HashSet<>();
+
+	/**
+	 * Singleton copy of this object
+	 */
+	public static final LodWorldGenerator INSTANCE = new LodWorldGenerator();
+
+
+	private LodWorldGenerator()
+	{
+
+	}
+
+	/**
+	 * Queues up LodNodeGenWorkers for the given lodDimension.
+	 *
+	 * @param renderer needed so the LodNodeGenWorkers can flag that the
+	 *                 buffers need to be rebuilt.
+	 */
+	public void queueGenerationRequests(LodDimension lodDim, LodRenderer renderer, LodBuilder lodBuilder)
+	{
+		if (LodConfig.CLIENT.worldGenerator.distanceGenerationMode.get() != DistanceGenerationMode.NONE
+				    && !generatorThreadRunning
+				    && mc.hasSingleplayerServer())
+		{
+			// the thread is now running, don't queue up another thread
+			generatorThreadRunning = true;
+
+			// just in case the config changed
+			maxChunkGenRequests = LodConfig.CLIENT.threading.numberOfWorldGenerationThreads.get() * 8;
+
+			Thread generatorThread = new Thread(() ->
+			{
+				try
+				{
+					// round the player's block position down to the nearest chunk BlockPos
+					int playerPosX = mc.getPlayer().blockPosition().getX();
+					int playerPosZ = mc.getPlayer().blockPosition().getZ();
+
+					// if we don't have a full number of chunks to generate in chunksToGen
+					// we can top it off from this reserve
+
+
+					//=======================================//
+					// create the generation Request objects //
+					//=======================================//
+
+					ServerWorld serverWorld = LodUtil.getServerWorldFromDimension(lodDim.dimension);
+
+					PosToGenerateContainer posToGenerate = lodDim.getDataToGenerate(
+							maxChunkGenRequests,
+							playerPosX,
+							playerPosZ);
+					//System.out.println(posToGenerate);
+					//here we prepare two sorted set
+					//the first contains the near pos to render
+					//the second contain the far pos to render
+					byte detailLevel;
+					int posX;
+					int posZ;
+					boolean nearOrFar = true;
+					boolean stopSwitch = false;
+					int near = 0;
+					int far = 0;
+
+					for (int index = 0; index < posToGenerate.getNumberOfPos(); index++)
+					{
+						if (posToGenerate.getNthDetail(near, true) != 0 && near < posToGenerate.getNumberOfNearPos())
+						{
+							detailLevel = (byte) (posToGenerate.getNthDetail(near, true) - 1);
+							posX = posToGenerate.getNthPosX(near, true);
+							posZ = posToGenerate.getNthPosZ(near, true);
+							near++;
+							ChunkPos chunkPos = new ChunkPos(LevelPosUtil.getChunkPos(detailLevel, posX), LevelPosUtil.getChunkPos(detailLevel, posZ));
+							if (numberOfChunksWaitingToGenerate.get() < maxChunkGenRequests)
+							{
+								// prevent generating the same chunk multiple times
+								if (positionWaitingToBeGenerated.contains(chunkPos))
+								{
+									continue;
+								}
+							}
+
+							// don't add null chunkPos (which shouldn't happen anyway)
+							// or add more to the generation queue
+							if (chunkPos == null || numberOfChunksWaitingToGenerate.get() >= maxChunkGenRequests)
+								continue;
+
+							positionWaitingToBeGenerated.add(chunkPos);
+							numberOfChunksWaitingToGenerate.addAndGet(1);
+							LodNodeGenWorker genWorker = new LodNodeGenWorker(chunkPos, DetailDistanceUtil.getDistanceGenerationMode(detailLevel), lodBuilder, lodDim, serverWorld);
+							WorldWorkerManager.addWorker(genWorker);
+						}
+
+
+						if (posToGenerate.getNthDetail(far, false) != 0 && far < posToGenerate.getNumberOfFarPos())
+						{
+							detailLevel = (byte) (posToGenerate.getNthDetail(far, false) - 1);
+							posX = posToGenerate.getNthPosX(far, false);
+							posZ = posToGenerate.getNthPosZ(far, false);
+							far++;
+							ChunkPos chunkPos = new ChunkPos(LevelPosUtil.getChunkPos(detailLevel, posX), LevelPosUtil.getChunkPos(detailLevel, posZ));
+							if (numberOfChunksWaitingToGenerate.get() < maxChunkGenRequests)
+							{
+								// prevent generating the same chunk multiple times
+								if (positionWaitingToBeGenerated.contains(chunkPos))
+								{
+									continue;
+								}
+							}
+
+							// don't add null chunkPos (which shouldn't happen anyway)
+							// or add more to the generation queue
+							if (chunkPos == null || numberOfChunksWaitingToGenerate.get() >= maxChunkGenRequests)
+								continue;
+
+							positionWaitingToBeGenerated.add(chunkPos);
+							numberOfChunksWaitingToGenerate.addAndGet(1);
+							LodNodeGenWorker genWorker = new LodNodeGenWorker(chunkPos, DetailDistanceUtil.getDistanceGenerationMode(detailLevel), lodBuilder, lodDim, serverWorld);
+							WorldWorkerManager.addWorker(genWorker);
+						}
+					}
+
+				} catch (Exception e)
+				{
+					// this shouldn't ever happen, but just in case
+					e.printStackTrace();
+				} finally
+				{
+					generatorThreadRunning = false;
+				}
+			});
+
+			mainGenThread.execute(generatorThread);
+		} // if distanceGenerationMode != DistanceGenerationMode.NONE && !generatorThreadRunning
+	}
+
+}

src/main/java/com/seibel/lod/config/LodConfig.java

@@ -0,0 +1,458 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.config;
+
+import java.nio.file.Path;
+import java.nio.file.Paths;
+
+import org.apache.commons.lang3.tuple.Pair;
+import org.apache.logging.log4j.LogManager;
+
+import com.electronwill.nightconfig.core.file.CommentedFileConfig;
+import com.electronwill.nightconfig.core.io.WritingMode;
+import com.seibel.lod.ModInfo;
+import com.seibel.lod.enums.DebugMode;
+import com.seibel.lod.enums.DetailDropOff;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.enums.DistanceQualityDropOff;
+import com.seibel.lod.enums.FogDistance;
+import com.seibel.lod.enums.FogDrawOverride;
+import com.seibel.lod.enums.GenerationPriority;
+import com.seibel.lod.enums.HorizontalQuality;
+import com.seibel.lod.enums.HorizontalResolution;
+import com.seibel.lod.enums.LodTemplate;
+import com.seibel.lod.enums.VerticalQuality;
+
+import net.minecraftforge.common.ForgeConfigSpec;
+import net.minecraftforge.eventbus.api.SubscribeEvent;
+import net.minecraftforge.fml.common.Mod;
+import net.minecraftforge.fml.config.ModConfig;
+
+/**
+ * This handles any configuration the user has access to.
+ *
+ * @author James Seibel
+ * @version 9-24-2021
+ */
+@Mod.EventBusSubscriber
+public class LodConfig
+{
+	public static class Client
+	{
+		public final Graphics graphics;
+		public final WorldGenerator worldGenerator;
+		public final Threading threading;
+		public final Debugging debugging;
+		public final Buffers buffers;
+		
+		public Client(ForgeConfigSpec.Builder builder)
+		{
+			builder.push("client");
+			{
+				graphics = new Graphics(builder);
+				worldGenerator = new WorldGenerator(builder);
+				threading = new Threading(builder);
+				debugging = new Debugging(builder);
+				buffers = new Buffers(builder);
+			}
+			builder.pop();
+		}
+	}
+	
+	//================//
+	// Client Configs //
+	//================//
+	
+	public static class Graphics
+	{
+		public ForgeConfigSpec.EnumValue<FogDistance> fogDistance;
+		public ForgeConfigSpec.EnumValue<FogDrawOverride> fogDrawOverride;
+		
+		public ForgeConfigSpec.EnumValue<LodTemplate> lodTemplate;
+		
+		public ForgeConfigSpec.EnumValue<HorizontalResolution> drawResolution;
+		
+//		public ForgeConfigSpec.EnumValue<ShadingMode> shadingMode;
+		
+		public ForgeConfigSpec.EnumValue<HorizontalQuality> horizontalQuality;
+		
+		public ForgeConfigSpec.EnumValue<DetailDropOff> detailDropOff;
+		
+		public ForgeConfigSpec.IntValue lodChunkRenderDistance;
+		
+		public ForgeConfigSpec.BooleanValue disableDirectionalCulling;
+		
+		public ForgeConfigSpec.BooleanValue alwaysDrawAtMaxQuality;
+		
+		
+		Graphics(ForgeConfigSpec.Builder builder)
+		{
+			builder.comment("These settings control how the LODs look.").push(this.getClass().getSimpleName());
+			
+			fogDistance = builder
+					.comment("\n\n"
+							+ " At what distance should Fog be drawn on the LODs? \n"
+							+ " If the fog cuts off ubruptly or you are using Optifine's \"fast\" fog option \n"
+							+ " set this to " + FogDistance.NEAR + " or " + FogDistance.FAR + ". \n")
+					.defineEnum("fogDistance", FogDistance.NEAR_AND_FAR);
+			
+			fogDrawOverride = builder
+					.comment("\n\n"
+							+ " When should fog be drawn? \n"
+							+ " " + FogDrawOverride.USE_OPTIFINE_FOG_SETTING + ": Use whatever Fog setting Optifine is using. If Optifine isn't installed this defaults to " + FogDrawOverride.ALWAYS_DRAW_FOG_FANCY + ". \n"
+							+ " " + FogDrawOverride.NEVER_DRAW_FOG + ": Never draw fog on the LODs \n"
+							+ " " + FogDrawOverride.ALWAYS_DRAW_FOG_FAST + ": Always draw fast fog on the LODs \n"
+							+ " " + FogDrawOverride.ALWAYS_DRAW_FOG_FANCY + ": Always draw fancy fog on the LODs (if your graphics card supports it) \n")
+					.defineEnum("fogDrawOverride", FogDrawOverride.ALWAYS_DRAW_FOG_FANCY);
+			
+			lodTemplate = builder
+					.comment("\n\n"
+							+ " How should the LODs be drawn? \n"
+							+ " NOTE: Currently only " + LodTemplate.CUBIC + " is implemented! \n"
+							+ " \n"
+							+ " " + LodTemplate.CUBIC + ": LOD Chunks are drawn as rectangular prisms (boxes). \n"
+							+ " " + LodTemplate.TRIANGULAR + ": LOD Chunks smoothly transition between other. \n"
+							+ " " + LodTemplate.DYNAMIC + ": LOD Chunks smoothly transition between other, \n"
+							+ " " + "         unless a neighboring chunk is at a significantly different height. \n")
+					.defineEnum("lodTemplate", LodTemplate.CUBIC);
+			
+			detailDropOff = builder
+					.comment("\n\n"
+							+ " How smooth should the detail transition for LODs be? \n"
+							+ DetailDropOff.BY_CHUNK + ": quality is determined per-chunk (best quality option, may cause stuttering when moving)\n"
+							+ DetailDropOff.BY_REGION_FANCY + ": quality is determiend per-region (quality option)\n"
+							+ DetailDropOff.BY_REGION_FAST + ": quality is determiend per-region (performance option)\n")
+					.defineEnum("detailDropOff", DetailDropOff.BY_CHUNK);
+			
+			drawResolution = builder
+					.comment("\n\n"
+							+ " What is the maximum detail level that LODs should be drawn at? \n"
+							+ " " + HorizontalResolution.CHUNK + ": render 1 LOD for each Chunk. \n"
+							+ " " + HorizontalResolution.HALF_CHUNK + ": render 4 LODs for each Chunk. \n"
+							+ " " + HorizontalResolution.FOUR_BLOCKS + ": render 16 LODs for each Chunk. \n"
+							+ " " + HorizontalResolution.TWO_BLOCKS + ": render 64 LODs for each Chunk. \n"
+							+ " " + HorizontalResolution.BLOCK + ": render 256 LODs for each Chunk. \n")
+					.defineEnum("Draw resolution", HorizontalResolution.BLOCK);
+			
+			horizontalQuality = builder
+					.comment("\n\n"
+							+ " This indicates how quickly LODs drop off in quality. \n"
+							+ " " + HorizontalQuality.LOW + ": quality drops every 4 chunks. \n"
+							+ " " + HorizontalQuality.MEDIUM + ": quality drops every 8 chunks. \n"
+							+ " " + HorizontalQuality.HIGH + ": quality drops every 16 chunks. \n")
+					.defineEnum("lodDrawQuality", HorizontalQuality.MEDIUM);
+			
+			lodChunkRenderDistance = builder
+					.comment("\n\n"
+							+ " The mod's render distance, measured in chunks. \n")
+					.defineInRange("lodChunkRenderDistance", 64, 32, 1024);
+			
+			disableDirectionalCulling = builder
+					.comment("\n\n"
+							+ " If false LODs that are behind the player's camera \n"
+							+ " aren't drawn, increasing performance. \n\n"
+							+ ""
+							+ " If true all LODs are drawn, even those behind \n"
+							+ " the player's camera, decreasing performance. \n\n"
+							+ ""
+							+ " Disable this if you see LODs disapearing. \n"
+							+ " (This may happen if you are using a camera mod) \n")
+					.define("disableDirectionalCulling", false);
+			
+//			shadingMode = builder
+//					.comment("\n\n"
+//							+ " What kind of shading should the LODs have? \n"
+//							+ " \n"
+//							+ " " + ShadingMode.NONE + " \n"
+//							+ " " + "LODs will have the same lighting on every side. \n"
+//							+ " " + "Can make large similarly colored areas hard to differentiate. \n"
+//							+ "\n"
+//							+ " " + ShadingMode.GAME_SHADING + " \n"
+//							+ " " + "LODs will have darker sides and bottoms to simulate Minecraft's flat lighting.")
+//					.defineEnum("lightingMode", ShadingMode.GAME_SHADING);
+			
+			alwaysDrawAtMaxQuality = builder
+					.comment("\n\n"
+							+ " Disable LOD quality falloff, "
+							+ " all LODs will be drawn at the highest "
+							+ " available detail level. "
+							+ " "
+							+ " WARNING "
+							+ " This could cause a Out Of Memory crash on render "
+							+ " distances higher than 128 \n")
+					.define("alwaysDrawAtMaxQuality", false);
+			
+			builder.pop();
+		}
+	}
+	
+	public static class WorldGenerator
+	{
+		public ForgeConfigSpec.EnumValue<VerticalQuality> lodQualityMode;
+		public ForgeConfigSpec.EnumValue<HorizontalResolution> generationResolution;
+		public ForgeConfigSpec.EnumValue<DistanceGenerationMode> distanceGenerationMode;
+		public ForgeConfigSpec.EnumValue<GenerationPriority> generationPriority;
+		public ForgeConfigSpec.BooleanValue allowUnstableFeatureGeneration;
+		public ForgeConfigSpec.EnumValue<DistanceQualityDropOff> lodDistanceCalculatorType;
+		
+		WorldGenerator(ForgeConfigSpec.Builder builder)
+		{
+			builder.comment("These settings control how LODs outside your normal view range are generated.").push(this.getClass().getSimpleName());
+			
+			lodQualityMode = builder
+					.comment("\n\n"
+							+ " Use 3d lods or 2d lods? \n"
+							+ " " + VerticalQuality.HEIGHTMAP + ": LODs are solid from the lowest world point to the highest. Not good for floating islands or caves. Faster \n"
+							+ " " + VerticalQuality.MULTI_LOD + ": LODs have gaps between vertical blocks. Good for floating islands and caves. Slower \n")
+					.defineEnum("lodQualityMode", VerticalQuality.HEIGHTMAP);
+			
+			generationResolution = builder
+					.comment("\n\n"
+							+ " What is the maximum detail level that LODs should be generated at? \n"
+							+ " " + HorizontalResolution.CHUNK + ": render 1 LOD for each Chunk. \n"
+							+ " " + HorizontalResolution.HALF_CHUNK + ": render 4 LODs for each Chunk. \n"
+							+ " " + HorizontalResolution.FOUR_BLOCKS + ": render 16 LODs for each Chunk. \n"
+							+ " " + HorizontalResolution.TWO_BLOCKS + ": render 64 LODs for each Chunk. \n"
+							+ " " + HorizontalResolution.BLOCK + ": render 256 LODs for each Chunk. \n")
+					.defineEnum("Generation Resolution", HorizontalResolution.BLOCK);
+			
+			lodDistanceCalculatorType = builder
+					.comment("\n\n"
+							+ " " + DistanceQualityDropOff.LINEAR + " \n"
+							+ " with LINEAR calculator the quality of block decrease \n"
+							+ " linearly to the distance of the player \n"
+							
+							                                     + "\n"
+							                                     + " " + DistanceQualityDropOff.QUADRATIC + " \n"
+							                                     + " with QUADRATIC calculator the quality of block decrease \n"
+							                                     + " quadratically to the distance of the player \n")
+					.defineEnum("lodDistanceComputation", DistanceQualityDropOff.LINEAR);
+			
+			generationPriority = builder
+					.comment("\n\n"
+							+ " " + GenerationPriority.FAR_FIRST + " \n"
+							+ " LODs are generated from low to high detail\n"
+							+ " with a small priority for far regions. \n"
+							+ " This fills in the world fastest. \n"
+							
+							                              + "\n"
+							                              + " " + GenerationPriority.NEAR_FIRST + " \n"
+							                              + " LODs are generated around the player \n"
+							                              + " in a spiral, similar to vanilla minecraft. \n")
+					.defineEnum("Generation priority", GenerationPriority.NEAR_FIRST);
+			
+			distanceGenerationMode = builder
+					.comment("\n\n"
+							+ " Note: The times listed here are the amount of time it took \n"
+							+ "       one of the developer's PC to generate 1 chunk, \n"
+							+ "       and are included so you can compare the \n"
+							+ "       different generation options. Your mileage may vary. \n"
+							+ "\n"
+							
+							+ " " + DistanceGenerationMode.NONE + " \n"
+							+ " Don't run the distance generator. \n"
+							
+							+ " " + DistanceGenerationMode.BIOME_ONLY + " \n"
+							+ " Only generate the biomes and use the biome's \n"
+							+ " grass color, water color, or snow color. \n"
+							+ " Doesn't generate height, everything is shown at sea level. \n"
+							+ " Multithreaded - Fastest (2-5 ms) \n"
+							
+							+ "\n"
+							+ " " + DistanceGenerationMode.BIOME_ONLY_SIMULATE_HEIGHT + " \n"
+							+ " Same as BIOME_ONLY, except instead \n"
+							+ " of always using sea level as the LOD height \n"
+							+ " different biome types (mountain, ocean, forest, etc.) \n"
+							+ " use predetermined heights to simulate having height data. \n"
+							+ " Multithreaded - Fastest (2-5 ms) \n"
+							
+							+ "\n"
+							+ " " + DistanceGenerationMode.SURFACE + " \n"
+							+ " Generate the world surface, \n"
+							+ " this does NOT include caves, trees, \n"
+							+ " or structures. \n"
+							+ " Multithreaded - Faster (10-20 ms) \n"
+							
+							+ "\n"
+							+ " " + DistanceGenerationMode.FEATURES + " \n"
+							+ " Generate everything except structures. \n"
+							+ " WARNING: This may cause world generation bugs or instability! \n"
+							+ " Multithreaded - Fast (15-20 ms) \n"
+							
+							+ "\n"
+							+ " " + DistanceGenerationMode.SERVER + " \n"
+							+ " Ask the server to generate/load each chunk. \n"
+							+ " This is the most compatible, but causes server/simulation lag. \n"
+							+ " This will show player made structures, which can \n"
+							+ " be useful if you are adding the mod to a pre-existing world. \n"
+							+ " Singlethreaded - Slow (15-50 ms, with spikes up to 200 ms) \n")
+					.defineEnum("distanceGenerationMode", DistanceGenerationMode.SURFACE);
+			
+			allowUnstableFeatureGeneration = builder
+					.comment("\n\n"
+							+ " When using the " + DistanceGenerationMode.FEATURES + " generation mode \n"
+							+ " some features may not be thread safe, which could \n"
+							+ " cause instability and crashes. \n"
+							+ " By default (false) those features are skipped, \n"
+							+ " improving stability, but decreasing how many features are \n"
+							+ " actually generated. \n"
+							+ " (for example: some tree generation is unstable, \n"
+							+ "               so some trees may not be generated.) \n"
+							+ " By setting this to true, all features will be generated, \n"
+							+ " but your game will be more unstable and crashes may occur. \n"
+							+ " \n"
+							+ " I would love to remove this option and always generate everything, \n"
+							+ " but I'm not sure how to do that. \n"
+							+ " If you are a Java wizard, check out the git issue here: \n"
+							+ " https://gitlab.com/jeseibel/minecraft-lod-mod/-/issues/35 \n")
+					.define("allowUnstableFeatureGeneration", false);
+			
+			builder.pop();
+		}
+	}
+	
+	public static class Threading
+	{
+		public ForgeConfigSpec.IntValue numberOfWorldGenerationThreads;
+		public ForgeConfigSpec.IntValue numberOfBufferBuilderThreads;
+		
+		Threading(ForgeConfigSpec.Builder builder)
+		{
+			builder.comment("These settings control how many CPU threads the mod uses for different tasks.").push(this.getClass().getSimpleName());
+			
+			numberOfWorldGenerationThreads = builder
+					.comment("\n\n"
+							+ " This is how many threads are used when generating LODs outside \n"
+							+ " the normal render distance. \n"
+							+ " If you experience stuttering when generating distant LODs, decrease \n"
+							+ " this number. If you want to increase LOD generation speed, \n"
+							+ " increase this number. \n"
+							+ " \n"
+							+ " The maximum value is the number of logical processors on your CPU. \n"
+							+ " Requires a restart to take effect. \n")
+					.defineInRange("numberOfWorldGenerationThreads", Runtime.getRuntime().availableProcessors() / 2, 1, Runtime.getRuntime().availableProcessors());
+			
+			numberOfBufferBuilderThreads = builder
+					.comment("\n\n"
+							+ " This is how many threads are used when building vertex buffers \n"
+							+ " (The things sent to your GPU to draw the LODs). \n"
+							+ " If you experience high CPU useage when NOT generating distant \n"
+							+ " LODs, lower this number. \n"
+							+ " \n"
+							+ " The maximum value is the number of logical processors on your CPU. \n"
+							+ " Requires a restart to take effect. \n")
+					.defineInRange("numberOfBufferBuilderThreads", Runtime.getRuntime().availableProcessors(), 1, Runtime.getRuntime().availableProcessors());
+			
+			builder.pop();
+		}
+	}
+	
+	public static class Debugging
+	{
+		public ForgeConfigSpec.EnumValue<DebugMode> debugMode;
+		public ForgeConfigSpec.BooleanValue enableDebugKeybindings;
+		
+		Debugging(ForgeConfigSpec.Builder builder)
+		{
+			builder.comment("These settings can be used to look for bugs, or see how certain aspects of the mod work.").push(this.getClass().getSimpleName());
+			
+			debugMode = builder
+					.comment("\n\n"
+							+ " " + DebugMode.OFF + ": LODs will draw with their normal colors. \n"
+							+ " " + DebugMode.SHOW_DETAIL + ": LOD colors will be based on their detail level. \n"
+							+ " " + DebugMode.SHOW_DETAIL_WIREFRAME + ": LOD colors will be based on their detail level, drawn as a wireframe. \n")
+					.defineEnum("debugMode", DebugMode.OFF);
+			
+			enableDebugKeybindings = builder
+					.comment("\n\n"
+							+ " If true the F4 key can be used to cycle through the different debug modes. \n"
+							+ " and the F6 key can be used to enable and disable LOD rendering.")
+					.define("enableDebugKeybinding", false);
+			
+			builder.pop();
+		}
+	}
+	
+	public static class Buffers
+	{
+		public ForgeConfigSpec.IntValue bufferRebuildPlayerMoveTimeout;
+		public ForgeConfigSpec.IntValue bufferRebuildChunkChangeTimeout;
+		public ForgeConfigSpec.IntValue bufferRebuildLodChangeTimeout;
+		
+		Buffers(ForgeConfigSpec.Builder builder)
+		{
+			builder.comment("These settings affect when Vertex Buffers are built.").push(this.getClass().getSimpleName());
+			
+			bufferRebuildPlayerMoveTimeout = builder
+					.comment("\n\n"
+							+ " How long in milliseconds should we wait to \n"
+							+ " rebuild the vertex buffers when the player moves \n"
+							+ " a chunk or more? \n")
+					.defineInRange("bufferRebuildPlayerMoveTimeout", 2000, 1, 60000);
+			
+			bufferRebuildChunkChangeTimeout = builder
+					.comment("\n\n"
+							+ " How long in milliseconds should we wait to \n"
+							+ " rebuild the vertex buffers when the vanilla rendered \n"
+							+ " chunks change? \n")
+					.defineInRange("bufferRebuildChunkChangeTimeout", 1000, 1, 60000);
+			
+			bufferRebuildLodChangeTimeout = builder
+					.comment("\n\n"
+							+ " How long in milliseconds should we wait to \n"
+							+ " rebuild the vertex buffers when the LOD regions change? \n")
+					.defineInRange("bufferRebuildLodChangeTimeout", 5000, 1, 60000);
+			
+			builder.pop();
+		}
+	}
+	
+	/**
+	 * {@link Path} to the configuration file of this mod
+	 */
+	private static final Path CONFIG_PATH = Paths.get("config", ModInfo.MODID + ".toml");
+	
+	public static final ForgeConfigSpec CLIENT_SPEC;
+	public static final Client CLIENT;
+	
+	static
+	{
+		final Pair<Client, ForgeConfigSpec> specPair = new ForgeConfigSpec.Builder().configure(Client::new);
+		CLIENT_SPEC = specPair.getRight();
+		CLIENT = specPair.getLeft();
+		CommentedFileConfig clientConfig = CommentedFileConfig.builder(CONFIG_PATH)
+				.writingMode(WritingMode.REPLACE)
+				.build();
+		clientConfig.load();
+		clientConfig.save();
+		CLIENT_SPEC.setConfig(clientConfig);
+	}
+	
+	@SubscribeEvent
+	public static void onLoad(final ModConfig.Loading configEvent)
+	{
+		LogManager.getLogger().debug(ModInfo.MODNAME, "Loaded forge config file {}", configEvent.getConfig().getFileName());
+	}
+	
+	@SubscribeEvent
+	public static void onFileChange(final ModConfig.Reloading configEvent)
+	{
+		LogManager.getLogger().debug(ModInfo.MODNAME, "Forge config just got changed on the file system!");
+	}
+	
+}

src/main/java/com/seibel/lod/enums/ColorDirection.java

@@ -1,34 +0,0 @@
-package com.seibel.lod.enums;
-
-/**
- * TOP, NORTH, SOUTH, EAST, WEST, BOTTOM
- * 
- * @author James Seibel
- * @version 10-17-2020
- */
-public enum ColorDirection
-{
-	// used for colors
-	/** +Y */
-	TOP(0),
-	
-	/** -Z */
-	NORTH(1),
-	/** +Z */
-	SOUTH(2),
-	
-	/** +X */
-	EAST(3),
-	/** -X */
-	WEST(4),
-	
-	/** -Y */
-	BOTTOM(5);
-	
-	public final int value;
-	
-	private ColorDirection(int newValue)
-	{
-		value = newValue;
-	}
-}

src/main/java/com/seibel/lod/enums/DebugMode.java

@@ -0,0 +1,50 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+/**
+ * off, detail, detail wireframe
+ * 
+ * @author James Seibel
+ * @version 8-28-2021
+ */
+public enum DebugMode
+{
+	OFF,
+	
+	/** LOD colors are based on their detail */
+	SHOW_DETAIL,
+	
+	/** LOD colors are based on their detail, and draws in wireframe. */
+	SHOW_DETAIL_WIREFRAME;
+	
+	/** used when cycling through the different modes */
+	private DebugMode next;
+	static 
+	{
+		OFF.next = SHOW_DETAIL;
+		SHOW_DETAIL.next = SHOW_DETAIL_WIREFRAME;
+		SHOW_DETAIL_WIREFRAME.next = OFF;
+	}
+	
+	/** returns the next debug mode */
+	public DebugMode getNext()
+	{
+		return this.next;
+	}
+}

src/main/java/com/seibel/lod/enums/DetailDropOff.java

@@ -0,0 +1,28 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+/**
+ *
+ */
+public enum DetailDropOff
+{
+	BY_REGION_FAST,
+	BY_REGION_FANCY,
+	BY_CHUNK,
+}

src/main/java/com/seibel/lod/enums/DistanceGenerationMode.java

@@ -0,0 +1,93 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+/**
+ * NONE <br>
+ * BIOME_ONLY <br>
+ * BIOME_ONLY_SIMULATE_HEIGHT <br>
+ * SURFACE <br>
+ * FEATURES <br>
+ * SERVER <br><br>
+ * <p>
+ * In order of fastest to slowest.
+ *
+ * @author James Seibel
+ * @author Leonardo Amato
+ * @version 8-7-2021
+ */
+public enum DistanceGenerationMode
+{
+	/**
+	 * Don't generate anything
+	 */
+	NONE((byte) 0),
+
+	/**
+	 * Only generate the biomes and use biome
+	 * grass/foliage color, water color, or ice color
+	 * to generate the color.
+	 * Doesn't generate height, everything is shown at sea level.
+	 * Multithreaded - Fastest (2-5 ms)
+	 */
+	BIOME_ONLY((byte) 1),
+
+	/**
+	 * Same as BIOME_ONLY, except instead
+	 * of always using sea level as the LOD height
+	 * different biome types (mountain, ocean, forest, etc.)
+	 * use predetermined heights to simulate having height data.
+	 */
+	BIOME_ONLY_SIMULATE_HEIGHT((byte) 2),
+
+	/**
+	 * Generate the world surface,
+	 * this does NOT include caves, trees,
+	 * or structures.
+	 * Multithreaded - Faster (10-20 ms)
+	 */
+	SURFACE((byte) 3),
+
+	/**
+	 * Generate everything except structures.
+	 * NOTE: This may cause world generation bugs or instability,
+	 * since some features cause concurrentModification exceptions.
+	 * Multithreaded - Fast (15-20 ms)
+	 */
+	FEATURES((byte) 4),
+
+	/**
+	 * Ask the server to generate/load each chunk.
+	 * This is the most compatible, but causes server/simulation lag.
+	 * This will also show player made structures if you
+	 * are adding the mod to a pre-existing world.
+	 * Singlethreaded - Slow (15-50 ms, with spikes up to 200 ms)
+	 */
+	SERVER((byte) 5);
+
+
+	/**
+	 * The higher the number the more complete the generation is.
+	 */
+	public final byte complexity;
+
+	DistanceGenerationMode(byte complexity)
+	{
+		this.complexity = complexity;
+	}
+}

src/main/java/com/seibel/lod/enums/DistanceQualityDropOff.java

@@ -0,0 +1,18 @@
+package com.seibel.lod.enums;
+
+/**
+ * @author Leonardo Amato
+ * @version 22-08-2021
+ */
+public enum DistanceQualityDropOff
+{
+	/**
+	 * different Lod detail render and generate linearly to the distance
+	 */
+	LINEAR,
+
+	/**
+	 * different Lod detail render and generate quadratically to the distance
+	 */
+	QUADRATIC,
+}

src/main/java/com/seibel/lod/enums/FogDistance.java

@@ -1,7 +1,24 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.seibel.lod.enums;
 
 /**
- * Near, far, or NEAR_AND_FAR.
+ * NEAR, FAR, or NEAR_AND_FAR.
  * 
  * @author James Seibel
  * @version 02-14-2021
@@ -10,8 +27,10 @@ public enum FogDistance
 {
 	/** good for fast or fancy fog qualities. */
 	NEAR,
+	
 	/** good for fast or fancy fog qualities. */
 	FAR,
+	
 	/** only looks good if the fog quality is set to Fancy. */
 	NEAR_AND_FAR;
 }

src/main/java/com/seibel/lod/enums/FogDrawOverride.java

@@ -0,0 +1,43 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+/**
+ * USE_OPTIFINE_FOG_SETTING, <br>
+ * NEVER_DRAW_FOG, <br>
+ * ALWAYS_DRAW_FOG_FAST, <br>
+ * ALWAYS_DRAW_FOG_FANCY <br>
+ * 
+ * @author James Seibel
+ * @version 7-03-2021
+ */
+public enum FogDrawOverride
+{
+	/** Use whatever Fog setting optifine is using.
+	 * If optifine isn't installed this defaults to ALWAYS_DRAW_FOG. */
+	USE_OPTIFINE_FOG_SETTING,
+	
+	/** Never draw fog on the LODs */
+	NEVER_DRAW_FOG,
+	
+	/** Always draw fog on the LODs */
+	ALWAYS_DRAW_FOG_FAST,
+	
+	/** Always draw fog on the LODs */
+	ALWAYS_DRAW_FOG_FANCY;
+}

src/main/java/com/seibel/lod/enums/FogQuality.java

@@ -1,3 +1,20 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.seibel.lod.enums;
 
 /**

src/main/java/com/seibel/lod/enums/GenerationPriority.java

@@ -0,0 +1,29 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+/**
+ * @author James Seibel
+ * @author Leonardo Amato
+ */
+public enum GenerationPriority
+{
+	NEAR_FIRST,
+
+	FAR_FIRST;
+}

src/main/java/com/seibel/lod/enums/HorizontalQuality.java

@@ -0,0 +1,46 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+/**
+ * USE_OPTIFINE_FOG_SETTING, <br>
+ * NEVER_DRAW_FOG, <br>
+ * ALWAYS_DRAW_FOG_FAST, <br>
+ * ALWAYS_DRAW_FOG_FANCY <br>
+ *
+ * @author James Seibel
+ * @version 7-03-2021
+ */
+public enum HorizontalQuality
+{
+	/** Lods are 2D with heightMap */
+	LOW(64),
+
+	/** Lods expand in three dimension */
+	MEDIUM(128),
+
+	/** Lods expand in three dimension */
+	HIGH(256);
+
+	public int distanceUnit;
+
+	HorizontalQuality(int distanceUnit)
+	{
+		this.distanceUnit = distanceUnit;
+	}
+}

src/main/java/com/seibel/lod/enums/HorizontalResolution.java

@@ -0,0 +1,158 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+import java.util.ArrayList;
+import java.util.Collections;
+
+import com.seibel.lod.util.LodUtil;
+
+/**
+ * single, double, quad, half, full
+ * 
+ * @author James Seibel
+ * @version 8-11-2021
+ */
+public enum HorizontalResolution
+{
+	/** render 1 LOD for each chunk */
+	CHUNK(1, 4),
+	
+	/** render 4 LODs for each chunk */
+	HALF_CHUNK(2, 3),
+	
+	/** render 16 LODs for each chunk */
+	FOUR_BLOCKS(4, 2),
+	
+	/** render 64 LODs for each chunk */
+	TWO_BLOCKS(8, 1),
+	
+	/** render 256 LODs for each chunk */
+	BLOCK(16, 0);
+
+	/** How many DataPoints should 
+	 * be drawn per side per LodChunk */
+	public final int dataPointLengthCount;
+	/** How wide each LOD DataPoint is */
+	public final int dataPointWidth;
+	/** This is the same as detailLevel in LodQuadTreeNode, 
+	 * lowest is 0 highest is 9 */
+	public final byte detailLevel;
+	
+	/* Start/End X/Z give the block positions
+	 * for each individual dataPoint in a LodChunk */
+	public final int[] startX;
+	public final int[] startZ;
+	
+	public final int[] endX;
+	public final int[] endZ;
+
+	
+	/** 
+	 * 1st dimension: LodDetail.detailLevel <br>
+	 * 2nd dimension: An array of all LodDetails that are less than or <br>
+	 *                equal to that detailLevel
+	 */
+	private static HorizontalResolution[][] lowerDetailArrays;
+	
+	
+	
+	
+	private HorizontalResolution(int newLengthCount, int newDetailLevel)
+	{
+		detailLevel = (byte) newDetailLevel;
+		dataPointLengthCount = newLengthCount;
+		dataPointWidth = 16 / dataPointLengthCount;
+		
+		startX = new int[dataPointLengthCount * dataPointLengthCount];
+		endX = new int[dataPointLengthCount * dataPointLengthCount];
+		
+		startZ = new int[dataPointLengthCount * dataPointLengthCount];
+		endZ = new int[dataPointLengthCount * dataPointLengthCount];
+		
+		
+		int index = 0;
+		for(int x = 0; x < newLengthCount; x++)
+		{
+			for(int z = 0; z < newLengthCount; z++)
+			{
+				startX[index] = x * dataPointWidth;
+				startZ[index] = z * dataPointWidth;
+				
+				endX[index] = (x*dataPointWidth) + dataPointWidth;
+				endZ[index] = (z*dataPointWidth) + dataPointWidth;
+				
+				index++;
+			}
+		}
+		
+	}// constructor
+	
+	
+	
+	
+	
+	
+	/** 
+	 * Returns an array of all LodDetails that have a detail level
+	 * that is less than or equal to the given LodDetail
+	 */
+	public static HorizontalResolution[] getSelfAndLowerDetails(HorizontalResolution detail)
+	{
+		if (lowerDetailArrays == null)
+		{
+			// run first time setup
+			lowerDetailArrays = new HorizontalResolution[HorizontalResolution.values().length][];
+			
+			// go through each LodDetail
+			for(HorizontalResolution currentDetail : HorizontalResolution.values())
+			{
+				ArrayList<HorizontalResolution> lowerDetails = new ArrayList<>();
+				
+				// find the details lower than currentDetail
+				for(HorizontalResolution compareDetail : HorizontalResolution.values())
+				{
+					if (currentDetail.detailLevel <= compareDetail.detailLevel)
+					{
+						lowerDetails.add(compareDetail);
+					}
+				}
+				
+				// have the highest detail item first in the list
+				Collections.sort(lowerDetails);
+				Collections.reverse(lowerDetails);
+				
+				lowerDetailArrays[currentDetail.detailLevel] = lowerDetails.toArray(new HorizontalResolution[lowerDetails.size()]);
+			}
+		}
+		
+		return lowerDetailArrays[detail.detailLevel];
+	}
+	
+	/** Returns what detail level should be used at a given distance and maxDistance. */
+	public static HorizontalResolution getDetailForDistance(HorizontalResolution maxDetailLevel, int distance, int maxDistance)
+	{
+		HorizontalResolution[] lowerDetails = getSelfAndLowerDetails(maxDetailLevel);
+		int distaneBetweenDetails = maxDistance / lowerDetails.length;
+		int index = LodUtil.clamp(0, distance / distaneBetweenDetails, lowerDetails.length - 1);
+		
+		return lowerDetails[index];
+		
+	}
+	
+}

src/main/java/com/seibel/lod/enums/LodColorStyle.java

@@ -1,18 +0,0 @@
-package com.seibel.lod.enums;
-
-/**
- * top, individual_sides
- * 
- * @author James Seibel
- * @version 05-08-2021
- */
-public enum LodColorStyle
-{
-	/** Use the color from the top of the LOD chunk 
-	 * for all sides */
-	TOP,
-	
-	/** For each side of the LOD use the color corresponding
-	 * to that side */
-	INDIVIDUAL_SIDES;
-}

src/main/java/com/seibel/lod/enums/LodCorner.java

@@ -1,26 +0,0 @@
-package com.seibel.lod.enums;
-
-/**
- * NE, SE, SW, NW
- * 
- * @author James Seibel
- * @version 1-20-2020
- */
-public enum LodCorner
-{
-	/** -Z, +X */
-	NE(0),
-	/** +Z, +X */
-	SE(1),
-	/** +Z, -X */
-	SW(2),
-	/** -Z, -X */
-	NW(3);
-	
-	public final int value;
-	
-	private LodCorner(int newValue)
-	{
-		value = newValue;
-	}
-}

src/main/java/com/seibel/lod/enums/LodDetail.java

@@ -1,25 +0,0 @@
-package com.seibel.lod.enums;
-
-/**
- * single, quad
- * 
- * @author James Seibel
- * @version 05-29-2021
- */
-public enum LodDetail
-{
-	/** render 1 LOD for each chunk */
-	SINGLE(1),
-	
-	/** render 4 LODs for each chunk */
-	DOUBLE(2);
-	
-	/** How many data points wide the related
-	 * LodChunk object should contain */
-	public final int value;
-	
-	private LodDetail(int newValue)
-	{
-		value = newValue;
-	}
-}

src/main/java/com/seibel/lod/enums/LodTemplate.java

@@ -1,3 +1,20 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.seibel.lod.enums;
 
 import com.seibel.lod.builders.lodTemplates.AbstractLodTemplate;
@@ -9,7 +26,7 @@ import com.seibel.lod.builders.lodTemplates.TriangularLodTemplate;
  * Cubic, Triangular, Dynamic
  * 
  * @author James Seibel
- * @version 05-07-2021
+ * @version 8-4-2021
  */
 public enum LodTemplate
 {
@@ -35,4 +52,10 @@ public enum LodTemplate
 	{
 		template = newTemplate;
 	}
+	
+	
+	public int getBufferMemoryForSingleLod(int maxVerticalData)
+	{
+		return template.getBufferMemoryForSingleNode(maxVerticalData);
+	}
 }

src/main/java/com/seibel/lod/enums/RelativeChunkPos.java

@@ -1,69 +0,0 @@
-package com.seibel.lod.enums;
-
-import java.util.ArrayList;
-import java.util.Arrays;
-import java.util.EnumSet;
-
-/** 
- * NE, SE, SW, NW <br>
- * NORTH, SOUTH, EAST, WEST, <br>
- * CENTER
- * 
- * @author James Seibel
- * @version 05-30-2021
- */
-public enum RelativeChunkPos
-{
-	/** +X, -Z */
-	NE(0, 1,-1),
-	/** +X, +Z */
-	SE(1, 1,1),
-	/** -X, +Z */
-	SW(2, -1,1),
-	/** -X, -Z */
-	NW(3, -1,-1),
-	
-	/** -Z */
-	NORTH(4, 0,-1),
-	/** +Z */
-	SOUTH(5, 0,1),
-	
-	/** +X */
-	EAST(6, 1,0),
-	/** -X */
-	WEST(7, -1,0),
-	
-	CENTER(8, 0,0);
-	
-	/** index used when referencing objects in an array */
-	public final int index;
-	
-	/** position relative to X CENTER */
-	public final int x;
-	/** position relative to Z CENTER */
-	public final int z;
-	
-	/** NORTH, SOUTH, EAST, WEST */
-	public static EnumSet<RelativeChunkPos> ADJACENT = EnumSet.of(NORTH, SOUTH, EAST, WEST);
-	/** NE, NW, SE, SW */
-	public static EnumSet<RelativeChunkPos> DIAGONAL = EnumSet.of(NE, NW, SE, SW);
-	
-	
-	public static EnumSet<RelativeChunkPos> NW_CORNER = EnumSet.of(WEST, NW, NORTH);
-	public static EnumSet<RelativeChunkPos> NE_CORNER = EnumSet.of(EAST, NE, NORTH);
-	public static EnumSet<RelativeChunkPos> SW_CORNER = EnumSet.of(WEST, SW, SOUTH);
-	public static EnumSet<RelativeChunkPos> SE_CORNER = EnumSet.of(EAST, SE, SOUTH);
-	
-	/** NW_CORNER, NE_CORNER, SW_CORNER, SE_CORNER <br>
-	 * Contains the 3 points surrounding a corner. */
-	public static ArrayList<EnumSet<RelativeChunkPos>> CORNERS = new ArrayList<EnumSet<RelativeChunkPos>>( Arrays.asList(NW_CORNER, NE_CORNER, SW_CORNER, SE_CORNER) );
-	
-	private RelativeChunkPos(int newIndex, int newX, int newZ)
-	{
-		index = newIndex;
-		x = newX;
-		z = newZ;
-	}
-}
-
-

src/main/java/com/seibel/lod/enums/ShadingMode.java

@@ -0,0 +1,18 @@
+package com.seibel.lod.enums;
+
+/**
+ * NONE, DARKEN_SIDES
+ * 
+ * @author James Seibel
+ * @version 7-25-2020
+ */
+public enum ShadingMode
+{
+	/** LODs will have the same lighting on every side.
+	Fastest, but can make large similarly colored areas hard to differentiate */
+	NONE,
+	
+	/** LODs will have darker sides and bottoms to simulate top down lighting.
+	Fastest */
+	GAME_SHADING;
+}

src/main/java/com/seibel/lod/enums/VerticalQuality.java

@@ -0,0 +1,36 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+/**
+ * USE_OPTIFINE_FOG_SETTING, <br>
+ * NEVER_DRAW_FOG, <br>
+ * ALWAYS_DRAW_FOG_FAST, <br>
+ * ALWAYS_DRAW_FOG_FANCY <br>
+ *
+ * @author James Seibel
+ * @version 7-03-2021
+ */
+public enum VerticalQuality
+{
+	/** Lods are 2D with heightMap */
+	HEIGHTMAP,
+
+	/** Lods expand in three dimension */
+	MULTI_LOD;
+}

src/main/java/com/seibel/lod/handlers/LodDimensionFileHandler.java

@@ -1,192 +1,208 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.seibel.lod.handlers;
 
-import java.io.BufferedReader;
+import java.io.BufferedInputStream;
+import java.io.BufferedOutputStream;
 import java.io.File;
-import java.io.FileReader;
-import java.io.FileWriter;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
 import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.nio.file.Files;
+import java.nio.file.StandardCopyOption;
 import java.util.concurrent.ExecutorService;
 import java.util.concurrent.Executors;
 
-import com.seibel.lod.objects.LodChunk;
-import com.seibel.lod.objects.LodDimension;
-import com.seibel.lod.objects.LodRegion;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.enums.VerticalQuality;
+import com.seibel.lod.objects.*;
 import com.seibel.lod.proxy.ClientProxy;
+import com.seibel.lod.util.LodThreadFactory;
+import com.seibel.lod.util.LodUtil;
 
 /**
  * This object handles creating LodRegions
  * from files and saving LodRegion objects
  * to file.
- * 
+ *
  * @author James Seibel
- * @version 05-31-2021
+ * @version 9-7-2021
  */
 public class LodDimensionFileHandler
 {
+
 	private LodDimension loadedDimension = null;
 	public long regionLastWriteTime[][];
-	
+
 	private File dimensionDataSaveFolder;
-	
-	private final String FILE_NAME_PREFIX = "lod";
-	private final String FILE_EXTENSION = ".txt";
-	
-	/** This is the file version currently accepted by this
+
+	/**
+	 * lod
+	 */
+	private static final String FILE_NAME_PREFIX = "lod";
+	/**
+	 * .txt
+	 */
+	private static final String FILE_EXTENSION = ".dat";
+	/**
+	 * detail-#
+	 */
+	private static final String DETAIL_FOLDER_NAME_PREFIX = "detail-";
+
+	/**
+	 * .tmp <br>
+	 * Added to the end of the file path when saving to prevent
+	 * nulling a currently existing file. <br>
+	 * After the file finishes saving it will end with
+	 * FILE_EXTENSION.
+	 */
+	private static final String TMP_FILE_EXTENSION = ".tmp";
+
+	/**
+	 * This is the file version currently accepted by this
 	 * file handler, older versions (smaller numbers) will be deleted and overwritten,
-	 * newer versions (larger numbers) will be ignored and won't be read. */
-	public static final int LOD_SAVE_FILE_VERSION = 1;
-	/** This is the string written before the file version */
-	private static final String LOD_FILE_VERSION_PREFIX = "lod_save_file_version";
-	
-	/** Allow saving asynchronously, but never try to save multiple regions
-	 * at a time */
-	private ExecutorService fileWritingThreadPool = Executors.newSingleThreadExecutor();
-	
-	
+	 * newer versions (larger numbers) will be ignored and won't be read.
+	 */
+	public static final int LOD_SAVE_FILE_VERSION = 6;
+
+	/**
+	 * Allow saving asynchronously, but never try to save multiple regions
+	 * at a time
+	 */
+	private ExecutorService fileWritingThreadPool = Executors.newSingleThreadExecutor(new LodThreadFactory(this.getClass().getSimpleName()));
+
+
 	public LodDimensionFileHandler(File newSaveFolder, LodDimension newLoadedDimension)
 	{
 		if (newSaveFolder == null)
 			throw new IllegalArgumentException("LodDimensionFileHandler requires a valid File location to read and write to.");
-		
+
 		dimensionDataSaveFolder = newSaveFolder;
-		
+
 		loadedDimension = newLoadedDimension;
 		// these two variable are used in sync with the LodDimension
 		regionLastWriteTime = new long[loadedDimension.getWidth()][loadedDimension.getWidth()];
-		for(int i = 0; i < loadedDimension.getWidth(); i++)
-			for(int j = 0; j < loadedDimension.getWidth(); j++)
+		for (int i = 0; i < loadedDimension.getWidth(); i++)
+			for (int j = 0; j < loadedDimension.getWidth(); j++)
 				regionLastWriteTime[i][j] = -1;
 	}
-	
-	
-	
-	
-	
+
+
 	//================//
 	// read from file //
 	//================//
-	
-	
-	
+
 	/**
-	 * Return the LodRegion at the given coordinates.
+	 * Return the LodRegion region at the given coordinates.
 	 * (null if the file doesn't exist)
 	 */
-	public LodRegion loadRegionFromFile(int regionX, int regionZ)
+	public LodRegion loadRegionFromFile(byte detailLevel, RegionPos regionPos, DistanceGenerationMode generationMode, VerticalQuality verticalQuality)
 	{
-		String fileName = getFileNameAndPathForRegion(regionX, regionZ);
-		
-		File f = new File(fileName);
-		
-		if (!f.exists())
+		int regionX = regionPos.x;
+		int regionZ = regionPos.z;
+		LodRegion region = new LodRegion(LodUtil.REGION_DETAIL_LEVEL,regionPos, generationMode, verticalQuality);
+		for (byte tempDetailLevel = LodUtil.REGION_DETAIL_LEVEL; tempDetailLevel >= detailLevel; tempDetailLevel--)
 		{
-			// there wasn't a file, don't
-			// return anything
-			return null;
-		}
-		
-		LodRegion region = new LodRegion(regionX, regionZ);
-		
-		try
-		{
-			BufferedReader br = new BufferedReader(new FileReader(f));
-			String s = br.readLine();
-			int fileVersion = -1;
-						
-			if(s != null && !s.isEmpty())
+			String fileName = getFileNameAndPathForRegion(regionX, regionZ, generationMode, tempDetailLevel, verticalQuality);
+
+			try
 			{
-				// try to get the file version
-				try
+				// if the fileName was null that means the folder is inaccessible
+				// for some reason
+				if (fileName == null)
+					throw new IllegalArgumentException("Unable to read region [" + regionX + ", " + regionZ + "] file, no fileName.");
+
+
+				File f = new File(fileName);
+
+				if (!f.exists())
 				{
-					fileVersion = Integer.parseInt(s.substring(s.indexOf(' ')).trim());
+					// there wasn't a file, don't
+					// return anything
+					continue;
 				}
-				catch(NumberFormatException | StringIndexOutOfBoundsException e)
-				{
-					// this file doesn't have a version
-					// keep the version as -1
-					fileVersion = -1;
+				byte[] data = {0};
+				long dataSize = f.length();
+				dataSize -= 1;
+				if (dataSize > 0) {
+					try (InputStream inputStream = new BufferedInputStream(new FileInputStream(f))) {
+						int fileVersion = -1;
+						fileVersion = inputStream.read();
+						// check if this file can be read by this file handler
+						if (fileVersion < LOD_SAVE_FILE_VERSION) {
+							// the file we are reading is an older version,
+							// close the reader and delete the file.
+							inputStream.close();
+							f.delete();
+							ClientProxy.LOGGER.info("Outdated LOD region file for region: (" + regionX + "," + regionZ + ") version found: " + fileVersion +
+									", version requested: " + LOD_SAVE_FILE_VERSION +
+									" File was been deleted.");
+
+							break;
+						} else if (fileVersion > LOD_SAVE_FILE_VERSION) {
+							// the file we are reading is a newer version,
+							// close the reader and ignore the file, we don't
+							// want to accidently delete anything the user may want.
+							inputStream.close();
+							ClientProxy.LOGGER.info("Newer LOD region file for region: (" + regionX + "," + regionZ + ") version found: " + fileVersion +
+									", version requested: " + LOD_SAVE_FILE_VERSION +
+									" this region will not be written to in order to protect the newer file.");
+
+							break;
+						}
+						// this file is a readable version, begin reading the file
+						data = new byte[(int) dataSize];
+						inputStream.read(data);
+						inputStream.close();
+					} catch (IOException ex) {
+						ex.printStackTrace();
+					}
 				}
-				
-				// check if this file can be read by this file handler
-				if(fileVersion < LOD_SAVE_FILE_VERSION)
-				{
-					// the file we are reading is an older version,
-					// close the reader and delete the file.
-					br.close();
-					f.delete();
-					ClientProxy.LOGGER.info("Outdated LOD region file for region: (" + regionX + "," + regionZ + ") version: " + fileVersion +
-							", version requested: " + LOD_SAVE_FILE_VERSION +
-							" File was been deleted.");
-					
-					return null;
+				switch (region.getLodQualityMode()){
+					default:
+					case HEIGHTMAP:
+						region.addLevel(new SingleLevelContainer(data));
+						break;
+					case MULTI_LOD:
+						region.addLevel(new VerticalLevelContainer(data));
+						break;
 				}
-				else if(fileVersion > LOD_SAVE_FILE_VERSION)
-				{
-					// the file we are reading is a newer version,
-					// close the reader and ignore the file, we don't
-					// want to accidently delete anything the user may want.
-					br.close();
-					ClientProxy.LOGGER.info("Newer LOD region file for region: (" + regionX + "," + regionZ + ") version: " + fileVersion + 
-							", version requested: " + LOD_SAVE_FILE_VERSION +
-							" this region will not be written to in order to protect the newer file.");
-					
-					return null;
-				}
-			}
-			else
+				//region.addLevel(new SingleLevelContainer(data));
+			} catch (Exception e)
 			{
-				// there is no data in this file
-				br.close();
-				return null;
+				// the buffered reader encountered a
+				// problem reading the file
+				ClientProxy.LOGGER.error("LOD file read error. Unable to read to [" + fileName + "] error [" + e.getMessage() + "]: ");
+				e.printStackTrace();
 			}
-			
-			
-			// this file is a readable version, begin reading the file
-			s = br.readLine();
-			
-			while(s != null && !s.isEmpty())
-			{
-				try
-				{
-					// convert each line into an LOD object and add it to the region
-					LodChunk lod = new LodChunk(s);
-					
-					region.addLod(lod);
-				}
-				catch(IllegalArgumentException e)
-				{
-					// we were unable to create this chunk
-					// for whatever reason.
-					// skip to the next chunk
-					ClientProxy.LOGGER.warn(e.getMessage());
-				}
-				
-				s = br.readLine();
-			}
-			
-			br.close();
 		}
-		catch (IOException e)
-		{
-			// the buffered reader encountered a 
-			// problem reading the file
-			return null;
-		}
-		
+		if (region.getMinDetailLevel() >= detailLevel)
+			region.expand(detailLevel);
 		return region;
 	}
-	
-	
-	
-	
-	
-	
-	
-	
+
+
 	//==============//
 	// Save to File //
 	//==============//
-	
+
 	/**
 	 * Save all dirty regions in this LodDimension to file.
 	 */
@@ -194,22 +210,28 @@ public class LodDimensionFileHandler
 	{
 		fileWritingThreadPool.execute(saveDirtyRegionsThread);
 	}
-	
-	private Thread saveDirtyRegionsThread = new Thread(() -> 
+
+	private Thread saveDirtyRegionsThread = new Thread(() ->
 	{
-		for(int i = 0; i < loadedDimension.getWidth(); i++)
+		try
 		{
-			for(int j = 0; j < loadedDimension.getWidth(); j++)
+			for (int i = 0; i < loadedDimension.getWidth(); i++)
 			{
-				if(loadedDimension.isRegionDirty[i][j] && loadedDimension.regions[i][j] != null)
+				for (int j = 0; j < loadedDimension.getWidth(); j++)
 				{
-					saveRegionToDisk(loadedDimension.regions[i][j]);
-					loadedDimension.isRegionDirty[i][j] = false;
+					if (loadedDimension.isRegionToRegen(i,j) && loadedDimension.getRegionByArrayIndex(i,j) != null)
+					{
+						saveRegionToFile(loadedDimension.getRegionByArrayIndex(i,j));
+						loadedDimension.setRegenByArrayIndex(i, j,false);
+					}
 				}
 			}
+		} catch (Exception e)
+		{
+			e.printStackTrace();
 		}
 	});
- 	
+
 	/**
 	 * Save a specific region to disk.<br>
 	 * Note: <br>
@@ -218,102 +240,101 @@ public class LodDimensionFileHandler
 	 * 2. This will save to the LodDimension that this
 	 * handler is associated with.
 	 */
-	private void saveRegionToDisk(LodRegion region)
+	private void saveRegionToFile(LodRegion region)
 	{
-		// convert chunk coordinates to region
-		// coordinates
-		int x = region.x;
-		int z = region.z;
-		
-		File f = new File(getFileNameAndPathForRegion(x, z));
-		
-		try
+		// convert to region coordinates
+		int x = region.regionPosX;
+		int z = region.regionPosZ;
+		for (byte detailLevel = region.getMinDetailLevel(); detailLevel <= LodUtil.REGION_DETAIL_LEVEL; detailLevel++)
 		{
-			// make sure the file and folder exists
-			if (!f.exists())
+			String fileName = getFileNameAndPathForRegion(x, z, region.getGenerationMode(), detailLevel, region.getLodQualityMode());
+			File oldFile = new File(fileName);
+
+			// if the fileName was null that means the folder is inaccessible
+			// for some reason
+			if (fileName == null)
 			{
-				// the file doesn't exist,
-				// create it and the folder if need be
-				if(!f.getParentFile().exists())
-					f.getParentFile().mkdirs();
-				f.createNewFile();
+				ClientProxy.LOGGER.warn("Unable to save region [" + x + ", " + z + "] to file, no fileName.");
+				return;
 			}
-			else
+
+
+			try
 			{
-				// the file exists, make sure it
-				// is the correct version.
-				// (to make sure we don't overwrite a newer
-				// version file if it exists)
-				
-				BufferedReader br = new BufferedReader(new FileReader(f));
-				String s = br.readLine();
-				int fileVersion = LOD_SAVE_FILE_VERSION;
-							
-				if(s != null && !s.isEmpty())
+				// make sure the file and folder exists
+				if (!oldFile.exists())
 				{
-					// try to get the file version
-					try
-					{
-						fileVersion = Integer.parseInt(s.substring(s.indexOf(' ')).trim());
-					}
-					catch(NumberFormatException | StringIndexOutOfBoundsException e)
-					{
-						// this file doesn't have a correctly formated version
-						// just overwrite the file
+					// the file doesn't exist,
+					// create it and the folder if need be
+					if (!oldFile.getParentFile().exists())
+						oldFile.getParentFile().mkdirs();
+					oldFile.createNewFile();
+				} else
+				{
+					// the file exists, make sure it
+					// is the correct version.
+					// (to make sure we don't overwrite a newer
+					// version file if it exists)
+					int fileVersion = LOD_SAVE_FILE_VERSION;
+					try (InputStream inputStream = new BufferedInputStream(new FileInputStream(oldFile))) {
+						fileVersion = inputStream.read();
+						inputStream.close();
+					} catch (IOException ex) {
+						ex.printStackTrace();
 					}
+					// check if this file can be written to by the file handler
+					if (fileVersion > LOD_SAVE_FILE_VERSION) {
+						// the file we are reading is a newer version,
+						// don't write anything, we don't want to accidently
+						// delete anything the user may want.
+						return;
+					}  // if(fileVersion > LOD_SAVE_FILE_VERSION)
+					//else {
+						// we are good to continue and overwrite the old file
+					//}
+
 				}
-				br.close();
-				
-				// check if this file can be written to by the file handler
-				if(fileVersion <= LOD_SAVE_FILE_VERSION)
-				{
-					// we are good to continue and overwrite the old file
-				}
-				else //if(fileVersion > LOD_SAVE_FILE_VERSION)
-				{
-					// the file we are reading is a newer version,
-					// don't write anything, we don't want to accidently 
-					// delete anything the user may want.
-					return;
+
+				// the old file is good, now create a new save file
+				File newFile = new File(fileName + TMP_FILE_EXTENSION);
+				try (OutputStream outputStream = new BufferedOutputStream(new FileOutputStream(newFile))) {
+
+					// add the version of this file
+					outputStream.write(LOD_SAVE_FILE_VERSION);
+
+					// add each LodChunk to the file
+					outputStream.write(region.getLevel(detailLevel).toDataString());
+					outputStream.close();
+
+					// overwrite the old file with the new one
+					Files.move(newFile.toPath(), oldFile.toPath(), StandardCopyOption.ATOMIC_MOVE, StandardCopyOption.REPLACE_EXISTING);
+				}catch (IOException ex) {
+					ex.printStackTrace();
 				}
+			} catch (Exception e)
+			{
+				ClientProxy.LOGGER.error("LOD file write error. Unable to write to [" + fileName + "] error [" + e.getMessage() + "]: ");
+				e.printStackTrace();
 			}
-			
-			FileWriter fw = new FileWriter(f);
-			
-			// add the version of this file
-			fw.write(LOD_FILE_VERSION_PREFIX + " " + LOD_SAVE_FILE_VERSION + "\n");
-			
-			// add each LodChunk to the file
-			for(LodChunk[] chunkArray : region.getAllLods())
-				for(LodChunk chunk : chunkArray)
-					if(chunk != null && !chunk.isPlaceholder())
-						fw.write(chunk.toData() + "\n");
-			
-			fw.close();
-		}
-		catch(Exception e)
-		{
-			ClientProxy.LOGGER.error("LOD file write error: " + e.getMessage());
 		}
 	}
-	
-	
- 	
-	
-	
-	
-	
+
+
 	//================//
 	// helper methods //
 	//================//
-	
-	
+
+
 	/**
-	 * Return the name of the file that should contain the 
+	 * Return the name of the file that should contain the
 	 * region at the given x and z. <br>
-	 * Returns null if this object isn't ready to read and write.
+	 * Returns null if this object isn't ready to read and write. <br><br>
+	 * <p>
+	 * example: "lod.0.0.txt" <br><br>
+	 * <p>
+	 * Returns null if there is an IO Exception.
 	 */
-	private String getFileNameAndPathForRegion(int regionX, int regionZ)
+	private String getFileNameAndPathForRegion(int regionX, int regionZ, DistanceGenerationMode generationMode, byte detailLevel, VerticalQuality verticalQuality)
 	{
 		try
 		{
@@ -321,13 +342,17 @@ public class LodDimensionFileHandler
 			// ".\Super Flat\DIM-1\data"
 			// or
 			// ".\Super Flat\data"
-			return dimensionDataSaveFolder.getCanonicalPath() + "\\" +
+			return dimensionDataSaveFolder.getCanonicalPath() + File.separatorChar +
+					       verticalQuality + File.separatorChar +
+					generationMode.toString() + File.separatorChar +
+					DETAIL_FOLDER_NAME_PREFIX + detailLevel + File.separatorChar +
 					FILE_NAME_PREFIX + "." + regionX + "." + regionZ + FILE_EXTENSION;
-		}
-		catch(IOException e)
+		} catch (IOException | SecurityException e)
 		{
+			ClientProxy.LOGGER.warn("Unable to get the filename for the region [" + regionX + ", " + regionZ + "], error: [" + e.getMessage() + "], stacktrace: ");
+			e.printStackTrace();
 			return null;
 		}
 	}
-	
+
 }

src/main/java/com/seibel/lod/handlers/ReflectionHandler.java

@@ -1,47 +1,66 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.seibel.lod.handlers;
 
 import java.lang.reflect.Field;
+import java.lang.reflect.Method;
 
 import com.seibel.lod.enums.FogQuality;
-
-import net.minecraft.client.Minecraft;
+import com.seibel.lod.wrappers.MinecraftWrapper;
 
 /**
  * This object is used to get variables from methods
  * where they are private. Specifically the fog setting
  * in Optifine.
- * 
+ *
  * @author James Seibel
- * @version 09-21-2020
+ * @version 9-7-2021
  */
 public class ReflectionHandler
 {
-	private Minecraft mc = Minecraft.getInstance();
+	public static final ReflectionHandler INSTANCE = new ReflectionHandler();
+	private MinecraftWrapper mc = MinecraftWrapper.INSTANCE;
+	
 	public Field ofFogField = null;
+	public Method vertexBufferUploadMethod = null;
 	
 	
-	public ReflectionHandler()
+	
+	private ReflectionHandler()
 	{
 		setupFogField();
 	}
 	
 	
-	
-	
 	/**
-	 * Similar to setupFovMethod.
+	 * finds the Optifine fog type field
 	 */
 	private void setupFogField()
 	{
 		// get every variable from the entity renderer
-		Field[] vars = mc.gameSettings.getClass().getDeclaredFields();
-				
+		Field[] optionFields = mc.getOptions().getClass().getDeclaredFields();
+		
 		// try and find the ofFogType variable in gameSettings
-		for(Field f : vars)
+		for (Field field : optionFields)
 		{
-			if(f.getName().equals("ofFogType"))
+			if (field.getName().equals("ofFogType"))
 			{
-				ofFogField = f;
+				ofFogField = field;
 				return;
 			}
 		}
@@ -49,13 +68,11 @@ public class ReflectionHandler
 		// we didn't find the field,
 		// either optifine isn't installed, or
 		// optifine changed the name of the variable
-		ofFogField = null;
 	}
 	
 	
 	
 	
-	
 	/**
 	 * Get what type of fog optifine is currently set to render.
 	 */
@@ -73,27 +90,29 @@ public class ReflectionHandler
 		
 		try
 		{
-			returnNum = (int)ofFogField.get(mc.gameSettings);
-		}
-		catch (IllegalArgumentException | IllegalAccessException e)
+			returnNum = (int) ofFogField.get(mc.getOptions());
+		} catch (IllegalArgumentException | IllegalAccessException e)
 		{
 			e.printStackTrace();
 		}
 		
 		switch (returnNum)
 		{
-			case 0:
-				return FogQuality.FAST;
-			case 1:
-				return FogQuality.FAST;
-			case 2:
-				return FogQuality.FANCY;
-			case 3:
-				return FogQuality.OFF;
-				
-			default:
-				return FogQuality.FAST;
+		// optifine's "default" option,
+		// it should never be called in this case
+		case 0:
+			return FogQuality.FAST;
+			
+			// normal options
+		case 1:
+			return FogQuality.FAST;
+		case 2:
+			return FogQuality.FANCY;
+		case 3:
+			return FogQuality.OFF;
+			
+		default:
+			return FogQuality.FAST;
 		}
 	}
-	
 }

src/main/java/com/seibel/lod/mixin/MixinWorldRenderer.java

@@ -1,25 +1,41 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.seibel.lod.mixin;
 
+import com.mojang.blaze3d.matrix.MatrixStack;
+import com.seibel.lod.LodMain;
+import com.seibel.lod.proxy.ClientProxy;
+import net.minecraft.client.renderer.RenderType;
+import net.minecraft.client.renderer.WorldRenderer;
 import org.spongepowered.asm.mixin.Mixin;
 import org.spongepowered.asm.mixin.injection.At;
 import org.spongepowered.asm.mixin.injection.Inject;
 import org.spongepowered.asm.mixin.injection.callback.CallbackInfo;
 
-import com.mojang.blaze3d.matrix.MatrixStack;
-import com.seibel.lod.LodMain;
-import com.seibel.lod.util.LodConfig;
-
-import net.minecraft.client.renderer.RenderType;
-import net.minecraft.client.renderer.WorldRenderer;
-
 /**
  * This class is used to mix in my rendering code
  * before Minecraft starts rendering blocks.
- * If this wasn't done the LODs would render on top
+ * If this wasn't done and we used Forge's 
+ * render last event, the LODs would render on top
  * of the normal terrain.
  * 
  * @author James Seibel
- * @version 05-29-2021
+ * @version 9-19-2021
  */
 @Mixin(WorldRenderer.class)
 public class MixinWorldRenderer
@@ -34,12 +50,12 @@ public class MixinWorldRenderer
 		previousPartialTicks = partialTicks;
 	}
 	
-	@Inject(at = @At("HEAD"), method = "renderBlockLayer(Lnet/minecraft/client/renderer/RenderType;Lcom/mojang/blaze3d/matrix/MatrixStack;DDD)V", cancellable = false)
-	private void renderBlockLayer(RenderType renderType, MatrixStack matrixStackIn, double xIn, double yIn, double zIn, CallbackInfo callback)
+	@Inject(at = @At("HEAD"), method = "renderChunkLayer(Lnet/minecraft/client/renderer/RenderType;Lcom/mojang/blaze3d/matrix/MatrixStack;DDD)V", cancellable = false)
+	private void renderChunkLayer(RenderType renderType, MatrixStack matrixStackIn, double xIn, double yIn, double zIn, CallbackInfo callback)
 	{
 		// only render if LODs are enabled and
 		// only render before solid blocks
-		if (LodConfig.CLIENT.drawLODs.get() && renderType.equals(RenderType.getSolid()))
-			LodMain.client_proxy.renderLods(previousPartialTicks);
+		if (ClientProxy.drawLods && renderType.equals(RenderType.solid()))
+			LodMain.client_proxy.renderLods(matrixStackIn, previousPartialTicks);
 	}
 }

src/main/java/com/seibel/lod/objects/LevelContainer.java

@@ -0,0 +1,92 @@
+package com.seibel.lod.objects;
+
+public interface LevelContainer
+{
+	public static final char VERTICAL_DATA_DELIMITER = '\t';
+	public static final char DATA_DELIMITER = ' ';
+
+	/**With this you can add data to the level container
+	 *
+	 * @param data actual data to add in a array of long format.
+	 * @param posX x position in the detail level
+	 * @param posZ z position in the detail level
+	 * @param index z position in the detail level
+	 * @return true if correctly added, false otherwise
+	 */
+	public boolean addData(long data, int posX, int posZ, int index);
+
+	/**With this you can add data to the level container
+	 *
+	 * @param data actual data to add in a array of long format.
+	 * @param posX x position in the detail level
+	 * @param posZ z position in the detail level
+	 * @return true if correctly added, false otherwise
+	 */
+	public boolean addSingleData(long data, int posX, int posZ);
+
+	/**With this you can get data from the level container
+	 *
+	 * @param posX x position in the detail level
+	 * @param posZ z position in the detail level
+	 * @return the data in long array format
+	 */
+	public long getData(int posX, int posZ, int index);
+
+	/**With this you can get data from the level container
+	 *
+	 * @param posX x position in the detail level
+	 * @param posZ z position in the detail level
+	 * @return the data in long array format
+	 */
+	public long getSingleData(int posX, int posZ);
+
+	/**
+	 * @param posX x position in the detail level
+	 * @param posZ z position in the detail level
+	 * @return true only if the data exist
+	 */
+	public boolean doesItExist(int posX, int posZ);
+
+	/**
+	 * @return return the deatilLevel of this level container
+	 */
+	public byte getDetailLevel();
+
+
+	public int getMaxVerticalData();
+
+	public void clear(int posX, int posZ);
+
+	/**This return a level container with detail level lower than the current level.
+	 * The new level container may use information of this level.
+	 * @return the new level container
+	 */
+	public LevelContainer expand();
+
+	/**
+	 *
+	 * @param lowerLevelContainer lower level where we extract the data
+	 * @param posX x position in the detail level to update
+	 * @param posZ z position in the detail level to update
+	 */
+	public void updateData(LevelContainer lowerLevelContainer, int posX, int posZ);
+
+	/**
+	 * This will give the data to save in the file
+	 * @return data as a String
+	 */
+	public byte[] toDataString();
+
+
+	/**
+	 * This will give the data to save in the file
+	 * @return data as a String
+	 */
+	public int getMaxNumberOfLods();
+
+	/**
+	 * This will give the data to save in the file
+	 * @return data as a String
+	 */
+	public int getMaxMemoryUse();
+}

src/main/java/com/seibel/lod/objects/LodChunk.java

@@ -1,313 +0,0 @@
-package com.seibel.lod.objects;
-
-import java.awt.Color;
-
-import com.seibel.lod.enums.ColorDirection;
-
-import net.minecraft.util.math.ChunkPos;
-
-/**
- * This object contains position
- * and color data for an LOD object.
- * 
- * @author James Seibel
- * @version 05-29-2021
- */
-public class LodChunk
-{
-	/** how many different pieces of data are in one line */
-	private static final int DATA_DELIMITER_COUNT = 22;
-
-	/** This is what separates each piece of data in the toData method */
-	public static final char DATA_DELIMITER = ',';
-	
-	/** Width of a Minecraft Chunk */
-	public static final int WIDTH = 16;
-	
-	private static final Color INVISIBLE = new Color(0,0,0,0);
-	
-	
-	
-	/** The x coordinate of the chunk. */
-	public int x = 0;
-	/** The z coordinate of the chunk. */
-	public int z = 0;
-	
-	/*
-	 * The reason we are only using 1 height and depth point
-	 * instead of multiple is because:
-	 * 1. more points would drastically increase the amount of
-	 * 		memory and disk space needed
-	 * 2. more height/depth points require more color points,
-	 * 		which can get out of hand quickly
-	 * 3. with the increased disk space reading/writing would
-	 * 		take far too long
-	 * 4. the increased resolution is generally not worth it,
-	 * 		4 LODs per chunk is the limit of diminishing returns.
-	 * 		And some of that could potentially be faked through 
-	 * 		smart LodTemplates
-	 */
-	private short height;
-	private short depth;
-	
-	/** The average color for the 6 cardinal directions */
-	public Color colors[];
-	
-	/** If true then this LodChunk contains no data */
-	private boolean empty = false;
-	
-	
-	/**
-	 * Create an empty invisible LodChunk at (0,0)
-	 */
-	public LodChunk()
-	{
-		empty = true;
-		
-		x = 0;
-		z = 0;
-		
-		height = 0;
-		depth = 0;
-		colors = new Color[ColorDirection.values().length];
-		
-		// by default have the colors invisible
-		for(ColorDirection dir : ColorDirection.values())
-			colors[dir.value] = INVISIBLE;
-	}
-	
-	
-	/**
-	 * Creates an LodChunk from the string
-	 * generated by the toData method.
-	 * 
-	 * @throws IllegalArgumentException if the data isn't valid to create a LodChunk
-	 * @throws NumberFormatException if any piece of data can't be converted at any point
-	 */
-	public LodChunk(String data) throws IllegalArgumentException, NumberFormatException
-	{
-		/*
-		 * data format:
-		 * x, z, height, depth, rgb color data
-		 * 
-		 * example:
-		 * 5,8, 4, 0, 255,255,255, 255,255,255, 255,255,255, 255,255,255, 255,255,255, 255,255,255,
-		 */
-		
-		// make sure there are the correct number of entries
-		// in the data string (28)
-		int count = 0;
-		
-		for(int i = 0; i < data.length(); i++)
-			if(data.charAt(i) == DATA_DELIMITER)
-				count++;
-		
-		if(count != DATA_DELIMITER_COUNT)
-			throw new IllegalArgumentException("LodChunk constructor givin an invalid string. The data given had " + count + " delimiters when it should have had " + DATA_DELIMITER_COUNT + ".");
-		
-		
-		
-		// index we will use when going through the String
-		int index = 0;
-		int lastIndex = 0;
-		
-		
-		
-		// x and z position
-		index = data.indexOf(DATA_DELIMITER, 0);
-		x = Integer.parseInt(data.substring(0,index));
-		
-		lastIndex = index;
-		index = data.indexOf(DATA_DELIMITER, lastIndex+1);
-		z = Integer.parseInt(data.substring(lastIndex+1,index));
-		
-		// height
-		lastIndex = index;
-		index = data.indexOf(DATA_DELIMITER, lastIndex+1);
-		height = Short.parseShort(data.substring(lastIndex+1,index));
-		
-		// depth
-		lastIndex = index;
-		index = data.indexOf(DATA_DELIMITER, lastIndex+1);
-		depth = Short.parseShort(data.substring(lastIndex+1,index));
-		
-		
-		
-		// color
-		colors = new Color[6];
-		for(ColorDirection dir : ColorDirection.values())
-		{
-			int red = 0;
-			int green = 0;
-			int blue = 0;
-			
-			// get r,g,b
-			for(int i = 0; i < 3; i++)
-			{
-				lastIndex = index;
-				index = data.indexOf(DATA_DELIMITER, lastIndex + 1);
-				
-				String raw = "";
-				switch(i)
-				{
-				case 0:
-					raw = data.substring(lastIndex+1,index);
-					red = Short.parseShort(raw);
-					break;
-				case 1:
-					raw = data.substring(lastIndex+1,index);
-					green = Short.parseShort(raw);
-					break;
-				case 2:
-					raw = data.substring(lastIndex+1,index);
-					blue = Short.parseShort(raw);
-					break;
-				}
-			}
-			
-			colors[dir.value] = new Color(red, green, blue);
-		}
-		
-		
-		// after going through all this
-		// is this LOD empty?
-		empty = determineIfEmtpy();
-	}
-	
-	/**
-	 * Create a LodChunk from the given values.
-	 */
-	public LodChunk(ChunkPos pos, short newHeight, short newDepth, Color[] newColors)
-	{
-		x = pos.x;
-		z = pos.z;
-		
-		height = newHeight;
-		depth = newDepth;
-		colors = newColors;
-		
-		empty = determineIfEmtpy();
-	}
-	
-	
-	
-	
-	
-	
-	//================//
-	// misc functions //
-	//================//
-	
-	/**
-	 * Returns true if this LodChunk is an emptyPlaceholder
-	 */
-	public boolean isPlaceholder()
-	{
-		return empty;
-	}
-	
-	public boolean isLodEmpty()
-	{
-		return empty;
-	}
-	
-	/**
-	 * Returns true if this LOD is either invisible
-	 * from every direction or doesn't have a valid height.
-	 */
-	private boolean determineIfEmtpy()
-	{
-		// we don't check the depth since the
-		// height should always be greater than or equal
-		// to the depth
-		if(height >= 0)
-		{
-			// the height is valid,
-			// do we have at least 1 non-invisible color?
-			
-			for(ColorDirection dir : ColorDirection.values())
-				if(!colors[dir.value].equals(INVISIBLE))
-					// at least one direction has a non-invisible color
-					return false;
-			
-			return true;
-		}
-		else
-		{
-			// the height is negative,
-			// this LodChunk is empty
-			return true;
-		}
-	}
-	
-	
-	
-	
-	//========//
-	// output //
-	//========//
-	
-	/** Returns the color for the given direction */
-	public Color getColor(ColorDirection dir)
-	{
-		return colors[dir.value];
-	}
-	
-	public short getHeight()
-	{
-		return height;
-	}
-	
-	public short getDepth()
-	{
-		return depth;
-	}
-	
-	
-	
-	
-	
-	/**
-	 * Outputs all data in csv format
-	 * with the given delimiter.
-	 * <br>
-	 * Exports data in the form:
-	 * <br>
-	 * x, z, height, depth, rgb color data
-	 * 
-	 * <br>
-	 * example output:
-	 * <br>
-	 * 5,8, 4, 0, 255,255,255, 255,255,255, 255,255,255, 255,255,255, 255,255,255, 255,255,255,
-	 */
-	public String toData()
-	{
-		String s = "";
-		
-		s += Integer.toString(x) + DATA_DELIMITER +  Integer.toString(z) + DATA_DELIMITER;
-		
-		s += Short.toString(height) + DATA_DELIMITER;
-		
-		s += Short.toString(depth) + DATA_DELIMITER;
-		
-		for(int i = 0; i < colors.length; i++)
-		{
-			s += Integer.toString(colors[i].getRed()) + DATA_DELIMITER + Integer.toString(colors[i].getGreen()) + DATA_DELIMITER + Integer.toString(colors[i].getBlue()) + DATA_DELIMITER;
-		}
-		
-		return s;
-	}
-	
-	
-	@Override
-	public String toString()
-	{
-		String s = "";
-		
-		s += "x: " + x + " z: " + z + "\t";
-		
-		s += "(" + colors[ColorDirection.TOP.value].getRed() + ", " + colors[ColorDirection.TOP.value].getGreen() + ", " + colors[ColorDirection.TOP.value].getBlue() + ")";
-		
-		return s;
-	}
-}

src/main/java/com/seibel/lod/objects/LodRegion.java

@@ -1,90 +1,510 @@
 package com.seibel.lod.objects;
 
+
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.enums.LodTemplate;
+import com.seibel.lod.enums.VerticalQuality;
+import com.seibel.lod.util.DataPointUtil;
+import com.seibel.lod.util.DetailDistanceUtil;
+import com.seibel.lod.util.LevelPosUtil;
+import com.seibel.lod.util.LodUtil;
+
 /**
- * A LodRegion is the a 32x32
- * 2D array of LodChunk objects.
- * Each LodRegion corresponds to
- * one file in the file system.
- * 
- * @author James Seibel
- * @version 1-22-2021
+ * STANDARD TO FOLLOW
+ * every coordinate called posX or posZ is a relative coordinate and not and absolute coordinate
+ * if an array contain coordinate the order is the following
+ * 0 for x, 1 for z in 2D
+ * 0 for x, 1 for y, 2 for z in 3D
  */
 public class LodRegion
 {
-	/** number of chunks wide */
-	public static final int SIZE = 32;
-	
-	/**	X coordinate of this region */
-	public final int x;
-	/** Z coordinate of this region */
-	public final int z;
-	
-	private LodChunk chunks[][];
-	
-	
-	public LodRegion(int regionX, int regionZ)
+	//x coord,
+	private byte minDetailLevel;
+	private static final byte POSSIBLE_LOD = 10;
+	//private int numberOfPoints;
+	//For each of the following field the first slot is for the level of detail
+	//Important: byte have a [-128, 127] range. When converting from or to int a 128 should be added or removed
+	//If there is a bug with color then it's probably caused by this.
+	//in the future other fields like transparency and light level could be added
+
+	private LevelContainer[] dataContainer;
+
+
+	private DistanceGenerationMode generationMode;
+	private VerticalQuality verticalQuality;
+
+	public final int regionPosX;
+	public final int regionPosZ;
+
+	public LodRegion(RegionPos regionPos)
 	{
-		x = regionX;
-		z = regionZ;
-		
-		chunks = new LodChunk[SIZE][SIZE];
+		this.minDetailLevel = LodUtil.REGION_DETAIL_LEVEL;
+		this.regionPosX = regionPos.x;
+		this.regionPosZ = regionPos.z;
+		dataContainer = new LevelContainer[POSSIBLE_LOD];
 	}
-	
-	
+
+	public LodRegion(byte minDetailLevel, RegionPos regionPos, DistanceGenerationMode generationMode, VerticalQuality verticalQuality)
+	{
+		this.minDetailLevel = minDetailLevel;
+		this.regionPosX = regionPos.x;
+		this.regionPosZ = regionPos.z;
+		this.verticalQuality = verticalQuality;
+		this.generationMode = generationMode;
+		dataContainer = new LevelContainer[POSSIBLE_LOD];
+
+
+		// Initialize all the different matrices
+		for (byte lod = minDetailLevel; lod <= LodUtil.REGION_DETAIL_LEVEL; lod++)
+		{
+			switch (verticalQuality)
+			{
+				default:
+				case HEIGHTMAP:
+					dataContainer[lod] = new SingleLevelContainer(lod);
+					break;
+				case MULTI_LOD:
+					dataContainer[lod] = new VerticalLevelContainer(lod);
+					break;
+			}
+		}
+	}
+
+	public VerticalQuality getLodQualityMode()
+	{
+		return verticalQuality;
+	}
+
+	public DistanceGenerationMode getGenerationMode()
+	{
+		return generationMode;
+	}
+
+	public int getMaxVerticalData(byte detailLevel)
+	{
+		return dataContainer[detailLevel].getMaxVerticalData();
+	}
+
 	/**
-	 * Add the given LOD to this region at the coordinate
-	 * stored in the LOD. If an LOD already exists at the given
-	 * coordinates it will be overwritten.
+	 * This method can be used to insert data into the LodRegion
+	 *
+	 * @return if the data was added successfully
 	 */
-	public void addLod(LodChunk lod)
+	public boolean addData(byte detailLevel, int posX, int posZ, int verticalIndex, long data)
 	{
-		// we use ABS since LODs can be negative, but if they are
-		// the region will negative first, therefore we don't have to
-		// store the LOD chunks at negative indexes since we search 
-		// LOD the region first
-		int xIndex = Math.abs(lod.x % SIZE);
-		int zIndex = Math.abs(lod.z % SIZE);
-		
-		chunks[xIndex][zIndex] = lod;
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+
+		// For some reason the dataContainer can contain null entries
+		if (this.dataContainer[detailLevel] == null)
+		{
+			if (verticalQuality == VerticalQuality.HEIGHTMAP)
+				this.dataContainer[detailLevel] = new SingleLevelContainer(detailLevel);
+			else
+				this.dataContainer[detailLevel] = new VerticalLevelContainer(detailLevel);
+		}
+
+		this.dataContainer[detailLevel].addData(data, posX, posZ, verticalIndex);
+
+		return true;
 	}
-	
+
 	/**
-	 * Get the LodChunk at the given X and Z coordinates
-	 * in this region.
-	 * <br>
-	 * Returns null if the LodChunk doesn't exist or 
-	 * is outside the loaded area.
+	 * This method will return the data in the position relative to the level of detail
+	 *
+	 * @return the data at the relative pos and level
 	 */
-	public LodChunk getLod(int chunkX, int chunkZ)
+	public long getData(byte detailLevel, int posX, int posZ, int verticalIndex)
 	{
-		// since we add LOD's with ABS, we get them the same way
-		int arrayX = Math.abs(chunkX % SIZE);
-		int arrayZ = Math.abs(chunkZ % SIZE);
-		
-		if(arrayX >= SIZE || arrayZ >= SIZE)
-			return null;
-		
-		return chunks[arrayX][arrayZ];
+		return dataContainer[detailLevel].getData(posX, posZ, verticalIndex);
 	}
-	
-	
+
 	/**
-	 * Returns all LodChunks in this region
+	 * This method will return the data in the position relative to the level of detail
+	 *
+	 * @return the data at the relative pos and level
 	 */
-	public LodChunk[][] getAllLods()
+	public long getSingleData(byte detailLevel, int posX, int posZ)
 	{
-		return chunks;
+		return dataContainer[detailLevel].getSingleData(posX, posZ);
 	}
-	
-	
-	
+
+	public void clear(byte detailLevel, int posX, int posZ)
+	{
+		dataContainer[detailLevel].clear(posX, posZ);
+	}
+
+	/**
+	 * This method will return all the levelPos that are renderable according to the requisite given in input
+	 *
+	 * @return
+	 */
+	public void getDataToGenerate(PosToGenerateContainer posToGenerate, int playerPosX, int playerPosZ)
+	{
+		getDataToGenerate(posToGenerate, LodUtil.REGION_DETAIL_LEVEL, 0, 0, playerPosX, playerPosZ);
+
+	}
+
+	private void getDataToGenerate(PosToGenerateContainer posToGenerate, byte detailLevel, int posX, int posZ, int playerPosX, int playerPosZ)
+	{
+		int size = 1 << (LodUtil.REGION_DETAIL_LEVEL - detailLevel);
+
+		//here i calculate the the LevelPos is in range
+		//This is important to avoid any kind of hole in the generation
+		//nt minDistance = LevelPosUtil.minDistance(detailLevel, posX + regionPosX * size, posZ + regionPosZ * size, playerPosX, playerPosZ);
+		int maxDistance = LevelPosUtil.maxDistance(detailLevel, posX, posZ, playerPosX, playerPosZ, regionPosX, regionPosZ);
+
+		byte childDetailLevel = (byte) (detailLevel - 1);
+		int childPosX = posX * 2;
+		int childPosZ = posZ * 2;
+
+		int childSize = 1 << (LodUtil.REGION_DETAIL_LEVEL - childDetailLevel);
+		//we have reached the target detail level
+		byte targetDetailLevel = DetailDistanceUtil.getLodGenDetail(DetailDistanceUtil.getGenerationDetailFromDistance(maxDistance)).detailLevel;
+		if (targetDetailLevel > detailLevel)
+		{
+			return;
+		} else if (targetDetailLevel == detailLevel)
+		{
+			if (!doesDataExist(detailLevel, posX, posZ))
+			{
+				posToGenerate.addPosToGenerate(detailLevel, posX + regionPosX * size, posZ + regionPosZ * size);
+			}
+		} else
+		{
+			//we want max a request per chunk. So for lod smaller than chunk we explore only the top rigth child
+			if (detailLevel > LodUtil.CHUNK_DETAIL_LEVEL)
+			{
+				int num = 0;
+				//We take all the children that are not generated to at least the generation level taken in input
+				for (int x = 0; x <= 1; x++)
+				{
+					for (int z = 0; z <= 1; z++)
+					{
+
+						if (!doesDataExist(childDetailLevel, childPosX + x, childPosZ + z))
+						{
+							num++;
+							posToGenerate.addPosToGenerate(childDetailLevel, childPosX + x + regionPosX * childSize, childPosZ + z + regionPosZ * childSize);
+						}
+					}
+				}
+
+				//only if all the children are correctly generated we go deeper
+				if (num == 0)
+				{
+					for (int x = 0; x <= 1; x++)
+					{
+						for (int z = 0; z <= 1; z++)
+						{
+							getDataToGenerate(posToGenerate, childDetailLevel, childPosX + x, childPosZ + z, playerPosX, playerPosZ);
+						}
+					}
+				}
+			} else
+			//now we keep exploring the top right child
+			{
+				if (DetailDistanceUtil.getLodGenDetail(childDetailLevel).detailLevel <= (childDetailLevel))
+				{
+					if (!doesDataExist(childDetailLevel, childPosX, childPosZ))
+					{
+						posToGenerate.addPosToGenerate(childDetailLevel, childPosX + regionPosX * childSize, childPosZ + regionPosZ * childSize);
+					} else
+					{
+						getDataToGenerate(posToGenerate, childDetailLevel, childPosX, childPosZ, playerPosX, playerPosZ);
+					}
+				}
+			}
+		}
+	}
+
+
+	/**
+	 * @return
+	 */
+	public void getDataToRender(PosToRenderContainer posToRender, int playerPosX, int playerPosZ, boolean requireCorrectDetailLevel)
+	{
+		getDataToRender(posToRender, LodUtil.REGION_DETAIL_LEVEL, 0, 0, playerPosX, playerPosZ, requireCorrectDetailLevel);
+	}
+
+	/**
+	 * @return
+	 */
+	private void getDataToRender(PosToRenderContainer posToRender, byte detailLevel, int posX, int posZ, int playerPosX, int playerPosZ, boolean requireCorrectDetailLevel)
+	{
+		int size = 1 << (LodUtil.REGION_DETAIL_LEVEL - detailLevel);
+
+		//here i calculate the the LevelPos is in range
+		//This is important to avoid any kind of hole in the rendering
+		byte supposedLevel;
+		int maxDistance;
+		boolean stopNow = false;
+		int minDistance;
+		int childLevel;
+		switch (LodConfig.CLIENT.graphics.detailDropOff.get())
+		{
+			default:
+			case BY_CHUNK:
+				maxDistance = LevelPosUtil.maxDistance(detailLevel, posX, posZ, playerPosX, playerPosZ, regionPosX, regionPosZ);
+				supposedLevel = DetailDistanceUtil.getLodDrawDetail(DetailDistanceUtil.getDrawDetailFromDistance(maxDistance));
+				minDistance = LevelPosUtil.minDistance(detailLevel, posX, posZ, playerPosX, playerPosZ, regionPosX, regionPosZ);
+				childLevel = DetailDistanceUtil.getLodDrawDetail(DetailDistanceUtil.getDrawDetailFromDistance(minDistance));
+				stopNow = detailLevel == childLevel - 1;
+
+				break;
+			case BY_REGION_FANCY:
+				supposedLevel = minDetailLevel;
+				break;
+			case BY_REGION_FAST:
+				int playerRegionX = LevelPosUtil.getRegion(LodUtil.BLOCK_DETAIL_LEVEL, playerPosX);
+				int playerRegionZ = LevelPosUtil.getRegion(LodUtil.BLOCK_DETAIL_LEVEL, playerPosZ);
+				if (playerRegionX == regionPosX && playerRegionZ == regionPosZ)
+				{
+					maxDistance = LevelPosUtil.maxDistance(detailLevel, posX, posZ, playerPosX, playerPosZ, regionPosX, regionPosZ);
+					supposedLevel = DetailDistanceUtil.getLodDrawDetail(DetailDistanceUtil.getDrawDetailFromDistance(maxDistance));
+					minDistance = LevelPosUtil.minDistance(detailLevel, posX, posZ, playerPosX, playerPosZ, regionPosX, regionPosZ);
+					childLevel = DetailDistanceUtil.getLodDrawDetail(DetailDistanceUtil.getDrawDetailFromDistance(minDistance));
+					stopNow = detailLevel == childLevel - 1;
+				} else
+				{
+					maxDistance = LevelPosUtil.maxDistance(LodUtil.REGION_DETAIL_LEVEL, regionPosX, regionPosZ, playerRegionX * 512 + 256, playerRegionZ * 512 + 256);
+					supposedLevel = DetailDistanceUtil.getLodDrawDetail(DetailDistanceUtil.getDrawDetailFromDistance(maxDistance));
+				}
+				break;
+		}
+
+		if (stopNow)
+		{
+			posToRender.addPosToRender(detailLevel,
+					posX + regionPosX * size,
+					posZ + regionPosZ * size);
+		} else if (supposedLevel > detailLevel)
+		{
+			return;
+		} else if (supposedLevel == detailLevel)
+		{
+			posToRender.addPosToRender(detailLevel,
+					posX + regionPosX * size,
+					posZ + regionPosZ * size);
+		} else //case where (detailLevel > supposedLevel)
+		{
+			int childPosX = posX * 2;
+			int childPosZ = posZ * 2;
+			byte childDetailLevel = (byte) (detailLevel - 1);
+			int childrenCount = 0;
+			for (int x = 0; x <= 1; x++)
+			{
+				for (int z = 0; z <= 1; z++)
+				{
+					if (doesDataExist(childDetailLevel, childPosX + x, childPosZ + z))
+					{
+						if (!requireCorrectDetailLevel)
+						{
+							childrenCount++;
+						} else
+						{
+							getDataToRender(posToRender, childDetailLevel, childPosX + x, childPosZ + z, playerPosX, playerPosZ, requireCorrectDetailLevel);
+						}
+					}
+				}
+			}
+
+			//If all the four children exist we go deeper
+
+			if (!requireCorrectDetailLevel)
+			{
+				if (childrenCount == 4)
+				{
+					for (int x = 0; x <= 1; x++)
+					{
+						for (int z = 0; z <= 1; z++)
+						{
+							getDataToRender(posToRender, childDetailLevel, childPosX + x, childPosZ + z, playerPosX, playerPosZ, requireCorrectDetailLevel);
+						}
+					}
+				} else
+				{
+					posToRender.addPosToRender(detailLevel,
+							posX + regionPosX * size,
+							posZ + regionPosZ * size);
+				}
+			}
+		}
+	}
+
+	/**
+	 *
+	 */
+	public void updateArea(byte detailLevel, int posX, int posZ)
+	{
+		int width;
+		int startX;
+		int startZ;
+		for (byte bottom = (byte) (minDetailLevel + 1); bottom <= detailLevel; bottom++)
+		{
+			startX = LevelPosUtil.convert(detailLevel, posX, bottom);
+			startZ = LevelPosUtil.convert(detailLevel, posZ, bottom);
+			width = 1 << (detailLevel - bottom);
+			for (int x = 0; x < width; x++)
+			{
+				for (int z = 0; z < width; z++)
+				{
+					update(bottom, startX + x, startZ + z);
+				}
+			}
+		}
+		for (byte up = (byte) (detailLevel + 1); up <= LodUtil.REGION_DETAIL_LEVEL; up++)
+		{
+			update(up,
+					LevelPosUtil.convert(detailLevel, posX, up),
+					LevelPosUtil.convert(detailLevel, posZ, up));
+		}
+	}
+
+	/**
+	 *
+	 */
+	private void update(byte detailLevel, int posX, int posZ)
+	{
+		dataContainer[detailLevel].updateData(dataContainer[detailLevel - 1], posX, posZ);
+	}
+
+
+	/**
+	 * @return
+	 */
+	public boolean doesDataExist(byte detailLevel, int posX, int posZ)
+	{
+		if (detailLevel < minDetailLevel) return false;
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		if (dataContainer == null || dataContainer[detailLevel] == null)
+			return false;
+		return dataContainer[detailLevel].doesItExist(posX, posZ);
+	}
+
+	/**
+	 * @return
+	 */
+	public byte getGenerationMode(byte detailLevel, int posX, int posZ)
+	{
+		if (dataContainer[detailLevel].doesItExist(posX, posZ))
+		{
+			//We take the bottom information always
+			return DataPointUtil.getGenerationMode(dataContainer[detailLevel].getSingleData(posX, posZ));
+		} else
+		{
+			return DistanceGenerationMode.NONE.complexity;
+		}
+	}
+
+	public byte getMinDetailLevel()
+	{
+		return minDetailLevel;
+	}
+
+	/**
+	 * This will be used to save a level
+	 *
+	 * @param detailLevel
+	 * @return
+	 */
+	public LevelContainer getLevel(byte detailLevel)
+	{
+		if (detailLevel < minDetailLevel)
+		{
+			throw new IllegalArgumentException("getLevel asked for a level that does not exist: minimum " + minDetailLevel + " level requested " + detailLevel);
+		}
+		return dataContainer[detailLevel];
+	}
+
+	/**
+	 * @param levelContainer
+	 */
+	public void addLevel(LevelContainer levelContainer)
+	{
+		if (levelContainer.getDetailLevel() < minDetailLevel - 1)
+		{
+			throw new IllegalArgumentException("addLevel requires a level that is at least the minimum level of the region -1 ");
+		}
+		if (levelContainer.getDetailLevel() == minDetailLevel - 1) minDetailLevel = levelContainer.getDetailLevel();
+		dataContainer[levelContainer.getDetailLevel()] = levelContainer;
+
+	}
+
+	/**
+	 * @param detailLevel
+	 */
+	public void cutTree(byte detailLevel)
+	{
+		if (minDetailLevel < detailLevel)
+		{
+			for (byte tempLod = 0; tempLod < detailLevel; tempLod++)
+			{
+				dataContainer[tempLod] = null;
+			}
+			minDetailLevel = detailLevel;
+		}
+	}
+
+	/**
+	 * @param detailLevel
+	 */
+	public void expand(byte detailLevel)
+	{
+		if (detailLevel < minDetailLevel)
+		{
+			for (byte tempLod = (byte) (minDetailLevel - 1); tempLod >= detailLevel; tempLod--)
+			{
+				if (dataContainer[tempLod + 1] == null)
+				{
+					dataContainer[tempLod + 1] = new SingleLevelContainer((byte) (tempLod + 1));
+				}
+				dataContainer[tempLod] = dataContainer[tempLod + 1].expand();
+			}
+			minDetailLevel = detailLevel;
+		}
+	}
+
+	/**
+	 * return RegionPos of this lod region
+	 */
+	public RegionPos getRegionPos()
+	{
+		return new RegionPos(regionPosX, regionPosZ);
+	}
+
+	/**
+	 * return needed memory in byte
+	 *
+	 * @param template
+	 */
+	public int getMinMemoryNeeded(LodTemplate template)
+	{
+		int count = 0;
+		for (byte tempLod = LodUtil.REGION_DETAIL_LEVEL; tempLod > minDetailLevel; tempLod--)
+		{
+			//i'm doing a upper limit of the minimum
+			//Color should be just 3 byte but i'm gonna calculate as 12 byte
+			//Height and depth should be just 4 byte but i'm gonna calculate as 8 byte
+			count += dataContainer[tempLod].getMaxMemoryUse() * template.getBufferMemoryForSingleLod(dataContainer[tempLod].getMaxVerticalData());
+			//count += Math.pow(2, LodUtil.REGION_DETAIL_LEVEL - tempLod) * (24 + 8 + 8 + 8 + 8);
+		}
+		return count;
+	}
+
 	@Override
 	public String toString()
 	{
-		String s = "";
-		
-		s += "x: " + x + " z: " + z + "\t";
-		
-		return s;
+		return getLevel(LodUtil.REGION_DETAIL_LEVEL).toString();
+	}
+
+	public int getNumberOfLods()
+	{
+		int count = 0;
+		for (LevelContainer container : dataContainer)
+			count += container.getMaxNumberOfLods();
+		return count;
 	}
 }

src/main/java/com/seibel/lod/objects/LodWorld.java

@@ -1,58 +1,83 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.seibel.lod.objects;
 
 import java.util.Hashtable;
 import java.util.Map;
 
+import com.seibel.lod.proxy.ClientProxy;
+
 import net.minecraft.world.DimensionType;
 
 /**
  * This stores all LODs for a given world.
- * 
+ *
  * @author James Seibel
- * @version 04-01-2021
+ * @author Leonardo Amato
+ * @version 8-17-2021
  */
 public class LodWorld
 {
 	private String worldName;
-	
+
 	private Map<DimensionType, LodDimension> lodDimensions;
-	/** If true then the LOD world is setup and ready to use */
+
+	/**
+	 * If true then the LOD world is setup and ready to use
+	 */
 	private boolean isWorldLoaded = false;
-	
+
 	public static final String NO_WORLD_LOADED = "No world loaded";
-	
+
+
 	public LodWorld()
 	{
 		worldName = NO_WORLD_LOADED;
 	}
-	
+
 	/**
-	 * Set up the LodWorld with the given newWorldName. <br>
+	 * Set up the LodQuadTreeWorld with the given newWorldName. <br>
 	 * This should be done whenever loading a new world.
-	 * @param newWorldName
+	 *
+	 * @param newWorldName name of the world
 	 */
 	public void selectWorld(String newWorldName)
 	{
-		if(newWorldName.isEmpty())
+		if (newWorldName.isEmpty())
 		{
 			deselectWorld();
 			return;
 		}
-		
+
 		if (worldName.equals(newWorldName))
 			// don't recreate everything if we
 			// didn't actually change worlds
 			return;
-		
+
 		worldName = newWorldName;
 		lodDimensions = new Hashtable<DimensionType, LodDimension>();
 		isWorldLoaded = true;
 	}
-	
+
 	/**
 	 * Set the worldName to "No world loaded"
 	 * and clear the lodDimensions Map. <br>
-	 * This should be done whenever unloaded a world. 
+	 * This should be done whenever unloaded a world.
 	 */
 	public void deselectWorld()
 	{
@@ -60,51 +85,75 @@ public class LodWorld
 		lodDimensions = null;
 		isWorldLoaded = false;
 	}
-	
-	
+
+
+	/**
+	 * Adds newStorage to this world, if a LodQuadTreeDimension
+	 * already exists for the given dimension it is replaced.
+	 */
 	public void addLodDimension(LodDimension newStorage)
 	{
 		if (lodDimensions == null)
-			throw new IllegalStateException("LodWorld hasn't been given a world yet.");
-		
+			return;
+
 		lodDimensions.put(newStorage.dimension, newStorage);
 	}
-	
+
+	/**
+	 * Returns null if no LodQuadTreeDimension exists for the given dimension
+	 */
 	public LodDimension getLodDimension(DimensionType dimension)
 	{
 		if (lodDimensions == null)
-			throw new IllegalStateException("LodWorld hasn't been given a world yet.");
-		
+			return null;
+
 		return lodDimensions.get(dimension);
 	}
-	
+
 	/**
 	 * Resizes the max width in regions that each LodDimension
-	 * should use. 
+	 * should use.
 	 */
 	public void resizeDimensionRegionWidth(int newWidth)
 	{
 		if (lodDimensions == null)
-			throw new IllegalStateException("LodWorld hasn't been given a world yet.");
-		
-		for(DimensionType key : lodDimensions.keySet())
+			return;
+
+		saveAllDimensions();
+
+		for (DimensionType key : lodDimensions.keySet())
 			lodDimensions.get(key).setRegionWidth(newWidth);
 	}
-	
-	
+
+	/**
+	 * Requests all dimensions save any dirty regions they may have.
+	 */
+	public void saveAllDimensions()
+	{
+		if (lodDimensions == null)
+			return;
+
+		ClientProxy.LOGGER.info("Saving LODs");
+
+		for (DimensionType key : lodDimensions.keySet())
+			lodDimensions.get(key).saveDirtyRegionsToFileAsync();
+	}
+
+
 	public boolean getIsWorldLoaded()
 	{
 		return isWorldLoaded;
 	}
-	
+
 	public String getWorldName()
 	{
 		return worldName;
 	}
-	
+
 	@Override
 	public String toString()
 	{
 		return "World name: " + worldName;
 	}
 }
+

src/main/java/com/seibel/lod/objects/NearFarBuffer.java

@@ -1,28 +0,0 @@
-package com.seibel.lod.objects;
-
-import net.minecraft.client.renderer.BufferBuilder;
-
-/**
- * This object is just a replacement for an array
- * to make things easier to understand in the LodRenderer
- * and BuildBufferThread.
- * 
- * @author James Seibel
- * @version 03-25-2021
- */
-public class NearFarBuffer
-{
-	public BufferBuilder nearBuffer;
-	
-	public BufferBuilder farBuffer;
-	
-	/**
-	 * @param newNearBuffer
-	 * @param newFarBuffer
-	 */
-	public NearFarBuffer(BufferBuilder newNearBuffer, BufferBuilder newFarBuffer)
-	{
-		nearBuffer = newNearBuffer;
-		farBuffer = newFarBuffer;
-	}
-}

src/main/java/com/seibel/lod/objects/NearFarFogSetting.java

@@ -1,28 +0,0 @@
-package com.seibel.lod.objects;
-
-import com.seibel.lod.enums.FogDistance;
-
-/**
- * This object is just a replacement for an array
- * to make things easier to understand in the LodRenderer.
- * 
- * @author James Seibel
- * @version 02-27-2021
- */
-public class NearFarFogSetting
-{
-	public FogDistance nearFogSetting = FogDistance.NEAR;
-	public FogDistance farFogSetting = FogDistance.FAR;
-	
-	
-	public NearFarFogSetting()
-	{
-		
-	}
-	
-	public NearFarFogSetting(FogDistance newNearFogSetting, FogDistance newFarFogSetting)
-	{
-		nearFogSetting = newNearFogSetting;
-		farFogSetting = newFarFogSetting;
-	}
-}

src/main/java/com/seibel/lod/objects/NearFarFogSettings.java

@@ -0,0 +1,63 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.objects;
+
+import com.seibel.lod.enums.FogDistance;
+import com.seibel.lod.enums.FogQuality;
+
+/**
+ * This object is just a replacement for an array
+ * to make things easier to understand in the LodRenderer.
+ * 
+ * @author James Seibel
+ * @version 7-03-2021
+ */
+public class NearFarFogSettings
+{
+	public NearOrFarSetting near = new NearOrFarSetting(FogDistance.NEAR);
+	public NearOrFarSetting far = new NearOrFarSetting(FogDistance.FAR);
+	
+	/** If true that means Minecraft is
+	 * rendering fog along side us */
+	public boolean vanillaIsRenderingFog = true;
+	
+	public NearFarFogSettings()
+	{
+		
+	}
+	
+	
+	
+	/**
+	 * This holds all relevant data to rendering fog at either
+	 * near or far distances.
+	 */
+	public class NearOrFarSetting
+	{
+		public FogQuality quality = FogQuality.FANCY;
+		public FogDistance distance = FogDistance.FAR;
+		
+		/** If true this section should render with fog */
+		public boolean enabled = true;
+		
+		public NearOrFarSetting(FogDistance newFogDistance)
+		{
+			distance = newFogDistance;
+		}
+	}
+}

src/main/java/com/seibel/lod/objects/PosToGenerateContainer.java

@@ -0,0 +1,170 @@
+package com.seibel.lod.objects;
+
+import com.seibel.lod.util.LevelPosUtil;
+
+public class PosToGenerateContainer
+{
+	private int playerPosX;
+	private int playerPosZ;
+	private byte farMinDetail;
+	private int maxSize;
+	private int maxNearSize;
+	private int maxFarSize;
+	private int nearSize;
+	private int farSize;
+	private int[][] nearPosToGenerate;
+	private int[][] farPosToGenerate;
+
+
+	public PosToGenerateContainer(byte farMinDetail, int maxDataToGenerate, int maxFarDataToGenerate, int playerPosX, int playerPosZ)
+	{
+		this.playerPosX = playerPosX;
+		this.playerPosZ = playerPosZ;
+		this.farMinDetail = farMinDetail;
+		maxNearSize = maxDataToGenerate-maxFarDataToGenerate;
+		maxFarSize = maxFarDataToGenerate;
+		maxSize = maxDataToGenerate;
+		nearSize = 0;
+		farSize = 0;
+		nearPosToGenerate = new int[maxDataToGenerate][4];
+		farPosToGenerate = new int[maxDataToGenerate][4];
+	}
+
+	public void addPosToGenerate(byte detailLevel, int posX, int posZ)
+	{
+		int distance = LevelPosUtil.minDistance(detailLevel, posX, posZ, playerPosX, playerPosZ);
+		int index;
+		if (detailLevel >= farMinDetail)
+		{//We are introducing a position in the far array
+
+			if(farSize < farPosToGenerate.length)
+				farSize++;
+			index = farSize;
+			//while (index > 0 && LevelPosUtil.compareDistance(distance, farPosToGenerate[index - 1][3]) <= 0)
+			while (index > 0 && LevelPosUtil.compareDistance(distance, farPosToGenerate[index - 1][3]) <= 0)
+			{
+				farPosToGenerate[index][0] = farPosToGenerate[index - 1][0];
+				farPosToGenerate[index][1] = farPosToGenerate[index - 1][1];
+				farPosToGenerate[index][2] = farPosToGenerate[index - 1][2];
+				farPosToGenerate[index][3] = farPosToGenerate[index - 1][3];
+				index--;
+			}
+			if (index != farSize-1 || farSize != farPosToGenerate.length)
+			{
+				farPosToGenerate[index][0] = detailLevel + 1;
+				farPosToGenerate[index][1] = posX;
+				farPosToGenerate[index][2] = posZ;
+				farPosToGenerate[index][3] = distance;
+			}
+		} else
+		{//We are introducing a position in the near array
+			if(nearSize < nearPosToGenerate.length)
+				nearSize++;
+			index = nearSize-1;
+			while (index > 0 && LevelPosUtil.compareDistance(distance, nearPosToGenerate[index - 1][3]) <= 0)
+			{
+				nearPosToGenerate[index][0] = nearPosToGenerate[index - 1][0];
+				nearPosToGenerate[index][1] = nearPosToGenerate[index - 1][1];
+				nearPosToGenerate[index][2] = nearPosToGenerate[index - 1][2];
+				nearPosToGenerate[index][3] = nearPosToGenerate[index - 1][3];
+				index--;
+			}
+			if (index != nearSize-1 || nearSize != nearPosToGenerate.length)
+			{
+				nearPosToGenerate[index][0] = detailLevel + 1;
+				nearPosToGenerate[index][1] = posX;
+				nearPosToGenerate[index][2] = posZ;
+				nearPosToGenerate[index][3] = distance;
+			}
+		}
+	}
+
+	public int getNumberOfPos()
+	{
+		return nearSize+farSize;
+	}
+
+	public int getNumberOfNearPos()
+	{
+		return nearSize;
+	}
+
+	public int getNumberOfFarPos()
+	{
+		return farSize;
+	}
+
+	public int getNthDetail(int n, boolean near)
+	{
+		if (near)
+			return nearPosToGenerate[n][0];
+		else
+			return farPosToGenerate[n][0];
+	}
+	public int getNthPosX(int n, boolean near)
+	{
+		if (near)
+			return nearPosToGenerate[n][1];
+		else
+			return farPosToGenerate[n][1];
+	}
+	public int getNthPosZ(int n, boolean near)
+	{
+		if (near)
+			return nearPosToGenerate[n][2];
+		else
+			return farPosToGenerate[n][2];
+	}
+	public int getNthGeneration(int n, boolean near)
+	{
+		if (near)
+			return nearPosToGenerate[n][3];
+		else
+			return farPosToGenerate[n][3];
+	}
+
+	public String toString()
+	{/*
+		StringBuilder builder = new StringBuilder();
+		builder.append("Number of pos to generate ");
+		builder.append(farSize + nearSize);
+		builder.append('\n');
+		builder.append("Number of near pos to generate ");
+		builder.append(nearSize);
+		builder.append('\n');
+		builder.append("Number of far pos to generate ");
+		builder.append(farSize);
+		builder.append('\n');
+		builder.append('\n');
+		builder.append("near pos to generate");
+		builder.append('\n');
+		for (int i = 0; i < nearSize; i++)
+		{
+			builder.append(posToGenerate[i][0]-1);
+			builder.append(" ");
+			builder.append(posToGenerate[i][1]);
+			builder.append(" ");
+			builder.append(posToGenerate[i][2]);
+			builder.append(" ");
+			builder.append(posToGenerate[i][3]);
+			builder.append('\n');
+		}
+		builder.append('\n');
+		builder.append("far pos to generate");
+		builder.append('\n');
+		for (int i = maxSize - 1; i >= maxSize - farSize; i--)
+		{
+			builder.append(posToGenerate[i][0]-1);
+			builder.append(" ");
+			builder.append(posToGenerate[i][1]);
+			builder.append(" ");
+			builder.append(posToGenerate[i][2]);
+			builder.append(" ");
+			builder.append(posToGenerate[i][3]);
+			builder.append('\n');
+		}
+		builder.append('\n');
+		return builder.toString();*/
+		return " ";
+	}
+}

src/main/java/com/seibel/lod/objects/PosToRenderContainer.java

@@ -0,0 +1,126 @@
+package com.seibel.lod.objects;
+
+import com.seibel.lod.proxy.ClientProxy;
+import com.seibel.lod.util.LevelPosUtil;
+import com.seibel.lod.util.LodUtil;
+
+import java.util.Arrays;
+
+/**
+ * 
+ * @author Leonardo Amato
+ * @version 9-18-2021
+ */
+public class PosToRenderContainer
+{
+	public byte minDetail;
+	private int size;
+	private int regionPosX;
+	private int regionPosZ;
+	private int numberOfPosToRender;
+	private int[] posToRender;
+	/*TODO this population matrix could be converted to boolean to improve memory use*/
+	private byte[][] population;
+
+	public PosToRenderContainer(byte minDetail, int regionPosX, int regionPosZ)
+	{
+		this.minDetail = minDetail;
+		this.numberOfPosToRender = 0;
+		this.regionPosX = regionPosX;
+		this.regionPosZ = regionPosZ;
+		this.size = 1 << (LodUtil.REGION_DETAIL_LEVEL - minDetail);
+		posToRender = new int[size*size*3];
+		population = new byte[size][size];
+	}
+
+	public void addPosToRender(byte detailLevel, int posX, int posZ)
+	{
+		// When rapidly changing dimensions the bufferBuidler can cause this,
+		// James isn't sure why, but this will prevent an exception at
+		// the very least (while stilling logging the problem). 
+		if (numberOfPosToRender >= posToRender.length)
+		{
+			// This is might be due to dimensions having a different width
+			// when first loading in
+			ClientProxy.LOGGER.error("Unable to addPosToRender. numberOfPosToRender [" + numberOfPosToRender +"] detailLevel [" + detailLevel + "] Pos [" + posX + "," + posZ + "]");
+			numberOfPosToRender++; // incrementing so we can see how many pos over the limit we would go
+			return;
+		}
+		
+		//if(numberOfPosToRender >= posToRender.length)
+		//	posToRender = Arrays.copyOf(posToRender, posToRender.length*2);
+		posToRender[numberOfPosToRender*3 + 0] = detailLevel;
+		posToRender[numberOfPosToRender*3 + 1] = posX;
+		posToRender[numberOfPosToRender*3 + 2] = posZ;
+		numberOfPosToRender++;
+		population[LevelPosUtil.getRegionModule(minDetail, LevelPosUtil.convert(detailLevel,posX,minDetail))]
+				[LevelPosUtil.getRegionModule(minDetail, LevelPosUtil.convert(detailLevel,posZ,minDetail))] = (byte) (detailLevel + 1);
+	}
+
+	public boolean contains(byte detailLevel, int posX, int posZ)
+	{
+		if(LevelPosUtil.getRegion(detailLevel, posX) == regionPosX && LevelPosUtil.getRegion(detailLevel, posZ) == regionPosZ)
+		{
+			return (population[LevelPosUtil.getRegionModule(minDetail, LevelPosUtil.convert(detailLevel,posX,minDetail))]
+					        [LevelPosUtil.getRegionModule(minDetail, LevelPosUtil.convert(detailLevel,posZ,minDetail))] == (detailLevel + 1));
+		}else
+		{
+			return false;
+		}
+	}
+	public void clear(byte minDetail, int regionPosX, int regionPosZ){
+		this.numberOfPosToRender = 0;
+		this.regionPosX = regionPosX;
+		this.regionPosZ = regionPosZ;
+		if(this.minDetail == minDetail)
+		{
+			Arrays.fill(posToRender, 0);
+			for(int i = 0; i< population.length; i++)
+				Arrays.fill(population[i], (byte) 0);
+		}else{
+			this.minDetail = minDetail;
+			int size = 1 << (LodUtil.REGION_DETAIL_LEVEL - minDetail);
+			posToRender = new int[size*size*3];
+			population = new byte[size][size];
+		}
+	}
+
+	public int getNumberOfPos()
+	{
+		return numberOfPosToRender;
+	}
+
+	public byte getNthDetailLevel(int n)
+	{
+		return (byte) posToRender[n*3 + 0];
+	}
+	public int getNthPosX(int n)
+	{
+		return posToRender[n*3 + 1];
+	}
+	public int getNthPosZ(int n)
+	{
+		return posToRender[n*3 + 2];
+	}
+
+	@Override
+	public String toString()
+	{
+
+		StringBuilder builder = new StringBuilder();
+		builder.append("To render ");
+		builder.append(numberOfPosToRender);
+		builder.append('\n');
+		for(int i = 0; i < numberOfPosToRender; i++)
+		{
+			builder.append(posToRender[i*3 + 0]);
+			builder.append(" ");
+			builder.append(posToRender[i*3 + 1]);
+			builder.append(" ");
+			builder.append(posToRender[i*3 + 2]);
+			builder.append('\n');
+		}
+		builder.append('\n');
+		return builder.toString();
+	}
+}

src/main/java/com/seibel/lod/objects/RegionPos.java

@@ -1,20 +1,42 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.seibel.lod.objects;
 
+import com.seibel.lod.util.LodUtil;
+
+import net.minecraft.util.math.BlockPos;
+import net.minecraft.util.math.ChunkPos;
+
 /**
  * This object is similar to ChunkPos or BlockPos.
- * 
+ *
  * @author James Seibel
- * @version 03-19-2021
+ * @version 8-21-2021
  */
 public class RegionPos
 {
 	public int x;
 	public int z;
-	
-	
+
+
 	/**
 	 * Default Constructor <br>
-	 * 
+	 * <p>
 	 * Sets x and z to 0
 	 */
 	public RegionPos()
@@ -22,10 +44,44 @@ public class RegionPos
 		x = 0;
 		z = 0;
 	}
-	
+
 	public RegionPos(int newX, int newZ)
 	{
 		x = newX;
 		z = newZ;
 	}
+
+	public RegionPos(BlockPos pos)
+	{
+		this(new ChunkPos(pos));
+	}
+
+	public RegionPos(ChunkPos pos)
+	{
+		x = Math.floorDiv(pos.x, LodUtil.REGION_WIDTH_IN_CHUNKS);
+		z = Math.floorDiv(pos.z, LodUtil.REGION_WIDTH_IN_CHUNKS);
+	}
+
+	/**
+	 * Returns the ChunkPos at the center of this region
+	 */
+	public ChunkPos chunkPos()
+	{
+		return new ChunkPos((x * LodUtil.REGION_WIDTH_IN_CHUNKS) + LodUtil.REGION_WIDTH_IN_CHUNKS / 2, (z * LodUtil.REGION_WIDTH_IN_CHUNKS) + LodUtil.REGION_WIDTH_IN_CHUNKS / 2);
+	}
+
+	/**
+	 * Returns the BlockPos at the center of this region
+	 */
+	public BlockPos blockPos()
+	{
+		return chunkPos().getWorldPosition().offset(LodUtil.CHUNK_WIDTH / 2, 0, LodUtil.CHUNK_WIDTH / 2);
+	}
+
+
+	@Override
+	public String toString()
+	{
+		return "(" + x + "," + z + ")";
+	}
 }

src/main/java/com/seibel/lod/objects/SingleLevelContainer.java

@@ -0,0 +1,193 @@
+package com.seibel.lod.objects;
+
+import com.seibel.lod.util.*;
+
+import javax.xml.crypto.Data;
+import java.util.Arrays;
+
+public class SingleLevelContainer implements LevelContainer
+{
+	public final byte detailLevel;
+	public final int size;
+
+	public final long[][] dataContainer;
+
+	public SingleLevelContainer(byte detailLevel)
+	{
+		this.detailLevel = detailLevel;
+		size = 1 << (LodUtil.REGION_DETAIL_LEVEL - detailLevel);
+		dataContainer = new long[size][size];
+	}
+
+	public void clear(int posX, int posZ)
+	{
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		dataContainer[posX][posZ] = DataPointUtil.EMPTY_DATA;
+	}
+
+	public boolean addData(long data, int posX, int posZ, int index)
+	{
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		dataContainer[posX][posZ] = data;
+		return true;
+	}
+
+	public boolean addSingleData(long newData, int posX, int posZ)
+	{
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		dataContainer[posX][posZ] = newData;
+		return true;
+	}
+
+	public long getData(int posX, int posZ, int index)
+	{
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		//Improve this using a thread map to long[]
+		return dataContainer[posX][posZ];
+	}
+
+	public long getSingleData(int posX, int posZ)
+	{
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		//Improve this using a thread map to long[]
+		return dataContainer[posX][posZ];
+	}
+
+	public byte getDetailLevel()
+	{
+		return detailLevel;
+	}
+
+	public LevelContainer expand()
+	{
+		return new SingleLevelContainer((byte) (getDetailLevel() - 1));
+	}
+
+	public SingleLevelContainer(byte[] inputData)
+	{
+		int tempIndex;
+		int index = 0;
+		long newData;
+		detailLevel = inputData[index];
+		index++;
+		size = (int) Math.pow(2, LodUtil.REGION_DETAIL_LEVEL - detailLevel);
+		this.dataContainer = new long[size][size];
+		for (int x = 0; x < size; x++)
+		{
+			for (int z = 0; z < size; z++)
+			{
+				newData = 0;
+				if (inputData[index] == 0)
+					index++;
+				else if (inputData[index] == 3)
+				{
+					newData = 3;
+					index++;
+				} else if (index + 7 >= inputData.length)
+					break;
+				else
+				{
+					for (tempIndex = 0; tempIndex < 8; tempIndex++)
+						newData += (((long) inputData[index + tempIndex]) & 0xff) << (8 * tempIndex);
+					index = index + 8;
+				}
+				dataContainer[x][z] = newData;
+
+			}
+		}
+	}
+
+	public void updateData(LevelContainer lowerLevelContainer, int posX, int posZ)
+	{
+		//We reset the array
+		long[] dataToMerge = ThreadMapUtil.getSingleUpdateArray();
+
+		int childPosX;
+		int childPosZ;
+		long data;
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		for (int x = 0; x <= 1; x++)
+		{
+			for (int z = 0; z <= 1; z++)
+			{
+				childPosX = 2 * posX + x;
+				childPosZ = 2 * posZ + z;
+				dataToMerge[2 * x + z] = lowerLevelContainer.getSingleData(childPosX, childPosZ);
+			}
+		}
+		data = DataPointUtil.mergeSingleData(dataToMerge);
+		addSingleData(data, posX, posZ);
+	}
+
+	public int getMaxVerticalData()
+	{
+		return 1;
+	}
+
+	public boolean doesItExist(int posX, int posZ)
+	{
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		//Improve this using a thread map to long[]
+		return DataPointUtil.doesItExist(getSingleData(posX, posZ));
+	}
+
+	public byte[] toDataString()
+	{
+		int index = 0;
+		int tempIndex;
+		byte[] tempData = ThreadMapUtil.getSaveContainer();
+		if (tempData == null || tempData.length != (1 + (size * size * 8)))
+			tempData = new byte[1 + (size * size * 8)];
+		else
+			Arrays.fill(tempData, (byte) 0);
+		tempData[index] = detailLevel;
+		index++;
+		for (int x = 0; x < size; x++)
+		{
+			for (int z = 0; z < size; z++)
+			{
+				if (dataContainer[x][z] == 0)
+				{
+					tempData[index] = 0;
+					index++;
+				} else if (dataContainer[x][z] == 3)
+				{
+					tempData[index] = 3;
+					index++;
+				} else
+				{
+					for (tempIndex = 0; tempIndex < 8; tempIndex++)
+						tempData[index + tempIndex] = (byte) (dataContainer[x][z] >>> (8 * tempIndex));
+					index += 8;
+				}
+			}
+		}
+		return Arrays.copyOfRange(tempData, 0, index);
+	}
+
+	@Override
+	public String toString()
+	{
+		StringBuilder stringBuilder = new StringBuilder();
+		stringBuilder.append(detailLevel);
+		return stringBuilder.toString();
+	}
+
+
+	public int getMaxNumberOfLods()
+	{
+		return size * size * getMaxVerticalData();
+	}
+
+	public int getMaxMemoryUse()
+	{
+		return getMaxNumberOfLods() * 2; //2 byte
+	}
+}

src/main/java/com/seibel/lod/objects/VerticalLevelContainer.java

@@ -0,0 +1,253 @@
+package com.seibel.lod.objects;
+
+import com.seibel.lod.util.*;
+
+import java.util.Arrays;
+
+public class VerticalLevelContainer implements LevelContainer
+{
+
+	public final byte detailLevel;
+	public final int size;
+	public final int maxVerticalData;
+
+	public final long[] dataContainer;
+
+	public VerticalLevelContainer(byte detailLevel)
+	{
+		this.detailLevel = detailLevel;
+		size = 1 << (LodUtil.REGION_DETAIL_LEVEL - detailLevel);
+		maxVerticalData = DetailDistanceUtil.getMaxVerticalData(detailLevel);
+		dataContainer = new long[size * size * DetailDistanceUtil.getMaxVerticalData(detailLevel)];
+	}
+
+	@Override
+	public byte getDetailLevel()
+	{
+		return detailLevel;
+	}
+
+	public void clear(int posX, int posZ){
+
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		for(int verticalIndex = 0; verticalIndex < maxVerticalData; verticalIndex++){
+			dataContainer[posX*size*maxVerticalData + posZ*maxVerticalData + verticalIndex] = DataPointUtil.EMPTY_DATA;
+		}
+	}
+
+	public boolean addData(long data, int posX, int posZ, int verticalIndex){
+
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		dataContainer[posX*size*maxVerticalData + posZ*maxVerticalData + verticalIndex] = data;
+		return true;
+	}
+
+	public boolean addSingleData(long data, int posX, int posZ){
+		return addData(data, posX, posZ, 0);
+	}
+
+	public long getData(int posX, int posZ, int verticalIndex){
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		return dataContainer[posX*size*maxVerticalData + posZ*maxVerticalData + verticalIndex];
+	}
+
+	public long getSingleData(int posX, int posZ){
+		return getData(posX,posZ,0);
+	}
+
+	public int getMaxVerticalData(){
+		return maxVerticalData;
+	}
+
+	public int getSize(){
+		return size;
+	}
+
+	public boolean doesItExist(int posX, int posZ){
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		return DataPointUtil.doesItExist(getSingleData(posX,posZ));
+	}
+
+	public VerticalLevelContainer(byte[] inputData)
+	{
+		int tempIndex;
+		int index = 0;
+		int counter = -1;
+		long newData;
+		byte last = 0;
+		detailLevel = inputData[index];
+		index++;
+		maxVerticalData = inputData[index];
+		index++;
+		size = (int) Math.pow(2, LodUtil.REGION_DETAIL_LEVEL - detailLevel);
+		int x = size * size * maxVerticalData;
+		this.dataContainer = new long[x];
+		for ( int i = 0; i < x; i++)
+		{
+			newData = 0;
+			if (counter > -1)
+			{
+				dataContainer[i] = last;
+				if (last == 3)
+				{ //skip rest of void chunk
+					for (tempIndex = 1; tempIndex < maxVerticalData; tempIndex++) {
+						dataContainer[i + tempIndex] = 0;
+					}
+					i += maxVerticalData - 1;
+				}
+				counter--;
+			} else if ((inputData[index] & 0x3) == 0 || (inputData[index] & 0x3) == 3)
+			{
+				last = (byte)(inputData[index] & 0x3);
+				//recover counter
+				counter = (inputData[index] & 0x7c) >>> 2;
+				tempIndex = 0;
+				while ((inputData[index] & 0x80) == 0x80)
+				{ //overflow bit is on
+					index++;
+					counter += (inputData[index] & 0x7f) << (5 + 7 * tempIndex);
+					tempIndex++;
+				}
+				index++;
+				//since loop expects from us to put some data in, we just make it rerun it with new counter;
+				i--;
+			} else if (index + 7 >= inputData.length)
+				break;
+			else {
+				for (tempIndex = 0; tempIndex < 8; tempIndex++)
+					newData += (((long) inputData[index + tempIndex]) & 0xff) << (8 * tempIndex);
+				index = index + 8;
+				dataContainer[i] = newData;
+			}
+		}
+	}
+
+	public LevelContainer expand(){
+		return new VerticalLevelContainer((byte) (getDetailLevel() - 1));
+	}
+
+	public void updateData(LevelContainer lowerLevelContainer, int posX, int posZ)
+	{
+		//We reset the array
+		long[] dataToMerge = ThreadMapUtil.getVerticalUpdateArray()[detailLevel];
+
+		if(dataToMerge == null || dataToMerge.length != 4*lowerLevelContainer.getMaxVerticalData())
+			dataToMerge = new long[4 * lowerLevelContainer.getMaxVerticalData()];
+		else
+			Arrays.fill(dataToMerge, DataPointUtil.EMPTY_DATA);
+
+		int lowerMaxVertical = dataToMerge.length/4;
+		int childPosX;
+		int childPosZ;
+		long[] data;
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		for (int x = 0; x <= 1; x++)
+		{
+			for (int z = 0; z <= 1; z++)
+			{
+				childPosX = 2 * posX + x;
+				childPosZ = 2 * posZ + z;
+				for(int verticalIndex = 0; verticalIndex < lowerMaxVertical; verticalIndex++)
+					dataToMerge[(z*2+x)*lowerMaxVertical + verticalIndex] = lowerLevelContainer.getData(childPosX, childPosZ, verticalIndex);
+			}
+		}
+		data = DataPointUtil.mergeMultiData(dataToMerge, lowerMaxVertical, getMaxVerticalData());
+
+		for(int verticalIndex = 0; (verticalIndex < data.length) && (verticalIndex < maxVerticalData); verticalIndex++)
+		{
+			addData(data[verticalIndex],
+					posX,
+					posZ,
+					verticalIndex);
+		}
+	}
+
+	public byte[] toDataString()
+	{
+		int index = 0;
+		int counter = -1;
+		byte last = -1;
+		int x = size * size * maxVerticalData;
+		int tempIndex;
+		byte[] tempData = ThreadMapUtil.getSaveContainer();
+		long current;
+		if(tempData == null || tempData.length != (2 + (x * 8)))
+			tempData = new byte[2 + (x * 8)];
+		else
+			Arrays.fill(tempData, (byte) 0);
+
+		tempData[index] = detailLevel;
+		index++;
+		tempData[index] = (byte) maxVerticalData;
+		index++;
+
+		for (int i = 0; i < x; i++)
+		{
+			current = dataContainer[i];
+			if ((current & 0b11) == 0 || (current & 0b11) == 3)
+			{
+				current &= 0b11; //clean any garbage data after those two bits
+				last = (byte) current;
+				if (current == 3) //skip rest of void chunk
+					i += maxVerticalData - 1;
+				counter++;
+			} else {
+				for (tempIndex = 0; tempIndex < 8; tempIndex++)
+					tempData[index + tempIndex] = (byte) (current >>> (8 * tempIndex));
+				index += 8;
+			}
+			if (last != -1 && ( i == x - 1 || last != ((dataContainer[i + 1]) & 0b11)))
+			{ //save compressed data if next is different or if we reached onf of the data
+				tempData[index] = (byte)(0x7f & ((counter << 2) + last)); //save 5 bits of counter and compressed block
+
+				tempIndex = 0;
+				while ((counter >>> (5 + 7 * tempIndex)) != 0) //there is more of that counter
+				{
+					tempData[index] = (byte)(tempData[index] | 0x80); //set overflow bit to true
+					index++; // after setting overflow bit w can actually index++
+					tempData[index] = (byte)(0x7f & (counter >>> (5 + 7 * tempIndex))); // save 7 bits of counter
+					tempIndex++;
+				}
+				index++;
+				last = -1;
+				counter = -1;
+			}
+		}
+		return Arrays.copyOfRange(tempData, 0, index);
+	}
+
+	@Override
+	public String toString()
+	{
+		/*
+		StringBuilder stringBuilder = new StringBuilder();
+		int size = (int) Math.pow(2, LodUtil.REGION_DETAIL_LEVEL - detailLevel);
+		stringBuilder.append(detailLevel);
+		stringBuilder.append(DATA_DELIMITER);
+		for (int x = 0; x < size; x++)
+		{
+			for (int z = 0; z < size; z++)
+			{
+				//Converting the dataToHex
+				stringBuilder.append(Long.toHexString(dataContainer[x][z][0]));
+				stringBuilder.append(DATA_DELIMITER);
+			}
+		}
+		return stringBuilder.toString();
+		 */
+		return " ";
+	}
+
+	public int getMaxNumberOfLods(){
+		return size*size*getMaxVerticalData();
+	}
+
+	public int getMaxMemoryUse(){
+		return getMaxNumberOfLods() * 2; //2 byte
+	}
+}

src/main/java/com/seibel/lod/proxy/ClientProxy.java

@@ -1,20 +1,48 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.seibel.lod.proxy;
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
+import org.lwjgl.glfw.GLFW;
 
+import com.mojang.blaze3d.matrix.MatrixStack;
 import com.seibel.lod.builders.LodBufferBuilder;
 import com.seibel.lod.builders.LodBuilder;
-import com.seibel.lod.objects.LodChunk;
+import com.seibel.lod.builders.worldGeneration.LodNodeGenWorker;
+import com.seibel.lod.builders.worldGeneration.LodWorldGenerator;
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DistanceGenerationMode;
 import com.seibel.lod.objects.LodDimension;
-import com.seibel.lod.objects.LodRegion;
 import com.seibel.lod.objects.LodWorld;
-import com.seibel.lod.render.LodRender;
-import com.seibel.lod.util.LodConfig;
-import com.seibel.lod.util.LodUtils;
+import com.seibel.lod.objects.RegionPos;
+import com.seibel.lod.render.LodRenderer;
+import com.seibel.lod.util.DataPointUtil;
+import com.seibel.lod.util.DetailDistanceUtil;
+import com.seibel.lod.util.LodUtil;
+import com.seibel.lod.util.ThreadMapUtil;
+import com.seibel.lod.wrappers.MinecraftWrapper;
 
-import net.minecraft.client.Minecraft;
 import net.minecraft.profiler.IProfiler;
+import net.minecraft.util.text.StringTextComponent;
+import net.minecraft.world.DimensionType;
+import net.minecraftforge.client.event.InputEvent;
+import net.minecraftforge.event.TickEvent;
 import net.minecraftforge.event.world.BlockEvent;
 import net.minecraftforge.event.world.ChunkEvent;
 import net.minecraftforge.event.world.WorldEvent;
@@ -22,22 +50,44 @@ import net.minecraftforge.eventbus.api.SubscribeEvent;
 
 /**
  * This handles all events sent to the client,
- * and is the starting point for most of this program.
- * 
+ * and is the starting point for most of the mod.
+ *
  * @author James_Seibel
- * @version 05-31-2021
+ * @version 9-23-2021
  */
 public class ClientProxy
 {
 	public static final Logger LOGGER = LogManager.getLogger("LOD");
 	
+	private boolean firstTimeSetupComplete = false;
+	public static boolean drawLods = true;
+	
 	private static LodWorld lodWorld = new LodWorld();
 	private static LodBuilder lodBuilder = new LodBuilder();
-	private static LodBufferBuilder lodBufferBuilder = new LodBufferBuilder(lodBuilder);
-	private static LodRender renderer = new LodRender(lodBufferBuilder);
+	private static LodBufferBuilder lodBufferBuilder = new LodBufferBuilder();
+	private static LodRenderer renderer = new LodRenderer(lodBufferBuilder);
+	private static LodWorldGenerator lodWorldGenerator = LodWorldGenerator.INSTANCE;
 	
-	Minecraft mc = Minecraft.getInstance();
+	private boolean configOverrideReminderPrinted = false;
 	
+	private MinecraftWrapper mc = MinecraftWrapper.INSTANCE;
+	
+	
+	/**
+	 * This is used to determine if the LODs should be regenerated
+	 */
+	public static int previousChunkRenderDistance = 0;
+	/**
+	 * This is used to determine if the LODs should be regenerated
+	 */
+	public static int previousLodRenderDistance = 0;
+	
+	/**
+	 * can be set if we want to recalculate variables related
+	 * to the LOD view distance
+	 */
+	private boolean recalculateWidths = false;
+	private DimensionType currentDimension = null;
 	
 	public ClientProxy()
 	{
@@ -45,8 +95,6 @@ public class ClientProxy
 	}
 	
 	
-	
-	
 	//==============//
 	// render event //
 	//==============//
@@ -54,66 +102,113 @@ public class ClientProxy
 	/**
 	 * Do any setup that is required to draw LODs
 	 * and then tell the LodRenderer to draw.
+	 * @param mcMatrixStack 
 	 */
-	public void renderLods(float partialTicks)
+	public void renderLods(MatrixStack mcMatrixStack, float partialTicks)
 	{
-		if (mc == null || mc.player == null || !lodWorld.getIsWorldLoaded())
-			return;
+		// comment out when creating a release
+		applyConfigOverrides();
 		
-		// update each regions' width to match the new render distance
-		int newWidth = Math.max(4, 
-				// TODO is this logic good?
-				(mc.gameSettings.renderDistanceChunks * LodChunk.WIDTH * 2 * LodConfig.CLIENT.lodChunkRadiusMultiplier.get()) / LodRegion.SIZE
-				);
-		if (lodBuilder.regionWidth != newWidth)
+		// clear any out of date objects
+		mc.clearFrameObjectCache();
+		
+		try
 		{
-			lodWorld.resizeDimensionRegionWidth(newWidth);
-			lodBuilder.regionWidth = newWidth;
+			// only run the first time setup once
+			if (!firstTimeSetupComplete)
+			{
+				ThreadMapUtil.clearMaps();
+				firstFrameSetup();
+			}
 			
-			// skip this frame, hopefully the lodWorld
-			// should have everything set up by then
-			return;
+			if(mc.getCurrentDimension() != currentDimension)
+			{
+				currentDimension = mc.getCurrentDimension();
+				reset();
+			}
+			
+			DetailDistanceUtil.updateSettings();
+			if (mc == null || mc.getPlayer() == null || !lodWorld.getIsWorldLoaded())
+				return;
+			
+			LodDimension lodDim = lodWorld.getLodDimension(mc.getCurrentDimension());
+			if (lodDim == null)
+				return;
+			
+			viewDistanceChangedEvent();
+			playerMoveEvent(lodDim);
+			
+			lodDim.treeCutter((int) mc.getPlayer().getX(), (int) mc.getPlayer().getZ());
+			lodDim.treeGenerator((int) mc.getPlayer().getX(), (int) mc.getPlayer().getZ());
+			
+			
+			// Note to self:
+			// if "unspecified" shows up in the pie chart, it is
+			// possibly because the amount of time between sections
+			// is too small for the profiler to measure
+			IProfiler profiler = mc.getProfiler();
+			profiler.pop(); // get out of "terrain"
+			profiler.push("LOD");
+			
+			if(drawLods)
+			{
+				renderer.drawLODs(lodDim, mcMatrixStack, partialTicks, mc.getProfiler());
+			}
+			
+			profiler.pop(); // end LOD
+			profiler.push("terrain"); // go back into "terrain"
+			
+			
+			// these can't be set until after the buffers are built (in renderer.drawLODs)
+			// otherwise the buffers may be set to the wrong size, or not changed at all
+			previousChunkRenderDistance = mc.getRenderDistance();
+			previousLodRenderDistance = LodConfig.CLIENT.graphics.lodChunkRenderDistance.get();
 		}
-		
-		LodDimension lodDim = lodWorld.getLodDimension(mc.player.world.getDimensionType());
-		if (lodDim == null)
-			return;
-		
-		
-		// offset the regions
-		double playerX = mc.player.getPosX();
-		double playerZ = mc.player.getPosZ();
-		
-		int xOffset = ((int)playerX / (LodChunk.WIDTH * LodRegion.SIZE)) - lodDim.getCenterX();
-		int zOffset = ((int)playerZ / (LodChunk.WIDTH * LodRegion.SIZE)) - lodDim.getCenterZ();
-		
-		if (xOffset != 0 || zOffset != 0)
+		catch (Exception e)
 		{
-			lodDim.move(xOffset, zOffset);
+			LOGGER.error("client proxy: " + e.getMessage());
+			e.printStackTrace();
+		}
+	}
+	
+	
+	private void applyConfigOverrides()
+	{
+		// remind the developer(s) that the config override is active
+		if (!configOverrideReminderPrinted)
+		{
+			//mc.getPlayer().sendMessage(new StringTextComponent("Debug settings enabled!"), mc.getPlayer().getUUID());
+			
+			// this was changed just for the buggy pre-release, since the code was already here
+			mc.getPlayer().sendMessage(new StringTextComponent("Warning: LOD mod 1.5 buggy pre-release"), mc.getPlayer().getUUID());
+			mc.getPlayer().sendMessage(new StringTextComponent("Hic sunt dracones"), mc.getPlayer().getUUID()); // Here be dragons
+			configOverrideReminderPrinted = true;
 		}
 		
 		
-		// TODO for testing
-//		LodConfig.CLIENT.debugMode.set(false);
-//		LodConfig.CLIENT.lodDetail.set(LodDetail.DOUBLE);
-//		LodConfig.CLIENT.lodColorStyle.set(LodColorStyle.INDIVIDUAL_SIDES);
-//		LodConfig.CLIENT.lodChunkRadiusMultiplier.set(12);
+//		LodConfig.CLIENT.graphics.drawResolution.set(HorizontalResolution.BLOCK);
+//		LodConfig.CLIENT.worldGenerator.generationResolution.set(HorizontalResolution.BLOCK);
+		// requires a world restart?
+//		LodConfig.CLIENT.worldGenerator.lodQualityMode.set(VerticalQuality.MULTI_LOD);
 		
-		// Note to self:
-		// if "unspecified" shows up in the pie chart, it is
-		// possibly because the amount of time between sections
-		// is too small for the profile to measure
-		IProfiler profiler = mc.getProfiler();
-		profiler.endSection(); // get out of "terrain"
-		profiler.startSection("LOD");
+//		LodConfig.CLIENT.graphics.fogDistance.set(FogDistance.FAR);
+//		LodConfig.CLIENT.graphics.fogDrawOverride.set(FogDrawOverride.ALWAYS_DRAW_FOG_FANCY);
+//		LodConfig.CLIENT.graphics.shadingMode.set(ShadingMode.DARKEN_SIDES);
+//		LodConfig.CLIENT.graphics.brightnessMultiplier.set(1.0);
+//		LodConfig.CLIENT.graphics.saturationMultiplier.set(1.0);
+
+//		LodConfig.CLIENT.worldGenerator.distanceGenerationMode.set(DistanceGenerationMode.SURFACE);
+//		LodConfig.CLIENT.graphics.lodChunkRenderDistance.set(64);
+//		LodConfig.CLIENT.worldGenerator.lodDistanceCalculatorType.set(DistanceCalculatorType.LINEAR);
+//		LodConfig.CLIENT.worldGenerator.allowUnstableFeatureGeneration.set(false);
+
+//		LodConfig.CLIENT.buffers.bufferRebuildPlayerMoveTimeout.set(2000); // 2000
+//		LodConfig.CLIENT.buffers.bufferRebuildChunkChangeTimeout.set(1000); // 1000
+//		LodConfig.CLIENT.buffers.bufferRebuildLodChangeTimeout.set(5000); // 5000
 		
-		renderer.drawLODs(lodDim, partialTicks, mc.getProfiler());
-		
-		profiler.endSection(); // end LOD
-		profiler.startSection("terrain"); // restart terrain
-	}	
-	
-	
+//		LodConfig.CLIENT.debugging.enableDebugKeybindings.set(true);
+//		LodConfig.CLIENT.debugging.debugMode.set(DebugMode.SHOW_DETAIL);
+	}
 	
 	
 	//==============//
@@ -121,17 +216,37 @@ public class ClientProxy
 	//==============//
 	
 	@SubscribeEvent
-	public void chunkLoadEvent(ChunkEvent.Load event)
+	public void serverTickEvent(TickEvent.ServerTickEvent event)
 	{
-		lodBuilder.generateLodChunkAsync(event.getChunk(), lodWorld, event.getWorld());
+		if (mc == null || mc.getPlayer() == null || !lodWorld.getIsWorldLoaded())
+			return;
+		
+		LodDimension lodDim = lodWorld.getLodDimension(mc.getPlayer().level.dimensionType());
+		if (lodDim == null)
+			return;
+		
+		lodWorldGenerator.queueGenerationRequests(lodDim, renderer, lodBuilder);
 	}
 	
+	@SubscribeEvent
+	public void chunkLoadEvent(ChunkEvent.Load event)
+	{
+		lodBuilder.generateLodNodeAsync(event.getChunk(), lodWorld, event.getWorld(), DistanceGenerationMode.SERVER);
+	}
+	
+	@SubscribeEvent
+	public void worldSaveEvent(WorldEvent.Save event)
+	{
+		if (lodWorld != null)
+			lodWorld.saveAllDimensions();
+	}
 	
 	@SubscribeEvent
 	public void worldLoadEvent(WorldEvent.Load event)
 	{
+		DataPointUtil.worldHeight = event.getWorld().getHeight();
 		// the player just loaded a new world/dimension
-		lodWorld.selectWorld(LodUtils.getWorldID(event.getWorld()));
+		lodWorld.selectWorld(LodUtil.getWorldID(event.getWorld()));
 		// make sure the correct LODs are being rendered
 		// (if this isn't done the previous world's LODs may be drawn)
 		renderer.regenerateLODsNextFrame();
@@ -141,33 +256,129 @@ public class ClientProxy
 	public void worldUnloadEvent(WorldEvent.Unload event)
 	{
 		// the player just unloaded a world/dimension
-		
-		if(mc.getConnection().getWorld() == null)
+		if (mc.getConnection().getLevel() == null)
 		{
-			lodBufferBuilder.numberOfChunksWaitingToGenerate = 0;
+			// if this isn't done unfinished tasks may be left in the queue
+			// preventing new LodChunks form being generated
+			LodNodeGenWorker.restartExecuterService();
+			
+			LodWorldGenerator.INSTANCE.numberOfChunksWaitingToGenerate.set(0);
 			// the player has disconnected from a server
 			lodWorld.deselectWorld();
+			
+			
+			// hopefully this should reduce issues related to the buffer builder
+			// breaking when changing worlds.
+			renderer.destroyBuffers();
+			recalculateWidths = true;
+			
+			
+			// make sure the nulled objects are freed.
+			// (this prevents a out of memory error when
+			// changing worlds)
+			System.gc();
 		}
 	}
 	
-	
 	@SubscribeEvent
 	public void blockChangeEvent(BlockEvent event)
 	{
 		if (event.getClass() == BlockEvent.BreakEvent.class ||
-			event.getClass() == BlockEvent.EntityPlaceEvent.class ||
-			event.getClass() == BlockEvent.EntityMultiPlaceEvent.class ||
-			event.getClass() == BlockEvent.FluidPlaceBlockEvent.class ||
-			event.getClass() == BlockEvent.PortalSpawnEvent.class)
+				event.getClass() == BlockEvent.EntityPlaceEvent.class ||
+				event.getClass() == BlockEvent.EntityMultiPlaceEvent.class ||
+				event.getClass() == BlockEvent.FluidPlaceBlockEvent.class ||
+				event.getClass() == BlockEvent.PortalSpawnEvent.class)
 		{
 			// recreate the LOD where the blocks were changed
-			lodBuilder.generateLodChunkAsync(event.getWorld().getChunk(event.getPos()), lodWorld, event.getWorld());
+			lodBuilder.generateLodNodeAsync(event.getWorld().getChunk(event.getPos()), lodWorld, event.getWorld());
+		}
+	}
+	
+	@SubscribeEvent
+	public void onKeyInput(InputEvent.KeyInputEvent event) 
+	{
+		if(LodConfig.CLIENT.debugging.enableDebugKeybindings.get()
+				&& event.getKey() == GLFW.GLFW_KEY_F4 && event.getAction() == GLFW.GLFW_PRESS)
+		{
+			LodConfig.CLIENT.debugging.debugMode.set(LodConfig.CLIENT.debugging.debugMode.get().getNext());
+		}
+		
+		if(LodConfig.CLIENT.debugging.enableDebugKeybindings.get()
+				&& event.getKey() == GLFW.GLFW_KEY_F6 && event.getAction() == GLFW.GLFW_PRESS)
+		{
+			drawLods = !drawLods;
+		}
+	}
+	
+	//============//
+	// LOD events //
+	//============//
+	
+	/**
+	 * Re-centers the given LodDimension if it needs to be.
+	 */
+	private void playerMoveEvent(LodDimension lodDim)
+	{
+		// make sure the dimension is centered
+		RegionPos playerRegionPos = new RegionPos(mc.getPlayer().blockPosition());
+		RegionPos worldRegionOffset = new RegionPos(playerRegionPos.x - lodDim.getCenterX(), playerRegionPos.z - lodDim.getCenterZ());
+		if (worldRegionOffset.x != 0 || worldRegionOffset.z != 0)
+		{
+			lodWorld.saveAllDimensions();
+			lodDim.move(worldRegionOffset);
+			//LOGGER.info("offset: " + worldRegionOffset.x + "," + worldRegionOffset.z + "\t center: " + lodDim.getCenterX() + "," + lodDim.getCenterZ());
 		}
 	}
 	
 	
+	/**
+	 * Re-sizes all LodDimensions if they needs to be.
+	 */
+	private void viewDistanceChangedEvent()
+	{
+		// calculate how wide the dimension(s) should be in regions
+		int chunksWide = LodConfig.CLIENT.graphics.lodChunkRenderDistance.get() * 2 + 1;
+		int newWidth = (int) Math.ceil(chunksWide / (float) LodUtil.REGION_WIDTH_IN_CHUNKS);
+		newWidth = (newWidth % 2 == 0) ? (newWidth += 1) : (newWidth += 2); // make sure we have a odd number of regions
+		
+		// do the dimensions need to change in size?
+		if (lodBuilder.defaultDimensionWidthInRegions != newWidth || recalculateWidths)
+		{
+			lodWorld.saveAllDimensions();
+			
+			// update the dimensions to fit the new width
+			lodWorld.resizeDimensionRegionWidth(newWidth);
+			lodBuilder.defaultDimensionWidthInRegions = newWidth;
+			renderer.setupBuffers(lodWorld.getLodDimension(mc.getClientWorld().dimensionType()));
+			
+			recalculateWidths = false;
+			//LOGGER.info("new dimension width in regions: " + newWidth + "\t potential: " + newWidth );
+		}
+		DetailDistanceUtil.updateSettings();
+	}
 	
 	
+	/**
+	 * This event is called once during the first frame Minecraft renders in the world.
+	 */
+	public void firstFrameSetup()
+	{
+		// make sure the GlProxy is created before the LodBufferBuilder
+		GlProxy.getInstance();
+		
+		
+		
+		firstTimeSetupComplete = true;
+	}
+	
+	
+	public static void reset()
+	{
+		renderer = new LodRenderer(lodBufferBuilder);
+		LodNodeGenWorker.resetGenerator();
+		ThreadMapUtil.clearMaps();
+	}
+	
 	//================//
 	// public getters //
 	//================//
@@ -182,7 +393,7 @@ public class ClientProxy
 		return lodBuilder;
 	}
 	
-	public static LodRender getRenderer()
+	public static LodRenderer getRenderer()
 	{
 		return renderer;
 	}

src/main/java/com/seibel/lod/proxy/GlProxy.java

@@ -0,0 +1,188 @@
+package com.seibel.lod.proxy;
+
+import org.lwjgl.opengl.GL;
+import org.lwjgl.opengl.GLCapabilities;
+import org.lwjgl.opengl.WGL;
+
+import com.mojang.blaze3d.systems.RenderSystem;
+
+/**
+ * A singleton that holds references to different openGL contexts
+ * and GPU capabilities.
+ * 
+ * <p>
+ * Helpful OpenGL resources: <br><br>
+ * 
+ * https://www.seas.upenn.edu/~pcozzi/OpenGLInsights/OpenGLInsights-AsynchronousBufferTransfers.pdf <br>
+ * https://learnopengl.com/Advanced-OpenGL/Advanced-Data <br>
+ * https://gamedev.stackexchange.com/questions/91995/edit-vbo-data-or-create-a-new-one <br><br>
+ * 
+ * 
+ * @author James Seibel
+ * @version 9-15-2021
+ */
+public class GlProxy
+{
+	private static GlProxy instance = null;
+	
+	public final long deviceContext;
+	
+	public long minecraftGlContext;
+	public GLCapabilities minecraftGlCapabilities;
+	
+	public long lodBuilderGlContext;
+	public GLCapabilities lodBuilderGlCapabilities;
+	/** This is just used for debugging, hopefuly it can be removed once 
+	 * the context switching is more stable. */
+	public Thread lodBuilderOwnerThread = null;
+	
+	/**
+	 * Does this computer's GPU support fancy fog?
+	 */
+	public final boolean fancyFogAvailable;
+	
+	
+	
+	private GlProxy()
+	{
+		// getting Minecraft's context has to be done on the render thread,
+		// where the GL context is
+		if (!RenderSystem.isOnRenderThread())
+			throw new IllegalStateException(GlProxy.class.getSimpleName() + " was created outside the render thread!");
+		
+		
+		
+		
+		//============================//
+		// create the builder context //
+		//============================//
+		
+		minecraftGlContext = WGL.wglGetCurrentContext();
+		minecraftGlCapabilities = GL.getCapabilities();
+		deviceContext = WGL.wglGetCurrentDC();
+		
+		lodBuilderGlContext = WGL.wglCreateContext(deviceContext);
+		if (!WGL.wglShareLists(minecraftGlContext, lodBuilderGlContext))
+			throw new IllegalStateException("Unable to share lists between Minecraft and builder contexts.");
+		if (!WGL.wglMakeCurrent(deviceContext, lodBuilderGlContext))
+			throw new IllegalStateException("Unable to change OpenGL contexts! tried to change to [" + GlProxyContext.LOD_BUILDER.toString() + "] from [" + GlProxyContext.MINECRAFT.toString() + "]");
+		lodBuilderGlCapabilities = GL.createCapabilities();
+		WGL.wglMakeCurrent(deviceContext, 0L);
+		
+		
+		// Since this is called on the render thread, make sure the Minecraft context is used in the end
+		WGL.wglMakeCurrent(deviceContext, minecraftGlContext);
+		
+		
+		
+		
+		//==================================//
+		// get any GPU related capabilities //
+		//==================================//
+		
+		// see if this GPU can run fancy fog
+		fancyFogAvailable = GL.getCapabilities().GL_NV_fog_distance;
+
+		if (!fancyFogAvailable)
+		{
+			ClientProxy.LOGGER.info("This GPU does not support GL_NV_fog_distance. This means that the fancy fog option will not be available.");
+		}
+	}
+	
+	
+	/**
+	 * A simple wrapper function to make switching contexts easier
+	 * 
+	 * @throws IllegalStateException if unable to change to newContext. <br>
+	 * 								 This expection should never be thrown if 
+	 * 								 switching to GlProxyContext.NONE
+	 */
+	public void setGlContext(GlProxyContext newContext)
+	{
+		GlProxyContext currentContext = getGlContext();
+		
+		// we don't have to change the context, we're already there.
+		if (currentContext == newContext)
+			return;
+		
+		
+		long contextPointer = 0L;
+		GLCapabilities newGlCapabilities = null;
+		switch(newContext)
+		{
+		case LOD_BUILDER:
+			contextPointer = lodBuilderGlContext;
+			newGlCapabilities = lodBuilderGlCapabilities;
+			break;
+		case MINECRAFT:
+			contextPointer = minecraftGlContext;
+			newGlCapabilities = minecraftGlCapabilities;
+			break;
+		case NONE:
+			contextPointer = 0L; // equivalent to null
+			newGlCapabilities = null;
+			break;
+			
+		default:
+			// should never happen, here to make the compiler happy
+		}
+		
+		if (!WGL.wglMakeCurrent(deviceContext, contextPointer))
+			throw new IllegalStateException("Unable to change OpenGL contexts! tried to change to [" + newContext.toString() + "] from [" + currentContext.toString() + "] on thread: [" + Thread.currentThread().getName() + "] lod builder owner thread: " + (lodBuilderOwnerThread != null ? lodBuilderOwnerThread.getName() : "null"));
+		
+		if (newContext == GlProxyContext.LOD_BUILDER)
+		{
+			lodBuilderOwnerThread = Thread.currentThread();
+		}
+		else if (newContext == GlProxyContext.NONE && currentContext == GlProxyContext.LOD_BUILDER)
+		{
+			lodBuilderOwnerThread = null;
+		}
+		
+		GL.setCapabilities(newGlCapabilities);
+	}
+	
+	/**
+	 * Returns this thread's OpenGL context.
+	 */
+	public GlProxyContext getGlContext()
+	{
+		long currentContext = WGL.wglGetCurrentContext();
+		if(currentContext == lodBuilderGlContext)
+		{
+			return GlProxyContext.LOD_BUILDER;
+		}
+		else if(currentContext == minecraftGlContext)
+		{
+			return GlProxyContext.MINECRAFT;
+		}
+		else 
+		{
+			return GlProxyContext.NONE;
+		}
+	}
+	
+	/** Minecraft, Alpha, Beta, None */
+	public enum GlProxyContext
+	{
+		MINECRAFT,
+		LOD_BUILDER,
+		
+		/** used to un-bind threads */
+		NONE,
+	}
+	
+	public static GlProxy getInstance()
+	{
+		try
+		{
+			if (instance == null)
+				instance = new GlProxy();
+		}catch (Exception e)
+		{
+			e.printStackTrace();
+		}
+		
+		return instance;
+	}
+}

src/main/java/com/seibel/lod/render/LodRender.java

@@ -1,639 +0,0 @@
-package com.seibel.lod.render;
-
-import java.nio.ByteBuffer;
-import java.nio.ByteOrder;
-import java.nio.FloatBuffer;
-
-import org.lwjgl.opengl.GL11;
-
-import com.mojang.blaze3d.matrix.MatrixStack;
-import com.mojang.blaze3d.platform.GlStateManager;
-import com.mojang.blaze3d.systems.RenderSystem;
-import com.seibel.lod.builders.LodBufferBuilder;
-import com.seibel.lod.enums.FogDistance;
-import com.seibel.lod.enums.FogQuality;
-import com.seibel.lod.handlers.ReflectionHandler;
-import com.seibel.lod.objects.LodChunk;
-import com.seibel.lod.objects.LodDimension;
-import com.seibel.lod.objects.NearFarBuffer;
-import com.seibel.lod.objects.NearFarFogSetting;
-import com.seibel.lod.util.LodConfig;
-
-import net.minecraft.client.Minecraft;
-import net.minecraft.client.entity.player.ClientPlayerEntity;
-import net.minecraft.client.renderer.ActiveRenderInfo;
-import net.minecraft.client.renderer.BufferBuilder;
-import net.minecraft.client.renderer.FogRenderer;
-import net.minecraft.client.renderer.GameRenderer;
-import net.minecraft.client.renderer.vertex.DefaultVertexFormats;
-import net.minecraft.client.renderer.vertex.VertexBuffer;
-import net.minecraft.client.renderer.vertex.VertexFormat;
-import net.minecraft.potion.Effects;
-import net.minecraft.profiler.IProfiler;
-import net.minecraft.util.math.MathHelper;
-import net.minecraft.util.math.vector.Matrix4f;
-import net.minecraft.util.math.vector.Vector3d;
-import net.minecraft.util.math.vector.Vector3f;
-
-
-/**
- * This is where all the magic happens. <br>
- * This is where LODs are draw to the world. 
- * 
- * @author James Seibel
- * @version 05-08-2021
- */
-public class LodRender
-{
-	/** this is the light used when rendering the LODs,
-	 * it should be something different than what is used by Minecraft */
-	private static final int LOD_GL_LIGHT_NUMBER = GL11.GL_LIGHT2;
-
-	/** If true the LODs colors will be replaced with
-	 * a checkerboard, this can be used for debugging. */
-	public boolean debugging = false;
-	
-	private Minecraft mc;
-	private GameRenderer gameRender;
-	private IProfiler profiler;
-	private float farPlaneDistance;
-	private ReflectionHandler reflectionHandler;
-	
-	
-	/** This is used to generate the buildable buffers */
-	private LodBufferBuilder lodBufferBuilder;
-	
-	/** The buffers that are used to draw LODs using near fog */
-	private volatile BufferBuilder drawableNearBuffer;
-	/** The buffers that are used to draw LODs using far fog */
-	private volatile BufferBuilder drawableFarBuffer;
-	
-	/** This is the VertexBuffer used to draw any LODs that use near fog */
-	private volatile VertexBuffer nearVbo;
-	/** This is the VertexBuffer used to draw any LODs that use far fog */
-	private volatile VertexBuffer farVbo;
-	public static final VertexFormat LOD_VERTEX_FORMAT = DefaultVertexFormats.POSITION_COLOR;
-	
-	/** This is used to determine if the LODs should be regenerated */
-	private int previousChunkRenderDistance = 0;
-	/** This is used to determine if the LODs should be regenerated */
-	private int prevChunkX = 0;
-	/** This is used to determine if the LODs should be regenerated */
-	private int prevChunkZ = 0;
-	/** This is used to determine if the LODs should be regenerated */
-	private FogDistance prevFogDistance = FogDistance.NEAR_AND_FAR;
-	
-	/** if this is true the LOD buffers should be regenerated,
-	 * provided they aren't already being regenerated. */
-	private boolean regen = false;
-	
-	
-	
-	
-	
-	public LodRender(LodBufferBuilder newLodBufferBuilder)
-	{
-		mc = Minecraft.getInstance();
-		gameRender = mc.gameRenderer;
-		
-		reflectionHandler = new ReflectionHandler();
-		lodBufferBuilder = newLodBufferBuilder;
-	}
-	
-	
-	/**
-	 * Besides drawing the LODs this method also starts
-	 * the async process of generating the Buffers that hold those LODs.
-	 * 
-	 * @param newDimension The dimension to draw, if null doesn't replace the current dimension.
-	 * @param partialTicks how far into the current tick this method was called.
-	 */
-	@SuppressWarnings("deprecation")
-	public void drawLODs(LodDimension lodDim, float partialTicks, IProfiler newProfiler)
-	{		
-		if (lodDim == null)
-		{
-			// if there aren't any loaded LodChunks
-			// don't try drawing anything
-			return;
-		}
-		
-		
-		
-		
-		
-		
-		//===============//
-		// initial setup //
-		//===============//
-		
-		profiler = newProfiler;
-		profiler.startSection("LOD setup");
-		
-		ClientPlayerEntity player = mc.player;
-		
-		// should LODs be regenerated?
-		if ((int)player.getPosX() / LodChunk.WIDTH != prevChunkX ||
-			(int)player.getPosZ() / LodChunk.WIDTH != prevChunkZ ||
-			previousChunkRenderDistance != mc.gameSettings.renderDistanceChunks ||
-			prevFogDistance != LodConfig.CLIENT.fogDistance.get())
-		{
-			// yes
-			regen = true;
-			
-			prevChunkX = (int)player.getPosX() / LodChunk.WIDTH;
-			prevChunkZ = (int)player.getPosZ() / LodChunk.WIDTH;
-			prevFogDistance = LodConfig.CLIENT.fogDistance.get();
-		}
-		else
-		{
-			// nope, the player hasn't moved, the
-			// render distance hasn't changed, and
-			// the dimension is the same
-		}
-		
-		// did the user change the debug setting?
-		if (LodConfig.CLIENT.debugMode.get() != debugging)
-		{
-			debugging = LodConfig.CLIENT.debugMode.get();
-			regen = true;
-		}
-		
-		
-		// determine how far the game's render distance is currently set
-		int renderDistWidth = mc.gameSettings.renderDistanceChunks;
-		farPlaneDistance = renderDistWidth * LodChunk.WIDTH;
-		
-		// set how big the LODs will be and how far they will go
-		int totalLength = (int) farPlaneDistance * LodConfig.CLIENT.lodChunkRadiusMultiplier.get() * 2;
-		int numbChunksWide = (totalLength / LodChunk.WIDTH);
-		
-		
-		
-		
-		//=================//
-		// create the LODs //
-		//=================//
-		
-		// only regenerate the LODs if:
-		// 1. we want to regenerate LODs
-		// 2. we aren't already regenerating the LODs
-		// 3. we aren't waiting for the build and draw buffers to swap
-		//		(this is to prevent thread conflicts)
-		if (regen && !lodBufferBuilder.generatingBuffers && !lodBufferBuilder.newBuffersAvaliable())
-		{
-			// this will mainly happen when the view distance is changed
-			if (drawableNearBuffer == null || drawableFarBuffer == null || 
-				previousChunkRenderDistance != mc.gameSettings.renderDistanceChunks)
-				setupBuffers(numbChunksWide);
-			
-			// generate the LODs on a separate thread to prevent stuttering or freezing
-			lodBufferBuilder.generateLodBuffersAsync(this, lodDim, player.getPosX(), player.getPosZ(), numbChunksWide);
-			
-			// the regen process has been started,
-			// it will be done when lodBufferBuilder.newBuffersAvaliable
-			// is true
-			regen = false;
-		}
-		
-		// replace the buffers used to draw and build,
-		// this is only done when the createLodBufferGenerationThread
-		// has finished executing on a parallel thread.
-		if (lodBufferBuilder.newBuffersAvaliable())
-		{
-			swapBuffers();
-		}
-		
-		
-		
-		
-		
-		//===========================//
-		// GL settings for rendering //
-		//===========================//
-		
-		// set the required open GL settings
-		GL11.glPolygonMode(GL11.GL_FRONT_AND_BACK, GL11.GL_FILL);
-		GL11.glBlendFunc(GL11.GL_SRC_ALPHA, GL11.GL_ONE_MINUS_SRC_ALPHA);
-		GL11.glDisable(GL11.GL_TEXTURE_2D);
-		GL11.glEnable(GL11.GL_CULL_FACE);
-		GL11.glEnable(GL11.GL_COLOR_MATERIAL);
-		GL11.glEnable(GL11.GL_DEPTH_TEST);
-		
-		// disable the lights Minecraft uses
-		GL11.glDisable(GL11.GL_LIGHT0);
-		GL11.glDisable(GL11.GL_LIGHT1);
-		
-		// get the default projection matrix so we can
-		// reset it after drawing the LODs
-		float[] defaultProjMatrix = new float[16];
-        GL11.glGetFloatv(GL11.GL_PROJECTION_MATRIX, defaultProjMatrix);
-		
-		Matrix4f modelViewMatrix = generateModelViewMatrix(partialTicks);
-		
-		setupProjectionMatrix(partialTicks);
-		setupLighting(lodDim, partialTicks);
-		
-		NearFarFogSetting fogSetting = determineFogSettings();
-		
-		// determine the current fog settings so they can be
-		// reset after drawing the LODs
-		float defaultFogStartDist = GL11.glGetFloat(GL11.GL_FOG_START);
-		float defaultFogEndDist = GL11.glGetFloat(GL11.GL_FOG_END);
-		int defaultFogMode = GL11.glGetInteger(GL11.GL_FOG_MODE);
-
-		
-		
-		
-		
-		
-		
-		//===========//
-		// rendering //
-		//===========//
-		profiler.endStartSection("LOD draw");
-		
-		setupFog(fogSetting.nearFogSetting, reflectionHandler.getFogQuality());
-		sendLodsToGpuAndDraw(nearVbo, modelViewMatrix);
-		
-		setupFog(fogSetting.farFogSetting, reflectionHandler.getFogQuality());
-		sendLodsToGpuAndDraw(farVbo, modelViewMatrix);
-		
-		
-		
-		
-		
-		//=========//
-		// cleanup //
-		//=========//
-		
-		profiler.endStartSection("LOD cleanup");
-		
-		GL11.glPolygonMode(GL11.GL_FRONT_AND_BACK, GL11.GL_FILL);
-		GL11.glEnable(GL11.GL_TEXTURE_2D);
-		GL11.glDisable(LOD_GL_LIGHT_NUMBER);
-		// re-enable the lights Minecraft uses
-		GL11.glEnable(GL11.GL_LIGHT0);
-		GL11.glEnable(GL11.GL_LIGHT1);
-		RenderSystem.disableLighting();
-		
-		// this can't be called until after the buffers are built
-		// because otherwise the buffers may be set to the wrong size
-		previousChunkRenderDistance = mc.gameSettings.renderDistanceChunks;
-		
-		// reset the fog settings so the normal chunks
-		// will be drawn correctly
-		RenderSystem.fogStart(defaultFogStartDist);
-		RenderSystem.fogEnd(defaultFogEndDist);
-		RenderSystem.fogMode(defaultFogMode);
-		
-		// reset the projection matrix so anything drawn after
-		// the LODs will use the correct projection matrix
-		Matrix4f mvm = new Matrix4f(defaultProjMatrix);
-		mvm.transpose();
-		gameRender.resetProjectionMatrix(mvm);
-		
-		// clear the depth buffer so anything drawn is drawn
-		// over the LODs
-		GL11.glClear(GL11.GL_DEPTH_BUFFER_BIT);
-		
-		
-		// end of internal LOD profiling
-		profiler.endSection();
-	}
-	
-	
-
-	/**
-	 * This is where the actual drawing happens.
-	 * 
-	 * @param buffers the buffers sent to the GPU to draw
-	 */
-	private void sendLodsToGpuAndDraw(VertexBuffer vbo, Matrix4f modelViewMatrix)
-	{
-		if (vbo == null)
-			return;
-		
-        vbo.bindBuffer();
-        // 0L is the starting pointer
-        LOD_VERTEX_FORMAT.setupBufferState(0L);
-        
-        vbo.draw(modelViewMatrix, GL11.GL_QUADS);
-        
-        VertexBuffer.unbindBuffer();
-        LOD_VERTEX_FORMAT.clearBufferState();
-	}
-	
-	
-	
-	
-	
-	
-	
-	//=================//
-	// Setup Functions //
-	//=================//
-	
-	@SuppressWarnings("deprecation")
-	private void setupFog(FogDistance fogDistance, FogQuality fogQuality)
-	{
-		if(fogQuality == FogQuality.OFF)
-		{
-			FogRenderer.resetFog();
-			RenderSystem.disableFog();
-			return;
-		}
-		
-		if(fogDistance == FogDistance.NEAR_AND_FAR)
-		{
-			throw new IllegalArgumentException("setupFog doesn't accept the NEAR_AND_FAR fog distance.");
-		}
-
-		// the multipliers are percentages
-		// of the regular view distance.
-		
-		if(fogDistance == FogDistance.NEAR)
-		{
-			// the reason that I wrote fogEnd then fogStart backwards
-			// is because we are using fog backwards to how
-			// it is normally used, with it hiding near objects
-			// instead of far objects.
-			
-			if (fogQuality == FogQuality.FANCY)
-			{
-				RenderSystem.fogEnd(farPlaneDistance * 1.75f);
-				RenderSystem.fogStart(farPlaneDistance * 1.95f);
-			}
-			else if(fogQuality == FogQuality.FAST)
-			{
-				// for the far fog of the normal chunks
-				// to start right where the LODs' end use:
-				// end = 0.8f, start = 1.5f
-				
-				RenderSystem.fogEnd(farPlaneDistance * 1.5f);
-				RenderSystem.fogStart(farPlaneDistance * 2.0f);
-			}
-		}
-		else if(fogDistance == FogDistance.FAR)
-		{
-			if (fogQuality == FogQuality.FANCY)
-			{
-				RenderSystem.fogStart(farPlaneDistance * 0.85f * LodConfig.CLIENT.lodChunkRadiusMultiplier.get());
-				RenderSystem.fogEnd(farPlaneDistance * 1.0f * LodConfig.CLIENT.lodChunkRadiusMultiplier.get());
-			}
-			else if(fogQuality == FogQuality.FAST)
-			{
-				RenderSystem.fogStart(farPlaneDistance * 0.5f * LodConfig.CLIENT.lodChunkRadiusMultiplier.get());
-				RenderSystem.fogEnd(farPlaneDistance * 0.75f * LodConfig.CLIENT.lodChunkRadiusMultiplier.get());
-			}
-		}
-		
-		RenderSystem.fogMode(GlStateManager.FogMode.LINEAR);
-		RenderSystem.enableFog();
-	}
-	
-
-	/**
-	 * Create the model view matrix to move the LODs
-	 * from object space into world space.
-	 */
-	private Matrix4f generateModelViewMatrix(float partialTicks)
-	{
-		// get all relevant camera info
-		ActiveRenderInfo renderInfo = mc.gameRenderer.getActiveRenderInfo();
-        Vector3d projectedView = renderInfo.getProjectedView();
-		
-		
-		// generate the model view matrix
-		MatrixStack matrixStack = new MatrixStack();
-        matrixStack.push();
-        // translate and rotate to the current camera location
-        matrixStack.rotate(Vector3f.XP.rotationDegrees(renderInfo.getPitch()));
-        matrixStack.rotate(Vector3f.YP.rotationDegrees(renderInfo.getYaw() + 180));
-        matrixStack.translate(-projectedView.x, -projectedView.y, -projectedView.z);
-        
-        return matrixStack.getLast().getMatrix();
-	}
-	
-	
-	/**
-	 * create a new projection matrix and send it over to the GPU
-	 * <br><br>
-	 * A lot of this code is copied from renderWorld (line 578)
-	 * in the GameRender class. The code copied is anything with
-	 * a matrixStack and is responsible for making sure the LOD
-	 * objects distort correctly relative to the rest of the world.
-	 * Distortions are caused by: standing in a nether portal,
-	 * nausea potion effect, walking bobbing.
-	 * 
-	 * @param partialTicks how many ticks into the frame we are
-	 */
-	private void setupProjectionMatrix(float partialTicks)
-	{
-		// Note: if the LOD objects don't distort correctly
-		// compared to regular minecraft terrain, make sure
-		// all the transformations in renderWorld are here too
-		
-		MatrixStack matrixStack = new MatrixStack();
-        matrixStack.push();
-		
-		gameRender.hurtCameraEffect(matrixStack, partialTicks);
-		if (this.mc.gameSettings.viewBobbing) {
-			gameRender.applyBobbing(matrixStack, partialTicks);
-		}
-		
-		// potion and nausea effects
-		float f = MathHelper.lerp(partialTicks, mc.player.prevTimeInPortal, mc.player.timeInPortal) * mc.gameSettings.screenEffectScale * mc.gameSettings.screenEffectScale;
-		if (f > 0.0F) {
-			int i = this.mc.player.isPotionActive(Effects.NAUSEA) ? 7 : 20;
-			float f1 = 5.0F / (f * f + 5.0F) - f * 0.04F;
-			f1 = f1 * f1;
-			Vector3f vector3f = new Vector3f(0.0F, MathHelper.SQRT_2 / 2.0F, MathHelper.SQRT_2 / 2.0F);
-			matrixStack.rotate(vector3f.rotationDegrees((gameRender.rendererUpdateCount + partialTicks) * i));
-			matrixStack.scale(1.0F / f1, 1.0F, 1.0F);
-			float f2 = -(gameRender.rendererUpdateCount + partialTicks) * i;
-			matrixStack.rotate(vector3f.rotationDegrees(f2));
-		}
-		
-		
-		
-		// this projection matrix allows us to see past the normal 
-		// world render distance
-		Matrix4f projectionMatrix = 
-				Matrix4f.perspective(
-				getFov(partialTicks, true), 
-				(float)this.mc.getMainWindow().getFramebufferWidth() / (float)this.mc.getMainWindow().getFramebufferHeight(), 
-				0.5F, 
-				this.farPlaneDistance * LodConfig.CLIENT.lodChunkRadiusMultiplier.get() * 2);
-		
-		// add the screen space distortions
-		projectionMatrix.mul(matrixStack.getLast().getMatrix());
-		gameRender.resetProjectionMatrix(projectionMatrix);
-		return;
-	}
-	
-	
-	/**
-	 * setup the lighting to be used for the LODs
-	 */
-	@SuppressWarnings("deprecation")
-	private void setupLighting(LodDimension lodDimension, float partialTicks)
-	{
-		float sunBrightness = lodDimension.dimension.hasSkyLight() ? mc.world.getSunBrightness(partialTicks) : 0.2f;
-		float gammaMultiplyer = (float)mc.gameSettings.gamma - 0.5f;
-		float lightStrength = sunBrightness - 0.4f + (gammaMultiplyer * 0.2f);
-		
-		float lightAmbient[] = {lightStrength, lightStrength, lightStrength, 1.0f};
-		
-		ByteBuffer temp = ByteBuffer.allocateDirect(16);
-		temp.order(ByteOrder.nativeOrder());
-		GL11.glLightfv(LOD_GL_LIGHT_NUMBER, GL11.GL_AMBIENT, (FloatBuffer) temp.asFloatBuffer().put(lightAmbient).flip());
-		GL11.glEnable(LOD_GL_LIGHT_NUMBER); // Enable the above lighting
-		
-		RenderSystem.enableLighting();
-	}
-	
-	
-	/**
-	 * Create all buffers that will be used.
-	 */
-	private void setupBuffers(int numbChunksWide)
-	{
-		// calculate the max amount of storage needed (in bytes)
-		int bufferMaxCapacity = (numbChunksWide * numbChunksWide * (6 * 4 * (3 + 4)));
-		// (numbChunksWide * numbChunksWide * 
-		// (sidesOnACube * pointsInASquare * (positionPoints + colorPoints)))
-		
-		// TODO complain or do something when memory is too low
-		// currently the VM will just crash and complain there is no more memory
-		// issue #4
-		drawableNearBuffer = new BufferBuilder(bufferMaxCapacity);
-		drawableFarBuffer = new BufferBuilder(bufferMaxCapacity);
-		
-		lodBufferBuilder.setupBuffers(bufferMaxCapacity);
-	}
-	
-	
-
-	
-	
-	
-	
-	
-	//======================//
-	// Other Misc Functions // 
-	//======================//
-	
-	/**
-	 * If this is called then the next time "drawLODs" is called
-	 * the LODs will be regenerated; the same as if the player moved.
-	 */
-	public void regenerateLODsNextFrame()
-	{
-		regen = true;
-	}
-	
-	
-	/**
-	 * Replace the current drawable buffers with the newly
-	 * created buffers from the lodBufferBuilder.
-	 */
-	private void swapBuffers()
-	{
-		// replace the drawable buffers with
-		// the newly created buffers from the lodBufferBuilder
-		NearFarBuffer newBuffers = lodBufferBuilder.swapBuffers(drawableNearBuffer, drawableFarBuffer);
-		drawableNearBuffer = newBuffers.nearBuffer;
-		drawableFarBuffer = newBuffers.farBuffer;
-		
-		
-		// bind the buffers with their respective VBOs
-		if (nearVbo != null)
-			nearVbo.close();
-		
-		nearVbo = new VertexBuffer(LOD_VERTEX_FORMAT);
-		nearVbo.upload(drawableNearBuffer);
-		
-		
-		if (farVbo != null)
-			farVbo.close();
-		
-		farVbo = new VertexBuffer(LOD_VERTEX_FORMAT);
-		farVbo.upload(drawableFarBuffer);
-	}
-	
-	
-	private double getFov(float partialTicks, boolean useFovSetting)
-	{
-		return mc.gameRenderer.getFOVModifier(mc.gameRenderer.getActiveRenderInfo(), partialTicks, useFovSetting);
-	}
-	
-	
-	/**
-	 * Based on the fogDistance setting and
-	 * optifine's fogQuality setting return what fog
-	 * settings should be used when rendering.
-	 */
-	private NearFarFogSetting determineFogSettings()
-	{
-		NearFarFogSetting fogSetting = new NearFarFogSetting();
-		
-		switch(reflectionHandler.getFogQuality())
-		{
-		case FANCY:
-			
-			switch(LodConfig.CLIENT.fogDistance.get())
-			{
-			case NEAR_AND_FAR:
-				fogSetting.nearFogSetting = FogDistance.NEAR;
-				fogSetting.farFogSetting = FogDistance.FAR;
-				break;
-				
-			case NEAR:
-				fogSetting.nearFogSetting = FogDistance.NEAR;
-				fogSetting.farFogSetting = FogDistance.NEAR;
-				break;
-				
-			case FAR:
-				fogSetting.nearFogSetting = FogDistance.FAR;
-				fogSetting.farFogSetting = FogDistance.FAR;
-				break;
-			}
-			
-			break;
-		case FAST:
-			// fast fog setting should only have one type of
-			// fog, since the LODs are separated into a near
-			// and far portion; and fast fog is rendered from the
-			// frustrum's perspective instead of the camera
-			
-			switch(LodConfig.CLIENT.fogDistance.get())
-			{
-			case NEAR_AND_FAR:
-				fogSetting.nearFogSetting = FogDistance.NEAR;
-				fogSetting.farFogSetting = FogDistance.NEAR;
-				break;
-				
-			case NEAR:
-				fogSetting.nearFogSetting = FogDistance.NEAR;
-				fogSetting.farFogSetting = FogDistance.NEAR;
-				break;
-				
-			case FAR:
-				fogSetting.nearFogSetting = FogDistance.FAR;
-				fogSetting.farFogSetting = FogDistance.FAR;
-				break;
-			}
-			
-			break;
-		case OFF:
-			break;
-		
-		}
-		
-		return fogSetting;
-	}
-	
-	
-	
-}

src/main/java/com/seibel/lod/render/LodRenderer.java

@@ -0,0 +1,881 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.render;
+
+import java.util.HashSet;
+
+import org.lwjgl.opengl.GL11;
+import org.lwjgl.opengl.GL15;
+import org.lwjgl.opengl.GL15C;
+import org.lwjgl.opengl.NVFogDistance;
+
+import com.mojang.blaze3d.matrix.MatrixStack;
+import com.mojang.blaze3d.platform.GlStateManager;
+import com.mojang.blaze3d.systems.RenderSystem;
+import com.seibel.lod.builders.LodBufferBuilder;
+import com.seibel.lod.builders.LodBufferBuilder.VertexBuffersAndOffset;
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DebugMode;
+import com.seibel.lod.enums.DetailDropOff;
+import com.seibel.lod.enums.FogDistance;
+import com.seibel.lod.enums.FogDrawOverride;
+import com.seibel.lod.enums.FogQuality;
+import com.seibel.lod.handlers.ReflectionHandler;
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.objects.NearFarFogSettings;
+import com.seibel.lod.objects.RegionPos;
+import com.seibel.lod.proxy.ClientProxy;
+import com.seibel.lod.proxy.GlProxy;
+import com.seibel.lod.util.DetailDistanceUtil;
+import com.seibel.lod.util.LevelPosUtil;
+import com.seibel.lod.util.LodUtil;
+import com.seibel.lod.wrappers.MinecraftWrapper;
+
+import net.minecraft.client.renderer.ActiveRenderInfo;
+import net.minecraft.client.renderer.FogRenderer;
+import net.minecraft.client.renderer.GameRenderer;
+import net.minecraft.client.renderer.texture.NativeImage;
+import net.minecraft.client.renderer.vertex.DefaultVertexFormats;
+import net.minecraft.client.renderer.vertex.VertexBuffer;
+import net.minecraft.client.renderer.vertex.VertexFormat;
+import net.minecraft.profiler.IProfiler;
+import net.minecraft.util.math.BlockPos;
+import net.minecraft.util.math.ChunkPos;
+import net.minecraft.util.math.vector.Matrix4f;
+import net.minecraft.util.math.vector.Vector3d;
+
+
+/**
+ * This is where all the magic happens. <br>
+ * This is where LODs are draw to the world.
+ *
+ * @author James Seibel
+ * @version 9-23-2021
+ */
+public class LodRenderer
+{
+	/**
+	 * this is the light used when rendering the LODs,
+	 * it should be something different than what is used by Minecraft
+	 */
+	private static final int LOD_GL_LIGHT_NUMBER = GL11.GL_LIGHT2;
+
+	/**
+	 * 64 MB by default is the maximum amount of memory that
+	 * can be directly allocated. <br><br>
+	 * <p>
+	 * I know there are commands to change that amount
+	 * (specifically "-XX:MaxDirectMemorySize"), but
+	 * I have no idea how to access that amount. <br>
+	 * So I guess this will be the hard limit for now. <br><br>
+	 * <p>
+	 * https://stackoverflow.com/questions/50499238/bytebuffer-allocatedirect-and-xmx
+	 */
+	public static final int MAX_ALOCATEABLE_DIRECT_MEMORY = 64 * 1024 * 1024;
+	
+	/**
+	 * If true the LODs colors will be replaced with
+	 * a checkerboard, this can be used for debugging.
+	 */
+	public DebugMode previousDebugMode = DebugMode.OFF;
+
+	private MinecraftWrapper mc;
+	private GameRenderer gameRender;
+	private IProfiler profiler;
+	private int farPlaneBlockDistance;
+
+
+	/**
+	 * This is used to generate the buildable buffers
+	 */
+	private LodBufferBuilder lodBufferBuilder;
+
+	/**
+	 * Each VertexBuffer represents 1 region
+	 */
+	private VertexBuffer[][] vbos;
+	public static final VertexFormat LOD_VERTEX_FORMAT = DefaultVertexFormats.POSITION_COLOR;
+	private ChunkPos vbosCenter = new ChunkPos(0,0);
+
+	/**
+	 * This is used to determine if the LODs should be regenerated
+	 */
+	private int[] previousPos = new int[]{0,0,0};
+	
+	public NativeImage lightMap = null;
+	
+	// these variables are used to determine if the buffers should be rebuilt
+	private long prevDayTime = 0;
+	private double prevBrightness = 0;
+	private int prevRenderDistance = 0;
+	private long prevPlayerPosTime = 0;
+	private long prevVanillaChunkTime = 0;
+	private long prevChunkTime = 0;
+
+
+	/**
+	 * This is used to determine if the LODs should be regenerated
+	 */
+	private FogDistance prevFogDistance = FogDistance.NEAR_AND_FAR;
+
+	/**
+	 * if this is true the LOD buffers should be regenerated,
+	 * provided they aren't already being regenerated.
+	 */
+	private volatile boolean partialRegen = false;
+	private volatile boolean fullRegen = true;
+
+	/**
+	 * This HashSet contains every chunk that Vanilla Minecraft
+	 * is going to render
+	 */
+	public boolean[][] vanillaRenderedChunks;
+	public boolean vanillaRenderedChunksChanged;
+
+
+	public LodRenderer(LodBufferBuilder newLodNodeBufferBuilder)
+	{
+		mc = MinecraftWrapper.INSTANCE;
+		gameRender = mc.getGameRenderer();
+
+		lodBufferBuilder = newLodNodeBufferBuilder;
+	}
+
+
+	/**
+	 * Besides drawing the LODs this method also starts
+	 * the async process of generating the Buffers that hold those LODs.
+	 *
+	 * @param lodDim       The dimension to draw, if null doesn't replace the current dimension.
+	 * @param mcMatrixStack This matrix stack should come straight from MC's renderChunkLayer (or future equivalent) method
+	 * @param partialTicks how far into the current tick this method was called.
+	 */
+	public void drawLODs(LodDimension lodDim, MatrixStack mcMatrixStack, float partialTicks, IProfiler newProfiler)
+	{
+		if (lodDim == null)
+		{
+			// if there aren't any loaded LodChunks
+			// don't try drawing anything
+			return;
+		}
+
+
+		//===============//
+		// initial setup //
+		//===============//
+
+		profiler = newProfiler;
+		profiler.push("LOD setup");
+		
+		
+		// TODO move the buffer regeneration logic into its own class (probably called in the client proxy instead)
+		// starting here...
+		determineIfLodsShouldRegenerate(lodDim);
+
+		//=================//
+		// create the LODs //
+		//=================//
+
+		// only regenerate the LODs if:
+		// 1. we want to regenerate LODs
+		// 2. we aren't already regenerating the LODs
+		// 3. we aren't waiting for the build and draw buffers to swap
+		//		(this is to prevent thread conflicts)
+		if ((partialRegen || fullRegen) && !lodBufferBuilder.generatingBuffers && !lodBufferBuilder.newBuffersAvaliable())
+		{
+			// generate the LODs on a separate thread to prevent stuttering or freezing
+			lodBufferBuilder.generateLodBuffersAsync(this, lodDim, mc.getPlayer().blockPosition(), true);
+
+			// the regen process has been started,
+			// it will be done when lodBufferBuilder.newBuffersAvaliable()
+			// is true
+			fullRegen = false;
+			partialRegen = false;
+		}
+
+		// TODO move the buffer regeneration logic into its own class (probably called in the client proxy instead)
+		// ...ending here
+		
+		if (lodBufferBuilder.newBuffersAvaliable())
+		{
+			swapBuffers();
+		}
+		
+
+
+		//===========================//
+		// GL settings for rendering //
+		//===========================//
+
+		// set the required open GL settings
+		
+		if (LodConfig.CLIENT.debugging.debugMode.get() == DebugMode.SHOW_DETAIL_WIREFRAME)
+			GL11.glPolygonMode(GL11.GL_FRONT_AND_BACK, GL11.GL_LINE);
+		else
+			GL11.glPolygonMode(GL11.GL_FRONT_AND_BACK, GL11.GL_FILL);
+
+		GL11.glDisable(GL11.GL_TEXTURE_2D);
+		GL11.glEnable(GL11.GL_CULL_FACE);
+		GL11.glEnable(GL11.GL_COLOR_MATERIAL);
+		GL11.glEnable(GL11.GL_DEPTH_TEST);
+
+		// disable the lights Minecraft uses
+		GL11.glDisable(GL11.GL_LIGHT0);
+		GL11.glDisable(GL11.GL_LIGHT1);
+
+		// get the default projection matrix so we can
+		// reset it after drawing the LODs
+		float[] mcProjMatrixRaw = new float[16];
+		GL11.glGetFloatv(GL11.GL_PROJECTION_MATRIX, mcProjMatrixRaw);
+		Matrix4f mcProjectionMatrix = new Matrix4f(mcProjMatrixRaw);
+		// OpenGl outputs their matricies in col,row form instead of row,col
+		// (or maybe vice versa I have no idea :P)
+		mcProjectionMatrix.transpose();
+		
+		Matrix4f modelViewMatrix = offsetTheModelViewMatrix(mcMatrixStack, partialTicks);
+
+		// required for setupFog and setupProjectionMatrix
+		farPlaneBlockDistance = LodConfig.CLIENT.graphics.lodChunkRenderDistance.get() * LodUtil.CHUNK_WIDTH;
+
+		setupProjectionMatrix(mcProjectionMatrix, partialTicks);
+		// commented out until we can add shaders to handle lighting
+		//setupLighting(lodDim, partialTicks);
+
+		NearFarFogSettings fogSettings = determineFogSettings();
+
+		// determine the current fog settings so they can be
+		// reset after drawing the LODs
+		float defaultFogStartDist = GL11.glGetFloat(GL11.GL_FOG_START);
+		float defaultFogEndDist = GL11.glGetFloat(GL11.GL_FOG_END);
+		int defaultFogMode = GL11.glGetInteger(GL11.GL_FOG_MODE);
+		int defaultFogDistance = GL11.glGetInteger(NVFogDistance.GL_FOG_DISTANCE_MODE_NV);
+
+
+		//===========//
+		// rendering //
+		//===========//
+		
+		profiler.popPush("LOD draw");
+		
+		if (vbos != null)
+		{
+			ActiveRenderInfo renderInfo = mc.getGameRenderer().getMainCamera();
+			Vector3d cameraDir = new Vector3d(renderInfo.getLookVector());
+			
+			boolean cullingDisabled = LodConfig.CLIENT.graphics.disableDirectionalCulling.get();
+			
+			// used to determine what type of fog to render
+			int halfWidth = vbos.length / 2;
+			int quarterWidth = vbos.length / 4;
+
+			for (int i = 0; i < vbos.length; i++)
+			{
+				for (int j = 0; j < vbos.length; j++)
+				{
+					RegionPos vboPos = new RegionPos(i + lodDim.getCenterX() - lodDim.getWidth() / 2, j + lodDim.getCenterZ() - lodDim.getWidth() / 2);
+					if (cullingDisabled || RenderUtil.isRegionInViewFrustum(renderInfo.getBlockPosition(), cameraDir, vboPos.blockPos()))
+					{
+						if ((i > halfWidth - quarterWidth && i < halfWidth + quarterWidth) && (j > halfWidth - quarterWidth && j < halfWidth + quarterWidth))
+							setupFog(fogSettings.near.distance, fogSettings.near.quality);
+						else
+							setupFog(fogSettings.far.distance, fogSettings.far.quality);
+
+
+						sendLodsToGpuAndDraw(vbos[i][j], modelViewMatrix);
+					}
+				}
+			}
+		}
+		
+
+		//=========//
+		// cleanup //
+		//=========//
+
+		profiler.popPush("LOD cleanup");
+
+		GL11.glPolygonMode(GL11.GL_FRONT_AND_BACK, GL11.GL_FILL);
+		GL11.glEnable(GL11.GL_TEXTURE_2D);
+		GL11.glDisable(LOD_GL_LIGHT_NUMBER);
+		// re-enable the lights Minecraft uses
+		GL11.glEnable(GL11.GL_LIGHT0);
+		GL11.glEnable(GL11.GL_LIGHT1);
+		RenderSystem.disableLighting();
+
+		// reset the fog settings so the normal chunks
+		// will be drawn correctly
+		cleanupFog(fogSettings, defaultFogStartDist, defaultFogEndDist, defaultFogMode, defaultFogDistance);
+
+		// reset the projection matrix so anything drawn after
+		// the LODs will use the correct projection matrix
+		gameRender.resetProjectionMatrix(mcProjectionMatrix);
+		
+		// clear the depth buffer so anything drawn is drawn
+		// over the LODs
+		GL11.glClear(GL11.GL_DEPTH_BUFFER_BIT);
+		
+
+		// end of internal LOD profiling
+		profiler.pop();
+	}
+
+
+	/**
+	 * This is where the actual drawing happens.
+	 */
+	private void sendLodsToGpuAndDraw(VertexBuffer vbo, Matrix4f modelViewMatrix)
+	{
+		if (vbo == null)
+			return;
+		
+		GL15C.glBindBuffer(GL15.GL_ARRAY_BUFFER, vbo.id);
+		// 0L is the starting pointer
+		LOD_VERTEX_FORMAT.setupBufferState(0L);
+		
+		vbo.draw(modelViewMatrix, GL11.GL_QUADS);
+		
+		GL15C.glBindBuffer(GL15.GL_ARRAY_BUFFER, 0);
+		LOD_VERTEX_FORMAT.clearBufferState();
+	}
+
+
+	//=================//
+	// Setup Functions //
+	//=================//
+
+	@SuppressWarnings("deprecation")
+	private void setupFog(FogDistance fogDistance, FogQuality fogQuality)
+	{
+		if (fogQuality == FogQuality.OFF)
+		{
+			FogRenderer.setupNoFog();
+			RenderSystem.disableFog();
+			return;
+		}
+
+		if (fogDistance == FogDistance.NEAR_AND_FAR)
+		{
+			throw new IllegalArgumentException("setupFog doesn't accept the NEAR_AND_FAR fog distance.");
+		}
+
+		// determine the fog distance mode to use
+		int glFogDistanceMode;
+		if (fogQuality == FogQuality.FANCY)
+		{
+			// fancy fog (fragment distance based fog)
+			glFogDistanceMode = NVFogDistance.GL_EYE_RADIAL_NV;
+		}
+		else
+		{
+			// fast fog (frustum distance based fog)
+			glFogDistanceMode = NVFogDistance.GL_EYE_PLANE_ABSOLUTE_NV;
+		}
+
+		// the multipliers are percentages
+		// of the regular view distance.
+		if (fogDistance == FogDistance.FAR)
+		{
+			// the reason that I wrote fogEnd then fogStart backwards
+			// is because we are using fog backwards to how
+			// it is normally used, with it hiding near objects
+			// instead of far objects.
+
+			if (fogQuality == FogQuality.FANCY)
+			{
+				// for more realistic fog when using FAR
+				if(LodConfig.CLIENT.graphics.fogDistance.get() == FogDistance.NEAR_AND_FAR)
+				{
+					RenderSystem.fogStart(farPlaneBlockDistance * 0.9f);
+					RenderSystem.fogEnd(farPlaneBlockDistance * 1.0f);
+				}else{
+					RenderSystem.fogStart(farPlaneBlockDistance * 0.1f);
+					RenderSystem.fogEnd(farPlaneBlockDistance * 1.0f);
+				}
+			}
+			else if (fogQuality == FogQuality.FAST)
+			{
+				// for the far fog of the normal chunks
+				// to start right where the LODs' end use:
+				// end = 0.8f, start = 1.5f
+				RenderSystem.fogStart(farPlaneBlockDistance * 1.5f);
+				RenderSystem.fogEnd(farPlaneBlockDistance * 2.0f);
+			}
+		}
+		else if (fogDistance == FogDistance.NEAR)
+		{
+			if (fogQuality == FogQuality.FANCY)
+			{
+				RenderSystem.fogEnd(mc.getRenderDistance() * 16 * 1.41f);
+				RenderSystem.fogStart(mc.getRenderDistance() * 16 * 1.6f);
+			}
+			else if (fogQuality == FogQuality.FAST)
+			{
+				RenderSystem.fogEnd(mc.getRenderDistance() * 16 * 1.0f);
+				RenderSystem.fogStart(mc.getRenderDistance() * 16 * 1.5f);
+			}
+		}
+
+		GL11.glEnable(GL11.GL_FOG);
+		RenderSystem.enableFog();
+		RenderSystem.setupNvFogDistance();
+		RenderSystem.fogMode(GlStateManager.FogMode.LINEAR);
+		GL11.glFogi(NVFogDistance.GL_FOG_DISTANCE_MODE_NV, glFogDistanceMode);
+	}
+
+	/**
+	 * Revert any changes that were made to the fog.
+	 */
+	private void cleanupFog(NearFarFogSettings fogSettings,
+	                        float defaultFogStartDist, float defaultFogEndDist,
+	                        int defaultFogMode, int defaultFogDistance)
+	{
+		RenderSystem.fogStart(defaultFogStartDist);
+		RenderSystem.fogEnd(defaultFogEndDist);
+		RenderSystem.fogMode(defaultFogMode);
+		GL11.glFogi(NVFogDistance.GL_FOG_DISTANCE_MODE_NV, defaultFogDistance);
+
+		// disable fog if Minecraft wasn't rendering fog
+		// but we were
+		if (!fogSettings.vanillaIsRenderingFog &&
+				    (fogSettings.near.quality != FogQuality.OFF ||
+						     fogSettings.far.quality != FogQuality.OFF))
+		{
+			GL11.glDisable(GL11.GL_FOG);
+		}
+	}
+
+
+	/**
+	 * Translate the camera relative to the LodDimension's center,
+	 * this is done since all LOD buffers are created in world space
+	 * instead of object space.
+	 * (since AxisAlignedBoundingBoxes (LODs) use doubles and thus have a higher
+	 * accuracy vs the model view matrix, which only uses floats)
+	 */
+	private Matrix4f offsetTheModelViewMatrix(MatrixStack mcMatrixStack, float partialTicks)
+	{
+		// duplicate the last matrix
+		mcMatrixStack.pushPose();
+		
+		
+		// get all relevant camera info
+		ActiveRenderInfo renderInfo = mc.getGameRenderer().getMainCamera();
+		Vector3d projectedView = renderInfo.getPosition();
+		
+		// translate the camera relative to the regions' center
+		// (AxisAlignedBoundingBoxes (LODs) use doubles and thus have a higher
+		// accuracy vs the model view matrix, which only uses floats)
+		BlockPos bufferPos = vbosCenter.getWorldPosition();
+		Vector3d eyePos = mc.getPlayer().getEyePosition(partialTicks);
+		double xDiff = eyePos.x - bufferPos.getX();
+		double zDiff = eyePos.z - bufferPos.getZ();
+		mcMatrixStack.translate(-xDiff, -projectedView.y, -zDiff);
+		
+		
+		// get the modified model view matrix
+		Matrix4f lodModelViewMatrix = mcMatrixStack.last().pose(); 
+		// remove the lod ModelViewMatrix
+		mcMatrixStack.popPose();
+		
+		return lodModelViewMatrix;
+	}
+
+
+	/**
+	 * create a new projection matrix and send it over to the GPU
+	 * 
+	 * @param currentProjectionMatrix this is Minecraft's current projection matrix
+	 * @param partialTicks how many ticks into the frame we are
+	 */
+	private void setupProjectionMatrix(Matrix4f currentProjectionMatrix, float partialTicks)
+	{
+		// create the new projection matrix
+		Matrix4f lodPoj =
+			Matrix4f.perspective(
+					getFov(partialTicks, true),
+					(float) this.mc.getWindow().getScreenWidth() / (float) this.mc.getWindow().getScreenHeight(),
+					mc.getRenderDistance()/2,
+					farPlaneBlockDistance * LodUtil.CHUNK_WIDTH * 2 / 4);
+		
+		// get Minecraft's un-edited projection matrix
+		// (this is before it is zoomed, distorted, etc.)
+		Matrix4f defaultMcProj = mc.getGameRenderer().getProjectionMatrix(mc.getGameRenderer().getMainCamera(), partialTicks, true);
+		// true here means use "use fov setting" (probably)
+		
+		
+		// this logic strips away the defaultMcProj matrix so we 
+		// can get the distortionMatrix, which represents all
+		// transformations, zooming, distortions, etc. done
+		// to Minecraft's Projection matrix
+		Matrix4f defaultMcProjInv = defaultMcProj.copy();
+		defaultMcProjInv.invert();
+		
+		Matrix4f distortionMatrix = defaultMcProjInv.copy();
+		distortionMatrix.multiply(currentProjectionMatrix);
+		
+		
+		// edit the lod projection to match Minecraft's
+		// (so the LODs line up with the real world)
+		lodPoj.multiply(distortionMatrix);
+		
+		// send the projection over to the GPU
+		gameRender.resetProjectionMatrix(lodPoj);
+	}
+
+
+	/**
+	 * setup the lighting to be used for the LODs
+	 */
+	/*private void setupLighting(LodDimension lodDimension, float partialTicks)
+	{
+		// Determine if the player has night vision
+		boolean playerHasNightVision = false;
+		if (this.mc.getPlayer() != null)
+		{
+			Iterator<EffectInstance> iterator = this.mc.getPlayer().getActiveEffects().iterator();
+			while (iterator.hasNext())
+			{
+				EffectInstance instance = iterator.next();
+				if (instance.getEffect() == Effects.NIGHT_VISION)
+				{
+					playerHasNightVision = true;
+					break;
+				}
+			}
+		}
+
+		float sunBrightness = lodDimension.dimension.hasSkyLight() ? mc.getSkyDarken(partialTicks) : 0.2f;
+		sunBrightness = playerHasNightVision ? 1.0f : sunBrightness;
+		float gamma = (float) mc.getOptions().gamma - 0.0f;
+		float dayEffect = (sunBrightness - 0.2f) * 1.25f;
+		float lightStrength = (gamma * 0.34f - 0.01f) * (1.0f - dayEffect) + dayEffect - 0.20f; //gamma * 0.2980392157f + 0.1647058824f
+		float blueLightStrength = (gamma * 0.44f + 0.12f) * (1.0f - dayEffect) + dayEffect - 0.20f; //gamma * 0.4235294118f + 0.2784313725f
+
+		float[] lightAmbient = {lightStrength, lightStrength, blueLightStrength, 1.0f};
+
+
+		// can be used for debugging
+		//		if (partialTicks < 0.005)
+		//			ClientProxy.LOGGER.debug(lightStrength);
+
+		ByteBuffer temp = ByteBuffer.allocateDirect(16);
+		temp.order(ByteOrder.nativeOrder());
+		GL11.glLightfv(LOD_GL_LIGHT_NUMBER, GL11.GL_AMBIENT, (FloatBuffer) temp.asFloatBuffer().put(lightAmbient).flip());
+		GL11.glEnable(LOD_GL_LIGHT_NUMBER); // Enable the above lighting
+
+		RenderSystem.enableLighting();
+	}*/
+
+	/**
+	 * Create all buffers that will be used.
+	 */
+	public void setupBuffers(LodDimension lodDim)
+	{
+		lodBufferBuilder.setupBuffers(lodDim);
+	}
+
+
+	//======================//
+	// Other Misc Functions //
+	//======================//
+
+	/**
+	 * If this is called then the next time "drawLODs" is called
+	 * the LODs will be regenerated; the same as if the player moved.
+	 */
+	public void regenerateLODsNextFrame()
+	{
+		fullRegen = true;
+	}
+
+
+	/**
+	 * Replace the current Vertex Buffers with the newly
+	 * created buffers from the lodBufferBuilder. <br><br>
+	 *
+	 * For some reason this has to be called after the frame has been rendered,
+	 * otherwise visual stuttering/rubber banding may happen. I'm not sure why...
+	 */
+	private void swapBuffers()
+	{
+		// replace the drawable buffers with
+		// the newly created buffers from the lodBufferBuilder
+		VertexBuffersAndOffset result = lodBufferBuilder.getVertexBuffers();
+		vbos = result.vbos;
+		vbosCenter = result.drawableCenterChunkPos;
+	}
+
+	/**
+	 * Calls the BufferBuilder's destroyBuffers method.
+	 */
+	public void destroyBuffers()
+	{
+		lodBufferBuilder.destroyBuffers();
+	}
+
+
+	private double getFov(float partialTicks, boolean useFovSetting)
+	{
+		return mc.getGameRenderer().getFov(mc.getGameRenderer().getMainCamera(), partialTicks, useFovSetting);
+	}
+
+
+	/**
+	 * Return what fog settings should be used when rendering.
+	 */
+	private NearFarFogSettings determineFogSettings()
+	{
+		NearFarFogSettings fogSettings = new NearFarFogSettings();
+
+
+		FogQuality quality = ReflectionHandler.INSTANCE.getFogQuality();
+		FogDrawOverride override = LodConfig.CLIENT.graphics.fogDrawOverride.get();
+
+
+		fogSettings.vanillaIsRenderingFog = quality != FogQuality.OFF;
+
+
+		// use any fog overrides the user may have set
+		switch (override)
+		{
+			case ALWAYS_DRAW_FOG_FANCY:
+				quality = FogQuality.FANCY;
+				break;
+
+			case NEVER_DRAW_FOG:
+				quality = FogQuality.OFF;
+				break;
+
+			case ALWAYS_DRAW_FOG_FAST:
+				quality = FogQuality.FAST;
+				break;
+
+			case USE_OPTIFINE_FOG_SETTING:
+				// don't override anything
+				break;
+		}
+
+
+		// only use fancy fog if the user's GPU can deliver
+		if (!GlProxy.getInstance().fancyFogAvailable && quality == FogQuality.FANCY)
+		{
+			quality = FogQuality.FAST;
+		}
+
+
+		// how different distances are drawn depends on the quality set
+		switch (quality)
+		{
+			case FANCY:
+				fogSettings.near.quality = FogQuality.FANCY;
+				fogSettings.far.quality = FogQuality.FANCY;
+
+				switch (LodConfig.CLIENT.graphics.fogDistance.get())
+				{
+					case NEAR_AND_FAR:
+						fogSettings.near.distance = FogDistance.NEAR;
+						fogSettings.far.distance = FogDistance.FAR;
+						break;
+
+					case NEAR:
+						fogSettings.near.distance = FogDistance.NEAR;
+						fogSettings.far.distance = FogDistance.NEAR;
+						break;
+
+					case FAR:
+						fogSettings.near.distance = FogDistance.FAR;
+						fogSettings.far.distance = FogDistance.FAR;
+						break;
+				}
+				break;
+
+			case FAST:
+				fogSettings.near.quality = FogQuality.FAST;
+				fogSettings.far.quality = FogQuality.FAST;
+
+				// fast fog setting should only have one type of
+				// fog, since the LODs are separated into a near
+				// and far portion; and fast fog is rendered from the
+				// frustrum's perspective instead of the camera
+				switch (LodConfig.CLIENT.graphics.fogDistance.get())
+				{
+					case NEAR_AND_FAR:
+						fogSettings.near.distance = FogDistance.NEAR;
+						fogSettings.far.distance = FogDistance.NEAR;
+						break;
+
+					case NEAR:
+						fogSettings.near.distance = FogDistance.NEAR;
+						fogSettings.far.distance = FogDistance.NEAR;
+						break;
+
+					case FAR:
+						fogSettings.near.distance = FogDistance.FAR;
+						fogSettings.far.distance = FogDistance.FAR;
+						break;
+				}
+				break;
+
+			case OFF:
+
+				fogSettings.near.quality = FogQuality.OFF;
+				fogSettings.far.quality = FogQuality.OFF;
+				break;
+
+		}
+
+
+		return fogSettings;
+	}
+
+
+	/**
+	 * Determines if the LODs should have a fullRegen or partialRegen
+	 */
+	private void determineIfLodsShouldRegenerate(LodDimension lodDim)
+	{
+		short chunkRenderDistance = (short) mc.getRenderDistance();
+		
+		int vanillaRenderedChunksWidth = chunkRenderDistance*2+2;
+		vanillaRenderedChunks = new boolean[vanillaRenderedChunksWidth][vanillaRenderedChunksWidth];
+		
+		
+		
+		//=============//
+		// full regens //
+		//=============//
+		
+		// check if the view distance changed
+		if (ClientProxy.previousLodRenderDistance != LodConfig.CLIENT.graphics.lodChunkRenderDistance.get()
+				    ||  mc.getRenderDistance()  != prevRenderDistance
+				    || prevFogDistance != LodConfig.CLIENT.graphics.fogDistance.get())
+		{
+			DetailDistanceUtil.updateSettings();
+			fullRegen = true;
+			previousPos = LevelPosUtil.createLevelPos((byte) 4, mc.getPlayer().xChunk, mc.getPlayer().zChunk);
+			prevFogDistance = LodConfig.CLIENT.graphics.fogDistance.get();
+			prevRenderDistance = mc.getRenderDistance();
+		}
+
+		// did the user change the debug setting?
+		if (LodConfig.CLIENT.debugging.debugMode.get() != previousDebugMode)
+		{
+			previousDebugMode = LodConfig.CLIENT.debugging.debugMode.get();
+			fullRegen = true;
+		}
+
+
+		long newTime = System.currentTimeMillis();
+
+		if(LodConfig.CLIENT.graphics.detailDropOff.get() == DetailDropOff.BY_CHUNK)
+		{
+			// check if the player has moved
+			if (newTime - prevPlayerPosTime > LodConfig.CLIENT.buffers.bufferRebuildPlayerMoveTimeout.get())
+			{
+				if (LevelPosUtil.getDetailLevel(previousPos) == 0
+						    || mc.getPlayer().xChunk != LevelPosUtil.getPosX(previousPos)
+						    || mc.getPlayer().zChunk != LevelPosUtil.getPosZ(previousPos))
+				{
+					fullRegen = true;
+					previousPos = LevelPosUtil.createLevelPos((byte) 4, mc.getPlayer().xChunk, mc.getPlayer().zChunk);
+				}
+				prevPlayerPosTime = newTime;
+			}
+		}
+
+
+
+		//================//
+		// partial regens //
+		//================//
+
+
+		// check if the vanilla rendered chunks changed
+		if (newTime - prevVanillaChunkTime > LodConfig.CLIENT.buffers.bufferRebuildChunkChangeTimeout.get())
+		{
+			if (vanillaRenderedChunksChanged)
+			{
+				partialRegen = true;
+				vanillaRenderedChunksChanged = false;
+
+			}
+			prevVanillaChunkTime = newTime;
+		}
+
+
+		// check if there is any newly generated terrain to show
+		if (newTime - prevChunkTime > LodConfig.CLIENT.buffers.bufferRebuildLodChangeTimeout.get())
+		{
+			if (lodDim.regenDimension)
+			{
+				partialRegen = true;
+				lodDim.regenDimension = false;
+			}
+			prevChunkTime = newTime;
+		}
+
+		// check if the lighting has changed
+		if (mc.getClientWorld().getDayTime() - prevDayTime > 1000 || mc.getOptions().gamma != prevBrightness || lightMap == null)
+		{
+			fullRegen = true;
+			lightMap = mc.getCurrentLightMap();
+			prevBrightness = mc.getOptions().gamma;
+			prevDayTime = mc.getClientWorld().getDayTime();
+		}
+
+
+
+
+		//==============//
+		// LOD skipping //
+		//==============//
+
+		// determine which LODs should not be rendered close to the player
+		HashSet<ChunkPos> chunkPosToSkip = LodUtil.getNearbyLodChunkPosToSkip(lodDim, mc.getPlayer().blockPosition());
+		int xIndex;
+		int zIndex;
+		for (ChunkPos pos : chunkPosToSkip)
+		{
+			xIndex = (pos.x - mc.getPlayer().xChunk) + (chunkRenderDistance + 1);
+			zIndex = (pos.z - mc.getPlayer().zChunk) + (chunkRenderDistance + 1);
+			
+			// sometimes we are given chunks that are outside the render distance,
+			// This prevents index out of bounds exceptions
+			if (xIndex >= 0 && zIndex >= 0
+				&& xIndex < vanillaRenderedChunks.length 
+				&& zIndex < vanillaRenderedChunks.length)
+			{
+				if (!vanillaRenderedChunks[xIndex][zIndex])
+				{
+					vanillaRenderedChunks[xIndex][zIndex] = true;
+					vanillaRenderedChunksChanged = true;
+					lodDim.setToRegen(pos.getRegionX(), pos.getRegionZ());
+				}
+			}
+		}
+		
+		
+		// if the player is high enough, draw all LODs
+		if(chunkPosToSkip.isEmpty() && mc.getPlayer().position().y > 256)
+		{
+			vanillaRenderedChunks = new boolean[vanillaRenderedChunksWidth][vanillaRenderedChunksWidth];
+			vanillaRenderedChunksChanged = true;
+		}
+	}
+
+}

src/main/java/com/seibel/lod/render/RenderUtil.java

@@ -1,29 +1,69 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.seibel.lod.render;
 
-import net.minecraft.client.Minecraft;
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.LodTemplate;
+import com.seibel.lod.objects.LodRegion;
+import com.seibel.lod.util.DetailDistanceUtil;
+import com.seibel.lod.util.LodUtil;
+import com.seibel.lod.wrappers.MinecraftWrapper;
+
+import net.minecraft.util.math.BlockPos;
+import net.minecraft.util.math.ChunkPos;
+import net.minecraft.util.math.vector.Vector3d;
 
 /**
  * This holds miscellaneous helper code
  * to be used in the rendering process.
  * 
  * @author James Seibel
- * @version 2-13-2021
+ * @version 8-21-2021
  */
 public class RenderUtil
 {
+	private static final MinecraftWrapper mc = MinecraftWrapper.INSTANCE;
+	
+	
+	/**
+	 * Returns if the given ChunkPos is in the loaded area of the world.
+	 * @param centerCoordinate the center of the loaded world (probably the player's ChunkPos)
+	 */
+	public static boolean isChunkPosInLoadedArea(ChunkPos pos, ChunkPos center)
+	{
+		return (pos.x >= center.x - mc.getRenderDistance() 
+				&& pos.x <= center.x + mc.getRenderDistance()) 
+				&& 
+				(pos.z >= center.z - mc.getRenderDistance() 
+				&& pos.z <= center.z + mc.getRenderDistance());
+	}
+	
 	/**
 	 * Returns if the given coordinate is in the loaded area of the world.
 	 * @param centerCoordinate the center of the loaded world
 	 */
-	public static boolean isCoordinateInLoadedArea(int i, int j, int centerCoordinate)
+	public static boolean isCoordinateInLoadedArea(int x, int z, int centerCoordinate)
 	{
-		Minecraft mc = Minecraft.getInstance();
-		
-		return (i >= centerCoordinate - mc.gameSettings.renderDistanceChunks 
-				&& i <= centerCoordinate + mc.gameSettings.renderDistanceChunks) 
+		return (x >= centerCoordinate - mc.getRenderDistance() 
+				&& x <= centerCoordinate + mc.getRenderDistance()) 
 				&& 
-				(j >= centerCoordinate - mc.gameSettings.renderDistanceChunks 
-				&& j <= centerCoordinate + mc.gameSettings.renderDistanceChunks);
+				(z >= centerCoordinate - mc.getRenderDistance() 
+				&& z <= centerCoordinate + mc.getRenderDistance());
 	}
 	
 	
@@ -42,4 +82,71 @@ public class RenderUtil
 				&& j <= lodRadius + halfRadius);
 	}
 	
+	
+	/**
+	 * Get how much buffer memory would be required for the given radius multiplier
+	 * 
+	 * issue #62
+	 * TODO check if this is actually returning the correct memory needed
+	 * it is possible (albeit unlikely) to have a buffer indexOutOfBounds exception
+	 * which is caused by the buffer not being big enough.
+	 */
+	public static int getBufferMemoryForRegion(LodRegion region)
+	{
+		// calculate the max amount of buffer memory needed (in bytes)
+		return region.getMinMemoryNeeded(LodConfig.CLIENT.graphics.lodTemplate.get());
+	}
+	
+	/**
+	 * Returns the maxViewDistanceMultiplier for the given LodTemplate
+	 * at the given LodDetail level.
+	 */
+	/*public static int getMaxRadiusMultiplierWithAvaliableMemory(LodTemplate lodTemplate, int detailLevel)
+	{
+		int maxNumberOfLods = LodRenderer.MAX_ALOCATEABLE_DIRECT_MEMORY / lodTemplate.getBufferMemoryForSingleLod();
+		int numbLodsWide = (int) Math.sqrt(maxNumberOfLods);
+		
+		return numbLodsWide / (2 * mc.getRenderDistance());
+	}*/
+	
+	
+	/**
+	 * Returns true if one of the region's 4 corners is in front
+	 * of the camera.
+	 */
+	public static boolean isRegionInViewFrustum(BlockPos playerBlockPos, Vector3d cameraDir, BlockPos vboCenterPos)
+	{
+    	// convert the vbo position into a direction vector
+    	// starting from the player's position
+		Vector3d vboVec = new Vector3d(vboCenterPos.getX(), 0, vboCenterPos.getZ());
+		Vector3d playerVec = new Vector3d(playerBlockPos.getX(), playerBlockPos.getY(), playerBlockPos.getZ());
+		Vector3d vboCenterVec = vboVec.subtract(playerVec);
+		
+		
+    	int halfRegionWidth = LodUtil.REGION_WIDTH / 2;
+    	
+    	// calculate the 4 corners
+    	Vector3d vboSeVec = new Vector3d(vboCenterVec.x + halfRegionWidth, vboCenterVec.y, vboCenterVec.z + halfRegionWidth);//.normalize();
+    	Vector3d vboSwVec = new Vector3d(vboCenterVec.x - halfRegionWidth, vboCenterVec.y, vboCenterVec.z + halfRegionWidth);//.normalize();
+    	Vector3d vboNwVec = new Vector3d(vboCenterVec.x - halfRegionWidth, vboCenterVec.y, vboCenterVec.z - halfRegionWidth);//.normalize();
+    	Vector3d vboNeVec = new Vector3d(vboCenterVec.x + halfRegionWidth, vboCenterVec.y, vboCenterVec.z - halfRegionWidth);//.normalize();
+    	
+    	// if any corner is visible, this region should be rendered
+    	return isNormalizedVectorInViewFrustum(vboSeVec, cameraDir) ||
+    			isNormalizedVectorInViewFrustum(vboSwVec, cameraDir) ||
+    			isNormalizedVectorInViewFrustum(vboNwVec, cameraDir) ||
+    			isNormalizedVectorInViewFrustum(vboNeVec, cameraDir);
+	}
+    
+	/**
+	 * Currently takes the dot product of the two vectors,
+	 * but in the future could do more complicated frustum culling tests.
+	 */
+    private static boolean isNormalizedVectorInViewFrustum(Vector3d objectVector, Vector3d cameraDir)
+	{
+    	// the -0.1 is to offer a slight buffer so we are
+    	// more likely to render LODs and thus, hopefully prevent
+    	// flickering or odd disappearences
+    	return objectVector.dot(cameraDir) > -0.1;
+	}
 }

src/main/java/com/seibel/lod/util/ColorUtil.java

@@ -0,0 +1,114 @@
+package com.seibel.lod.util;
+
+import java.awt.*;
+
+public class ColorUtil
+{
+	public static int rgbToInt(int red, int green, int blue)
+	{
+		return (0xFF << 24) | (red << 16) | (green << 8) | blue;
+	}
+
+	public static int rgbToInt(int alpha, int red, int green, int blue)
+	{
+		return (alpha << 24) | (red << 16) | (green << 8) | blue;
+	}
+
+	public static int getAlpha(int color)
+	{
+		return (color >> 24) & 0xFF;
+	}
+
+	public static int getRed(int color)
+	{
+		return (color >> 16) & 0xFF;
+	}
+
+	public static int getGreen(int color)
+	{
+		return (color >> 8) & 0xFF;
+	}
+
+	public static int getBlue(int color)
+	{
+		return color & 0xFF;
+	}
+
+	public static int applyShade(int color, int shade)
+	{
+		if (shade < 0)
+		{
+			return (getAlpha(color) << 24) | (Math.max(getRed(color) + shade, 0) << 16) | (Math.max(getGreen(color) + shade, 0) << 8) | Math.max(getBlue(color) + shade, 0);
+		} else
+		{
+			return (getAlpha(color) << 24) | (Math.min(getRed(color) + shade, 255) << 16) | (Math.min(getGreen(color) + shade, 255) << 8) | Math.min(getBlue(color) + shade, 255);
+		}
+	}
+
+	public static int applyShade(int color, float shade)
+	{
+		if (shade < 1)
+		{
+			return (getAlpha(color) << 24) | ((int) Math.max(getRed(color) * shade, 0) << 16) | ((int) Math.max(getGreen(color) * shade, 0) << 8) | (int) Math.max(getBlue(color) * shade, 0);
+		} else
+		{
+			return (getAlpha(color) << 24) | ((int) Math.min(getRed(color) * shade, 255) << 16) | ((int) Math.min(getGreen(color) * shade, 255) << 8) | (int) Math.min(getBlue(color) * shade, 255);
+		}
+	}
+
+	/**
+	 * Edit the given color as a HSV (Hue Saturation Value) color.
+	 */
+	public static int applySaturationAndBrightnessMultipliers(int color, float saturationMultiplier, float brightnessMultiplier)
+	{
+		float[] hsv = Color.RGBtoHSB(getRed(color), getGreen(color), getBlue(color), null);
+		return Color.getHSBColor(
+				hsv[0], // hue
+				LodUtil.clamp(0.0f, hsv[1] * saturationMultiplier, 1.0f),
+				LodUtil.clamp(0.0f, hsv[2] * brightnessMultiplier, 1.0f)).getRGB();
+	}
+
+	/**
+	 * Edit the given color as a HSV (Hue Saturation Value) color.
+	 */
+	public static int changeBrightness(int color, float brightness)
+	{
+		float[] hsv = Color.RGBtoHSB(getRed(color), getGreen(color), getBlue(color), null);
+		return Color.getHSBColor(
+				hsv[0], // hue
+				hsv[1],
+				brightness).getRGB();
+	}
+
+	/**
+	 * Edit the given color as a HSV (Hue Saturation Value) color.
+	 */
+	public static int changeBrightnessValue(int color, int brightnessColor)
+	{
+		float[] hsv = Color.RGBtoHSB(getRed(color), getGreen(color), getBlue(color), null);
+		float brightness = Color.RGBtoHSB(getRed(brightnessColor), getGreen(brightnessColor), getBlue(brightnessColor), null)[2];
+		return Color.getHSBColor(
+				hsv[0], // hue
+				hsv[1],
+				brightness).getRGB();
+	}
+	public static int multiplyRGBcolors(int color1, int color2)
+	{
+		/**TODO FIX the alpha*/
+		return 0xFF000000 | (((getRed(color1) * getRed(color2)) << 8) & 0xFF0000) | ((getGreen(color1) * getGreen(color2)) & 0xFF00) | (((getBlue(color1) * getBlue(color2)) >> 8) & 0xFF);
+	}
+
+
+	public static String toString(int color)
+	{
+		StringBuilder s = new StringBuilder();
+		s.append(Integer.toHexString(getAlpha(color)));
+		s.append(" ");
+		s.append(Integer.toHexString(getRed(color)));
+		s.append(" ");
+		s.append(Integer.toHexString(getGreen(color)));
+		s.append(" ");
+		s.append(Integer.toHexString(getBlue(color)));
+		return s.toString();
+	}
+}

src/main/java/com/seibel/lod/util/DataPointUtil.java

@@ -0,0 +1,448 @@
+package com.seibel.lod.util;
+
+import java.util.Arrays;
+
+import com.seibel.lod.enums.DistanceGenerationMode;
+
+import net.minecraft.client.renderer.texture.NativeImage;
+
+public class DataPointUtil
+{
+	/*
+	|a  |a  |a  |a  |r  |r  |r  |r   |
+
+	|r  |r  |r  |r  |g  |g  |g  |g  |
+
+	|g  |g  |g  |g  |b  |b  |b  |b  |
+
+	|b  |b  |b  |b  |h  |h  |h  |h  |
+
+	|h  |h  |h  |h  |h  |h  |d  |d  |
+
+	|d  |d  |d  |d  |d  |d  |d  |d  |
+
+	|bl |bl |bl |bl |sl |sl |sl |sl |
+
+	|l  |l  |f  |g  |g  |g  |v  |e  |
+
+
+	 */
+	//To be used in the future for negative value
+	//public final static int MIN_DEPTH = -64;
+	//public final static int MIN_HEIGHT = -64;
+	public final static int EMPTY_DATA = 0;
+	public static int worldHeight = 256;
+
+	public final static int ALPHA_DOWNSIZE_SHIFT = 4;
+
+	//public final static int BLUE_COLOR_SHIFT = 0;
+	//public final static int GREEN_COLOR_SHIFT = 8;
+	//public final static int RED_COLOR_SHIFT = 16;
+	//public final static int ALPHA_COLOR_SHIFT = 24;
+
+	public final static int BLUE_SHIFT = 36;
+	public final static int GREEN_SHIFT = BLUE_SHIFT + 8;
+	public final static int RED_SHIFT = BLUE_SHIFT + 16;
+	public final static int ALPHA_SHIFT = BLUE_SHIFT + 24;
+
+	public final static int COLOR_SHIFT = 36;
+
+	public final static int HEIGHT_SHIFT = 26;
+	public final static int DEPTH_SHIFT = 16;
+	public final static int BLOCK_LIGHT_SHIFT = 12;
+	public final static int SKY_LIGHT_SHIFT = 8;
+	//public final static int LIGHTS_SHIFT = SKY_LIGHT_SHIFT;
+	//public final static int VERTICAL_INDEX_SHIFT = 6;
+	//public final static int FLAG_SHIFT = 5;
+	public final static int GEN_TYPE_SHIFT = 2;
+	public final static int VOID_SHIFT = 1;
+	public final static int EXISTENCE_SHIFT = 0;
+
+	public final static long ALPHA_MASK = 0b1111;
+	public final static long RED_MASK = 0b1111_1111;
+	public final static long GREEN_MASK = 0b1111_1111;
+	public final static long BLUE_MASK = 0b1111_1111;
+	//public final static long COLOR_MASK = 0b11111111_11111111_11111111;
+	public final static long HEIGHT_MASK = 0b11_1111_1111;
+	public final static long DEPTH_MASK = 0b11_1111_1111;
+	//public final static long LIGHTS_MASK = 0b1111_1111;
+	public final static long BLOCK_LIGHT_MASK = 0b1111;
+	public final static long SKY_LIGHT_MASK = 0b1111;
+	//public final static long VERTICAL_INDEX_MASK = 0b11;
+	//public final static long FLAG_MASK = 0b1;
+	public final static long GEN_TYPE_MASK = 0b111;
+	public final static long VOID_MASK = 1;
+	public final static long EXISTENCE_MASK = 1;
+
+
+	public static long createVoidDataPoint(int generationMode)
+	{
+		long dataPoint = 0;
+		dataPoint += (generationMode & GEN_TYPE_MASK) << GEN_TYPE_SHIFT;
+		dataPoint += VOID_MASK << VOID_SHIFT;
+		dataPoint += EXISTENCE_MASK << EXISTENCE_SHIFT;
+		return dataPoint;
+	}
+
+	public static long createDataPoint(int height, int depth, int color, int lightSky, int lightBlock, int generationMode)
+	{
+		return createDataPoint(
+				ColorUtil.getAlpha(color),
+				ColorUtil.getRed(color),
+				ColorUtil.getGreen(color),
+				ColorUtil.getBlue(color),
+				height, depth, lightSky, lightBlock, generationMode);
+	}
+
+	public static long createDataPoint(int alpha, int red, int green, int blue, int height, int depth, int lightSky, int lightBlock, int generationMode)
+	{
+		long dataPoint = 0;
+		dataPoint += ((alpha >>> ALPHA_DOWNSIZE_SHIFT) & ALPHA_MASK) << ALPHA_SHIFT;
+		dataPoint += (red & RED_MASK) << RED_SHIFT;
+		dataPoint += (green & GREEN_MASK) << GREEN_SHIFT;
+		dataPoint += (blue & BLUE_MASK) << BLUE_SHIFT;
+		dataPoint += (height & HEIGHT_MASK) << HEIGHT_SHIFT;
+		dataPoint += (depth & DEPTH_MASK) << DEPTH_SHIFT;
+		dataPoint += (lightBlock & BLOCK_LIGHT_MASK) << BLOCK_LIGHT_SHIFT;
+		dataPoint += (lightSky & SKY_LIGHT_MASK) << SKY_LIGHT_SHIFT;
+		dataPoint += (generationMode & GEN_TYPE_MASK) << GEN_TYPE_SHIFT;
+		dataPoint += EXISTENCE_MASK << EXISTENCE_SHIFT;
+		return dataPoint;
+	}
+
+	public static short getHeight(long dataPoint)
+	{
+		return (short) ((dataPoint >>> HEIGHT_SHIFT) & HEIGHT_MASK);
+	}
+
+	public static short getDepth(long dataPoint)
+	{
+
+		return (short) ((dataPoint >>> DEPTH_SHIFT) & DEPTH_MASK);
+	}
+
+	public static short getAlpha(long dataPoint)
+	{
+		return (short) (((dataPoint >>> ALPHA_SHIFT) & ALPHA_MASK) << ALPHA_DOWNSIZE_SHIFT);
+	}
+
+	public static short getRed(long dataPoint)
+	{
+		return (short) ((dataPoint >>> RED_SHIFT) & RED_MASK);
+	}
+
+	public static short getGreen(long dataPoint)
+	{
+		return (short) ((dataPoint >>> GREEN_SHIFT) & GREEN_MASK);
+	}
+
+	public static short getBlue(long dataPoint)
+	{
+		return (short) ((dataPoint >>> BLUE_SHIFT) & BLUE_MASK);
+	}
+
+	public static int getLightSky(long dataPoint)
+	{
+		return (int) ((dataPoint >>> SKY_LIGHT_SHIFT) & SKY_LIGHT_MASK);
+	}
+
+	public static int getLightBlock(long dataPoint)
+	{
+		return (int) ((dataPoint >>> BLOCK_LIGHT_SHIFT) & BLOCK_LIGHT_MASK);
+	}
+
+	public static byte getGenerationMode(long dataPoint)
+	{
+		return (byte) ((dataPoint >>> GEN_TYPE_SHIFT) & GEN_TYPE_MASK);
+	}
+
+
+	public static boolean isItVoid(long dataPoint)
+	{
+		return (((dataPoint >>> VOID_SHIFT) & VOID_MASK) == 1);
+	}
+
+	public static boolean doesItExist(long dataPoint)
+	{
+		return (((dataPoint >>> EXISTENCE_SHIFT) & EXISTENCE_MASK) == 1);
+	}
+
+	public static int getColor(long dataPoint)
+	{
+		//int color = getBlue(dataPoint) << BLUE_COLOR_SHIFT;
+		//color += getRed(dataPoint) << BLUE_COLOR_SHIFT;
+		return (int) (dataPoint >>> COLOR_SHIFT);
+	}
+
+	public static int getLightColor(long dataPoint, NativeImage lightMap)
+	{
+		int lightBlock = getLightBlock(dataPoint);
+		int lightSky = getLightSky(dataPoint);
+		int color = lightMap.getPixelRGBA(lightBlock, lightSky);
+		int red = ColorUtil.getBlue(color);
+		int green = ColorUtil.getGreen(color);
+		int blue = ColorUtil.getRed(color);
+
+		return ColorUtil.multiplyRGBcolors(getColor(dataPoint), ColorUtil.rgbToInt(red, green, blue));
+	}
+
+	public static String toString(long dataPoint)
+	{
+		StringBuilder s = new StringBuilder();
+		s.append(getHeight(dataPoint));
+		s.append(" ");
+		s.append(getDepth(dataPoint));
+		s.append(" ");
+		s.append(getAlpha(dataPoint));
+		s.append(" ");
+		s.append(getRed(dataPoint));
+		s.append(" ");
+		s.append(getBlue(dataPoint));
+		s.append(" ");
+		s.append(getGreen(dataPoint));
+		s.append(" ");
+		s.append(getLightBlock(dataPoint));
+		s.append(" ");
+		s.append(getLightSky(dataPoint));
+		s.append(" ");
+		s.append(getGenerationMode(dataPoint));
+		s.append(" ");
+		s.append(isItVoid(dataPoint));
+		s.append(" ");
+		s.append(doesItExist(dataPoint));
+		s.append('\n');
+		return s.toString();
+	}
+
+	public static long mergeSingleData(long[] dataToMerge)
+	{
+		int numberOfChildren = 0;
+
+		int tempAlpha = 0;
+		int tempRed = 0;
+		int tempGreen = 0;
+		int tempBlue = 0;
+		int tempHeight = Integer.MIN_VALUE;
+		int tempDepth = Integer.MAX_VALUE;
+		int tempLightBlock = 0;
+		int tempLightSky = 0;
+		byte tempGenMode = DistanceGenerationMode.SERVER.complexity;
+		boolean allEmpty = true;
+		boolean allVoid = true;
+		for (long data : dataToMerge)
+		{
+			if (DataPointUtil.doesItExist(data))
+			{
+				allEmpty = false;
+				if (!(DataPointUtil.isItVoid(data)))
+				{
+					numberOfChildren++;
+					allVoid = false;
+					tempAlpha += DataPointUtil.getAlpha(data);
+					tempRed += DataPointUtil.getRed(data);
+					tempGreen += DataPointUtil.getGreen(data);
+					tempBlue += DataPointUtil.getBlue(data);
+					tempHeight = Math.max(tempHeight, DataPointUtil.getHeight(data));
+					tempDepth = Math.min(tempDepth, DataPointUtil.getDepth(data));
+					tempLightBlock += DataPointUtil.getLightBlock(data);
+					tempLightSky += DataPointUtil.getLightSky(data);
+				}
+				tempGenMode = (byte) Math.min(tempGenMode, DataPointUtil.getGenerationMode(data));
+			} else
+			{
+				tempGenMode = (byte) Math.min(tempGenMode, DistanceGenerationMode.NONE.complexity);
+			}
+		}
+
+		if (allEmpty)
+		{
+			//no child has been initialized
+			return DataPointUtil.EMPTY_DATA;
+		} else if (allVoid)
+		{
+			//all the children are void
+			return DataPointUtil.createVoidDataPoint(tempGenMode);
+		} else
+		{
+			//we have at least 1 child
+			tempAlpha = tempAlpha / numberOfChildren;
+			tempRed = tempRed / numberOfChildren;
+			tempGreen = tempGreen / numberOfChildren;
+			tempBlue = tempBlue / numberOfChildren;
+			tempLightBlock = tempLightBlock / numberOfChildren;
+			tempLightSky = tempLightSky / numberOfChildren;
+			return DataPointUtil.createDataPoint(tempAlpha, tempRed, tempGreen, tempBlue, tempHeight, tempDepth, tempLightSky, tempLightBlock, tempGenMode);
+		}
+	}
+
+	public static long[] mergeMultiData(long[] dataToMerge, int inputVerticalData, int maxVerticalData)
+	{
+		int size = dataToMerge.length / inputVerticalData;
+
+		//We initialise the arrays that are going to be used
+		short[] projection = ThreadMapUtil.getProjectionShort();
+		short[] heightAndDepth = ThreadMapUtil.getHeightAndDepth();
+		long[] singleDataToMerge = ThreadMapUtil.getSingleAddDataToMerge();
+		long[] dataPoint = ThreadMapUtil.verticalDataArray();
+
+		if (projection == null || projection.length != (worldHeight) / 16 + 1)
+			projection = new short[(worldHeight) / 16 + 1];
+		else
+			Arrays.fill(projection, (short) 0);
+
+		if (heightAndDepth == null || heightAndDepth.length != (worldHeight + 1) * 2)
+			heightAndDepth = new short[(worldHeight + 1) * 2];
+		else
+			Arrays.fill(heightAndDepth, (short) 0);
+
+		if (singleDataToMerge == null || singleDataToMerge.length != size)
+			singleDataToMerge = new long[size];
+		else
+			Arrays.fill(singleDataToMerge, EMPTY_DATA);
+
+		if (dataPoint == null || dataPoint.length != worldHeight + 1)
+			dataPoint = new long[worldHeight + 1];
+		else
+			Arrays.fill(dataPoint, EMPTY_DATA);
+
+		int genMode = DistanceGenerationMode.SERVER.complexity;
+		boolean allEmpty = true;
+		boolean allVoid = true;
+		long singleData;
+
+
+		short depth;
+		short height;
+
+		//We collect the indexes of the data, ordered by the depth
+		for (int index = 0; index < size; index++)
+		{
+			for (int dataIndex = 0; dataIndex < inputVerticalData; dataIndex++)
+			{
+				singleData = dataToMerge[index * inputVerticalData + dataIndex];
+				if (doesItExist(singleData))
+				{
+					genMode = Math.min(genMode, getGenerationMode(singleData));
+					allEmpty = false;
+					if (!isItVoid(singleData))
+					{
+						allVoid = false;
+						depth = getDepth(singleData);
+						height = getHeight(singleData);
+						for (int y = depth; y <= height; y++)
+							projection[y / 16] |= 1 << (y & 0xf);
+					}
+				}
+			}
+		}
+		//We check if there is any data that's not empty or void
+		if (allEmpty)
+		{
+			return dataPoint;
+		}
+		if (allVoid)
+		{
+			dataPoint[0] = createVoidDataPoint(genMode);
+			return dataPoint;
+		}
+		//We extract the merged data
+		int count = 0;
+		int i = 0;
+		int ii = 0;
+		while (i < projection.length)
+		{
+			while (i < projection.length && projection[i] == 0) i++;
+			if (i == projection.length)
+				break; //we reached end of WORLD_HEIGHT and it's nothing more here
+			while (ii < 15 && ((projection[i] >>> ii) & 1) == 0) ii++;
+			if (ii >= 15 && ((projection[i] >>> ii) & 1) == 0) //there is nothing more in this chunk
+			{
+				ii = 0;
+				i++;
+				continue;
+			}
+			depth = (short) (i * 16 + ii);
+
+			while (ii < 15 && ((projection[i] >>> ii) & 1) == 1) ii++;
+			if (ii >= 15 && ((projection[i] >>> ii) & 1) == 1) //if end is not in this chunk
+			{
+				ii = 0;
+				i++;
+				while (i < projection.length && ~(projection[i]) == 0) i++; //check for big solid blocks
+				if (i == projection.length) //solid to WORLD_HEIGHT
+				{
+					heightAndDepth[count * 2] = depth;
+					heightAndDepth[count * 2 + 1] = (short) (worldHeight - 1);
+					break;
+				}
+				while ((((projection[i] >>> ii) & 1) == 1)) ii++;
+			}
+			height = (short) (i * 16 + ii - 1);
+			heightAndDepth[count * 2] = depth;
+			heightAndDepth[count * 2 + 1] = height;
+			count++;
+		}
+
+		//we limit the vertical portion to maxVerticalData
+		int j = 0;
+		while (count > maxVerticalData)
+		{
+			ii = worldHeight;
+			for (i = 0; i < count - 1; i++)
+			{
+				if (heightAndDepth[(i + 1) * 2] - heightAndDepth[i * 2 + 1] < ii)
+				{
+					ii = heightAndDepth[(i + 1) * 2] - heightAndDepth[i * 2 + 1];
+					j = i;
+				}
+			}
+			heightAndDepth[j * 2 + 1] = heightAndDepth[(j + 1) * 2 + 1];
+			for (i = j + 1; i < count - 1; i++)
+			{
+				heightAndDepth[i * 2] = heightAndDepth[(i + 1) * 2];
+				heightAndDepth[i * 2 + 1] = heightAndDepth[(i + 1) * 2 + 1];
+			}
+			//System.arraycopy(heightAndDepth,j + 1, heightAndDepth, j,count - j - 1);
+			count--;
+		}
+		//As standard the vertical lods are ordered from top to bottom
+		for (j = 0; j < count; j++)
+		{
+			depth = heightAndDepth[j * 2];
+			height = heightAndDepth[j * 2 + 1];
+			if ((depth == 0 && height == 0) || j >= heightAndDepth.length / 2)
+				break;
+			for (int k = 0; k < size; k++)
+			{
+				singleDataToMerge[k] = 0;
+			}
+			for (int index = 0; index < size; index++)
+			{
+				for (int dataIndex = 0; dataIndex < inputVerticalData; dataIndex++)
+				{
+					singleData = dataToMerge[index * inputVerticalData + dataIndex];
+					if (doesItExist(singleData) && !isItVoid(singleData))
+					{
+						if ((depth <= getDepth(singleData) && getDepth(singleData) <= height)
+								    || (depth <= getHeight(singleData) && getHeight(singleData) <= height))
+						{
+							if (getHeight(singleData) > getHeight(singleDataToMerge[index]))
+							{
+								singleDataToMerge[index] = singleData;
+							}
+						}
+					}
+				}
+			}
+			long data = mergeSingleData(singleDataToMerge);
+
+			dataPoint[count - j - 1] = createDataPoint(height, depth, getColor(data), getLightSky(data), getLightBlock(data), getGenerationMode(data));
+		}
+		return dataPoint;
+	}
+
+	public static long[] compress(long[] data, byte detailLevel)
+	{
+		return null;
+	}
+}

src/main/java/com/seibel/lod/util/DetailDistanceUtil.java

@@ -0,0 +1,168 @@
+package com.seibel.lod.util;
+
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.enums.HorizontalResolution;
+
+public class DetailDistanceUtil
+{
+	private static double genMultiplier = 1.0;
+	private static double treeGenMultiplier = 1.0;
+	private static double treeCutMultiplier = 1.0;
+	private static int minGenDetail = LodConfig.CLIENT.worldGenerator.generationResolution.get().detailLevel;
+	private static int minDrawDetail = Math.max(LodConfig.CLIENT.graphics.drawResolution.get().detailLevel,LodConfig.CLIENT.worldGenerator.generationResolution.get().detailLevel);
+	private static int maxDetail = LodUtil.REGION_DETAIL_LEVEL + 1;
+	private static int minDistance = 0;
+	private static int maxDistance = LodConfig.CLIENT.graphics.lodChunkRenderDistance.get() * 16 * 2;
+	private static int base = 2;
+	private static double logBase = Math.log(2);
+
+	private static int[] maxVerticalData = {
+			4,
+			4,
+			4,
+			2,
+			2,
+			1,
+			1,
+			1,
+			1,
+			1,
+			1};
+
+
+	private static HorizontalResolution[] lodGenDetails = {
+			HorizontalResolution.BLOCK,
+			HorizontalResolution.TWO_BLOCKS,
+			HorizontalResolution.FOUR_BLOCKS,
+			HorizontalResolution.HALF_CHUNK,
+			HorizontalResolution.CHUNK,
+			HorizontalResolution.CHUNK,
+			HorizontalResolution.CHUNK,
+			HorizontalResolution.CHUNK,
+			HorizontalResolution.CHUNK,
+			HorizontalResolution.CHUNK,
+			HorizontalResolution.CHUNK};
+
+
+
+	public static void updateSettings(){
+		minGenDetail = LodConfig.CLIENT.worldGenerator.generationResolution.get().detailLevel;
+		minDrawDetail = Math.max(LodConfig.CLIENT.graphics.drawResolution.get().detailLevel,LodConfig.CLIENT.worldGenerator.generationResolution.get().detailLevel);
+		maxDistance = LodConfig.CLIENT.graphics.lodChunkRenderDistance.get() * 16 * 2;
+	}
+
+	public static int baseDistanceFunction(int detail)
+	{
+		int distanceUnit = LodConfig.CLIENT.graphics.horizontalQuality.get().distanceUnit;
+		if (detail <= minGenDetail)
+			return minDistance;
+		if (detail == maxDetail)
+			return maxDistance;
+		if (detail == maxDetail + 1)
+			return maxDistance;
+		switch (LodConfig.CLIENT.worldGenerator.lodDistanceCalculatorType.get())
+		{
+			case LINEAR:;
+				return (detail * distanceUnit);
+			default:
+			case QUADRATIC:
+				return (int) (Math.pow(base, detail) * distanceUnit);
+		}
+	}
+
+	public static byte baseInverseFunction(int distance, int minDetail)
+	{
+		int distanceUnit = LodConfig.CLIENT.graphics.horizontalQuality.get().distanceUnit;
+		byte detail = 0;
+		if (distance == 0)
+			detail = (byte) minDetail;
+		if (distance > maxDistance)
+			detail = (byte) (maxDetail-1);
+		switch (LodConfig.CLIENT.worldGenerator.lodDistanceCalculatorType.get())
+		{
+			case LINEAR:
+				detail = (byte) Math.floorDiv(distance, distanceUnit);
+				break;
+			case QUADRATIC:
+				detail = (byte) (Math.log(Math.floorDiv(distance, distanceUnit))/logBase);
+				break;
+		}
+		return (byte) Math.min(detail, LodUtil.REGION_DETAIL_LEVEL);
+	}
+
+	public static byte getDrawDetailFromDistance(int distance)
+	{
+		return baseInverseFunction(distance, minDrawDetail);
+	}
+
+	public static byte getGenerationDetailFromDistance(int distance)
+	{
+		return baseInverseFunction((int) (distance * genMultiplier), minGenDetail);
+	}
+
+	public static byte getTreeCutDetailFromDistance(int distance)
+	{
+		return baseInverseFunction((int) (distance * treeCutMultiplier), minGenDetail);
+	}
+
+
+	public static byte getTreeGenDetailFromDistance(int distance)
+	{
+		return baseInverseFunction((int) (distance * treeGenMultiplier), minGenDetail);
+	}
+
+	public static DistanceGenerationMode getDistanceGenerationMode(int detail)
+	{
+		return LodConfig.CLIENT.worldGenerator.distanceGenerationMode.get();
+	}
+
+	public static byte getLodDrawDetail(int detail)
+	{
+		if (detail < minDrawDetail)
+		{
+			if(LodConfig.CLIENT.graphics.alwaysDrawAtMaxQuality.get())
+				return getLodGenDetail(minDrawDetail).detailLevel;
+			else
+				return (byte) minDrawDetail;
+		} else
+		{
+			if(LodConfig.CLIENT.graphics.alwaysDrawAtMaxQuality.get())
+				return getLodGenDetail(detail).detailLevel;
+			else
+				return (byte) detail;
+		}
+	}
+
+	public static HorizontalResolution getLodGenDetail(int detail)
+	{
+		if (detail < minGenDetail)
+		{
+			return lodGenDetails[minGenDetail];
+		} else
+		{
+			return lodGenDetails[detail];
+		}
+	}
+
+
+	public static byte getCutLodDetail(int detail)
+	{
+		if (detail < minGenDetail)
+		{
+			return lodGenDetails[minGenDetail].detailLevel;
+		} else if (detail == maxDetail)
+		{
+			return LodUtil.REGION_DETAIL_LEVEL;
+		} else
+		{
+			return lodGenDetails[detail].detailLevel;
+		}
+	}
+
+	public static int getMaxVerticalData(int detail)
+	{
+		return maxVerticalData[LodUtil.clamp(minGenDetail, detail, LodUtil.REGION_DETAIL_LEVEL)];
+	}
+
+}

src/main/java/com/seibel/lod/util/LevelPosUtil.java

@@ -0,0 +1,264 @@
+package com.seibel.lod.util;
+
+public class LevelPosUtil
+{
+	public static int[] convert(int[] levelPos, byte newDetailLevel)
+	{
+		return convert(getDetailLevel(levelPos), getPosX(levelPos), getPosZ(levelPos), newDetailLevel);
+	}
+
+	public static int[] convert(byte detailLevel, int posX, int posZ, byte newDetailLevel)
+	{
+		int width;
+		if (newDetailLevel >= detailLevel)
+		{
+			width = 1 << (newDetailLevel - detailLevel);
+			return createLevelPos(
+					newDetailLevel,
+					Math.floorDiv(posX, width),
+					Math.floorDiv(posZ, width));
+		} else
+		{
+			width = 1 << (detailLevel - newDetailLevel);
+			return createLevelPos(
+					newDetailLevel,
+					posX * width,
+					posZ * width);
+		}
+	}
+
+	public static int[] createLevelPos(byte detailLevel, int posX, int posZ)
+	{
+		return new int[]{detailLevel, posX, posZ};
+	}
+
+	public static int convert(byte detailLevel, int pos, byte newDetailLevel)
+	{
+		int width;
+		if (newDetailLevel >= detailLevel)
+		{
+			width = 1 << (newDetailLevel - detailLevel);
+			return Math.floorDiv(pos, width);
+		} else
+		{
+			width = 1 << (detailLevel - newDetailLevel);
+			return pos * width;
+		}
+	}
+
+	public static int getRegion(byte detailLevel, int pos)
+	{
+		return Math.floorDiv(pos, 1 << (LodUtil.REGION_DETAIL_LEVEL - detailLevel));
+	}
+
+	public static int getRegionModule(byte detailLevel, int pos)
+	{
+		return Math.floorMod(pos, 1 << (LodUtil.REGION_DETAIL_LEVEL - detailLevel));
+	}
+
+	public static byte getDetailLevel(int[] levelPos)
+	{
+		return (byte) levelPos[0];
+	}
+
+	public static int getPosX(int[] levelPos)
+	{
+		return levelPos[1];
+	}
+
+	public static int getPosZ(int[] levelPos)
+	{
+		return levelPos[2];
+	}
+
+	public static int getDistance(int[] levelPos)
+	{
+		return levelPos[3];
+	}
+
+	public static int[] getRegionModule(int[] levelPos)
+	{
+		return getRegionModule(getDetailLevel(levelPos), getPosX(levelPos), getPosZ(levelPos));
+	}
+
+	public static int[] getRegionModule(byte detailLevel, int posX, int posZ)
+	{
+		int width = 1 << (LodUtil.REGION_DETAIL_LEVEL - detailLevel);
+		return createLevelPos(
+				detailLevel,
+				Math.floorMod(posX, width),
+				Math.floorMod(posZ, width));
+	}
+
+	public static int[] applyOffset(int[] levelPos, int xOffset, int zOffset)
+	{
+		return createLevelPos(
+				getDetailLevel(levelPos),
+				getPosX(levelPos) + xOffset,
+				getPosZ(levelPos) + zOffset);
+	}
+
+	public static int[] applyLevelOffset(int[] levelPos, byte detailOffset, int xOffset, int zOffset)
+	{
+		return createLevelPos(
+				getDetailLevel(levelPos),
+				getPosX(levelPos) + xOffset * (1 << detailOffset),
+				getPosZ(levelPos) + zOffset * (1 << detailOffset));
+	}
+
+	public static int getRegionPosX(int[] levelPos)
+	{
+		int width = 1 << (LodUtil.REGION_DETAIL_LEVEL - getDetailLevel(levelPos));
+		return Math.floorDiv(getPosX(levelPos), width);
+	}
+
+	public static int getRegionPosZ(int[] levelPos)
+	{
+		int width = 1 << (LodUtil.REGION_DETAIL_LEVEL - getDetailLevel(levelPos));
+		return Math.floorDiv(getPosZ(levelPos), width);
+	}
+
+	public static int getChunkPos(byte detailLevel, int pos)
+	{
+		return convert(detailLevel,pos, LodUtil.CHUNK_DETAIL_LEVEL);
+	}
+
+
+	public static int maxDistance(byte detailLevel, int posX, int posZ, int playerPosX, int playerPosZ)
+	{
+		int width = 1 << detailLevel;
+
+		int startPosX = posX * width;
+		int startPosZ = posZ * width;
+		int endPosX = startPosX + width;
+		int endPosZ = startPosZ + width;
+
+		int maxDistance = (int) Math.sqrt(Math.pow(playerPosX - startPosX, 2) + Math.pow(playerPosZ - startPosZ, 2));
+		maxDistance = Math.max(maxDistance, (int) Math.sqrt(Math.pow(playerPosX - startPosX, 2) + Math.pow(playerPosZ - endPosZ, 2)));
+		maxDistance = Math.max(maxDistance, (int) Math.sqrt(Math.pow(playerPosX - endPosX, 2) + Math.pow(playerPosZ - startPosZ, 2)));
+		maxDistance = Math.max(maxDistance, (int) Math.sqrt(Math.pow(playerPosX - endPosX, 2) + Math.pow(playerPosZ - endPosZ, 2)));
+
+		return maxDistance;
+	}
+
+	public static int maxDistance(byte detailLevel, int posX, int posZ, int playerPosX, int playerPosZ, int xRegion, int zRegion)
+	{
+		int width = 1 << detailLevel;
+
+		int startPosX = xRegion * 512 + posX * width;
+		int startPosZ = zRegion * 512 + posZ * width;
+		int endPosX = startPosX + width;
+		int endPosZ = startPosZ + width;
+
+		int maxDistance = (int) Math.sqrt(Math.pow(playerPosX - startPosX, 2) + Math.pow(playerPosZ - startPosZ, 2));
+		maxDistance = Math.max(maxDistance, (int) Math.sqrt(Math.pow(playerPosX - startPosX, 2) + Math.pow(playerPosZ - endPosZ, 2)));
+		maxDistance = Math.max(maxDistance, (int) Math.sqrt(Math.pow(playerPosX - endPosX, 2) + Math.pow(playerPosZ - startPosZ, 2)));
+		maxDistance = Math.max(maxDistance, (int) Math.sqrt(Math.pow(playerPosX - endPosX, 2) + Math.pow(playerPosZ - endPosZ, 2)));
+
+		return maxDistance;
+	}
+
+
+	public static int minDistance(byte detailLevel, int posX, int posZ, int playerPosX, int playerPosZ)
+	{
+		int width = 1 << detailLevel;
+
+		int startPosX = posX * width;
+		int startPosZ = posZ * width;
+		int endPosX = startPosX + width;
+		int endPosZ = startPosZ + width;
+
+		boolean inXArea = playerPosX >= startPosX && playerPosX <= endPosX;
+		boolean inZArea = playerPosZ >= startPosZ && playerPosZ <= endPosZ;
+		if (inXArea && inZArea)
+		{
+			return 0;
+		} else if (inXArea)
+		{
+			return Math.min(
+					Math.abs(playerPosZ - startPosZ),
+					Math.abs(playerPosZ - endPosZ)
+			);
+		} else if (inZArea)
+		{
+			return Math.min(
+					Math.abs(playerPosX - startPosX),
+					Math.abs(playerPosX - endPosX)
+			);
+		} else
+		{
+			int minDistance = (int) Math.sqrt(Math.pow(playerPosX - startPosX, 2) + Math.pow(playerPosZ - startPosZ, 2));
+			minDistance = Math.min(minDistance, (int) Math.sqrt(Math.pow(playerPosX - startPosX, 2) + Math.pow(playerPosZ - endPosZ, 2)));
+			minDistance = Math.min(minDistance, (int) Math.sqrt(Math.pow(playerPosX - endPosX, 2) + Math.pow(playerPosZ - startPosZ, 2)));
+			minDistance = Math.min(minDistance, (int) Math.sqrt(Math.pow(playerPosX - endPosX, 2) + Math.pow(playerPosZ - endPosZ, 2)));
+			return minDistance;
+		}
+	}
+
+	public static int minDistance(byte detailLevel, int posX, int posZ, int playerPosX, int playerPosZ, int xRegion, int zRegion)
+	{
+		int width = 1 << detailLevel;
+
+		int startPosX = xRegion * 512 + posX * width;
+		int startPosZ = zRegion * 512 + posZ * width;
+		int endPosX = startPosX + width;
+		int endPosZ = startPosZ + width;
+
+		boolean inXArea = playerPosX >= startPosX && playerPosX <= endPosX;
+		boolean inZArea = playerPosZ >= startPosZ && playerPosZ <= endPosZ;
+		if (inXArea && inZArea)
+		{
+			return 0;
+		} else if (inXArea)
+		{
+			return Math.min(
+					Math.abs(playerPosZ - startPosZ),
+					Math.abs(playerPosZ - endPosZ)
+			);
+		} else if (inZArea)
+		{
+			return Math.min(
+					Math.abs(playerPosX - startPosX),
+					Math.abs(playerPosX - endPosX)
+			);
+		} else
+		{
+			int minDistance = (int) Math.sqrt(Math.pow(playerPosX - startPosX, 2) + Math.pow(playerPosZ - startPosZ, 2));
+			minDistance = Math.min(minDistance, (int) Math.sqrt(Math.pow(playerPosX - startPosX, 2) + Math.pow(playerPosZ - endPosZ, 2)));
+			minDistance = Math.min(minDistance, (int) Math.sqrt(Math.pow(playerPosX - endPosX, 2) + Math.pow(playerPosZ - startPosZ, 2)));
+			minDistance = Math.min(minDistance, (int) Math.sqrt(Math.pow(playerPosX - endPosX, 2) + Math.pow(playerPosZ - endPosZ, 2)));
+			return minDistance;
+		}
+	}
+
+	public static int compareDistance(int firstDistance, int secondDistance)
+	{
+		return Integer.compare(
+				firstDistance,
+				secondDistance);
+	}
+
+
+	public static int compareLevelAndDistance(byte firstDetail, int firstDistance, byte secondDetail, int secondDistance)
+	{
+		int compareResult = Integer.compare(
+				secondDetail,
+				firstDetail);
+		if (compareResult == 0)
+		{
+			compareResult = Integer.compare(
+					firstDistance,
+					secondDistance);
+		}
+		return compareResult;
+	}
+
+	public static String toString(int[] levelPos)
+	{
+		return (getDetailLevel(levelPos) + " " + getPosX(levelPos) + " " + getPosZ(levelPos));
+	}
+	public static String toString(byte detailLevel, int posX, int posZ)
+	{
+		return (detailLevel + " " + posX + " " + posZ);
+	}
+}

src/main/java/com/seibel/lod/util/LodConfig.java

@@ -1,149 +0,0 @@
-package com.seibel.lod.util;
-
-import java.nio.file.Path;
-import java.nio.file.Paths;
-
-import org.apache.commons.lang3.tuple.Pair;
-import org.apache.logging.log4j.LogManager;
-
-import com.electronwill.nightconfig.core.file.CommentedFileConfig;
-import com.electronwill.nightconfig.core.io.WritingMode;
-import com.seibel.lod.ModInfo;
-import com.seibel.lod.enums.FogDistance;
-import com.seibel.lod.enums.LodColorStyle;
-import com.seibel.lod.enums.LodDetail;
-import com.seibel.lod.enums.LodTemplate;
-
-import net.minecraftforge.common.ForgeConfigSpec;
-import net.minecraftforge.eventbus.api.SubscribeEvent;
-import net.minecraftforge.fml.common.Mod;
-import net.minecraftforge.fml.config.ModConfig;
-
-/**
- * 
- * @author James Seibel
- * @version 05-31-2021
- */
-@Mod.EventBusSubscriber
-public class LodConfig
-{
-	public static class Client
-	{
-		public ForgeConfigSpec.BooleanValue drawLODs;
-		
-		public ForgeConfigSpec.EnumValue<FogDistance> fogDistance;
-		
-		public ForgeConfigSpec.BooleanValue debugMode;
-		
-		public ForgeConfigSpec.EnumValue<LodTemplate> lodTemplate;
-		
-		public ForgeConfigSpec.EnumValue<LodDetail> lodDetail;
-		
-		public ForgeConfigSpec.EnumValue<LodColorStyle> lodColorStyle;
-		
-		/** this is multiplied by the default view distance
-		 * to determine how far out to generate/render LODs */
-		public ForgeConfigSpec.IntValue lodChunkRadiusMultiplier;
-		
-		Client(ForgeConfigSpec.Builder builder)
-		{
-	        builder.comment(ModInfo.MODNAME + " configuration settings").push("client");
-	        
-	        drawLODs = builder
-	        		.comment("\n"
-	        				+ " If false LODs will not be drawn, \n"
-	        				+ " however they will still be generated \n"
-	        				+ " and saved to file for later use.")
-	        		.define("drawLODs", true);
-	        
-	        fogDistance = builder
-	                .comment("\n"
-	                		+ " At what distance should Fog be drawn on the LODs? \n"
-	                		+ " If the fog cuts off ubruptly or you are using Optifine's \"fast\" \n"
-	                		+ " fog option set this to " + FogDistance.NEAR.toString() + " or " + FogDistance.FAR.toString() + ".")
-	                .defineEnum("fogDistance", FogDistance.NEAR_AND_FAR);
-	        
-	        debugMode = builder
-	                .comment("\n"
-	                		+ " If false the LODs will draw with their normal world colors. \n"
-	                		+ " If true they will draw as a black and white checkerboard. \n"
-	                		+ " This can be used for debugging or imagining you are playing a \n"
-	                		+ " giant game of chess ;)")
-	                .define("drawCheckerBoard", false);
-	        
-	        lodTemplate = builder
-	                .comment("\n"
-	                		+ " How should the LODs be drawn? \n"
-	                		+ " " + LodTemplate.CUBIC.toString() + ": LOD Chunks are drawn as rectangular prisms (boxes). \n"
-	                		+ " " + LodTemplate.TRIANGULAR.toString() + ": LOD Chunks smoothly transition between other. \n"
-	                		+ " " + LodTemplate.DYNAMIC.toString() + ": LOD Chunks smoothly transition between other, "
-	                		+ " " + "         unless a neighboring chunk is at a significantly different height. ")
-	                .defineEnum("lodTemplate", LodTemplate.CUBIC);
-	        
-	        lodDetail = builder
-	                .comment("\n"
-	                		+ " How detailed should the LODs be? \n"
-	                		+ " " + LodDetail.SINGLE.toString() + ": render 1 LOD for each Chunk. \n"
-            				+ " " + LodDetail.DOUBLE.toString() + ": render 4 LODs for each Chunk.")
-	                .defineEnum("lodGeometryQuality", LodDetail.SINGLE);
-	        
-	        lodColorStyle = builder
-	                .comment("\n"
-	                		+ " How should the LODs be colored? \n"
-	                		+ " " + LodColorStyle.TOP.toString() + ": Use the color from the top of the LOD chunk for all sides. \n"
-	                		+ " " + LodColorStyle.INDIVIDUAL_SIDES.toString() + ": For each side of the LOD use the color corresponding to that side. ")
-	                .defineEnum("lodColorStyle", LodColorStyle.TOP);
-	        
-	        lodChunkRadiusMultiplier = builder
-	                .comment("\n"
-	                		+ " This is multiplied by the default view distance \n"
-	                		+ " to determine how far out to generate/render LODs. \n"
-	                		+ " A value of 2 means that there is 1 render distance worth \n"
-	                		+ " of LODs in each cardinal direction.")
-	                .defineInRange("lodChunkRadiusMultiplier", 6, 2, 1023);
-	        
-	        builder.pop();
-	    }
-	}
-	
-	
-
-    /**
-     * {@link Path} to the configuration file of this mod
-     */
-    private static final Path CONFIG_PATH =
-            Paths.get("config", ModInfo.MODID + ".toml");
-
-    public static final ForgeConfigSpec clientSpec;
-    public static final Client CLIENT;
-    static {
-        final Pair<Client, ForgeConfigSpec> specPair = new ForgeConfigSpec.Builder().configure(Client::new);
-        clientSpec = specPair.getRight();
-        CLIENT = specPair.getLeft();
-        
-        // setup the config file
-        CommentedFileConfig config = CommentedFileConfig.builder(CONFIG_PATH)
-                .writingMode(WritingMode.REPLACE)
-                .build();
-        config.load();
-        config.save();
-        clientSpec.setConfig(config);
-    }
-    
-    
-    @SubscribeEvent
-    public static void onLoad(final ModConfig.Loading configEvent)
-    {
-        LogManager.getLogger().debug(ModInfo.MODNAME, "Loaded forge config file {}", configEvent.getConfig().getFileName());
-    }
-    
-    @SubscribeEvent
-    public static void onFileChange(final ModConfig.Reloading configEvent)
-    {
-        LogManager.getLogger().debug(ModInfo.MODNAME, "Forge config just got changed on the file system!");
-    }
-    
-    
-    
-    
-}

src/main/java/com/seibel/lod/util/LodThreadFactory.java

@@ -0,0 +1,28 @@
+package com.seibel.lod.util;
+
+import java.util.concurrent.ThreadFactory;
+
+/**
+ * Just a simple ThreadFactory to name ExecutorService
+ * threads, which can be helpful when debugging.
+ * 
+ * @author James Seibel
+ * @version 8-15-2021
+ */
+public class LodThreadFactory implements ThreadFactory
+{
+	public String threadName;
+	
+	
+	public LodThreadFactory(String newThreadName)
+	{
+		threadName = newThreadName + " Thread";
+	}
+	
+	@Override
+	public Thread newThread(Runnable r)
+	{
+            return new Thread(r, threadName);
+	}
+	
+}

src/main/java/com/seibel/lod/util/LodUtil.java

@@ -0,0 +1,394 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.util;
+
+import java.awt.Color;
+import java.io.File;
+import java.util.HashSet;
+
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.objects.RegionPos;
+import com.seibel.lod.wrappers.MinecraftWrapper;
+
+import net.minecraft.client.multiplayer.ServerData;
+import net.minecraft.client.renderer.WorldRenderer;
+import net.minecraft.client.renderer.chunk.ChunkRenderDispatcher.CompiledChunk;
+import net.minecraft.server.integrated.IntegratedServer;
+import net.minecraft.util.math.BlockPos;
+import net.minecraft.util.math.ChunkPos;
+import net.minecraft.world.DimensionType;
+import net.minecraft.world.IWorld;
+import net.minecraft.world.chunk.ChunkSection;
+import net.minecraft.world.chunk.IChunk;
+import net.minecraft.world.gen.Heightmap;
+import net.minecraft.world.server.ServerChunkProvider;
+import net.minecraft.world.server.ServerWorld;
+
+/**
+ * This class holds methods and constants that may be used in multiple places.
+ * 
+ * @author James Seibel
+ * @version 9-7-2021
+ */
+public class LodUtil
+{
+	private static MinecraftWrapper mc = MinecraftWrapper.INSTANCE;
+	
+	
+	/** alpha used when drawing chunks in debug mode */
+	public static final int DEBUG_ALPHA = 255; // 0 - 255
+	public static final Color COLOR_DEBUG_BLACK = new Color(0, 0, 0, DEBUG_ALPHA);
+	public static final Color COLOR_DEBUG_WHITE = new Color(255, 255, 255, DEBUG_ALPHA);
+	public static final Color COLOR_INVISIBLE = new Color(0,0,0,0);
+	
+	/** a gray-purple color */
+	public static final int MYCELIUM_COLOR_INT = LodUtil.colorToInt(Color.decode("#6E6166"));
+	/** TODO, add a better way to override material colors
+	 * and/or add a method to generate colors based on texture
+	 * issue #64 */
+	public static final int STONE_COLOR_INT = LodUtil.colorToInt(new Color(150, 150, 150));
+	public static final int NETHERRACK_COLOR_INT = LodUtil.colorToInt(new Color(95, 38, 38));
+	public static final int WARPED_NYLIUM_COLOR_INT = LodUtil.colorToInt(new Color(34, 94, 85));
+	public static final int CRIMSON_NYLIUM_COLOR_INT = LodUtil.colorToInt(new Color(126, 27, 27));
+
+	/**
+	 * In order of nearest to farthest: <br>
+	 * Red, Orange, Yellow, Green, Cyan, Blue, Magenta, white, gray, black
+	 */
+	public static final Color DEBUG_DETAIL_LEVEL_COLORS[] = new Color[] { Color.RED, Color.ORANGE, Color.YELLOW, Color.GREEN, Color.CYAN, Color.BLUE, Color.MAGENTA, Color.WHITE, Color.GRAY, Color.BLACK };
+	
+	
+	/** 512 blocks wide */
+	public static final byte REGION_DETAIL_LEVEL = 9;
+	/** 16 blocks wide */
+	public static final byte CHUNK_DETAIL_LEVEL = 4;
+	/** 1 block wide */
+	public static final byte BLOCK_DETAIL_LEVEL = 0;
+
+
+	public static final byte DETAIL_OPTIONS = 10;
+
+	public static final short MAX_VERTICAL_DATA = 4;
+
+	/** measured in Blocks <br>
+	 * detail level 9 */
+	public static final short REGION_WIDTH = 512;
+	/** measured in Blocks <br>
+	 * detail level 4 */
+	public static final short CHUNK_WIDTH = 16;
+	/** measured in Blocks <br> 
+	 * detail level 0 */
+	public static final short BLOCK_WIDTH = 1;
+	
+	
+	/** number of chunks wide */
+	public static final int REGION_WIDTH_IN_CHUNKS = 32;
+	
+	
+	/** If we ever need to use a heightmap for any reason, use this one. */
+	public static final Heightmap.Type DEFAULT_HEIGHTMAP = Heightmap.Type.WORLD_SURFACE_WG;
+	
+	/** This regex finds any characters that are invalid for use in a windows 
+	 * (and by extension mac and linux) file path */
+	public static final String INVALID_FILE_CHARACTERS_REGEX = "[\\\\\\/:*?\\\"<>|]";
+	
+	
+	
+	
+	/**
+	 * Gets the first valid ServerWorld.
+	 * 
+	 * @return null if there are no ServerWorlds
+	 */
+	public static ServerWorld getFirstValidServerWorld()
+	{
+		if (mc.hasSingleplayerServer())
+			return null;
+		
+		Iterable<ServerWorld> worlds = mc.getSingleplayerServer().getAllLevels();
+		
+		for (ServerWorld world : worlds)
+			return world;
+		
+		return null;
+	}
+	
+	/**
+	 * Gets the ServerWorld for the relevant dimension.
+	 * 
+	 * @return null if there is no ServerWorld for the given dimension
+	 */
+	public static ServerWorld getServerWorldFromDimension(DimensionType dimension)
+	{
+		IntegratedServer server = mc.getSingleplayerServer();
+		if (server == null)
+			return null;
+		
+		Iterable<ServerWorld> worlds = server.getAllLevels();
+		ServerWorld returnWorld = null;
+		
+		for (ServerWorld world : worlds)
+		{
+			if(world.dimensionType() == dimension)
+			{
+				returnWorld = world;
+				break;
+			}
+		}
+		
+		return returnWorld;
+	}
+	
+	/**
+	 * Convert a 2D absolute position into a quad tree relative position. 
+	 */
+	public static RegionPos convertGenericPosToRegionPos(int x, int z, int detailLevel)
+	{
+		int relativePosX = Math.floorDiv(x, (int) Math.pow(2, LodUtil.REGION_DETAIL_LEVEL - detailLevel));
+		int relativePosZ = Math.floorDiv(z, (int) Math.pow(2, LodUtil.REGION_DETAIL_LEVEL - detailLevel));
+		
+		return new RegionPos(relativePosX, relativePosZ);
+	}
+	
+	/**
+	 * Convert a 2D absolute position into a quad tree relative position.
+	 */
+	public static int convertLevelPos(int pos, int currectDetailLevel, int targetDetailLevel)
+	{
+		int newPos = Math.floorDiv(pos, (int) Math.pow(2, targetDetailLevel - currectDetailLevel));
+		
+		return newPos;
+	}
+	/**
+	 * Return whether the given chunk
+	 * has any data in it.
+	 */
+	public static boolean chunkHasBlockData(IChunk chunk)
+	{
+		ChunkSection[] blockStorage = chunk.getSections();
+		
+		for(ChunkSection section : blockStorage)
+		{
+			if(section != null && !section.isEmpty())
+			{
+				return true;
+			}
+		}
+		
+		return false;
+	}
+	
+	
+	
+	/**
+	 * If on single player this will return the name of the user's
+	 * world, if in multiplayer it will return the server name, IP,
+	 * and game version.
+	 */
+	public static String getWorldID(IWorld world)
+	{
+		if(mc.hasSingleplayerServer())
+		{
+			// chop off the dimension ID as it is not needed/wanted
+			String dimId = getDimensionIDFromWorld(world);
+			
+			// get the world name
+			int saveIndex = dimId.indexOf("saves") + 1 + "saves".length();
+			int slashIndex = dimId.indexOf(File.separatorChar, saveIndex);
+			dimId = dimId.substring(saveIndex, slashIndex);
+			return dimId;
+		}
+		else
+		{
+			return getServerId();
+		}
+	}
+	
+	
+	
+	/**
+	 * If on single player this will return the name of the user's
+	 * world and the dimensional save folder, if in multiplayer 
+	 * it will return the server name, ip, game version, and dimension.<br>
+	 * <br>
+	 * This can be used to determine where to save files for a given
+	 * dimension.
+	 */
+	public static String getDimensionIDFromWorld(IWorld world)
+	{
+		if(mc.hasSingleplayerServer())
+		{
+			// this will return the world save location
+			// and the dimension folder
+			
+			ServerWorld serverWorld = LodUtil.getServerWorldFromDimension(world.dimensionType());
+			if(serverWorld == null)
+				throw new NullPointerException("getDimensionIDFromWorld wasn't able to get the ServerWorld for the dimension " + world.dimensionType().effectsLocation().getPath());
+			
+			ServerChunkProvider provider = serverWorld.getChunkSource();
+			if(provider == null)
+				throw new NullPointerException("getDimensionIDFromWorld wasn't able to get the ServerChunkProvider for the dimension " + world.dimensionType().effectsLocation().getPath());
+			
+			return provider.dataStorage.dataFolder.toString();
+		}
+		else
+		{
+			return getServerId() + File.separatorChar + "dim_" + world.dimensionType().effectsLocation().getPath() + File.separatorChar;
+		}
+	}
+	
+	/**
+	 * returns the server name, IP and game version.
+	 */
+	public static String getServerId()
+	{
+		ServerData server = mc.getCurrentServer();
+		
+		String serverName = server.name.replaceAll(INVALID_FILE_CHARACTERS_REGEX, "");
+		String serverIp = server.ip.replaceAll(INVALID_FILE_CHARACTERS_REGEX, "");
+		String serverMcVersion = server.version.getString().replaceAll(INVALID_FILE_CHARACTERS_REGEX, "");
+		
+		String serverId =  serverName + ", IP " + serverIp + ", GameVersion " + serverMcVersion;
+		
+		return serverId; 
+	}
+	
+	
+	/**
+	 * Convert a BlockColors int into a Color object.
+	 */
+	public static Color intToColor(int num)
+	{
+		int filter = 0b11111111;
+		
+		int red = (num >> 16 ) & filter;
+		int green = (num >> 8 ) & filter;
+		int blue = num & filter;
+		
+		return new Color(red, green, blue);
+	}
+	
+	/**
+	 * Convert a Color into a BlockColors object.
+	 */
+	public static int colorToInt(Color color)
+	{
+		return color.getRGB();
+	}
+	
+	
+	/**
+	 * Clamps the given value between the min and max values.
+	 * May behave strangely if min > max.
+	 */
+	public static int clamp(int min, int value, int max)
+	{
+		return Math.min(max, Math.max(value, min));
+	}
+	
+	/**
+	 * Clamps the given value between the min and max values.
+	 * May behave strangely if min > max.
+	 */
+	public static float clamp(float min, float value, float max)
+	{
+		return Math.min(max, Math.max(value, min));
+	}
+	
+	/**
+	 * Clamps the given value between the min and max values.
+	 * May behave strangely if min > max.
+	 */
+	public static double clamp(double min, double value, double max)
+	{
+		return Math.min(max, Math.max(value, min));
+	}
+	
+	
+	
+	 /**
+     * Get a HashSet of all ChunkPos within the normal render distance
+     * that should not be rendered.
+     */
+	 public static HashSet<ChunkPos> getNearbyLodChunkPosToSkip(LodDimension lodDim, BlockPos playerPos)
+	 {
+		 int chunkRenderDist = mc.getRenderDistance();
+		 ChunkPos centerChunk = new ChunkPos(playerPos);
+
+		 // skip chunks that are already going to be rendered by Minecraft
+		 HashSet<ChunkPos> posToSkip = getRenderedChunks();
+
+		 // go through each chunk within the normal view distance
+		 for (int x = centerChunk.x - chunkRenderDist; x < centerChunk.x + chunkRenderDist; x++)
+		 {
+			 for (int z = centerChunk.z - chunkRenderDist; z < centerChunk.z + chunkRenderDist; z++)
+			 {
+				 if (!lodDim.doesDataExist(LodUtil.CHUNK_DETAIL_LEVEL, x, z))
+					 continue;
+
+				 long data = lodDim.getSingleData(LodUtil.CHUNK_DETAIL_LEVEL, x, z);
+
+				 short lodAverageHeight = DataPointUtil.getHeight(data);
+
+				 if (playerPos.getY() <= lodAverageHeight)
+				 {
+					 // don't draw Lod's that are taller than the player
+					 // to prevent LODs being drawn on top of the player
+					 posToSkip.add(new ChunkPos(x, z));
+				 }
+			 }
+		 }
+
+		 return posToSkip;
+	 }
+
+
+	/**
+     * This method returns the ChunkPos of all chunks that Minecraft
+     * is going to render this frame. <br><br>
+     * <p>
+     * Note: This isn't perfect. It will return some chunks that are outside
+     * the clipping plane. (For example, if you are high above the ground some chunks
+     * will be incorrectly added, even though they are outside render range).
+     */
+	public static HashSet<ChunkPos> getRenderedChunks()
+	{
+		HashSet<ChunkPos> loadedPos = new HashSet<>();
+		
+		// Wow those are some long names!
+		
+		// go through every RenderInfo to get the compiled chunks
+		WorldRenderer renderer = mc.getLevelRenderer();
+		for (WorldRenderer.LocalRenderInformationContainer worldrenderer$localrenderinformationcontainer : renderer.renderChunks)
+		{
+			CompiledChunk compiledChunk = worldrenderer$localrenderinformationcontainer.chunk.getCompiledChunk();
+			if (!compiledChunk.hasNoRenderableLayers())
+			{
+				// add the ChunkPos for every rendered chunk
+				BlockPos bpos = worldrenderer$localrenderinformationcontainer.chunk.getOrigin();
+				
+				loadedPos.add(new ChunkPos(bpos));
+			}
+		}
+		
+		
+		return loadedPos;
+	}
+	
+	
+}

src/main/java/com/seibel/lod/util/LodUtils.java

@@ -1,215 +0,0 @@
-package com.seibel.lod.util;
-
-import com.seibel.lod.objects.LodRegion;
-import com.seibel.lod.objects.RegionPos;
-
-import net.minecraft.client.Minecraft;
-import net.minecraft.client.multiplayer.ServerData;
-import net.minecraft.server.integrated.IntegratedServer;
-import net.minecraft.util.math.ChunkPos;
-import net.minecraft.world.DimensionType;
-import net.minecraft.world.IWorld;
-import net.minecraft.world.chunk.ChunkSection;
-import net.minecraft.world.chunk.IChunk;
-import net.minecraft.world.server.ServerChunkProvider;
-import net.minecraft.world.server.ServerWorld;
-
-/**
- * This class holds methods that may be used in multiple places.
- * 
- * @author James Seibel
- * @version 04-01-2021
- */
-public class LodUtils
-{
-	private static Minecraft mc = Minecraft.getInstance();
-	
-	
-	
-	/**
-	 * Gets the first valid ServerWorld.
-	 * 
-	 * @return null if there are no ServerWorlds
-	 */
-	public static ServerWorld getFirstValidServerWorld()
-	{
-		if (mc.getIntegratedServer() == null)
-			return null;
-		
-		Iterable<ServerWorld> worlds = mc.getIntegratedServer().getWorlds();
-		
-		for (ServerWorld world : worlds)
-			return world;
-				
-		return null;
-	}
-	
-	/**
-	 * Gets the ServerWorld for the relevant dimension.
-	 * 
-	 * @return null if there is no ServerWorld for the given dimension
-	 */
-	public static ServerWorld getServerWorldFromDimension(DimensionType dimension)
-	{
-		IntegratedServer server = mc.getIntegratedServer();
-		if (server == null)
-			return null;
-		
-		Iterable<ServerWorld> worlds = server.getWorlds();
-		ServerWorld returnWorld = null;
-		
-		for (ServerWorld world : worlds)
-		{
-			if(world.getDimensionType() == dimension)
-			{
-				returnWorld = world;
-				break;
-			}
-		}
-				
-		return returnWorld;
-	}
-	
-	/**
-	 * Convert the given ChunkPos into a RegionPos.
-	 */
-	public static RegionPos convertChunkPosToRegionPos(ChunkPos pos)
-	{
-		RegionPos rPos = new RegionPos();
-		rPos.x = pos.x / LodRegion.SIZE;
-		rPos.z = pos.z / LodRegion.SIZE;
-		
-		// prevent issues if X/Z is negative and less than 16
-		if (pos.x < 0)
-		{
-			rPos.x = (Math.abs(rPos.x) * -1) - 1; 
-		}
-		if (pos.z < 0)
-		{
-			rPos.z = (Math.abs(rPos.z) * -1) - 1; 
-		}
-		
-		return rPos;
-	}
-	
-	/**
-	 * Return whether the given chunk
-	 * has any data in it.
-	 */
-	public static boolean chunkHasBlockData(IChunk chunk)
-	{
-		ChunkSection[] blockStorage = chunk.getSections();
-		
-		for(ChunkSection section : blockStorage)
-		{
-			if(section != null && !section.isEmpty())
-			{
-				return true;
-			}
-		}
-		
-		return false;
-	}
-	
-	
-	
-	public static String getCurrentDimensionID()
-	{
-
-		Minecraft mc = Minecraft.getInstance();
-		
-		if(mc.isIntegratedServerRunning())
-		{
-			// this will return the world save location
-			// and the dimension folder
-			
-			if(mc.world == null)
-				return "";
-			
-			ServerWorld serverWorld = LodUtils.getServerWorldFromDimension(mc.world.getDimensionType());
-			if(serverWorld == null)
-				return "";
-			
-			ServerChunkProvider provider = serverWorld.getChunkProvider();
-			if(provider == null)
-				return "";
-			
-			return provider.getSavedData().folder.toString();
-		}
-		else
-		{
-			ServerData server = mc.getCurrentServerData();
-			return server.serverName + ", IP " + 
-					server.serverIP + ", GameVersion " + 
-					server.gameVersion.getString() + "\\"
-					+ "dim_" + mc.world.getDimensionType().getEffects().getPath() + "\\";
-		}
-	}
-
-	
-	/**
-	 * If on single player this will return the name of the user's
-	 * world and the dimensional save folder, if in multiplayer 
-	 * it will return the server name, game version, and dimension.<br>
-	 * <br>
-	 * This can be used to determine where to save files for a given
-	 * dimension.
-	 */
-	public static String getDimensionIDFromWorld(IWorld world)
-	{
-		Minecraft mc = Minecraft.getInstance();
-		
-		if(mc.isIntegratedServerRunning())
-		{
-			// this will return the world save location
-			// and the dimension folder
-			
-			ServerWorld serverWorld = LodUtils.getServerWorldFromDimension(world.getDimensionType());
-			if(serverWorld == null)
-				throw new NullPointerException("getDimensionIDFromWorld wasn't able to get the ServerWorld for the dimension " + world.getDimensionType().getEffects().getPath());
-			
-			ServerChunkProvider provider = serverWorld.getChunkProvider();
-			if(provider == null)
-				throw new NullPointerException("getDimensionIDFromWorld wasn't able to get the ServerChunkProvider for the dimension " + world.getDimensionType().getEffects().getPath());
-			
-			return provider.getSavedData().folder.toString();
-		}
-		else
-		{
-			ServerData server = mc.getCurrentServerData();
-			return server.serverName + ", IP " + 
-					server.serverIP + ", GameVersion " + 
-					server.gameVersion.getString() + "\\"
-					+ "dim_" + world.getDimensionType().getEffects().getPath() + "\\";
-		}
-	}
-	
-	/**
-	 * If on single player this will return the name of the user's
-	 * world, if in multiplayer it will return the server name
-	 * and game version.
-	 */
-	public static String getWorldID(IWorld world)
-	{
-		if(mc.isIntegratedServerRunning())
-		{
-			// chop off the dimension ID as it is not needed/wanted
-			String dimId = getDimensionIDFromWorld(world);
-			
-			// get the world name
-			int saveIndex = dimId.indexOf("saves") + 1 + "saves".length();
-			int slashIndex = dimId.indexOf('\\', saveIndex);
-			dimId = dimId.substring(saveIndex, slashIndex);
-			return dimId;
-		}
-		else
-		{
-			ServerData server = mc.getCurrentServerData();
-			return server.serverName + ", IP " + 
-					server.serverIP + ", GameVersion " + 
-					server.gameVersion.getString();
-		}
-	}
-	
-	
-}

src/main/java/com/seibel/lod/util/Reference.java

@@ -1,3 +1,20 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.seibel.lod.util;
 
 /**

src/main/java/com/seibel/lod/util/ReflectionHandler.java

@@ -1,96 +0,0 @@
-package com.seibel.lod.util;
-
-import java.lang.reflect.Field;
-
-import com.seibel.lod.enums.FogQuality;
-
-import net.minecraft.client.Minecraft;
-
-/**
- * This object is used to get variables from methods
- * where they are private.
- * 
- * @author James Seibel
- * @version 02-18-2021
- */
-public class ReflectionHandler
-{
-	private Minecraft mc = Minecraft.getInstance();
-	
-	public Field ofFogField = null;
-	
-	
-	public ReflectionHandler()
-	{
-		setupFogField();
-	}
-	
-	/**
-	 * Similar to setupFovMethod.
-	 */
-	private void setupFogField()
-	{
-		// get every variable from the entity renderer
-		Field[] vars = mc.gameSettings.getClass().getDeclaredFields();
-				
-		// try and find the ofFogType variable in gameSettings
-		for(Field f : vars)
-		{
-			if(f.getName().equals("ofFogType"))
-			{
-				ofFogField = f;
-				return;
-			}
-		}
-		
-		// we didn't find the field,
-		// either optifine isn't installed, or
-		// optifine changed the name of the variable
-		ofFogField = null;
-	}
-	
-	
-	
-	
-	
-	/**
-	 * Get what type of fog optifine is currently set to render.
-	 */
-	public FogQuality getFogQuality()
-	{
-		if (ofFogField == null)
-		{
-			// either optifine isn't installed,
-			// the variable name was changed, or
-			// the setup method wasn't called yet.
-			return FogQuality.OFF;
-		}
-		
-		int returnNum = 0;
-		
-		try
-		{
-			returnNum = (int)ofFogField.get(mc.gameSettings);
-		}
-		catch (IllegalArgumentException | IllegalAccessException e)
-		{
-			e.printStackTrace();
-		}
-		
-		switch (returnNum)
-		{
-			case 0:
-				return FogQuality.FAST;
-			case 1:
-				return FogQuality.FAST;
-			case 2:
-				return FogQuality.FANCY;
-			case 3:
-				return FogQuality.OFF;
-				
-			default:
-				return FogQuality.FAST;
-		}
-	}
-	
-}

src/main/java/com/seibel/lod/util/ThreadMapUtil.java

@@ -0,0 +1,108 @@
+package com.seibel.lod.util;
+
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.ConcurrentMap;
+
+public class ThreadMapUtil
+{
+	public static final ConcurrentMap<String, long[]> threadSingleUpdateMap = new ConcurrentHashMap<>();
+	public static final ConcurrentMap<String, long[][]> threadBuilderArrayMap = new ConcurrentHashMap<>();
+	public static final ConcurrentMap<String, long[][]> threadBuilderVerticalArrayMap = new ConcurrentHashMap<>();
+	public static final ConcurrentMap<String, long[]> threadVerticalAddDataMap = new ConcurrentHashMap<>();
+	public static final ConcurrentMap<String, byte[]> saveContainer = new ConcurrentHashMap<>();
+	public static final ConcurrentMap<String, short[]> projectionShortMap = new ConcurrentHashMap<>();
+	public static final ConcurrentMap<String, short[]> heightAndDepthMap = new ConcurrentHashMap<>();
+	public static final ConcurrentMap<String, long[]> singleDataToMergeMap = new ConcurrentHashMap<>();
+	public static final ConcurrentMap<String, long[][]> verticalUpdate = new ConcurrentHashMap<>();
+
+	public static long[] getSingleUpdateArray()
+	{
+		if (!threadSingleUpdateMap.containsKey(Thread.currentThread().getName()) || (threadSingleUpdateMap.get(Thread.currentThread().getName()) == null))
+		{
+			threadSingleUpdateMap.put(Thread.currentThread().getName(), new long[4]);
+		}
+		return threadSingleUpdateMap.get(Thread.currentThread().getName());
+	}
+
+	public static long[][] getBuilderArray()
+	{
+		if (!threadBuilderArrayMap.containsKey(Thread.currentThread().getName()) || (threadBuilderArrayMap.get(Thread.currentThread().getName()) == null))
+		{
+			long[][] array = new long[5][];
+			threadBuilderArrayMap.put(Thread.currentThread().getName(), array);
+		}
+		return threadBuilderArrayMap.get(Thread.currentThread().getName());
+	}
+
+	public static long[][] getBuilderVerticalArray()
+	{
+		if (!threadBuilderVerticalArrayMap.containsKey(Thread.currentThread().getName()) || (threadBuilderVerticalArrayMap.get(Thread.currentThread().getName()) == null))
+		{
+			long[][] array = new long[5][];
+			threadBuilderVerticalArrayMap.put(Thread.currentThread().getName(), array);
+		}
+		return threadBuilderVerticalArrayMap.get(Thread.currentThread().getName());
+	}
+
+	public static long[] verticalDataArray()
+	{
+		if (!threadVerticalAddDataMap.containsKey(Thread.currentThread().getName()) || (threadVerticalAddDataMap.get(Thread.currentThread().getName()) == null))
+		{
+			threadVerticalAddDataMap.put(Thread.currentThread().getName(), new long[0]);
+		}
+		return threadVerticalAddDataMap.get(Thread.currentThread().getName());
+	}
+
+	public static short[] getProjectionShort(){
+		if(!projectionShortMap.containsKey(Thread.currentThread().getName()) || (projectionShortMap.get(Thread.currentThread().getName()) == null))
+		{
+			projectionShortMap.put(Thread.currentThread().getName(), new short[0]);
+		}
+		return projectionShortMap.get(Thread.currentThread().getName());
+	}
+
+	public static short[] getHeightAndDepth(){
+		if(!heightAndDepthMap.containsKey(Thread.currentThread().getName()) || (heightAndDepthMap.get(Thread.currentThread().getName()) == null))
+		{
+			heightAndDepthMap.put(Thread.currentThread().getName(), new short[0]);
+		}
+		return heightAndDepthMap.get(Thread.currentThread().getName());
+	}
+
+	public static byte[] getSaveContainer(){
+		if(!saveContainer.containsKey(Thread.currentThread().getName()) || (saveContainer.get(Thread.currentThread().getName()) == null))
+		{
+			saveContainer.put(Thread.currentThread().getName(), new byte[0]);
+		}
+		return saveContainer.get(Thread.currentThread().getName());
+	}
+
+	public static long[][] getVerticalUpdateArray(){
+		if(!verticalUpdate.containsKey(Thread.currentThread().getName()) || (verticalUpdate.get(Thread.currentThread().getName()) == null))
+		{
+			long[][] array = new long[10][];
+			verticalUpdate.put(Thread.currentThread().getName(), array);
+		}
+		return verticalUpdate.get(Thread.currentThread().getName());
+	}
+
+	public static long[] getSingleAddDataToMerge(){
+		if(!singleDataToMergeMap.containsKey(Thread.currentThread().getName()) || (singleDataToMergeMap.get(Thread.currentThread().getName()) == null))
+		{
+			singleDataToMergeMap.put(Thread.currentThread().getName(), new long[0]);
+		}
+		return singleDataToMergeMap.get(Thread.currentThread().getName());
+	}
+
+	public static void clearMaps(){
+		threadSingleUpdateMap.clear();
+		threadBuilderArrayMap.clear();
+		threadBuilderVerticalArrayMap.clear();
+		threadVerticalAddDataMap.clear();
+		saveContainer.clear();
+		projectionShortMap.clear();
+		heightAndDepthMap.clear();
+		singleDataToMergeMap.clear();
+		verticalUpdate.clear();
+	}
+}

src/main/java/com/seibel/lod/wrappers/MinecraftWrapper.java

@@ -0,0 +1,236 @@
+package com.seibel.lod.wrappers;
+
+import java.awt.Color;
+import java.io.File;
+
+import com.seibel.lod.util.LodUtil;
+
+import net.minecraft.client.GameSettings;
+import net.minecraft.client.MainWindow;
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.entity.player.ClientPlayerEntity;
+import net.minecraft.client.multiplayer.ServerData;
+import net.minecraft.client.network.play.ClientPlayNetHandler;
+import net.minecraft.client.renderer.GameRenderer;
+import net.minecraft.client.renderer.LightTexture;
+import net.minecraft.client.renderer.WorldRenderer;
+import net.minecraft.client.renderer.model.ModelManager;
+import net.minecraft.client.renderer.texture.NativeImage;
+import net.minecraft.client.world.ClientWorld;
+import net.minecraft.entity.Entity;
+import net.minecraft.profiler.IProfiler;
+import net.minecraft.server.integrated.IntegratedServer;
+import net.minecraft.util.Direction;
+import net.minecraft.world.DimensionType;
+
+/**
+ * A singleton that wraps the Minecraft class
+ * to allow for easier movement between Minecraft versions.
+ * 
+ * @author James Seibel
+ * @version 9-16-2021
+ */
+public class MinecraftWrapper
+{
+	public static MinecraftWrapper INSTANCE = new MinecraftWrapper();
+	
+	private Minecraft mc = Minecraft.getInstance();
+	
+	/** The lightmap for the current:
+	 * Time, dimension, brightness setting, etc. */
+	private NativeImage lightMap = null;
+	
+	private MinecraftWrapper()
+	{
+		
+	}
+	
+	
+	
+	//================//
+	// helper methods //
+	//================//
+	
+	/**
+	 * This should be called at the beginning of every frame to
+	 * clear any Minecraft data that becomes out of date after a frame. <br> <br>
+	 * 
+	 * Lightmaps and other time sensitive objects fall in this category. <br> <br>
+	 * 
+	 * This doesn't effect OpenGL objects in any way.
+	 */
+	public void clearFrameObjectCache()
+	{
+		lightMap = null;
+	}
+	
+	
+	
+	//=================//
+	// method wrappers //
+	//=================//
+	
+	public float getShading(Direction direction)
+	{
+		return mc.level.getShade(Direction.UP, true);
+	}
+	
+	public boolean hasSingleplayerServer()
+	{
+		return mc.hasSingleplayerServer();
+	}
+	
+	public DimensionType getCurrentDimension()
+	{
+		return mc.player.level.dimensionType();
+	}
+	
+	public String getCurrentDimensionId()
+	{
+		return LodUtil.getDimensionIDFromWorld(mc.level);
+	}
+	
+	/** 
+	 * This texture changes every frame
+	 */
+	public NativeImage getCurrentLightMap()
+	{
+		// get the current lightMap if the cache is empty
+		if (lightMap == null)
+		{
+			LightTexture tex = mc.gameRenderer.lightTexture();
+			NativeImage lightPixels = tex.lightPixels;
+			lightMap = lightPixels;
+		}
+		
+//		// hotswap this to true, then back to false to write a file
+//		// (and not write a file every frame)
+//		if (false)
+//		{
+//			try
+//			{
+//				// obviously change the filepath to somewhere on your PC
+//				lightPixels.writeToFile(new File("C:\\Users\\James Seibel\\Desktop\\image.png"));
+//			}
+//			catch(Exception e)
+//			{
+//				e.printStackTrace();
+//			}
+//		}
+		
+		return lightMap;
+	}
+	
+	/**
+	 * Returns the color int at the given pixel coordinates
+	 * from the current lightmap.
+	 * 
+	 * @param u x location in texture space
+	 * @param v z location in texture space
+	 */
+	public int getColorIntFromLightMap(int u, int v)
+	{
+		if (lightMap == null)
+		{
+			// make sure the lightMap is up to date
+			getCurrentLightMap();
+		}
+		
+		return lightMap.getPixelRGBA(u, v);
+	}
+	
+	/**
+	 * Returns the Color at the given pixel coordinates
+	 * from the current lightmap.
+	 * 
+	 * @param u x location in texture space
+	 * @param v z location in texture space
+	 */
+	public Color getColorFromLightMap(int u, int v)
+	{
+		return LodUtil.intToColor(lightMap.getPixelRGBA(u, v));
+	}
+	
+	
+	
+	
+	//=============//
+	// Simple gets //
+	//=============//
+	
+	public ClientPlayerEntity getPlayer()
+	{
+		return mc.player;
+	}
+	
+	public GameSettings getOptions()
+	{
+		return mc.options;
+	}
+
+	public ModelManager getModelManager()
+	{
+		return mc.getModelManager();
+	}
+	
+	public ClientWorld getClientWorld()
+	{
+		return  mc.level;
+	}
+
+	/** Measured in chunks */
+	public int getRenderDistance()
+	{
+		return mc.options.renderDistance;
+	}
+	
+	public File getGameDirectory()
+	{
+		return mc.gameDirectory;
+	}
+	
+	public IProfiler getProfiler()
+	{
+		return mc.getProfiler();
+	}
+	
+	public ClientPlayNetHandler getConnection()
+	{
+		return mc.getConnection();
+	}
+	
+	public GameRenderer getGameRenderer()
+	{
+		return mc.gameRenderer;
+	}
+	
+	public Entity getCameraEntity()
+	{
+		return mc.cameraEntity;
+	}
+	
+	public MainWindow getWindow()
+	{
+		return mc.getWindow();
+	}
+	
+	public float getSkyDarken(float partialTicks)
+	{
+		return mc.level.getSkyDarken(partialTicks);
+	}
+	
+	public IntegratedServer getSingleplayerServer()
+	{
+		return mc.getSingleplayerServer();
+	}
+	
+	public ServerData getCurrentServer()
+	{
+		return mc.getCurrentServer();
+	}
+	
+	public WorldRenderer getLevelRenderer()
+	{
+		return mc.levelRenderer;
+	}
+}

src/main/resources/META-INF/accesstransformer.cfg

@@ -16,6 +16,41 @@ public net.minecraft.world.storage.DimensionSavedDataManager field_215759_d # fo
 # used when generating LodChunks
 public net.minecraft.block.AbstractBlock$AbstractBlockState field_235704_h_ # materialColor
 
+# used when determining which chunks Vanilla Minecraft is going to render
+public net.minecraft.client.renderer.WorldRenderer$LocalRenderInformationContainer
+public net.minecraft.client.renderer.WorldRenderer field_72755_R # renderInfos
+public net.minecraft.client.renderer.WorldRenderer$LocalRenderInformationContainer field_178036_a # renderChunk
+
+# used in world generation
+public net.minecraft.world.server.ServerWorld field_241106_P_ # structuremanager
+public net.minecraft.world.gen.Heightmap func_202267_b(II)I # getDataArrayIndex
+public net.minecraft.world.gen.Heightmap func_202272_a(III)V # set
+public net.minecraft.world.chunk.Chunk field_76634_f # heightMap
+public net.minecraft.world.chunk.Chunk field_76652_q # sections
+public net.minecraft.world.chunk.ChunkPrimer field_201661_i # sections
+public net.minecraft.world.server.ChunkManager field_219269_w # templateManager
+public net.minecraft.world.server.ChunkManager field_219256_j # lightManager
+public net.minecraft.world.gen.feature.template.TemplateManager field_186240_a # templates
+public net.minecraft.world.biome.Biome field_242424_k # biomeGenerationSettings
+public net.minecraft.world.gen.blockstateprovider.WeightedBlockStateProvider field_227406_b_ # weightedStates
+public net.minecraft.world.gen.placement.ConfiguredPlacement field_215096_a # decorator
+public net.minecraft.world.gen.placement.ConfiguredPlacement field_215097_b # config
+public net.minecraft.util.WeightedList field_220658_a # weightedEntries
+public net.minecraft.world.gen.feature.FeatureSpread field_242250_b # base
+public net.minecraft.world.gen.feature.FeatureSpread field_242251_c # spread
+public net.minecraft.world.gen.feature.ConfiguredFeature func_242765_a(Lnet/minecraft/world/ISeedReader;Lnet/minecraft/world/gen/ChunkGenerator;Ljava/util/Random;Lnet/minecraft/util/math/BlockPos;)Z # place
+public net.minecraft.world.server.ServerChunkProvider field_217244_j # dataStorage
+public net.minecraft.world.lighting.WorldLightManager field_215576_a # blockEngine
+public net.minecraft.world.lighting.WorldLightManager field_215577_b # skyEngine
+public net.minecraft.world.gen.feature.Feature field_236290_a_ # configuredCodec
+
+# used for uploading vertex buffers off the render thread
+public net.minecraft.client.renderer.vertex.VertexBuffer field_177365_a # id
+public net.minecraft.client.renderer.vertex.VertexBuffer field_177363_b # format
+public net.minecraft.client.renderer.vertex.VertexBuffer field_177364_c # vertexCount
+
+# used for accessing the lightmap
+public net.minecraft.client.renderer.LightTexture field_205111_b # lightPixels
 
 
 #=====================#

src/main/resources/META-INF/mods.toml

@@ -7,14 +7,14 @@
 modLoader="javafml" #mandatory
 
 #// A version range to match for said mod loader - for regular FML @Mod it will be the forge version
-loaderVersion="[35,)" #mandatory This is typically bumped every Minecraft version by Forge. See our download page for lists of versions.
+loaderVersion="[36,)" #mandatory This is typically bumped every Minecraft version by Forge. See our download page for lists of versions.
 
 #// The license for you mod. This is mandatory metadata and allows for easier comprehension of your redistributive properties.
 #// Review your options at https://choosealicense.com/. All rights reserved is the default copyright stance, and is thus the default here.
-license="All rights reserved"
+license="GNU GPLv3"
 
 #// A URL to refer people to when problems occur with this mod
-#//issueTrackerURL="https://change.me.to.your.issue.tracker.example.invalid/" #optional
+issueTrackerURL="https://gitlab.com/jeseibel/minecraft-lod-mod/-/issues" #optional
 #// A list of mods - how many allowed here is determined by the individual mod loader
 [[mods]] #mandatory
 
@@ -24,27 +24,25 @@ modId="lod" #mandatory
 #// The version number of the mod - there's a few well known ${} variables useable here or just hardcode it
 #//${file.jarVersion} will substitute the value of the Implementation-Version as read from the mod's JAR file metadata
 #// see the associated build.gradle script for how to populate this completely automatically during a build
-version="a1.2" #mandatory
+version="a1.5.0-pre" #mandatory
 
 #// A display name for the mod
-displayName="Levels of Detail" #mandatory
+displayName="LOD" #mandatory
 
 #// A URL to query for updates for this mod. See the JSON update specification https://mcforge.readthedocs.io/en/latest/gettingstarted/autoupdate/
 #//updateJSONURL="https://change.me.example.invalid/updates.json" #optional
 
 #// A URL for the "homepage" for this mod, displayed in the mod UI
-#//displayURL="https://change.me.to.your.mods.homepage.example.invalid/" #optional
+displayURL="https://www.curseforge.com/minecraft/mc-mods/lod-level-of-detail" #optional
 
 #// A file name (in the root of the mod JAR) containing a logo for display
-#//logoFile="examplemod.png" #optional
+logoFile="logo.png" #optional
 
 #// A text field displayed in the mod UI
 credits="TechnoVision, Vike, and Darkhax for their modding tutorials." #optional
 
 #// A text field displayed in the mod UI
-authors="James Seibel" #optional
+authors="James Seibel, Leonardo Amato, and Cola" #optional
 
 #// The description text for the mod (multi line!) (#mandatory)
-description='''
-This mod generates and renders simplified chunks beyond the normal view distance, at a low performance cost.
-'''
+description='''This mod generates and renders simplified terrain beyond the normal view distance, at a low performance cost.'''

src/main/resources/mcmod.info

@@ -1,16 +0,0 @@
-[
-{
-  "modid": "lod",
-  "name": "Level Of Details",
-  "description": "Generates and renders simplified chunks beyond the normal view distance, at a low performance cost.",
-  "version": "a1.2",
-  "mcversion": "1.16.4",
-  "url": "",
-  "updateUrl": "",
-  "authorList": ["James Seibel"],
-  "credits": "TechnoVision, Vike, and Darkhax for their modding tutorials.",
-  "logoFile": "",
-  "screenshots": [],
-  "dependencies": []
-}
-]

src/main/resources/pack.mcmeta

@@ -1,6 +1,6 @@
 {
     "pack": {
-        "description": "examplemod resources",
+        "description": "",
         "pack_format": 6,
         "_comment": "A pack_format of 6 requires json lang files and some texture changes from 1.16.2. Note: we require v6 pack meta for all mods."
     }