comment out the config override for release a1.4.1

I'm not certain why in LodRenderer swapBuffers has to be called after the frame has been rendered, but otherwise it causes stuttering / rubber banding.

build.gradle

@@ -3,9 +3,11 @@ buildscript {
         maven { url = 'https://files.minecraftforge.net/maven' }
         jcenter()
         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
@@ -17,13 +19,21 @@ apply plugin: 'org.spongepowered.mixin'
 // Only edit below this line, the above code adds and enables the necessary things for Forge to be setup.
 apply plugin: 'eclipse'
 apply plugin: 'maven-publish'
+apply plugin: 'java' // needed for compileJava
 
-version = 'a1.3'
-group = 'com.backsun.lod'
+version = 'a1.4.1'
+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.
 
+compileJava {
+    // release 8 is needed because otherwise FloatBuffer.flip() will crash
+    // on some machines
+    // example thread: https://github.com/eclipse/jetty.project/issues/3244
+    options.compilerArgs.addAll(['--release', '8', '-Xlint:unchecked', '-Xlint:deprecation']) 
+}
+
 println('Java: ' + System.getProperty('java.version') + ' JVM: ' + System.getProperty('java.vm.version') + '(' + System.getProperty('java.vendor') + ') Arch: ' + System.getProperty('os.arch'))
 minecraft {
     // The mappings can be changed at any time, and must be in the following format.
@@ -116,26 +126,53 @@ 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.5-36.1.0'
 	
-	
-	// 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'
-	
-	
+	// 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"
     // compile "some.group:artifact:version"
@@ -160,7 +197,7 @@ dependencies {
 jar {
     manifest {
         attributes([
-            "Specification-Title": "Level of Detail",
+            "Specification-Title": "LOD",
             "Specification-Version": "1", // We are version 1 of ourselves
             "Implementation-Title": project.name,
             "Implementation-Version": "{version}",

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

@@ -17,15 +17,11 @@
  */
 package com.seibel.lod;
 
-import org.lwjgl.opengl.GL;
-
-import com.seibel.lod.handlers.LodConfig;
+import com.seibel.lod.config.LodConfig;
 import com.seibel.lod.proxy.ClientProxy;
-import com.seibel.lod.render.LodRenderer;
 
 import net.minecraftforge.common.MinecraftForge;
 import net.minecraftforge.eventbus.api.SubscribeEvent;
-import net.minecraftforge.fml.DeferredWorkQueue;
 import net.minecraftforge.fml.ModLoadingContext;
 import net.minecraftforge.fml.common.Mod;
 import net.minecraftforge.fml.config.ModConfig;
@@ -51,26 +47,9 @@ public class LodMain
 	public static ClientProxy client_proxy;
 	
 	
-	@SuppressWarnings("deprecation")
 	private void init(final FMLCommonSetupEvent event)
 	{
-		ModLoadingContext.get().registerConfig(ModConfig.Type.CLIENT, LodConfig.clientSpec);
-		
-		
-		Thread setFancyFog = new Thread(() ->
-		{ 
-			LodRenderer.fancyFogAvailable = GL.getCapabilities().GL_NV_fog_distance;
-			
-			if (!LodRenderer.fancyFogAvailable)
-			{
-				ClientProxy.LOGGER.info("This GPU does not support GL_NV_fog_distance. This means that fancy fog options will not be available.");
-			}
-		});
-		
-		// This will be run on the main thread when it is able.
-		// If it wasn't run on the main thread GL.getCapabilities()
-		// would fail.
-		DeferredWorkQueue.runLater(setFancyFog);
+		ModLoadingContext.get().registerConfig(ModConfig.Type.CLIENT, LodConfig.CLIENT_SPEC);
 	}
 	
 	

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

@@ -21,12 +21,12 @@ 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 = "Level of Detail";
+	public static final String MODNAME = "LOD";
 	public static final String MODAPI = "LodAPI";
-	public static final String VERSION = "a1.3";
+	public static final String VERSION = "a1.4";
 }

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

@@ -17,421 +17,508 @@
  */
 package com.seibel.lod.builders;
 
+import java.util.ArrayList;
+import java.util.List;
+import java.util.concurrent.Callable;
 import java.util.concurrent.ExecutorService;
 import java.util.concurrent.Executors;
-import java.util.concurrent.atomic.AtomicInteger;
+import java.util.concurrent.Future;
+import java.util.concurrent.locks.ReentrantLock;
 
 import org.lwjgl.opengl.GL11;
 
-import com.seibel.lod.builders.worldGeneration.LodChunkGenWorker;
-import com.seibel.lod.handlers.LodConfig;
-import com.seibel.lod.objects.LodChunk;
+import com.seibel.lod.builders.lodTemplates.Box;
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.objects.DataPoint;
+import com.seibel.lod.objects.LevelPosUtil;
 import com.seibel.lod.objects.LodDimension;
-import com.seibel.lod.objects.NearFarBuffer;
+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.render.LodRenderer;
+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.math.BlockPos;
 import net.minecraft.util.math.ChunkPos;
-import net.minecraft.world.biome.BiomeContainer;
-import net.minecraft.world.chunk.ChunkStatus;
-import net.minecraft.world.server.ServerWorld;
-import net.minecraftforge.common.WorldWorkerManager;
+
 
 /**
  * This object is used to create NearFarBuffer objects.
- * 
+ *
  * @author James Seibel
- * @version 06-19-2021
+ * @version 8-24-2021
  */
 public class LodBufferBuilder
 {
-	private Minecraft mc;
-	
-	/** This holds the thread used to generate new LODs off the main thread. */
-	private ExecutorService genThread = Executors.newSingleThreadExecutor();
-	
-	private LodChunkBuilder lodChunkBuilder;
-	
-	/** 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;
-	
-	/** if this is true the LOD buffers are currently being
-	 * regenerated. */
-	public volatile 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;
-	
-	/** This keeps track of how many chunk generation requests are on going.
-	 * This is to prevent chunks from being generated for a long time in an area
-	 * the player is no longer in. */
-	public volatile AtomicInteger numberOfChunksWaitingToGenerate = new AtomicInteger(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).
-	 * 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 = LodConfig.CLIENT.numberOfWorldGenerationThreads.get() * 8;
-	
-	
-	public LodBufferBuilder(LodChunkBuilder newLodBuilder)
+	/**
+	 * This holds the thread used to generate new LODs off the main thread.
+	 */
+	private ExecutorService mainGenThread = Executors.newSingleThreadExecutor(new LodThreadFactory(this.getClass().getSimpleName() + " - main"));
+	/**
+	 * This holds the threads used to generate buffers.
+	 */
+	private ExecutorService bufferBuilderThreads = Executors.newFixedThreadPool(LodConfig.CLIENT.threading.numberOfBufferBuilderThreads.get(), new LodThreadFactory(this.getClass().getSimpleName() + " - builder"));
+
+	/**
+	 * The buffers that are used to create LODs using far fog
+	 */
+	public volatile BufferBuilder[][] buildableBuffers;
+
+	/**
+	 * Used when building new VBOs
+	 */
+	public volatile VertexBuffer[][] buildableVbos;
+
+	/**
+	 * VBOs that are sent over to the LodNodeRenderer
+	 */
+	public volatile VertexBuffer[][] drawableVbos;
+
+	/**
+	 * 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 boolean switchVbos = false;
+
+
+	/**
+	 * Size of the buffer builders in bytes last time we created them
+	 */
+	public int previousBufferSize = 0;
+
+	/**
+	 * 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();
+
+	private static final int NUMBER_OF_DIRECTION = 4;
+	//in order -x, +x, -z, +z
+	private static final int[][] ADJ_DIRECTION = 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);
+
+
+
+	public LodBufferBuilder()
 	{
-		mc = Minecraft.getInstance();
-		lodChunkBuilder = newLodBuilder;
+
 	}
-	
-	
-	private BiomeContainer biomeContainer = null;
-	private LodDimension previousDimension = null;
-	
+
 
 	/**
 	 * 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(LodRenderer renderer, LodDimension lodDim,
-			double playerX, double playerZ, int numbChunksWide)
+	                                    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 (previousDimension != lodDim)
-		{
-			biomeContainer = LodUtil.getServerWorldFromDimension(lodDim.dimension).getChunk(0, 0, ChunkStatus.EMPTY).getBiomes();
-			previousDimension = lodDim;
-		}
-		
+
+		if (buildableBuffers == null)
+			// setupBuffers hasn't been called yet
+			return;
+
+
 		generatingBuffers = true;
-		
-		
-		// 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 thread = new Thread(()->
+
+
+		// round the player's block position down to the nearest chunk BlockPos
+		ChunkPos playerChunkPos = new ChunkPos(playerBlockPos);
+		BlockPos playerBlockPosRounded = playerChunkPos.getWorldPosition();
+
+
+		Thread thread = new Thread(() ->
 		{
-			// index of the chunk currently being added to the
-			// generation list
-			int chunkGenIndex = 0;
-			
-			ChunkPos[] chunksToGen = new ChunkPos[maxChunkGenRequests];
-			// if we don't have a full number of chunks to generate in chunksToGen
-			// we can top it off from the reserve
-			ChunkPos[] chunksToGenReserve = 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, LodRenderer.LOD_VERTEX_FORMAT);
-			buildableFarBuffer.begin(GL11.GL_QUADS, LodRenderer.LOD_VERTEX_FORMAT);
-			
-			
-			
-			// x axis
-			for (int i = 0; i < numbChunksWide; i++)
+			bufferLock.lock();
+
+
+			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.regions.length * lodDim.regions.length);
+
+				startBuffers(fullRegen, lodDim);
+
+				// =====================//
+				//    RENDERING PART    //
+				// =====================//
+
+				RegionPos playerRegionPos = new RegionPos(playerChunkPos);
+				if (center == null)
+					center = playerRegionPos;
+
+				if (setsToRender == null)
+					setsToRender = new PosToRenderContainer[lodDim.regions.length][lodDim.regions.length];
+
+				if (setsToRender.length != lodDim.regions.length)
+					setsToRender = new PosToRenderContainer[lodDim.regions.length][lodDim.regions.length];
+
+				if (boxCache == null)
+					boxCache = new Box[lodDim.regions.length][lodDim.regions.length];
+
+				if (boxCache.length != lodDim.regions.length)
+					boxCache = new Box[lodDim.regions.length][lodDim.regions.length];
+
+				// this will be the center of the VBOs once they have been built
+				buildableCenterChunkPos = playerChunkPos;
+
+				for (int xRegion = 0; xRegion < lodDim.regions.length; xRegion++)
 				{
-					int chunkX = i + (startX / LodChunk.WIDTH);
-					int chunkZ = j + (startZ / LodChunk.WIDTH);
-					
-					// skip any chunks that Minecraft is going to render
-					if(isCoordInCenterArea(i, j, (numbChunksWide / 2)) 
-						&& renderer.vanillaRenderedChunks.contains(new ChunkPos(chunkX, chunkZ)))
+					for (int zRegion = 0; zRegion < lodDim.regions.length; 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;
-					
-					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.get() < maxChunkGenRequests)
+						if (lodDim.regen[xRegion][zRegion] || fullRegen)
 						{
-							ChunkPos pos = new ChunkPos(chunkX, chunkZ);
-							
-							
-							// can be used for debugging
-//							if (chunksToGen == null)
-//							{
-//								chunkGenIndex = 0;
-//								chunksToGen = new ChunkPos[maxChunkGenRequests];
-//							}
-//							
-//							if (chunkGenIndex < maxChunkGenRequests)
-//							{
-//								chunksToGen[chunkGenIndex] = pos;
-//								chunkGenIndex++;
-//							}
-							
-							
-							
-							
-							// determine if this position is closer to the player
-							// than the previous
-							int newDistance = playerChunkPos.getChessboardDistance(pos);
-							
-							// issue #40
-							// TODO optimize this code, 
-							// using the purely optimized code above we can achieve close to
-							// 100% CPU utilization, this code generally achieves 40 - 50 %
-							// I'm sure there is a better data structure for this.
-							if (newDistance < minChunkDist)
+							RegionPos regionPos = new RegionPos(
+									xRegion + lodDim.getCenterX() - Math.floorDiv(lodDim.getWidth(), 2),
+									zRegion + lodDim.getCenterZ() - Math.floorDiv(lodDim.getWidth(), 2));
+
+							// local position in the vbo and bufferBuilder arrays
+							BufferBuilder currentBuffer = buildableBuffers[xRegion][zRegion];
+							LodRegion region = lodDim.getRegion(regionPos.x, regionPos.z);
+							if (region == null) continue;
+							byte minDetail = region.getMinDetailLevel();
+							// make sure the buffers weren't
+							// changed while we were running this method
+							if (currentBuffer == null || (currentBuffer != null && !currentBuffer.building()))
+								return;
+							//previous setToRender chache
+							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;
-								
-								
-								// move all the old chunks into the reserve
-								ChunkPos[] newReserve = new ChunkPos[maxChunkGenRequests];
-								int oldToGenIndex = 0;
-								int oldReserveIndex = 0;
-								for(int tmpIndex = 0; tmpIndex < newReserve.length; tmpIndex++)
+
+								//previous setToRender chache
+								if (setsToRender[xR][zR] == null)
 								{
-									// we don't check if the boundaries are good since
-									// the tmp array will always be the same length
-									// as chunksToGen and chunksToGenReserve
-									
-									if (chunksToGen[oldToGenIndex] != null)
-									{
-										// add all the closest chunks...
-										newReserve[tmpIndex] = chunksToGen[oldToGenIndex];
-										oldToGenIndex++;
-									}
-									else if (chunksToGenReserve[oldReserveIndex] != null)
-									{
-										// ...then add all the previous reserve chunks
-										// (which are farther away)
-										newReserve[tmpIndex] = chunksToGenReserve[oldToGenIndex];
-										oldReserveIndex++;
-									}
-									else
-									{
-										// we have moved all the items from
-										// the old chunksToGen and reserve
-										break;
-									}
+									setsToRender[xR][zR] = new PosToRenderContainer(minDetail, regionPos.x, regionPos.z);
 								}
-								chunksToGenReserve = newReserve;
-								
-								
-								
-								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)
+
+								if (boxCache[xR][zR] == null)
 								{
-									// we are still under the number of chunks to generate
-									// add this position to the list
-									chunksToGen[chunkGenIndex] = pos;
-									chunkGenIndex++;
+									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;
+								short gameChunkRenderDistance = (short) (renderer.vanillaRenderedChunks.length / 2 - 1);
+								long dataPoint;
+								long[] adjData;
+								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
+											    && renderer.vanillaRenderedChunks[chunkXdist + gameChunkRenderDistance + 1][chunkZdist + gameChunkRenderDistance + 1])
+									{
+										continue;
+									}
+									// skip any chunks that Minecraft is going to render
+									try
+									{
+										if (lodDim.doesDataExist(detailLevel, posX, posZ))
+										{
+											dataPoint = lodDim.getData(detailLevel, posX, posZ);
+											if(DataPoint.getHeight(dataPoint) == LodBuilder.DEFAULT_HEIGHT && DataPoint.getDepth(dataPoint) == LodBuilder.DEFAULT_DEPTH)
+												continue;
+											adjData = new long[NUMBER_OF_DIRECTION];
+											for (int direction = 0; direction < NUMBER_OF_DIRECTION; direction++)
+											{
+												xAdj = posX + ADJ_DIRECTION[direction][0];
+												zAdj = posZ + ADJ_DIRECTION[direction][1];
+												chunkXdist = LevelPosUtil.getChunkPos(detailLevel,xAdj) - playerChunkPos.x;
+												chunkZdist = LevelPosUtil.getChunkPos(detailLevel,zAdj) - playerChunkPos.z;
+
+												if (gameChunkRenderDistance >= Math.abs(chunkXdist) && gameChunkRenderDistance >= Math.abs(chunkZdist))
+												{
+													if (!renderer.vanillaRenderedChunks[chunkXdist + gameChunkRenderDistance + 1][chunkZdist + gameChunkRenderDistance + 1]
+															    && posToRender.contains(detailLevel, xAdj, zAdj))
+													{
+														adjData[direction]= lodDim.getData(detailLevel, xAdj, zAdj);
+													}
+												} else
+												{
+													if (posToRender.contains(detailLevel, xAdj, zAdj))
+													{
+														adjData[direction] = lodDim.getData(detailLevel, xAdj, zAdj);
+													}
+												}
+											}
+											LodConfig.CLIENT.graphics.lodTemplate.get().template.addLodToBuffer(currentBuffer, playerBlockPosRounded, dataPoint, adjData,
+													detailLevel, posX, posZ, boxCache[xR][zR],renderer.previousDebugMode);
+										}
+									} catch (ArrayIndexOutOfBoundsException e)
+									{
+										e.printStackTrace();
+										return false;
+									}
+
+								}// 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.hasSingleplayerServer())
-			{
-		        ServerWorld serverWorld = LodUtil.getServerWorldFromDimension(lodDim.dimension);
-				
-		        // make sure we have as many chunks to generate as we are allowed
-		        if (chunkGenIndex < maxChunkGenRequests)
-		        {
-		        	for(int i = chunkGenIndex, j = 0; i < maxChunkGenRequests; i++, j++)
-		        	{
-		        		chunksToGen[i] = chunksToGenReserve[j];
-		        	}
-		        }
-		        
-				// 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;
-					
-					// make sure we don't generate this chunk again
-		        	lodDim.addLod(new LodChunk(chunkPos));
-					
-					numberOfChunksWaitingToGenerate.addAndGet(1);
-					
-					LodChunkGenWorker genWorker = new LodChunkGenWorker(chunkPos, renderer, lodChunkBuilder, this, lodDim, serverWorld, biomeContainer);
-					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.end();
-			buildableFarBuffer.end();
-			
-			// mark that the buildable buffers as ready to swap
-			generatingBuffers = false;
-			switchBuffers = true;
+
 		});
-		
-		genThread.execute(thread);
-		
+
+		mainGenThread.execute(thread);
+
 		return;
 	}
-	
-	
-	
-	
-	
-	
-	
-	
-	
-	
-	//====================//
-	// 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.options.renderDistance
-				&& i <= centerCoordinate + mc.options.renderDistance) 
-				&& 
-				(j >= centerCoordinate - mc.options.renderDistance
-				&& j <= centerCoordinate + mc.options.renderDistance);
-	}
-	
-	
-	/**
-	 * 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. <br><br>
+	 * <p>
+	 * May have to wait for the bufferLock to open.
+	 */
+	public void setupBuffers(int numbRegionsWide, int bufferMaxCapacity)
+	{
+		bufferLock.lock();
+
+		previousRegionWidth = numbRegionsWide;
+		previousBufferSize = bufferMaxCapacity;
+
+
+		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++)
+			{
+				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();
+	}
+
+	/**
+	 * 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 void destroyBuffers()
+	{
+		bufferLock.lock();
+
+		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.regen[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.regen[x][z]))
+				{
+					buildableBuffers[x][z].end();
+				}
+	}
+
 	/**
 	 * Called from the LodRenderer to create the
 	 * BufferBuilders at the right size.
-	 * 
-	 * @param bufferMaxCapacity
 	 */
-	public void setupBuffers(int bufferMaxCapacity)
+	private void uploadBuffers(boolean fullRegen, LodDimension lodDim)
 	{
-		buildableNearBuffer = new BufferBuilder(bufferMaxCapacity);
-		buildableFarBuffer = new BufferBuilder(bufferMaxCapacity);
+		for (int x = 0; x < buildableVbos.length; x++)
+		{
+			for (int z = 0; z < buildableVbos.length; z++)
+			{
+				if (fullRegen || lodDim.regen[x][z])
+				{
+					buildableVbos[x][z].upload(buildableBuffers[x][z]);
+					lodDim.regen[x][z] = false;
+				}
+			}
+		}
 	}
-	
+
+
+
 	/**
-	 * Swap the drawable and buildable buffers and return
-	 * the old drawable buffers.
-	 * @param drawableNearBuffer
-	 * @param drawableFarBuffer
+	 * Get the newly created VBOs
 	 */
-	public NearFarBuffer swapBuffers(BufferBuilder drawableNearBuffer, BufferBuilder drawableFarBuffer)
+	public VertexBuffersAndOffset getVertexBuffers()
 	{
-		// swap the BufferBuilders
-		BufferBuilder tmp = buildableNearBuffer;
-		buildableNearBuffer = drawableNearBuffer;
-		drawableNearBuffer = tmp;
-		
-		tmp = buildableFarBuffer;
-		buildableFarBuffer = drawableFarBuffer;
-		drawableFarBuffer = tmp;
-		
-		
-		// the buffers have been swapped
-		switchBuffers = false;
-		
-		return new NearFarBuffer(drawableNearBuffer, drawableFarBuffer);
+		// don't wait for the lock to open
+		// since this is called on the main render thread
+		if (bufferLock.tryLock())
+		{
+			VertexBuffer[][] tmp = drawableVbos;
+			drawableVbos = buildableVbos;
+			buildableVbos = tmp;
+
+			drawableCenterChunkPos = buildableCenterChunkPos;
+
+			// the vbos have been swapped
+			switchVbos = false;
+			bufferLock.unlock();
+		}
+
+		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/LodBuilder.java

@@ -0,0 +1,575 @@
+/*
+ *    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.awt.Color;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.enums.LodDetail;
+import com.seibel.lod.objects.DataPoint;
+import com.seibel.lod.objects.LevelPosUtil;
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.objects.LodRegion;
+import com.seibel.lod.objects.LodWorld;
+import com.seibel.lod.util.ColorUtil;
+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.block.AbstractPlantBlock;
+import net.minecraft.block.BlockState;
+import net.minecraft.block.Blocks;
+import net.minecraft.block.BushBlock;
+import net.minecraft.block.GrassBlock;
+import net.minecraft.block.IGrowable;
+import net.minecraft.block.LeavesBlock;
+import net.minecraft.block.material.MaterialColor;
+import net.minecraft.world.DimensionType;
+import net.minecraft.world.IWorld;
+import net.minecraft.world.biome.Biome;
+import net.minecraft.world.chunk.ChunkSection;
+import net.minecraft.world.chunk.IChunk;
+import net.minecraft.world.gen.Heightmap;
+
+/**
+ * This object is in charge of creating Lod related objects. (specifically: Lod
+ * World, Dimension, and Region objects)
+ *
+ * @author Leonardo Amato
+ * @author James Seibel
+ * @version 9-7-2021
+ */
+public class LodBuilder
+{
+	private ExecutorService lodGenThreadPool = Executors.newSingleThreadExecutor(new LodThreadFactory(this.getClass().getSimpleName()));
+
+	public static final int CHUNK_DATA_WIDTH = LodUtil.CHUNK_WIDTH;
+	public static final int CHUNK_SECTION_HEIGHT = CHUNK_DATA_WIDTH;
+	public static final Heightmap.Type DEFAULT_HEIGHTMAP = Heightmap.Type.WORLD_SURFACE_WG;
+
+	/**
+	 * If no blocks are found in the area in determineBottomPointForArea return this
+	 */
+	public static final short DEFAULT_DEPTH = 0;
+	/**
+	 * If no blocks are found in the area in determineHeightPointForArea return this
+	 */
+	public static final short DEFAULT_HEIGHT = 0;
+
+	/**
+	 * How wide LodDimensions should be in regions
+	 */
+	public int defaultDimensionWidthInRegions = 5;
+
+	public LodBuilder()
+	{
+
+	}
+
+	public void generateLodNodeAsync(IChunk chunk, LodWorld lodWorld, IWorld world)
+	{
+		generateLodNodeAsync(chunk, lodWorld, world, DistanceGenerationMode.SERVER);
+	}
+
+
+	public void generateLodNodeAsync(IChunk chunk, LodWorld lodWorld, IWorld world, DistanceGenerationMode generationMode)
+	{
+		if (lodWorld == null || !lodWorld.getIsWorldLoaded())
+			return;
+
+		// don't try to create an LOD object
+		// if for some reason we aren't
+		// given a valid chunk object
+		if (chunk == null)
+			return;
+
+		Thread thread = new Thread(() ->
+		{
+			try
+			{
+				DimensionType dim = world.dimensionType();
+
+				LodDimension lodDim;
+
+				int playerPosX;
+				int playerPosZ;
+				if (MinecraftWrapper.INSTANCE.getPlayer() == null)
+				{
+					playerPosX = chunk.getPos().getMinBlockX();
+					playerPosZ = chunk.getPos().getMinBlockZ();
+				} else
+				{
+					playerPosX = (int) world.players().get(0).getX();
+					playerPosZ = (int) world.players().get(0).getZ();
+				}
+				if (lodWorld.getLodDimension(dim) == null)
+				{
+					lodDim = new LodDimension(dim, lodWorld, defaultDimensionWidthInRegions);
+					lodWorld.addLodDimension(lodDim);
+					lodDim.treeGenerator(playerPosX, playerPosZ);
+				} else
+				{
+					lodDim = lodWorld.getLodDimension(dim);
+				}
+				generateLodNodeFromChunk(lodDim, chunk, new LodBuilderConfig(generationMode));
+			} catch (IllegalArgumentException | NullPointerException e)
+			{
+				e.printStackTrace();
+				// if the world changes while LODs are being generated
+				// they will throw errors as they try to access things that no longer
+				// exist.
+			}
+		});
+		lodGenThreadPool.execute(thread);
+
+		return;
+	}
+
+	/**
+	 * Creates a LodChunk for a chunk in the given world.
+	 *
+	 * @throws IllegalArgumentException thrown if either the chunk or world is null.
+	 */
+	public void generateLodNodeFromChunk(LodDimension lodDim, IChunk chunk) throws IllegalArgumentException
+	{
+		generateLodNodeFromChunk(lodDim, chunk, new LodBuilderConfig());
+	}
+
+	/**
+	 * Creates a LodChunk for a chunk in the given world.
+	 *
+	 * @throws IllegalArgumentException thrown if either the chunk or world is null.
+	 */
+	public void generateLodNodeFromChunk(LodDimension lodDim, IChunk chunk, LodBuilderConfig config)
+			throws IllegalArgumentException
+	{
+		if (chunk == null)
+			throw new IllegalArgumentException("generateLodFromChunk given a null chunk");
+
+		int startX;
+		int startZ;
+		int endX;
+		int endZ;
+		int color;
+		short height;
+		short depth;
+		long data;
+		try
+		{
+			LodDetail detail;
+			LodRegion region = lodDim.getRegion(chunk.getPos().getRegionX(), chunk.getPos().getRegionZ());
+			if (region == null)
+				return;
+			byte minDetailLevel = region.getMinDetailLevel();
+			detail = DetailDistanceUtil.getLodGenDetail(minDetailLevel);
+
+			byte detailLevel = detail.detailLevel;
+			int posX;
+			int posZ;
+			for (int i = 0; i < detail.dataPointLengthCount * detail.dataPointLengthCount; i++)
+			{
+				startX = detail.startX[i];
+				startZ = detail.startZ[i];
+				endX = detail.endX[i];
+				endZ = detail.endZ[i];
+
+				color = generateLodColorForArea(chunk, config, startX, startZ, endX, endZ);
+
+				if (!config.useHeightmap)
+				{
+					height = determineHeightPointForArea(chunk.getSections(), startX, startZ, endX, endZ);
+					depth = determineBottomPointForArea(chunk.getSections(), startX, startZ, endX, endZ);
+				} else
+				{
+					height = determineHeightPoint(chunk.getOrCreateHeightmapUnprimed(LodUtil.DEFAULT_HEIGHTMAP), startX,
+							startZ, endX, endZ);
+					depth = 0;
+				}
+				posX = LevelPosUtil.convert((byte) 0, chunk.getPos().x * 16 + startX, detail.detailLevel);
+				posZ = LevelPosUtil.convert((byte) 0, chunk.getPos().z * 16 + startZ, detail.detailLevel);
+				boolean isServer = config.distanceGenerationMode == DistanceGenerationMode.SERVER;
+				data = DataPoint.createDataPoint(height, depth, ColorUtil.getRed(color), ColorUtil.getGreen(color), ColorUtil.getBlue(color));
+				lodDim.addData(detailLevel,
+						posX,
+						posZ,
+						data,
+						false,
+						isServer);
+			}
+			lodDim.updateData(LodUtil.CHUNK_DETAIL_LEVEL, chunk.getPos().x, chunk.getPos().z);
+		} catch (Exception e)
+		{
+			e.printStackTrace();
+		}
+
+	}
+
+
+	// =====================//
+	// constructor helpers //
+	// =====================//
+
+	/**
+	 * Find the lowest valid point from the bottom.
+	 */
+	private short determineBottomPointForArea(ChunkSection[] chunkSections, int startX, int startZ, int endX, int endZ)
+	{
+		int numberOfBlocksRequired = ((endX - startX) * (endZ - startZ) / 2);
+
+		// search from the bottom up
+		for (int section = 0; section < CHUNK_DATA_WIDTH; section++)
+		{
+			for (int y = 0; y < CHUNK_SECTION_HEIGHT; y++)
+			{
+				int numberOfBlocksFound = 0;
+
+				for (int x = startX; x < endX; x++)
+				{
+					for (int z = startZ; z < endZ; z++)
+					{
+						if (isLayerValidLodPoint(chunkSections, section, y, x, z))
+						{
+							numberOfBlocksFound++;
+
+							if (numberOfBlocksFound >= numberOfBlocksRequired)
+							{
+								// we found
+								// enough blocks in this
+								// layer to count as an
+								// LOD point
+								return (short) (y + (section * CHUNK_SECTION_HEIGHT));
+							}
+						}
+					}
+				}
+			}
+		}
+
+		// we never found a valid LOD point
+		return DEFAULT_DEPTH;
+	}
+
+
+	/**
+	 * Find the lowest valid point from the bottom.
+	 */
+	@SuppressWarnings("unused")
+	private short determineBottomPoint(Heightmap heightmap)
+	{
+		// the heightmap only shows how high the blocks go, it
+		// doesn't have any info about how low they go
+		return 0;
+	}
+
+	/**
+	 * Find the highest valid point from the Top
+	 */
+	private short determineHeightPointForArea(ChunkSection[] chunkSections, int startX, int startZ, int endX, int endZ)
+	{
+		int numberOfBlocksRequired = ((endX - startX) * (endZ - startZ) / 2);
+		// search from the top down
+		for (int section = chunkSections.length - 1; section >= 0; section--)
+		{
+			for (int y = CHUNK_DATA_WIDTH - 1; y >= 0; y--)
+			{
+				int numberOfBlocksFound = 0;
+
+				for (int x = startX; x < endX; x++)
+				{
+					for (int z = startZ; z < endZ; z++)
+					{
+						if (isLayerValidLodPoint(chunkSections, section, y, x, z))
+						{
+							numberOfBlocksFound++;
+
+							if (numberOfBlocksFound >= numberOfBlocksRequired)
+							{
+								// we found
+								// enough blocks in this
+								// layer to count as an
+								// LOD point
+								return (short) (y + 1 + (section * CHUNK_SECTION_HEIGHT));
+							}
+						}
+					}
+				}
+			}
+		}
+
+		// we never found a valid LOD point
+		return DEFAULT_HEIGHT;
+	}
+
+
+	/**
+	 * Find the highest point from the Top
+	 */
+	private short determineHeightPoint(Heightmap heightmap, int startX, int startZ, int endX, int endZ)
+	{
+		short highest = 0;
+		for (int x = startX; x < endX; x++)
+		{
+			for (int z = startZ; z < endZ; z++)
+			{
+				short newHeight = (short) heightmap.getFirstAvailable(x, z);
+				if (newHeight > highest)
+					highest = newHeight;
+			}
+		}
+
+		return highest;
+	}
+
+	/**
+	 * Generate the color for the given chunk using biome water color, foliage
+	 * color, and grass color.
+	 *
+	 * @param config_useSolidBlocksInColorGen <br>
+	 *                                        If true we look down from the top of
+	 *                                        the <br>
+	 *                                        chunk until we find a non-invisible
+	 *                                        block, and then use <br>
+	 *                                        its color. If false we generate the
+	 *                                        color immediately for <br>
+	 *                                        each x and z.
+	 * @param config_useBiomeColors           <br>
+	 *                                        If true use biome foliage, water, and
+	 *                                        grass colors, <br>
+	 *                                        otherwise only use the block's
+	 *                                        material color
+	 */
+	private int generateLodColorForArea(IChunk chunk, LodBuilderConfig config, int startX, int startZ, int endX,
+	                                    int endZ)
+	{
+		ChunkSection[] chunkSections = chunk.getSections();
+
+		int numbOfBlocks = 0;
+		int red = 0;
+		int green = 0;
+		int blue = 0;
+
+		for (int x = startX; x < endX; x++)
+		{
+			for (int z = startZ; z < endZ; z++)
+			{
+				boolean foundBlock = false;
+
+				// go top down
+				for (int i = chunkSections.length - 1; !foundBlock && i >= 0; i--)
+				{
+					if (!foundBlock && (chunkSections[i] != null || !config.useSolidBlocksInColorGen))
+					{
+						for (int y = CHUNK_SECTION_HEIGHT - 1; !foundBlock && y >= 0; y--)
+						{
+							int colorInt = 0;
+							BlockState blockState = null;
+
+							if (chunkSections[i] != null)
+							{
+								blockState = chunkSections[i].getBlockState(x, y, z);
+								colorInt = blockState.materialColor.col;
+							}
+
+							if (colorInt == 0 && config.useSolidBlocksInColorGen)
+							{
+								// skip air or invisible blocks
+								continue;
+							}
+
+							if (config.useBiomeColors)
+							{
+								// I have no idea why I need to bit shift to the right, but
+								// if I don't the biomes don't show up correctly.
+								Biome biome = chunk.getBiomes().getNoiseBiome(x >> 2, y + 1 * chunkSections.length >> 2,
+										z >> 2);
+								colorInt = getColorForBiome(x, z, biome);
+							} else
+							{
+
+								// the bit shift is equivalent to dividing by 4
+								Biome biome = chunk.getBiomes().getNoiseBiome(x >> 2, y + i * chunkSections.length >> 2,
+										z >> 2);
+								colorInt = getColorForBlock(x, z, blockState, biome);
+							}
+
+							red += ColorUtil.getRed(colorInt);
+							green += ColorUtil.getGreen(colorInt);
+							blue += ColorUtil.getBlue(colorInt);
+
+							numbOfBlocks++;
+
+							// we found a valid block, skip to the
+							// next x and z
+							foundBlock = true;
+						}
+					}
+				}
+			}
+		}
+
+		if (numbOfBlocks == 0)
+			numbOfBlocks = 1;
+
+		red /= numbOfBlocks;
+		green /= numbOfBlocks;
+		blue /= numbOfBlocks;
+		return ColorUtil.rgbToInt(red,green,blue);
+	}
+
+	/**
+	 * Returns a color int for the given block.
+	 */
+	private int getColorForBlock(int x, int z, BlockState blockState, Biome biome)
+	{
+		int colorInt = 0;
+
+		// block special cases
+		if (blockState == Blocks.AIR.defaultBlockState() 
+				|| blockState == Blocks.CAVE_AIR.defaultBlockState()
+				|| blockState == Blocks.BARRIER.defaultBlockState())
+		{
+			Color tmp = LodUtil.intToColor(biome.getGrassColor(x, z));
+			tmp = tmp.darker();
+			colorInt = LodUtil.colorToInt(tmp);
+		} else if (blockState == Blocks.STONE.defaultBlockState())
+		{
+			colorInt = LodUtil.STONE_COLOR_INT;
+		} else if (blockState == Blocks.MYCELIUM.defaultBlockState())
+		{
+			colorInt = LodUtil.MYCELIUM_COLOR_INT;
+		}
+
+		// plant life
+		else if (blockState.getBlock() instanceof LeavesBlock || blockState.getBlock() == Blocks.VINE)
+		{
+			Color leafColor = LodUtil.intToColor(biome.getFoliageColor()).darker();
+			leafColor = leafColor.darker();
+			colorInt = LodUtil.colorToInt(leafColor);
+		} else if ((blockState.getBlock() instanceof GrassBlock || blockState.getBlock() instanceof AbstractPlantBlock
+				            || blockState.getBlock() instanceof BushBlock || blockState.getBlock() instanceof IGrowable)
+				           && !(blockState.getBlock() == Blocks.BROWN_MUSHROOM || blockState.getBlock() == Blocks.RED_MUSHROOM))
+		{
+			Color plantColor = LodUtil.intToColor(biome.getGrassColor(x, z));
+			plantColor = plantColor.darker();
+			colorInt = LodUtil.colorToInt(plantColor);
+		}
+
+		// water
+		else if (blockState.getBlock() == Blocks.WATER)
+		{
+			colorInt = biome.getWaterColor();
+		}
+
+		// everything else
+		else
+		{
+			colorInt = blockState.materialColor.col;
+		}
+
+		return colorInt;
+	}
+
+	/**
+	 * Returns a color int for the given biome.
+	 */
+	private int getColorForBiome(int x, int z, Biome biome)
+	{
+		int colorInt = 0;
+
+		switch (biome.getBiomeCategory())
+		{
+
+			case NETHER:
+				colorInt = Blocks.BEDROCK.defaultBlockState().materialColor.col;
+				break;
+
+			case THEEND:
+				colorInt = Blocks.END_STONE.defaultBlockState().materialColor.col;
+				break;
+
+			case BEACH:
+			case DESERT:
+				colorInt = Blocks.SAND.defaultBlockState().materialColor.col;
+				break;
+
+			case EXTREME_HILLS:
+				colorInt = Blocks.STONE.defaultMaterialColor().col;
+				break;
+
+			case MUSHROOM:
+				colorInt = MaterialColor.COLOR_LIGHT_GRAY.col;
+				break;
+
+			case ICY:
+				colorInt = Blocks.SNOW.defaultMaterialColor().col;
+				break;
+
+			case MESA:
+				colorInt = Blocks.RED_SAND.defaultMaterialColor().col;
+				break;
+
+			case OCEAN:
+			case RIVER:
+				colorInt = biome.getWaterColor();
+				break;
+
+			case NONE:
+			case FOREST:
+			case TAIGA:
+			case JUNGLE:
+			case PLAINS:
+			case SAVANNA:
+			case SWAMP:
+			default:
+				Color tmp = LodUtil.intToColor(biome.getGrassColor(x, z));
+				tmp = tmp.darker();
+				colorInt = LodUtil.colorToInt(tmp);
+				break;
+
+		}
+
+		return colorInt;
+	}
+
+	/**
+	 * Is the layer between the given X, Z, and dataIndex values a valid LOD point?
+	 */
+	private boolean isLayerValidLodPoint(ChunkSection[] chunkSections, int sectionIndex, int y, int x, int z)
+	{
+		if (chunkSections[sectionIndex] == null)
+		{
+			// this section doesn't have any blocks,
+			// it is not a valid section
+			return false;
+		} else
+		{
+			if (chunkSections[sectionIndex].getBlockState(x, y, z) != null
+					    && chunkSections[sectionIndex].getBlockState(x, y, z).getBlock() != Blocks.AIR
+					    && chunkSections[sectionIndex].getBlockState(x, y, z).getBlock() != Blocks.CAVE_AIR
+					    && chunkSections[sectionIndex].getBlockState(x, y, z).getBlock() != Blocks.BARRIER)
+			{
+				return true;
+			}
+		}
+
+		return false;
+	}
+}

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

@@ -17,45 +17,96 @@
  */
 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 6-27-2021
+ * @version 8-14-2021
  */
 public class LodBuilderConfig
 {
-	/** default false */
+	/**
+	 * default false
+	 */
 	public boolean useHeightmap;
-	/** default false */
+	/**
+	 * default false
+	 */
 	public boolean useBiomeColors;
-	/** default true */
+	/**
+	 * default true
+	 */
 	public boolean useSolidBlocksInColorGen;
-	
-	/** default settings for a normal chunk 
-	 * useHeightmap = false
-	 * useBiomeColors = false
-	 * useSolidBlocksInColorGen = true
+	/**
+	 * 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 newUseHeightmap               default = false
+	 * @param newUseBiomeColors             default = false
 	 * @param newUseSolidBlocksInBiomeColor default = true
+	 * @param newDistanceGenerationMode     default = Server
 	 */
-	public LodBuilderConfig(boolean newUseHeightmap, boolean newUseBiomeColors, boolean newUseSolidBlocksInBiomeColor)
+	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/LodChunkBuilder.java

@@ -1,527 +0,0 @@
-/*
- *    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.awt.Color;
-import java.util.concurrent.ExecutorService;
-import java.util.concurrent.Executors;
-
-import com.seibel.lod.enums.LodDetail;
-import com.seibel.lod.handlers.LodConfig;
-import com.seibel.lod.objects.LodChunk;
-import com.seibel.lod.objects.LodDataPoint;
-import com.seibel.lod.objects.LodDimension;
-import com.seibel.lod.objects.LodWorld;
-import com.seibel.lod.util.LodUtil;
-
-import net.minecraft.block.AbstractPlantBlock;
-import net.minecraft.block.BlockState;
-import net.minecraft.block.Blocks;
-import net.minecraft.block.BushBlock;
-import net.minecraft.block.FlowingFluidBlock;
-import net.minecraft.block.GrassBlock;
-import net.minecraft.block.IGrowable;
-import net.minecraft.block.LeavesBlock;
-import net.minecraft.world.DimensionType;
-import net.minecraft.world.IWorld;
-import net.minecraft.world.biome.Biome;
-import net.minecraft.world.chunk.ChunkSection;
-import net.minecraft.world.chunk.IChunk;
-import net.minecraft.world.gen.Heightmap;
-
-/**
- * This object is in charge of creating Lod
- * related objects. 
- * (specifically: Lod World, Dimension, Region, and Chunk objects)
- * 
- * @author James Seibel
- * @version 6-27-2021
- */
-public class LodChunkBuilder
-{
-	private ExecutorService lodGenThreadPool = Executors.newSingleThreadExecutor();
-	
-	/** Default size of any LOD regions we use */
-	public int regionWidth = 5;
-	
-	
-	public static final int CHUNK_DATA_WIDTH = LodChunk.WIDTH;
-	public static final int CHUNK_SECTION_HEIGHT = LodChunk.WIDTH;
-	
-	
-	
-	public LodChunkBuilder()
-	{
-		
-	}
-	
-	
-	public void generateLodChunkAsync(IChunk chunk, LodWorld lodWorld, IWorld world)
-	{
-		generateLodChunkAsync(chunk, new LodBuilderConfig(), lodWorld, world);
-	}
-	
-	public void generateLodChunkAsync(IChunk chunk, LodBuilderConfig config, LodWorld lodWorld, IWorld world)
-	{
-		if (lodWorld == null || !lodWorld.getIsWorldLoaded())
-			return;
-		
-		// don't try to create an LOD object
-		// if for some reason we aren't
-		// given a valid chunk object
-		if (chunk == null)
-			return;
-			
-		Thread thread = new Thread(() ->
-		{
-			try
-			{
-				DimensionType dim = world.dimensionType();
-				
-				LodChunk lod = generateLodFromChunk(chunk, config);
-				
-				LodDimension lodDim;
-				
-				if (lodWorld.getLodDimension(dim) == null)
-				{
-					lodDim = new LodDimension(dim, lodWorld, regionWidth);
-					lodWorld.addLodDimension(lodDim);
-				}
-				else
-				{
-					lodDim = lodWorld.getLodDimension(dim);
-				}
-				
-				lodDim.addLod(lod);
-			}
-			catch(IllegalArgumentException | NullPointerException e)
-			{
-				// if the world changes while LODs are being generated
-				// they will throw errors as they try to access things that no longer
-				// exist.
-			}
-		});
-		lodGenThreadPool.execute(thread);
-		
-		return;
-	}
-	
-	
-	
-	
-	
-	/**
-	 * Creates a LodChunk for a chunk in the given world.
-	 * 
-	 * @throws IllegalArgumentException 
-	 * thrown if either the chunk or world is null.
-	 */
-	public LodChunk generateLodFromChunk(IChunk chunk) throws IllegalArgumentException
-	{
-		return generateLodFromChunk(chunk, new LodBuilderConfig());
-	}
-	
-	/**
-	 * Creates a LodChunk for a chunk in the given world.
-	 * 
-	 * @throws IllegalArgumentException 
-	 * thrown if either the chunk or world is null.
-	 */
-	public LodChunk generateLodFromChunk(IChunk chunk, LodBuilderConfig config) throws IllegalArgumentException
-	{
-		if(chunk == null)
-			throw new IllegalArgumentException("generateLodFromChunk given a null chunk");
-		
-		
-		LodDetail detail = LodConfig.CLIENT.lodDetail.get();
-		LodDataPoint[][] dataPoints = new LodDataPoint[detail.dataPointLengthCount][detail.dataPointLengthCount];
-		
-		for(int i = 0; i < detail.dataPointLengthCount * detail.dataPointLengthCount; i++)
-		{
-			int startX = detail.startX[i];
-			int startZ = detail.startZ[i];
-			int endX = detail.endX[i];
-			int endZ = detail.endZ[i];
-			
-			Color color;
-			
-			color = generateLodColorForArea(chunk, config, startX, startZ, endX, endZ);
-
-			
-			short height;
-			short depth;
-			
-			if (!config.useHeightmap)
-			{
-				height = determineHeightPointForArea(chunk.getSections(), startX, startZ, endX, endZ);
-				depth = determineBottomPointForArea(chunk.getSections(), startX, startZ, endX, endZ);
-			}
-			else
-			{
-				height = determineHeightPoint(chunk.getOrCreateHeightmapUnprimed(LodChunk.DEFAULT_HEIGHTMAP), startX, startZ, endX, endZ);
-				depth = 0;
-			}
-			
-			int x = i / detail.dataPointLengthCount;
-			int z = i % detail.dataPointLengthCount;
-			
-			dataPoints[x][z] = new LodDataPoint(height, depth, color);
-		}
-		
-		return new LodChunk(chunk.getPos(), dataPoints, detail);
-	}
-	
-	
-	
-	
-	
-	
-	//=====================//
-	// constructor helpers //
-	//=====================//
-	
-	
-	/**
-	 * Find the lowest valid point from the bottom.
-	 * @param chunkSections
-	 * @param startX
-	 * @param startZ
-	 * @param endX
-	 * @param endZ
-	 */
-	private short determineBottomPointForArea(ChunkSection[] chunkSections, 
-			int startX, int startZ, int endX, int endZ)
-	{
-		int numberOfBlocksRequired = ((endX-startX) * (endZ-startZ) / 2);
-		
-		// search from the bottom up
-		for(int section = 0; section < CHUNK_DATA_WIDTH; section++)
-		{
-			for(int y = 0; y < CHUNK_SECTION_HEIGHT; y++)
-			{
-				int numberOfBlocksFound = 0;
-				
-				for(int x = startX; x < endX; x++)
-				{
-					for(int z = startZ; z < endZ; z++)
-					{
-						if(isLayerValidLodPoint(chunkSections, section, y, x, z))
-						{
-							numberOfBlocksFound++;
-							
-							if (numberOfBlocksFound >= numberOfBlocksRequired)
-							{
-								// we found
-								// enough blocks in this
-								// layer to count as an
-								// LOD point
-								return (short) (y + (section * CHUNK_SECTION_HEIGHT));
-							}
-						}
-					}
-				}
-			}
-		}
-		
-		// we never found a valid LOD point
-		return -1;
-	}
-	
-	/**
-	 * Find the lowest valid point from the bottom.
-	 */
-	@SuppressWarnings("unused")
-	private short determineBottomPoint(Heightmap heightmap)
-	{
-		// the heightmap only shows how high the blocks go, it
-		// doesn't have any info about how low they go
-		return 0;
-	}
-	
-	
-	
-	/**
-	 * Find the highest valid point from the Top
-	 * @param chunkSections
-	 * @param startX
-	 * @param startZ
-	 * @param endX
-	 * @param endZ
-	 */
-	private short determineHeightPointForArea(ChunkSection[] chunkSections, 
-			int startX, int startZ, int endX, int endZ)
-	{
-		int numberOfBlocksRequired = ((endX-startX) * (endZ-startZ) / 2);
-		
-		// search from the top down
-		for(int section = chunkSections.length - 1; section >= 0; section--)
-		{
-			for(int y = CHUNK_DATA_WIDTH - 1; y >= 0; y--)
-			{
-				int numberOfBlocksFound = 0;
-				
-				for(int x = startX; x < endX; x++)
-				{
-					for(int z = startZ; z < endZ; z++)
-					{
-						if(isLayerValidLodPoint(chunkSections, section, y, x, z))
-						{
-							numberOfBlocksFound++;
-							
-							if (numberOfBlocksFound >= numberOfBlocksRequired)
-							{
-								// we found
-								// enough blocks in this
-								// layer to count as an
-								// LOD point
-								return (short) (y + (section * CHUNK_SECTION_HEIGHT));
-							}
-						}
-					}
-				}
-			}
-		}
-		
-		// we never found a valid LOD point
-		return -1;
-	}
-	
-	/**
-	 * Find the highest point from the Top
-	 */
-	private short determineHeightPoint(Heightmap heightmap,
-			int startX, int startZ, int endX, int endZ)
-	{
-		short highest = 0;
-		for(int x = startX; x < endX; x++)
-		{
-			for(int z = startZ; z < endZ; z++)
-			{
-				short newHeight = (short) heightmap.getFirstAvailable(x, z);
-				if (newHeight > highest)
-					highest = newHeight;
-			}
-		}
-		
-		return highest;
-	}
-	
-	/**
-	 * Generate the color for the given chunk using biome
-	 * water color, foliage color, and grass color.
-	 * 
-	 * @param config_useSolidBlocksInColorGen <br>
-	 * 			If true we look down from the top of the <br>
-	 * 			chunk until we find a non-invisible block, and then use <br>
-	 * 			its color. If false we generate the color immediately for <br>
-	 * 			each x and z.
-	 * @param config_useBiomeColors <br>
-	 * 			If true use biome foliage, water, and grass colors, <br>
-	 * 			otherwise only use the block's material color
-	 */
-	private Color  generateLodColorForArea(IChunk chunk, LodBuilderConfig config, int startX, int startZ, int endX, int endZ)
-	{
-		ChunkSection[] chunkSections = chunk.getSections();
-		
-		int numbOfBlocks = 0;
-		int red = 0;
-		int green = 0;
-		int blue = 0;
-		
-		
-		for(int x = startX; x < endX; x++)
-		{
-			for(int z = startZ; z < endZ; z++)
-			{
-				boolean foundBlock = false;
-				
-				// go top down
-				for(int i = chunkSections.length - 1; !foundBlock && i >= 0; i--)
-				{
-					if( !foundBlock && (chunkSections[i] != null || !config.useSolidBlocksInColorGen))
-					{
-						for(int y = CHUNK_SECTION_HEIGHT - 1; !foundBlock && y >= 0; y--)
-						{
-							int colorInt = 0;
-							BlockState blockState = null;
-							
-							if (chunkSections[i] != null)
-							{
-								blockState = chunkSections[i].getBlockState(x, y, z);
-								colorInt = blockState.materialColor.col;
-							}
-							
-							if(colorInt == 0 && config.useSolidBlocksInColorGen)
-							{
-								// skip air or invisible blocks
-								continue;
-							}
-							
-							if (config.useBiomeColors)
-							{
-								Biome biome = chunk.getBiomes().getNoiseBiome(x, y + i * chunkSections.length, z);
-								
-								if (biome.getBiomeCategory() == Biome.Category.OCEAN ||
-									biome.getBiomeCategory() == Biome.Category.RIVER)
-								{
-									if (config.useSolidBlocksInColorGen &&
-											blockState != Blocks.WATER.defaultBlockState())
-									{
-										// non-water block
-										colorInt = getColorForBlock(x, z, blockState, biome);
-									}
-									else
-									{
-										// water block
-										colorInt = biome.getWaterColor();
-									}
-								}
-								else if (biome.getBiomeCategory() == Biome.Category.EXTREME_HILLS)
-								{
-									colorInt = Blocks.STONE.defaultMaterialColor().col;
-								}
-								else if (biome.getBiomeCategory() == Biome.Category.ICY)
-								{
-									colorInt = LodUtil.colorToInt(Color.WHITE);
-								}
-								else if (biome.getBiomeCategory() == Biome.Category.THEEND)
-								{
-									colorInt = Blocks.END_STONE.defaultBlockState().materialColor.col;
-								}
-								else if (config.useSolidBlocksInColorGen)
-								{
-									colorInt = getColorForBlock(x, z, blockState, biome);
-								}
-								else
-								{
-									colorInt = biome.getGrassColor(x, z);
-								}
-							}
-							else
-							{
-								Biome biome = chunk.getBiomes().getNoiseBiome(x, y + i * chunkSections.length, z);
-								colorInt = getColorForBlock(x,z, blockState, biome);
-							}
-							
-							
-							Color c = LodUtil.intToColor(colorInt);
-							
-							red += c.getRed();
-							green += c.getGreen();
-							blue += c.getBlue();
-							
-							numbOfBlocks++;
-							
-							
-							// we found a valid block, skip to the
-							// next x and z
-							foundBlock = true;
-						}
-					}
-				}
-				
-			}
-		}
-		
-		if(numbOfBlocks == 0)
-			numbOfBlocks = 1;
-		
-		red /= numbOfBlocks;
-		green /= numbOfBlocks;
-		blue /= numbOfBlocks;
-		
-		return new Color(red, green, blue);
-	}
-
-
-
-	/**
-	 * Returns a color int for a given block.
-	 */
-	private int getColorForBlock(int x, int z, BlockState blockState, Biome biome)
-	{
-		int colorInt = 0;
-		
-		if (blockState == Blocks.AIR.defaultBlockState())
-		{
-			colorInt = biome.getGrassColor(x, z);
-		}
-		
-		
-		else if (blockState.getBlock() instanceof LeavesBlock)
-		{
-			Color leafColor = LodUtil.intToColor(biome.getFoliageColor()).darker();
-			colorInt = LodUtil.colorToInt(leafColor);
-		}
-		else if (blockState.getBlock() instanceof GrassBlock ||
-				blockState.getBlock() instanceof AbstractPlantBlock ||
-				blockState.getBlock() instanceof BushBlock ||
-				blockState.getBlock() instanceof IGrowable)
-		{
-			colorInt = biome.getGrassColor(x, z);
-		}
-		else if (blockState.getBlock() instanceof FlowingFluidBlock)
-		{
-			colorInt = biome.getWaterColor();
-		}
-		else
-		{
-			colorInt = blockState.materialColor.col;
-		}
-		
-		return colorInt;
-	}
-	
-	
-	
-	/**
-	 * Is the layer between the given X, Z, and dataIndex
-	 * values a valid LOD point?
-	 */
-	private boolean isLayerValidLodPoint(
-			ChunkSection[] chunkSections,
-			int sectionIndex, int y, 
-			int x, int z)
-	{
-		if(chunkSections[sectionIndex] == null)
-		{
-			// this section doesn't have any blocks,
-			// it is not a valid section
-			return false;
-		}
-		else
-		{
-			if(chunkSections[sectionIndex].getBlockState(x, y, z) != null && 
-				chunkSections[sectionIndex].getBlockState(x, y, z).getBlock() != Blocks.AIR)
-			{
-				return true;
-			}
-		}
-		
-		return false;
-	}
-	
-	
-
-
-	
-	
-	
-	
-	
-}

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

@@ -17,38 +17,36 @@
  */
 package com.seibel.lod.builders.lodTemplates;
 
-import com.seibel.lod.enums.LodDetail;
-import com.seibel.lod.objects.LodChunk;
-import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.enums.DebugMode;
 
 import net.minecraft.client.renderer.BufferBuilder;
+import net.minecraft.util.math.BlockPos;
 
 /**
  * This is the abstract class used to create different
  * BufferBuilders.
- * 
+ *
  * @author James Seibel
- * @version 06-16-2021
+ * @version 8-8-2021
  */
 public abstract class AbstractLodTemplate
 {
-	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, long[] adjData,
+	                                    byte detailLevel, int posX, int posZ, Box box, DebugMode 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)
 	{
 		buffer.vertex(x, y, z).color(red, green, blue, alpha).endVertex();
 	}
-	
-	/** Returns in bytes how much buffer memory is required
-	 * for one LOD object */
-	public abstract int getBufferMemoryForSingleLod(LodDetail detail);
-	
-	
-	
+
+	/**
+	 * Returns in bytes how much buffer memory is required
+	 * for one LOD object
+	 */
+	public abstract int getBufferMemoryForSingleNode();
 }

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

@@ -0,0 +1,64 @@
+package com.seibel.lod.builders.lodTemplates;
+
+public class Box
+{
+	public static final int DOWN = 0;
+	public static final int UP = 1;
+	public static final int EAST = 2;
+	public static final int WEST = 3;
+	public static final int SOUTH = 4;
+	public static final int NORTH = 5;
+
+	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 int[][] box;
+
+	public Box(){
+		box = new int[2][3];
+	}
+
+	public void set(int xWidth, int yWidth, int zWidth){
+			box[OFFSET][X] = 0;
+			box[OFFSET][Y] = 0;
+			box[OFFSET][Z] = 0;
+
+			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 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

@@ -17,175 +17,366 @@
  */
 package com.seibel.lod.builders.lodTemplates;
 
-import java.awt.Color;
-
-import com.seibel.lod.enums.ColorDirection;
-import com.seibel.lod.enums.LodDetail;
-import com.seibel.lod.handlers.LodConfig;
-import com.seibel.lod.objects.LodChunk;
-import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DebugMode;
+import com.seibel.lod.enums.ShadingMode;
+import com.seibel.lod.objects.DataPoint;
+import com.seibel.lod.util.ColorUtil;
+import com.seibel.lod.util.LodUtil;
 
+import net.minecraft.client.Minecraft;
 import net.minecraft.client.renderer.BufferBuilder;
-import net.minecraft.util.math.AxisAlignedBB;
+import net.minecraft.util.Direction;
+import net.minecraft.util.math.BlockPos;
 
 /**
  * Builds LODs as rectangular prisms.
- * 
+ *
  * @author James Seibel
- * @version 06-16-2021
+ * @version 8-10-2021
  */
 public class CubicLodTemplate extends AbstractLodTemplate
 {
-	
+	private final int CULL_OFFSET = 16;
+
 	public CubicLodTemplate()
 	{
-		
+
 	}
-	
-	
+
 	@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, long[] adjData,
+	                           byte detailLevel, int posX, int posZ, Box box, DebugMode debugging)
 	{
-		AxisAlignedBB bbox;
-		
-		// Add this LOD to the BufferBuilder
-		// using the quality setting set by the config
-		LodDetail detail = LodConfig.CLIENT.lodDetail.get();
-		
-		int halfWidth = detail.dataPointWidth / 2;
-		
-		for(int i = 0; i < detail.dataPointLengthCount * detail.dataPointLengthCount; i++)
+		int width = 1 << detailLevel;
+
+		// add each LOD for the detail level
+		generateBoundingBox(
+				box,
+				DataPoint.getHeight(data),
+				DataPoint.getDepth(data),
+				width,
+				posX * width,
+				0,
+				posZ * width,
+				bufferCenterBlockPos);
+
+		int color = DataPoint.getColor(data);
+		if (debugging != DebugMode.OFF)
 		{
-			int startX = detail.startX[i];
-			int startZ = detail.startZ[i];
-			int endX = detail.endX[i];
-			int endZ = detail.endZ[i];
-			
-			// returns null if the lod is empty at the given location
-			bbox = generateBoundingBox(
-					centerLod.getAverageHeightOverArea(startX, startZ, endX, endZ), 
-					centerLod.getAverageDepthOverArea(startX, startZ, endX, endZ), 
-					detail.dataPointWidth, 
-					xOffset - (halfWidth / 2) + detail.startX[i],
-					yOffset, 
-					zOffset - (halfWidth / 2) + detail.startZ[i]);
-			
-			if (bbox != null)
-			{
-				addBoundingBoxToBuffer(buffer, bbox, centerLod.getAverageColorOverArea(startX, startZ, endX, endZ, debugging));
-			}
+			color = LodUtil.DEBUG_DETAIL_LEVEL_COLORS[detailLevel].getRGB();
 		}
+
+		if (box != null)
+		{
+			addBoundingBoxToBuffer(buffer, box, color, bufferCenterBlockPos, adjData);
+		}
+
 	}
-	
-	
-	
-	
-	
-	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)
 	{
 		// don't add an LOD if it is empty
 		if (height == -1 && depth == -1)
-			return null;
-		
+			return;
+
 		if (depth == height)
 		{
 			// if the top and bottom points are at the same height
 			// render this LOD as 1 block thick
 			height++;
 		}
-		
-		return new AxisAlignedBB(0, depth, 0, width, height, width).move(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.set(width, height - depth, width);
+		box.move((int) (xOffset + x), (int) (yOffset + depth), (int) (zOffset + z));
 	}
-	
-	
-	
-	private void addBoundingBoxToBuffer(BufferBuilder buffer, AxisAlignedBB bb, Color c)
+
+	private void addBoundingBoxToBuffer(BufferBuilder buffer, Box box, int c, BlockPos playerBlockPos, long[] adjData)
 	{
-		// top (facing up)
-		addPosAndColor(buffer, bb.minX, bb.maxY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		addPosAndColor(buffer, bb.minX, bb.maxY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		// bottom (facing down)
-		addPosAndColor(buffer, bb.maxX, bb.minY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		addPosAndColor(buffer, bb.maxX, bb.minY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		addPosAndColor(buffer, bb.minX, bb.minY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		addPosAndColor(buffer, bb.minX, bb.minY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		int topColor = c;
+		int bottomColor = c;
+		int northColor = c;
+		int southColor = c;
+		int westColor = c;
+		int eastColor = c;
 
-		// south (facing -Z) 
-		addPosAndColor(buffer, bb.maxX, bb.minY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		addPosAndColor(buffer, bb.minX, bb.maxY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		addPosAndColor(buffer, bb.minX, bb.minY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		// north (facing +Z)
-		addPosAndColor(buffer, bb.minX, bb.minY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		addPosAndColor(buffer, bb.minX, bb.maxY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		addPosAndColor(buffer, bb.maxX, bb.minY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		// darken the bottom and side colors if requested
+		if (LodConfig.CLIENT.graphics.shadingMode.get() == ShadingMode.DARKEN_SIDES)
+		{
+			// the side colors are different because
+			// when using fast lighting in Minecraft the north/south
+			// and east/west sides are different in a similar way
+			/**TODO OPTIMIZE THIS STEP*/
+			Minecraft mc = Minecraft.getInstance();
+			topColor = ColorUtil.applyShade(c, mc.level.getShade(Direction.UP, true));
+			bottomColor = ColorUtil.applyShade(c, mc.level.getShade(Direction.DOWN, true));
+			northColor = ColorUtil.applyShade(c, mc.level.getShade(Direction.NORTH, true));
+			southColor = ColorUtil.applyShade(c, mc.level.getShade(Direction.SOUTH, true));
+			westColor = ColorUtil.applyShade(c, mc.level.getShade(Direction.WEST, true));
+			eastColor = ColorUtil.applyShade(c, mc.level.getShade(Direction.EAST, true));
+		}
 
-		// west (facing -X)
-		addPosAndColor(buffer, bb.minX, bb.minY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		addPosAndColor(buffer, bb.minX, bb.minY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		addPosAndColor(buffer, bb.minX, bb.maxY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		addPosAndColor(buffer, bb.minX, bb.maxY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		// east (facing +X)
-		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		addPosAndColor(buffer, bb.maxX, bb.minY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
-		addPosAndColor(buffer, bb.maxX, bb.minY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		// apply the user specified saturation and brightness
+		float saturationMultiplier = LodConfig.CLIENT.graphics.saturationMultiplier.get().floatValue();
+		float brightnessMultiplier = LodConfig.CLIENT.graphics.brightnessMultiplier.get().floatValue();
+
+		if (saturationMultiplier != 1 || brightnessMultiplier != 1)
+		{
+			topColor = ColorUtil.applySaturationAndBrightnessMultipliers(topColor, saturationMultiplier, brightnessMultiplier);
+			bottomColor = ColorUtil.applySaturationAndBrightnessMultipliers(bottomColor, saturationMultiplier, brightnessMultiplier);
+			northColor = ColorUtil.applySaturationAndBrightnessMultipliers(northColor, saturationMultiplier, brightnessMultiplier);
+			southColor = ColorUtil.applySaturationAndBrightnessMultipliers(southColor, saturationMultiplier, brightnessMultiplier);
+			westColor = ColorUtil.applySaturationAndBrightnessMultipliers(westColor, saturationMultiplier, brightnessMultiplier);
+			eastColor = ColorUtil.applySaturationAndBrightnessMultipliers(eastColor, saturationMultiplier, brightnessMultiplier);
+		}
+		int minX;
+		int maxX;
+		int minY;
+		int maxY;
+		int minZ;
+		int maxZ;
+		long data;
+		int tempMinY;
+		int tempMaxY;
+
+		int red;
+		int green;
+		int blue;
+		int alpha;
+		boolean disableCulling = true;
+		/**TODO make all of this more automatic if possible*/
+		if (playerBlockPos.getY() > box.getMaxY() - CULL_OFFSET || disableCulling)
+		{
+			red = ColorUtil.getRed(topColor);
+			green = ColorUtil.getGreen(topColor);
+			blue = ColorUtil.getBlue(topColor);
+			alpha = ColorUtil.getAlpha(topColor);
+			// top (facing up)
+			minX = box.getMinX();
+			maxX = box.getMaxX();
+			minY = box.getMinY();
+			maxY = box.getMaxY();
+			minZ = box.getMinZ();
+			maxZ = box.getMaxZ();
+			addPosAndColor(buffer, minX, maxY, minZ, red, green, blue, alpha);
+			addPosAndColor(buffer, minX, maxY, maxZ, red, green, blue, alpha);
+			addPosAndColor(buffer, maxX, maxY, maxZ, red, green, blue, alpha);
+			addPosAndColor(buffer, maxX, maxY, minZ, red, green, blue, alpha);
+		}
+		if (playerBlockPos.getY() < box.getMinY() + CULL_OFFSET || disableCulling)
+		{
+			red = ColorUtil.getRed(bottomColor);
+			green = ColorUtil.getGreen(bottomColor);
+			blue = ColorUtil.getBlue(bottomColor);
+			alpha = ColorUtil.getAlpha(bottomColor);
+			// bottom (facing down)
+			minX = box.getMinX();
+			maxX = box.getMaxX();
+			minY = box.getMinY();
+			maxY = box.getMaxY();
+			minZ = box.getMinZ();
+			maxZ = box.getMaxZ();
+			addPosAndColor(buffer, maxX, minY, minZ, red, green, blue, alpha);
+			addPosAndColor(buffer, maxX, minY, maxZ, red, green, blue, alpha);
+			addPosAndColor(buffer, minX, minY, maxZ, red, green, blue, alpha);
+			addPosAndColor(buffer, minX, minY, minZ, red, green, blue, alpha);
+		}
+
+		if (playerBlockPos.getX() < box.getMaxX() + CULL_OFFSET || disableCulling)
+		{
+			red = ColorUtil.getRed(westColor);
+			green = ColorUtil.getGreen(westColor);
+			blue = ColorUtil.getBlue(westColor);
+			alpha = ColorUtil.getAlpha(westColor);
+			// west (facing -X)
+			data = adjData[0];
+
+			minX = box.getMinX();
+			maxX = box.getMaxX();
+			minY = box.getMinY();
+			maxY = box.getMaxY();
+			minZ = box.getMinZ();
+			maxZ = box.getMaxZ();
+			if (data == 0)
+			{
+				addPosAndColor(buffer, minX, minY, minZ, red, green, blue, alpha);
+				addPosAndColor(buffer, minX, minY, maxZ, red, green, blue, alpha);
+				addPosAndColor(buffer, minX, maxY, maxZ, red, green, blue, alpha);
+				addPosAndColor(buffer, minX, maxY, minZ, red, green, blue, alpha);
+			}else
+			{
+				maxY = box.getMaxY();
+				tempMaxY = DataPoint.getHeight(data);
+				if (tempMaxY < maxY)
+				{
+					minY = Math.max(tempMaxY, minY);
+					addPosAndColor(buffer, minX, minY, minZ, red, green, blue, alpha);
+					addPosAndColor(buffer, minX, minY, maxZ, red, green, blue, alpha);
+					addPosAndColor(buffer, minX, maxY, maxZ, red, green, blue, alpha);
+					addPosAndColor(buffer, minX, maxY, minZ, red, green, blue, alpha);
+				}
+				tempMinY = DataPoint.getDepth(data);
+				minY = box.getMinY();
+				if (tempMinY > minY)
+				{
+					maxY = Math.min(tempMinY, maxY);
+					addPosAndColor(buffer, minX, minY, minZ, red, green, blue, alpha);
+					addPosAndColor(buffer, minX, minY, maxZ, red, green, blue, alpha);
+					addPosAndColor(buffer, minX, maxY, maxZ, red, green, blue, alpha);
+					addPosAndColor(buffer, minX, maxY, minZ, red, green, blue, alpha);
+				}
+			}
+		}
+
+		if (playerBlockPos.getX() > box.getMinX() - CULL_OFFSET || disableCulling)
+		{
+			red = ColorUtil.getRed(eastColor);
+			green = ColorUtil.getGreen(eastColor);
+			blue = ColorUtil.getBlue(eastColor);
+			alpha = ColorUtil.getAlpha(eastColor);
+			// east (facing +X)
+			data = adjData[1];
+			minX = box.getMinX();
+			maxX = box.getMaxX();
+			minY = box.getMinY();
+			maxY = box.getMaxY();
+			minZ = box.getMinZ();
+			maxZ = box.getMaxZ();
+			if (data == 0)
+			{
+				addPosAndColor(buffer, maxX, maxY, minZ, red, green, blue, alpha);
+				addPosAndColor(buffer, maxX, maxY, maxZ, red, green, blue, alpha);
+				addPosAndColor(buffer, maxX, minY, maxZ, red, green, blue, alpha);
+				addPosAndColor(buffer, maxX, minY, minZ, red, green, blue, alpha);
+			}
+			else
+			{
+				maxY = box.getMaxY();
+				tempMaxY = DataPoint.getHeight(data);
+				if (tempMaxY < maxY)
+				{
+					minY = Math.max(tempMaxY, minY);
+					addPosAndColor(buffer, maxX, maxY, minZ, red, green, blue, alpha);
+					addPosAndColor(buffer, maxX, maxY, maxZ, red, green, blue, alpha);
+					addPosAndColor(buffer, maxX, minY, maxZ, red, green, blue, alpha);
+					addPosAndColor(buffer, maxX, minY, minZ, red, green, blue, alpha);
+				}
+				tempMinY = DataPoint.getDepth(data);
+				minY = box.getMinY();
+				if (tempMinY > minY)
+				{
+					maxY = Math.min(tempMinY, maxY);
+					addPosAndColor(buffer, maxX, maxY, minZ, red, green, blue, alpha);
+					addPosAndColor(buffer, maxX, maxY, maxZ, red, green, blue, alpha);
+					addPosAndColor(buffer, maxX, minY, maxZ, red, green, blue, alpha);
+					addPosAndColor(buffer, maxX, minY, minZ, red, green, blue, alpha);
+				}
+			}
+		}
+
+		if (playerBlockPos.getZ() > box.getMinZ() - CULL_OFFSET || disableCulling)
+		{
+			red = ColorUtil.getRed(northColor);
+			green = ColorUtil.getGreen(northColor);
+			blue = ColorUtil.getBlue(northColor);
+			alpha = ColorUtil.getAlpha(northColor);
+			data = adjData[3];
+			minX = box.getMinX();
+			maxX = box.getMaxX();
+			minY = box.getMinY();
+			maxY = box.getMaxY();
+			minZ = box.getMinZ();
+			maxZ = box.getMaxZ();
+			// north (facing +Z)
+			if (data == 0)
+			{
+				addPosAndColor(buffer, maxX, minY, maxZ, red, green, blue, alpha);
+				addPosAndColor(buffer, maxX, maxY, maxZ, red, green, blue, alpha);
+				addPosAndColor(buffer, minX, maxY, maxZ, red, green, blue, alpha);
+				addPosAndColor(buffer, minX, minY, maxZ, red, green, blue, alpha);
+			}
+			else
+			{
+				maxY = box.getMaxY();
+				tempMaxY = DataPoint.getHeight(data);
+				if (tempMaxY < maxY)
+				{
+					minY = Math.max(tempMaxY, minY);
+					addPosAndColor(buffer, maxX, minY, maxZ, red, green, blue, alpha);
+					addPosAndColor(buffer, maxX, maxY, maxZ, red, green, blue, alpha);
+					addPosAndColor(buffer, minX, maxY, maxZ, red, green, blue, alpha);
+					addPosAndColor(buffer, minX, minY, maxZ, red, green, blue, alpha);
+				}
+				tempMinY = DataPoint.getDepth(data);
+				minY = box.getMinY();
+				if (tempMinY > minY)
+				{
+					maxY = Math.min(tempMinY, maxY);
+					addPosAndColor(buffer, maxX, minY, maxZ, red, green, blue, alpha);
+					addPosAndColor(buffer, maxX, maxY, maxZ, red, green, blue, alpha);
+					addPosAndColor(buffer, minX, maxY, maxZ, red, green, blue, alpha);
+					addPosAndColor(buffer, minX, minY, maxZ, red, green, blue, alpha);
+				}
+			}
+		}
+
+		if (playerBlockPos.getZ() < box.getMaxZ() + CULL_OFFSET || disableCulling)
+		{
+			red = ColorUtil.getRed(southColor);
+			green = ColorUtil.getGreen(southColor);
+			blue = ColorUtil.getBlue(southColor);
+			alpha = ColorUtil.getAlpha(southColor);
+			data = adjData[2];
+			minX = box.getMinX();
+			maxX = box.getMaxX();
+			minY = box.getMinY();
+			maxY = box.getMaxY();
+			minZ = box.getMinZ();
+			maxZ = box.getMaxZ();
+			// south (facing -Z)
+			if (data == 0)
+			{
+				addPosAndColor(buffer, minX, minY, minZ, red, green, blue, alpha);
+				addPosAndColor(buffer, minX, maxY, minZ, red, green, blue, alpha);
+				addPosAndColor(buffer, maxX, maxY, minZ, red, green, blue, alpha);
+				addPosAndColor(buffer, maxX, minY, minZ, red, green, blue, alpha);
+			}
+			else
+			{
+				maxY = box.getMaxY();
+				tempMaxY = DataPoint.getHeight(data);
+				if (tempMaxY < maxY)
+				{
+					minY = Math.max(tempMaxY, minY);
+					addPosAndColor(buffer, minX, minY, minZ, red, green, blue, alpha);
+					addPosAndColor(buffer, minX, maxY, minZ, red, green, blue, alpha);
+					addPosAndColor(buffer, maxX, maxY, minZ, red, green, blue, alpha);
+					addPosAndColor(buffer, maxX, minY, minZ, red, green, blue, alpha);
+				}
+				tempMinY = DataPoint.getDepth(data);
+				minY = box.getMinY();
+				if (tempMinY > minY)
+				{
+					maxY = Math.min(tempMinY, maxY);
+					addPosAndColor(buffer, minX, minY, minZ, red, green, blue, alpha);
+					addPosAndColor(buffer, minX, maxY, minZ, red, green, blue, alpha);
+					addPosAndColor(buffer, maxX, maxY, minZ, red, green, blue, alpha);
+					addPosAndColor(buffer, maxX, minY, minZ, red, green, blue, alpha);
+				}
+			}
+		}
 	}
-	
-	
-	
-	@SuppressWarnings("unused")
-	private void addBoundingBoxToBuffer(BufferBuilder buffer, AxisAlignedBB bb, Color[] c)
-	{
-		// 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());
-	}
-
 
 	@Override
-	public int getBufferMemoryForSingleLod(LodDetail detail)
+	public int getBufferMemoryForSingleNode()
 	{
-		// (sidesOnACube * pointsInASquare * (positionPoints + colorPoints))) * howManyPointsPerLodChunk
-		return (6 * 4 * (3 + 4)) * detail.dataPointLengthCount * detail.dataPointLengthCount;
+		// (sidesOnACube * pointsInASquare * (positionPoints + colorPoints)))
+		return (6 * 4 * (3 + 4));
 	}
-	
-	
-	
-	
+
 }

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

@@ -17,35 +17,32 @@
  */
 package com.seibel.lod.builders.lodTemplates;
 
-import com.seibel.lod.enums.LodDetail;
-import com.seibel.lod.objects.LodChunk;
-import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.enums.DebugMode;
 
 import net.minecraft.client.renderer.BufferBuilder;
+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 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, long[] adjData,
+	                           byte detailLevel, int posX, int posZ, Box box, DebugMode debugging)
 	{
 		System.err.println("DynamicLodTemplate not implemented!");
 	}
 
 	@Override
-	public int getBufferMemoryForSingleLod(LodDetail detail) {
-		// TODO Auto-generated method stub
+	public int getBufferMemoryForSingleNode()
+	{
 		return 0;
 	}
 }

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

@@ -17,33 +17,30 @@
  */
 package com.seibel.lod.builders.lodTemplates;
 
-import com.seibel.lod.enums.LodDetail;
-import com.seibel.lod.objects.LodChunk;
-import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.enums.DebugMode;
 
 import net.minecraft.client.renderer.BufferBuilder;
+import net.minecraft.util.math.BlockPos;
 
 /**
  * TODO #21 TriangularLodTemplate
  * Builds each LOD chunk as a singular rectangular prism.
- * 
+ *
  * @author James Seibel
  * @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, long[] adjData,
+	                           byte detailLevel, int posX, int posZ, Box box, DebugMode debugging)
 	{
 		System.err.println("DynamicLodTemplate not implemented!");
 	}
 
 	@Override
-	public int getBufferMemoryForSingleLod(LodDetail detail) {
-		// TODO Auto-generated method stub
+	public int getBufferMemoryForSingleNode()
+	{
 		return 0;
 	}
 }

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

@@ -26,24 +26,22 @@ import java.util.concurrent.ExecutorService;
 import java.util.concurrent.Executors;
 import java.util.function.Supplier;
 
-import com.seibel.lod.builders.LodBufferBuilder;
+import com.seibel.lod.builders.LodBuilder;
 import com.seibel.lod.builders.LodBuilderConfig;
-import com.seibel.lod.builders.LodChunkBuilder;
+import com.seibel.lod.config.LodConfig;
 import com.seibel.lod.enums.DistanceGenerationMode;
-import com.seibel.lod.handlers.LodConfig;
-import com.seibel.lod.objects.LodChunk;
 import com.seibel.lod.objects.LodDimension;
-import com.seibel.lod.objects.LodRegion;
 import com.seibel.lod.proxy.ClientProxy;
-import com.seibel.lod.render.LodRenderer;
+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.biome.BiomeContainer;
 import net.minecraft.world.chunk.ChunkPrimer;
 import net.minecraft.world.chunk.ChunkStatus;
 import net.minecraft.world.chunk.IChunk;
@@ -68,145 +66,183 @@ import net.minecraftforge.common.WorldWorkerManager.IWorker;
 
 /**
  * This is used to generate a LodChunk at a given ChunkPos.
- * 
+ *
  * @author James Seibel
- * @version 7-5-2021
+ * @version 9-7-2021
  */
-public class LodChunkGenWorker implements IWorker
+public class LodNodeGenWorker implements IWorker
 {
-    public static final ExecutorService genThreads = Executors.newFixedThreadPool(LodConfig.CLIENT.numberOfWorldGenerationThreads.get());
-    
-    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 LodChunkGenWorker(ChunkPos newPos, LodRenderer newLodRenderer, 
-    		LodChunkBuilder newLodBuilder, LodBufferBuilder newLodBufferBuilder, 
-    		LodDimension newLodDimension, ServerWorld newServerWorld,
-    		BiomeContainer newBiomeContainer)
-    {
-        if (newServerWorld == null)
-        	throw new IllegalArgumentException("LodChunkGenWorker must have a non-null ServerWorld"); 
-        	
-        thread = new LodChunkGenThread(newPos, newLodRenderer, 
-        		newLodBuilder, newLodBufferBuilder, 
-        		newLodDimension, newServerWorld);
-    }
-    
-    @Override
-    public boolean doWork()
-    {
-        if (!threadStarted)
-        {
-        	thread.lodBufferBuilder.numberOfChunksWaitingToGenerate.addAndGet(-1);
-        	
-        	if (LodConfig.CLIENT.distanceGenerationMode.get() == DistanceGenerationMode.SERVER)
+	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);
+	}
+
+	@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();
+				// 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
-        		genThreads.execute(thread);
-        	}
-        	
-        	threadStarted = true;
-        	
-    		// useful for debugging
+			else
+			{
+				// Every other method can
+				// be done asynchronously
+				Thread newThread = new Thread(thread);
+				newThread.setPriority(3);
+				genThreads.execute(newThread);
+			}
+
+			threadStarted = true;
+
+			// useful for debugging
 //        	ClientProxy.LOGGER.info(thread.lodDim.getNumberOfLods());
-        }
-        
-        return false;
-    }
-    
-    @Override
-    public boolean hasWork()
-    {
-        return !threadStarted;
-    }
-    
-    
-    
-    
-    private class LodChunkGenThread implements Runnable
-    {
-    	public final ServerWorld serverWorld;
-        public final LodDimension lodDim;
-        public final LodChunkBuilder lodChunkBuilder;
-        public final LodRenderer lodRenderer;
-        private LodBufferBuilder lodBufferBuilder;
-    	
-    	private ChunkPos pos;
-    	
-    	public LodChunkGenThread(ChunkPos newPos, LodRenderer newLodRenderer, 
-        		LodChunkBuilder newLodBuilder, LodBufferBuilder newLodBufferBuilder, 
-        		LodDimension newLodDimension, ServerWorld newServerWorld)
-    	{
-    		pos = newPos;
-    		lodRenderer = newLodRenderer;
-    		lodChunkBuilder = newLodBuilder;
-    		lodBufferBuilder = newLodBufferBuilder;
-    		lodDim = newLodDimension;
-    		serverWorld = newServerWorld;
-    	}
-    	
+//        	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()
 		{
-			// only generate LodChunks if they can
-            // be added to the current LodDimension
-			if (lodDim.regionIsInRange(pos.x / LodRegion.SIZE, pos.z / LodRegion.SIZE))
+			try
 			{
-//				long startTime = System.currentTimeMillis();
-				
-				switch(LodConfig.CLIENT.distanceGenerationMode.get())
+				// 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))
 				{
-				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;
+//					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);
 				
-				lodRenderer.regenerateLODsNextFrame();
-				
-				
-//				if (lodDim.getLodFromCoordinates(pos.x, pos.z) != null)
-//					ClientProxy.LOGGER.info(pos.x + " " + pos.z + " Success!");
-//				else
-//					ClientProxy.LOGGER.info(pos.x + " " + pos.z);
-				
-//				long endTime = System.currentTimeMillis();
-//				System.out.println(endTime - startTime);
-				
-			}// if in range
-			
+				// this position is no longer being generated
+				LodWorldGenerator.INSTANCE.positionWaitingToBeGenerated.remove(pos);
+			}
+
 		}// run
-		
-		
-		
+
+
+
 		/**
 		 * takes about 2-5 ms
 		 */
@@ -215,79 +251,78 @@ public class LodChunkGenWorker implements IWorker
 			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);
-			ChunkStatus.BIOMES.generate(serverWorld, chunkGen, serverWorld.getStructureManager(), (ServerWorldLightManager) serverWorld.getLightEngine(), null, chunkList);
+			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 = LodConfig.CLIENT.distanceGenerationMode.get() == DistanceGenerationMode.BIOME_ONLY_SIMULATE_HEIGHT;
+
+			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, LodChunk.DEFAULT_HEIGHTMAP);
-			for(int x = 0; x < LodChunk.WIDTH && !inTheEnd; x++)
+			Heightmap heightmap = new Heightmap(chunk, LodUtil.DEFAULT_HEIGHTMAP);
+			for(int x = 0; x < LodUtil.CHUNK_WIDTH && !inTheEnd; x++)
 			{
-				for(int z = 0; z < LodChunk.WIDTH && !inTheEnd; z++)
+				for(int z = 0; z < LodUtil.CHUNK_WIDTH && !inTheEnd; z++)
 				{
 					if (simulateHeight)
 					{
-						// TODO use the biomes around each block to smooth out the transition
-						
 						// 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, seaLevel, z).getBiomeCategory())
+						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;
+							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
@@ -298,26 +333,29 @@ public class LodChunkGenWorker implements IWorker
 					}
 				}// z
 			}// x
-			
-			chunk.setHeightmap(LodChunk.DEFAULT_HEIGHTMAP, heightmap.getRawData());
-			
-			
-			LodChunk lod;
+
+			chunk.setHeightmap(LodUtil.DEFAULT_HEIGHTMAP, heightmap.getRawData());
+
+
 			if (!inTheEnd)
 			{
-				lod = lodChunkBuilder.generateLodFromChunk(chunk, new LodBuilderConfig(true, true, false));
+				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.
-				lod = new LodChunk(chunk.getPos().x, chunk.getPos().z);
+				lodBuilder.generateLodNodeFromChunk(lodDim, chunk, new LodBuilderConfig(true, true, false));
 			}
-			lodDim.addLod(lod);
+
+
+//			long startTime = System.currentTimeMillis();
+//			long endTime = System.currentTimeMillis();
+//			System.out.println(endTime - startTime);
 		}
-		
-		
+
+
 		/**
 		 * takes about 10 - 20 ms
 		 */
@@ -327,33 +365,34 @@ public class LodChunkGenWorker implements IWorker
 			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);
-			ChunkStatus.BIOMES.generate(serverWorld, chunkGen, serverWorld.getStructureManager(), (ServerWorldLightManager) serverWorld.getLightEngine(), null, chunkList);
+			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 proved to be thread safe
+
+			// 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);
-			
-			
-			LodChunk lod = lodChunkBuilder.generateLodFromChunk(chunk);
-			lodDim.addLod(lod);
+
+			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
 		 */
@@ -363,28 +402,28 @@ public class LodChunkGenWorker implements IWorker
 			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);
-			ChunkStatus.BIOMES.generate(serverWorld, chunkGen, serverWorld.getStructureManager(), (ServerWorldLightManager) serverWorld.getLightEngine(), null, chunkList);
+			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 < LodChunk.WIDTH; x++)
+			for (int x = 0; x < LodUtil.CHUNK_WIDTH; x++)
 			{
-				for (int z = 0; z < LodChunk.WIDTH; z++)
+				for (int z = 0; z < LodUtil.CHUNK_WIDTH; z++)
 				{
-					Biome biome = chunk.getBiomes().getNoiseBiome(x, serverWorld.getSeaLevel(), 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
@@ -399,26 +438,26 @@ public class LodChunkGenWorker implements IWorker
 					}
 				}
 			}
-			
-			boolean allowUnstableFeatures = LodConfig.CLIENT.allowUnstableFeatureGeneration.get();
-			
+
+			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()))
+								configuredFeaturesToAvoid.containsKey(configuredFeature.hashCode()))
 							continue;
-						
-						
+
+
 						try
 						{
 							configuredFeature.place(lodServerWorld, chunkGen, serverWorld.random, chunk.getPos().getWorldPosition());
@@ -429,16 +468,16 @@ public class LodChunkGenWorker implements IWorker
 							// 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 
+							// ( https://github.com/kostaskougios/cloning
 							//   and
 							//   https://github.com/EsotericSoftware/kryo )
-							
+
 							if (!allowUnstableFeatures)
 								configuredFeaturesToAvoid.put(configuredFeature.hashCode(), configuredFeature);
 //							ClientProxy.LOGGER.info(configuredFeaturesToAvoid.mappingCount());
@@ -448,7 +487,7 @@ public class LodChunkGenWorker implements IWorker
 							// 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());
@@ -456,13 +495,13 @@ public class LodChunkGenWorker implements IWorker
 						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());
@@ -470,51 +509,51 @@ public class LodChunkGenWorker implements IWorker
 					}
 				}
 			}
-			
+
 			// generate a Lod like normal
-			LodChunk lod = lodChunkBuilder.generateLodFromChunk(chunk);
-			lodDim.addLod(lod);
+
+			lodBuilder.generateLodNodeFromChunk(lodDim, chunk, new LodBuilderConfig(DistanceGenerationMode.FEATURES));
 		}
-		
-		
+
+
 		/**
 		 * on pre generated chunks 0 - 1 ms
-		 * on un generated chunks 0 - 50 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()
 		{
-			lodChunkBuilder.generateLodChunkAsync(serverWorld.getChunk(pos.x, pos.z, ChunkStatus.FEATURES), ClientProxy.getLodWorld(), serverWorld);
+			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)
@@ -532,29 +571,29 @@ public class LodChunkGenWorker implements IWorker
 //				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();
 			for(Entry<BlockState> state : ((WeightedBlockStateProvider) config.stateProvider).weightedList.entries)
 				provider.weightedList.entries.add(state);
-			
+
 			HashSet<Block> whitelist = new HashSet<>();
 			for(Block block : config.whitelist)
 				whitelist.add(block);
-			
+
 			HashSet<BlockState> blacklist = new HashSet<>();
 			for(BlockState state : config.blacklist)
-				blacklist.add(state); 
-			
-			
+				blacklist.add(state);
+
+
 			BlockClusterFeatureConfig.Builder builder = new BlockClusterFeatureConfig.Builder(provider, config.blockPlacer);
 			builder.whitelist(whitelist);
 			builder.blacklist(blacklist);
@@ -565,21 +604,43 @@ public class LodChunkGenWorker implements IWorker
 			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)
@@ -592,11 +653,11 @@ public class LodChunkGenWorker implements IWorker
      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

@@ -23,7 +23,7 @@ import java.util.Random;
 import java.util.function.Predicate;
 import java.util.stream.Stream;
 
-import com.seibel.lod.objects.LodChunk;
+import com.seibel.lod.util.LodUtil;
 
 import net.minecraft.block.Block;
 import net.minecraft.block.BlockState;
@@ -65,257 +65,266 @@ import net.minecraft.world.storage.IWorldInfo;
  * This allows us to keep each LodChunk generation independent
  * of the actual ServerWorld, allowing us
  * to multithread generation.
- * 
+ *
  * @author James Seibel
- * @version 7-4-2021
+ * @version 7-26-2021
  */
-public class LodServerWorld implements ISeedReader {
-	
+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 % LodChunk.WIDTH;
+		x = x % LodUtil.CHUNK_WIDTH;
 		x = (x < 0) ? x + 16 : x;
-		
-		z = z % LodChunk.WIDTH;
+
+		z = z % LodUtil.CHUNK_WIDTH;
 		z = (z < 0) ? z + 16 : z;
-		
-		return chunk.getOrCreateHeightmapUnprimed(LodChunk.DEFAULT_HEIGHTMAP).getFirstAvailable(x, z);
+
+		return chunk.getOrCreateHeightmapUnprimed(LodUtil.DEFAULT_HEIGHTMAP).getFirstAvailable(x, z);
 	}
-	
+
 	@Override
 	public Biome getBiome(BlockPos pos)
 	{
-		return chunk.getBiomes().getNoiseBiome(pos.getX(), pos.getY(), pos.getZ());
+		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);
 	}
-	
-	
-	
-	
-	
-	/**
-	 * 
-	 * All methods below shouldn't be needed
-	 * and thus have been left unimplemented. 
-	 * 
-	 */
-	
-	
-	
+
 	@Override
-	public Random getRandom() {
+	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) {
+	                      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 DynamicRegistries registryAccess() {
-		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 long getSeed() {
+	                        double zSpeed)
+	{
 		throw new UnsupportedOperationException("Not Implemented");
 	}
 
-	
 	@Override
-	public ServerWorld getLevel() {
+	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 AbstractChunkProvider getChunkSource() {
+	public ServerWorld getLevel()
+	{
 		throw new UnsupportedOperationException("Not Implemented");
 	}
 
 
-
 	@Override
-	public DifficultyInstance getCurrentDifficultyAt(BlockPos arg0) {
+	public AbstractChunkProvider getChunkSource()
+	{
 		throw new UnsupportedOperationException("Not Implemented");
 	}
 
 
-
 	@Override
-	public IWorldInfo getLevelData() {
+	public DifficultyInstance getCurrentDifficultyAt(BlockPos arg0)
+	{
 		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) {
+	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) {
+	                                                     Predicate<? super T> arg2)
+	{
 		throw new UnsupportedOperationException("Not Implemented");
 	}
 
 
-
 	@Override
-	public List<? extends PlayerEntity> players() {
+	public List<? extends PlayerEntity> players()
+	{
 		throw new UnsupportedOperationException("Not Implemented");
 	}
 
 
-
 	@Override
-	public int getSkyDarken() {
+	public int getSkyDarken()
+	{
 		throw new UnsupportedOperationException("Not Implemented");
 	}
 
 
-
 	@Override
-	public Biome getUncachedNoiseBiome(int p_225604_1_, int p_225604_2_, int p_225604_3_) {
+	public Biome getUncachedNoiseBiome(int p_225604_1_, int p_225604_2_, int p_225604_3_)
+	{
 		throw new UnsupportedOperationException("Not Implemented");
 	}
 
 
-
 	@Override
-	public boolean isClientSide() {
+	public boolean isClientSide()
+	{
 		throw new UnsupportedOperationException("Not Implemented");
 	}
 
 
-
 	@Override
-	public DimensionType dimensionType() {
+	public DimensionType dimensionType()
+	{
 		throw new UnsupportedOperationException("Not Implemented");
 	}
-	
-	
+
+
 	@Override
-	public TileEntity getBlockEntity(BlockPos p_175625_1_) {
+	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,169 @@
+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.objects.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);
+
+					byte farDetail = (byte) 8;
+					PosToGenerateContainer posToGenerate = lodDim.getDataToGenerate(
+							farDetail,
+							maxChunkGenRequests,
+							0.25,
+							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;
+					int[] levelPos;
+					for (int index = 0; index < posToGenerate.getNumberOfPos(); index++)
+					{
+						levelPos = posToGenerate.getNthPos(index);
+						if(levelPos[0] == 0)
+							continue;
+						detailLevel = (byte) (levelPos[0] -1);
+						posX = levelPos[1];
+						posZ = levelPos[2];
+
+						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,440 @@
+/*
+ *    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.DistanceCalculatorType;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.enums.FogDistance;
+import com.seibel.lod.enums.FogDrawOverride;
+import com.seibel.lod.enums.LodDetail;
+import com.seibel.lod.enums.LodTemplate;
+import com.seibel.lod.enums.ShadingMode;
+
+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-1-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.BooleanValue drawLODs;
+		
+		public ForgeConfigSpec.EnumValue<FogDistance> fogDistance;
+		public ForgeConfigSpec.EnumValue<FogDrawOverride> fogDrawOverride;
+		
+		public ForgeConfigSpec.EnumValue<LodTemplate> lodTemplate;
+		
+		public ForgeConfigSpec.EnumValue<LodDetail> maxDrawDetail;
+		
+		public ForgeConfigSpec.EnumValue<ShadingMode> shadingMode;
+		
+		public ForgeConfigSpec.IntValue lodQuality;
+		
+		public ForgeConfigSpec.IntValue lodChunkRenderDistance;
+		
+		public ForgeConfigSpec.DoubleValue brightnessMultiplier;
+		public ForgeConfigSpec.DoubleValue saturationMultiplier;
+		
+		
+		Graphics(ForgeConfigSpec.Builder builder)
+		{
+			builder.comment("These settings control how the LODs look.").push(this.getClass().getSimpleName());
+			
+			drawLODs = builder
+					.comment("\n\n"
+							+ " If false LODs will not be drawn, \n"
+							+ " however they will still be generated \n"
+							+ " and saved to file for later use. \n")
+					.define("drawLODs", true);
+			
+			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.toString() + " or " + FogDistance.FAR.toString() + ". \n")
+					.defineEnum("fogDistance", FogDistance.NEAR_AND_FAR);
+			
+			fogDrawOverride = builder
+					.comment("\n\n"
+							+ " When should fog be drawn? \n"
+							+ " " + FogDrawOverride.USE_OPTIFINE_FOG_SETTING.toString() + ": Use whatever Fog setting Optifine is using. If Optifine isn't installed this defaults to " + FogDrawOverride.ALWAYS_DRAW_FOG_FANCY.toString() + ". \n"
+							+ " " + FogDrawOverride.NEVER_DRAW_FOG.toString() + ": Never draw fog on the LODs \n"
+							+ " " + FogDrawOverride.ALWAYS_DRAW_FOG_FAST.toString() + ": Always draw fast fog on the LODs \n"
+							+ " " + FogDrawOverride.ALWAYS_DRAW_FOG_FANCY.toString() + ": Always draw fancy fog on the LODs (if your graphics card supports it) \n")
+					.defineEnum("fogDrawOverride", FogDrawOverride.USE_OPTIFINE_FOG_SETTING);
+			
+			lodTemplate = builder
+					.comment("\n\n"
+							+ " How should the LODs be drawn? \n"
+							+ " NOTE: Currently only " + LodTemplate.CUBIC.toString() + " is implemented! \n"
+							+ " \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, \n"
+							+ " " + "         unless a neighboring chunk is at a significantly different height. \n")
+					.defineEnum("lodTemplate", LodTemplate.CUBIC);
+			
+			maxDrawDetail = builder
+					.comment("\n\n"
+							+ " What is the maximum detail level that LODs should be drawn at? \n"
+							+ " " + LodDetail.SINGLE.toString() + ": render 1 LOD for each Chunk. \n"
+							+ " " + LodDetail.DOUBLE.toString() + ": render 4 LODs for each Chunk. \n"
+							+ " " + LodDetail.QUAD.toString() + ": render 16 LODs for each Chunk. \n"
+							+ " " + LodDetail.HALF.toString() + ": render 64 LODs for each Chunk. \n"
+							+ " " + LodDetail.FULL.toString() + ": render 256 LODs for each Chunk. \n")
+					.defineEnum("lodDrawQuality", LodDetail.FULL);
+			
+			lodQuality = builder
+					.comment("\n\n"
+							+ " this value is multiplied by 128 and determine \n"
+							+ " how much the quality decrease over distance \n")
+					.defineInRange("lodQuality", 1, 1, 4);
+			
+			lodChunkRenderDistance = builder
+					.comment("\n\n"
+							+ " This is the render distance of the mod \n")
+					.defineInRange("lodChunkRenderDistance", 64, 32, 512);
+			
+			shadingMode = builder
+					.comment("\n\n"
+							+ " What kind of shading should the LODs have? \n"
+							+ " \n"
+							+ " " + ShadingMode.NONE.toString() + " \n"
+							+ " " + "LODs will have the same lighting on every side. \n"
+							+ " " + "Can make large similarly colored areas hard to differentiate. \n"
+							+ "\n"
+							+ " " + ShadingMode.DARKEN_SIDES.toString() + " \n"
+							+ " " + "LODs will have darker sides and bottoms to simulate Minecraft's flat lighting.")
+					.defineEnum("lightingMode", ShadingMode.DARKEN_SIDES);
+			
+			brightnessMultiplier = builder
+					.comment("\n\n"
+							+ " Change how bright LOD colors are. \n"
+							+ " 0 = black \n"
+							+ " 1 = normal color value \n"
+							+ " 2 = washed out colors \n")
+					.defineInRange("brightnessMultiplier", 1.0, 0, 2);
+			
+			saturationMultiplier = builder
+					.comment("\n\n"
+							+ " Change how saturated LOD colors are. \n"
+							+ " 0 = black and white \n"
+							+ " 1 = normal saturation \n"
+							+ " 2 = very saturated \n")
+					.defineInRange("saturationMultiplier", 1.0, 0, 2);
+			
+			
+			builder.pop();
+		}
+	}
+	
+	public static class WorldGenerator
+	{
+		public ForgeConfigSpec.EnumValue<LodDetail> maxGenerationDetail;
+		public ForgeConfigSpec.EnumValue<DistanceGenerationMode> distanceGenerationMode;
+		public ForgeConfigSpec.BooleanValue allowUnstableFeatureGeneration;
+		public ForgeConfigSpec.EnumValue<DistanceCalculatorType> lodDistanceCalculatorType;
+		
+		
+		WorldGenerator(ForgeConfigSpec.Builder builder)
+		{
+			builder.comment("These settings control how LODs outside your normal view range are generated.").push(this.getClass().getSimpleName());
+			
+			maxGenerationDetail = builder
+					.comment("\n\n"
+							+ " What is the maximum detail level that LODs should be generated at? \n"
+							+ " " + LodDetail.SINGLE.toString() + ": render 1 LOD for each Chunk. \n"
+							+ " " + LodDetail.DOUBLE.toString() + ": render 4 LODs for each Chunk. \n"
+							+ " " + LodDetail.QUAD.toString() + ": render 16 LODs for each Chunk. \n"
+							+ " " + LodDetail.HALF.toString() + ": render 64 LODs for each Chunk. \n"
+							+ " " + LodDetail.FULL.toString() + ": render 256 LODs for each Chunk. \n")
+					.defineEnum("lodGenerationQuality", LodDetail.HALF);
+			
+			lodDistanceCalculatorType = builder
+					.comment("\n\n"
+							+ " " + DistanceCalculatorType.LINEAR + " \n"
+							+ " with LINEAR calculator the quality of block decrease \n"
+							+ " linearly to the distance of the player \n"
+							
+							+ "\n"
+							+ " " + DistanceCalculatorType.QUADRATIC + " \n"
+							+ " with LINEAR calculator the quality of block decrease \n"
+							+ " quadratically to the distance of the player \n"
+							
+							+ "\n"
+							+ " " + DistanceCalculatorType.RENDER_DEPENDANT + " \n"
+							+ " with LINEAR calculator the quality of block decrease \n"
+							+ " quadratically to the distance of the player \n")
+					.defineEnum("lodDistanceComputation", DistanceCalculatorType.LINEAR);
+			
+			distanceGenerationMode = builder
+					.comment("\n\n"
+							+ " Note: The times listed here are the amount of time it took \n"
+							+ "       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.toString() + " \n"
+							+ " Don't run the distance generator. \n"
+							
+							+ " " + DistanceGenerationMode.BIOME_ONLY.toString() + " \n"
+							+ " Only generate the biomes and use biome \n"
+							+ " grass/foliage color, water color, or snow color \n"
+							+ " to generate the 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.toString() + " \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.toString() + " \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.toString() + " \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.toString() + " \n"
+							+ " Ask the server to generate/load each chunk. \n"
+							+ " This is the most compatible, but causes server/simulation lag. \n"
+							+ " This will also show player made structures if you \n"
+							+ " 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.toString() + " 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 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 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 enableDebugKeybinding;
+		
+		Debugging(ForgeConfigSpec.Builder builder)
+		{
+			builder.comment("These settings can be used by to look for bugs, or see how certain parts of the mod are working.").push(this.getClass().getSimpleName());
+			
+			debugMode = builder
+					.comment("\n\n"
+							+ " " + DebugMode.OFF.toString() + ": LODs will draw with their normal colors. \n"
+							+ " " + DebugMode.SHOW_DETAIL.toString() + ": LOD colors will be based on their detail. \n"
+							+ " " + DebugMode.SHOW_DETAIL_WIREFRAME.toString() + ": LOD colors will be based on their detail, drawn with wireframe. \n")
+					.defineEnum("debugMode", DebugMode.OFF);
+			
+			enableDebugKeybinding = builder
+					.comment("\n\n"
+							+ " If true the F4 key can be used to cycle through the different debug modes. \n")
+					.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/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/DistanceCalculatorType.java

@@ -0,0 +1,23 @@
+package com.seibel.lod.enums;
+
+/**
+ * @author Leonardo Amato
+ * @version 22-08-2021
+ */
+public enum DistanceCalculatorType
+{
+	/**
+	 * different Lod detail render and generate linearly to the distance
+	 */
+	LINEAR,
+
+	/**
+	 * different Lod detail render and generate quadratically to the distance
+	 */
+	QUADRATIC,
+
+	/**
+	 * we calculate the distance based on game render distance and mod render distance
+	 */
+	RENDER_DEPENDANT;
+}

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

@@ -18,51 +18,76 @@
 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
- * @version 6-27-2021
+ * @author Leonardo Amato
+ * @version 8-7-2021
  */
 public enum DistanceGenerationMode
 {
-	/** Only generate the biomes and use biome
+	/**
+	 * 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,
-	
+	 * 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,
-	
-	/** Generate the world surface, 
+	BIOME_ONLY_SIMULATE_HEIGHT((byte) 2),
+
+	/**
+	 * Generate the world surface,
 	 * this does NOT include caves, trees,
-	 * or structures. 
-	 * Multithreaded - Faster (10-20 ms) */
-	SURFACE,
-	
-	/** Generate everything except structures. 
+	 * 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,
-	
-	/** Ask the server to generate/load each chunk.
+	 * 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;
-	
+	 * 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/LodDetail.java

@@ -17,31 +17,33 @@
  */
 package com.seibel.lod.enums;
 
-import com.seibel.lod.objects.LodChunk;
-import com.seibel.lod.objects.LodDataPoint;
+import java.util.ArrayList;
+import java.util.Collections;
+
+import com.seibel.lod.util.LodUtil;
 
 /**
  * single, double, quad, half, full
  * 
  * @author James Seibel
- * @version 06-13-2021
+ * @version 8-11-2021
  */
 public enum LodDetail
 {
 	/** render 1 LOD for each chunk */
-	SINGLE(1),
+	SINGLE(1, 4),
 	
 	/** render 4 LODs for each chunk */
-	DOUBLE(2),
+	DOUBLE(2, 3),
 	
 	/** render 16 LODs for each chunk */
-	QUAD(4),
+	QUAD(4, 2),
 	
 	/** render 64 LODs for each chunk */
-	HALF(8),
+	HALF(8, 1),
 	
 	/** render 256 LODs for each chunk */
-	FULL(16);
+	FULL(16, 0);
 	
 	
 	/** How many DataPoints should 
@@ -49,6 +51,9 @@ public enum LodDetail
 	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 */
@@ -57,25 +62,24 @@ public enum LodDetail
 	
 	public final int[] endX;
 	public final int[] endZ;
+
 	
-	/** This is how many pieces of data should be expected
-	 * when creating a LodChunk with this detail level */
-	public final int lodChunkStringDelimiterCount;
+	/** 
+	 * 1st dimension: LodDetail.detailLevel <br>
+	 * 2nd dimension: An array of all LodDetails that are less than or <br>
+	 *                equal to that detailLevel
+	 */
+	private static LodDetail[][] lowerDetailArrays;
 	
 	
 	
 	
-	private LodDetail(int newLengthCount)
+	private LodDetail(int newLengthCount, int newDetailLevel)
 	{
+		detailLevel = (byte) newDetailLevel;
 		dataPointLengthCount = newLengthCount;
 		dataPointWidth = 16 / dataPointLengthCount;
 		
-		if(newLengthCount == LodChunk.WIDTH)
-		{
-			// this is to prevent overflow
-			newLengthCount = LodChunk.WIDTH - 1;
-		}
-		
 		startX = new int[dataPointLengthCount * dataPointLengthCount];
 		endX = new int[dataPointLengthCount * dataPointLengthCount];
 		
@@ -91,24 +95,65 @@ public enum LodDetail
 				startX[index] = x * dataPointWidth;
 				startZ[index] = z * dataPointWidth;
 				
-				// special case for FULL
-				if(dataPointWidth != 1)
-				{
-					endX[index] = (x*dataPointWidth) + dataPointWidth - 1; 
-					endZ[index] = (z*dataPointWidth) + dataPointWidth - 1; 
-				}
-				else
-				{
-					endX[index] = (x*dataPointWidth) + dataPointWidth;
-					endZ[index] = (z*dataPointWidth) + dataPointWidth;
-				}
+				endX[index] = (x*dataPointWidth) + dataPointWidth;
+				endZ[index] = (z*dataPointWidth) + dataPointWidth;
 				
 				index++;
 			}
 		}
 		
-		
-		lodChunkStringDelimiterCount = 2 + (dataPointLengthCount * dataPointLengthCount * LodDataPoint.NUMBER_OF_DELIMITERS);
-		
 	}// constructor
+	
+	
+	
+	
+	
+	
+	/** 
+	 * Returns an array of all LodDetails that have a detail level
+	 * that is less than or equal to the given LodDetail
+	 */
+	public static LodDetail[] getSelfAndLowerDetails(LodDetail detail)
+	{
+		if (lowerDetailArrays == null)
+		{
+			// run first time setup
+			lowerDetailArrays = new LodDetail[LodDetail.values().length][];
+			
+			// go through each LodDetail
+			for(LodDetail currentDetail : LodDetail.values())
+			{
+				ArrayList<LodDetail> lowerDetails = new ArrayList<>();
+				
+				// find the details lower than currentDetail
+				for(LodDetail compareDetail : LodDetail.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 LodDetail[lowerDetails.size()]); 
+			}
+		}
+		
+		return lowerDetailArrays[detail.detailLevel];
+	}
+	
+	/** Returns what detail level should be used at a given distance and maxDistance. */
+	public static LodDetail getDetailForDistance(LodDetail maxDetailLevel, int distance, int maxDistance)
+	{
+		LodDetail[] 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/LodRenderDistance.java

@@ -15,31 +15,36 @@
  *    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 net.minecraft.client.renderer.BufferBuilder;
+package com.seibel.lod.enums;
 
 /**
- * This object is just a replacement for an array
- * to make things easier to understand in the LodRenderer
- * and BuildBufferThread.
+ * NONE <br>
+ * BIOME_ONLY <br>
+ * BIOME_ONLY_SIMULATE_HEIGHT <br>
+ * SURFACE <br>
+ * FEATURES <br>
+ * SERVER <br><br>
+ * 
+ * In order of fastest to slowest.
  * 
  * @author James Seibel
- * @version 03-25-2021
+ * @author Leonardo Amato
+ * @version 8-7-2021
  */
-public class NearFarBuffer
+public enum LodRenderDistance
 {
-	public BufferBuilder nearBuffer;
-	
-	public BufferBuilder farBuffer;
-	
-	/**
-	 * @param newNearBuffer
-	 * @param newFarBuffer
-	 */
-	public NearFarBuffer(BufferBuilder newNearBuffer, BufferBuilder newFarBuffer)
+	SHORT(32),
+
+	MEDIUM(64),
+
+	FAR(128);
+
+
+	/** The higher the number the more complete the generation is. */
+	public final int renderDistance;
+
+	LodRenderDistance(int complexity)
 	{
-		nearBuffer = newNearBuffer;
-		farBuffer = newFarBuffer;
+		this.renderDistance = complexity;
 	}
 }

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

@@ -26,7 +26,7 @@ import com.seibel.lod.builders.lodTemplates.TriangularLodTemplate;
  * Cubic, Triangular, Dynamic
  * 
  * @author James Seibel
- * @version 06-16-2021
+ * @version 8-4-2021
  */
 public enum LodTemplate
 {
@@ -54,8 +54,8 @@ public enum LodTemplate
 	}
 	
 	
-	public int getBufferMemoryForSingleLod(LodDetail detail)
+	public int getBufferMemoryForSingleLod()
 	{
-		return template.getBufferMemoryForSingleLod(detail);
+		return template.getBufferMemoryForSingleNode();
 	}
 }

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 */
+	DARKEN_SIDES;
+}

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

@@ -1,258 +0,0 @@
-/*
- *    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.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.DistanceGenerationMode;
-import com.seibel.lod.enums.FogDistance;
-import com.seibel.lod.enums.FogDrawOverride;
-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 7-5-2021
- */
-@Mod.EventBusSubscriber
-public class LodConfig
-{
-	public static class Client
-	{
-		public ForgeConfigSpec.BooleanValue drawLODs;
-		
-		public ForgeConfigSpec.EnumValue<FogDistance> fogDistance;
-		
-		public ForgeConfigSpec.EnumValue<FogDrawOverride> fogDrawOverride;
-		
-		public ForgeConfigSpec.BooleanValue debugMode;
-		
-		public ForgeConfigSpec.EnumValue<LodTemplate> lodTemplate;
-		
-		public ForgeConfigSpec.EnumValue<LodDetail> lodDetail;
-		
-		public ForgeConfigSpec.EnumValue<DistanceGenerationMode> distanceGenerationMode;
-		
-		public ForgeConfigSpec.BooleanValue allowUnstableFeatureGeneration;
-		
-		public ForgeConfigSpec.IntValue numberOfWorldGenerationThreads;
-		
-		/** 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\n"
-	        				+ " If false LODs will not be drawn, \n"
-	        				+ " however they will still be generated \n"
-	        				+ " and saved to file for later use. \n")
-	        		.define("drawLODs", true);
-	        
-	        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\" \n"
-	                		+ " fog option set this to " + FogDistance.NEAR.toString() + " or " + FogDistance.FAR.toString() + ". \n")
-	                .defineEnum("fogDistance", FogDistance.NEAR_AND_FAR);
-	        
-	        fogDrawOverride = builder
-	                .comment("\n\n"
-	                		+ " When should fog be drawn? \n"
-	                		+ " " + FogDrawOverride.USE_OPTIFINE_FOG_SETTING.toString() + ": Use whatever Fog setting Optifine is using. If Optifine isn't installed this defaults to " + FogDrawOverride.ALWAYS_DRAW_FOG_FANCY.toString() + ". \n"
-	                		+ " " + FogDrawOverride.NEVER_DRAW_FOG.toString() + ": Never draw fog on the LODs \n"
-            				+ " " + FogDrawOverride.ALWAYS_DRAW_FOG_FAST.toString() + ": Always draw fast fog on the LODs \n"
-	                		+ " " + FogDrawOverride.ALWAYS_DRAW_FOG_FANCY.toString() + ": Always draw fancy fog on the LODs (if your graphics card supports it) \n")
-	                .defineEnum("fogDrawOverride", FogDrawOverride.USE_OPTIFINE_FOG_SETTING);
-	        
-	        debugMode = builder
-	                .comment("\n\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 ;) \n")
-	                .define("drawCheckerBoard", false);
-	        
-	        lodTemplate = builder
-	                .comment("\n\n"
-	                		+ " How should the LODs be drawn? \n"
-	                		+ " NOTE: Currently only " + LodTemplate.CUBIC.toString() + " is implemented! \n"
-	                		+ " \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, \n"
-	                		+ " " + "         unless a neighboring chunk is at a significantly different height. \n")
-	                .defineEnum("lodTemplate", LodTemplate.CUBIC);
-	        
-	        lodDetail = builder
-	                .comment("\n\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. \n"
-            				+ " " + LodDetail.QUAD.toString() +   ": render 16 LODs for each Chunk. \n"
-            				+ " " + LodDetail.HALF.toString() +   ": render 64 LODs for each Chunk. \n")
-	                .defineEnum("lodGeometryQuality", LodDetail.DOUBLE);
-	        
-	        lodChunkRadiusMultiplier = builder
-	                .comment("\n\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. \n")
-	                .defineInRange("lodChunkRadiusMultiplier", 8, 2, 16);
-	        
-	        distanceGenerationMode = builder
-	                .comment("\n\n"
-	                		+ " Note: The times listed here are the amount of time it took \n"
-	                		+ "       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.BIOME_ONLY.toString() + " \n"
-	                		+ " Only generate the biomes and use biome \n"
-	                		+ " grass/foliage color, water color, or snow color \n"
-	                		+ " to generate the 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.toString() + " \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.toString() + " \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.toString() + " \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.toString() + " \n"
-							+ " Ask the server to generate/load each chunk. \n"
-							+ " This is the most compatible, but causes server/simulation lag. \n"
-							+ " This will also show player made structures if you \n"
-							+ " are adding the mod to a pre-existing world. \n"
-							+ " Singlethreaded - Slow (15-50 ms, with spikes up to 200 ms) \n")
-	                .defineEnum("distanceBiomeOnlyGeneration", DistanceGenerationMode.SURFACE);
-	        
-	        allowUnstableFeatureGeneration = builder
-	                .comment("\n\n"
-	                		+ " When using the " + DistanceGenerationMode.FEATURES.toString() + "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);
-	        
-	        numberOfWorldGenerationThreads = builder
-	                .comment("\n\n"
-	                		+ " This is how many threads are used when generating terrain. \n"
-	                		+ " If you experience stuttering when generating terrain, decrease \n"
-	                		+ " this number. If you want to increase LOD generation speed, \n"
-	                		+ " increase the number. \n"
-	                		+ " The max is the number of processors on your CPU. \n"
-	                		+ "\n"
-	                		+ " Requires a restart to take effect. \n"
-	                		)
-	                .defineInRange("numberOfWorldGenerationThreads", Runtime.getRuntime().availableProcessors(), 1, Runtime.getRuntime().availableProcessors());
-	        
-	        
-	        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/handlers/LodDimensionFileHandler.java

@@ -22,197 +22,203 @@ import java.io.File;
 import java.io.FileReader;
 import java.io.FileWriter;
 import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.StandardCopyOption;
 import java.util.concurrent.ExecutorService;
 import java.util.concurrent.Executors;
 
-import com.seibel.lod.enums.LodDetail;
-import com.seibel.lod.objects.LodChunk;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.objects.LevelContainer;
 import com.seibel.lod.objects.LodDimension;
 import com.seibel.lod.objects.LodRegion;
+import com.seibel.lod.objects.RegionPos;
 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 6-27-2021
+ * @version 9-7-2021
  */
 public class LodDimensionFileHandler
 {
-	/** This is what separates each piece of data */
+	/**
+	 * This is what separates each piece of data
+	 */
 	public static final char DATA_DELIMITER = ',';
-	
-	
+
+
 	private LodDimension loadedDimension = null;
 	public long regionLastWriteTime[][];
-	
+
 	private File dimensionDataSaveFolder;
-	
-	/** lod */
-	private final String FILE_NAME_PREFIX = "lod";
-	/** .txt */
-	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 = ".txt";
+	/**
+	 * 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 = 2;
-	
-	/** This is the string written before the file version */
+	 * newer versions (larger numbers) will be ignored and won't be read.
+	 */
+	public static final int LOD_SAVE_FILE_VERSION = 5;
+
+	/**
+	 * 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();
-	
-	
+
+	/**
+	 * 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)
 	{
-		
-		String fileName = getFileNameAndPathForRegion(regionX, regionZ, LodConfig.CLIENT.lodDetail.get());
-		
-		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);
+		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);
+
+			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)
+				String data = "";
+				BufferedReader bufferedReader = new BufferedReader(new FileReader(f));
+				data = bufferedReader.readLine();
+				int fileVersion = -1;
+
+				if (data != null && !data.isEmpty())
 				{
-					// this file doesn't have a version
-					// keep the version as -1
-					fileVersion = -1;
-				}
-				
-				// check if this file can be read by this file handler
-				if(fileVersion < LOD_SAVE_FILE_VERSION)
+					// try to get the file version
+					try
+					{
+						fileVersion = Integer.parseInt(data.substring(data.indexOf(' ')).trim());
+					} catch (NumberFormatException | StringIndexOutOfBoundsException e)
+					{
+						// this file doesn't have a version
+						// keep the version as -1
+						fileVersion = -1;
+					}
+
+					// 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.
+						bufferedReader.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.
+						bufferedReader.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;
+					}
+				} else
 				{
-					// 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;
+					// there is no data in this file
+					bufferedReader.close();
+					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
+
+				// this file is a readable version, begin reading the file
+				data = bufferedReader.readLine();
+
+				bufferedReader.close();
+				region.addLevel(new LevelContainer(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, LodConfig.CLIENT.lodDetail.get());
-					
-					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.
 	 */
@@ -220,22 +226,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.isRegionDirty[i][j] && loadedDimension.regions[i][j] != null)
+					{
+						saveRegionToFile(loadedDimension.regions[i][j]);
+						loadedDimension.isRegionDirty[i][j] = false;
+					}
 				}
 			}
+		} catch (Exception e)
+		{
+			e.printStackTrace();
 		}
 	});
- 	
+
 	/**
 	 * Save a specific region to disk.<br>
 	 * Note: <br>
@@ -244,104 +256,110 @@ 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, LodConfig.CLIENT.lodDetail.get()));
-		
-		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);
+			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
+					// 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)
+
+					BufferedReader br = new BufferedReader(new FileReader(oldFile));
+					String s = br.readLine();
+					int fileVersion = LOD_SAVE_FILE_VERSION;
+
+					if (s != null && !s.isEmpty())
 					{
-						fileVersion = Integer.parseInt(s.substring(s.indexOf(' ')).trim());
+						// 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
+						}
 					}
-					catch(NumberFormatException | StringIndexOutOfBoundsException e)
+					br.close();
+
+					// check if this file can be written to by the file handler
+					if (fileVersion <= LOD_SAVE_FILE_VERSION)
 					{
-						// this file doesn't have a correctly formated version
-						// just overwrite the file
+						// 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;
 					}
 				}
-				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);
+				FileWriter fw = new FileWriter(newFile);
+
+				// add the version of this file
+				fw.write(LOD_FILE_VERSION_PREFIX + " " + LOD_SAVE_FILE_VERSION + "\n");
+
+				// add each LodChunk to the file
+				fw.write(region.getLevel(detailLevel).toString());
+				fw.close();
+
+				// overwrite the old file with the new one
+				Files.move(newFile.toPath(), oldFile.toPath(), StandardCopyOption.ATOMIC_MOVE, StandardCopyOption.REPLACE_EXISTING);
+			} 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. <br><br>
-	 * 
-	 * example: "lod.FULL.0.0.txt"
+	 * <p>
+	 * example: "lod.0.0.txt" <br><br>
+	 * <p>
+	 * Returns null if there is an IO Exception.
 	 */
-	private String getFileNameAndPathForRegion(int regionX, int regionZ, LodDetail detail)
+	private String getFileNameAndPathForRegion(int regionX, int regionZ, DistanceGenerationMode generationMode, byte detailLevel)
 	{
 		try
 		{
@@ -349,13 +367,16 @@ public class LodDimensionFileHandler
 			// ".\Super Flat\DIM-1\data"
 			// or
 			// ".\Super Flat\data"
-			return dimensionDataSaveFolder.getCanonicalPath() + File.separatorChar + 
-					FILE_NAME_PREFIX + "." + detail.toString() + "." + regionX + "." + regionZ + FILE_EXTENSION;
-		}
-		catch(IOException e)
+			return dimensionDataSaveFolder.getCanonicalPath() + File.separatorChar +
+					       generationMode.toString() + File.separatorChar +
+					       DETAIL_FOLDER_NAME_PREFIX + detailLevel + File.separatorChar +
+					       FILE_NAME_PREFIX + "." + regionX + "." + regionZ + FILE_EXTENSION;
+		} 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

@@ -18,44 +18,47 @@
 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 7-03-2021
+ * @version 9-7-2021
  */
 public class ReflectionHandler
 {
-	private Minecraft mc = Minecraft.getInstance();
-	public Field ofFogField = null;
+	public static final ReflectionHandler INSTANCE = new ReflectionHandler();
+	private MinecraftWrapper mc = MinecraftWrapper.INSTANCE;
 	
-	public ReflectionHandler()
+	public Field ofFogField = null;
+	public Method vertexBufferUploadMethod = null;
+	
+	
+	
+	private ReflectionHandler()
 	{
 		setupFogField();
 	}
 	
 	
-	
-	
 	/**
-	 * Similar to setupFovMethod.
+	 * finds the Optifine fog type field
 	 */
 	private void setupFogField()
 	{
 		// get every variable from the entity renderer
-		Field[] optionFields = mc.options.getClass().getDeclaredFields();
-				
+		Field[] optionFields = mc.getOptions().getClass().getDeclaredFields();
+		
 		// try and find the ofFogType variable in gameSettings
-		for(Field field : optionFields)
+		for (Field field : optionFields)
 		{
-			if(field.getName().equals("ofFogType"))
+			if (field.getName().equals("ofFogType"))
 			{
 				ofFogField = field;
 				return;
@@ -65,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.
 	 */
@@ -89,31 +90,29 @@ public class ReflectionHandler
 		
 		try
 		{
-			returnNum = (int)ofFogField.get(mc.options);
-		}
-		catch (IllegalArgumentException | IllegalAccessException e)
+			returnNum = (int) ofFogField.get(mc.getOptions());
+		} catch (IllegalArgumentException | IllegalAccessException e)
 		{
 			e.printStackTrace();
 		}
 		
 		switch (returnNum)
 		{
-			// optifine's "default" option,
-			// it should never be called in this case
-			case 0:
-				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;
+		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

@@ -24,7 +24,7 @@ import org.spongepowered.asm.mixin.injection.callback.CallbackInfo;
 
 import com.mojang.blaze3d.matrix.MatrixStack;
 import com.seibel.lod.LodMain;
-import com.seibel.lod.handlers.LodConfig;
+import com.seibel.lod.config.LodConfig;
 
 import net.minecraft.client.renderer.RenderType;
 import net.minecraft.client.renderer.WorldRenderer;
@@ -56,7 +56,7 @@ public class MixinWorldRenderer
 	{
 		// only render if LODs are enabled and
 		// only render before solid blocks
-		if (LodConfig.CLIENT.drawLODs.get() && renderType.equals(RenderType.solid()))
+		if (LodConfig.CLIENT.graphics.drawLODs.get() && renderType.equals(RenderType.solid()))
 			LodMain.client_proxy.renderLods(previousPartialTicks);
 	}
 }

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

@@ -0,0 +1,97 @@
+package com.seibel.lod.objects;
+
+public class DataPoint
+{
+	public final static int HEIGHT_SHIFT = 54;
+	public final static int DEPTH_SHIFT = 44;
+	public final static int RED_SHIFT = 36;
+	public final static int GREEN_SHIFT = 28;
+	public final static int BLUE_SHIFT = 20;
+	public final static int GEN_TYPE_SHIFT = 17;
+	public final static int LIGHT_SHIFT = 13;
+	public final static int EXISTENCE_SHIFT = 0;
+
+	public final static long HEIGHT_MASK = Long.parseUnsignedLong("1111111111", 2);
+	public final static long DEPTH_MASK = Long.parseUnsignedLong("1111111111", 2);
+	public final static long RED_MASK = Long.parseUnsignedLong("11111111", 2);
+	public final static long GREEN_MASK = Long.parseUnsignedLong("11111111", 2);
+	public final static long BLUE_MASK = Long.parseUnsignedLong("11111111", 2);
+	public final static long GEN_TYPE_MASK = Long.parseUnsignedLong("111", 2);
+	public final static long LIGHT_MASK = Long.parseUnsignedLong("1111", 2);
+	public final static long EXISTENCE_MASK = 1;
+
+	public static long createDataPoint(int height, int depth, int color)
+	{
+		int red = (getRed(color) << 16) & 0x00FF0000;
+		int green = (getGreen(color) << 8) & 0x0000FF00;
+		int blue = getBlue(color)& 0x000000FF;
+		return createDataPoint(height, depth, red, green, blue);
+	}
+	public static long createDataPoint(int height, int depth, int red, int green, int blue)
+	{
+		long dataPoint = 0;
+		dataPoint += (height & HEIGHT_MASK) << HEIGHT_SHIFT;
+		dataPoint += (depth & DEPTH_MASK) << DEPTH_SHIFT;
+		dataPoint += (red & RED_MASK) << RED_SHIFT;
+		dataPoint += (green & GREEN_MASK) << GREEN_SHIFT;
+		dataPoint += (blue & BLUE_MASK) << BLUE_SHIFT;
+		dataPoint += 1;
+		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 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 boolean doesItExist(long dataPoint)
+	{
+		return ((dataPoint & EXISTENCE_MASK) == 1);
+	}
+
+	public static int getColor(long dataPoint)
+	{
+		int R = (getRed(dataPoint) << 16) & 0x00FF0000;
+		int G = (getGreen(dataPoint) << 8) & 0x0000FF00;
+		int B = getBlue(dataPoint)& 0x000000FF;
+		return 0xFF000000 | R | G | B;
+	}
+
+	public static String toString(long dataPoint)
+	{
+		StringBuilder s = new StringBuilder();
+		s.append(getHeight(dataPoint));
+		s.append(" ");
+		s.append(getDepth(dataPoint));
+		s.append(" ");
+		s.append(getRed(dataPoint));
+		s.append(" ");
+		s.append(getBlue(dataPoint));
+		s.append(" ");
+		s.append(getGreen(dataPoint));
+		s.append('\n');
+		return s.toString();
+	}
+}

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

@@ -0,0 +1,67 @@
+package com.seibel.lod.objects;
+
+import java.io.Serializable;
+
+import com.seibel.lod.util.LodUtil;
+
+public class LevelContainer implements Serializable
+{
+
+	/** This is here so that Eclipse doesn't complain */
+	private static final long serialVersionUID = -4930855068717998385L;
+
+	public static final char DATA_DELIMITER = ',';
+
+	public final byte detailLevel;
+
+	public final long[][] data;
+
+	public LevelContainer(byte detailLevel, long[][] data)
+	{
+		this.detailLevel = detailLevel;
+		this.data = data;
+	}
+
+	public LevelContainer(String inputString)
+	{
+
+		int index = 0;
+		int lastIndex = 0;
+
+
+		index = inputString.indexOf(DATA_DELIMITER, 0);
+		this.detailLevel = (byte) Integer.parseInt(inputString.substring(0, index));
+		int size = (int) Math.pow(2, LodUtil.REGION_DETAIL_LEVEL - detailLevel);
+
+		this.data = new long[size][size];
+		for (int x = 0; x < size; x++)
+		{
+			for (int z = 0; z < size; z++)
+			{
+				lastIndex = index;
+				index = inputString.indexOf(DATA_DELIMITER, lastIndex + 1);
+				data[x][z] = Long.parseLong(inputString.substring(lastIndex + 1, index), 16);
+			}
+		}
+
+	}
+
+	@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(data[x][z]));
+				stringBuilder.append(DATA_DELIMITER);
+			}
+		}
+		return stringBuilder.toString();
+	}
+}

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

@@ -0,0 +1,253 @@
+package com.seibel.lod.objects;
+
+import com.seibel.lod.util.LodUtil;
+
+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 getChunkPosX(int[] levelPos)
+	{
+		levelPos = convert(levelPos, LodUtil.CHUNK_DETAIL_LEVEL);
+		return getPosX(levelPos);
+	}
+
+	public static int getChunkPosZ(int[] levelPos)
+	{
+		levelPos = convert(levelPos, LodUtil.CHUNK_DETAIL_LEVEL);
+		return getPosZ(levelPos);
+	}
+
+	public static int maxDistance(int[] levelPos, int playerPosX, int playerPosZ)
+	{
+		return maxDistance(getDetailLevel(levelPos), getPosX(levelPos), getPosZ(levelPos), playerPosX, playerPosZ);
+	}
+
+	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(int[] levelPos, int playerPosX, int playerPosZ)
+	{
+		return minDistance(getDetailLevel(levelPos), getPosX(levelPos), getPosZ(levelPos), playerPosX, playerPosZ);
+	}
+
+	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 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);
+//		System.out.println("comparing level "+ firstDetail + " " + secondDetail + " " + compareResult);
+		if (compareResult == 0)
+		{
+			compareResult = compareDistance(
+					firstDistance,
+					secondDistance);
+//			System.out.println("Equal level "+ firstDistance + " " + secondDistance + " " + compareResult);
+		}
+		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/objects/LodChunk.java

@@ -1,503 +0,0 @@
-/*
- *    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.awt.Color;
-
-import com.seibel.lod.enums.LodDetail;
-import com.seibel.lod.handlers.LodDimensionFileHandler;
-
-import net.minecraft.util.math.ChunkPos;
-import net.minecraft.world.gen.Heightmap;
-
-/**
- * This object contains position
- * and color data for an LOD object.
- * 
- * @author James Seibel
- * @version 6-27-2021
- */
-public class LodChunk
-{
-	/** This is what separates each piece of data in the toData method */
-	private static final char DATA_DELIMITER = LodDimensionFileHandler.DATA_DELIMITER;
-	
-	/** Width of a Minecraft Chunk */
-	public static final int WIDTH = 16;
-	
-	/** alpha used when drawing chunks in debug mode */
-	private static final int DEBUG_ALPHA = 255; // 0 - 255
-	private static final Color DEBUG_BLACK = new Color(0, 0, 0, DEBUG_ALPHA);
-	private static final Color DEBUG_WHITE = new Color(255, 255, 255, DEBUG_ALPHA);
-	private static final Color INVISIBLE = new Color(0,0,0,0);
-	
-	/** If we ever have to use a heightmap for any reason, use this one. */
-	public static final Heightmap.Type DEFAULT_HEIGHTMAP = Heightmap.Type.WORLD_SURFACE_WG;
-	
-	
-	public LodDetail detail = LodDetail.SINGLE;
-	
-	/** If this is set to true then toData will return
-	 * the empty string */
-	public boolean dontSave = false;
-	
-	// TODO store the DistanceGenerationMethod used for this chunk (so we can upgrade old chunks if we want to)
-	
-	
-	/** The x coordinate of the chunk. */
-	public int x = 0;
-	/** The z coordinate of the chunk. */
-	public int z = 0;
-	
-	
-	/** This stores the height and color for each data point in the LodChunk */
-	public LodDataPoint dataPoints[][];
-	
-	/** If true then this LodChunk contains no data */
-	private boolean empty = false;
-	
-	
-	/**
-	 * Create an empty, invisible, non-saving LodChunk at (0,0)
-	 */
-	public LodChunk()
-	{
-		dontSave = true;
-		empty = true;
-		
-		x = 0;
-		z = 0;
-		
-		detail = LodDetail.SINGLE;
-		
-		dataPoints = new LodDataPoint[detail.dataPointLengthCount][detail.dataPointLengthCount];
-		
-		// fill with dummy data, to prevent null pointers
-		for(int i = 0; i < detail.dataPointLengthCount; i++)
-			for(int j = 0; j < detail.dataPointLengthCount; j++)
-				dataPoints[i][j] = new LodDataPoint();
-	}
-	
-	/**
-	 * Create an empty, invisible, non-saving LodChunk at the given ChunkPos
-	 */
-	public LodChunk(ChunkPos pos)
-	{
-		this();
-		
-		x = pos.x;
-		z = pos.z;
-	}
-	
-	/**
-	 * Create an empty, invisible, non-saving LodChunk at the given ChunkPos
-	 */
-	public LodChunk(int newX, int newZ)
-	{
-		this();
-		
-		x = newX;
-		z = newZ;
-	}
-	
-	
-	/**
-	 * 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, LodDetail newDetail) throws IllegalArgumentException, NumberFormatException
-	{
-		/*
-		 * data format: 
-		 * x, z, dataPoint[0][0], dataPoint[0][1], ... 
-		 * x, z,  height, depth, rgb color data,  height, depth, rgb....
-		 * 
-		 * example:
-		 * 5,8,  4, 0, 255,255,255,  4, 0, 255, 255, 255, ...
-		 */
-		
-		dontSave = false;
-		
-		// make sure there are the correct number of entries
-		// in the data string
-		int count = 0;
-		detail = newDetail;
-		
-		for(int i = 0; i < data.length(); i++)
-			if(data.charAt(i) == DATA_DELIMITER)
-				count++;
-		
-		if(count != detail.lodChunkStringDelimiterCount)
-			throw new IllegalArgumentException("LodChunk constructor givin an invalid string. The data given had " + count + " delimiters when it should have had " + detail.lodChunkStringDelimiterCount + ".");
-		
-		
-		dataPoints = new LodDataPoint[detail.dataPointLengthCount][detail.dataPointLengthCount];
-		
-		// 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);
-		this.x = Integer.parseInt(data.substring(0,index));
-		
-		lastIndex = index;
-		index = data.indexOf(DATA_DELIMITER, lastIndex+1);
-		this.z = Integer.parseInt(data.substring(lastIndex+1,index));
-		
-		
-		// LodDataPoints
-		for(int blockX = 0; blockX < detail.dataPointLengthCount; blockX++)
-		{
-			for(int blockZ = 0; blockZ < detail.dataPointLengthCount; blockZ++)
-			{
-				// height
-				lastIndex = index;
-				index = data.indexOf(DATA_DELIMITER, lastIndex+1);
-				int height = Short.parseShort(data.substring(lastIndex+1,index));
-				
-				// depth
-				lastIndex = index;
-				index = data.indexOf(DATA_DELIMITER, lastIndex+1);
-				int depth = Short.parseShort(data.substring(lastIndex+1,index));
-				
-				
-				// color
-				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;
-					}
-				}
-				
-				dataPoints[blockX][blockZ] = new LodDataPoint((short)height, (short)depth, new Color(red, green, blue));
-			}
-		}
-		
-		
-		empty = determineIfEmtpy();
-	}
-	
-	/**
-	 * Create a LodChunk from the given values.
-	 */
-	public LodChunk(ChunkPos pos, LodDataPoint[][] newDataPoints, LodDetail newDetail)
-	{
-		x = pos.x;
-		z = pos.z;
-		
-		dataPoints = newDataPoints;
-		
-		dontSave = false;
-		detail = newDetail;
-		
-		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()
-	{
-		for(LodDataPoint[] dataPointArray : dataPoints)
-		{
-			for(LodDataPoint dataPoint : dataPointArray)
-			{
-				if (dataPoint == null)
-					continue;
-				
-				// we don't check the depth since the
-				// height should always be greater than or equal
-				// to the depth
-				if(dataPoint.height >= 0)
-				{
-					// the height is valid,
-					
-					if (dataPoint.color == INVISIBLE)
-						continue;
-					
-					// the color and height are valid
-					// this LodChunk isn't empty
-					return false;
-				}
-			}
-		}
-		
-		// we checked everywhere, this LodChunk is empty
-		return true;
-	}
-	
-	
-	
-	
-	//========//
-	// output //
-	//========//
-	
-	/**
-	 * Returns the data point for the given relative block position.
-	 */
-	public LodDataPoint getDataPointForBlockPos(int blockX, int blockZ)
-	{
-		return dataPoints[blockX / detail.dataPointWidth][blockZ / detail.dataPointWidth];
-	}
-	
-	public Color getColorForBlockPos(int blockX, int blockZ)
-	{
-		return getDataPointForBlockPos(blockX, blockZ).color;
-	}
-	
-	public short getHeightForBlockPos(int blockX, int blockZ)
-	{
-		return getDataPointForBlockPos(blockX, blockZ).height;
-	}
-	
-	public short getDepthForBlockPos(int blockX, int blockZ)
-	{
-		return getDataPointForBlockPos(blockX, blockZ).depth;
-	}
-	
-	
-	public Color getColor(int xIndex, int zIndex)
-	{
-		return dataPoints[xIndex][zIndex].color;
-	}
-	
-	public short getHeight(int xIndex, int zIndex)
-	{
-		return dataPoints[xIndex][zIndex].height;
-	}
-	
-	public short getDepth(int xIndex, int zIndex)
-	{
-		return dataPoints[xIndex][zIndex].depth;
-	}
-	
-	public short calculateHighestPoint()
-	{
-		short highest = 0;
-		
-		for(int x = 0; x < detail.dataPointLengthCount; x++)
-		{
-			for(int z = 0; z < detail.dataPointLengthCount; z++)
-			{
-				if (getHeight(x,z) > highest)
-					highest = getHeight(x,z);
-			}
-		}
-		
-		return highest;
-	}
-	
-	
-	
-	/**
-	 * @param startX
-	 * @param startZ
-	 * @param endX
-	 * @param endZ
-	 * @return
-	 */
-	public short getAverageHeightOverArea(int startX, int startZ, int endX, int endZ)
-	{
-		if (startX == endX || startZ == endZ)
-			// we were given an area with 0 blocks in it
-			return getHeightForBlockPos(startX,startZ);
-		
-		int average = 0;
-		
-		for(int x = startX; x < endX; x++)
-			for(int z = startZ; z < endZ; z++)
-				average += getHeightForBlockPos(x,z);
-		
-		return (short) (average / ((endX - startX) * (endZ - startZ)));
-	}
-	
-	/**
-	 * @param startX
-	 * @param startZ
-	 * @param endX
-	 * @param endZ
-	 * @return
-	 */
-	public short getAverageDepthOverArea(int startX, int startZ, int endX, int endZ)
-	{
-		if (startX == endX || startZ == endZ)
-			// we were given an area with 0 blocks in it
-			return getDepthForBlockPos(startX,startZ);
-		
-		int average = 0;
-		
-		for(int x = startX; x < endX; x++)
-			for(int z = startZ; z < endZ; z++)
-				average += getDepthForBlockPos(x,z);
-		
-		return (short) (average / ((endX - startX) * (endZ - startZ)));
-	}
-	
-	
-	/**
-	 * Determine the color of this LOD.
-	 */
-	public Color getAverageColorOverArea(int startX, int startZ, int endX, int endZ, boolean debugging)
-	{
-		if (startX == endX || startZ == endZ)
-			// we were given an area with 0 blocks in it
-			return getColorForBlockPos(startX,startZ);
-		
-		
-		
-		int[] colorComponents = new int[3];
-		
-		
-		if (debugging)
-		{
-			// draw the squares as a black and white,
-			// like a checker board
-			
-			// only return 1 color to prevent
-			// getting back gray
-			if ((startX + startZ) % 2 == 0)
-				return DEBUG_WHITE;
-			else
-				return DEBUG_BLACK;
-		}
-		
-		
-		for(int x = startX; x < endX; x++)
-		{
-			for(int z = startZ; z < endZ; z++)
-			{
-				colorComponents = addColorToColorAverages(colorComponents, getColorForBlockPos(x,z));
-			}
-		}
-		
-		int numbPoints = ((endX - startX) * (endZ - startZ));
-		
-		return new Color(colorComponents[0]/numbPoints, colorComponents[1]/numbPoints, colorComponents[2]/numbPoints);
-	}
-	
-	
-	private int[] addColorToColorAverages(int[] colorAverages, Color colorToAdd) 
-	{
-		// convert the colorToAdd to an int array
-		float[] colorCompoments = new float[4];
-		colorCompoments = colorToAdd.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[rgbIndex] += (int) (colorCompoments[rgbIndex] * 255 + 0.5);
-		}
-		
-		return colorAverages;
-	}
-	
-	
-	
-	
-	
-	/**
-	 * Outputs all data in a csv format
-	 * with the given delimiter, if
-	 * dontSave is false. <br><br>
-	 * 
-	 * data format: <br>
-	 * x, z, dataPoint[0][0], dataPoint[0][1], ... <br>
-	 * x, z, height, depth, rgb color data,   height, depth, rgb.... <br><br>
-	 * 
-	 * example: <br>
-	 * 5,8,  4, 0, 255,255,255,  4, 0, 255, 255, 255, ...
-	 */
-	public String toData()
-	{
-		if (dontSave)
-			return "";
-		
-		String s = "";
-		s += Integer.toString(x) + DATA_DELIMITER +  Integer.toString(z) + DATA_DELIMITER;
-		
-		for (int i = 0; i < dataPoints.length; i++)
-			for (int j = 0; j < dataPoints[i].length; j++)
-				s += dataPoints[i][j].toData();
-		
-		return s;
-	}
-	
-	
-	@Override
-	public String toString()
-	{
-		String s = "";
-		
-		s += "x: " + x + " z: " + z + "\t";
-		
-		return s;
-	}
-	
-}

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

@@ -1,112 +0,0 @@
-/*
- *    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.awt.Color;
-
-import com.seibel.lod.handlers.LodDimensionFileHandler;
-
-/**
- * This stores the height and color
- * for a specific area in a LodChunk.
- * 
- * @author James Seibel
- * @version 6-19-2021
- */
-public class LodDataPoint
-{
-	/** This is what separates each piece of data in the toData method */
-	private static final char DATA_DELIMITER = LodDimensionFileHandler.DATA_DELIMITER;
-	
-	/** this is how many pieces of data are exported when toData is called */
-	public static final int NUMBER_OF_DELIMITERS = 5;
-	
-	private static final Color INVISIBLE = new Color(0,0,0,0);
-	
-	/** highest point */
-	public short height;
-	
-	/** lowest point */
-	public short depth;
-	
-	/** The average color for the 6 cardinal directions */
-	public Color color;
-	
-	
-	/**
-	 * Creates and empty LodDataPoint
-	 */
-	public LodDataPoint()
-	{
-		height = -1;
-		depth = -1;
-		color = INVISIBLE;
-	}
-	
-	
-	public LodDataPoint(short newHeight, short newDepth, Color newColor)
-	{
-		height = newHeight;
-		depth = newDepth;
-		color = newColor;
-	}
-	
-	public LodDataPoint(int newHeight, int newDepth, Color newColor)
-	{
-		height = (short) newHeight;
-		depth = (short) newDepth;
-		color = newColor;
-	}
-	
-	
-	/**
-	 * Outputs all data in a csv format
-	 * with the given delimiter.
-	 * <br>
-	 * Exports data in the form:
-	 * <br>
-	 * height, depth, rgb color data
-	 * 
-	 * <br>
-	 * example output:
-	 * <br>
-	 * 4, 0, 255,255,255, 
-	 */
-	public String toData()
-	{
-		String s = Short.toString(height) + DATA_DELIMITER;
-		
-		s += Short.toString(depth) + DATA_DELIMITER;
-		
-		s += Integer.toString(color.getRed()) + DATA_DELIMITER + Integer.toString(color.getGreen()) + DATA_DELIMITER + Integer.toString(color.getBlue()) + DATA_DELIMITER;
-		
-		return s;
-	}
-	
-	@Override
-	public String toString()
-	{
-		String s = Short.toString(height) + DATA_DELIMITER;
-		
-		s += Short.toString(depth) + DATA_DELIMITER;
-		
-		s += Integer.toString(color.getRed()) + DATA_DELIMITER + Integer.toString(color.getGreen()) + DATA_DELIMITER + Integer.toString(color.getBlue()) + DATA_DELIMITER;
-		
-		return s;
-	}
-}

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

@@ -19,406 +19,660 @@ package com.seibel.lod.objects;
 
 import java.io.File;
 import java.io.IOException;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
 
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DistanceGenerationMode;
 import com.seibel.lod.handlers.LodDimensionFileHandler;
+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.client.Minecraft;
 import net.minecraft.util.math.ChunkPos;
 import net.minecraft.world.DimensionType;
 import net.minecraft.world.server.ServerChunkProvider;
 import net.minecraft.world.server.ServerWorld;
 
+
 /**
  * This object holds all loaded LOD regions
  * for a given dimension.
- * 
+ *
+ * @author Leonardo Amato
  * @author James Seibel
- * @version 06-27-2021
+ * @version 8-8-2021
  */
 public class LodDimension
 {
+
 	public final DimensionType dimension;
-	
+
+	/**
+	 * measured in regions
+	 */
 	private volatile int width;
+	/**
+	 * measured in regions
+	 */
 	private volatile int halfWidth;
-	
+
+
 	public volatile LodRegion regions[][];
 	public volatile boolean isRegionDirty[][];
-	
-	private int centerX;
-	private int centerZ;
-	
+	public volatile boolean regen[][];
+	/**
+	 * if true that means there are regions in this dimension
+	 * that need to have their buffers rebuilt.
+	 */
+	public volatile boolean regenDimension = false;
+
+	private volatile RegionPos center;
+	private volatile ChunkPos lastGenChunk;
+	private volatile ChunkPos lastCutChunk;
 	private LodDimensionFileHandler fileHandler;
-	
-	
-	public LodDimension(DimensionType newDimension, LodWorld lodWorld, int newMaxWidth)
+	private ExecutorService cutAndGenThreads = Executors.newSingleThreadExecutor(new LodThreadFactory(this.getClass().getSimpleName() + " - cutAndGen"));
+
+	/**
+	 * Creates the dimension centered at (0,0)
+	 *
+	 * @param newWidth in regions
+	 */
+	public LodDimension(DimensionType newDimension, LodWorld lodWorld, int newWidth)
 	{
+		lastCutChunk = null;
+		lastGenChunk = null;
 		dimension = newDimension;
-		width = newMaxWidth;
-		
-		try
+		width = newWidth;
+		halfWidth = (int) Math.floor(width / 2);
+		MinecraftWrapper mc = MinecraftWrapper.INSTANCE;
+		if (newDimension != null && lodWorld != null)
 		{
-			Minecraft mc = Minecraft.getInstance();
-			
-			File saveDir;
-			if(mc.hasSingleplayerServer())
+			try
 			{
-				// local world
-				
-				ServerWorld serverWorld = LodUtil.getServerWorldFromDimension(newDimension);
-				// provider needs a separate variable to prevent
-				// the compiler from complaining
-				ServerChunkProvider provider = serverWorld.getChunkSource();
-				saveDir = new File(provider.dataStorage.dataFolder.getCanonicalFile().getPath() + File.separatorChar + "lod");
-			}
-			else
+
+				File saveDir;
+				if (mc.hasSingleplayerServer())
+				{
+					// local world
+
+					ServerWorld serverWorld = LodUtil.getServerWorldFromDimension(newDimension);
+
+					// provider needs a separate variable to prevent
+					// the compiler from complaining
+					ServerChunkProvider provider = serverWorld.getChunkSource();
+					saveDir = new File(provider.dataStorage.dataFolder.getCanonicalFile().getPath() + File.separatorChar + "lod");
+				} else
+				{
+					// connected to server
+
+					saveDir = new File(mc.getGameDirectory().getCanonicalFile().getPath() +
+							                   File.separatorChar + "lod server data" + File.separatorChar + mc.getCurrentDimensionId());
+				}
+
+				fileHandler = new LodDimensionFileHandler(saveDir, this);
+			} catch (IOException e)
 			{
-				// connected to server
-				
-				saveDir = new File(mc.gameDirectory.getCanonicalFile().getPath() +
-						File.separatorChar + "lod server data" + File.separatorChar + LodUtil.getDimensionIDFromWorld(mc.level));
+				// the file handler wasn't able to be created
+				// we won't be able to read or write any files
 			}
-			
-			fileHandler = new LodDimensionFileHandler(saveDir, this);
 		}
-		catch(IOException e)
-		{
-			// the file handler wasn't able to be created
-			// we won't be able to read or write any files
-		}
-		
-		
+
+
 		regions = new LodRegion[width][width];
 		isRegionDirty = new boolean[width][width];
-		
+		regen = new boolean[width][width];
+
+		//treeGenerator((int) mc.player.getX(),(int) mc.player.getZ());
+
 		// populate isRegionDirty
-		for(int i = 0; i < width; i++)
-			for(int j = 0; j < width; j++)
+		for (int i = 0; i < width; i++)
+			for (int j = 0; j < width; j++)
 				isRegionDirty[i][j] = false;
-		
-		centerX = 0;
-		centerZ = 0;
-		
-		halfWidth = (int)Math.floor(width / 2);
+
+		center = new RegionPos(0, 0);
 	}
-	
-	
+
+
 	/**
 	 * Move the center of this LodDimension and move all owned
-	 * regions over by the given x and z offset.
+	 * regions over by the given x and z offset. <br><br>
+	 * <p>
+	 * Synchronized to prevent multiple moves happening on top of each other.
 	 */
-	public void move(int xOffset, int zOffset)
-	{		
+	public synchronized void move(RegionPos regionOffset)
+	{
+		int xOffset = regionOffset.x;
+		int zOffset = regionOffset.z;
+
 		// if the x or z offset is equal to or greater than
 		// the total size, just delete the current data
 		// and update the centerX and/or centerZ
 		if (Math.abs(xOffset) >= width || Math.abs(zOffset) >= width)
 		{
-			for(int x = 0; x < width; x++)
+			for (int x = 0; x < width; x++)
 			{
-				for(int z = 0; z < width; z++)
+				for (int z = 0; z < width; z++)
 				{
 					regions[x][z] = null;
 				}
 			}
-			
+
 			// update the new center
-			centerX += xOffset;
-			centerZ += zOffset;
-			
+			center.x += xOffset;
+			center.z += zOffset;
+
 			return;
 		}
-		
-		
+
+
 		// X
-		if(xOffset > 0)
+		if (xOffset > 0)
 		{
 			// move everything over to the left (as the center moves to the right)
-			for(int x = 0; x < width; x++)
+			for (int x = 0; x < width; x++)
 			{
-				for(int z = 0; z < width; z++)
+				for (int z = 0; z < width; z++)
 				{
-					if(x + xOffset < width)
+					if (x + xOffset < width)
 						regions[x][z] = regions[x + xOffset][z];
 					else
 						regions[x][z] = null;
 				}
 			}
-		}
-		else
+		} else
 		{
 			// move everything over to the right (as the center moves to the left)
-			for(int x = width - 1; x >= 0; x--)
+			for (int x = width - 1; x >= 0; x--)
 			{
-				for(int z = 0; z < width; z++)
+				for (int z = 0; z < width; z++)
 				{
-					if(x + xOffset >= 0)
+					if (x + xOffset >= 0)
 						regions[x][z] = regions[x + xOffset][z];
 					else
+					{
 						regions[x][z] = null;
+					}
 				}
 			}
 		}
-		
-		
-		
+
+
 		// Z
-		if(zOffset > 0)
+		if (zOffset > 0)
 		{
 			// move everything up (as the center moves down)
-			for(int x = 0; x < width; x++)
+			for (int x = 0; x < width; x++)
 			{
-				for(int z = 0; z < width; z++)
+				for (int z = 0; z < width; z++)
 				{
-					if(z + zOffset < width)
+					if (z + zOffset < width)
 						regions[x][z] = regions[x][z + zOffset];
 					else
 						regions[x][z] = null;
 				}
 			}
-		}
-		else
+		} else
 		{
 			// move everything down (as the center moves up)
-			for(int x = 0; x < width; x++)
+			for (int x = 0; x < width; x++)
 			{
-				for(int z = width - 1; z >= 0; z--)
+				for (int z = width - 1; z >= 0; z--)
 				{
-					if(z + zOffset >= 0)
+					if (z + zOffset >= 0)
 						regions[x][z] = regions[x][z + zOffset];
 					else
 						regions[x][z] = null;
 				}
 			}
 		}
-		
-		
-		
+
+
 		// update the new center
-		centerX += xOffset;
-		centerZ += zOffset;
+		center.x += xOffset;
+		center.z += zOffset;
 	}
-	
-	
-	
-	
-	
-	
+
+
+	/**
+	 * return needed memory in byte
+	 */
+	public int getMinMemoryNeeded()
+	{
+		int count = 0;
+		LodRegion region;
+
+		for (int x = 0; x < regions.length; x++)
+		{
+			for (int z = 0; z < regions.length; z++)
+			{
+				region = regions[x][z];
+				if (region != null)
+				{
+					count += region.getMinMemoryNeeded();
+				}
+			}
+		}
+		return count;
+	}
+
+
 	/**
 	 * Gets the region at the given X and Z
 	 * <br>
 	 * Returns null if the region doesn't exist
 	 * or is outside the loaded area.
 	 */
-	public LodRegion getRegion(int regionX, int regionZ)
+	public LodRegion getRegion(byte detailLevel, int posX, int posZ)
 	{
-		int xIndex = (regionX - centerX) + halfWidth;
-		int zIndex = (regionZ - centerZ) + halfWidth;
-		
-		if (!regionIsInRange(regionX, regionZ))
-			// out of range
+		int xRegion = LevelPosUtil.getRegion(detailLevel, posX);
+		int zRegion = LevelPosUtil.getRegion(detailLevel, posZ);
+		int xIndex = (xRegion - center.x) + halfWidth;
+		int zIndex = (zRegion - center.z) + halfWidth;
+
+		if (!regionIsInRange(xRegion, zRegion))
 			return null;
-		
-		if (regions[xIndex][zIndex] == null)
-		{
-			regions[xIndex][zIndex] = getRegionFromFile(regionX, regionZ);
-			if (regions[xIndex][zIndex] == null)
-			{
-				regions[xIndex][zIndex] = new LodRegion(regionX, regionZ);
-			}
-		}
-		
+			//throw new ArrayIndexOutOfBoundsException("Region for level pos " + LevelPosUtil.toString(detailLevel, posX, posZ) + " out of range");
+		else if (regions[xIndex][zIndex] == null)
+			return null;
+			//throw new InvalidParameterException("Region for level pos " + LevelPosUtil.toString(detailLevel, posX, posZ) + " not currently initialized");
+		else if (regions[xIndex][zIndex].getMinDetailLevel() > detailLevel)
+			return null;
+		//throw new InvalidParameterException("Region for level pos " + LevelPosUtil.toString(detailLevel, posX, posZ) + " currently only reach level " + regions[xIndex][zIndex].getMinDetailLevel());
 		return regions[xIndex][zIndex];
 	}
-	
+
+	/**
+	 * Gets the region at the given X and Z
+	 * <br>
+	 * Returns null if the region doesn't exist
+	 * or is outside the loaded area.
+	 */
+	public LodRegion getRegion(int regionPosX, int regionPosZ)
+	{
+		int xIndex = (regionPosX - center.x) + halfWidth;
+		int zIndex = (regionPosZ - center.z) + halfWidth;
+
+		if (!regionIsInRange(regionPosX, regionPosZ))
+			return null;
+			//throw new ArrayIndexOutOfBoundsException("Region " + regionPosX + " " + regionPosZ + " out of range");
+		else if (regions[xIndex][zIndex] == null)
+			return null;
+		//throw new InvalidParameterException("Region " + regionPosX + " " + regionPosZ + " not currently initialized");
+		return regions[xIndex][zIndex];
+	}
+
 	/**
 	 * Overwrite the LodRegion at the location of newRegion with newRegion.
+	 *
 	 * @throws ArrayIndexOutOfBoundsException if newRegion is outside what can be stored in this LodDimension.
 	 */
-	public void setRegion(LodRegion newRegion) throws ArrayIndexOutOfBoundsException
+	public synchronized void addOrOverwriteRegion(LodRegion newRegion) throws ArrayIndexOutOfBoundsException
 	{
-		int xIndex = (newRegion.x - centerX) + halfWidth;
-		int zIndex = (centerZ - newRegion.z) + halfWidth;
-		
-		if (!regionIsInRange(newRegion.x, newRegion.z))
+		int xIndex = (newRegion.regionPosX - center.x) + halfWidth;
+		int zIndex = (newRegion.regionPosZ - center.z) + halfWidth;
+
+		if (!regionIsInRange(newRegion.regionPosX, newRegion.regionPosZ))
 			// out of range
-			throw new ArrayIndexOutOfBoundsException();
-		
+			throw new ArrayIndexOutOfBoundsException("Region " + newRegion.regionPosX + ", " + newRegion.regionPosZ + " out of range");
+
 		regions[xIndex][zIndex] = newRegion;
 	}
-	
-	
-	
-	
-	
+
+
+	/**
+	 *
+	 */
+	public void treeCutter(int playerPosX, int playerPosZ)
+	{
+		ChunkPos newPlayerChunk = new ChunkPos(LevelPosUtil.getChunkPos((byte) 0, playerPosX), LevelPosUtil.getChunkPos((byte) 0, playerPosZ));
+		if (lastCutChunk == null)
+			lastCutChunk = new ChunkPos(newPlayerChunk.x + 1, newPlayerChunk.z - 1);
+		if (newPlayerChunk.x != lastCutChunk.x || newPlayerChunk.z != lastCutChunk.z)
+		{
+			lastCutChunk = newPlayerChunk;
+			Thread thread = new Thread(() ->
+			{
+				int regionX;
+				int regionZ;
+				int minDistance;
+				byte detail;
+				byte levelToCut;
+
+				for (int x = 0; x < regions.length; x++)
+				{
+					for (int z = 0; z < regions.length; z++)
+					{
+						regionX = (x + center.x) - halfWidth;
+						regionZ = (z + center.z) - halfWidth;
+						//we start checking from the first circle. If the whole region is in the circle
+						//we proceed to cut all the level lower than the level of circle 1 and we break
+						//if this is not the case w
+						if (regions[x][z] != null)
+						{
+							minDistance = LevelPosUtil.minDistance(LodUtil.REGION_DETAIL_LEVEL, regionX, regionZ, playerPosX, playerPosZ);
+							detail = DetailDistanceUtil.getDistanceTreeCutInverse(minDistance);
+							levelToCut = DetailDistanceUtil.getCutLodDetail(detail);
+							if (regions[x][z].getMinDetailLevel() > levelToCut)
+							{
+								regions[x][z].cutTree(levelToCut);
+							}
+						}
+
+					}// region z
+				}// region z
+
+			});
+			cutAndGenThreads.execute(thread);
+		}
+	}
+
+	/**
+	 *
+	 */
+	public void treeGenerator(int playerPosX, int playerPosZ)
+	{
+		DistanceGenerationMode generationMode = LodConfig.CLIENT.worldGenerator.distanceGenerationMode.get();
+		ChunkPos newPlayerChunk = new ChunkPos(LevelPosUtil.getChunkPos((byte) 0, playerPosX), LevelPosUtil.getChunkPos((byte) 0, playerPosZ));
+
+		if (lastGenChunk == null)
+			lastGenChunk = new ChunkPos(newPlayerChunk.x + 1, newPlayerChunk.z - 1);
+		if (newPlayerChunk.x != lastGenChunk.x || newPlayerChunk.z != lastGenChunk.z)
+		{
+			lastGenChunk = newPlayerChunk;
+			Thread thread = new Thread(() ->
+			{
+				int regionX;
+				int regionZ;
+				LodRegion region;
+				int minDistance;
+				byte detail;
+				byte levelToGen;
+				for (int x = 0; x < regions.length; x++)
+				{
+					for (int z = 0; z < regions.length; z++)
+					{
+						regionX = (x + center.x) - halfWidth;
+						regionZ = (z + center.z) - halfWidth;
+						final RegionPos regionPos = new RegionPos(regionX, regionZ);
+						region = regions[x][z];
+						//We require that the region we are checking is loaded with at least this level
+
+						minDistance = LevelPosUtil.minDistance(LodUtil.REGION_DETAIL_LEVEL, regionX, regionZ, playerPosX, playerPosZ);
+						detail = DetailDistanceUtil.getDistanceTreeGenInverse(minDistance);
+						levelToGen = DetailDistanceUtil.getLodGenDetail(detail).detailLevel;
+						if (region == null || region.getGenerationMode() != generationMode)
+						{
+							//First case, region has to be initialized
+
+							//We check if there is a file at the target level
+							regions[x][z] = getRegionFromFile(regionPos, levelToGen, generationMode);
+
+							//if there is no file we initialize the region
+							if (regions[x][z] == null)
+							{
+								regions[x][z] = new LodRegion(levelToGen, regionPos, generationMode);
+							}
+							regen[x][z] = true;
+							regenDimension = true;
+
+						} else if (region.getMinDetailLevel() > levelToGen)
+						{
+							//Second case, region has been initialized but at a higher level
+							//We expand the region by introducing the missing layer
+							region.expand(levelToGen);
+						}
+					}
+				}
+			});
+			cutAndGenThreads.execute(thread);
+		}
+	}
+
 	/**
 	 * Add the given LOD to this dimension at the coordinate
 	 * stored in the LOD. If an LOD already exists at the given
 	 * coordinates it will be overwritten.
 	 */
-	public void addLod(LodChunk lod)
+	public synchronized Boolean addData(byte detailLevel, int posX, int posZ, long lodDataPoint, boolean dontSave, boolean serverQuality)
 	{
-		RegionPos pos = LodUtil.convertChunkPosToRegionPos(new ChunkPos(lod.x, lod.z));
-		
+
 		// don't continue if the region can't be saved
-		if (!regionIsInRange(pos.x, pos.z))
+		int regionPosX = LevelPosUtil.getRegion(detailLevel, posX);
+		int regionPosZ = LevelPosUtil.getRegion(detailLevel, posZ);
+
+		LodRegion region = getRegion(regionPosX, regionPosZ);
+		if (region == null)
+			return false;
+		boolean nodeAdded = region.addData(detailLevel, posX, posZ, lodDataPoint, serverQuality);
+		// only save valid LODs to disk
+		if (!dontSave && fileHandler != null)
+		{
+			try
+			{
+				// mark the region as dirty so it will be saved to disk
+				int xIndex = (regionPosX - center.x) + halfWidth;
+				int zIndex = (regionPosZ - center.z) + halfWidth;
+				isRegionDirty[xIndex][zIndex] = true;
+				regen[xIndex][zIndex] = true;
+				regenDimension = true;
+			} catch (ArrayIndexOutOfBoundsException e)
+			{
+				e.printStackTrace();
+				// This method was probably called when the dimension was changing size.
+				// Hopefully this shouldn't be an issue.
+			}
+		}
+		return nodeAdded;
+	}
+
+	public void setToRegen(int xRegion, int zRegion)
+	{
+		int xIndex = (xRegion - center.x) + halfWidth;
+		int zIndex = (zRegion - center.z) + halfWidth;
+		regen[xIndex][zIndex] = true;
+	}
+
+	/**
+	 * method to get all the quadtree level that have to be generated based on the position of the player
+	 *
+	 * @return list of quadTrees
+	 */
+	public PosToGenerateContainer getDataToGenerate(byte farDetail, int maxDataToGenerate, double farRatio, int playerPosX, int playerPosZ)
+	{
+		PosToGenerateContainer posToGenerate = new PosToGenerateContainer(farDetail, maxDataToGenerate, (int) (maxDataToGenerate * farRatio), playerPosX, playerPosZ);
+		int n = regions.length;
+		int xIndex;
+		int zIndex;
+		LodRegion region;
+		for (int xRegion = 0; xRegion < n; xRegion++)
+		{
+			for (int zRegion = 0; zRegion < n; zRegion++)
+			{
+				xIndex = (xRegion + center.x) - halfWidth;
+				zIndex = (zRegion + center.z) - halfWidth;
+				region = getRegion(xIndex, zIndex);
+				if (region != null)
+					region.getDataToGenerate(posToGenerate, playerPosX, playerPosZ);
+
+			}
+		}
+		return posToGenerate;
+	}
+
+	/**
+	 * method to get all the nodes that have to be rendered based on the position of the player
+	 *
+	 * @return list of nodes
+	 */
+	public void getDataToRender(PosToRenderContainer posToRender, RegionPos regionPos, int playerPosX, int playerPosZ)
+	{
+		LodRegion region = getRegion(regionPos.x, regionPos.z);
+		if (region != null)
+			region.getDataToRender(posToRender, playerPosX, playerPosZ);
+	}
+
+	/**
+	 * Get the data point at the given X and Z coordinates
+	 * in this dimension.
+	 * <br>
+	 * Returns null if the LodChunk doesn't exist or
+	 * is outside the loaded area.
+	 */
+	public long getData(byte detailLevel, int posX, int posZ)
+	{
+		if (detailLevel > LodUtil.REGION_DETAIL_LEVEL)
+			throw new IllegalArgumentException("getLodFromCoordinates given a level of \"" + detailLevel + "\" when \"" + LodUtil.REGION_DETAIL_LEVEL + "\" is the max.");
+
+		LodRegion region = getRegion(detailLevel, posX, posZ);
+
+		if (region == null)
+		{
+			return 0;
+		}
+
+		return region.getData(detailLevel, posX, posZ);
+	}
+
+
+	/**
+	 * Get the data point at the given X and Z coordinates
+	 * in this dimension.
+	 * <br>
+	 * Returns null if the LodChunk doesn't exist or
+	 * is outside the loaded area.
+	 */
+	public void updateData(byte detailLevel, int posX, int posZ)
+	{
+		if (detailLevel > LodUtil.REGION_DETAIL_LEVEL)
+			throw new IllegalArgumentException("getLodFromCoordinates given a level of \"" + detailLevel + "\" when \"" + LodUtil.REGION_DETAIL_LEVEL + "\" is the max.");
+
+		LodRegion region = getRegion(detailLevel, posX, posZ);
+
+
+		if (region == null)
 		{
 			return;
 		}
-			
-		LodRegion region = getRegion(pos.x, pos.z);
-		
+		region.updateArea(detailLevel, posX, posZ);
+	}
+
+	/**
+	 * return true if and only if the node at that position exist
+	 */
+	public boolean doesDataExist(byte detailLevel, int posX, int posZ)
+	{
+		LodRegion region = getRegion(detailLevel, posX, posZ);
+
 		if (region == null)
 		{
-			// if no region exists, create it
-			region = new LodRegion(pos.x, pos.z);
-			setRegion(region);
-		}
-		
-		region.addLod(lod);
-		
-		// don't save empty place holders to disk
-		if (!lod.isPlaceholder() && fileHandler != null)
-		{
-			// mark the region as dirty so it will be saved to disk
-			int xIndex = (pos.x - centerX) + halfWidth;
-			int zIndex = (pos.z - centerZ) + halfWidth;
-			isRegionDirty[xIndex][zIndex] = true;
-			fileHandler.saveDirtyRegionsToFileAsync();
+			return false;
 		}
+
+		return region.doesDataExist(detailLevel, posX, posZ);
 	}
-	
-	/**
-	 * Get the LodChunk at the given X and Z coordinates
-	 * in this dimension.
-	 * <br>
-	 * Returns null if the LodChunk doesn't exist or 
-	 * is outside the loaded area.
-	 */
-	public LodChunk getLodFromCoordinates(int chunkX, int chunkZ)
-	{
-		RegionPos pos = LodUtil.convertChunkPosToRegionPos(new ChunkPos(chunkX, chunkZ));
-		
-		LodRegion region = getRegion(pos.x, pos.z);
-		
-		if(region == null)
-			return null;
-		
-		return region.getLod(chunkX, chunkZ);
-	}
-	
-	
+
 	/**
 	 * Get the region at the given X and Z coordinates from the
 	 * RegionFileHandler.
 	 */
-	public LodRegion getRegionFromFile(int regionX, int regionZ)
+	public LodRegion getRegionFromFile(RegionPos regionPos, byte detailLevel, DistanceGenerationMode generationMode)
 	{
 		if (fileHandler != null)
-			return fileHandler.loadRegionFromFile(regionX, regionZ);
+			return fileHandler.loadRegionFromFile(detailLevel, regionPos, generationMode);
 		else
 			return null;
 	}
-	
-	
+
+	/**
+	 * Save all dirty regions in this LodDimension to file.
+	 */
+	public void saveDirtyRegionsToFileAsync()
+	{
+		fileHandler.saveDirtyRegionsToFileAsync();
+	}
+
+
 	/**
 	 * Returns whether the region at the given X and Z coordinates
 	 * is within the loaded range.
 	 */
 	public boolean regionIsInRange(int regionX, int regionZ)
 	{
-		int xIndex = (regionX - centerX) + halfWidth;
-		int zIndex = (regionZ - centerZ) + halfWidth;
-		
+		int xIndex = (regionX - center.x) + halfWidth;
+		int zIndex = (regionZ - center.z) + halfWidth;
+
 		return xIndex >= 0 && xIndex < width && zIndex >= 0 && zIndex < width;
 	}
 
-	
-	
-	
-	
-	
 
 	public int getCenterX()
 	{
-		return centerX;
+		return center.x;
 	}
-	
+
 	public int getCenterZ()
 	{
-		return centerZ;
+		return center.z;
 	}
-	
-	
-	/**
-	 * Returns how many non-null LodChunks
-	 * are stored in this LodDimension.
-	 */
-	public int getNumberOfLods()
-	{
-		int numbLods = 0;
-        for (LodRegion[] regions : regions)
-        {
-        	if(regions == null)
-    			continue;
-        	
-        	for (LodRegion region : regions)
-            {
-        		if(region == null)
-        			continue;
-        			
-            	for(LodChunk[] lods : region.getAllLods())
-            	{
-            		if(lods == null)
-            			continue;
-            		
-            		for(LodChunk lod : lods)
-                	{
-                		if (lod != null)
-                			numbLods++;
-                	}
-            	}
-            }
-        }
-        
-        return numbLods;
-	}
-	
-	
+
+
 	public int getWidth()
 	{
-		return width;
+		if (regions != null)
+		{
+			// we want to get the length directly from the
+			// source to make sure it is in sync with region
+			// and isRegionDirty
+			return regions.length;
+		} else
+		{
+			return width;
+		}
 	}
-	
+
 	public void setRegionWidth(int newWidth)
 	{
 		width = newWidth;
-		halfWidth = (int)Math.floor(width / 2);
-		
+		halfWidth = Math.floorDiv(width, 2);
+
 		regions = new LodRegion[width][width];
 		isRegionDirty = new boolean[width][width];
-		
+		regen = new boolean[width][width];
+
 		// populate isRegionDirty
-		for(int i = 0; i < width; i++)
-			for(int j = 0; j < width; j++)
+		for (int i = 0; i < width; i++)
+			for (int j = 0; j < width; j++)
 				isRegionDirty[i][j] = false;
 	}
-	
-	
+
+
 	@Override
 	public String toString()
 	{
-		String s = "";
-		
-		s += "dim: " + dimension.toString() + "\t";
-		s += "(" + centerX + "," + centerZ + ")";
-		
-		return s;
+		LodRegion region;
+
+		StringBuilder stringBuilder = new StringBuilder();
+		stringBuilder.append("Dimension : \n");
+		for (int x = 0; x < regions.length; x++)
+		{
+			for (int z = 0; z < regions.length; z++)
+			{
+				region = regions[x][z];
+				if (region == null)
+				{
+					stringBuilder.append("n");
+					stringBuilder.append("\t");
+
+				} else
+				{
+					stringBuilder.append(region.getMinDetailLevel());
+					stringBuilder.append("\t");
+				}
+			}
+			stringBuilder.append("\n");
+		}
+		return stringBuilder.toString();
 	}
 }
-
-
-
-
-

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

@@ -1,104 +1,463 @@
-/*
- *    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.builders.LodBuilder;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.util.DetailDistanceUtil;
+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 6-12-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;
+	private DistanceGenerationMode generationMode;
+	//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 long[][][] data;
+
+
+	public final int regionPosX;
+	public final int regionPosZ;
+
+	public LodRegion(LevelContainer levelContainer, RegionPos regionPos, DistanceGenerationMode generationMode)
 	{
-		x = regionX;
-		z = regionZ;
-		
-		chunks = new LodChunk[SIZE][SIZE];
+		this.generationMode = generationMode;
+		this.regionPosX = regionPos.x;
+		this.regionPosZ = regionPos.z;
+		this.minDetailLevel = levelContainer.detailLevel;
+
+		//Arrays of matrices
+		data = new long[POSSIBLE_LOD][][];
+
+		data[minDetailLevel] = levelContainer.data;
+
+		//Initialize all the different matrices
+		for (byte lod = (byte) (minDetailLevel + 1); lod <= LodUtil.REGION_DETAIL_LEVEL; lod++)
+		{
+			int size = (short) Math.pow(2, LodUtil.REGION_DETAIL_LEVEL - lod);
+			data[lod] = new long[size][size];
+		}
+		updateArea(LodUtil.REGION_DETAIL_LEVEL, regionPosX, regionPosZ);
 	}
-	
-	
+
+	public LodRegion(byte minDetailLevel, RegionPos regionPos, DistanceGenerationMode generationMode)
+	{
+		this.generationMode = generationMode;
+		this.minDetailLevel = minDetailLevel;
+		this.regionPosX = regionPos.x;
+		this.regionPosZ = regionPos.z;
+
+		data = new long[POSSIBLE_LOD][][];
+
+
+		//Initialize all the different matrices
+		for (byte lod = minDetailLevel; lod <= LodUtil.REGION_DETAIL_LEVEL; lod++)
+		{
+			int size = (short) Math.pow(2, LodUtil.REGION_DETAIL_LEVEL - lod);
+			data[lod] = new long[size][size];
+
+		}
+	}
+
 	/**
-	 * 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
+	 *
+	 * @param dataPoint
+	 * @return
 	 */
-	public void addLod(LodChunk lod)
+	public boolean addData(byte detailLevel, int posX, int posZ, long dataPoint, boolean serverQuality)
 	{
-		// 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);
+		if (!doesDataExist(detailLevel, posX, posZ) || serverQuality)
+		{
+
+			//update the number of node present
+			//if (!doesDataExist(detailLevel, posX, posZ)) numberOfPoints++;
+
+			//add the node data
+			this.data[detailLevel][posX][posZ] = dataPoint;
+			return true;
+		} else
+		{
+			return false;
+		}
 	}
-	
+
 	/**
-	 * 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)
 	{
-		// 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);
-		
-		return chunks[arrayX][arrayZ];
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		return data[detailLevel][posX][posZ];
 	}
-	
-	
+
 	/**
-	 * Returns all LodChunks in this region
+	 * This method will return all the levelPos that are renderable according to the requisite given in input
+	 *
+	 * @return
 	 */
-	public LodChunk[][] getAllLods()
+	public void getDataToGenerate(PosToGenerateContainer posToGenerate, int playerPosX, int playerPosZ)
 	{
-		return chunks;
+		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
+
+		if (DetailDistanceUtil.getDistanceGenerationInverse(maxDistance) > detailLevel)
+		{
+			return;
+		} else if (DetailDistanceUtil.getDistanceGenerationInverse(maxDistance) == 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)
+	{
+		getDataToRender(posToRender, LodUtil.REGION_DETAIL_LEVEL, 0, 0, playerPosX, playerPosZ);
+	}
+
+	/**
+	 * @return
+	 */
+	private void getDataToRender(PosToRenderContainer posToRender, 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 rendering
+		int maxDistance = LevelPosUtil.maxDistance(detailLevel, posX, posZ, playerPosX, playerPosZ, regionPosX, regionPosZ);
+
+		byte supposedLevel = DetailDistanceUtil.getLodDrawDetail(DetailDistanceUtil.getDistanceRenderingInverse(maxDistance));
+		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)) childrenCount++;
+				}
+			}
+
+			//If all the four children exist we go deeper
+			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);
+					}
+				}
+			} 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)
+	{
+		int numberOfChildren = 0;
+		int numberOfVoidChildren = 0;
+
+		int tempRed = 0;
+		int tempGreen = 0;
+		int tempBlue = 0;
+		int tempHeight = 0;
+		int tempDepth = 0;
+		int childPosX;
+		int childPosZ;
+		byte childDetailLevel;
+		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;
+				childDetailLevel = (byte) (detailLevel - 1);
+				if (doesDataExist(childDetailLevel, childPosX, childPosZ))
+				{
+					if (!(DataPoint.getHeight(data[childDetailLevel][childPosX][childPosZ]) == LodBuilder.DEFAULT_HEIGHT
+							    && DataPoint.getDepth(data[childDetailLevel][childPosX][childPosZ]) == LodBuilder.DEFAULT_DEPTH))
+					{
+						numberOfChildren++;
+
+						tempRed += DataPoint.getRed(data[childDetailLevel][childPosX][childPosZ]);
+						tempGreen += DataPoint.getGreen(data[childDetailLevel][childPosX][childPosZ]);
+						tempBlue += DataPoint.getBlue(data[childDetailLevel][childPosX][childPosZ]);
+						tempHeight += DataPoint.getHeight(data[childDetailLevel][childPosX][childPosZ]);
+						tempDepth += DataPoint.getDepth(data[childDetailLevel][childPosX][childPosZ]);
+					} else
+					{
+						// void children have the default height (most likely -1)
+						// and represent a LOD with no blocks in it
+						numberOfVoidChildren++;
+					}
+				}
+			}
+		}
+		if (numberOfChildren > 0)
+		{
+			tempRed = tempRed / numberOfChildren;
+			tempGreen = tempGreen / numberOfChildren;
+			tempBlue = tempBlue / numberOfChildren;
+			tempHeight = tempHeight / numberOfChildren;
+			tempDepth = tempDepth / numberOfChildren;
+		} else if (numberOfVoidChildren > 0)
+		{
+			tempRed = (byte) 0;
+			tempGreen = (byte) 0;
+			tempBlue = (byte) 0;
+			tempHeight = LodBuilder.DEFAULT_HEIGHT;
+			tempDepth = LodBuilder.DEFAULT_DEPTH;
+		}
+		data[detailLevel][posX][posZ] = DataPoint.createDataPoint(tempHeight, tempDepth, tempRed, tempGreen, tempBlue);
+	}
+
+
+	/**
+	 * @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);
+		return DataPoint.doesItExist(data[detailLevel][posX][posZ]);
+	}
+
+	/**
+	 * @return
+	 */
+	public DistanceGenerationMode getGenerationMode()
+	{
+		return generationMode;
+	}
+
+	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 new LevelContainer(detailLevel, data[detailLevel]);
+	}
+
+	/**
+	 * @param levelContainer
+	 */
+	public void addLevel(LevelContainer levelContainer)
+	{
+		if (levelContainer.detailLevel < minDetailLevel - 1)
+		{
+			throw new IllegalArgumentException("addLevel requires a level that is at least the minimum level of the region -1 ");
+		}
+		if (levelContainer.detailLevel == minDetailLevel - 1) minDetailLevel = levelContainer.detailLevel;
+		data[levelContainer.detailLevel] = levelContainer.data;
+
+	}
+
+	/**
+	 * @param detailLevel
+	 */
+	public void cutTree(byte detailLevel)
+	{
+		if (minDetailLevel < detailLevel)
+		{
+			for (byte tempLod = 0; tempLod < detailLevel; tempLod++)
+			{
+				data[tempLod] = new long[0][0];
+			}
+			minDetailLevel = detailLevel;
+		}
+	}
+
+	/**
+	 * @param detailLevel
+	 */
+	public void expand(byte detailLevel)
+	{
+		if (detailLevel < minDetailLevel)
+		{
+			for (byte tempLod = detailLevel; tempLod < minDetailLevel; tempLod++)
+			{
+				int size = (short) Math.pow(2, LodUtil.REGION_DETAIL_LEVEL - tempLod);
+				data[tempLod] = new long[size][size];
+			}
+			minDetailLevel = detailLevel;
+		}
+	}
+
+	/**
+	 * return RegionPos of this lod region
+	 */
+	public RegionPos getRegionPos()
+	{
+		return new RegionPos(regionPosX, regionPosZ);
+	}
+
+	/**
+	 * return needed memory in byte
+	 */
+	public int getMinMemoryNeeded()
+	{
+		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 += Math.pow(2, LodUtil.REGION_DETAIL_LEVEL - tempLod) * (8 + 3 + 2 + 2 + 1);
+			//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();
 	}
 }

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

@@ -20,56 +20,64 @@ 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()
 	{
@@ -77,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/PosToGenerateContainer.java

@@ -0,0 +1,148 @@
+package com.seibel.lod.objects;
+
+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[][] posToGenerate;
+
+	public PosToGenerateContainer(byte farMinDetail, int maxDataToGenerate, int maxFarDataToGenerate, int playerPosX, int playerPosZ)
+	{
+		this.playerPosX = playerPosX;
+		this.playerPosZ = playerPosZ;
+		this.farMinDetail = farMinDetail;
+		maxNearSize = maxDataToGenerate;
+		maxFarSize = maxFarDataToGenerate;
+		maxSize = maxDataToGenerate;
+		nearSize = 0;
+		farSize = 0;
+		posToGenerate = 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 < maxFarSize)
+			{
+				farSize++;
+				if (nearSize == maxNearSize)
+				{
+					nearSize--;
+				}
+				maxNearSize--;
+			}
+			index = posToGenerate.length - farSize;
+			while (index < posToGenerate.length - 1 && LevelPosUtil.compareLevelAndDistance(detailLevel, distance, (byte) (posToGenerate[index + 1][0] - 1), posToGenerate[index + 1][3]) <= 0)
+			{
+				posToGenerate[index][0] = posToGenerate[index + 1][0];
+				posToGenerate[index][1] = posToGenerate[index + 1][1];
+				posToGenerate[index][2] = posToGenerate[index + 1][2];
+				posToGenerate[index][3] = posToGenerate[index + 1][3];
+				index++;
+			}
+			if (index <= posToGenerate.length - 1)
+			{
+				posToGenerate[index][0] = detailLevel + 1;
+				posToGenerate[index][1] = posX;
+				posToGenerate[index][2] = posZ;
+				posToGenerate[index][3] = distance;
+			}
+		} else
+		{//We are introducing a position in the near array
+			if (nearSize < maxNearSize)
+				nearSize++;
+			index = nearSize - 1;
+
+			while (index > 0 && LevelPosUtil.compareDistance(distance, posToGenerate[index - 1][3]) <= 0)
+			{
+				posToGenerate[index][0] = posToGenerate[index - 1][0];
+				posToGenerate[index][1] = posToGenerate[index - 1][1];
+				posToGenerate[index][2] = posToGenerate[index - 1][2];
+				posToGenerate[index][3] = posToGenerate[index - 1][3];
+				index--;
+			}
+			if (index >= 0)
+			{
+				posToGenerate[index][0] = detailLevel + 1;
+				posToGenerate[index][1] = posX;
+				posToGenerate[index][2] = posZ;
+				posToGenerate[index][3] = distance;
+			}
+		}
+	}
+
+
+	public int getNumberOfPos()
+	{
+		return farSize + nearSize;
+	}
+
+	public int[] getNthPos(int n)
+	{
+		/*if(n < farSize)
+			return posToGenerate[maxSize - n - 1];
+		else
+			return posToGenerate[n - farSize];*/
+		int index;
+		if (n > farSize * 2)
+			index = n - farSize;
+		else if (n % 2 == 0)
+			index = n / 2;
+		else
+			index = posToGenerate.length - n / 2 - 1;
+		return posToGenerate[index];
+	}
+
+	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();
+	}
+}

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

@@ -0,0 +1,117 @@
+package com.seibel.lod.objects;
+
+import com.seibel.lod.util.LodUtil;
+
+public class PosToRenderContainer
+{
+	public byte minDetail;
+	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;
+		int 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)
+	{
+		//if(numberOfPosToRender >= posToRender.length)
+		//	posToRender = Arrays.copyOf(posToRender, posToRender.length*2);
+		posToRender[numberOfPosToRender][0] = detailLevel;
+		posToRender[numberOfPosToRender][1] = posX;
+		posToRender[numberOfPosToRender][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)
+		{
+			int size = 1 << (LodUtil.REGION_DETAIL_LEVEL - minDetail);
+			for (int x = 0; x < size; x++)
+			{
+				for (int z = 0; z < size; z++)
+				{
+					posToRender[0][0] = 0;
+					posToRender[0][1] = 0;
+					posToRender[0][2] = 0;
+					population[x][z] = 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][0];
+	}
+	public int getNthPosX(int n)
+	{
+		return posToRender[n][1];
+	}
+	public int getNthPosZ(int n)
+	{
+		return posToRender[n][2];
+	}
+
+	public int[] getNthPos(int n)
+	{
+		return posToRender[n];
+	}
+
+	@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][0]);
+			builder.append(" ");
+			builder.append(posToRender[i][1]);
+			builder.append(" ");
+			builder.append(posToRender[i][2]);
+			builder.append('\n');
+		}
+		builder.append('\n');
+		return builder.toString();
+	}
+}

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

@@ -17,21 +17,26 @@
  */
 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()
@@ -39,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/proxy/ClientProxy.java

@@ -19,19 +19,27 @@ package com.seibel.lod.proxy;
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
+import org.lwjgl.glfw.GLFW;
 
 import com.seibel.lod.builders.LodBufferBuilder;
-import com.seibel.lod.builders.LodChunkBuilder;
-import com.seibel.lod.handlers.LodConfig;
-import com.seibel.lod.objects.LodChunk;
+import com.seibel.lod.builders.LodBuilder;
+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.enums.LodDetail;
 import com.seibel.lod.objects.LodDimension;
-import com.seibel.lod.objects.LodRegion;
 import com.seibel.lod.objects.LodWorld;
+import com.seibel.lod.objects.RegionPos;
 import com.seibel.lod.render.LodRenderer;
+import com.seibel.lod.util.DetailDistanceUtil;
 import com.seibel.lod.util.LodUtil;
+import com.seibel.lod.wrappers.MinecraftWrapper;
 
-import net.minecraft.client.Minecraft;
 import net.minecraft.profiler.IProfiler;
+import net.minecraft.util.text.StringTextComponent;
+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;
@@ -40,20 +48,39 @@ import net.minecraftforge.eventbus.api.SubscribeEvent;
 /**
  * This handles all events sent to the client,
  * and is the starting point for most of this program.
- * 
+ *
  * @author James_Seibel
- * @version 06-27-2021
+ * @version 8-24-2021
  */
 public class ClientProxy
 {
 	public static final Logger LOGGER = LogManager.getLogger("LOD");
 	
 	private static LodWorld lodWorld = new LodWorld();
-	private static LodChunkBuilder lodChunkBuilder = new LodChunkBuilder();
-	private static LodBufferBuilder lodBufferBuilder = new LodBufferBuilder(lodChunkBuilder);
+	private static LodBuilder lodBuilder = new LodBuilder();
+	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;
+	
+	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;
 	
 	
 	public ClientProxy()
@@ -62,8 +89,6 @@ public class ClientProxy
 	}
 	
 	
-	
-	
 	//==============//
 	// render event //
 	//==============//
@@ -74,69 +99,82 @@ public class ClientProxy
 	 */
 	public void renderLods(float partialTicks)
 	{
-		if (mc == null || mc.player == null || !lodWorld.getIsWorldLoaded())
+		DetailDistanceUtil.updateSettings();
+		if (mc == null || mc.getPlayer() == null || !lodWorld.getIsWorldLoaded())
 			return;
 		
-		// update each regions' width to match the new render distance
-		int newWidth = Math.max(4, 
-				// TODO is this logic good?
-				(mc.options.renderDistance * LodChunk.WIDTH * 2 * LodConfig.CLIENT.lodChunkRadiusMultiplier.get()) / LodRegion.SIZE
-				);
-		if (lodChunkBuilder.regionWidth != newWidth)
-		{
-			lodWorld.resizeDimensionRegionWidth(newWidth);
-			lodChunkBuilder.regionWidth = newWidth;
-			
-			// skip this frame, hopefully the lodWorld
-			// should have everything set up by then
-			return;
-		}
+		viewDistanceChangedEvent();
 		
-		LodDimension lodDim = lodWorld.getLodDimension(mc.player.level.dimensionType());
+		LodDimension lodDim = lodWorld.getLodDimension(mc.getCurrentDimension());
 		if (lodDim == null)
 			return;
 		
 		
-		// offset the regions
-		double playerX = mc.player.getX();
-		double playerZ = mc.player.getZ();
+		playerMoveEvent(lodDim);
+		//System.out.println("memory needed " + lodDim.getMinMemoryNeeded() + " byte");
+		//System.out.println(lodDim);
 		
-		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)
-		{
-			lodDim.move(xOffset, zOffset);
-		}
+		lodDim.treeCutter((int) mc.getPlayer().getX(), (int) mc.getPlayer().getZ());
+		lodDim.treeGenerator((int) mc.getPlayer().getX(), (int) mc.getPlayer().getZ());
 		
 		
-		// for testing
-//		LodConfig.CLIENT.debugMode.set(false);
-		
-//		LodConfig.CLIENT.lodDetail.set(LodDetail.DOUBLE);
-//		LodConfig.CLIENT.lodChunkRadiusMultiplier.set(12);
-//		LodConfig.CLIENT.fogDistance.set(FogDistance.FAR);
-//		LodConfig.CLIENT.fogDrawOverride.set(FogDrawOverride.ALWAYS_DRAW_FOG_FANCY);
-		
-//		LodConfig.CLIENT.distanceGenerationMode.set(DistanceGenerationMode.FEATURES);
-//		LodConfig.CLIENT.allowUnstableFeatureGeneration.set(false);
+		// comment out when creating a release
+		//applyConfigOverrides();
 		
 		
 		// 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
+		// is too small for the profiler to measure
 		IProfiler profiler = mc.getProfiler();
 		profiler.pop(); // get out of "terrain"
 		profiler.push("LOD");
-		
 		renderer.drawLODs(lodDim, partialTicks, mc.getProfiler());
 		
 		profiler.pop(); // end LOD
-		profiler.push("terrain"); // restart terrain
-	}	
+		profiler.push("terrain"); // restart "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();
+	}
 	
 	
+	private void applyConfigOverrides()
+	{
+		// remind the developer(s). that config override is active
+		if (!configOverrideReminderPrinted)
+		{
+			mc.getPlayer().sendMessage(new StringTextComponent("Debug settings enabled!"), mc.getPlayer().getUUID());
+			configOverrideReminderPrinted = true;
+		}
+		
+		//LodConfig.CLIENT.drawLODs.set(true);
+		//LodConfig.CLIENT.debugMode.set(true);
+		
+		LodConfig.CLIENT.graphics.maxDrawDetail.set(LodDetail.FULL);
+		LodConfig.CLIENT.worldGenerator.maxGenerationDetail.set(LodDetail.FULL);
+		
+//		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(256);
+//		LodConfig.CLIENT.worldGenerator.lodDistanceCalculatorType.set(DistanceCalculatorType.LINEAR);
+//		LodConfig.CLIENT.graphics.lodQuality.set(3);
+//		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(50); // 5000
+		
+		LodConfig.CLIENT.debugging.enableDebugKeybinding.set(true);
+	}
 	
 	
 	//==============//
@@ -144,11 +182,30 @@ public class ClientProxy
 	//==============//
 	
 	@SubscribeEvent
-	public void chunkLoadEvent(ChunkEvent.Load event)
+	public void serverTickEvent(TickEvent.ServerTickEvent event)
 	{
-		lodChunkBuilder.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)
@@ -164,30 +221,96 @@ public class ClientProxy
 	public void worldUnloadEvent(WorldEvent.Unload event)
 	{
 		// the player just unloaded a world/dimension
-		
-		if(mc.getConnection().getLevel() == null)
+		if (mc.getConnection().getLevel() == null)
 		{
-			lodBufferBuilder.numberOfChunksWaitingToGenerate.set(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;
 		}
 	}
 	
-	
 	@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
-			lodChunkBuilder.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.enableDebugKeybinding.get()
+			&& event.getKey() == GLFW.GLFW_KEY_F4 && event.getAction() == GLFW.GLFW_PRESS)
+		{
+			LodConfig.CLIENT.debugging.debugMode.set(LodConfig.CLIENT.debugging.debugMode.get().getNext());
+		}
+	}
+	
+	
+	
+	//==================//
+	// frame 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(newWidth);
+			
+			recalculateWidths = false;
+			//LOGGER.info("new dimension width in regions: " + newWidth + "\t potential: " + newWidth );
+		}
+		DetailDistanceUtil.updateSettings();
+	}
 	
 	
 	
@@ -200,9 +323,9 @@ public class ClientProxy
 		return lodWorld;
 	}
 	
-	public static LodChunkBuilder getLodBuilder()
+	public static LodBuilder getLodBuilder()
 	{
-		return lodChunkBuilder;
+		return lodBuilder;
 	}
 	
 	public static LodRenderer getRenderer()

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

@@ -17,23 +17,25 @@
  */
 package com.seibel.lod.render;
 
-import com.seibel.lod.enums.LodDetail;
+import com.seibel.lod.config.LodConfig;
 import com.seibel.lod.enums.LodTemplate;
-import com.seibel.lod.handlers.LodConfig;
+import com.seibel.lod.util.LodUtil;
+import com.seibel.lod.wrappers.MinecraftWrapper;
 
-import net.minecraft.client.Minecraft;
+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 6-17-2021
+ * @version 8-21-2021
  */
 public class RenderUtil
 {
-	private static final Minecraft mc = Minecraft.getInstance();
+	private static final MinecraftWrapper mc = MinecraftWrapper.INSTANCE;
 	
 	
 	/**
@@ -42,28 +44,24 @@ public class RenderUtil
 	 */
 	public static boolean isChunkPosInLoadedArea(ChunkPos pos, ChunkPos center)
 	{
-		Minecraft mc = Minecraft.getInstance();
-		
-		return (pos.x >= center.x - mc.options.renderDistance 
-				&& pos.x <= center.x + mc.options.renderDistance) 
+		return (pos.x >= center.x - mc.getRenderDistance() 
+				&& pos.x <= center.x + mc.getRenderDistance()) 
 				&& 
-				(pos.z >= center.z - mc.options.renderDistance 
-				&& pos.z <= center.z + mc.options.renderDistance);
+				(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.options.renderDistance 
-				&& i <= centerCoordinate + mc.options.renderDistance) 
+		return (x >= centerCoordinate - mc.getRenderDistance() 
+				&& x <= centerCoordinate + mc.getRenderDistance()) 
 				&& 
-				(j >= centerCoordinate - mc.options.renderDistance 
-				&& j <= centerCoordinate + mc.options.renderDistance);
+				(z >= centerCoordinate - mc.getRenderDistance() 
+				&& z <= centerCoordinate + mc.getRenderDistance());
 	}
 	
 	
@@ -85,27 +83,69 @@ public class RenderUtil
 	
 	/**
 	 * 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 getBufferMemoryForRadiusMultiplier(int radiusMultiplier)
-	{ 
-		int numbChunksWide = mc.options.renderDistance * 
-							radiusMultiplier * 2;
-		
+	public static int getBufferMemoryForRegion()
+	{
 		// calculate the max amount of buffer memory needed (in bytes)
-		return numbChunksWide * numbChunksWide *
-				LodConfig.CLIENT.lodTemplate.get().
-				getBufferMemoryForSingleLod(LodConfig.CLIENT.lodDetail.get());
+		return LodUtil.REGION_WIDTH_IN_CHUNKS * LodUtil.REGION_WIDTH_IN_CHUNKS *
+				LodConfig.CLIENT.graphics.lodTemplate.get().getBufferMemoryForSingleLod();
 	}
 	
 	/**
 	 * Returns the maxViewDistanceMultiplier for the given LodTemplate
 	 * at the given LodDetail level.
 	 */
-	public static int getMaxRadiusMultiplierWithAvaliableMemory(LodTemplate lodTemplate, LodDetail lodDetail)
+	public static int getMaxRadiusMultiplierWithAvaliableMemory(LodTemplate lodTemplate, int detailLevel)
 	{
-		int maxNumberOfLods = LodRenderer.MAX_ALOCATEABLE_DIRECT_MEMORY / lodTemplate.getBufferMemoryForSingleLod(lodDetail); 
+		int maxNumberOfLods = LodRenderer.MAX_ALOCATEABLE_DIRECT_MEMORY / lodTemplate.getBufferMemoryForSingleLod();
 		int numbLodsWide = (int) Math.sqrt(maxNumberOfLods);
 		
-		return numbLodsWide / (2 * mc.options.renderDistance);
+		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,70 @@
+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();
+	}
+}

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

@@ -0,0 +1,189 @@
+package com.seibel.lod.util;
+
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.enums.LodDetail;
+import com.seibel.lod.objects.RegionPos;
+import com.seibel.lod.wrappers.MinecraftWrapper;
+
+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.maxGenerationDetail.get().detailLevel;
+	private static int minDrawDetail = Math.max(LodConfig.CLIENT.graphics.maxDrawDetail.get().detailLevel,LodConfig.CLIENT.worldGenerator.maxGenerationDetail.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 LodDetail[] lodGenDetails = {
+			LodDetail.FULL,
+			LodDetail.HALF,
+			LodDetail.QUAD,
+			LodDetail.DOUBLE,
+			LodDetail.SINGLE,
+			LodDetail.SINGLE,
+			LodDetail.SINGLE,
+			LodDetail.SINGLE,
+			LodDetail.SINGLE,
+			LodDetail.SINGLE,
+			LodDetail.SINGLE};
+
+
+
+	public static void updateSettings(){
+		minGenDetail = LodConfig.CLIENT.worldGenerator.maxGenerationDetail.get().detailLevel;
+		minDrawDetail = Math.max(LodConfig.CLIENT.graphics.maxDrawDetail.get().detailLevel,LodConfig.CLIENT.worldGenerator.maxGenerationDetail.get().detailLevel);
+		maxDistance = LodConfig.CLIENT.graphics.lodChunkRenderDistance.get() * 16 * 2;
+	}
+
+	public static int getDistanceRendering(int detail)
+	{
+		int initial;
+		int distance = 0;
+		if (detail <= minGenDetail)
+			return minDistance;
+		if (detail == maxDetail)
+			return maxDistance;
+		if (detail == maxDetail + 1)
+			return maxDistance;
+		switch (LodConfig.CLIENT.worldGenerator.lodDistanceCalculatorType.get())
+		{
+			case LINEAR:
+				initial = LodConfig.CLIENT.graphics.lodQuality.get() * 128;
+				return (detail * initial);
+			case QUADRATIC:
+				initial = LodConfig.CLIENT.graphics.lodQuality.get() * 128;
+				return (int) (Math.pow(base, detail) * initial);
+			case RENDER_DEPENDANT:
+				int realRenderDistance = MinecraftWrapper.INSTANCE.getRenderDistance() * 16;
+				int border = 64;
+				byte detailAtBorder = (byte) 4;
+				if (detail > detailAtBorder)
+				{
+					return (detail * (border - realRenderDistance) / detailAtBorder + realRenderDistance);
+				} else
+				{
+					return ((maxDetail - detail) * (maxDistance - border) / (maxDetail - detailAtBorder) + border);
+				}
+		}
+		return distance;
+	}
+
+	public static byte baseInverse(int distance, int minDetail)
+	{
+		int initial;
+		byte detail = 0;
+		if (distance == 0)
+			detail = (byte) minDetail;
+		if (distance > maxDistance)
+			detail = (byte) (maxDetail-1);
+		switch (LodConfig.CLIENT.worldGenerator.lodDistanceCalculatorType.get())
+		{
+			case LINEAR:
+				initial = LodConfig.CLIENT.graphics.lodQuality.get() * 128;
+				detail = (byte) Math.floorDiv(distance, initial);
+				break;
+			case QUADRATIC:
+				initial = LodConfig.CLIENT.graphics.lodQuality.get() * 128;
+				detail = (byte) (Math.log(Math.floorDiv(distance, initial))/logBase);
+				break;
+			case RENDER_DEPENDANT:
+				detail = (byte) 9;
+				break;
+		}
+		return (byte) Math.min(detail, LodUtil.REGION_DETAIL_LEVEL);
+	}
+
+	public static byte getDistanceRenderingInverse(int distance)
+	{
+		return baseInverse(distance, minDrawDetail);
+	}
+
+	public static byte getDistanceGenerationInverse(int distance)
+	{
+		return baseInverse((int) (distance * genMultiplier), minGenDetail);
+	}
+
+	public static byte getDistanceTreeCutInverse(int distance)
+	{
+		return baseInverse((int) (distance * treeCutMultiplier), minGenDetail);
+	}
+
+
+	public static byte getDistanceTreeGenInverse(int distance)
+	{
+		return baseInverse((int) (distance * treeGenMultiplier), minGenDetail);
+	}
+
+	public static int getDistanceGeneration(int detail)
+	{
+		if (detail == maxDetail)
+			return maxDistance;
+		return (int) (getDistanceRendering(detail) * genMultiplier);
+	}
+
+	public static int getDistanceTreeCut(int detail)
+	{
+		if (detail == maxDetail)
+			return maxDistance;
+		return (int) (getDistanceRendering(detail) * treeCutMultiplier);
+	}
+
+	public static int getDistanceTreeGen(int detail)
+	{
+		if (detail == maxDetail)
+			return maxDistance;
+		return (int) (getDistanceRendering(detail) * treeGenMultiplier);
+	}
+
+	public static DistanceGenerationMode getDistanceGenerationMode(int detail)
+	{
+		return LodConfig.CLIENT.worldGenerator.distanceGenerationMode.get();
+	}
+
+	public static byte getLodDrawDetail(int detail)
+	{
+		return (byte) Math.max(detail, minDrawDetail);
+	}
+
+	public static LodDetail 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 boolean regionInView(int playerPosX, int playerPosY, int playerPosZ, int xRot, int yRot, int fov, RegionPos regionPos)
+	{
+
+		//System.out.println(Math.floorMod((int) mc.player.xRot,360) + " " + Math.floorMod((int) mc.player.yRot,360) + " " + mc.options.fov);
+		//System.out.println(mc.player.xRotO + " " + mc.player.yRotO);
+		//mc.options.fov;
+		return false;
+	}
+
+}

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

@@ -19,30 +19,91 @@ package com.seibel.lod.util;
 
 import java.awt.Color;
 import java.io.File;
+import java.util.HashSet;
 
-import com.seibel.lod.objects.LodRegion;
+import com.seibel.lod.objects.DataPoint;
+import com.seibel.lod.objects.LodDimension;
 import com.seibel.lod.objects.RegionPos;
+import com.seibel.lod.wrappers.MinecraftWrapper;
 
-import net.minecraft.client.Minecraft;
+import it.unimi.dsi.fastutil.objects.ObjectList;
 import net.minecraft.client.multiplayer.ServerData;
+import net.minecraft.client.renderer.WorldRenderer;
+import net.minecraft.client.renderer.WorldRenderer.LocalRenderInformationContainer;
 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 that may be used in multiple places.
+ * This class holds methods and constants that may be used in multiple places.
  * 
  * @author James Seibel
- * @version 06-27-2021
+ * @version 9-7-2021
  */
 public class LodUtil
 {
-	private static Minecraft mc = Minecraft.getInstance();
+	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));
+	
+	/**
+	 * 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;
+	
+	/** 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 = "[\\\\\\/:*?\\\"<>|]";
+	
 	
 	
 	
@@ -60,7 +121,7 @@ public class LodUtil
 		
 		for (ServerWorld world : worlds)
 			return world;
-				
+		
 		return null;
 	}
 	
@@ -86,32 +147,30 @@ public class LodUtil
 				break;
 			}
 		}
-				
+		
 		return returnWorld;
 	}
 	
 	/**
-	 * Convert the given ChunkPos into a RegionPos.
+	 * Convert a 2D absolute position into a quad tree relative position. 
 	 */
-	public static RegionPos convertChunkPosToRegionPos(ChunkPos pos)
+	public static RegionPos convertGenericPosToRegionPos(int x, int z, int detailLevel)
 	{
-		RegionPos rPos = new RegionPos();
-		rPos.x = pos.x / LodRegion.SIZE;
-		rPos.z = pos.z / LodRegion.SIZE;
+		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));
 		
-		// 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 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.
@@ -133,80 +192,9 @@ public class LodUtil
 	
 	
 	
-	public static String getCurrentDimensionID()
-	{
-
-		Minecraft mc = Minecraft.getInstance();
-		
-		if(mc.hasSingleplayerServer())
-		{
-			// this will return the world save location
-			// and the dimension folder
-			
-			if(mc.level == null)
-				return "";
-			
-			ServerWorld serverWorld = LodUtil.getServerWorldFromDimension(mc.level.dimensionType());
-			if(serverWorld == null)
-				return "";
-			
-			ServerChunkProvider provider = serverWorld.getChunkSource();
-			if(provider == null)
-				return "";
-			
-			return provider.dataStorage.dataFolder.toString();
-		}
-		else
-		{
-			ServerData server = mc.getCurrentServer();
-			return server.name + ", IP " + 
-					server.ip + ", GameVersion " + 
-					server.version.getString() + File.separatorChar
-					+ "dim_" + mc.level.dimensionType().effectsLocation().getPath() + File.separatorChar;
-		}
-	}
-
-	
 	/**
 	 * 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.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
-		{
-			ServerData server = mc.getCurrentServer();
-			return server.name + ", IP " + 
-					server.ip + ", GameVersion " + 
-					server.version.getString() + File.separatorChar
-					+ "dim_" + world.dimensionType().effectsLocation().getPath() + File.separatorChar;
-		}
-	}
-	
-	/**
-	 * If on single player this will return the name of the user's
-	 * world, if in multiplayer it will return the server name
+	 * world, if in multiplayer it will return the server name, IP,
 	 * and game version.
 	 */
 	public static String getWorldID(IWorld world)
@@ -224,15 +212,60 @@ public class LodUtil
 		}
 		else
 		{
-			ServerData server = mc.getCurrentServer();
-			return server.name + ", IP " + 
-					server.ip + ", GameVersion " + 
-					server.version.getString();
+			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.
 	 */
@@ -254,4 +287,104 @@ public class LodUtil
 	{
 		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.getData(LodUtil.CHUNK_DETAIL_LEVEL, x, z);
+
+					short lodAverageHeight = DataPoint.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();
+		ObjectList<LocalRenderInformationContainer> chunks = renderer.renderChunks;
+		for (WorldRenderer.LocalRenderInformationContainer worldrenderer$localrenderinformationcontainer : chunks)
+		{
+			if (!worldrenderer$localrenderinformationcontainer.chunk.getCompiledChunk().hasNoRenderableLayers())
+			{
+				// add the ChunkPos for every empty compiled chunk
+				BlockPos bpos = worldrenderer$localrenderinformationcontainer.chunk.getOrigin();
+				
+				loadedPos.add(new ChunkPos(bpos));
+			}
+		}
+		
+		
+		return loadedPos;
+	}
+	
+	
 }

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

@@ -0,0 +1,137 @@
+package com.seibel.lod.wrappers;
+
+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.WorldRenderer;
+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-6-2021
+ */
+public class MinecraftWrapper
+{
+	public static MinecraftWrapper INSTANCE = new MinecraftWrapper();
+	
+	private Minecraft mc = Minecraft.getInstance();
+	
+	private MinecraftWrapper()
+	{
+		
+	}
+	
+	
+	
+	//=================//
+	// 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);
+	}
+	
+	
+	
+	
+	//=============//
+	// Simple gets //
+	//=============//
+	
+	public ClientPlayerEntity getPlayer()
+	{
+		return mc.player;
+	}
+	
+	public GameSettings getOptions()
+	{
+		return mc.options;
+	}
+	
+	/** 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/mods.toml

@@ -11,10 +11,10 @@ loaderVersion="[36,)" #mandatory This is typically bumped every Minecraft versio
 
 #// 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.3" #mandatory
+version="a1.4.1" #mandatory
 
 #// A display name for the mod
-displayName="Level 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 and Leonardo Amato" #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 Detail",
-  "description": "Generates and renders simplified chunks beyond the normal view distance, at a low performance cost.",
-  "version": "a1.3",
-  "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."
     }