Move max generation distance check functionality to render distance config

api/src/main/java/com/seibel/distanthorizons/api/enums/config/EDhApiDataCompressionMode.java

@@ -39,8 +39,8 @@ public enum EDhApiDataCompressionMode
 	/** 
 	 * Should only be used internally and for unit testing. <br><br> 
 	 * 
-	 * Read Speed: 6.09 MS / DTO <br>
-	 * Write Speed: 6.01 MS / DTO <br>
+	 * Read Speed: 1.64 MS / DTO <br>
+	 * Write Speed: 12.44 MS / DTO <br>
 	 * Compression ratio: 1.0 <br>
 	 */
 	@DisallowSelectingViaConfigGui
@@ -49,28 +49,28 @@ public enum EDhApiDataCompressionMode
 	/** 
 	 * Extremely fast (often faster than uncompressed), but generally poor compression. <br><br> 
 	 * 
-	 * Read Speed: 3.25 MS / DTO <br>
-	 * Write Speed: 5.99 MS / DTO <br>
-	 * Compression ratio: 0.4513 <br>
+	 * Read Speed: 1.85 MS / DTO <br>
+	 * Write Speed: 9.46 MS / DTO <br>
+	 * Compression ratio: 0.3638 <br>
 	 */
 	LZ4(1),
 	
-	/**
+	/*
 	 * Decent speed and good compression. <br><br> 
 	 *
-	 * Read Speed: 9.31 MS / DTO <br>
-	 * Write Speed: 15.13 MS / DTO <br>
-	 * Compression ratio: 0.2606 <br>
+	 * Read Speed: 11.78 MS / DTO <br>
+	 * Write Speed: 16.76 MS / DTO <br>
+	 * Compression ratio: 0.2199 <br>
 	 */
-	Z_STD(2),
-	
+	//@Deprecated
+	//Z_STD(2),
 	
 	/** 
 	 * Extremely slow, but very good compression. <br><br> 
 	 *
-	 * Read Speed: 13.29 MS / DTO <br>
-	 * Write Speed: 70.95 MS / DTO <br>
-	 * Compression ratio: 0.2068 <br>
+	 * Read Speed: 12.25 MS / DTO <br>
+	 * Write Speed: 490.07 MS / DTO <br>
+	 * Compression ratio: 0.1242 <br>
 	 */
 	LZMA2(3);
 	

api/src/main/java/com/seibel/distanthorizons/api/enums/config/EDhApiLoggerMode.java

@@ -40,7 +40,6 @@ public enum EDhApiLoggerMode
 	LOG_DEBUG_TO_CHAT_AND_FILE(Level.DEBUG, Level.DEBUG),
 	LOG_WARNING_TO_CHAT_AND_INFO_TO_FILE(Level.INFO, Level.WARN),
 	LOG_ERROR_TO_CHAT_AND_INFO_TO_FILE(Level.INFO, Level.ERROR),
-	LOG_ERROR_TO_CHAT_AND_WARNING_TO_FILE(Level.ERROR, Level.WARN),
 	;
 	
 	public final Level levelForFile;

api/src/main/java/com/seibel/distanthorizons/api/methods/events/abstractEvents/DhApiChunkProcessingEvent.java

@@ -1,197 +0,0 @@
-/*
- *    This file is part of the Distant Horizons mod
- *    licensed under the GNU LGPL 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 Lesser 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 Lesser General Public License for more details.
- *
- *    You should have received a copy of the GNU Lesser General Public License
- *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
- */
-
-package com.seibel.distanthorizons.api.methods.events.abstractEvents;
-
-import com.seibel.distanthorizons.api.interfaces.block.IDhApiBiomeWrapper;
-import com.seibel.distanthorizons.api.interfaces.block.IDhApiBlockStateWrapper;
-import com.seibel.distanthorizons.api.interfaces.factories.IDhApiWrapperFactory;
-import com.seibel.distanthorizons.api.interfaces.world.IDhApiLevelWrapper;
-import com.seibel.distanthorizons.api.methods.events.interfaces.IDhApiEvent;
-import com.seibel.distanthorizons.api.methods.events.interfaces.IDhApiEventParam;
-import com.seibel.distanthorizons.api.methods.events.sharedParameterObjects.DhApiEventParam;
-
-/**
- * Used to override which blocks may be stored in a given chunk.
- * This can be used for X-ray prevention or to replace problematic mod blocks
- * that don't fit into the {@link IDhApiBlockStateWrapper} format DH requires
- * (IE modded blocks that use NBT data
- * to determine their model and/or texture). <br/><br/>
- *
- * This event is fired for each block or biome change when DH is processing a chunk.
- * A change happens when DH finds a different block or biome while walking through a chunk.
- * For example with the block sequence:<br/>
- * <code> stone -> stone -> air -> stone </code> <br/>
- * This event would be fired for the first, third, and forth blocks in the sequence
- * (IE the first stone, first air, and last stone respectively). <br/> <br/>
- * 
- * The order DH will process blocks is undefined so a specific ordering shouldn't be relied upon for your logic to function. <br/> <br/>
- * 
- * <b>Threading note:</b> this event may be called concurrently across multiple threads. <br/>
- * <b>Performance note:</b> this event will be called very frequently, avoid expensive lookups or other slow operations if possible. <br/>
- * 
- * @see DhApiLevelLoadEvent
- * @see IDhApiWrapperFactory
- *
- * @author James Seibel
- * @version 2025-09-29
- * @since API 4.1.0
- */
-public abstract class DhApiChunkProcessingEvent implements IDhApiEvent<DhApiChunkProcessingEvent.EventParam>
-{
-	public abstract void blockOrBiomeChangedDuringChunkProcessing(DhApiEventParam<EventParam> event);
-	
-	
-	//=========================//
-	// internal DH API methods //
-	//=========================//
-	
-	@Override
-	public final void fireEvent(DhApiEventParam<EventParam> event) { this.blockOrBiomeChangedDuringChunkProcessing(event); }
-	
-	
-	//==================//
-	// parameter object //
-	//==================//
-	
-	public static class EventParam implements IDhApiEventParam
-	{
-		/** The saved level. */
-		public final IDhApiLevelWrapper levelWrapper;
-		
-		/** the processed chunk's X pos in chunk coordinates */
-		public final int chunkX;
-		/** the processed chunk's Z pos in chunk coordinates */
-		public final int chunkZ;
-		
-		
-		public int relativeBlockPosX;
-		public int blockPosY;
-		public int relativeBlockPosZ;
-		
-		public IDhApiBlockStateWrapper currentBlock;
-		public IDhApiBiomeWrapper currentBiome;
-		
-		private IDhApiBlockStateWrapper newBlock;
-		private IDhApiBiomeWrapper newBiome;
-		
-		
-		
-		//=============//
-		// constructor //
-		//=============//
-		
-		public EventParam(IDhApiLevelWrapper newLevelWrapper, int chunkX, int chunkZ)
-		{
-			this.levelWrapper = newLevelWrapper;
-			this.chunkX = chunkX;
-			this.chunkZ = chunkZ;
-		}
-		
-		/** 
-		 * Internal method use by Distant Horizons
-		 * to set up this event.
-		 */
-		public void updateForPosition(
-				int relativeBlockPosX, int blockPosY, int relativeBlockPosZ,
-				IDhApiBlockStateWrapper currentBlock,
-				IDhApiBiomeWrapper currentBiome)
-		{
-			this.relativeBlockPosX = relativeBlockPosX;
-			this.blockPosY = blockPosY;
-			this.relativeBlockPosZ = relativeBlockPosZ;
-			
-			this.newBlock = null;
-			this.newBiome = null;
-			
-			this.currentBlock = currentBlock;
-			this.currentBiome = currentBiome;
-		}
-		
-		
-		
-		//=================//
-		// getters/setters //
-		//=================//
-		
-		/**
-		 * Sets the {@link IDhApiBlockStateWrapper} that should be used at this event's current position in the chunk.
-		 * If you don't want to modify the block at this event's current position, 
-		 * either don't call this method or pass in null. <br>
-		 * Passing in null will remove the override, meaning the original block will be used. <br><br>
-		 *
-		 * A {@link IDhApiWrapperFactory} should be used to get the {@link IDhApiBlockStateWrapper} that's returned. 
-		 * Attempting to create your own {@link IDhApiBlockStateWrapper} will cause a {@link ClassCastException}. <br/> <br/>
-		 *
-		 * If multiple API users are listening to this event the override may already have been set.
-		 * With that in mind it is recommended to check if an override has already been set via
-		 * {@link EventParam#getBlockOverride()} to handle that occurrence. <br>
-		 * Note that the order of API events firing is undefined so a specific order shouldn't be relied upon. <br><br>
-		 * 
-		 * @see IDhApiWrapperFactory
-		 */
-		public void setBlockOverride(IDhApiBlockStateWrapper block) { this.newBlock = block; }
-		/** 
-		 * Returns the currently overriding block for this position.
-		 * This will be null if no other API event has set the override.
-		 */
-		public IDhApiBlockStateWrapper getBlockOverride() { return this.newBlock; }
-		
-		
-		
-		/**
-		 * Sets the {@link IDhApiBiomeWrapper} that should be used at this event's current position in the chunk.
-		 * If you don't want to modify the biome at this event's current position, 
-		 * either don't call this method or pass in null. <br>
-		 * Passing in null will remove the override, meaning the original biome will be used. <br><br>
-		 *
-		 * A {@link IDhApiWrapperFactory} should be used to get the {@link IDhApiBiomeWrapper} that's returned. 
-		 * Attempting to create your own {@link IDhApiBiomeWrapper} will cause a {@link ClassCastException}. <br/> <br/>
-		 *
-		 * If multiple API users are listening to this event the override may already have been set.
-		 * With that in mind it is recommended to check if an override has already been set via
-		 * {@link EventParam#getBiomeOverride()} ()} to handle that occurrence. <br>
-		 * Note that the order of API events firing is undefined so a specific order shouldn't be relied upon. <br><br>
-		 *
-		 * @see IDhApiWrapperFactory
-		 */
-		public void setBiomeOverride(IDhApiBiomeWrapper biome) { this.newBiome = biome; }
-		/**
-		 * Returns the currently overriding biome for this position.
-		 * This will be null if no other API event has set the override.
-		 */
-		public IDhApiBiomeWrapper getBiomeOverride() { return this.newBiome; }
-		
-		
-		
-		/** 
-		 * Returns the same instance of this event.
-		 * Copying this event isn't recommended due to 
-		 * how often it would be called per chunk, creating
-		 * unnecessary garbage collector pressure.
-		 */
-		@Override
-		public EventParam copy() { return this; }
-		
-		@Override 
-		public boolean getCopyBeforeFire() { return false; }
-		
-	}
-	
-}

api/src/main/java/com/seibel/distanthorizons/api/methods/events/interfaces/IDhApiEventParam.java

@@ -9,23 +9,5 @@ import com.seibel.distanthorizons.api.interfaces.util.IDhApiCopyable;
  */
 public interface IDhApiEventParam extends IDhApiCopyable
 {
-	/** 
-	 * Internal DH use. <br> <br>
-	 * 
-	 * Most API events will clone their parameters
-	 * before firing to prevent API implementors
-	 * from modifying the properties causing
-	 * any subsequent listeners to see the wrong data. <br><br>
-	 * 
-	 * However, this can be overridden for API events that shouldn't 
-	 * be cloned before firing.
-	 * Generally that would be done for performance reasons
-	 * where an event may fire hundreds or thousands of times 
-	 * in quick succession or where the event parameter is needed
-	 * internally by DH after firing.
-	 * 
-	 * @since API 4.1.0 
-	 */
-	default boolean getCopyBeforeFire() { return true; }
 	
 }

api/src/main/java/com/seibel/distanthorizons/coreapi/DependencyInjection/ApiEventInjector.java

@@ -143,23 +143,19 @@ public class ApiEventInjector extends DependencyInjector<IDhApiEvent> implements
 					
 					
 					// attempt to clone the event input if possible
-					// this is done to reduce the likelihood that one event listener 
-					// will change the event parameter for other listeners 
+					// this is done to reduce the likely hood that one event listener 
+					// will make change the event parameter for other listeners 
 					T input = eventInput;
 					if (eventInput instanceof IDhApiEventParam)
 					{
-						IDhApiEventParam dhApiEventParam = (IDhApiEventParam) eventInput;
-						if (dhApiEventParam.getCopyBeforeFire())
+						try
 						{
-							try
-							{
-								//noinspection unchecked
-								input = (T) dhApiEventParam.copy();
-							}
-							catch (Exception e)
-							{
-								LOGGER.error("Unable to clone event parameter [" + eventInput.getClass().getSimpleName() + "], error: [" + e.getMessage() + "].", e);
-							}
+							//noinspection unchecked
+							input = (T) ((IDhApiEventParam) eventInput).copy();
+						}
+						catch (Exception e)
+						{
+							LOGGER.error("Unable to clone event parameter ["+eventInput.getClass().getSimpleName()+"], error: ["+e.getMessage()+"].", e);
 						}
 					}
 					

api/src/main/java/com/seibel/distanthorizons/coreapi/DependencyInjection/DependencyInjector.java

@@ -43,9 +43,11 @@ public class DependencyInjector<BindableType extends IBindable> implements IDepe
 	protected final boolean allowDuplicateBindings;
 	
 	
-	//==============//
-	// constructors //
-	//==============//
+	public DependencyInjector(Class<BindableType> newBindableInterface)
+	{
+		this.bindableInterface = newBindableInterface;
+		this.allowDuplicateBindings = false;
+	}
 	
 	public DependencyInjector(Class<BindableType> newBindableInterface, boolean newAllowDuplicateBindings)
 	{
@@ -55,16 +57,12 @@ public class DependencyInjector<BindableType extends IBindable> implements IDepe
 	
 	
 	
-	//=========//
-	// binding //
-	//=========//
 	
 	@Override
 	public void bind(Class<? extends BindableType> dependencyInterface, BindableType dependencyImplementation) throws IllegalStateException, IllegalArgumentException
 	{
 		// duplicate check if requested
-		if (this.dependencies.containsKey(dependencyInterface) 
-			&& !this.allowDuplicateBindings)
+		if (this.dependencies.containsKey(dependencyInterface) && !this.allowDuplicateBindings)
 		{
 			throw new IllegalStateException("The dependency [" + dependencyInterface.getSimpleName() + "] has already been bound.");
 		}
@@ -132,54 +130,6 @@ public class DependencyInjector<BindableType extends IBindable> implements IDepe
 	public boolean checkIfClassExtends(Class<?> classToTest, Class<?> extensionToLookFor) { return extensionToLookFor.isAssignableFrom(classToTest); }
 	
 	
-	
-	//===========//
-	// unbinding //
-	//===========//
-	
-	// TODO having a bindOrReplace method would probably be better since it wouldn't have the possiblity of having nothing bound
-	public void unbind(Class<? extends BindableType> dependencyInterface, BindableType dependencyImplementation) throws IllegalStateException, IllegalArgumentException
-	{
-		// check if this object is bound
-		if (!this.dependencies.containsKey(dependencyInterface))
-		{
-			return;
-		}
-		
-		
-		// make sure the given dependency implements the necessary interfaces
-		boolean implementsInterface = this.checkIfClassImplements(dependencyImplementation.getClass(), dependencyInterface)
-				|| this.checkIfClassExtends(dependencyImplementation.getClass(), dependencyInterface);
-		boolean implementsBindable = this.checkIfClassImplements(dependencyImplementation.getClass(), this.bindableInterface);
-		
-		// display any errors
-		if (!implementsInterface)
-		{
-			throw new IllegalArgumentException("The dependency [" + dependencyImplementation.getClass().getSimpleName() + "] doesn't implement or extend: [" + dependencyInterface.getSimpleName() + "].");
-		}
-		if (!implementsBindable)
-		{
-			throw new IllegalArgumentException("The dependency [" + dependencyImplementation.getClass().getSimpleName() + "] doesn't implement the interface: [" + IBindable.class.getSimpleName() + "].");
-		}
-		
-		
-		// make sure the hashSet has an array to hold the dependency
-		if (!this.dependencies.containsKey(dependencyInterface))
-		{
-			this.dependencies.put(dependencyInterface, new ArrayList<BindableType>());
-		}
-		
-		// remove the dependency if present
-		this.dependencies.get(dependencyInterface).remove(dependencyImplementation);
-		this.dependencies.remove(dependencyInterface);
-	}
-	
-	
-	
-	//=========//
-	// getters //
-	//=========//
-	
 	@SuppressWarnings("unchecked")
 	@Override
 	public <T extends BindableType> T get(Class<T> interfaceClass) throws ClassCastException

api/src/main/java/com/seibel/distanthorizons/coreapi/ModInfo.java

@@ -38,7 +38,7 @@ public final class ModInfo
 	public static final String NAME = "DistantHorizons";
 	/** Human-readable version of NAME */
 	public static final String READABLE_NAME = "Distant Horizons";
-	public static final String VERSION = "2.3.5-b";
+	public static final String VERSION = "2.3.3-b-dev";
 	/** Returns true if the current build is an unstable developer build, false otherwise. */
 	public static final boolean IS_DEV_BUILD = VERSION.toLowerCase().contains("dev");
 	

api/src/main/java/com/seibel/distanthorizons/coreapi/interfaces/config/IConfigEntry.java

@@ -36,15 +36,12 @@ public interface IConfigEntry<T>
 	
 	void setApiValue(T newApiValue);
 	T getApiValue();
-	/** @return true if this config is able to be overridden by the API and an API user has set it */
-	boolean apiIsOverriding();
 	
 	/** Returns true if this config can be set via the API. */
 	boolean getAllowApiOverride();
 	
 	void set(T newValue);
 	T get();
-	/** gets the option ignoring what the API has overridden */
 	T getTrueValue();
 	
 	/** Sets the value without saving */

api/src/main/java/com/seibel/distanthorizons/coreapi/util/converters/RenderModeEnabledConverter.java

@@ -31,12 +31,14 @@ import com.seibel.distanthorizons.coreapi.interfaces.config.IConverter;
 public class RenderModeEnabledConverter implements IConverter<EDhApiRendererMode, Boolean>
 {
 	
-	@Override 
-	public EDhApiRendererMode convertToCoreType(Boolean renderingEnabled)
-	{ return renderingEnabled ? EDhApiRendererMode.DEFAULT : EDhApiRendererMode.DISABLED; }
+	@Override public EDhApiRendererMode convertToCoreType(Boolean renderingEnabled)
+	{
+		return renderingEnabled ? EDhApiRendererMode.DEFAULT : EDhApiRendererMode.DISABLED;
+	}
 	
-	@Override 
-	public Boolean convertToApiType(EDhApiRendererMode renderingMode)
-	{ return renderingMode == EDhApiRendererMode.DEFAULT; }
+	@Override public Boolean convertToApiType(EDhApiRendererMode renderingMode)
+	{
+		return renderingMode == EDhApiRendererMode.DEFAULT;
+	}
 	
 }

core/build.gradle

@@ -61,9 +61,3 @@ shadowJar {
 //    relocate "it.unimi.dsi.fastutil", "${librariesLocation}.unimi.dsi.fastutil"
     mergeServiceFiles()
 }
-
-test {
-    // this is necessary specifically for the Compression tests since those
-    // need more than the default 512 MB of RAM
-    jvmArgs '-Xmx4096m'
-}

core/src/main/java/com/seibel/distanthorizons/core/Initializer.java

@@ -19,7 +19,6 @@
 
 package com.seibel.distanthorizons.core;
 
-import com.github.luben.zstd.ZstdOutputStream;
 import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
 import com.seibel.distanthorizons.core.render.renderer.generic.GenericRenderObjectFactory;
 import com.seibel.distanthorizons.core.sql.DatabaseUpdater;
@@ -55,9 +54,8 @@ public class Initializer
 		{
 			// if any library isn't present in the jar its class
 			// will throw an error (not an exception)
-			Class<?> lz4Compressor = LZ4FrameOutputStream.class;
-			Class<?> zstdCompressor = ZstdOutputStream.class;
-			Class<?> lzmaCompressor = XZOutputStream.class;
+			Class<?> fastCompressor = LZ4FrameOutputStream.class;
+			Class<?> smallCompressor = XZOutputStream.class;
 			//Class<?> networking = ByteBuf.class;
 			Class<?> config = com.electronwill.nightconfig.core.Config.class;
 			Class<?> oldFastUtil = it.unimi.dsi.fastutil.longs.LongArrayList.class; // available in 8.2.1
@@ -65,6 +63,30 @@ public class Initializer
 			Class<?> sqliteJava = org.sqlite.SQLiteConnection.class;
 			Class<?> sqliteNative = org.sqlite.core.NativeDB.class;
 			
+			//// maybe these lines are needed to shade SQLite, James isn't sure.
+			//// Although they never seemed to fail, which is a bit odd.
+			//try
+			//{
+			//	// needed by Forge to load the Java database connection
+			//	Class.forName("org.sqlite.JDBC");
+			//	LOGGER.info("loaded normal SQLITE");
+			//}
+			//catch (ClassNotFoundException e)
+			//{
+			//	LOGGER.warn("normal: " + e.getMessage(), e);
+			//}
+			//
+			//try
+			//{
+			//	// needed by Forge to load the Java database connection
+			//	Class.forName("DistantHorizons.libraries.sqlite.JDBC");
+			//	LOGGER.info("loaded shaded SQLITE");
+			//}
+			//catch (ClassNotFoundException e)
+			//{
+			//	LOGGER.warn("shaded: " + e.getMessage(), e);
+			//}
+			
 			boolean sqliteLoaded = SQLiteJDBCLoader.initialize();
 			if (!sqliteLoaded)
 			{

core/src/main/java/com/seibel/distanthorizons/core/api/external/methods/config/client/DhApiGraphicsConfig.java

@@ -26,7 +26,6 @@ import com.seibel.distanthorizons.api.interfaces.config.client.*;
 import com.seibel.distanthorizons.api.objects.config.DhApiConfigValue;
 import com.seibel.distanthorizons.api.enums.rendering.EDhApiRendererMode;
 import com.seibel.distanthorizons.core.config.Config;
-import com.seibel.distanthorizons.coreapi.util.converters.RenderModeEnabledConverter;
 
 public class DhApiGraphicsConfig implements IDhApiGraphicsConfig
 {
@@ -61,7 +60,7 @@ public class DhApiGraphicsConfig implements IDhApiGraphicsConfig
 	
 	@Override
 	public IDhApiConfigValue<Boolean> renderingEnabled()
-	{ return new DhApiConfigValue<EDhApiRendererMode, Boolean>(Config.Client.Advanced.Debugging.rendererMode, new RenderModeEnabledConverter()); }
+	{ return new DhApiConfigValue<Boolean, Boolean>(Config.Client.quickEnableRendering); }
 	
 	@Override
 	public IDhApiConfigValue<EDhApiRendererMode> renderingMode()

core/src/main/java/com/seibel/distanthorizons/core/api/external/methods/data/DhApiTerrainDataRepo.java

@@ -503,7 +503,7 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 		
 		// this will throw a cast exception if the chunk object array isn't correct
 		IChunkWrapper chunk = SingletonInjector.INSTANCE.get(IWrapperFactory.class).createChunkWrapper(chunkObjectArray);
-		SharedApi.INSTANCE.applyChunkUpdate(chunk, dhLevel.getLevelWrapper(), true, true);
+		SharedApi.INSTANCE.applyChunkUpdate(chunk, dhLevel.getLevelWrapper(), true);
 		
 		
 		return DhApiResult.createSuccess();

core/src/main/java/com/seibel/distanthorizons/core/api/internal/ClientApi.java

@@ -24,7 +24,6 @@ import com.seibel.distanthorizons.api.enums.config.EDhApiMcRenderingFadeMode;
 import com.seibel.distanthorizons.api.enums.rendering.EDhApiRenderPass;
 import com.seibel.distanthorizons.api.methods.events.abstractEvents.*;
 import com.seibel.distanthorizons.api.methods.events.sharedParameterObjects.DhApiRenderParam;
-import com.seibel.distanthorizons.core.api.internal.rendering.RenderState;
 import com.seibel.distanthorizons.core.file.structure.ClientOnlySaveStructure;
 import com.seibel.distanthorizons.core.network.messages.MessageRegistry;
 import com.seibel.distanthorizons.core.pos.DhChunkPos;
@@ -90,15 +89,6 @@ public class ClientApi
 	/** this includes the is dev build message and low allocated memory warning */
 	private static final int MS_BETWEEN_STATIC_STARTUP_MESSAGES = 4_000;
 	
-	/** 
-	 * This isn't the cleanest way of storing variables before passing them to the LOD renderer, 
-	 * but due to how mixins work and the inconsistency between MC versions,
-	 * having a static object that stores a single frame's data
-	 * is often the easiest solution. <br><br>
-	 * 
-	 * Only downside is making sure each variable is populated before rendering.
-	 */
-	public static final RenderState RENDER_STATE = new RenderState();
 	
 	
 	private boolean isDevBuildMessagePrinted = false;
@@ -399,28 +389,21 @@ public class ClientApi
 	// rendering //
 	//===========//
 	
-	/** Should be called before {@link ClientApi#renderDeferredLodsForShaders} */
-	public void renderLods() { this.renderLodLayer(false); }
+	/** Should be called before {@link ClientApi#renderDeferredLods} */
+	public void renderLods(IClientLevelWrapper levelWrapper, Mat4f mcModelViewMatrix, Mat4f mcProjectionMatrix, float partialTicks)
+	{ this.renderLodLayer(levelWrapper, mcModelViewMatrix, mcProjectionMatrix, partialTicks, false); }
 	
 	/** 
 	 * Only necessary when Shaders are in use.
 	 * Should be called after {@link ClientApi#renderLods} 
 	 */
-	public void renderDeferredLodsForShaders() { this.renderLodLayer(true); }
+	public void renderDeferredLods(IClientLevelWrapper levelWrapper, Mat4f mcModelViewMatrix, Mat4f mcProjectionMatrix, float partialTicks)
+	{ this.renderLodLayer(levelWrapper, mcModelViewMatrix, mcProjectionMatrix, partialTicks, true); }
 	
-	private void renderLodLayer(boolean renderingDeferredLayer)
+	private void renderLodLayer(
+			IClientLevelWrapper levelWrapper, Mat4f mcModelViewMatrix, Mat4f mcProjectionMatrix, float partialTicks,
+			boolean renderingDeferredLayer)
 	{
-		// A global render state variable is used since MC has split up their
-		// render prep and actual rendering into different threads/methods
-		// this is annoying since it's possible to start a render with only
-		// partially complete info, but there isn't a better option at the moment
-		IClientLevelWrapper levelWrapper = RENDER_STATE.clientLevelWrapper;
-		Mat4f mcModelViewMatrix = RENDER_STATE.mcModelViewMatrix;
-		Mat4f mcProjectionMatrix = RENDER_STATE.mcProjectionMatrix;
-		float partialTicks = RENDER_STATE.frameTime;
-		
-		
-		
 		// logging //
 		
 		this.sendQueuedChatMessages();
@@ -462,25 +445,6 @@ public class ClientApi
 		
 		
 		
-		//Mat4f mcCombined = mcModelViewMatrix.copy();
-		//mcCombined.multiply(mcProjectionMatrix);
-		//
-		//com.seibel.distanthorizons.api.objects.math.DhApiMat4f dhCombined = renderEventParam.dhModelViewMatrix.copy();
-		//dhCombined.multiply(renderEventParam.dhProjectionMatrix);
-		//
-		//LOGGER.info("\n\n" +
-		//		"API\n" +
-		//		"Mc MVM: \n" + mcModelViewMatrix.toString() + "\n" +
-		//		"Mc Proj: \n" + mcProjectionMatrix + "\n" +
-		//		"Mc Combined:\n" + mcCombined.toString() + "\n" +
-		//		"\n" +
-		//		"DH MVM: \n" + renderEventParam.dhModelViewMatrix.toString() + "\n" +
-		//		"DH Proj: \n" + renderEventParam.dhProjectionMatrix + "\n" +
-		//		"DH Combined:\n" + mcCombined.toString()
-		//);
-		
-		
-		
 		// render validation //
 		
 		try
@@ -587,44 +551,28 @@ public class ClientApi
 		}
 	}
 	
-	/** 
-	 * The first fade pass.
-	 * Called after MC finishes rendering the opaque passes. 
-	 */
-	public void renderFadeOpaque()
-	{
-		// only fade when DH is rendering
-		if (Config.Client.Advanced.Debugging.rendererMode.get() == EDhApiRendererMode.DEFAULT
-			// only fade when requested
-			&& Config.Client.Advanced.Graphics.Quality.vanillaFadeMode.get() == EDhApiMcRenderingFadeMode.DOUBLE_PASS
-			// don't fade when Iris shaders are active, otherwise the rendering can get weird
-			&& !DhApiRenderProxy.INSTANCE.getDeferTransparentRendering())
-		{
-			FadeRenderer.INSTANCE.render(RENDER_STATE.mcModelViewMatrix, RENDER_STATE.mcProjectionMatrix, RENDER_STATE.frameTime, RENDER_STATE.clientLevelWrapper);
-		}
-	}
-	/** 
-	 * The second fade pass.
-	 * Called after MC finishes rendering both opaque
-	 * and transparent passes. 
-	 */
-	public void renderFadeTransparent()
+	/** should be called after DH and MC finish rendering so we can smooth the transition between the two */
+	public void renderFadeOpaque(Mat4f mcModelViewMatrix, Mat4f mcProjectionMatrix, float partialTicks, IClientLevelWrapper level)
 	{
 		// only fade when DH is rendering
 		if (Config.Client.Advanced.Debugging.rendererMode.get() == EDhApiRendererMode.DEFAULT)
 		{
-			boolean renderFade =
-				(
-					// only fade when requested
-					Config.Client.Advanced.Graphics.Quality.vanillaFadeMode.get() != EDhApiMcRenderingFadeMode.NONE
-					// or if LOD-only mode is enabled (fading is used to remove the MC render pass)
-					|| Config.Client.Advanced.Debugging.lodOnlyMode.get()
-				)
-				// don't fade when Iris shaders are active, otherwise the rendering can get weird
-				&& !DhApiRenderProxy.INSTANCE.getDeferTransparentRendering();
-			if (renderFade)
+			if (Config.Client.Advanced.Graphics.Quality.vanillaFadeMode.get() == EDhApiMcRenderingFadeMode.DOUBLE_PASS)
 			{
-				FadeRenderer.INSTANCE.render(RENDER_STATE.mcModelViewMatrix, RENDER_STATE.mcProjectionMatrix, RENDER_STATE.frameTime, RENDER_STATE.clientLevelWrapper);
+				FadeRenderer.INSTANCE.render(mcModelViewMatrix, mcProjectionMatrix, partialTicks, level);
+			}
+		}
+	}
+	/** should be called after DH and MC finish rendering so we can smooth the transition between the two */
+	public void renderFade(Mat4f mcModelViewMatrix, Mat4f mcProjectionMatrix, float partialTicks, IClientLevelWrapper level)
+	{
+		// only fade when DH is rendering
+		if (Config.Client.Advanced.Debugging.rendererMode.get() == EDhApiRendererMode.DEFAULT)
+		{
+			// fade if any level fading is active
+			if (Config.Client.Advanced.Graphics.Quality.vanillaFadeMode.get() != EDhApiMcRenderingFadeMode.NONE)
+			{
+				FadeRenderer.INSTANCE.render(mcModelViewMatrix, mcProjectionMatrix, partialTicks, level);
 			}
 		}
 	}
@@ -704,8 +652,7 @@ public class ClientApi
 	private void detectAndSendBootTimeWarnings()
 	{
 		// dev build
-		if (ModInfo.IS_DEV_BUILD 
-			&& !this.isDevBuildMessagePrinted && MC_CLIENT.playerExists())
+		if (ModInfo.IS_DEV_BUILD && !this.isDevBuildMessagePrinted && MC_CLIENT.playerExists())
 		{
 			this.isDevBuildMessagePrinted = true;
 			this.lastStaticWarningMessageSentMsTime = System.currentTimeMillis();
@@ -722,8 +669,7 @@ public class ClientApi
 		
 		// memory
 		if (this.staticStartupMessageSentRecently()) return;
-		if (!this.lowMemoryWarningPrinted 
-			&& Config.Common.Logging.Warning.showLowMemoryWarningOnStartup.get())
+		if (!this.lowMemoryWarningPrinted && Config.Common.Logging.Warning.showLowMemoryWarningOnStartup.get())
 		{
 			this.lowMemoryWarningPrinted = true;
 			this.lastStaticWarningMessageSentMsTime = System.currentTimeMillis();
@@ -748,8 +694,7 @@ public class ClientApi
 		
 		// high vanilla render distance
 		if (this.staticStartupMessageSentRecently()) return;
-		if (!this.highVanillaRenderDistanceWarningPrinted 
-			&& Config.Common.Logging.Warning.showHighVanillaRenderDistanceWarning.get())
+		if (!this.highVanillaRenderDistanceWarningPrinted && Config.Common.Logging.Warning.showHighVanillaRenderDistanceWarning.get())
 		{
 			// DH generally doesn't need a vanilla render distance above 12 
 			if (MC_RENDER.getRenderDistance() > 12)
@@ -776,8 +721,7 @@ public class ClientApi
 	{
 		if (this.lastStaticWarningMessageSentMsTime == 0)
 		{
-			// no static message has ever been sent
-			return false;
+			return true;
 		}
 		
 		long timeSinceLastMessage = System.currentTimeMillis() - this.lastStaticWarningMessageSentMsTime; 
@@ -796,6 +740,4 @@ public class ClientApi
 	 */
 	public void showOverlayMessageNextFrame(String message) { this.overlayMessageQueueForNextFrame.add(message); }
 	
-	
-	
 }

core/src/main/java/com/seibel/distanthorizons/core/api/internal/ClientPluginChannelApi.java

@@ -11,7 +11,7 @@ import com.seibel.distanthorizons.core.network.session.NetworkSession;
 import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftClientWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.world.IClientLevelWrapper;
 import org.apache.logging.log4j.LogManager;
-import org.jetbrains.annotations.NotNull;
+import org.checkerframework.checker.nullness.qual.NonNull;
 import org.jetbrains.annotations.Nullable;
 
 import java.util.Objects;
@@ -65,7 +65,7 @@ public class ClientPluginChannelApi
 	//================//
 	
 	/** fired when this client connects to a server with DH support */
-	public void onJoinServer(@NotNull NetworkSession networkSession)
+	public void onJoinServer(@NonNull NetworkSession networkSession)
 	{
 		Objects.requireNonNull(networkSession);
 		this.networkSession = networkSession;

core/src/main/java/com/seibel/distanthorizons/core/api/internal/ServerApi.java

@@ -136,8 +136,8 @@ public class ServerApi
 	// chunk modified events //
 	//=======================//
 	
-	public void serverChunkLoadEvent(IChunkWrapper chunkWrapper, ILevelWrapper level) { SharedApi.INSTANCE.applyChunkUpdate(chunkWrapper, level, false, false); }
-	public void serverChunkSaveEvent(IChunkWrapper chunkWrapper, ILevelWrapper level) { SharedApi.INSTANCE.applyChunkUpdate(chunkWrapper, level, true, false); }
+	public void serverChunkLoadEvent(IChunkWrapper chunkWrapper, ILevelWrapper level) { SharedApi.INSTANCE.applyChunkUpdate(chunkWrapper, level, false); }
+	public void serverChunkSaveEvent(IChunkWrapper chunkWrapper, ILevelWrapper level) { SharedApi.INSTANCE.applyChunkUpdate(chunkWrapper, level, true); }
 	
 	
 	

core/src/main/java/com/seibel/distanthorizons/core/api/internal/SharedApi.java

@@ -22,8 +22,6 @@ package com.seibel.distanthorizons.core.api.internal;
 import com.seibel.distanthorizons.api.methods.events.abstractEvents.DhApiWorldLoadEvent;
 import com.seibel.distanthorizons.api.methods.events.abstractEvents.DhApiWorldUnloadEvent;
 import com.seibel.distanthorizons.core.Initializer;
-import com.seibel.distanthorizons.core.api.internal.chunkUpdating.ChunkUpdateData;
-import com.seibel.distanthorizons.core.api.internal.chunkUpdating.ChunkUpdateQueueManager;
 import com.seibel.distanthorizons.core.config.Config;
 import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
 import com.seibel.distanthorizons.core.generation.DhLightingEngine;
@@ -67,20 +65,20 @@ public class SharedApi
 	private static final IMinecraftClientWrapper MC_CLIENT = SingletonInjector.INSTANCE.get(IMinecraftClientWrapper.class);
 	private static final IMinecraftSharedWrapper MC_SHARED = SingletonInjector.INSTANCE.get(IMinecraftSharedWrapper.class);
 	
-	public static final ChunkUpdateQueueManager CHUNK_UPDATE_QUEUE_MANAGER = new ChunkUpdateQueueManager();
+	private static final UpdateChunkPosManager UPDATE_POS_MANAGER = new UpdateChunkPosManager();
 	/** 
 	 * how many chunks can be queued for updating per thread + player (in multiplayer), 
 	 * used to prevent updates from infinitely pilling up if the user flies around extremely fast 
 	 */
-	public static final int MAX_UPDATING_CHUNK_COUNT_PER_THREAD_AND_PLAYER = 1_000;
+	private static final int MAX_UPDATING_CHUNK_COUNT_PER_THREAD_AND_PLAYER = 1_000;
 	
 	/** how many milliseconds must pass before an overloaded message can be sent in chat or the log */
-	public static final int MIN_MS_BETWEEN_OVERLOADED_LOG_MESSAGE = 30_000;
+	private static final int MIN_MS_BETWEEN_OVERLOADED_LOG_MESSAGE = 30_000;
 	
 	
-	@Nullable
 	private static AbstractDhWorld currentWorld;
 	private static int lastWorldGenTickDelta = 0;
+	private static long lastOverloadedLogMessageMsTime = 0;
 	
 	
 	
@@ -129,7 +127,7 @@ public class SharedApi
 			// shouldn't be necessary, but if we missed closing one of the connections this should make sure they're all closed
 			AbstractDhRepo.closeAllConnections();
 			// needs to be closed on world shutdown to clear out un-processed chunks
-			CHUNK_UPDATE_QUEUE_MANAGER.clear();
+			UPDATE_POS_MANAGER.clear();
 			
 			// recommend that the garbage collector cleans up any objects from the old world and thread pools
 			System.gc();
@@ -151,7 +149,6 @@ public class SharedApi
 		}
 	}
 	
-	@Nullable
 	public static AbstractDhWorld getAbstractDhWorld() { return currentWorld; }
 	/** returns null if the {@link SharedApi#currentWorld} isn't a {@link DhClientServerWorld} */
 	public static DhClientServerWorld getDhClientServerWorld() { return (currentWorld instanceof DhClientServerWorld) ? (DhClientServerWorld) currentWorld : null; }
@@ -171,10 +168,10 @@ public class SharedApi
 	 * This is important since asking MC for a chunk is slow and may block the render thread.
 	 */
 	public static boolean isChunkAtBlockPosAlreadyUpdating(int blockPosX, int blockPosZ)
-	{ return CHUNK_UPDATE_QUEUE_MANAGER.contains(new DhChunkPos(new DhBlockPos2D(blockPosX, blockPosZ))); }
+	{ return UPDATE_POS_MANAGER.contains(new DhChunkPos(new DhBlockPos2D(blockPosX, blockPosZ))); }
 	
 	public static boolean isChunkAtChunkPosAlreadyUpdating(int chunkPosX, int chunkPosZ)
-	{ return CHUNK_UPDATE_QUEUE_MANAGER.contains(new DhChunkPos(chunkPosX, chunkPosZ)); }
+	{ return UPDATE_POS_MANAGER.contains(new DhChunkPos(chunkPosX, chunkPosZ)); }
 	
 	/** 
 	 * This is often fired when unloading a level.
@@ -182,18 +179,17 @@ public class SharedApi
 	 * rapidly changing dimensions.
 	 * (IE prevent DH from infinitely allocating memory 
 	 */
-	public void clearQueuedChunkUpdates() { CHUNK_UPDATE_QUEUE_MANAGER.clear(); }
+	public void clearQueuedChunkUpdates() { UPDATE_POS_MANAGER.clear(); }
 	
-	public int getQueuedChunkUpdateCount() { return CHUNK_UPDATE_QUEUE_MANAGER.getQueuedCount(); }
+	public int getQueuedChunkUpdateCount() { return UPDATE_POS_MANAGER.closestQueue.size(); }
 	
 	
 	
 	/** handles both block place and break events */
-	public void chunkBlockChangedEvent(IChunkWrapper chunk, ILevelWrapper level) { this.applyChunkUpdate(chunk, level, true, false); }
-	public void chunkLoadEvent(IChunkWrapper chunk, ILevelWrapper level) { this.applyChunkUpdate(chunk, level, true, true); }
+	public void chunkBlockChangedEvent(IChunkWrapper chunk, ILevelWrapper level) { this.applyChunkUpdate(chunk, level, true); }
+	public void chunkLoadEvent(IChunkWrapper chunk, ILevelWrapper level) { this.applyChunkUpdate(chunk, level, false); }
 	
-	//public void applyChunkUpdate(IChunkWrapper chunkWrapper, ILevelWrapper level, boolean canGetNeighboringChunks) { this.applyChunkUpdate(chunkWrapper, level, canGetNeighboringChunks, false); }
-	public void applyChunkUpdate(IChunkWrapper chunkWrapper, ILevelWrapper level, boolean canGetNeighboringChunks, boolean newlyLoaded)
+	public void applyChunkUpdate(IChunkWrapper chunkWrapper, ILevelWrapper level, boolean updateNeighborChunks)
 	{
 		//========================//
 		// world and level checks //
@@ -249,7 +245,7 @@ public class SharedApi
 		}
 		
 		// shoudln't normally happen, but just in case
-		if (CHUNK_UPDATE_QUEUE_MANAGER.contains(chunkWrapper.getChunkPos()))
+		if (UPDATE_POS_MANAGER.contains(chunkWrapper.getChunkPos()))
 		{
 			// TODO this will prevent some LODs from updating across dimensions if multiple levels are loaded
 			return;
@@ -261,53 +257,23 @@ public class SharedApi
 		// update the necessary chunk(s) //
 		//===============================//
 		
-		if (!canGetNeighboringChunks)
+		if (!updateNeighborChunks)
 		{
 			// only update the center chunk
-			queueChunkUpdate(chunkWrapper, null, dhLevel, false);
-			return;
-		}
-		
-		
-		ArrayList<IChunkWrapper> neighboringChunkList = getNeighborChunkListForChunk(chunkWrapper, dhLevel);
-		
-		if (newlyLoaded)
-		{
-			// this means this chunkWrapper is a newly loaded chunk 
-			// which may be missing some neighboring chunk data
-			// because it is bordering the render distance
-			// thus, only the chunks neighboring this chunkWrapper will get updated
-			// because those are more likely to have their full neighboring chunk data
-			//TODO this does not prevent those neighboring chunks from updating
-			// this newly loaded chunk that were just skipped
-			// leading to occasional lighting issues
-			for (IChunkWrapper neighboringChunk : neighboringChunkList)
-			{
-				if (neighboringChunk == chunkWrapper)
-				{
-					continue;
-				}
-				
-				this.applyChunkUpdate(neighboringChunk, level, true, false);
-			}
+			
+			queueChunkUpdate(chunkWrapper, null, dhLevel);
 		}
 		else
 		{
-			// if not all neighboring chunk data is available, do not try to update
-			if (neighboringChunkList.size() < 9)
-			{
-				return;
-			}
-			
 			// update the center with any existing neighbour chunks. 
 			// this is done so lighting changes are propagated correctly
-			queueChunkUpdate(chunkWrapper, neighboringChunkList, dhLevel, true);
+			queueChunkUpdate(chunkWrapper, getNeighbourChunkListForChunk(chunkWrapper,dhLevel), dhLevel);
 		}
 	}
-	private static ArrayList<IChunkWrapper> getNeighborChunkListForChunk(IChunkWrapper chunkWrapper, IDhLevel dhLevel)
+	private static ArrayList<IChunkWrapper> getNeighbourChunkListForChunk(IChunkWrapper chunkWrapper, IDhLevel dhLevel)
 	{
 		// get the neighboring chunk list
-		ArrayList<IChunkWrapper> neighborChunkList = new ArrayList<>(9);
+		ArrayList<IChunkWrapper> neighbourChunkList = new ArrayList<>(9);
 		for (int xOffset = -1; xOffset <= 1; xOffset++)
 		{
 			for (int zOffset = -1; zOffset <= 1; zOffset++)
@@ -315,36 +281,80 @@ public class SharedApi
 				if (xOffset == 0 && zOffset == 0)
 				{
 					// center chunk
-					neighborChunkList.add(chunkWrapper);
+					neighbourChunkList.add(chunkWrapper);
 				}
 				else
 				{
-					// neighboring chunk 
-					DhChunkPos neighborPos = new DhChunkPos(chunkWrapper.getChunkPos().getX() + xOffset, chunkWrapper.getChunkPos().getZ() + zOffset);
-					IChunkWrapper neighborChunk = dhLevel.getLevelWrapper().tryGetChunk(neighborPos);
-					if (neighborChunk != null)
+					// neighboring chunk
+					DhChunkPos neighbourPos = new DhChunkPos(chunkWrapper.getChunkPos().getX() + xOffset, chunkWrapper.getChunkPos().getZ() + zOffset);
+					IChunkWrapper neighbourChunk = dhLevel.getLevelWrapper().tryGetChunk(neighbourPos);
+					if (neighbourChunk != null)
 					{
-						neighborChunkList.add(neighborChunk);
+						neighbourChunkList.add(neighbourChunk);
 					}
 				}
 			}
 		}
-		return neighborChunkList;
+		return neighbourChunkList;
 	}
 	
-	private static void queueChunkUpdate(IChunkWrapper chunkWrapper, @Nullable ArrayList<IChunkWrapper> neighborChunkList, IDhLevel dhLevel, boolean canGetNeighboringChunks)
+	private static void queueChunkUpdate(IChunkWrapper chunkWrapper, @Nullable ArrayList<IChunkWrapper> neighbourChunkList, IDhLevel dhLevel) 
+	{ queueChunkUpdate(chunkWrapper, neighbourChunkList, dhLevel,false); }
+	private static void queueChunkUpdate(IChunkWrapper chunkWrapper, @Nullable ArrayList<IChunkWrapper> neighbourChunkList, IDhLevel dhLevel, boolean lightUpdateOnly)
 	{
-				
-		// return if the chunk is already queued
-		if (CHUNK_UPDATE_QUEUE_MANAGER.contains(chunkWrapper.getChunkPos()))
+		int maxUpdateSizeMultiplier;
+		if (MC_CLIENT != null && MC_CLIENT.playerExists())
 		{
-			return;
+			// Local worlds & multiplayer
+			UPDATE_POS_MANAGER.setCenter(MC_CLIENT.getPlayerChunkPos());
+			maxUpdateSizeMultiplier = MC_CLIENT.clientConnectedToDedicatedServer() ? 1 : MC_SHARED.getPlayerCount();
+		}
+		else
+		{
+			// Dedicated servers
+			// Also includes spawn chunks since they're likely to be intentionally utilized with updates
+			maxUpdateSizeMultiplier = 1 + MC_SHARED.getPlayerCount();
+		}
+		
+		UPDATE_POS_MANAGER.maxSize = MAX_UPDATING_CHUNK_COUNT_PER_THREAD_AND_PLAYER
+				* Config.Common.MultiThreading.numberOfThreads.get()
+				* maxUpdateSizeMultiplier;
+		
+		UpdateChunkData updateData = new UpdateChunkData(chunkWrapper, neighbourChunkList, dhLevel, lightUpdateOnly);
+		if(lightUpdateOnly)
+		{
+			UPDATE_POS_MANAGER.removeItem(chunkWrapper.getChunkPos());
+		}
+		int remainingCapacity = UPDATE_POS_MANAGER.addItem(chunkWrapper.getChunkPos(), updateData);
+		if (remainingCapacity <= 0)
+		{
+			// limit how often an overloaded message can be sent
+			long msBetweenLastLog = System.currentTimeMillis() - lastOverloadedLogMessageMsTime;
+			if (msBetweenLastLog >= MIN_MS_BETWEEN_OVERLOADED_LOG_MESSAGE)
+			{
+				lastOverloadedLogMessageMsTime = System.currentTimeMillis();
+				
+				String message = "\u00A76" + "Distant Horizons overloaded, too many chunks queued for LOD processing. " + "\u00A7r" +
+						"\nThis may result in holes in your LODs. " +
+						"\nFix: move through the world slower, decrease your vanilla render distance, slow down your world pre-generator (IE Chunky), or increase the Distant Horizons' CPU thread counts. " +
+						"\nMax queue count ["+UPDATE_POS_MANAGER.maxSize+"] (["+ MAX_UPDATING_CHUNK_COUNT_PER_THREAD_AND_PLAYER +"] per thread+players).";
+				
+				boolean showWarningInChat = Config.Common.Logging.Warning.showUpdateQueueOverloadedChatWarning.get();
+				if (showWarningInChat)
+				{
+					ClientApi.INSTANCE.showChatMessageNextFrame(message);
+				}
+				
+				// Don't log warnings in singleplayer or in hosted LAN since it usually isn't a problem (and if it is it's easy to notice).
+				// Servers should always log since being overloaded is harder to notice. 
+				EWorldEnvironment environment = SharedApi.getEnvironment();
+				if (showWarningInChat || environment == EWorldEnvironment.SERVER_ONLY)
+				{
+					LOGGER.warn(message);
+				}
+			}
 		}
-			
 		
-		// add chunk update data to preUpdate queue
-		ChunkUpdateData updateData = new ChunkUpdateData(chunkWrapper, neighborChunkList, dhLevel, canGetNeighboringChunks);
-		CHUNK_UPDATE_QUEUE_MANAGER.addItemToPreUpdateQueue(chunkWrapper.getChunkPos(), updateData);
 		
 		
 		// queue updates up to the number of CPU cores allocated for the job
@@ -355,7 +365,7 @@ public class SharedApi
 		{
 			try
 			{
-				executor.execute(SharedApi::processQueue);
+				executor.execute(SharedApi::processQueuedChunkUpdate);
 			}
 			catch (RejectedExecutionException ignore)
 			{
@@ -363,158 +373,94 @@ public class SharedApi
 			}
 		}
 	}
-	
-	private static void processQueue()
-	{
-		// update the center & max size of the queue manager
-		int maxUpdateSizeMultiplier;
-		if (MC_CLIENT != null && MC_CLIENT.playerExists())
-		{
-			// Local worlds & multiplayer
-			CHUNK_UPDATE_QUEUE_MANAGER.setCenter(MC_CLIENT.getPlayerChunkPos());
-			maxUpdateSizeMultiplier = MC_CLIENT.clientConnectedToDedicatedServer() ? 1 : MC_SHARED.getPlayerCount();
-		}
-		else
-		{
-			// Dedicated servers
-			// Also includes spawn chunks since they're likely to be intentionally utilized with updates
-			maxUpdateSizeMultiplier = 1 + MC_SHARED.getPlayerCount();
-		}
-		
-		CHUNK_UPDATE_QUEUE_MANAGER.maxSize = MAX_UPDATING_CHUNK_COUNT_PER_THREAD_AND_PLAYER
-				* Config.Common.MultiThreading.numberOfThreads.get()
-				* maxUpdateSizeMultiplier;
-		
-		
-		
-		//===============================//
-		// update the necessary chunk(s) //
-		//===============================//
-		
-		// process preUpdate queue
-		processQueuedChunkPreUpdate();
-		
-		// process update queue
-		processQueuedChunkUpdate();
-		
-		// queue the next position if there are still positions to process
-		AbstractExecutorService executor = ThreadPoolUtil.getChunkToLodBuilderExecutor();
-		if (executor != null && !CHUNK_UPDATE_QUEUE_MANAGER.isEmpty())
-		{
-			try
-			{
-				executor.execute(SharedApi::processQueue);
-			}
-			catch (RejectedExecutionException ignore)
-			{
-				// the executor was shut down, it should be back up shortly and able to accept new jobs
-			}
-		}
-		
-	}
-	
-	private static void processQueuedChunkPreUpdate()
-	{
-		ChunkUpdateData preUpdateData = CHUNK_UPDATE_QUEUE_MANAGER.preUpdateQueue.popClosest();
-		if (preUpdateData == null)
-		{
-			return;
-		}
-		
-		IDhLevel dhLevel = preUpdateData.dhLevel;
-		IChunkWrapper chunkWrapper = preUpdateData.chunkWrapper;
-		boolean canGetNeighboringChunks = preUpdateData.canGetNeighboringChunks;
-		ArrayList<IChunkWrapper> neighborChunkList = preUpdateData.neighborChunkList;
-		
-		try
-		{
-			// check if this chunk has been converted into an LOD already
-			boolean checkChunkHash = !Config.Common.LodBuilding.disableUnchangedChunkCheck.get();
-			if (checkChunkHash)
-			{
-				int oldChunkHash = dhLevel.getChunkHash(chunkWrapper.getChunkPos()); // shouldn't happen on the render thread since it may take a few moments to run
-				int newChunkHash = chunkWrapper.getBlockBiomeHashCode();
-				
-				boolean hasNewChunkHash = (oldChunkHash != newChunkHash);
-				if (!hasNewChunkHash)
-				{
-					// do not update the chunk if the hash is the same
-					return;
-				}
-				
-				// if this chunk will update and can get neighbors
-				// then queue neighboring chunks to update as well
-				// neighboring chunk will get added directly to the update queue
-				// so they won't queue further chunk updates
-				if (neighborChunkList != null 
-					&& !neighborChunkList.isEmpty())
-				{
-					for (IChunkWrapper adjacentChunk : neighborChunkList)
-					{
-						// pulling a new chunkWrapper is necessary to prevent concurrent modification on the existing chunkWrappers
-						IChunkWrapper newCenterChunk = dhLevel.getLevelWrapper().tryGetChunk(adjacentChunk.getChunkPos());
-						if (newCenterChunk != null)
-						{
-							ChunkUpdateData newUpdateData;
-							if (canGetNeighboringChunks)
-							{
-								newUpdateData = new ChunkUpdateData(newCenterChunk, getNeighborChunkListForChunk(newCenterChunk, dhLevel), dhLevel, true);
-							}
-							else
-							{
-								newUpdateData = new ChunkUpdateData(newCenterChunk, null, dhLevel, false);
-							}
-							
-							CHUNK_UPDATE_QUEUE_MANAGER.addItemToUpdateQueue(newCenterChunk.getChunkPos(), newUpdateData);
-						}
-					}
-				}
-			}
-			
-			CHUNK_UPDATE_QUEUE_MANAGER.addItemToUpdateQueue(chunkWrapper.getChunkPos(), preUpdateData);
-		}
-		catch (Exception e)
-		{
-			LOGGER.error("Unexpected error when pre-updating chunk at pos: [" + chunkWrapper.getChunkPos() + "]", e);
-		}
-	}
-	
 	private static void processQueuedChunkUpdate()
 	{
 		//LOGGER.trace(chunkWrapper.getChunkPos() + " " + executor.getActiveCount() + " / " + executor.getQueue().size() + " - " + executor.getCompletedTaskCount());
 		
-		ChunkUpdateData updateData = CHUNK_UPDATE_QUEUE_MANAGER.updateQueue.popClosest();
+		UpdateChunkData updateData = UPDATE_POS_MANAGER.popClosest();
 		if (updateData == null)
 		{
 			return;
 		}
 		
 		IChunkWrapper chunkWrapper = updateData.chunkWrapper;
+		@Nullable ArrayList<IChunkWrapper> neighbourChunkList = updateData.neighbourChunkList;
 		IDhLevel dhLevel = updateData.dhLevel;
-		// having a list of the nearby chunks is needed for lighting and beacon generation
-		@Nullable ArrayList<IChunkWrapper> nearbyChunkList = updateData.neighborChunkList; 
 		
-		// a non-null list is needed for the lighting engine
-		if (nearbyChunkList == null)
-		{
-			nearbyChunkList = new ArrayList<IChunkWrapper>();
-			nearbyChunkList.add(chunkWrapper);
-		}
 		
 		try
 		{
+			boolean checkChunkHash = !Config.Common.LodBuilding.disableUnchangedChunkCheck.get();
+			
+			// check if this chunk has been converted into an LOD already
+			int oldChunkHash = dhLevel.getChunkHash(chunkWrapper.getChunkPos()); // shouldn't happen on the render thread since it may take a few moments to run
+			int newChunkHash = chunkWrapper.getBlockBiomeHashCode();
+			if (checkChunkHash)
+			{
+				if (oldChunkHash == newChunkHash && !updateData.lightUpdateOnly)
+				{
+					// if the chunk hashes are the same then we don't need to bother with lighting the chunk
+					// or creating/updating the LODs
+					return;
+				}
+			}
+			
+			
+			// having a list of the nearby chunks is needed for lighting and beacon generation
+			ArrayList<IChunkWrapper> nearbyChunkList;
+			if (neighbourChunkList != null)
+			{
+				nearbyChunkList = neighbourChunkList;
+			}
+			else
+			{
+				nearbyChunkList = new ArrayList<>(1);
+				nearbyChunkList.add(chunkWrapper);
+			}
+			
+			// if this chunk will update its lighting
+			// then queue adjacent chunks to update theirs as well
+			// adjacent chunk will have 'lightUpdateOnly' true 
+			// so they won't schedule further chunk updates
+			if (!updateData.lightUpdateOnly)
+			{
+				for (IChunkWrapper adjacentChunk : nearbyChunkList)
+				{
+					// pulling a new chunkWrapper is necessary to prevent concurrent modification on the existing chunkWrappers
+					IChunkWrapper newCenterChunk = dhLevel.getLevelWrapper().tryGetChunk(adjacentChunk.getChunkPos());
+					if (newCenterChunk != null)
+					{
+						queueChunkUpdate(newCenterChunk, getNeighbourChunkListForChunk(newCenterChunk, dhLevel), dhLevel, true);
+					}
+				}
+			}
+			
 			// sky lighting is populated later at the data source level
 			DhLightingEngine.INSTANCE.bakeChunkBlockLighting(chunkWrapper, nearbyChunkList, dhLevel.hasSkyLight() ? LodUtil.MAX_MC_LIGHT : LodUtil.MIN_MC_LIGHT);
 			
 			dhLevel.updateBeaconBeamsForChunk(chunkWrapper, nearbyChunkList);
-			
-			int newChunkHash = chunkWrapper.getBlockBiomeHashCode();
 			dhLevel.updateChunkAsync(chunkWrapper, newChunkHash);
 		}
 		catch (Exception e)
 		{
 			LOGGER.error("Unexpected error when updating chunk at pos: [" + chunkWrapper.getChunkPos() + "]", e);
 		}
+		finally
+		{
+			// queue the next position if there are still positions to process
+			AbstractExecutorService executor = ThreadPoolUtil.getChunkToLodBuilderExecutor();
+			if (executor != null && !UPDATE_POS_MANAGER.updateDataByChunkPos.isEmpty())
+			{
+				try
+				{
+					executor.execute(SharedApi::processQueuedChunkUpdate);
+				}
+				catch (RejectedExecutionException ignore)
+				{
+					// the executor was shut down, it should be back up shortly and able to accept new jobs
+				}
+			}
+		}
 	}
 	
 	
@@ -525,13 +471,161 @@ public class SharedApi
 	
 	public String getDebugMenuString()
 	{
-		String preUpdatingCountStr = F3Screen.NUMBER_FORMAT.format(CHUNK_UPDATE_QUEUE_MANAGER.preUpdateQueue.getQueuedCount());
-		String updatingCountStr = F3Screen.NUMBER_FORMAT.format(CHUNK_UPDATE_QUEUE_MANAGER.updateQueue.getQueuedCount());
-		String queuedCountStr = F3Screen.NUMBER_FORMAT.format(CHUNK_UPDATE_QUEUE_MANAGER.getQueuedCount());
+		String updatingCountStr = F3Screen.NUMBER_FORMAT.format(UPDATE_POS_MANAGER.closestQueue.size());
+		String maxUpdateCountStr = F3Screen.NUMBER_FORMAT.format(UPDATE_POS_MANAGER.maxSize);
+		return "Queued chunk updates: "+updatingCountStr+" / "+maxUpdateCountStr;
+	}
+	
+	
+	
+	//================//
+	// helper classes //
+	//================//
+	
+	/** contains the objects needed to update a chunk */
+	private static class UpdateChunkData
+	{
+		public IChunkWrapper chunkWrapper;
+		@Nullable
+		public ArrayList<IChunkWrapper> neighbourChunkList;
+		public IDhLevel dhLevel;
+		/** adjacent chunks will only update their light */
+		public boolean lightUpdateOnly;
 		
-		String maxUpdateCountStr = F3Screen.NUMBER_FORMAT.format(CHUNK_UPDATE_QUEUE_MANAGER.maxSize);
+		public UpdateChunkData(IChunkWrapper chunkWrapper, @Nullable ArrayList<IChunkWrapper> neighbourChunkList, IDhLevel dhLevel, boolean lightUpdateOnly)
+		{
+			this.chunkWrapper = chunkWrapper;
+			this.neighbourChunkList = neighbourChunkList;
+			this.dhLevel = dhLevel;
+			this.lightUpdateOnly = lightUpdateOnly;
+		}
+	}
+	
+	/** keeps track of which chunks need to be updated */
+	private static class UpdateChunkPosManager
+	{
+		private final PriorityBlockingQueue<DhChunkPos> closestQueue;
+		private final PriorityBlockingQueue<DhChunkPos> furthestQueue;
+		private final ConcurrentHashMap<DhChunkPos, UpdateChunkData> updateDataByChunkPos;
+		
+		private DhChunkPos center;
+		private int maxSize = 500;
+		
+		
+		
+		//=============//
+		// constructor //
+		//=============//
+		
+		public UpdateChunkPosManager()
+		{
+			this.closestQueue = new PriorityBlockingQueue<>(500, Comparator.comparingDouble(pos -> pos.squaredDistance(this.center)));
+			this.furthestQueue = new PriorityBlockingQueue<>(500, Comparator.comparingDouble(pos -> ((DhChunkPos)pos).squaredDistance(this.center)).reversed());
+			this.updateDataByChunkPos = new ConcurrentHashMap<>();
+			// defaulting to 0,0 is fine since it'll be updated once we start adding items 
+			this.center = new DhChunkPos(0, 0);
+		}
+		
+		
+		
+		//==================//
+		// list/set methods //
+		//==================//
+		
+		public boolean contains(DhChunkPos pos) { return this.updateDataByChunkPos.containsKey(pos); }
+		
+		public void clear()
+		{
+			this.updateDataByChunkPos.clear();
+			this.closestQueue.clear();
+			this.furthestQueue.clear();
+		}
+		
+		public void removeItem(DhChunkPos pos)
+		{
+			this.updateDataByChunkPos.remove(pos);
+			this.closestQueue.remove(pos);
+			this.furthestQueue.remove(pos);
+		}
+		
+		/**
+		 * Adds an item to the queue of chunks that need to be updated.
+		 * If there are no more slots, replaces the item furthest from the center.
+		 *
+		 * @return The number of remaining slots available in the queue.
+		 */
+		public int addItem(DhChunkPos pos, UpdateChunkData updateData)
+		{
+			int remainingSlots = this.maxSize - this.updateDataByChunkPos.size();
+			if (this.updateDataByChunkPos.containsKey(pos))
+			{
+				// Chunk is already present in queue, no need to insert
+				return remainingSlots;
+			}
+			
+			// If no slots are left, get one by removing the item furthest from the center
+			if (remainingSlots <= 0)
+			{
+				DhChunkPos furthest = this.furthestQueue.poll();
+				if (furthest != null)
+				{
+					this.closestQueue.remove(furthest);
+					this.updateDataByChunkPos.remove(furthest);
+				}
+			}
+			
+			this.updateDataByChunkPos.put(pos, updateData);
+			this.closestQueue.add(pos);
+			this.furthestQueue.add(pos);
+			
+			return remainingSlots;
+		}
+		
+		
+		
+		//==================//
+		// position methods //
+		//==================//
+		
+		public void setCenter(DhChunkPos newCenter)
+		{
+			// if the rebuild time takes too long 
+			// (in James' testing a queue of 500 items only took around 0.1 milliseconds)
+			// this equation could be changed to only update after moving 2 or 4 chunks from the center
+			if (newCenter.equals(this.center))
+			{
+				return;
+			}
+			
+			this.center = newCenter;
+			
+			// rebuild the priority queues to match the new center
+			this.closestQueue.clear();
+			this.furthestQueue.clear();
+			for (DhChunkPos pos : this.updateDataByChunkPos.keySet())
+			{
+				this.closestQueue.add(pos);
+				this.furthestQueue.add(pos);
+			}
+		}
+		
+		public UpdateChunkData popClosest()
+		{
+			if (this.closestQueue.isEmpty())
+			{
+				return null;
+			}
+			
+			DhChunkPos closest = this.closestQueue.poll();
+			if (closest == null)
+			{
+				return null;
+			}
+			
+			this.furthestQueue.remove(closest);
+			return this.updateDataByChunkPos.remove(closest);
+		}
 		
-		return "Queued chunk updates: "+"( "+preUpdatingCountStr+" + "+updatingCountStr+" )  [ "+queuedCountStr+" / "+maxUpdateCountStr+" ]";
 	}
 	
 	

core/src/main/java/com/seibel/distanthorizons/core/api/internal/chunkUpdating/ChunkPosQueue.java

@@ -1,125 +0,0 @@
-package com.seibel.distanthorizons.core.api.internal.chunkUpdating;
-
-import com.seibel.distanthorizons.core.api.internal.SharedApi;
-import com.seibel.distanthorizons.core.pos.DhChunkPos;
-
-import java.util.Comparator;
-import java.util.concurrent.ConcurrentHashMap;
-import java.util.concurrent.PriorityBlockingQueue;
-
-public class ChunkPosQueue
-{
-	private final PriorityBlockingQueue<DhChunkPos> closestQueue;
-	private final PriorityBlockingQueue<DhChunkPos> furthestQueue;
-	private final ConcurrentHashMap<DhChunkPos, ChunkUpdateData> updateDataByChunkPos;
-	
-	private DhChunkPos center;
-	
-	
-	
-	//=============//
-	// constructor //
-	//=============//
-	
-	public ChunkPosQueue()
-	{
-		this.closestQueue = new PriorityBlockingQueue<>(500, Comparator.comparingDouble(pos -> pos.squaredDistance(this.center)));
-		this.furthestQueue = new PriorityBlockingQueue<>(500, Comparator.comparingDouble(pos -> ((DhChunkPos)pos).squaredDistance(this.center)).reversed());
-		this.updateDataByChunkPos = new ConcurrentHashMap<>();
-		// defaulting to 0,0 is fine since it'll be updated once we start adding items 
-		this.center = new DhChunkPos(0, 0);
-	}
-	
-	
-	
-	//==============//
-	// list methods //
-	//==============//
-	
-	public boolean contains(DhChunkPos pos) { return this.updateDataByChunkPos.containsKey(pos); }
-	
-	public void clear()
-	{
-		this.updateDataByChunkPos.clear();
-		this.closestQueue.clear();
-		this.furthestQueue.clear();
-	}
-	
-	public void addItem(DhChunkPos pos, ChunkUpdateData updateData)
-	{
-		if (this.updateDataByChunkPos.containsKey(pos))
-		{
-			// Chunk is already present in queue, no need to insert
-			return;
-		}
-		this.updateDataByChunkPos.put(pos, updateData);
-		this.closestQueue.add(pos);
-		this.furthestQueue.add(pos);
-	}
-	
-	public int getQueuedCount() { return this.updateDataByChunkPos.size(); }
-	
-	public boolean isEmpty() { return this.updateDataByChunkPos.isEmpty(); }
-	
-	
-	
-	//==================//
-	// position methods //
-	//==================//
-	
-	public void setCenter(DhChunkPos newCenter)
-	{
-		// if the rebuild time takes too long 
-		// (in James' testing a queue of 500 items only took around 0.1 milliseconds)
-		// this equation could be changed to only update after moving 2 or 4 chunks from the center
-		if (newCenter.equals(this.center))
-		{
-			return;
-		}
-		
-		this.center = newCenter;
-		
-		// rebuild the priority queues to match the new center
-		this.closestQueue.clear();
-		this.furthestQueue.clear();
-		for (DhChunkPos pos : this.updateDataByChunkPos.keySet())
-		{
-			this.closestQueue.add(pos);
-			this.furthestQueue.add(pos);
-		}
-	}
-	
-	public ChunkUpdateData popClosest()
-	{
-		if (this.closestQueue.isEmpty())
-		{
-			return null;
-		}
-		
-		DhChunkPos closest = this.closestQueue.poll();
-		if (closest == null)
-		{
-			return null;
-		}
-		
-		this.furthestQueue.remove(closest);
-		return this.updateDataByChunkPos.remove(closest);
-	}
-	public ChunkUpdateData popFurthest()
-	{
-		if (this.furthestQueue.isEmpty())
-		{
-			return null;
-		}
-		
-		DhChunkPos furthest = this.furthestQueue.poll();
-		if (furthest == null)
-		{
-			return null;
-		}
-		
-		this.closestQueue.remove(furthest);
-		return this.updateDataByChunkPos.remove(furthest);
-	}
-}
-		

core/src/main/java/com/seibel/distanthorizons/core/api/internal/chunkUpdating/ChunkUpdateData.java

@@ -1,26 +0,0 @@
-package com.seibel.distanthorizons.core.api.internal.chunkUpdating;
-
-import com.seibel.distanthorizons.core.level.IDhLevel;
-import com.seibel.distanthorizons.core.wrapperInterfaces.chunk.IChunkWrapper;
-import org.jetbrains.annotations.Nullable;
-
-import java.util.ArrayList;
-
-public class ChunkUpdateData
-{
-	public IChunkWrapper chunkWrapper;
-	@Nullable
-	public ArrayList<IChunkWrapper> neighborChunkList;
-	public IDhLevel dhLevel;
-	public boolean canGetNeighboringChunks;
-	
-	
-	
-	public ChunkUpdateData(IChunkWrapper chunkWrapper, @Nullable ArrayList<IChunkWrapper> neighborChunkList, IDhLevel dhLevel, boolean canGetNeighborChunks)
-	{
-		this.chunkWrapper = chunkWrapper;
-		this.neighborChunkList = neighborChunkList;
-		this.dhLevel = dhLevel;
-		this.canGetNeighboringChunks = canGetNeighborChunks;
-	}
-}

core/src/main/java/com/seibel/distanthorizons/core/api/internal/chunkUpdating/ChunkUpdateQueueManager.java

@@ -1,145 +0,0 @@
-package com.seibel.distanthorizons.core.api.internal.chunkUpdating;
-
-import com.seibel.distanthorizons.core.api.internal.ClientApi;
-import com.seibel.distanthorizons.core.api.internal.SharedApi;
-import com.seibel.distanthorizons.core.config.Config;
-import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
-import com.seibel.distanthorizons.core.pos.DhChunkPos;
-import com.seibel.distanthorizons.core.world.EWorldEnvironment;
-import org.apache.logging.log4j.Logger;
-
-public class ChunkUpdateQueueManager
-{
-	private static final Logger LOGGER = DhLoggerBuilder.getLogger();
-	
-	
-	public final ChunkPosQueue updateQueue;
-	public final ChunkPosQueue preUpdateQueue;
-	
-	public int maxSize = 500;
-	
-	private static long lastOverloadedLogMessageMsTime = 0;
-	
-	
-	
-	//=============//
-	// constructor //
-	//=============//
-	
-	public ChunkUpdateQueueManager()
-	{
-		this.updateQueue = new ChunkPosQueue();
-		this.preUpdateQueue = new ChunkPosQueue();
-	}
-	
-	
-	
-	//==================//
-	// list/set methods //
-	//==================//
-	
-	public boolean contains(DhChunkPos pos) { return this.updateQueue.contains(pos) || this.preUpdateQueue.contains(pos); }
-	
-	public void clear()
-	{
-		this.updateQueue.clear();
-		this.preUpdateQueue.clear();
-	}
-	public int getQueuedCount() { return this.updateQueue.getQueuedCount() + this.preUpdateQueue.getQueuedCount(); }
-	public boolean isEmpty()
-	{
-		return this.updateQueue.isEmpty()
-				&& this.preUpdateQueue.isEmpty();
-	}
-	
-	/**
-	 * Adds an item to the pre-update queue of chunks that might need to be updated.
-	 * If there are no more slots, replaces the item furthest from the center in the update queue.
-	 */
-	public void addItemToPreUpdateQueue(DhChunkPos pos, ChunkUpdateData updateData)
-	{
-		int remainingSlots = this.maxSize - this.getQueuedCount();
-		
-		// If no slots are left, get one by removing the item furthest from the center
-		if (remainingSlots <= 0)
-		{
-			if (!this.updateQueue.isEmpty())
-			{
-				this.updateQueue.popFurthest();
-			}
-			else
-			{
-				this.preUpdateQueue.popFurthest();
-			}
-		}
-		this.preUpdateQueue.addItem(pos, updateData);
-		
-		remainingSlots = this.maxSize - this.getQueuedCount();
-		if (remainingSlots <= 0)
-		{
-			this.sendOverloadMessage();
-		}
-	}
-	
-	public void addItemToUpdateQueue(DhChunkPos pos, ChunkUpdateData updateData)
-	{
-		int remainingSlots = this.maxSize - this.getQueuedCount();
-		
-		// If no slots are left, get one by removing the item furthest from the center
-		if (remainingSlots <= 0)
-		{
-			this.updateQueue.popFurthest();
-		}
-		
-		this.updateQueue.addItem(pos,updateData);
-		
-		remainingSlots = this.maxSize - this.getQueuedCount();
-		if (remainingSlots <= 0)
-		{
-			this.sendOverloadMessage();
-		}
-	}
-	
-	private void sendOverloadMessage()
-	{
-		// limit how often an overloaded message can be sent
-		long msBetweenLastLog = System.currentTimeMillis() - lastOverloadedLogMessageMsTime;
-		if (msBetweenLastLog >= SharedApi.MIN_MS_BETWEEN_OVERLOADED_LOG_MESSAGE)
-		{
-			lastOverloadedLogMessageMsTime = System.currentTimeMillis();
-			
-			String message = "\u00A76" + "Distant Horizons overloaded, too many chunks queued for LOD processing. " + "\u00A7r" +
-					"\nThis may result in holes in your LODs. " +
-					"\nFix: move through the world slower, decrease your vanilla render distance, slow down your world pre-generator (IE Chunky), or increase the Distant Horizons' CPU thread counts. " +
-					"\nMax queue count [" + SharedApi.CHUNK_UPDATE_QUEUE_MANAGER.maxSize + "] ([" + SharedApi.MAX_UPDATING_CHUNK_COUNT_PER_THREAD_AND_PLAYER + "] per thread+players).";
-			
-			boolean showWarningInChat = Config.Common.Logging.Warning.showUpdateQueueOverloadedChatWarning.get();
-			if (showWarningInChat)
-			{
-				ClientApi.INSTANCE.showChatMessageNextFrame(message);
-			}
-			
-			// Don't log warnings in singleplayer or in hosted LAN since it usually isn't a problem (and if it is it's easy to notice).
-			// Servers should always log since being overloaded is harder to notice. 
-			EWorldEnvironment environment = SharedApi.getEnvironment();
-			if (showWarningInChat || environment == EWorldEnvironment.SERVER_ONLY)
-			{
-				LOGGER.warn(message);
-			}
-		}
-	}
-	
-	
-	
-	//==================//
-	// position methods //
-	//==================//
-	
-	public void setCenter(DhChunkPos newCenter)
-	{
-		this.updateQueue.setCenter(newCenter);
-		this.preUpdateQueue.setCenter(newCenter);
-	}
-	
-	
-}

core/src/main/java/com/seibel/distanthorizons/core/api/internal/rendering/RenderState.java

@@ -1,72 +0,0 @@
-package com.seibel.distanthorizons.core.api.internal.rendering;
-
-import com.seibel.distanthorizons.core.api.internal.ClientApi;
-import com.seibel.distanthorizons.core.util.math.Mat4f;
-import com.seibel.distanthorizons.core.wrapperInterfaces.world.IClientLevelWrapper;
-
-/**
- * Used to track the rendering state for the current frame.
- * 
- * @see ClientApi
- */
-public class RenderState
-{
-	public Mat4f mcModelViewMatrix = null;
-	public Mat4f mcProjectionMatrix = null;
-	public float frameTime = -1;
-	public IClientLevelWrapper clientLevelWrapper = null;
-	
-	
-	
-	//========//
-	// checks //
-	//========//
-	
-	public String unableToRenderBecause()
-	{
-		String errorReasons = "";
-		
-		// the matrix may be the identity matrix or and old/incorrect matrix
-		// but we did set it at least once before this
-		if (this.mcModelViewMatrix == null)
-		{
-			errorReasons += "no MVM Matrix, ";
-		}
-		
-		if (this.mcProjectionMatrix == null)
-		{
-			errorReasons += "no Projection Matrix, ";
-		}
-		
-		if (this.frameTime == -1)
-		{
-			errorReasons += "no Frame Time, ";
-		}
-		
-		if (this.clientLevelWrapper == null)
-		{
-			errorReasons += "no Level Wrapper, ";
-		}
-		
-		return errorReasons;
-	}
-	
-	public boolean canRender()
-	{
-		// separated variable to allow for easy checking with the debugger
-		String errorReasons = this.unableToRenderBecause();
-		return errorReasons.isEmpty();
-	}
-	
-	public void canRenderOrThrow() throws IllegalStateException
-	{
-		String errorReasons = this.unableToRenderBecause();
-		if (!errorReasons.isEmpty())
-		{
-			throw new IllegalStateException(errorReasons);
-		}
-	}
-	
-	
-	
-}

core/src/main/java/com/seibel/distanthorizons/core/config/Config.java

@@ -131,8 +131,6 @@ public class Config
 			// since they aren't part of "client" config class
 			// TODO determine their destination programically instead of hard coding the value
 			
-			public static ConfigUIComment advancedHeader = new ConfigUIComment.Builder().setParentConfigClass(Advanced.class).build();
-			
 			public static ConfigCategory graphics = new ConfigCategory.Builder().set(Graphics.class).build();
 			public static ConfigCategory worldGenerator = new ConfigCategory.Builder().set(Common.WorldGenerator.class).setDestination("common.worldGenerator").build();
 			public static ConfigCategory multiplayer = new ConfigCategory.Builder().set(Multiplayer.class).build();
@@ -148,32 +146,23 @@ public class Config
 			
 			public static class Graphics
 			{
-				public static ConfigUIComment advancedGraphicsHeader = new ConfigUIComment.Builder().setParentConfigClass(Graphics.class).build();
-				
 				public static ConfigCategory quality = new ConfigCategory.Builder().set(Quality.class).build();
-				public static ConfigUISpacer qualitySpacer = new ConfigUISpacer.Builder().build();
 				
 				public static ConfigUiLinkedEntry quickEnableSsao = new ConfigUiLinkedEntry(Ssao.enableSsao);
 				public static ConfigCategory ssao = new ConfigCategory.Builder().set(Ssao.class).build();
-				public static ConfigUISpacer ssaoSpacer = new ConfigUISpacer.Builder().build();
-				
 				
 				public static ConfigUiLinkedEntry quickEnableGenericRendering = new ConfigUiLinkedEntry(GenericRendering.enableGenericRendering);
 				public static ConfigCategory genericRendering = new ConfigCategory.Builder().set(GenericRendering.class).build();
-				public static ConfigUISpacer genericRenderingSpacer = new ConfigUISpacer.Builder().build();
 				
 				public static ConfigUiLinkedEntry quickEnableDhFog = new ConfigUiLinkedEntry(Fog.enableDhFog);
 				public static ConfigUiLinkedEntry quickEnableMcFog = new ConfigUiLinkedEntry(Fog.enableVanillaFog);
 				public static ConfigCategory fog = new ConfigCategory.Builder().set(Fog.class).build();
-				public static ConfigUISpacer fogSpacer = new ConfigUISpacer.Builder().build();
 				
 				public static ConfigUiLinkedEntry quickEnableNoiseTexture = new ConfigUiLinkedEntry(NoiseTexture.enableNoiseTexture);
 				public static ConfigCategory noiseTexture = new ConfigCategory.Builder().set(NoiseTexture.class).build();
-				public static ConfigUISpacer noiseTextureSpacer = new ConfigUISpacer.Builder().build();
 				
 				public static ConfigUiLinkedEntry quickEnableCaveCulling = new ConfigUiLinkedEntry(Culling.enableCaveCulling);
 				public static ConfigCategory culling = new ConfigCategory.Builder().set(Culling.class).build();
-				public static ConfigUISpacer cullingSpacer = new ConfigUISpacer.Builder().build();
 				
 				public static ConfigCategory experimental = new ConfigCategory.Builder().set(Experimental.class).build();
 				
@@ -181,12 +170,12 @@ public class Config
 				
 				public static class Quality
 				{
-					public static ConfigUIComment qualityHeader = new ConfigUIComment.Builder().setParentConfigClass(Quality.class).build();
-					
 					public static ConfigEntry<Integer> lodChunkRenderDistanceRadius = new ConfigEntry.Builder<Integer>()
+							.setChatCommandName("generation.maxRequestDistance")
 							.setMinDefaultMax(32, 256, 4096)
 							.comment("" +
 									"The radius of the mod's render distance. (measured in chunks)\n" +
+									"On server defines the distance allowed to generate around the player; note that real-time updates and synd on load limits are defined separately. \n" +
 									"")
 							.setPerformance(EConfigEntryPerformance.HIGH)
 							.build();
@@ -215,7 +204,6 @@ public class Config
 									+ "Lowest Quality: " + EDhApiMaxHorizontalResolution.CHUNK + "\n"
 									+ "Highest Quality: " + EDhApiMaxHorizontalResolution.BLOCK)
 							.setPerformance(EConfigEntryPerformance.MEDIUM)
-							.addListener(ReloadLodsConfigEventHandler.DELAYED_INSTANCE)
 							.build();
 					
 					public static ConfigEntry<EDhApiVerticalQuality> verticalQuality = new ConfigEntry.Builder<EDhApiVerticalQuality>()
@@ -229,7 +217,7 @@ public class Config
 									+ "Lowest Quality: " + EDhApiVerticalQuality.HEIGHT_MAP + "\n"
 									+ "Highest Quality: " + EDhApiVerticalQuality.EXTREME)
 							.setPerformance(EConfigEntryPerformance.VERY_HIGH)
-							.addListener(ReloadLodsConfigEventHandler.DELAYED_INSTANCE)
+							.addListener(ReloadLodsConfigEventHandler.INSTANCE)
 							.build();
 					
 					public static ConfigEntry<EDhApiTransparency> transparency = new ConfigEntry.Builder<EDhApiTransparency>()
@@ -242,7 +230,7 @@ public class Config
 									+ EDhApiTransparency.DISABLED + ": LODs will be opaque. \n"
 									+ "")
 							.setPerformance(EConfigEntryPerformance.MEDIUM)
-							.addListener(ReloadLodsConfigEventHandler.DELAYED_INSTANCE)
+							.addListener(ReloadLodsConfigEventHandler.INSTANCE)
 							.build();
 					
 					public static ConfigEntry<EDhApiBlocksToAvoid> blocksToIgnore = new ConfigEntry.Builder<EDhApiBlocksToAvoid>()
@@ -254,7 +242,7 @@ public class Config
 									+ EDhApiBlocksToAvoid.NON_COLLIDING + ": Only represent solid blocks in the LODs (tall grass, torches, etc. won't count for a LOD's height) \n"
 									+ "")
 							.setPerformance(EConfigEntryPerformance.NONE)
-							.addListener(ReloadLodsConfigEventHandler.DELAYED_INSTANCE)
+							.addListener(ReloadLodsConfigEventHandler.INSTANCE)
 							.build();
 					
 					public static ConfigEntry<Boolean> tintWithAvoidedBlocks = new ConfigEntry.Builder<Boolean>()
@@ -266,7 +254,7 @@ public class Config
 									+ "False: skipped blocks will not change color of surface below them. "
 									+ "")
 							.setPerformance(EConfigEntryPerformance.NONE)
-							.addListener(ReloadLodsConfigEventHandler.DELAYED_INSTANCE)
+							.addListener(ReloadLodsConfigEventHandler.INSTANCE)
 							.build();
 					
 					public static ConfigEntry<Double> lodBias = new ConfigEntry.Builder<Double>()
@@ -287,7 +275,7 @@ public class Config
 									+ EDhApiLodShading.DISABLED + ": All LOD sides will be rendered with the same brightness. \n"
 									+ "")
 							.setPerformance(EConfigEntryPerformance.NONE)
-							.addListener(ReloadLodsConfigEventHandler.DELAYED_INSTANCE)
+							.addListener(ReloadLodsConfigEventHandler.INSTANCE)
 							.build();
 					
 					public static ConfigEntry<EDhApiGrassSideRendering> grassSideRendering = new ConfigEntry.Builder<EDhApiGrassSideRendering>()
@@ -300,7 +288,7 @@ public class Config
 									+ EDhApiGrassSideRendering.AS_DIRT + ": sides render entirely as dirt. \n"
 									+ "")
 							.setPerformance(EConfigEntryPerformance.NONE)
-							.addListener(ReloadLodsConfigEventHandler.DELAYED_INSTANCE)
+							.addListener(ReloadLodsConfigEventHandler.INSTANCE)
 							.build();
 					
 					public static ConfigEntry<Boolean> ditherDhFade = new ConfigEntry.Builder<Boolean>()
@@ -333,7 +321,7 @@ public class Config
 									+ "0 = black \n"
 									+ "1 = normal \n"
 									+ "2 = near white")
-							.addListener(ReloadLodsConfigEventHandler.DELAYED_INSTANCE)
+							.addListener(ReloadLodsConfigEventHandler.INSTANCE)
 							.build();
 					
 					public static ConfigEntry<Double> saturationMultiplier = new ConfigEntry.Builder<Double>() // TODO: Make this a float (the ClassicConfigGUI doesnt support floats)
@@ -344,26 +332,26 @@ public class Config
 									+ "0 = black and white \n"
 									+ "1 = normal \n"
 									+ "2 = very saturated")
-							.addListener(ReloadLodsConfigEventHandler.DELAYED_INSTANCE)
+							.addListener(ReloadLodsConfigEventHandler.INSTANCE)
 							.build();
 					
-					public static ConfigEntry<Integer> lodBiomeBlending = new ConfigEntry.Builder<Integer>()
-							.setMinDefaultMax(0,3,3) // going higher than 3 causes banding issues for blending across LOD borders and an exponential increase in load times
-							.comment(""
-									+ "This is the same as vanilla Biome Blending settings for Lod area. \n"
-									+ "    Note that anything other than '0' will greatly effect Lod building time. \n"
-									+ "\n"
-									+ "    '0' equals to Vanilla Biome Blending of '1x1' or 'OFF', \n"
-									+ "    '1' equals to Vanilla Biome Blending of '3x3', \n"
-									+ "    '2' equals to Vanilla Biome Blending of '5x5'...")
-							.addListener(ReloadLodsConfigEventHandler.DELAYED_INSTANCE)
-							.build();	
+					// TODO fixme
+					//public static ConfigEntry<Integer> lodBiomeBlending = new ConfigEntry.Builder<Integer>()
+					//		.setMinDefaultMax(0,1,7)
+					//		.comment(""
+					//				+ "This is the same as vanilla Biome Blending settings for Lod area. \n"
+					//				+ "    Note that anything other than '0' will greatly effect Lod building time \n"
+					//				+ "     and increase triangle count. The cost on chunk generation speed is also \n"
+					//				+ "     quite large if set too high.\n"
+					//				+ "\n"
+					//				+ "    '0' equals to Vanilla Biome Blending of '1x1' or 'OFF', \n"
+					//				+ "    '1' equals to Vanilla Biome Blending of '3x3', \n"
+					//				+ "    '2' equals to Vanilla Biome Blending of '5x5'...")
+					//		.build();	
 				}
 				
 				public static class Ssao
 				{
-					public static ConfigUIComment ssaoHeader = new ConfigUIComment.Builder().setParentConfigClass(Ssao.class).build();
-					
 					public static ConfigEntry<Boolean> enableSsao = new ConfigEntry.Builder<Boolean>()
 							.set(true)
 							.comment("Enable Screen Space Ambient Occlusion")
@@ -426,8 +414,6 @@ public class Config
 				
 				public static class GenericRendering
 				{
-					public static ConfigUIComment genericRendererHeader = new ConfigUIComment.Builder().setParentConfigClass(GenericRendering.class).build();
-					
 					public static ConfigEntry<Boolean> enableGenericRendering = new ConfigEntry.Builder<Boolean>()
 							.set(true)
 							.comment(""
@@ -475,8 +461,6 @@ public class Config
 					
 					
 					
-					public static ConfigUIComment fogHeader = new ConfigUIComment.Builder().setParentConfigClass(Fog.class).build();
-					
 					public static ConfigEntry<Boolean> enableDhFog = new ConfigEntry.Builder<Boolean>()
 							.set(true)
 							.comment(""
@@ -578,8 +562,6 @@ public class Config
 					
 					public static class HeightFog
 					{
-						public static ConfigUIComment heightFogHeader = new ConfigUIComment.Builder().setParentConfigClass(HeightFog.class).build();
-						
 						public static ConfigEntry<EDhApiHeightFogMixMode> heightFogMixMode = new ConfigEntry.Builder<EDhApiHeightFogMixMode>()
 								.set(EDhApiHeightFogMixMode.SPHERICAL)
 								.comment(""
@@ -675,8 +657,6 @@ public class Config
 				
 				public static class NoiseTexture
 				{
-					public static ConfigUIComment noiseTextureHeader = new ConfigUIComment.Builder().setParentConfigClass(NoiseTexture.class).build();
-					
 					public static ConfigEntry<Boolean> enableNoiseTexture = new ConfigEntry.Builder<Boolean>()
 							.set(true)
 							.comment(""
@@ -711,10 +691,8 @@ public class Config
 				
 				public static class Culling
 				{
-					public static ConfigUIComment cullingHeader = new ConfigUIComment.Builder().setParentConfigClass(Culling.class).build();
-					
 					public static ConfigEntry<Double> overdrawPrevention = new ConfigEntry.Builder<Double>()
-							.setMinDefaultMax(0.0, 0.0, 1.0) // TODO change -1 to auto
+							.setMinDefaultMax(0.0, 0.0, 1.0)
 							.comment(""
 									+ "Determines how far from the camera Distant Horizons will start rendering. \n"
 									+ "Measured as a percentage of the vanilla render distance.\n"
@@ -741,7 +719,7 @@ public class Config
 									+ " Tweaking the caveCullingHeight, can resolve some \n"
 									+ " of those issues. \n"
 									+ "")
-							.addListener(ReloadLodsConfigEventHandler.DELAYED_INSTANCE)
+							.addListener(ReloadLodsConfigEventHandler.INSTANCE)
 							.build();
 					
 					public static ConfigEntry<Integer> caveCullingHeight = new ConfigEntry.Builder<Integer>()
@@ -749,7 +727,7 @@ public class Config
 							.comment(""
 									+ "At what Y value should cave culling start? \n"
 									+ "Lower this value if you get walls for areas with 0 light.")
-							.addListener(ReloadLodsConfigEventHandler.DELAYED_INSTANCE)
+							.addListener(ReloadLodsConfigEventHandler.INSTANCE)
 							.build();
 					
 					public static ConfigEntry<Boolean> disableBeaconDistanceCulling = new ConfigEntry.Builder<Boolean>()
@@ -837,8 +815,6 @@ public class Config
 				
 				public static class Experimental
 				{
-					public static ConfigUIComment experimentalHeader = new ConfigUIComment.Builder().setParentConfigClass(Experimental.class).build();
-					
 					public static ConfigEntry<Integer> earthCurveRatio = new ConfigEntry.Builder<Integer>()
 							.setMinDefaultMax(0, 0, 5000)
 							.comment(""
@@ -861,8 +837,6 @@ public class Config
 			
 			public static class AutoUpdater
 			{
-				public static ConfigUIComment autoUpdaterHeader = new ConfigUIComment.Builder().setParentConfigClass(AutoUpdater.class).build();
-				
 				public static ConfigEntry<Boolean> enableAutoUpdater = new ConfigEntry.Builder<Boolean>()
 						.set(!isRunningInDevEnvironment())
 						.comment(""
@@ -890,8 +864,6 @@ public class Config
 			
 			public static class Multiplayer
 			{
-				public static ConfigUIComment multiplayerHeader = new ConfigUIComment.Builder().setParentConfigClass(Multiplayer.class).build();
-				
 				public static ConfigEntry<EDhApiServerFolderNameMode> serverFolderNameMode = new ConfigEntry.Builder<EDhApiServerFolderNameMode>()
 						.set(EDhApiServerFolderNameMode.NAME_ONLY)
 						.comment(""
@@ -908,8 +880,6 @@ public class Config
 			
 			public static class Debugging
 			{
-				public static ConfigUIComment debuggingHeader = new ConfigUIComment.Builder().setParentConfigClass(Debugging.class).build();
-				
 				public static ConfigEntry<EDhApiRendererMode> rendererMode = new ConfigEntry.Builder<EDhApiRendererMode>()
 						.set(EDhApiRendererMode.DEFAULT)
 						.comment(""
@@ -930,7 +900,6 @@ public class Config
 								+ EDhApiDebugRendering.SHOW_BLOCK_MATERIAL + ": LODs' color will be based on their material. \n"
 								+ EDhApiDebugRendering.SHOW_OVERLAPPING_QUADS + ": LODs will be drawn with total white, but overlapping quads will be drawn with red. \n"
 								+ "")
-						.addListener(ReloadLodsConfigEventHandler.DELAYED_INSTANCE)
 						.build();
 				
 				public static ConfigEntry<Boolean> lodOnlyMode = new ConfigEntry.Builder<Boolean>()
@@ -998,8 +967,6 @@ public class Config
 				
 				public static class DebugWireframe
 				{
-					public static ConfigUIComment debugWireframeHeader = new ConfigUIComment.Builder().setParentConfigClass(DebugWireframe.class).build();
-					
 					public static ConfigEntry<Boolean> enableRendering = new ConfigEntry.Builder<Boolean>()
 							.set(false)
 							.comment(""
@@ -1049,8 +1016,6 @@ public class Config
 				
 				public static class OpenGl
 				{
-					public static ConfigUIComment openGlHeader = new ConfigUIComment.Builder().setParentConfigClass(OpenGl.class).build();
-					
 					public static ConfigEntry<Boolean> overrideVanillaGLLogger = new ConfigEntry.Builder<Boolean>()
 							.set(true)
 							.comment(""
@@ -1098,54 +1063,50 @@ public class Config
 				
 				public static class ColumnBuilderDebugging
 				{
-					public static ConfigUIComment columnBuilderDebuggingHeader = new ConfigUIComment.Builder().setParentConfigClass(ColumnBuilderDebugging.class).build();
-					
 					public static ConfigEntry<Boolean> columnBuilderDebugEnable = new ConfigEntry.Builder<Boolean>()
 							.set(false)
 							.setAppearance(EConfigEntryAppearance.ONLY_IN_GUI)
-							.addListener(ReloadLodsConfigEventHandler.INSTANT_INSTANCE)
+							.addListener(ReloadLodsConfigEventHandler.INSTANCE)
 							.build();
 					public static ConfigEntry<Integer> columnBuilderDebugDetailLevel = new ConfigEntry.Builder<Integer>()
 							.set((int) DhSectionPos.SECTION_MINIMUM_DETAIL_LEVEL)
 							.setAppearance(EConfigEntryAppearance.ONLY_IN_GUI)
-							.addListener(ReloadLodsConfigEventHandler.INSTANT_INSTANCE)
+							.addListener(ReloadLodsConfigEventHandler.INSTANCE)
 							.build();
 					public static ConfigEntry<Integer> columnBuilderDebugXPos = new ConfigEntry.Builder<Integer>()
 							.set(0)
 							.setAppearance(EConfigEntryAppearance.ONLY_IN_GUI)
-							.addListener(ReloadLodsConfigEventHandler.INSTANT_INSTANCE)
+							.addListener(ReloadLodsConfigEventHandler.INSTANCE)
 							.build();
 					public static ConfigEntry<Integer> columnBuilderDebugZPos = new ConfigEntry.Builder<Integer>()
 							.set(0)
 							.setAppearance(EConfigEntryAppearance.ONLY_IN_GUI)
-							.addListener(ReloadLodsConfigEventHandler.INSTANT_INSTANCE)
+							.addListener(ReloadLodsConfigEventHandler.INSTANCE)
 							.build();
 					
 					public static ConfigEntry<Integer> columnBuilderDebugXRow = new ConfigEntry.Builder<Integer>()
 							.set(-1)
 							.setAppearance(EConfigEntryAppearance.ONLY_IN_GUI)
-							.addListener(ReloadLodsConfigEventHandler.INSTANT_INSTANCE)
+							.addListener(ReloadLodsConfigEventHandler.INSTANCE)
 							.build();
 					public static ConfigEntry<Integer> columnBuilderDebugZRow = new ConfigEntry.Builder<Integer>()
 							.set(-1)
 							.setAppearance(EConfigEntryAppearance.ONLY_IN_GUI)
-							.addListener(ReloadLodsConfigEventHandler.INSTANT_INSTANCE)
+							.addListener(ReloadLodsConfigEventHandler.INSTANCE)
 							.build();
 					public static ConfigEntry<Integer> columnBuilderDebugColumnIndex = new ConfigEntry.Builder<Integer>()
 							.set(-1)
 							.setAppearance(EConfigEntryAppearance.ONLY_IN_GUI)
-							.addListener(ReloadLodsConfigEventHandler.INSTANT_INSTANCE)
+							.addListener(ReloadLodsConfigEventHandler.INSTANCE)
 							.build();
 					
 				}
 				
 				public static class F3Screen
 				{
-					public static ConfigUIComment f3ScreenHeader = new ConfigUIComment.Builder().setParentConfigClass(F3Screen.class).build();
-					
 					public static ConfigEntry<Boolean> showPlayerPos = new ConfigEntry.Builder<Boolean>()
 							.set(true)
-							.comment("Shows the player's LOD position.")
+							.comment("Shows info about each thread pool.")
 							.build();
 					public static ConfigEntry<Integer> playerPosSectionDetailLevel = new ConfigEntry.Builder<Integer>()
 							.setMinDefaultMax(6, 6, 16)
@@ -1186,10 +1147,8 @@ public class Config
 				// This will throw a warning when opened in the default ui to tell you about it not showing
 				public static class ExampleConfigScreen
 				{
-					public static ConfigUIComment exampleConfigHeader = new ConfigUIComment.Builder().setParentConfigClass(ExampleConfigScreen.class).build();
-					
 					// Defined in the lang, just a note about this screen
-					public static ConfigUIComment debugConfigScreenNote = new ConfigUIComment.Builder().setTextPosition(EConfigCommentTextPosition.CENTER_OF_SCREEN).build();
+					public static ConfigUIComment debugConfigScreenNote = new ConfigUIComment();
 					
 					public static ConfigEntry<Boolean> boolTest = new ConfigEntry.Builder<Boolean>()
 							.set(false)
@@ -1197,7 +1156,6 @@ public class Config
 					
 					public static ConfigEntry<Byte> byteTest = new ConfigEntry.Builder<Byte>()
 							.set((byte) 8)
-							.setAppearance(EConfigEntryAppearance.ONLY_IN_FILE) // no GUI renderer set up currently
 							.build();
 					
 					public static ConfigEntry<Integer> intTest = new ConfigEntry.Builder<Integer>()
@@ -1210,17 +1168,14 @@ public class Config
 					
 					public static ConfigEntry<Short> shortTest = new ConfigEntry.Builder<Short>()
 							.set((short) 69)
-							.setAppearance(EConfigEntryAppearance.ONLY_IN_FILE) // no GUI renderer set up currently
 							.build();
 					
 					public static ConfigEntry<Long> longTest = new ConfigEntry.Builder<Long>()
 							.set(42069L)
-							.setAppearance(EConfigEntryAppearance.ONLY_IN_FILE) // no GUI renderer set up currently
 							.build();
 					
 					public static ConfigEntry<Float> floatTest = new ConfigEntry.Builder<Float>()
 							.set(0.42069f)
-							.setAppearance(EConfigEntryAppearance.ONLY_IN_FILE) // no GUI renderer set up currently
 							.build();
 					
 					public static ConfigEntry<String> stringTest = new ConfigEntry.Builder<String>()
@@ -1229,12 +1184,10 @@ public class Config
 					
 					public static ConfigEntry<List<String>> listTest = new ConfigEntry.Builder<List<String>>()
 							.set(new ArrayList<String>(Arrays.asList("option 1", "option 2", "option 3")))
-							.setAppearance(EConfigEntryAppearance.ONLY_IN_FILE) // no GUI renderer set up currently
 							.build();
 					
 					public static ConfigEntry<Map<String, String>> mapTest = new ConfigEntry.Builder<Map<String, String>>()
 							.set(new HashMap<String, String>())
-							.setAppearance(EConfigEntryAppearance.ONLY_IN_FILE) // no GUI renderer set up currently
 							.build();
 					
 					public static ConfigUIButton uiButtonTest = new ConfigUIButton(() -> 
@@ -1278,8 +1231,6 @@ public class Config
 	{
 		public static class WorldGenerator
 		{
-			public static ConfigUIComment worldGeneratorHeader = new ConfigUIComment.Builder().setParentConfigClass(WorldGenerator.class).build();
-			
 			public static ConfigEntry<Boolean> enableDistantGeneration = new ConfigEntry.Builder<Boolean>()
 					.setChatCommandName("generation.enable")
 					.set(true)
@@ -1333,7 +1284,7 @@ public class Config
 					.build();
 			
 			public static ConfigEntry<EDhApiDistantGeneratorProgressDisplayLocation> showGenerationProgress = new ConfigEntry.Builder<EDhApiDistantGeneratorProgressDisplayLocation>()
-					.set(EDhApiDistantGeneratorProgressDisplayLocation.DISABLED)
+					.set(EDhApiDistantGeneratorProgressDisplayLocation.OVERLAY)
 					.comment(""
 							+ "How should distant generator progress be displayed? \n"
 							+ "\n"
@@ -1360,21 +1311,10 @@ public class Config
 							+ "")
 					.build();
 			
-			public static ConfigEntry<Boolean> generationProgressIncludeChunksPerSecond = new ConfigEntry.Builder<Boolean>()
-					.set(true)
-					.comment(""
-							+ "When logging generation progress also include the rate at which chunks \n"
-							+ "are being generated. \n"
-							+ "This can be useful for troubleshooting performance. \n"
-							+ "")
-					.build();
-			
 		}
 		
 		public static class LodBuilding
 		{
-			public static ConfigUIComment lodBuildingHeader = new ConfigUIComment.Builder().setParentConfigClass(LodBuilding.class).build();
-			
 			public static ConfigEntry<Boolean> disableUnchangedChunkCheck = new ConfigEntry.Builder<Boolean>()
 					.set(false)
 					// enabling this can be quite detrimental to performance,
@@ -1394,7 +1334,7 @@ public class Config
 					.build();
 			
 			public static ConfigEntry<EDhApiDataCompressionMode> dataCompression = new ConfigEntry.Builder<EDhApiDataCompressionMode>()
-					.set(EDhApiDataCompressionMode.Z_STD)
+					.set(EDhApiDataCompressionMode.LZMA2)
 					.comment(""
 							+ "What algorithm should be used to compress new LOD data? \n"
 							+ "This setting will only affect new or updated LOD data, \n"
@@ -1404,26 +1344,20 @@ public class Config
 							+ EDhApiDataCompressionMode.UNCOMPRESSED + " \n"
 							+ "Should only be used for testing, is worse in every way vs ["+EDhApiDataCompressionMode.LZ4+"].\n"
 							+ "Expected Compression Ratio: 1.0\n"
-							+ "Estimated average DTO read speed: 6.09 milliseconds\n"
-							+ "Estimated average DTO write speed: 6.01 milliseconds\n"
+							+ "Estimated average DTO read speed: 1.64 milliseconds\n"
+							+ "Estimated average DTO write speed: 12.44 milliseconds\n"
 							+ "\n"
 							+ EDhApiDataCompressionMode.LZ4 + " \n"
 							+ "A good option if you're CPU limited and have plenty of hard drive space.\n"
-							+ "Expected Compression Ratio: 0.4513\n"
-							+ "Estimated average DTO read speed: 3.25 ms\n"
-							+ "Estimated average DTO write speed: 5.99 ms\n"
-							+ "\n"
-							+ EDhApiDataCompressionMode.Z_STD + " \n"
-							+ "A good option if you're CPU limited and have plenty of hard drive space.\n"
-							+ "Expected Compression Ratio: 0.2606\n"
-							+ "Estimated average DTO read speed: 9.31 ms\n"
-							+ "Estimated average DTO write speed: 15.13 ms\n"
+							+ "Expected Compression Ratio: 0.36\n"
+							+ "Estimated average DTO read speed: 1.85 ms\n"
+							+ "Estimated average DTO write speed: 9.46 ms\n"
 							+ "\n"
 							+ EDhApiDataCompressionMode.LZMA2 + " \n"
 							+ "Slow but very good compression.\n"
-							+ "Expected Compression Ratio: 0.2\n"
-							+ "Estimated average DTO read speed: 13.29 ms\n"
-							+ "Estimated average DTO write speed: 70.95 ms\n"
+							+ "Expected Compression Ratio: 0.14\n"
+							+ "Estimated average DTO read speed: 11.89 ms\n"
+							+ "Estimated average DTO write speed: 192.01 ms\n"
 							+ "")
 					.build();
 			
@@ -1496,8 +1430,6 @@ public class Config
 			
 			public static class Experimental
 			{
-				public static ConfigUIComment experimentalHeader = new ConfigUIComment.Builder().setParentConfigClass(Experimental.class).build();
-				
 				public static ConfigEntry<Boolean> upsampleLowerDetailLodsToFillHoles = new ConfigEntry.Builder<Boolean>()
 						.set(false)
 						.comment(""
@@ -1520,8 +1452,6 @@ public class Config
 		
 		public static class MultiThreading
 		{
-			public static ConfigUIComment multiThreadingHeader = new ConfigUIComment.Builder().setParentConfigClass(MultiThreading.class).build();
-			
 			public static final ConfigEntry<Integer> numberOfThreads = new ConfigEntry.Builder<Integer>()
 					.setChatCommandName("threading.numberOfThreads")
 					.setMinDefaultMax(1,
@@ -1550,8 +1480,6 @@ public class Config
 		
 		public static class Logging
 		{
-			public static ConfigUIComment loggingHeader = new ConfigUIComment.Builder().setParentConfigClass(Logging.class).build();
-			
 			// TODO add change all option
 			// TODO default to error chat and info file
 			public static ConfigEntry<EDhApiLoggerMode> logWorldGenEvent = new ConfigEntry.Builder<EDhApiLoggerMode>()
@@ -1594,7 +1522,7 @@ public class Config
 			
 			public static ConfigEntry<EDhApiLoggerMode> logNetworkEvent = new ConfigEntry.Builder<EDhApiLoggerMode>()
 					.setChatCommandName("logging.logNetworkEvent")
-					.set(EDhApiLoggerMode.LOG_ERROR_TO_CHAT_AND_WARNING_TO_FILE)
+					.set(EDhApiLoggerMode.LOG_ERROR_TO_CHAT_AND_INFO_TO_FILE)
 					.comment(""
 							+ "If enabled, the mod will log information about network operations. \n"
 							+ "This can be useful for debugging.")
@@ -1606,7 +1534,6 @@ public class Config
 			
 			public static class Warning
 			{
-				public static ConfigUIComment warningHeader = new ConfigUIComment.Builder().setParentConfigClass(Warning.class).build();
 				
 				public static ConfigEntry<Boolean> showLowMemoryWarningOnStartup = new ConfigEntry.Builder<Boolean>()
 						.set(true)
@@ -1695,15 +1622,6 @@ public class Config
 						+ "")
 				.build();
 		
-		public static ConfigEntry<Integer> maxGenerationRequestDistance = new ConfigEntry.Builder<Integer>()
-				.setChatCommandName("generation.maxRequestDistance")
-				.setMinDefaultMax(256, 4096, 4096)
-				.comment("" +
-						"Defines the distance allowed to generate around the player." +
-						"")
-				.setPerformance(EConfigEntryPerformance.HIGH)
-				.build();
-		
 		public static ConfigEntry<Integer> generationBoundsX = new ConfigEntry.Builder<Integer>()
 				.setChatCommandName("generation.bounds.x")
 				.setAppearance(EConfigEntryAppearance.ONLY_IN_FILE)
@@ -1780,24 +1698,16 @@ public class Config
 		
 		
 		// Common
-		public static ConfigEntry<Integer> playerBandwidthLimit = new ConfigEntry.Builder<Integer>()
-				.setChatCommandName("common.playerBandwidthLimit")
+		public static ConfigEntry<Integer> maxDataTransferSpeed = new ConfigEntry.Builder<Integer>()
+				.setChatCommandName("common.maxDataTransferSpeed")
 				.setMinDefaultMax(0, 500, 1000000 /* 1 GB/s */)
 				.comment(""
-						+ "Maximum per-player speed for uploading LODs to the clients, in KB/s.\n"
-						+ "Value of 0 disables the limit."
-						+ "")
-				.build();
-		public static ConfigEntry<Integer> globalBandwidthLimit = new ConfigEntry.Builder<Integer>()
-				.setChatCommandName("common.globalBandwidthLimit")
-				.setMinDefaultMax(0, 0, 10000000 /* 10 GB/s */)
-				.comment(""
-						+ "Maximum global speed for uploading LODs to the clients, in KB/s.\n"
+						+ "Maximum speed for uploading LODs to the clients, in KB/s.\n"
 						+ "Value of 0 disables the limit."
 						+ "")
 				.build();
 		public static ConfigEntry<Boolean> enableAdaptiveTransferSpeed = new ConfigEntry.Builder<Boolean>()
-				.set(false)
+				.set(true)
 				.comment(""
 						+ "Enables adaptive transfer speed based on client performance.\n"
 						+ "If true, DH will automatically adjust transfer rate to minimize connection lag.\n"
@@ -1854,6 +1764,7 @@ public class Config
 				RenderQualityPresetConfigEventHandler.INSTANCE.setUiOnlyConfigValues();
 				QuickRenderToggleConfigEventHandler.INSTANCE.setUiOnlyConfigValues();
 				QuickShowWorldGenProgressConfigEventHandler.INSTANCE.setUiOnlyConfigValues();
+				RenderCacheConfigEventHandler.getInstance();
 			}
 			catch (Exception e)
 			{

core/src/main/java/com/seibel/distanthorizons/core/config/ConfigBase.java

@@ -19,38 +19,46 @@
 
 package com.seibel.distanthorizons.core.config;
 
-import com.seibel.distanthorizons.core.config.file.ConfigFileHandler;
-import com.seibel.distanthorizons.core.config.types.*;
+import com.seibel.distanthorizons.core.config.file.ConfigFileHandling;
 import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
-import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
+import com.seibel.distanthorizons.core.config.types.AbstractConfigType;
+import com.seibel.distanthorizons.core.config.types.ConfigCategory;
+import com.seibel.distanthorizons.core.config.types.ConfigEntry;
+import com.seibel.distanthorizons.core.config.types.ConfigUiLinkedEntry;
 import com.seibel.distanthorizons.core.wrapperInterfaces.config.ILangWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftSharedWrapper;
-import com.seibel.distanthorizons.coreapi.ModInfo;
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 
-import java.lang.invoke.MethodHandles;
 import java.lang.reflect.Field;
 import java.nio.file.Path;
 import java.util.*;
 
 /**
- * Indexes and sets everything up for the file handling and gui.
- * This should be init after singletons have been bound
+ * Indexes and sets everything up for the file handling and gui
  *
  * @author coolGi
  * @author Ran
  * @version 2023-8-26
  */
+// Init the config after singletons have been blinded
 public class ConfigBase
 {
 	/** Our own config instance, don't modify unless you are the DH mod */
 	public static ConfigBase INSTANCE;
+	public ConfigFileHandling configFileINSTANCE;
+	
+	private final Logger logger;
+	public final String modID;
+	public final String modName;
+	public final int configVersion;
+	
+	public boolean isLoaded = false;
+	
 	
-	private static final Logger LOGGER = DhLoggerBuilder.getLogger();
 	
 	/**
-	 * What the config works with
+	 *      What the config works with
 	 * <br> 
 	 * <br> {@link Enum}
 	 * <br> {@link Boolean}
@@ -69,74 +77,61 @@ public class ConfigBase
 	 * <br> Map<String, T>
 	 * <br> HashMap<String, T>
 	 */
-	public static final List<Class<?>> ACCEPTABLE_INPUTS = new ArrayList<Class<?>>()
+	public static final List<Class<?>> acceptableInputs = new ArrayList<Class<?>>()
 	{{
-		this.add(Boolean.class);
-		this.add(Byte.class);
-		this.add(Integer.class);
-		this.add(Double.class);
-		this.add(Short.class);
-		this.add(Long.class);
-		this.add(Float.class);
-		this.add(String.class);
+		add(Boolean.class);
+		add(Byte.class);
+		add(Integer.class);
+		add(Double.class);
+		add(Short.class);
+		add(Long.class);
+		add(Float.class);
+		add(String.class);
 		
 		// TODO[CONFIG]: Check the type of these is valid
-		this.add(List.class);
-		this.add(ArrayList.class);
-		this.add(Map.class);
-		this.add(HashMap.class);
+		add(List.class);
+		add(ArrayList.class);
+		add(Map.class);
+		add(HashMap.class);
 	}};
 	
-	
-	
-	public ConfigFileHandler configFileHandler;
-	
-	public final int configVersion;
-	
-	public boolean isLoaded = false;
-	
 	/** Disables the minimum and maximum of any variable */
 	public boolean disableMinMax = false; // Very fun to use, but should always be disabled by default
 	public final List<AbstractConfigType<?, ?>> entries = new ArrayList<>();
 	
 	
-	
-	//=============//
-	// constructor //
-	//=============//
-	
-	public static void RunFirstTimeSetup()
+	public ConfigBase(String modID, String modName, Class<?> configClass)
 	{
-		if (INSTANCE != null)
-		{
-			LOGGER.debug("ConfigBase setup already run, ignoring.");
-			return;
-		}
-		
-		INSTANCE = new ConfigBase(Config.class, ModInfo.CONFIG_FILE_VERSION);
+		this(modID, modName, configClass, getConfigPath(modName), -1);
+	}
+	public ConfigBase(String modID, String modName, Class<?> configClass, Path configPath)
+	{
+		this(modID, modName, configClass, configPath, -1);
+	}
+	public ConfigBase(String modID, String modName, Class<?> configClass, int configVersion)
+	{
+		this(modID, modName, configClass, getConfigPath(modName), configVersion);
 	}
 	
-	private ConfigBase(Class<?> configClass, int configVersion)
+	public ConfigBase(String modID, String modName, Class<?> configClass, Path configPath, int configVersion)
 	{
-		LOGGER.info("Initialising config for [" + ModInfo.NAME + "]");
+		this.logger = LogManager.getLogger(this.getClass().getSimpleName() + ", " + modID);
 		
+		this.logger.info("Initialising config for " + modName);
+		this.modID = modID;
+		this.modName = modName;
 		this.configVersion = configVersion;
 		
 		this.initNestedClass(configClass, ""); // Init root category
 		
-		Path configPath = getConfigPath(ModInfo.NAME);
-		this.configFileHandler = new ConfigFileHandler(this, configPath);
-		this.configFileHandler.loadFromFile();
+		// File handling (load from file)
+		this.configFileINSTANCE = new ConfigFileHandling(this, configPath);
+		this.configFileINSTANCE.loadFromFile();
 		
 		this.isLoaded = true;
-		LOGGER.info("Config for [" + ModInfo.NAME + "] initialised");
-	}
-	/** Gets the default config path given a mod name */
-	private static Path getConfigPath(String modName)
-	{
-		return SingletonInjector.INSTANCE.get(IMinecraftSharedWrapper.class)
-				.getInstallationDirectory().toPath().resolve("config").resolve(modName + ".toml");
+		this.logger.info("Config for " + modName + " initialised");
 	}
+	
 	private void initNestedClass(Class<?> configClass, String category)
 	{
 		// Put all the entries in entries
@@ -151,7 +146,7 @@ public class ConfigBase
 				}
 				catch (IllegalAccessException exception)
 				{
-					LOGGER.warn(exception);
+					this.logger.warn(exception);
 				}
 				
 				AbstractConfigType<?, ?> entry = this.entries.get(this.entries.size() - 1);
@@ -160,12 +155,11 @@ public class ConfigBase
 				entry.configBase = this;
 				
 				if (ConfigEntry.class.isAssignableFrom(field.getType()))
-				{ 
-					// If item is type ConfigEntry
+				{ // If item is type ConfigEntry
 					if (!isAcceptableType(entry.getType()))
 					{
-						LOGGER.error("Invalid variable type at [" + (category.isEmpty() ? "" : category + ".") + field.getName() + "].");
-						LOGGER.error("Type [" + entry.getType() + "] is not one of these types [" + ACCEPTABLE_INPUTS.toString() + "]");
+						this.logger.error("Invalid variable type at [" + (category.isEmpty() ? "" : category + ".") + field.getName() + "].");
+						this.logger.error("Type [" + entry.getType() + "] is not one of these types [" + acceptableInputs.toString() + "]");
 						this.entries.remove(this.entries.size() - 1); // Delete the entry if it is invalid so the game can still run
 					}
 				}
@@ -183,31 +177,32 @@ public class ConfigBase
 			}
 		}
 	}
+	
 	private static boolean isAcceptableType(Class<?> Clazz)
 	{
 		if (Clazz.isEnum())
-		{
 			return true;
-		}
-		
-		return ACCEPTABLE_INPUTS.contains(Clazz);
+		return acceptableInputs.contains(Clazz);
 	}
 	
 	
+	/** Gets the default config path given a mod name */
+	public static Path getConfigPath(String modName)
+	{
+		return SingletonInjector.INSTANCE.get(IMinecraftSharedWrapper.class)
+				.getInstallationDirectory().toPath().resolve("config").resolve(modName + ".toml");
+	}
 	
-	//===============//
-	// lang handling //
-	//===============//
 	
 	/**
-	 * Used for checking that all the lang files for the config exist.
-	 * This is just to re-format the lang or check if there is something in the lang that is missing
+	 * Used for checking that all the lang files for the config exist
 	 *
-	 * @param onlyShowMissing If false then this will remake the entire config lang
+	 * @param onlyShowNew If disabled then it would basically remake the config lang
 	 * @param checkEnums Checks if all the lang for the enum's exist
 	 */
+	// This is just to re-format the lang or check if there is something in the lang that is missing
 	@SuppressWarnings("unchecked")
-	public String generateLang(boolean onlyShowMissing, boolean checkEnums)
+	public String generateLang(boolean onlyShowNew, boolean checkEnums)
 	{
 		ILangWrapper langWrapper = SingletonInjector.INSTANCE.get(ILangWrapper.class);
 		List<Class<? extends Enum<?>>> enumList = new ArrayList<>();
@@ -218,86 +213,50 @@ public class ConfigBase
 		String separator = "\":\n    \"";
 		String ending = "\",\n";
 		
-		// config entries
 		for (AbstractConfigType<?, ?> entry : this.entries)
 		{
-			String entryPrefix = "distanthorizons.config." + entry.getNameWCategory();
+			String entryPrefix = "lod.config." + entry.getNameWCategory();
 			
-			if (checkEnums 
-				&& entry.getType().isEnum() 
-				&& !enumList.contains(entry.getType()))
-			{ 
-				// Put it in an enum list to work with at the end
+			if (checkEnums && entry.getType().isEnum() && !enumList.contains(entry.getType()))
+			{ // Put it in an enum list to work with at the end
 				enumList.add((Class<? extends Enum<?>>) entry.getType());
 			}
-			
-			
-			// config file items don't need lang entries
-			if (!entry.getAppearance().showInGui)
+			if (!onlyShowNew || langWrapper.langExists(entryPrefix))
 			{
-				continue;
-			}
-			
-			// some entries don't need localization
-			if (ConfigUiLinkedEntry.class.isAssignableFrom(entry.getClass())
-				|| ConfigUISpacer.class.isAssignableFrom(entry.getClass()))
-			{
-				continue;
-			}
-			
-			if (ConfigUIComment.class.isAssignableFrom(entry.getClass())
-				&& ((ConfigUIComment)entry).parentConfigPath != null)
-			{
-				// TODO this could potentially add the same item multiple times
-				entryPrefix = "distanthorizons.config." + ((ConfigUIComment)entry).parentConfigPath;
-			}
-			
-			
-			if (langWrapper.langExists(entryPrefix)
-				&& onlyShowMissing)
-			{
-				continue;
-			}
-			
-			
-			generatedLang += starter
-					+ entryPrefix
-					+ separator
-					+ langWrapper.getLang(entryPrefix)
-					+ ending
-			;
-			
-			// only add tooltips for entries that are also missing
-			// their primary lang
-			// this is done since not all menu items need a tooltip
-			if (!langWrapper.langExists(entryPrefix + ".@tooltip") 
-				|| !onlyShowMissing)
-			{
-				generatedLang += starter
-						+ entryPrefix + ".@tooltip"
-						+ separator
-						+ langWrapper.getLang(entryPrefix + ".@tooltip")
-						.replaceAll("\n", "\\\\n")
-						.replaceAll("\"", "\\\\\"")
-						+ ending
-				;
+				if (!ConfigUiLinkedEntry.class.isAssignableFrom(entry.getClass()))
+				{ // If it is a linked item, dont generate the base lang
+					generatedLang += starter
+							+ entryPrefix
+							+ separator
+							+ langWrapper.getLang(entryPrefix)
+							+ ending
+					;
+				}
+				// Adds tooltips
+				if (langWrapper.langExists(entryPrefix + ".@tooltip"))
+				{
+					generatedLang += starter
+							+ entryPrefix + ".@tooltip"
+							+ separator
+							+ langWrapper.getLang(entryPrefix + ".@tooltip")
+							.replaceAll("\n", "\\\\n")
+							.replaceAll("\"", "\\\\\"")
+							+ ending
+					;
+				}
 			}
 		}
-		
-		
-		// enums
 		if (!enumList.isEmpty())
 		{
 			generatedLang += "\n"; // Separate the main lang with the enum's
 			
 			for (Class<? extends Enum> anEnum : enumList)
 			{
-				for (Object enumStr : new ArrayList<Object>(EnumSet.allOf(anEnum)))
+				for (Object enumStr : new ArrayList<>(EnumSet.allOf(anEnum)))
 				{
-					String enumPrefix = "distanthorizons.config.enum." + anEnum.getSimpleName() + "." + enumStr.toString();
+					String enumPrefix = "lod.config.enum." + anEnum.getSimpleName() + "." + enumStr.toString();
 					
-					if (!langWrapper.langExists(enumPrefix) 
-						|| !onlyShowMissing)
+					if (!onlyShowNew || langWrapper.langExists(enumPrefix))
 					{
 						generatedLang += starter
 								+ enumPrefix
@@ -313,6 +272,4 @@ public class ConfigBase
 		return generatedLang;
 	}
 	
-	
-	
 }

core/src/main/java/com/seibel/distanthorizons/core/config/ConfigEntryWithPresetOptions.java

@@ -48,9 +48,7 @@ public class ConfigEntryWithPresetOptions<TQuickEnum, TConfig>
 	
 	public HashSet<TQuickEnum> getPossibleQualitiesFromCurrentOptionValue()
 	{
-		// get true value so we can ignore API overrides,
-		// users find this confusing if their preset is set to "CUSTOM" 
-		TConfig inputOptionValue = this.configEntry.getTrueValue();
+		TConfig inputOptionValue = this.configEntry.get();
 		HashSet<TQuickEnum> possibleQualities = new HashSet<>();
 		
 		for (TQuickEnum key : this.configOptionByQualityOption.keySet())

core/src/main/java/com/seibel/distanthorizons/core/config/eventHandlers/ReloadLodsConfigEventHandler.java

@@ -22,77 +22,13 @@ package com.seibel.distanthorizons.core.config.eventHandlers;
 import com.seibel.distanthorizons.api.DhApi;
 import com.seibel.distanthorizons.api.interfaces.render.IDhApiRenderProxy;
 import com.seibel.distanthorizons.core.config.listeners.IConfigListener;
-import com.seibel.distanthorizons.core.util.TimerUtil;
-
-import java.util.Timer;
-import java.util.TimerTask;
 
 public class ReloadLodsConfigEventHandler implements IConfigListener
 {
-	/** 
-	 * should be used for user facing UI options
-	 * this allows the user a second to click through options before they're applied
-	 */
-	public static ReloadLodsConfigEventHandler DELAYED_INSTANCE = new ReloadLodsConfigEventHandler(2_000L);
-	/** should be used for debug options so their change can be seen instantly */
-	public static ReloadLodsConfigEventHandler INSTANT_INSTANCE = new ReloadLodsConfigEventHandler(0);
-	
-	/** how long to wait in milliseconds before applying the config changes */
-	private final long timeoutInMs;
-	private Timer cacheClearingTimer;
-	
-	
-	
-	//=============//
-	// constructor //
-	//=============//
-	
-	public ReloadLodsConfigEventHandler(long timeoutInMs)
-	{
-		this.timeoutInMs = timeoutInMs;
-	}
-	
-	
-	
-	//========//
-	// events //
-	//========//
+	public static ReloadLodsConfigEventHandler INSTANCE = new ReloadLodsConfigEventHandler();
 	
 	@Override
 	public void onConfigValueSet()
-	{ 
-		if (this.timeoutInMs > 0)
-		{
-			this.refreshRenderDataAfterTimeout();
-		}
-		else
-		{
-			clearRenderDataCache();
-		}
-	}
-	
-	/** Calling this method multiple times will reset the timer */
-	private synchronized void refreshRenderDataAfterTimeout() // synchronized to prevent potential threading issues when adding/removing the timer
-	{
-		// stop the previous timer if one exists
-		if (this.cacheClearingTimer != null)
-		{
-			this.cacheClearingTimer.cancel();
-		}
-		
-		// create a new timer task
-		TimerTask timerTask = new TimerTask()
-		{
-			public void run()
-			{
-				clearRenderDataCache();
-			}
-		};
-		this.cacheClearingTimer = TimerUtil.CreateTimer("RenderCacheClearConfigTimer");
-		this.cacheClearingTimer.schedule(timerTask, this.timeoutInMs);
-	}
-	
-	private static void clearRenderDataCache()
 	{
 		IDhApiRenderProxy renderProxy = DhApi.Delayed.renderProxy;
 		if (renderProxy != null)
@@ -101,5 +37,4 @@ public class ReloadLodsConfigEventHandler implements IConfigListener
 		}
 	}
 	
-	
 }

core/src/main/java/com/seibel/distanthorizons/core/config/eventHandlers/RenderCacheConfigEventHandler.java

@@ -0,0 +1,114 @@
+/*
+ *    This file is part of the Distant Horizons mod
+ *    licensed under the GNU LGPL 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 Lesser 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 Lesser General Public License for more details.
+ *
+ *    You should have received a copy of the GNU Lesser General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package com.seibel.distanthorizons.core.config.eventHandlers;
+
+import com.seibel.distanthorizons.api.DhApi;
+import com.seibel.distanthorizons.api.enums.config.*;
+import com.seibel.distanthorizons.api.enums.rendering.EDhApiDebugRendering;
+import com.seibel.distanthorizons.api.enums.rendering.EDhApiTransparency;
+import com.seibel.distanthorizons.core.config.listeners.ConfigChangeListener;
+import com.seibel.distanthorizons.core.config.Config;
+import com.seibel.distanthorizons.core.util.TimerUtil;
+
+import java.util.Timer;
+import java.util.TimerTask;
+
+/**
+ * Listens to the config and will automatically
+ * clear the current render cache if certain settings are changed. <br> <br>
+ *
+ * Note: if additional settings should clear the render cache, add those to this listener, don't create a new listener
+ */
+public class RenderCacheConfigEventHandler
+{
+	private static RenderCacheConfigEventHandler INSTANCE;
+	
+	
+	// previous values used to check if a watched setting was actually modified
+	private final ConfigChangeListener<EDhApiMaxHorizontalResolution> horizontalResolutionChangeListener;
+	private final ConfigChangeListener<EDhApiVerticalQuality> verticalQualityChangeListener;
+	private final ConfigChangeListener<EDhApiTransparency> transparencyChangeListener;
+	private final ConfigChangeListener<EDhApiBlocksToAvoid> blocksToIgnoreChangeListener;
+	private final ConfigChangeListener<Boolean> tintWithAvoidedBlocksChangeListener;
+	
+	private final ConfigChangeListener<Double> brightnessMultiplierChangeListener;
+	private final ConfigChangeListener<Double> saturationMultiplierChangeListener;
+	private final ConfigChangeListener<EDhApiLodShading> lodShadingChangeListener;
+	private final ConfigChangeListener<EDhApiGrassSideRendering> grassSideChangeListener;
+	
+	private final ConfigChangeListener<EDhApiDebugRendering> debugRenderingChangeListener;
+	
+	/** how long to wait in milliseconds before applying the config changes */
+	private static final long TIMEOUT_IN_MS = 4_000L;
+	private Timer cacheClearingTimer;
+	
+	
+	
+	public static RenderCacheConfigEventHandler getInstance()
+	{
+		if (INSTANCE == null)
+		{
+			INSTANCE = new RenderCacheConfigEventHandler();
+		}
+		
+		return INSTANCE;
+	}
+	
+	/** private since we only ever need one handler at a time */
+	private RenderCacheConfigEventHandler()
+	{
+		this.horizontalResolutionChangeListener = new ConfigChangeListener<>(Config.Client.Advanced.Graphics.Quality.maxHorizontalResolution, (newValue) -> this.refreshRenderDataAfterTimeout());
+		this.verticalQualityChangeListener = new ConfigChangeListener<>(Config.Client.Advanced.Graphics.Quality.verticalQuality, (newValue) -> this.refreshRenderDataAfterTimeout());
+		this.transparencyChangeListener = new ConfigChangeListener<>(Config.Client.Advanced.Graphics.Quality.transparency, (newValue) -> this.refreshRenderDataAfterTimeout());
+		this.blocksToIgnoreChangeListener = new ConfigChangeListener<>(Config.Client.Advanced.Graphics.Quality.blocksToIgnore, (newValue) -> this.refreshRenderDataAfterTimeout());
+		this.tintWithAvoidedBlocksChangeListener = new ConfigChangeListener<>(Config.Client.Advanced.Graphics.Quality.tintWithAvoidedBlocks, (newValue) -> this.refreshRenderDataAfterTimeout());
+		
+		this.brightnessMultiplierChangeListener = new ConfigChangeListener<>(Config.Client.Advanced.Graphics.Quality.brightnessMultiplier, (newValue) -> this.refreshRenderDataAfterTimeout());
+		this.saturationMultiplierChangeListener = new ConfigChangeListener<>(Config.Client.Advanced.Graphics.Quality.saturationMultiplier, (newValue) -> this.refreshRenderDataAfterTimeout());
+		this.lodShadingChangeListener = new ConfigChangeListener<>(Config.Client.Advanced.Graphics.Quality.lodShading, (newValue) -> this.refreshRenderDataAfterTimeout());
+		this.grassSideChangeListener = new ConfigChangeListener<>(Config.Client.Advanced.Graphics.Quality.grassSideRendering, (newValue) -> this.refreshRenderDataAfterTimeout());
+		
+		this.debugRenderingChangeListener = new ConfigChangeListener<>(Config.Client.Advanced.Debugging.debugRendering, (newValue) -> this.refreshRenderDataAfterTimeout());
+		
+	}
+	
+	
+	/** Calling this method multiple times will reset the timer */
+	private void refreshRenderDataAfterTimeout()
+	{
+		// stop the previous timer if one exists
+		if (this.cacheClearingTimer != null)
+		{
+			this.cacheClearingTimer.cancel();
+		}
+		
+		// create a new timer task
+		TimerTask timerTask = new TimerTask()
+		{
+			public void run()
+			{
+				DhApi.Delayed.renderProxy.clearRenderDataCache();
+			}
+		};
+		this.cacheClearingTimer = TimerUtil.CreateTimer("RenderCacheClearConfigTimer");
+		this.cacheClearingTimer.schedule(timerTask, TIMEOUT_IN_MS);
+	}
+	
+}

core/src/main/java/com/seibel/distanthorizons/core/config/eventHandlers/presets/RenderQualityPresetConfigEventHandler.java

@@ -105,24 +105,6 @@ public class RenderQualityPresetConfigEventHandler extends AbstractPresetConfigE
 				this.put(EDhApiQualityPreset.HIGH, true);
 				this.put(EDhApiQualityPreset.EXTREME, true);
 			}});
-	private final ConfigEntryWithPresetOptions<EDhApiQualityPreset, Boolean> caveCulling = new ConfigEntryWithPresetOptions<>(Config.Client.Advanced.Graphics.Culling.enableCaveCulling,
-			new HashMap<EDhApiQualityPreset, Boolean>()
-			{{
-				this.put(EDhApiQualityPreset.MINIMUM, true);
-				this.put(EDhApiQualityPreset.LOW, true);
-				this.put(EDhApiQualityPreset.MEDIUM, true);
-				this.put(EDhApiQualityPreset.HIGH, false);
-				this.put(EDhApiQualityPreset.EXTREME, false);
-			}});
-	private final ConfigEntryWithPresetOptions<EDhApiQualityPreset, Integer> biomeBlending = new ConfigEntryWithPresetOptions<>(Config.Client.Advanced.Graphics.Quality.lodBiomeBlending,
-			new HashMap<EDhApiQualityPreset, Integer>()
-			{{
-				this.put(EDhApiQualityPreset.MINIMUM, 0);
-				this.put(EDhApiQualityPreset.LOW, 1);
-				this.put(EDhApiQualityPreset.MEDIUM, 3);
-				this.put(EDhApiQualityPreset.HIGH, 3);
-				this.put(EDhApiQualityPreset.EXTREME, 3);
-			}});
 		
 	
 	
@@ -141,8 +123,6 @@ public class RenderQualityPresetConfigEventHandler extends AbstractPresetConfigE
 		this.configList.add(this.ssaoEnabled);
 		this.configList.add(this.vanillaFade);
 		this.configList.add(this.dhDither);
-		this.configList.add(this.caveCulling);
-		this.configList.add(this.biomeBlending);
 		
 		
 		for (ConfigEntryWithPresetOptions<EDhApiQualityPreset, ?> config : this.configList)

core/src/main/java/com/seibel/distanthorizons/core/config/file/ConfigFileHandling.java

@@ -27,7 +27,6 @@ import com.seibel.distanthorizons.core.config.types.ConfigEntry;
 import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
 import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftClientWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftSharedWrapper;
-import com.seibel.distanthorizons.coreapi.ModInfo;
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 
@@ -42,9 +41,10 @@ import java.util.concurrent.locks.ReentrantLock;
  * @author coolGi
  * @version 2023-8-26
  */
-public class ConfigFileHandler
+public class ConfigFileHandling
 {
 	private static final Logger LOGGER = DhLoggerBuilder.getLogger();
+	private static final IMinecraftSharedWrapper MC_SHARED = SingletonInjector.INSTANCE.get(IMinecraftSharedWrapper.class);
 	
 	
 	public final ConfigBase configBase;
@@ -64,25 +64,17 @@ public class ConfigFileHandler
 	// constructor //
 	//=============//
 	
-	public ConfigFileHandler(ConfigBase configBase, Path configPath)
+	public ConfigFileHandling(ConfigBase configBase, Path configPath)
 	{
-		this.logger = LogManager.getLogger(this.getClass().getSimpleName() + ", " + ModInfo.ID);
+		this.logger = LogManager.getLogger(this.getClass().getSimpleName() + ", " + configBase.modID);
 		this.configBase = configBase;
 		this.configPath = configPath;
 		
-		this.nightConfig = CommentedFileConfig
-				.builder(this.configPath.toFile())
-				// sync is needed so file reading/writing only happens during locked sections,
-				// otherwise some GUI changes may be lost when changing screens
-				.sync()
-				.build();
+		this.nightConfig = CommentedFileConfig.builder(this.configPath.toFile()).build();
 	}
 	
 	
 	
-	//====================//
-	// entire config file //
-	//====================//
 	
 	/** Saves the entire config to the file */
 	public void saveToFile() { this.saveToFile(this.nightConfig); }
@@ -164,7 +156,7 @@ public class ConfigFileHandler
 			}
 			else // if (currentCfgVersion < configBase.configVersion)
 			{
-				this.logger.warn(ModInfo.NAME + " config is of an older version, currently there is no config updater... so resetting config");
+				this.logger.warn(this.configBase.modName + " config is of an older version, currently there is no config updater... so resetting config");
 				try
 				{
 					Files.delete(this.configPath);
@@ -226,9 +218,6 @@ public class ConfigFileHandler
 	
 	
 	
-	//=======================//
-	// single config entries //
-	//=======================//
 	
 	// Save an entry when only given the entry
 	public void saveEntry(ConfigEntry<?> entry)
@@ -246,7 +235,7 @@ public class ConfigFileHandler
 		else if (entry.getTrueValue() == null)
 		{
 			// TODO when can this happen?
-			throw new IllegalArgumentException("Entry [" + entry.getNameWCategory() + "] is null, this may be a problem with [" + ModInfo.NAME + "]. Please contact the authors.");
+			throw new IllegalArgumentException("Entry [" + entry.getNameWCategory() + "] is null, this may be a problem with [" + this.configBase.modName + "]. Please contact the authors.");
 		}
 		
 		workConfig.set(entry.getNameWCategory(), ConfigTypeConverters.attemptToConvertToString(entry.getType(), entry.getTrueValue()));
@@ -325,16 +314,17 @@ public class ConfigFileHandler
 	
 	
 	
-	//=============//
-	// nightconfig //
-	//=============//
+	
 	
 	/**
-	 * Uses {@link ConfigFileHandler#nightConfig} to do {@link CommentedFileConfig#load()} but with error checking
+	 * Uses {@link ConfigFileHandling#nightConfig} to do {@link CommentedFileConfig#load()} but with error checking
 	 *
 	 * @apiNote This overwrites any value currently stored in the config
 	 */
-	public void loadNightConfig() { this.loadNightConfig(this.nightConfig); }
+	public void loadNightConfig()
+	{
+		loadNightConfig(this.nightConfig);
+	}
 	/**
 	 * Does {@link CommentedFileConfig#load()} but with error checking
 	 *
@@ -363,16 +353,12 @@ public class ConfigFileHandler
 		{
 			System.out.println("Creating file failed");
 			this.logger.error(ex);
-			SingletonInjector.INSTANCE.get(IMinecraftClientWrapper.class).crashMinecraft("Loading file and resetting config file failed at path [" + this.configPath + "]. Please check the file is ok and you have the permissions", ex);
+			SingletonInjector.INSTANCE.get(IMinecraftClientWrapper.class).crashMinecraft("Loading file and resetting config file failed at path [" + configPath + "]. Please check the file is ok and you have the permissions", ex);
 		}
 	}
 	
 	
 	
-	//===============//
-	// file handling //
-	//===============//
-	
 	public static void reCreateFile(Path path)
 	{
 		try

core/src/main/java/com/seibel/distanthorizons/core/config/gui/JavaScreenHandlerScreen.java

@@ -23,7 +23,6 @@ import org.jetbrains.annotations.NotNull;
 
 import javax.swing.*;
 import java.awt.*;
-import java.awt.event.ActionEvent;
 import java.awt.event.KeyEvent;
 import java.awt.event.KeyListener;
 
@@ -36,8 +35,6 @@ public class JavaScreenHandlerScreen extends AbstractScreen
 	public static boolean firstRun = true;
 	public final Component jComponent;
 	
-	
-	
 	static
 	{
 		// Note: this code can cause Mac
@@ -57,25 +54,19 @@ public class JavaScreenHandlerScreen extends AbstractScreen
 	public void init()
 	{
 		if (firstRun)
-		{
 			frame = EmbeddedFrameUtil.embeddedFrameCreate(this.minecraftWindow); // Don't call this multiple times
-		}
 		
-		frame.add(this.jComponent);
-		frame.setBackground(new Color(0, 125, 155));
+		frame.add(jComponent);
 		
 		JavaScreenHandlerScreen thiss = this;
 		
-		frame.addKeyListener(new KeyListener() 
-		{
+		frame.addKeyListener(new KeyListener() {
 			@Override
 			public void keyPressed(KeyEvent keyEvent)
 			{
 				System.out.println("Key pressed code=" + keyEvent.getKeyCode() + ", char=" + keyEvent.getKeyChar());
 				if (keyEvent.getKeyCode() == KeyEvent.VK_ESCAPE)
-				{
 					thiss.close = true;
-				}
 			}
 			
 			@Override
@@ -89,8 +80,8 @@ public class JavaScreenHandlerScreen extends AbstractScreen
 			EmbeddedFrameUtil.embeddedFrameSetBounds(frame, 0, 0, this.width, this.height);
 			firstRun = false;
 		}
-		
-		EmbeddedFrameUtil.showFrame(frame);
+		else
+			EmbeddedFrameUtil.showFrame(frame);
 	}
 	
 	/** A testing/debug screen */
@@ -98,43 +89,13 @@ public class JavaScreenHandlerScreen extends AbstractScreen
 	{
 		public ExampleScreen()
 		{
-			this.setLayout(new GridBagLayout());
-			this.setBackground(new Color(255, 0, 0)); // doesn't appear to be used
-			
-			GridBagConstraints helloWorldConstraints = new GridBagConstraints();
-			helloWorldConstraints.weightx = 0.5;
-			helloWorldConstraints.gridx = 0;
-			helloWorldConstraints.gridy = 0;
-			//helloWorldConstraints.fill = GridBagConstraints.BOTH;
-			this.add(new JLabel("Hello World!"), helloWorldConstraints);
-			
-			
-			GridBagConstraints buttonConstraints = new GridBagConstraints();
-			buttonConstraints.weightx = 0.5;
-			buttonConstraints.gridx = 0;
-			buttonConstraints.gridy = 1;
-			//buttonConstraints.fill = GridBagConstraints.BOTH;
-			JButton button = new JButton();
-			button.setBackground(Color.GREEN);
-			button.setFocusable(false); // otherwise we can't use escape to leave
-			button.setAction(new ExampleButtonEventHandler("Button text"));
-			this.add(button, buttonConstraints);
-		}
-		
-		private class ExampleButtonEventHandler extends AbstractAction
-		{
-			public ExampleButtonEventHandler(String text)
-			{
-				super(text);
-				//this.putValue(SHORT_DESCRIPTION, text);
-				//this.putValue(MNEMONIC_KEY, text);
-			}
-			
-			@Override
-			public void actionPerformed(ActionEvent e)
-			{
-				System.out.println("button pressed");
-			}
+			setLayout(new GridBagLayout());
+			GridBagConstraints constraints = new GridBagConstraints();
+			constraints.fill = GridBagConstraints.HORIZONTAL;
+			constraints.weightx = 0.5;
+			constraints.gridx = 0;
+			constraints.gridy = 0;
+			add(new JLabel("Hello World!"), constraints);
 		}
 		
 	}
@@ -155,10 +116,8 @@ public class JavaScreenHandlerScreen extends AbstractScreen
 	@Override
 	public void onClose()
 	{
-		frame.remove(this.jComponent);
+		frame.remove(jComponent);
 		EmbeddedFrameUtil.hideFrame(frame);
 	}
 	
-	
-	
 }

core/src/main/java/com/seibel/distanthorizons/core/config/gui/OpenGLConfigScreen.java

@@ -0,0 +1,126 @@
+/*
+ *    This file is part of the Distant Horizons mod
+ *    licensed under the GNU LGPL 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 Lesser 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 Lesser General Public License for more details.
+ *
+ *    You should have received a copy of the GNU Lesser General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package com.seibel.distanthorizons.core.config.gui;
+
+import com.seibel.distanthorizons.api.enums.config.EDhApiGpuUploadMethod;
+import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
+import com.seibel.distanthorizons.core.render.glObject.buffer.GLVertexBuffer;
+import com.seibel.distanthorizons.core.render.glObject.shader.ShaderProgram;
+import com.seibel.distanthorizons.core.render.glObject.vertexAttribute.AbstractVertexAttribute;
+import com.seibel.distanthorizons.core.render.glObject.vertexAttribute.VertexPointer;
+import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftGLWrapper;
+import org.lwjgl.opengl.GL32;
+
+import java.nio.ByteBuffer;
+import java.nio.ByteOrder;
+
+/**
+ * @author coolGi
+ */
+public class OpenGLConfigScreen extends AbstractScreen
+{
+	private static final IMinecraftGLWrapper GLMC = SingletonInjector.INSTANCE.get(IMinecraftGLWrapper.class);
+	
+	private ShaderProgram basicShader;
+	private GLVertexBuffer sameContextBuffer;
+	private GLVertexBuffer sharedContextBuffer;
+	private AbstractVertexAttribute va;
+	
+	
+	
+	@Override
+	public void init()
+	{
+		System.out.println("init");
+		
+		this.va = AbstractVertexAttribute.create();
+		this.va.bind();
+		// Pos
+		this.va.setVertexAttribute(0, 0, VertexPointer.addVec2Pointer(false));
+		// Color
+		this.va.setVertexAttribute(0, 1, VertexPointer.addVec4Pointer(false));
+		this.va.completeAndCheck(Float.BYTES * 6);
+		this.basicShader = new ShaderProgram("shaders/test/vert.vert", "shaders/test/frag.frag",
+						"fragColor", new String[]{"vPosition", "color"});
+		this.createBuffer();
+	}
+	
+	// Render a square with uv color
+	private static final float[] vertices = {
+			// PosX,Y, ColorR,G,B,A
+			-0.5f, -0.5f, 0.0f, 0.0f, 0.0f, 1.0f,
+			0.4f, -0.4f, 1.0f, 0.0f, 0.0f, 1.0f,
+			0.3f, 0.3f, 1.0f, 1.0f, 0.0f, 0.0f,
+			-0.2f, 0.2f, 0.0f, 1.0f, 1.0f, 1.0f
+	};
+	
+	private static GLVertexBuffer createTextingBuffer()
+	{
+		ByteBuffer buffer = ByteBuffer.allocateDirect(vertices.length * Float.BYTES);
+		// Fill buffer with the vertices.
+		buffer = buffer.order(ByteOrder.nativeOrder());
+		buffer.asFloatBuffer().put(vertices);
+		buffer.rewind();
+		GLVertexBuffer vbo = new GLVertexBuffer(false);
+		vbo.bind();
+		vbo.uploadBuffer(buffer, 4, EDhApiGpuUploadMethod.DATA, vertices.length * Float.BYTES);
+		return vbo;
+	}
+	
+	private void createBuffer()
+	{
+		this.sharedContextBuffer = createTextingBuffer();
+		this.sameContextBuffer = createTextingBuffer();
+	}
+	
+	@Override
+	public void render(float delta)
+	{
+		System.out.println("Updated config screen with the delta of " + delta);
+		
+		GL32.glViewport(0, 0, this.width, this.height);
+		GL32.glPolygonMode(GL32.GL_FRONT_AND_BACK, GL32.GL_FILL);
+		GLMC.disableFaceCulling();
+		GLMC.disableDepthTest();
+		GLMC.disableBlend();
+		
+		this.basicShader.bind();
+		this.va.bind();
+		
+		// Switch between the two buffers per second
+		if (System.currentTimeMillis() % 2000 < 1000)
+		{
+			this.sameContextBuffer.bind();
+			this.va.bindBufferToAllBindingPoints(this.sameContextBuffer.getId());
+		}
+		else
+		{
+			this.sameContextBuffer.bind();
+			this.va.bindBufferToAllBindingPoints(this.sharedContextBuffer.getId());
+		}
+		// Render the square
+		GL32.glDrawArrays(GL32.GL_TRIANGLE_FAN, 0, 4);
+		GL32.glClear(GL32.GL_DEPTH_BUFFER_BIT);
+	}
+	
+	@Override
+	public void tick() { System.out.println("Ticked"); }
+	
+}

core/src/main/java/com/seibel/distanthorizons/core/config/types/ConfigEntry.java

@@ -21,7 +21,6 @@ package com.seibel.distanthorizons.core.config.types;
 
 
 import com.seibel.distanthorizons.core.config.NumberUtil;
-import com.seibel.distanthorizons.core.config.file.ConfigFileHandler;
 import com.seibel.distanthorizons.core.config.listeners.ConfigChangeListener;
 import com.seibel.distanthorizons.core.config.listeners.IConfigListener;
 import com.seibel.distanthorizons.core.config.types.enums.EConfigEntryAppearance;
@@ -95,15 +94,13 @@ public class ConfigEntry<T> extends AbstractConfigType<T, ConfigEntry<T>> implem
 	}
 	@Override
 	public T getApiValue() { return this.apiValue; }
-	@Override 
-	public boolean apiIsOverriding() { return this.allowApiOverride && this.apiValue != null; }
 	@Override
 	public boolean getAllowApiOverride() { return this.allowApiOverride; }
 	
 	/** 
 	 * DONT USE THIS IN YOUR CODE <br>
 	 * Sets the value without informing the rest of the code (ie, doesnt call listeners, or saves the value). <br>
-	 * Should only be used when loading the config from the file (in places like the {@link ConfigFileHandler} or {@link com.seibel.distanthorizons.core.config.ConfigBase})
+	 * Should only be used when loading the config from the file (in places like the {@link com.seibel.distanthorizons.core.config.file.ConfigFileHandling} or {@link com.seibel.distanthorizons.core.config.ConfigBase})
 	 */
 	public void pureSet(T newValue) {
 		super.set(newValue);
@@ -308,9 +305,9 @@ public class ConfigEntry<T> extends AbstractConfigType<T, ConfigEntry<T>> implem
 	}
 	
 	/** This should normally not be called since set() automatically calls this */
-	public void save() { configBase.configFileHandler.saveEntry(this); }
+	public void save() { configBase.configFileINSTANCE.saveEntry(this); }
 	/** This should normally not be called except for special circumstances */
-	public void load() { configBase.configFileHandler.loadEntry(this); }
+	public void load() { configBase.configFileINSTANCE.loadEntry(this); }
 	
 	
 	@Override

core/src/main/java/com/seibel/distanthorizons/core/config/types/ConfigUIComment.java

@@ -19,13 +19,7 @@
 
 package com.seibel.distanthorizons.core.config.types;
 
-import com.seibel.distanthorizons.core.config.Config;
-import com.seibel.distanthorizons.core.config.types.enums.EConfigCommentTextPosition;
 import com.seibel.distanthorizons.core.config.types.enums.EConfigEntryAppearance;
-import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
-import org.apache.logging.log4j.Logger;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
 
 /**
  * Adds something like a ConfigEntry but without a button to change the input
@@ -34,25 +28,11 @@ import org.jetbrains.annotations.Nullable;
  */
 public class ConfigUIComment extends AbstractConfigType<String, ConfigUIComment>
 {
-	private static final Logger LOGGER = DhLoggerBuilder.getLogger();
-	
-	
-	public String parentConfigPath = null;
-	@Nullable
-	public EConfigCommentTextPosition textPosition = null;
-	
-	
-	
-	public ConfigUIComment() { this(null, null); }
-	public ConfigUIComment(String parentConfigPath, EConfigCommentTextPosition textPosition)
+	public ConfigUIComment()
 	{
 		super(EConfigEntryAppearance.ONLY_IN_GUI, "");
-		this.parentConfigPath = parentConfigPath;
-		this.textPosition = textPosition;
 	}
 	
-	
-	
 	/** Appearance shouldn't be changed */
 	@Override
 	public void setAppearance(EConfigEntryAppearance newAppearance) { }
@@ -61,102 +41,26 @@ public class ConfigUIComment extends AbstractConfigType<String, ConfigUIComment>
 	@Override
 	public void set(String newValue) { }
 	
-	
-	
 	public static class Builder extends AbstractConfigType.Builder<String, Builder>
 	{
-		public String tempParentConfigPath = null;
-		public EConfigCommentTextPosition tempTextPosition = null;
-		
-		
-		
 		/** Appearance shouldn't be changed */
-		@Deprecated
 		@Override
-		public Builder setAppearance(EConfigEntryAppearance newAppearance) { return this; }
-		
-		/** Pointless to set the value */
-		@Deprecated
-		@Override
-		public Builder set(String newValue)
-		{ return this; }
-		
-		
-		public Builder setParentConfigClass(@NotNull Class<?> parentConfigClass)
+		public Builder setAppearance(EConfigEntryAppearance newAppearance)
 		{
-			// expected format: "Config.Client.Advanced"
-			String packageName = parentConfigClass.getPackage().getName(); // com.seibel.distanthorizons.core.config
-			String fullName = parentConfigClass.getName(); // com.seibel.distanthorizons.core.config.Config$Common$MultiThreading
-			
-			try
-			{
-				String configPath = fullName.substring(
-						packageName.length() + // "com.seibel.distanthorizons.core.config"
-								1 + // "." before "Config"
-								Config.class.getSimpleName().length() + // "Config" 
-								1); // "$" before the inner class name
-				
-				// configPath after substring:
-				// Config$Common$MultiThreading
-				
-				this.tempParentConfigPath = convertPackageNameToLangPath(configPath); // client.advanced.graphics.Quality
-			}
-			catch (Exception e)
-			{
-				this.tempParentConfigPath = parentConfigClass.getSimpleName();
-				LOGGER.warn("Failed to parse config class: ["+fullName+"], error: ["+e.getMessage()+"], defaulting to: ["+this.tempParentConfigPath+"].", e);
-			}
-			
 			return this;
 		}
-		/** 
-		 * example:
-		 * input:  "Client$Advanced$multiThreading"
-		 * output: "client.advanced.multiThreading"
-		 */
-		public static String convertPackageNameToLangPath(String input)
+		
+		/** Pointless to set the value */
+		@Override
+		public Builder set(String newValue)
 		{
-			StringBuilder result = new StringBuilder(input.length());
-			
-			for (int i = 0; i < input.length(); i++)
-			{
-				char ch = input.charAt(i);
-				if (i == 0)
-				{
-					result.append(Character.toLowerCase(ch));
-					continue;
-				}
-				
-				// replace '$' -> '.' to match lang path naming
-				if (ch == '$')
-				{
-					result.append('.');
-					continue;
-				}
-				
-				char lastCh = input.charAt(i-1);
-				if (lastCh == '$')
-				{
-					result.append(Character.toLowerCase(ch));
-					continue;
-				}
-				
-				result.append(ch);
-			}
-			return result.toString();
+			return this;
 		}
 		
-		
-		public Builder setTextPosition(EConfigCommentTextPosition textPosition)
-		{
-			this.tempTextPosition = textPosition;
-			return this; 
-		}
-		
-		
-		
 		public ConfigUIComment build()
-		{ return new ConfigUIComment(this.tempParentConfigPath, this.tempTextPosition); }
+		{
+			return new ConfigUIComment();
+		}
 		
 	}
 	

core/src/main/java/com/seibel/distanthorizons/core/config/types/ConfigUISpacer.java

@@ -1,59 +0,0 @@
-/*
- *    This file is part of the Distant Horizons mod
- *    licensed under the GNU LGPL 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 Lesser 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 Lesser General Public License for more details.
- *
- *    You should have received a copy of the GNU Lesser General Public License
- *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
- */
-
-package com.seibel.distanthorizons.core.config.types;
-
-import com.seibel.distanthorizons.core.config.types.enums.EConfigEntryAppearance;
-
-/**
- * Adds empty space the height of a button.
- * Useful for separating different categories.
- */
-public class ConfigUISpacer extends AbstractConfigType<String, ConfigUISpacer>
-{
-	public ConfigUISpacer()
-	{ super(EConfigEntryAppearance.ONLY_IN_GUI, ""); }
-	
-	
-	
-	/** Appearance shouldn't be changed */
-	@Override
-	public void setAppearance(EConfigEntryAppearance newAppearance) { }
-	
-	/** Pointless to set the value */
-	@Override
-	public void set(String newValue) { }
-	
-	
-	
-	public static class Builder extends AbstractConfigType.Builder<String, Builder>
-	{
-		/** Appearance shouldn't be changed */
-		@Override
-		public Builder setAppearance(EConfigEntryAppearance newAppearance) { return this; }
-		
-		/** Pointless to set the value */
-		@Override
-		public Builder set(String newValue) { return this; }
-		
-		public ConfigUISpacer build() { return new ConfigUISpacer(); }
-		
-	}
-	
-}

core/src/main/java/com/seibel/distanthorizons/core/config/types/ConfigUiLinkedEntry.java

@@ -27,6 +27,7 @@ import com.seibel.distanthorizons.core.config.types.enums.EConfigEntryAppearance
  *
  * @author coolGi
  */
+@Deprecated // FIXME doesn't work with localization
 public class ConfigUiLinkedEntry extends AbstractConfigType<AbstractConfigType<?, ?>, ConfigUiLinkedEntry>
 {
 	public ConfigUiLinkedEntry(AbstractConfigType<?, ?> value)

core/src/main/java/com/seibel/distanthorizons/core/config/types/enums/EConfigCommentTextPosition.java

@@ -1,32 +0,0 @@
-/*
- *    This file is part of the Distant Horizons mod
- *    licensed under the GNU LGPL 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 Lesser 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 Lesser General Public License for more details.
- *
- *    You should have received a copy of the GNU Lesser General Public License
- *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
- */
-
-package com.seibel.distanthorizons.core.config.types.enums;
-
-/**
- * RIGHT_OVER_BUTTONS <br/>
- * CENTER_OF_SCREEN <br/>
- * CENTERED_OVER_BUTTONS <br/>
- */
-public enum EConfigCommentTextPosition
-{
-	RIGHT_JUSTIFIED,
-	CENTER_OF_SCREEN,
-	CENTERED_OVER_BUTTONS,
-}

core/src/main/java/com/seibel/distanthorizons/core/dataObjects/fullData/sources/FullDataSourceV1.java

@@ -116,7 +116,7 @@ public class FullDataSourceV1 implements IDataSource<IDhLevel>
 	public String getKeyDisplayString() { return DhSectionPos.toString(this.pos); }
 	
 	@Override
-	public long getPos() { return this.pos; }
+	public Long getPos() { return this.pos; }
 	
 	public void resizeDataStructuresForRepopulation(long pos)
 	{

core/src/main/java/com/seibel/distanthorizons/core/dataObjects/fullData/sources/FullDataSourceV2.java

@@ -29,16 +29,12 @@ import com.seibel.distanthorizons.core.file.AbstractDataSourceHandler;
 import com.seibel.distanthorizons.core.file.IDataSource;
 import com.seibel.distanthorizons.core.level.IDhLevel;
 import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
-import com.seibel.distanthorizons.core.pooling.AbstractPhantomArrayList;
-import com.seibel.distanthorizons.core.pooling.PhantomArrayListCheckout;
+import com.seibel.distanthorizons.core.pooling.PhantomArrayListParent;
 import com.seibel.distanthorizons.core.pooling.PhantomArrayListPool;
-import com.seibel.distanthorizons.core.pos.DhLodPos;
 import com.seibel.distanthorizons.core.pos.DhSectionPos;
-import com.seibel.distanthorizons.core.pos.blockPos.DhBlockPos;
 import com.seibel.distanthorizons.core.util.*;
 import com.seibel.distanthorizons.core.util.objects.DataCorruptedException;
 import com.seibel.distanthorizons.core.wrapperInterfaces.chunk.IChunkWrapper;
-import com.seibel.distanthorizons.core.wrapperInterfaces.world.ILevelWrapper;
 import com.seibel.distanthorizons.coreapi.ModInfo;
 import it.unimi.dsi.fastutil.bytes.ByteArrayList;
 import it.unimi.dsi.fastutil.longs.LongArrayList;
@@ -57,7 +53,7 @@ import java.util.List;
  * @see FullDataSourceV1
  */
 public class FullDataSourceV2 
-		extends AbstractPhantomArrayList
+		extends PhantomArrayListParent
 		implements IDataSource<IDhLevel>, IDhApiFullDataSource
 {
 	private static final Logger LOGGER = DhLoggerBuilder.getLogger();
@@ -136,7 +132,7 @@ public class FullDataSourceV2
 	// constructors //
 	//==============//
 	
-	public static FullDataSourceV2 createFromChunk(ILevelWrapper levelWrapper, IChunkWrapper chunkWrapper) { return LodDataBuilder.createFromChunk(levelWrapper, chunkWrapper); }
+	public static FullDataSourceV2 createFromChunk(IChunkWrapper chunkWrapper) { return LodDataBuilder.createFromChunk(chunkWrapper); }
 	
 	public static FullDataSourceV2 createFromLegacyDataSourceV1(FullDataSourceV1 legacyData)
 	{
@@ -283,83 +279,10 @@ public class FullDataSourceV2
 	
 	
 	//======//
-	// getters //
+	// data //
 	//======//
 	
-	public LongArrayList get(int relX, int relZ) throws IndexOutOfBoundsException 
-	{ return this.dataPoints[relativePosToIndex(relX, relZ)]; }
-	
-	/** 
-	 * returns {@link FullDataPointUtil#EMPTY_DATA_POINT} if the given {@link DhBlockPos}
-	 * is outside this data source's boundaries.
-	 */
-	public long getAtBlockPos(DhBlockPos blockPos)
-	{
-		DhLodPos requestedPos = new DhLodPos(LodUtil.BLOCK_DETAIL_LEVEL, blockPos.getX(), blockPos.getZ());
-		
-		// stop if the requested blockPos is outside this datasource
-		{
-			// get the detail levels for this request
-			byte requestedDetailLevel = requestedPos.detailLevel;
-			byte requestedSectionDetailLevel = (byte) (requestedDetailLevel + DhSectionPos.SECTION_MINIMUM_DETAIL_LEVEL);
-	
-			// get the positions for this request
-			long sectionPos = requestedPos.getSectionPosWithSectionDetailLevel(requestedSectionDetailLevel);
-			if (!DhSectionPos.contains(this.pos, sectionPos))
-			{
-				return FullDataPointUtil.EMPTY_DATA_POINT;
-			}
-		}
-		
-		
-		// get the relative data source position
-		byte requestDetailLevel = (byte) (DhSectionPos.getDetailLevel(this.pos) - DhSectionPos.SECTION_MINIMUM_DETAIL_LEVEL);
-		DhLodPos relativePos = requestedPos.getDhSectionRelativePositionForDetailLevel(requestDetailLevel);
-		
-		// get the data column
-		LongArrayList dataColumn = this.get(relativePos.x, relativePos.z);
-		if (dataColumn == null)
-		{
-			return FullDataPointUtil.EMPTY_DATA_POINT;
-		}
-		
-		
-		// search for a datapoint that contains the given block y position
-		long dataPoint;
-		for (int i = 0; i < dataColumn.size(); i++)
-		{
-			dataPoint = dataColumn.getLong(i);
-			
-			// we are looking for a specific datapoint,
-			// don't look at null ones
-			if (dataPoint == FullDataPointUtil.EMPTY_DATA_POINT)
-			{
-				continue;
-			}
-			
-			
-			
-			int requestedY = blockPos.getY();
-			int bottomY = FullDataPointUtil.getBottomY(dataPoint) + this.levelMinY;
-			int height = FullDataPointUtil.getHeight(dataPoint);
-			int topY = bottomY + height;
-			
-			// does this datapoint contain the requested Y position? 
-			if (bottomY <= requestedY
-				&& requestedY < topY) // blockPositions start from the bottom of the block, thus "<=" for bottomY, just "<" for topY
-			{
-				return dataPoint;
-			}
-		}
-		
-		return FullDataPointUtil.EMPTY_DATA_POINT;
-	}
-	
-	
-	
-	//==========//
-	// updating //
-	//==========//
+	public LongArrayList get(int relX, int relZ) throws IndexOutOfBoundsException { return this.dataPoints[relativePosToIndex(relX, relZ)]; }
 	
 	@Override
 	public boolean update(@NotNull FullDataSourceV2 inputDataSource, @Nullable IDhLevel level) { return this.update(inputDataSource); }
@@ -1066,7 +989,6 @@ public class FullDataSourceV2
 	}
 	
 	
-	
 	//================//
 	// helper methods //
 	//================//
@@ -1151,7 +1073,7 @@ public class FullDataSourceV2
 	//=====================//
 	
 	@Override
-	public long getPos() { return this.pos; }
+	public Long getPos() { return this.pos; }
 	
 	@Override
 	public byte getDataDetailLevel() { return (byte) (DhSectionPos.getDetailLevel(this.pos) - DhSectionPos.SECTION_MINIMUM_DETAIL_LEVEL); }
@@ -1241,15 +1163,6 @@ public class FullDataSourceV2
 	
 	
 	
-	//============//
-	// unit tests //
-	//============//
-	
-	public PhantomArrayListCheckout getPhantomArrayCheckoutForUnitTesting()
-	{ return this.pooledArraysCheckout; }
-	
-	
-	
 	//================//
 	// base overrides //
 	//================//

core/src/main/java/com/seibel/distanthorizons/core/dataObjects/render/CachedColumnRenderSource.java

@@ -1,6 +1,11 @@
 package com.seibel.distanthorizons.core.dataObjects.render;
 
 import com.google.common.cache.Cache;
+import com.seibel.distanthorizons.core.dataObjects.fullData.sources.FullDataSourceV2;
+import com.seibel.distanthorizons.core.dataObjects.transformers.FullDataToRenderDataTransformer;
+import com.seibel.distanthorizons.core.file.fullDatafile.FullDataSourceProviderV2;
+import com.seibel.distanthorizons.core.util.threading.PriorityTaskPicker;
+import com.seibel.distanthorizons.core.util.threading.ThreadPoolUtil;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 

core/src/main/java/com/seibel/distanthorizons/core/dataObjects/render/ColumnRenderSource.java

@@ -19,13 +19,20 @@
 
 package com.seibel.distanthorizons.core.dataObjects.render;
 
+import com.seibel.distanthorizons.api.enums.worldGeneration.EDhApiWorldGenerationStep;
+import com.seibel.distanthorizons.core.dataObjects.fullData.sources.FullDataSourceV2;
+import com.seibel.distanthorizons.core.dataObjects.transformers.FullDataToRenderDataTransformer;
+import com.seibel.distanthorizons.core.file.IDataSource;
 import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
-import com.seibel.distanthorizons.core.pooling.AbstractPhantomArrayList;
+import com.seibel.distanthorizons.core.pooling.PhantomArrayListParent;
 import com.seibel.distanthorizons.core.pooling.PhantomArrayListPool;
+import com.seibel.distanthorizons.core.pos.blockPos.DhBlockPos2D;
 import com.seibel.distanthorizons.core.pos.DhSectionPos;
+import com.seibel.distanthorizons.core.util.ListUtil;
 import com.seibel.distanthorizons.coreapi.ModInfo;
 import com.seibel.distanthorizons.core.dataObjects.render.columnViews.ColumnArrayView;
 import com.seibel.distanthorizons.core.dataObjects.render.columnViews.ColumnQuadView;
+import com.seibel.distanthorizons.core.level.IDhClientLevel;
 import com.seibel.distanthorizons.coreapi.util.BitShiftUtil;
 import com.seibel.distanthorizons.core.util.ColorUtil;
 import com.seibel.distanthorizons.core.util.RenderDataPointUtil;
@@ -39,7 +46,9 @@ import java.util.concurrent.atomic.AtomicLong;
  *
  * @see RenderDataPointUtil
  */
-public class ColumnRenderSource extends AbstractPhantomArrayList
+public class ColumnRenderSource
+		extends PhantomArrayListParent
+		implements IDataSource<IDhClientLevel>
 {
 	private static final Logger LOGGER = DhLoggerBuilder.getLogger();
 	
@@ -125,12 +134,80 @@ public class ColumnRenderSource extends AbstractPhantomArrayList
 	
 	
 	
+	//=============//
+	// data update //
+	//=============//
+	
+	@Override
+	public boolean update(FullDataSourceV2 inputFullDataSource, IDhClientLevel level)
+	{
+		final String errorMessagePrefix = "Unable to complete update for RenderSource pos: [" + this.pos + "] and pos: [" + inputFullDataSource.getPos() + "]. Error:";
+		
+		boolean dataChanged = false;
+		if (DhSectionPos.getDetailLevel(inputFullDataSource.getPos()) == DhSectionPos.getDetailLevel(this.pos))
+		{
+			try
+			{
+				if (Thread.interrupted())
+				{
+					LOGGER.warn(errorMessagePrefix + "write interrupted.");
+					return false;
+				}
+				
+				
+				
+				DhBlockPos2D centerBlockPos = DhSectionPos.getCenterBlockPos(inputFullDataSource.getPos());
+				int halfBlockWidth = DhSectionPos.getBlockWidth(inputFullDataSource.getPos()) / 2;
+				DhBlockPos2D minBlockPos = new DhBlockPos2D(centerBlockPos.x - halfBlockWidth, centerBlockPos.z - halfBlockWidth);
+				
+				for (int x = 0; x < FullDataSourceV2.WIDTH; x++)
+				{
+					for (int z = 0; z < FullDataSourceV2.WIDTH; z++)
+					{
+						ColumnArrayView columnArrayView = this.getVerticalDataPointView(x, z);
+						int columnHash = columnArrayView.getDataHash();
+						
+						LongArrayList dataColumn = inputFullDataSource.get(x, z);
+						EDhApiWorldGenerationStep worldGenStep = inputFullDataSource.getWorldGenStepAtRelativePos(x, z);
+						if (dataColumn != null && worldGenStep != EDhApiWorldGenerationStep.EMPTY)
+						{
+							FullDataToRenderDataTransformer.updateOrReplaceRenderDataViewColumnWithFullDataColumn(
+									level, inputFullDataSource.mapping,
+									minBlockPos.x + x,
+									minBlockPos.z + z,
+									columnArrayView, dataColumn);
+							dataChanged |= columnHash != columnArrayView.getDataHash();
+							
+							this.fillDebugFlag(x, z, 1, 1, ColumnRenderSource.DebugSourceFlag.DIRECT);
+						}
+					}
+				}
+			}
+			catch (Exception e)
+			{
+				LOGGER.error(errorMessagePrefix + e.getMessage(), e);
+			}
+		}
+		
+		if (dataChanged)
+		{
+			this.localVersion.incrementAndGet();
+			this.markNotEmpty();
+		}
+		
+		return dataChanged;
+	}
+	
+	
+	
 	//=====================//
 	// data helper methods //
 	//=====================//
 	
 	public Long getPos() { return this.pos; }
+	@Override
 	public Long getKey() { return this.pos; }
+	@Override
 	public String getKeyDisplayString() { return DhSectionPos.toString(this.pos); }
 	
 	public byte getDataDetailLevel() { return (byte) (DhSectionPos.getDetailLevel(this.pos) - SECTION_SIZE_OFFSET); }

core/src/main/java/com/seibel/distanthorizons/core/dataObjects/render/bufferBuilding/ColumnRenderBufferBuilder.java

@@ -284,7 +284,7 @@ public class ColumnRenderBufferBuilder
 			}// for z
 		}// for x
 		
-		quadBuilder.mergeQuads();
+		quadBuilder.finalizeData();
 	}
 	private static void addLodToBuffer(
 			IDhClientLevel clientLevel,

core/src/main/java/com/seibel/distanthorizons/core/dataObjects/render/bufferBuilding/LodQuadBuilder.java

@@ -22,7 +22,6 @@ package com.seibel.distanthorizons.core.dataObjects.render.bufferBuilding;
 import java.nio.ByteBuffer;
 import java.nio.ByteOrder;
 import java.util.*;
-import java.util.concurrent.atomic.AtomicLong;
 
 import com.seibel.distanthorizons.api.enums.config.EDhApiGrassSideRendering;
 import com.seibel.distanthorizons.api.enums.rendering.EDhApiBlockMaterial;
@@ -173,6 +172,19 @@ public class LodQuadBuilder
 		BufferQuad quad = new BufferQuad(minX, maxY, minZ, widthEastWest, widthNorthSouthOrUpDown, color, irisBlockMaterialId, skylight, blocklight, EDhDirection.UP);
 		boolean isTransparent = (this.doTransparency && ColorUtil.getAlpha(color) < 255);
 		ArrayList<BufferQuad> quadList = isTransparent ? this.transparentQuads[EDhDirection.UP.ordinal()] : this.opaqueQuads[EDhDirection.UP.ordinal()];
+		
+		
+		// attempt to merge this quad with adjacent ones
+		if (!quadList.isEmpty() &&
+				(
+					quadList.get(quadList.size() - 1).tryMerge(quad, BufferMergeDirectionEnum.EastWest)
+					|| quadList.get(quadList.size() - 1).tryMerge(quad, BufferMergeDirectionEnum.NorthSouthOrUpDown))
+			)
+		{
+			this.premergeCount++;
+			return;
+		}
+		
 		quadList.add(quad);
 	}
 	
@@ -181,6 +193,14 @@ public class LodQuadBuilder
 		BufferQuad quad = new BufferQuad(x, y, z, width, wz, color, irisBlockMaterialId, skylight, blocklight, EDhDirection.DOWN);
 		ArrayList<BufferQuad> qs = (doTransparency && ColorUtil.getAlpha(color) < 255)
 				? transparentQuads[EDhDirection.DOWN.ordinal()] : opaqueQuads[EDhDirection.DOWN.ordinal()];
+		if (!qs.isEmpty()
+				&& (qs.get(qs.size() - 1).tryMerge(quad, BufferMergeDirectionEnum.EastWest)
+						|| qs.get(qs.size() - 1).tryMerge(quad, BufferMergeDirectionEnum.NorthSouthOrUpDown))
+			)
+		{
+			premergeCount++;
+			return;
+		}
 		qs.add(quad);
 	}
 	
@@ -190,6 +210,9 @@ public class LodQuadBuilder
 	// data finalizing //
 	//=================//
 	
+	/** runs any final data cleanup, merging, etc. */
+	public void finalizeData() { this.mergeQuads(); }
+	
 	/** Uses Greedy meshing to merge this builder's Quads. */
 	public void mergeQuads()
 	{
@@ -228,9 +251,7 @@ public class LodQuadBuilder
 	private static long mergeQuadsInternal(ArrayList<BufferQuad>[] list, int directionIndex, BufferMergeDirectionEnum mergeDirection)
 	{
 		if (list[directionIndex].size() <= 1)
-		{
 			return 0;
-		}
 		
 		list[directionIndex].sort((objOne, objTwo) -> objOne.compare(objTwo, mergeDirection));
 		

core/src/main/java/com/seibel/distanthorizons/core/dataObjects/transformers/FullDataToRenderDataTransformer.java

@@ -26,6 +26,7 @@ import com.seibel.distanthorizons.core.dataObjects.fullData.sources.FullDataSour
 import com.seibel.distanthorizons.core.dataObjects.render.ColumnRenderSource;
 import com.seibel.distanthorizons.core.dataObjects.render.columnViews.ColumnArrayView;
 import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
+import com.seibel.distanthorizons.core.level.IDhClientLevel;
 import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
 import com.seibel.distanthorizons.core.pooling.PhantomArrayListCheckout;
 import com.seibel.distanthorizons.core.pooling.PhantomArrayListPool;
@@ -36,7 +37,6 @@ import com.seibel.distanthorizons.core.wrapperInterfaces.IWrapperFactory;
 import com.seibel.distanthorizons.core.wrapperInterfaces.block.IBlockStateWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftClientWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.world.IBiomeWrapper;
-import com.seibel.distanthorizons.core.wrapperInterfaces.world.IClientLevelWrapper;
 import com.seibel.distanthorizons.coreapi.util.BitShiftUtil;
 import it.unimi.dsi.fastutil.longs.LongArrayList;
 import it.unimi.dsi.fastutil.longs.LongOpenHashSet;
@@ -66,13 +66,13 @@ public class FullDataToRenderDataTransformer
 	//==============================//
 	
 	@Nullable
-	public static ColumnRenderSource transformFullDataToRenderSource(@Nullable FullDataSourceV2 fullDataSource, @Nullable IClientLevelWrapper levelWrapper)
+	public static ColumnRenderSource transformFullDataToRenderSource(@Nullable FullDataSourceV2 fullDataSource, @Nullable IDhClientLevel level)
 	{
 		if (fullDataSource == null)
 		{
 			return null;
 		}
-		else if (levelWrapper == null)
+		else if (level == null)
 		{
 			// if the client is no longer loaded in the world, render sources cannot be created 
 			return null;
@@ -81,7 +81,7 @@ public class FullDataToRenderDataTransformer
 		
 		try
 		{
-			return transformCompleteFullDataToColumnData(levelWrapper, fullDataSource);
+			return transformCompleteFullDataToColumnData(level, fullDataSource);
 		}
 		catch (InterruptedException e)
 		{
@@ -102,7 +102,7 @@ public class FullDataToRenderDataTransformer
 	 * @throws InterruptedException Can be caused by interrupting the thread upstream.
 	 * Generally thrown if the method is running after the client leaves the current world.
 	 */
-	private static ColumnRenderSource transformCompleteFullDataToColumnData(IClientLevelWrapper levelWrapper, FullDataSourceV2 fullDataSource) throws InterruptedException
+	private static ColumnRenderSource transformCompleteFullDataToColumnData(IDhClientLevel level, FullDataSourceV2 fullDataSource) throws InterruptedException
 	{
  		final long pos = fullDataSource.getPos();
 		final byte dataDetail = fullDataSource.getDataDetailLevel();
@@ -111,7 +111,7 @@ public class FullDataToRenderDataTransformer
 		
 		
 		
-		final ColumnRenderSource columnSource = ColumnRenderSource.createEmpty(pos, vertSize, levelWrapper.getMinHeight());
+		final ColumnRenderSource columnSource = ColumnRenderSource.createEmpty(pos, vertSize, level.getMinY());
 		if (fullDataSource.isEmpty)
 		{
 			return columnSource;
@@ -121,9 +121,9 @@ public class FullDataToRenderDataTransformer
 		int baseX = DhSectionPos.getMinCornerBlockX(pos);
 		int baseZ = DhSectionPos.getMinCornerBlockZ(pos);
 		
-		for (int x = 0; x < FullDataSourceV2.WIDTH; x++)
+		for (int x = 0; x < DhSectionPos.getWidthCountForLowerDetailedSection(pos, dataDetail); x++)
 		{
-			for (int z = 0; z < FullDataSourceV2.WIDTH; z++)
+			for (int z = 0; z < DhSectionPos.getWidthCountForLowerDetailedSection(pos, dataDetail); z++)
 			{
 				throwIfThreadInterrupted();
 				
@@ -131,7 +131,7 @@ public class FullDataToRenderDataTransformer
 				LongArrayList dataColumn = fullDataSource.get(x, z);
 				
 				updateOrReplaceRenderDataViewColumnWithFullDataColumn(
-						levelWrapper, fullDataSource, 
+						level, fullDataSource.mapping, 
 						// bitshift is to account for LODs with a detail level greater than 0 so the block pos is correct
 						baseX + BitShiftUtil.pow(x,dataDetail), baseZ + BitShiftUtil.pow(z,dataDetail), 
 						columnArrayView, dataColumn);
@@ -139,20 +139,19 @@ public class FullDataToRenderDataTransformer
 		}
 		
 		columnSource.fillDebugFlag(0, 0, ColumnRenderSource.SECTION_SIZE, ColumnRenderSource.SECTION_SIZE, ColumnRenderSource.DebugSourceFlag.FULL);
-		
+			
 		return columnSource;
 	}
 	
 	/** Updates the given {@link ColumnArrayView} to match the incoming Full data {@link LongArrayList} */
 	public static void updateOrReplaceRenderDataViewColumnWithFullDataColumn(
-			IClientLevelWrapper levelWrapper,
-			FullDataSourceV2 fullDataSource, int blockX, int blockZ, 
+			IDhClientLevel level, 
+			FullDataPointIdMap fullDataMapping, int blockX, int blockZ, 
 			ColumnArrayView columnArrayView, 
 			LongArrayList fullDataColumn)
 	{
 		// we can't do anything if the full data is missing or empty
-		if (fullDataColumn == null 
-			|| fullDataColumn.size() == 0)
+		if (fullDataColumn == null || fullDataColumn.size() == 0)
 		{
 			return;
 		}
@@ -161,7 +160,7 @@ public class FullDataToRenderDataTransformer
 		if (fullDataLength <= columnArrayView.verticalSize())
 		{
 			// Directly use the arrayView since it fits.
-			setRenderColumnView(levelWrapper, fullDataSource, blockX, blockZ, columnArrayView, fullDataColumn);
+			setRenderColumnView(level, fullDataMapping, blockX, blockZ, columnArrayView, fullDataColumn);
 		}
 		else
 		{
@@ -172,7 +171,7 @@ public class FullDataToRenderDataTransformer
 			{
 				// expand the ColumnArrayView to fit the new larger max vertical size
 				ColumnArrayView newColumnArrayView = new ColumnArrayView(dataArrayList, fullDataLength, 0, fullDataLength);
-				setRenderColumnView(levelWrapper, fullDataSource, blockX, blockZ, newColumnArrayView, fullDataColumn);
+				setRenderColumnView(level, fullDataMapping, blockX, blockZ, newColumnArrayView, fullDataColumn);
 				columnArrayView.changeVerticalSizeFrom(newColumnArrayView);
 			}
 			finally
@@ -182,7 +181,7 @@ public class FullDataToRenderDataTransformer
 		}
 	}
 	private static void setRenderColumnView(
-			IClientLevelWrapper levelWrapper, FullDataSourceV2 fullDataSource,
+			IDhClientLevel level, FullDataPointIdMap fullDataMapping,
 			int blockX, int blockZ,
 			ColumnArrayView renderColumnData, LongArrayList fullColumnData)
 	{
@@ -193,18 +192,18 @@ public class FullDataToRenderDataTransformer
 		boolean ignoreNonCollidingBlocks = (Config.Client.Advanced.Graphics.Quality.blocksToIgnore.get() == EDhApiBlocksToAvoid.NON_COLLIDING);
 		boolean colorBelowWithAvoidedBlocks = Config.Client.Advanced.Graphics.Quality.tintWithAvoidedBlocks.get();
 		
-		HashSet<IBlockStateWrapper> blockStatesToIgnore = WRAPPER_FACTORY.getRendererIgnoredBlocks(levelWrapper);
-		HashSet<IBlockStateWrapper> caveBlockStatesToIgnore = WRAPPER_FACTORY.getRendererIgnoredCaveBlocks(levelWrapper);
+		HashSet<IBlockStateWrapper> blockStatesToIgnore = WRAPPER_FACTORY.getRendererIgnoredBlocks(level.getLevelWrapper());
+		HashSet<IBlockStateWrapper> caveBlockStatesToIgnore = WRAPPER_FACTORY.getRendererIgnoredCaveBlocks(level.getLevelWrapper());
 		
-		int caveCullingMaxY = Config.Client.Advanced.Graphics.Culling.caveCullingHeight.get() - levelWrapper.getMinHeight();
+		int caveCullingMaxY = Config.Client.Advanced.Graphics.Culling.caveCullingHeight.get() - level.getMinY();
 		boolean caveCullingEnabled = 
 			Config.Client.Advanced.Graphics.Culling.enableCaveCulling.get()
 			&& (
 				// dimensions with a ceiling will be all caves so we don't want cave culling
-				!levelWrapper.hasCeiling()
+				!level.getLevelWrapper().hasCeiling()
 				// the end has a lot of overhangs with 0 lighting above the void, which look broken with
 				// the current cave culling logic (this could probably be improved, but just skipping it works best for now)
-				&& !levelWrapper.getDimensionType().isTheEnd()
+				&& !level.getLevelWrapper().getDimensionType().isTheEnd()
 			);
 		
 		boolean isColumnVoid = true;
@@ -223,8 +222,6 @@ public class FullDataToRenderDataTransformer
 		// convert full data to render data //
 		//==================================//
 		
-		FullDataPointIdMap fullDataMapping = fullDataSource.mapping;
-		
 		DhBlockPosMutable mutableBlockPos = new DhBlockPosMutable(blockX, 0, blockZ);
 		
 		// goes from the top down
@@ -239,7 +236,7 @@ public class FullDataToRenderDataTransformer
 			int blockLight = FullDataPointUtil.getBlockLight(fullData);
 			int skyLight = FullDataPointUtil.getSkyLight(fullData);
 			
-			mutableBlockPos.setY(bottomY + levelWrapper.getMinHeight());
+			mutableBlockPos.setY(bottomY + level.getMinY());
 			
 			IBiomeWrapper biome;
 			IBlockStateWrapper block;
@@ -253,7 +250,7 @@ public class FullDataToRenderDataTransformer
 				if (!brokenPos.contains(fullDataMapping.getPos()))
 				{
 					brokenPos.add(fullDataMapping.getPos());
-					String levelId = levelWrapper.getDhIdentifier();
+					String levelId = level.getLevelWrapper().getDhIdentifier();
 					LOGGER.warn("Unable to get data point with id ["+id+"] " +
 							"(Max possible ID: ["+fullDataMapping.getMaxValidId()+"]) " +
 							"for pos ["+fullDataMapping.getPos()+"] in level ["+levelId+"]. " +
@@ -323,14 +320,11 @@ public class FullDataToRenderDataTransformer
 			//=======================//
 			
 			if (ignoreNonCollidingBlocks 
-				&& !block.isSolid() 
-				&& !block.isLiquid() 
-				&& block.getOpacity() != LodUtil.BLOCK_FULLY_OPAQUE)
+				&& !block.isSolid() && !block.isLiquid() && block.getOpacity() != LodUtil.BLOCK_FULLY_OPAQUE)
 			{
 				if (colorBelowWithAvoidedBlocks)
 				{
-					int tempColor = levelWrapper.getBlockColor(mutableBlockPos, biome, fullDataSource, block);
-					
+					int tempColor = level.computeBaseColor(mutableBlockPos, biome, block);
 					// don't transfer the color when alpha is 0
 					// this prevents issues if grass is transparent
 					if (ColorUtil.getAlpha(tempColor) != 0)
@@ -350,7 +344,7 @@ public class FullDataToRenderDataTransformer
 			if (colorToApplyToNextBlock == -1)
 			{
 				// use this block's color
-				color = levelWrapper.getBlockColor(mutableBlockPos, biome, fullDataSource, block);
+				color = level.computeBaseColor(mutableBlockPos, biome, block);
 			}
 			else
 			{

core/src/main/java/com/seibel/distanthorizons/core/dataObjects/transformers/LodDataBuilder.java

@@ -24,15 +24,15 @@ import java.util.List;
 
 import com.seibel.distanthorizons.api.enums.config.EDhApiWorldCompressionMode;
 import com.seibel.distanthorizons.api.enums.worldGeneration.EDhApiWorldGenerationStep;
-import com.seibel.distanthorizons.api.interfaces.block.IDhApiBiomeWrapper;
-import com.seibel.distanthorizons.api.interfaces.block.IDhApiBlockStateWrapper;
-import com.seibel.distanthorizons.api.methods.events.abstractEvents.DhApiChunkProcessingEvent;
 import com.seibel.distanthorizons.api.objects.data.DhApiChunk;
 import com.seibel.distanthorizons.api.objects.data.DhApiTerrainDataPoint;
 import com.seibel.distanthorizons.core.config.Config;
 import com.seibel.distanthorizons.core.dataObjects.fullData.sources.FullDataSourceV2;
 import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
+import com.seibel.distanthorizons.core.enums.EDhDirection;
 import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
+import com.seibel.distanthorizons.core.pos.blockPos.DhBlockPos;
+import com.seibel.distanthorizons.core.pos.blockPos.DhBlockPosMutable;
 import com.seibel.distanthorizons.core.pos.DhSectionPos;
 import com.seibel.distanthorizons.core.util.FullDataPointUtil;
 import com.seibel.distanthorizons.core.util.LodUtil;
@@ -43,8 +43,6 @@ import com.seibel.distanthorizons.core.wrapperInterfaces.chunk.IChunkWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.misc.IMutableBlockPosWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.world.IBiomeWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.IWrapperFactory;
-import com.seibel.distanthorizons.core.wrapperInterfaces.world.ILevelWrapper;
-import com.seibel.distanthorizons.coreapi.DependencyInjection.ApiEventInjector;
 import it.unimi.dsi.fastutil.longs.LongArrayList;
 import org.apache.logging.log4j.Logger;
 import org.jetbrains.annotations.Nullable;
@@ -52,8 +50,7 @@ import org.jetbrains.annotations.Nullable;
 public class LodDataBuilder
 {
 	private static final Logger LOGGER = DhLoggerBuilder.getLogger();
-	private static final IWrapperFactory WRAPPER_FACTORY = SingletonInjector.INSTANCE.get(IWrapperFactory.class);
-	private static final IBlockStateWrapper AIR = WRAPPER_FACTORY.getAirBlockStateWrapper();
+	private static final IBlockStateWrapper AIR = SingletonInjector.INSTANCE.get(IWrapperFactory.class).getAirBlockStateWrapper();
 	
 	private static boolean getTopErrorLogged = false;
 	
@@ -63,13 +60,10 @@ public class LodDataBuilder
 	// converters //
 	//============//
 	
-	public static FullDataSourceV2 createFromChunk(ILevelWrapper levelWrapper, IChunkWrapper chunkWrapper)
+	public static FullDataSourceV2 createFromChunk(IChunkWrapper chunkWrapper)
 	{
 		// only block lighting is needed here, sky lighting is populated at the data source stage
-		LodUtil.assertTrue(chunkWrapper.isDhBlockLightingCorrect(), "Provided chunk's DH Block lighting hasn't been baked.");
-		
-		int chunkPosX = chunkWrapper.getChunkPos().getX();
-		int chunkPosZ = chunkWrapper.getChunkPos().getZ();
+		LodUtil.assertTrue(chunkWrapper.isDhBlockLightingCorrect());
 		
 		int sectionPosX = getXOrZSectionPosFromChunkPos(chunkWrapper.getChunkPos().getX());
 		int sectionPosZ = getXOrZSectionPosFromChunkPos(chunkWrapper.getChunkPos().getZ());
@@ -125,9 +119,6 @@ public class LodDataBuilder
 			IMutableBlockPosWrapper mcBlockPos = chunkWrapper.getMutableBlockPosWrapper();
 			IBlockStateWrapper previousBlockState = null;
 			
-			DhApiChunkProcessingEvent.EventParam mutableChunkProcessedEventParam 
-					= new DhApiChunkProcessingEvent.EventParam(levelWrapper, chunkPosX, chunkPosZ);
-			
 			int minBuildHeight = chunkWrapper.getMinNonEmptyHeight();
 			int exclusiveMaxBuildHeight = chunkWrapper.getExclusiveMaxBuildHeight();
 			int inclusiveMinBuildHeight = chunkWrapper.getInclusiveMinBuildHeight();
@@ -153,9 +144,9 @@ public class LodDataBuilder
 					}
 					
 					int lastY = exclusiveMaxBuildHeight;
-					IBiomeWrapper currentBiome = chunkWrapper.getBiome(relBlockX, lastY, relBlockZ);
-					IBlockStateWrapper currentBlockState = AIR;
-					int mappedId = dataSource.mapping.addIfNotPresentAndGetId(currentBiome, currentBlockState);
+					IBiomeWrapper biome = chunkWrapper.getBiome(relBlockX, lastY, relBlockZ);
+					IBlockStateWrapper blockState = AIR;
+					int mappedId = dataSource.mapping.addIfNotPresentAndGetId(biome, blockState);
 					
 					// Determine lighting (we are at the height limit. There are no torches here, and sky is not obscured.) // TODO: Per face lighting someday?
 					byte blockLight = LodUtil.MIN_MC_LIGHT;
@@ -171,8 +162,7 @@ public class LodDataBuilder
 					
 					// Go up until we reach open air or the world limit
 					IBlockStateWrapper topBlockState = previousBlockState = chunkWrapper.getBlockState(relBlockX, y, relBlockZ, mcBlockPos, previousBlockState);
-					while (!topBlockState.isAir() 
-							&& y < exclusiveMaxBuildHeight)
+					while (!topBlockState.isAir() && y < exclusiveMaxBuildHeight)
 					{
 						try
 						{
@@ -195,7 +185,6 @@ public class LodDataBuilder
 					}
 					
 					// Process blocks from top to bottom
-					boolean forceSingleBlock = false;
 					for (; y >= minBuildHeight; y--)
 					{
 						IBiomeWrapper newBiome = chunkWrapper.getBiome(relBlockX, y, relBlockZ);
@@ -204,46 +193,13 @@ public class LodDataBuilder
 						byte newSkyLight = (byte) chunkWrapper.getDhSkyLight(relBlockX, y + 1, relBlockZ);
 						
 						// Save the biome/block change if different from previous
-						if (!newBiome.equals(currentBiome) 
-							|| !newBlockState.equals(currentBlockState) 
-							|| forceSingleBlock)
+						if (!newBiome.equals(biome) || !newBlockState.equals(blockState))
 						{
-							// if the previous block potentially colors this block
-							// make this block a single entry, aka add the next block even if it is the same
-							// this is done to allow fire, snow, flowers, etc. to properly color the top of columns vs the whole column
-							forceSingleBlock = 
-									!currentBlockState.isAir()
-									&& !currentBlockState.isSolid()
-									&& !currentBlockState.isLiquid()
-									&& currentBlockState.getOpacity() != LodUtil.BLOCK_FULLY_OPAQUE;
-							
-							
-							// check for API overrides
-							{
-								mutableChunkProcessedEventParam.updateForPosition(relBlockX, y, relBlockZ, newBlockState, newBiome);
-								ApiEventInjector.INSTANCE.fireAllEvents(DhApiChunkProcessingEvent.class, mutableChunkProcessedEventParam);
-								
-								// did the API user override this block?
-								if (mutableChunkProcessedEventParam.getBlockOverride() != null)
-								{
-									// API users shouldn't be creating their own IBlockStateWrapper objects
-									newBlockState = (IBlockStateWrapper)mutableChunkProcessedEventParam.getBlockOverride();
-								}
-								
-								// did the API user override this biome?
-								if (mutableChunkProcessedEventParam.getBiomeOverride() != null)
-								{
-									// API users shouldn't be creating their own IBlockStateWrapper objects
-									newBiome = (IBiomeWrapper) mutableChunkProcessedEventParam.getBiomeOverride();
-								}
-							}
-							
-							
 							longs.add(FullDataPointUtil.encode(mappedId, lastY - y, y + 1 - inclusiveMinBuildHeight, blockLight, skyLight));
-							currentBiome = newBiome;
-							currentBlockState = newBlockState;
+							biome = newBiome;
+							blockState = newBlockState;
 							
-							mappedId = dataSource.mapping.addIfNotPresentAndGetId(currentBiome, currentBlockState);
+							mappedId = dataSource.mapping.addIfNotPresentAndGetId(biome, blockState);
 							blockLight = newBlockLight;
 							skyLight = newSkyLight;
 							lastY = y;
@@ -319,12 +275,6 @@ public class LodDataBuilder
 						continue;
 					}
 					
-					// the lowest/bedrock segment should not be culled
-					if (centerIndex + 1 == centerColumn.size())
-					{
-						continue;
-					}
-					
 					posXIndex = checkOcclusion(dataSource, currentPoint, posXColumn, posXIndex);
 					if (posXIndex < 0)
 					{
@@ -578,11 +528,11 @@ public class LodDataBuilder
 	
 	
 	
-	//==================//
-	// internal helpers //
-	//==================//
+	//================//
+	// helper methods //
+	//================//
 	
-	private static int getXOrZSectionPosFromChunkPos(int chunkXOrZPos)
+	public static int getXOrZSectionPosFromChunkPos(int chunkXOrZPos)
 	{
 		// get the section position
 		int sectionPos = chunkXOrZPos;
@@ -591,6 +541,4 @@ public class LodDataBuilder
 		return sectionPos;
 	}
 	
-	
-	
 }

core/src/main/java/com/seibel/distanthorizons/core/file/IDataSource.java

@@ -14,7 +14,7 @@ import com.seibel.distanthorizons.core.sql.dto.IBaseDTO;
  */
 public interface IDataSource<TDhLevel extends IDhLevel> extends IBaseDTO<Long>, AutoCloseable
 {
-	long getPos();
+	Long getPos();
 	
 	/** @return true if the data was changed */
 	boolean update(FullDataSourceV2 chunkData, TDhLevel level);

core/src/main/java/com/seibel/distanthorizons/core/file/fullDatafile/DelayedFullDataSourceSaveCache.java

@@ -1,5 +1,9 @@
 package com.seibel.distanthorizons.core.file.fullDatafile;
 
+import com.google.common.cache.Cache;
+import com.google.common.cache.CacheBuilder;
+import com.google.common.cache.RemovalCause;
+import com.google.common.cache.RemovalNotification;
 import com.seibel.distanthorizons.core.dataObjects.fullData.sources.FullDataSourceV2;
 import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
 import com.seibel.distanthorizons.core.pos.DhSectionPos;
@@ -10,7 +14,6 @@ import org.jetbrains.annotations.NotNull;
 
 import java.lang.ref.WeakReference;
 import java.util.Collections;
-import java.util.Enumeration;
 import java.util.Set;
 import java.util.concurrent.*;
 import java.util.concurrent.locks.ReentrantLock;
@@ -35,7 +38,7 @@ public class DelayedFullDataSourceSaveCache implements AutoCloseable
 	
 	
 	
-	private final ConcurrentHashMap<Long, DataSourceSavedTimePair> dataSourceByPosition = new ConcurrentHashMap<Long, DataSourceSavedTimePair>();
+	private final Cache<Long, FullDataSourceV2> dataSourceByPosition;
 	
 	/* don't let two threads load the same position at the same time */
 	protected final KeyedLockContainer<Long> saveLockContainer = new KeyedLockContainer<>();
@@ -57,15 +60,16 @@ public class DelayedFullDataSourceSaveCache implements AutoCloseable
 	public DelayedFullDataSourceSaveCache(@NotNull ISaveDataSourceFunc onSaveTimeoutAsyncFunc, int saveDelayInMs)
 	{
 		this.onSaveTimeoutAsyncFunc = onSaveTimeoutAsyncFunc;
-		
-		// we can't clean items faster than the cleanup timer fires
-		if (saveDelayInMs < CLEANUP_CHECK_TIME_IN_MS)
-		{
-			LOGGER.warn("The save delay ["+saveDelayInMs+"] shouldn't be less than the cleanup check timer interval ["+CLEANUP_CHECK_TIME_IN_MS+"].");
-		}
 		this.saveDelayInMs = saveDelayInMs;
 		
 		
+		this.dataSourceByPosition =
+			CacheBuilder.newBuilder()
+				.expireAfterAccess(this.saveDelayInMs, TimeUnit.MILLISECONDS)
+				.expireAfterWrite(this.saveDelayInMs, TimeUnit.MILLISECONDS)
+				.removalListener(this::handleDataSourceRemoval)
+				.<Long, FullDataSourceV2>build();
+		
 		SAVE_CACHE_SET.add(new WeakReference<>(this));
 	}
 	
@@ -79,61 +83,61 @@ public class DelayedFullDataSourceSaveCache implements AutoCloseable
 	 * Writing into memory is done synchronously so inputDataSource can 
 	 * be closed after this method finishes.
 	 */
-	public void writeDataSourceToMemoryAndQueueSave(@NotNull FullDataSourceV2 inputDataSource)
+	public void writeDataSourceToMemoryAndQueueSave(FullDataSourceV2 inputDataSource)
 	{
 		long inputPos = inputDataSource.getPos();
 		
-		ReentrantLock lockForPos = this.saveLockContainer.getLockForPos(inputPos);
+		ReentrantLock lock = this.saveLockContainer.getLockForPos(inputPos);
 		try
 		{
-			lockForPos.lock();
+			lock.lock();
 			
-			FullDataSourceV2 memoryDataSource;
-			
-			DataSourceSavedTimePair pair = this.dataSourceByPosition.getOrDefault(inputPos, null);
-			if (pair == null)
+			FullDataSourceV2 memoryDataSource = this.dataSourceByPosition.getIfPresent(inputPos);
+			if (memoryDataSource == null)
 			{
-				// no data currently in the memory cache for this position
 				memoryDataSource = FullDataSourceV2.createEmpty(inputPos);
-				pair = new DataSourceSavedTimePair(memoryDataSource);
-				this.dataSourceByPosition.put(inputPos, pair);
 			}
-			else
-			{
-				memoryDataSource = pair.dataSource;
-			}
-			
-			// write the new data into memory
 			memoryDataSource.update(inputDataSource);
-			// keep track of when the last time we saved something was
-			pair.updateLastWrittenTimestamp();
+			this.dataSourceByPosition.put(inputPos, memoryDataSource);
 		}
 		finally
 		{
-			lockForPos.unlock();
+			lock.unlock();
 		}
 	}
 	
-	/** when this method is called the datasource should no longer be in the memory cache */
-	public void handleDataSourceRemoval(@NotNull FullDataSourceV2 removedDataSource)
+	public void handleDataSourceRemoval(RemovalNotification<Long, FullDataSourceV2> removalNotification)
 	{
-		this.onSaveTimeoutAsyncFunc.saveAsync(removedDataSource)
-			.handle((voidObj, throwable) ->
+		RemovalCause cause = removalNotification.getCause();
+		if (cause == RemovalCause.EXPIRED
+			|| cause == RemovalCause.COLLECTED
+			|| cause == RemovalCause.EXPLICIT
+			|| cause == RemovalCause.SIZE)
+		{
+			// close the data source after it has expired from the cache
+			FullDataSourceV2 dataSource = removalNotification.getValue();
+			if (dataSource != null)
 			{
-				try
-				{
-					// if this close method is fired multiple times
-					// monoliths can appear due to concurrent writing to the
-					// backend arrays
-					removedDataSource.close();
-				}
-				catch (Exception e)
-				{
-					LOGGER.error("Unable to close datasource ["+ DhSectionPos.toString(removedDataSource.getPos()) +"], error: ["+e.getMessage()+"].", e);
-				}
-				
-				return null;
-			});
+				this.onSaveTimeoutAsyncFunc.saveAsync(dataSource)
+					.handle((voidObj, throwable) ->
+					{
+						try
+						{
+							dataSource.close();
+						}
+						catch (Exception e)
+						{
+							LOGGER.error("Unable to close datasource ["+ DhSectionPos.toString(dataSource.getPos()) +"], removal cause: ["+cause+"], error: ["+e.getMessage()+"].", e);
+						}
+						
+						return null;
+					});
+			}
+			else
+			{
+				LOGGER.error("Unable to close null cached data source.");
+			}
+		}
 	}
 	
 	
@@ -142,36 +146,26 @@ public class DelayedFullDataSourceSaveCache implements AutoCloseable
 	// List methods //
 	//==============//
 	
-	public int getUnsavedCount() { return this.dataSourceByPosition.size(); }
+	public int getUnsavedCount() { return (int)this.dataSourceByPosition.size(); }
 	
-	public void flush() { this.cleanUp(true); }
 	/** Removes everything from the memory cache and fires the {@link DelayedFullDataSourceSaveCache#onSaveTimeoutAsyncFunc} for each. */
-	public void cleanUp(boolean flushAll)
+	public void flush()
 	{
-		Enumeration<Long> keyIterator = this.dataSourceByPosition.keys();
-		while (keyIterator.hasMoreElements())
+		Set<Long> keySet = this.dataSourceByPosition.asMap().keySet();
+		for (Long pos : keySet)
 		{
-			Long pos = keyIterator.nextElement();
-			ReentrantLock posLock = this.saveLockContainer.getLockForPos(pos);
+			ReentrantLock lock = this.saveLockContainer.getLockForPos(pos);
 			try
 			{
-				posLock.lock();
+				lock.lock();
 				
-				DataSourceSavedTimePair savedPair = this.dataSourceByPosition.getOrDefault(pos, null);
-				if (savedPair != null)
-				{
-					if (flushAll
-						|| savedPair.dataSourceHasTimedOut(this.saveDelayInMs))
-					{
-						this.dataSourceByPosition.remove(pos);
-						this.handleDataSourceRemoval(savedPair.dataSource);
-					}
-				}
+				this.dataSourceByPosition.invalidate(pos);
 			}
 			finally
 			{
-				posLock.unlock();
+				lock.unlock();
 			}
+			
 		}
 	}
 	
@@ -203,7 +197,7 @@ public class DelayedFullDataSourceSaveCache implements AutoCloseable
 					}
 					else
 					{
-						cache.cleanUp(false);
+						cache.dataSourceByPosition.cleanUp();
 					}
 				});
 			}
@@ -246,36 +240,4 @@ public class DelayedFullDataSourceSaveCache implements AutoCloseable
 		CompletableFuture<Void> saveAsync(FullDataSourceV2 inputDataSource);
 	}
 	
-	/** 
-	 * used to keep track of when data sources
-	 * were written to so we can flush them once
-	 * enough time has passed.
-	 */
-	private static class DataSourceSavedTimePair
-	{
-		@NotNull
-		public final FullDataSourceV2 dataSource;
-		/** the last unix millisecond time this data source was written to */
-		public long lastWrittenDateTimeMs;
-		
-		
-		public DataSourceSavedTimePair(@NotNull FullDataSourceV2 dataSource)
-		{
-			this.dataSource = dataSource;
-			this.lastWrittenDateTimeMs = System.currentTimeMillis();
-		}
-		
-		
-		public void updateLastWrittenTimestamp()
-		{ this.lastWrittenDateTimeMs = System.currentTimeMillis(); }
-		
-		public boolean dataSourceHasTimedOut(long msTillTimeout)
-		{
-			long currentTime = System.currentTimeMillis();
-			long timeSinceUpdate = currentTime - this.lastWrittenDateTimeMs;
-			return (timeSinceUpdate > msTillTimeout);
-		}
-	}
-	
-	
 }

core/src/main/java/com/seibel/distanthorizons/core/file/fullDatafile/FullDataSourceProviderV1.java

@@ -9,7 +9,6 @@ import com.seibel.distanthorizons.core.sql.dto.FullDataSourceV1DTO;
 import com.seibel.distanthorizons.core.sql.repo.AbstractDhRepo;
 import com.seibel.distanthorizons.core.sql.repo.FullDataSourceV1Repo;
 import com.seibel.distanthorizons.core.util.objects.DataCorruptedException;
-import com.seibel.distanthorizons.core.util.objects.dataStreams.DhDataInputStream;
 import com.seibel.distanthorizons.core.util.threading.ThreadPoolUtil;
 import it.unimi.dsi.fastutil.longs.LongArrayList;
 import org.apache.logging.log4j.Logger;
@@ -22,6 +21,7 @@ import java.util.ArrayList;
 import java.util.concurrent.AbstractExecutorService;
 import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.RejectedExecutionException;
+import java.util.concurrent.ThreadPoolExecutor;
 import java.util.concurrent.locks.ReentrantLock;
 
 public class FullDataSourceProviderV1<TDhLevel extends IDhLevel>
@@ -79,10 +79,7 @@ public class FullDataSourceProviderV1<TDhLevel extends IDhLevel>
 	protected FullDataSourceV1 createDataSourceFromDto(FullDataSourceV1DTO dto) throws InterruptedException, IOException, DataCorruptedException
 	{
 		FullDataSourceV1 dataSource = FullDataSourceV1.createEmpty(dto.pos);
-		try (DhDataInputStream inputStream = dto.getInputStream())
-		{
-			dataSource.populateFromStream(dto, inputStream, this.level);
-		}
+		dataSource.populateFromStream(dto, dto.getInputStream(), this.level);
 		return dataSource;
 	}
 	

core/src/main/java/com/seibel/distanthorizons/core/file/fullDatafile/GeneratedFullDataSourceProvider.java

@@ -210,18 +210,8 @@ public class GeneratedFullDataSourceProvider extends FullDataSourceProviderV2 im
 		}
 		
 		
-		PriorityTaskPicker.Executor renderLoadExecutor = ThreadPoolUtil.getRenderLoadingExecutor();
-		if (renderLoadExecutor == null 
-			|| renderLoadExecutor.getQueueSize() >= getMaxUpdateTaskCount() / 2)
-		{
-			// don't queue additional world gen requests if the render loader handler is overwhelmed,
-			// otherwise LODs may not load in properly
-			return false;
-		}
-		
-		PriorityTaskPicker.Executor fileHandlerExecutor = ThreadPoolUtil.getFileHandlerExecutor();
-		if (fileHandlerExecutor == null 
-			|| fileHandlerExecutor.getQueueSize() >= getMaxUpdateTaskCount() / 2)
+		PriorityTaskPicker.Executor fileExecutor = ThreadPoolUtil.getFileHandlerExecutor();
+		if (fileExecutor == null || fileExecutor.getQueueSize() >= getMaxUpdateTaskCount() / 2)
 		{
 			// don't queue additional world gen requests if the file handler is overwhelmed,
 			// otherwise LODs may not load in properly
@@ -254,7 +244,6 @@ public class GeneratedFullDataSourceProvider extends FullDataSourceProviderV2 im
 			return false;
 		}
 		
-		
 		int availableTaskSlots = maxWorldGenQueueCount - worldGenQueue.getWaitingTaskCount();
 		if (availableTaskSlots <= 0)
 		{

core/src/main/java/com/seibel/distanthorizons/core/generation/WorldGenerationQueue.java

@@ -26,12 +26,12 @@ import com.seibel.distanthorizons.api.objects.data.DhApiChunk;
 import com.seibel.distanthorizons.api.objects.data.IDhApiFullDataSource;
 import com.seibel.distanthorizons.core.dataObjects.fullData.sources.FullDataSourceV2;
 import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
+import com.seibel.distanthorizons.core.file.AbstractDataSourceHandler;
 import com.seibel.distanthorizons.core.generation.tasks.IWorldGenTaskTracker;
 import com.seibel.distanthorizons.core.generation.tasks.InProgressWorldGenTaskGroup;
 import com.seibel.distanthorizons.core.generation.tasks.WorldGenResult;
 import com.seibel.distanthorizons.core.generation.tasks.WorldGenTask;
 import com.seibel.distanthorizons.core.generation.tasks.WorldGenTaskGroup;
-import com.seibel.distanthorizons.core.level.IDhServerLevel;
 import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
 import com.seibel.distanthorizons.core.pos.blockPos.DhBlockPos2D;
 import com.seibel.distanthorizons.core.pos.DhChunkPos;
@@ -76,7 +76,6 @@ public class WorldGenerationQueue implements IFullDataSourceRetrievalQueue, IDeb
 	
 	
 	private final IDhApiWorldGenerator generator;
-	private final IDhServerLevel level;
 	
 	/** contains the positions that need to be generated */
 	private final ConcurrentHashMap<Long, WorldGenTask> waitingTasks = new ConcurrentHashMap<>();
@@ -114,11 +113,10 @@ public class WorldGenerationQueue implements IFullDataSourceRetrievalQueue, IDeb
 	// constructors //
 	//==============//
 	
-	public WorldGenerationQueue(IDhApiWorldGenerator generator, IDhServerLevel level)
+	public WorldGenerationQueue(IDhApiWorldGenerator generator)
 	{
 		LOGGER.info("Creating world gen queue");
 		this.generator = generator;
-		this.level = level;
 		this.lowestDataDetail = generator.getLargestDataDetailLevel();
 		this.highestDataDetail = generator.getSmallestDataDetailLevel();
 		
@@ -187,40 +185,45 @@ public class WorldGenerationQueue implements IFullDataSourceRetrievalQueue, IDeb
 		// update the target pos
 		this.generationTargetPos = targetPos;
 		
-		// needs to be called at least once to start the queue
-		this.tryQueueNewWorldGenRequestsAsync();
+		// ensure the queuing thread is running
+		if (!this.generationQueueRunning)
+		{
+			this.startWorldGenQueuingThread();
+		}
 	}
-	private synchronized void tryQueueNewWorldGenRequestsAsync()
+	private void startWorldGenQueuingThread()
 	{
-		if (!DhApiWorldProxy.INSTANCE.worldLoaded()
-			|| DhApiWorldProxy.INSTANCE.getReadOnly())
-		{
-			return;
-		}
-		
-		if (this.generationQueueRunning)
-		{
-			return;
-		}
 		this.generationQueueRunning = true;
 		
-		
-		
 		// queue world generation tasks on its own thread since this process is very slow and would lag the server thread
 		this.queueingThread.execute(() ->
 		{
 			try
 			{
-				this.generator.preGeneratorTaskStart();
-			
-				// queue generation tasks until the generator is full, or there are no more tasks to generate
-				boolean taskStarted = true;
-				while (!this.isGeneratorBusy()
-						&& taskStarted)
+				// loop until the generator is shutdown
+				while (!Thread.interrupted() && DhApiWorldProxy.INSTANCE.worldLoaded() && !DhApiWorldProxy.INSTANCE.getReadOnly())
 				{
-					taskStarted = this.startNextWorldGenTask(this.generationTargetPos);
+					this.generator.preGeneratorTaskStart();
+					
+					// queue generation tasks until the generator is full, or there are no more tasks to generate
+					boolean taskStarted = true;
+					while (!this.isGeneratorBusy() && taskStarted)
+					{
+						taskStarted = this.startNextWorldGenTask(this.generationTargetPos);
+						if (!taskStarted)
+						{
+							int debugPointOne = 0;
+						}
+					}
+					
+					// if there aren't any new tasks, wait a second before checking again // TODO replace with a listener instead
+					Thread.sleep(1000);
 				}
 			}
+			catch (InterruptedException e)
+			{
+				/* do nothing, this means the thread is being shut down */
+			}
 			catch (Exception e)
 			{
 				LOGGER.error("queueing exception: " + e.getMessage(), e);
@@ -231,7 +234,7 @@ public class WorldGenerationQueue implements IFullDataSourceRetrievalQueue, IDeb
 			}
 		});
 	}
-	private boolean isGeneratorBusy()
+	public boolean isGeneratorBusy()
 	{
 		PriorityTaskPicker.Executor executor = ThreadPoolUtil.getWorldGenExecutor();
 		if (executor == null)
@@ -244,6 +247,7 @@ public class WorldGenerationQueue implements IFullDataSourceRetrievalQueue, IDeb
 		int maxWorldGenTaskCount = worldGenThreadCount * MAX_QUEUED_TASKS_PER_THREAD;
 		return executor.getQueueSize() > maxWorldGenTaskCount;
 	}
+	
 	/**
 	 * @param targetPos the position to center the generation around
 	 * @return false if no tasks were found to generate
@@ -376,10 +380,6 @@ public class WorldGenerationQueue implements IFullDataSourceRetrievalQueue, IDeb
 			{
 				LOGGER.error("Unexpected error completing world gen task at pos: ["+DhSectionPos.toString(taskPos)+"].", e);
 			}
-			finally
-			{
-				this.tryQueueNewWorldGenRequestsAsync();
-			}
 		});
 		
 		this.inProgressGenTasksByLodPos.put(taskPos, newTaskGroup);
@@ -410,15 +410,8 @@ public class WorldGenerationQueue implements IFullDataSourceRetrievalQueue, IDeb
 					{
 						try
 						{
-							IChunkWrapper chunkWrapper = WRAPPER_FACTORY.createChunkWrapper(generatedObjectArray);
-							
-							// TODO light data should be pulled (if possible) from the ChunkAccess object itself via ChunkFileReader.readLight
-							// but this should work for now
-							ArrayList<IChunkWrapper> nearbyChunkList = new ArrayList<IChunkWrapper>();
-							nearbyChunkList.add(chunkWrapper);
-							DhLightingEngine.INSTANCE.bakeChunkBlockLighting(chunkWrapper, nearbyChunkList, this.level.hasSkyLight() ? LodUtil.MAX_MC_LIGHT : LodUtil.MIN_MC_LIGHT);
-							
-							try (FullDataSourceV2 dataSource = LodDataBuilder.createFromChunk(this.level.getLevelWrapper(), chunkWrapper))
+							IChunkWrapper chunk = WRAPPER_FACTORY.createChunkWrapper(generatedObjectArray);
+							try (FullDataSourceV2 dataSource = LodDataBuilder.createFromChunk(chunk))
 							{
 								LodUtil.assertTrue(dataSource != null);
 								dataSourceConsumer.accept(dataSource);
@@ -472,7 +465,6 @@ public class WorldGenerationQueue implements IFullDataSourceRetrievalQueue, IDeb
 				pooledDataSource.setRunApiChunkValidation(this.generator.runApiValidation());
 				
 				// only apply to children if we aren't at the bottom of the tree
-				
 				pooledDataSource.applyToChildren = DhSectionPos.getDetailLevel(pooledDataSource.getPos()) > DhSectionPos.SECTION_BLOCK_DETAIL_LEVEL;
 				pooledDataSource.applyToParent = DhSectionPos.getDetailLevel(pooledDataSource.getPos()) < DhSectionPos.SECTION_BLOCK_DETAIL_LEVEL + 12;
 				
@@ -663,25 +655,8 @@ public class WorldGenerationQueue implements IFullDataSourceRetrievalQueue, IDeb
 	@Override
 	public void debugRender(DebugRenderer renderer)
 	{
-		// show the wireframe a bit lower than world max height,
-		// since most worlds don't render all the way up to the max height
-		int levelHeightRange = (this.level.getMaxY() - this.level.getMinY());
-		int maxY = this.level.getMaxY() - (levelHeightRange / 2);
-		
-		
-		// blue - queued
-		this.waitingTasks.keySet().forEach((pos) -> 
-		{ 
-			renderer.renderBox(
-					new DebugRenderer.Box(pos, this.level.getMinY(), maxY, 0.05f, Color.blue)); 
-		});
-		
-		// red - in progress
-		this.inProgressGenTasksByLodPos.forEach((pos, t) -> 
-		{ 
-			renderer.renderBox(
-					new DebugRenderer.Box(pos, this.level.getMinY(), maxY, 0.05f, Color.red)); 
-		});
+		this.waitingTasks.keySet().forEach((pos) -> { renderer.renderBox(new DebugRenderer.Box(pos, -32f, 64f, 0.05f, Color.blue)); });
+		this.inProgressGenTasksByLodPos.forEach((pos, t) -> { renderer.renderBox(new DebugRenderer.Box(pos, -32f, 64f, 0.05f, Color.red)); });
 	}
 	
 	

core/src/main/java/com/seibel/distanthorizons/core/jar/EPlatform.java

@@ -76,7 +76,7 @@ public enum EPlatform
 		{ // For MacOS it should either output "Mac OS X" or "Darwin" depending on the version of MacOS
 			current = MACOS;
 		}
-		else if (osName.startsWith("bsd") || osName.startsWith("freebsd"))
+		else if (osName.startsWith("bsd"))
 		{ // Depending on the BSD distro this will be different
 			current = BSD;
 		}

core/src/main/java/com/seibel/distanthorizons/core/jar/updater/SelfUpdater.java

@@ -111,7 +111,7 @@ public class SelfUpdater
 		}
 		if (!ModrinthGetter.mcVersions.contains(mcVersion))
 		{
-			LOGGER.warn("Minecraft version ["+ mcVersion +"] is not findable on Modrinth, only findable versions are ["+ StringUtil.join(", ", ModrinthGetter.mcVersions) +"]");
+			LOGGER.warn("Minecraft version ["+ mcVersion +"] is not findable on Modrinth, only findable versions are ["+ StringUtil.join(",", ModrinthGetter.mcVersions) +"]");
 			return false;
 		}
 		

core/src/main/java/com/seibel/distanthorizons/core/level/AbstractDhLevel.java

@@ -19,14 +19,7 @@
 
 package com.seibel.distanthorizons.core.level;
 
-import com.seibel.distanthorizons.api.enums.rendering.EDhApiBlockMaterial;
-import com.seibel.distanthorizons.api.interfaces.render.IDhApiRenderableBoxGroup;
 import com.seibel.distanthorizons.api.methods.events.abstractEvents.DhApiChunkModifiedEvent;
-import com.seibel.distanthorizons.api.methods.events.sharedParameterObjects.DhApiRenderParam;
-import com.seibel.distanthorizons.api.objects.math.DhApiVec3d;
-import com.seibel.distanthorizons.api.objects.render.DhApiRenderableBox;
-import com.seibel.distanthorizons.api.objects.render.DhApiRenderableBoxGroupShading;
-import com.seibel.distanthorizons.core.config.Config;
 import com.seibel.distanthorizons.core.dataObjects.fullData.sources.FullDataSourceV2;
 import com.seibel.distanthorizons.core.file.fullDatafile.DelayedFullDataSourceSaveCache;
 import com.seibel.distanthorizons.core.generation.DhLightingEngine;
@@ -36,24 +29,18 @@ import com.seibel.distanthorizons.core.pos.DhSectionPos;
 import com.seibel.distanthorizons.core.pos.blockPos.DhBlockPos;
 import com.seibel.distanthorizons.core.render.renderer.generic.CloudRenderHandler;
 import com.seibel.distanthorizons.core.render.renderer.generic.GenericObjectRenderer;
-import com.seibel.distanthorizons.core.render.renderer.generic.GenericRenderObjectFactory;
 import com.seibel.distanthorizons.core.sql.dto.BeaconBeamDTO;
 import com.seibel.distanthorizons.core.sql.dto.ChunkHashDTO;
 import com.seibel.distanthorizons.core.sql.repo.AbstractDhRepo;
 import com.seibel.distanthorizons.core.sql.repo.BeaconBeamRepo;
 import com.seibel.distanthorizons.core.sql.repo.ChunkHashRepo;
-import com.seibel.distanthorizons.core.util.ColorUtil;
 import com.seibel.distanthorizons.core.util.KeyedLockContainer;
 import com.seibel.distanthorizons.core.util.LodUtil;
 import com.seibel.distanthorizons.core.wrapperInterfaces.chunk.IChunkWrapper;
-import com.seibel.distanthorizons.core.wrapperInterfaces.world.IClientLevelWrapper;
 import com.seibel.distanthorizons.coreapi.DependencyInjection.ApiEventInjector;
-import com.seibel.distanthorizons.coreapi.ModInfo;
-import com.seibel.distanthorizons.coreapi.util.MathUtil;
 import org.apache.logging.log4j.Logger;
 import org.jetbrains.annotations.Nullable;
 
-import java.awt.*;
 import java.io.File;
 import java.sql.SQLException;
 import java.util.ArrayList;
@@ -86,15 +73,13 @@ public abstract class AbstractDhLevel implements IDhLevel
 	@Nullable
 	protected CloudRenderHandler cloudRenderHandler;
 	
-	private IDhApiRenderableBoxGroup unexploredFogRenderableBoxGroup;
-	
 	
 	
 	//=============//
 	// constructor //
 	//=============//
 	
-	protected AbstractDhLevel() { }
+	protected AbstractDhLevel() {  }
 	
 	/** 
 	 * Creating the repos requires access to the level file, which isn't
@@ -156,7 +141,7 @@ public abstract class AbstractDhLevel implements IDhLevel
 	@Override
 	public void updateChunkAsync(IChunkWrapper chunkWrapper, int chunkHash)
 	{
-		try (FullDataSourceV2 dataSource = FullDataSourceV2.createFromChunk(this.getLevelWrapper(), chunkWrapper))
+		try (FullDataSourceV2 dataSource = FullDataSourceV2.createFromChunk(chunkWrapper))
 		{
 			if (dataSource == null)
 			{
@@ -292,7 +277,7 @@ public abstract class AbstractDhLevel implements IDhLevel
 		
 		
 		// locked to prevent two threads from updating the same section at the same time
-		ReentrantLock lock = this.beaconUpdateLockContainer.getLockForPos(sectionPosForLock); // TODO this can cause a lot of slow-downs
+		ReentrantLock lock = this.beaconUpdateLockContainer.getLockForPos(sectionPosForLock);
 		try
 		{
 			lock.lock();
@@ -392,15 +377,6 @@ public abstract class AbstractDhLevel implements IDhLevel
 			this.beaconBeamRepo.close();
 		}
 		
-		
-		GenericObjectRenderer genericRenderer = this.getGenericRenderer();
-		if (genericRenderer != null 
-			&& this.unexploredFogRenderableBoxGroup != null)
-		{
-			genericRenderer.remove(this.unexploredFogRenderableBoxGroup.getId());
-		}
-		
-		
 		this.delayedFullDataSourceSaveCache.close();
 	}
 	

core/src/main/java/com/seibel/distanthorizons/core/level/AbstractDhServerLevel.java

@@ -143,9 +143,9 @@ public abstract class AbstractDhServerLevel extends AbstractDhLevel implements I
 			
 			if (message.clientTimestamp == null)
 			{
-				if (distanceFromPlayer > Config.Server.maxGenerationRequestDistance.get())
+				if (distanceFromPlayer > Config.Client.Advanced.Graphics.Quality.lodChunkRenderDistanceRadius.get())
 				{
-					message.sendResponse(new RequestOutOfRangeException("Distance too large: " + distanceFromPlayer + " > " + Config.Server.maxGenerationRequestDistance.get()));
+					message.sendResponse(new RequestOutOfRangeException("Distance too large: " + distanceFromPlayer + " > " + Config.Client.Advanced.Graphics.Quality.lodChunkRenderDistanceRadius.get()));
 					return;
 				}
 				
@@ -261,27 +261,29 @@ public abstract class AbstractDhServerLevel extends AbstractDhLevel implements I
 				}
 				
 				LodUtil.assertTrue(this.beaconBeamRepo != null, "beaconBeamRepo should not be null");
-				FullDataPayload payload = new FullDataPayload(data, this.beaconBeamRepo.getAllBeamsForPos(data.getPos()));
-				for (ServerPlayerState serverPlayerState : this.serverPlayerStateManager.getReadyPlayers())
+				try (FullDataPayload payload = new FullDataPayload(data, this.beaconBeamRepo.getAllBeamsForPos(data.getPos())))
 				{
-					if (serverPlayerState.getServerPlayer().getLevel() != this.serverLevelWrapper)
+					for (ServerPlayerState serverPlayerState : this.serverPlayerStateManager.getReadyPlayers())
 					{
-						continue;
-					}
-					
-					if (!serverPlayerState.sessionConfig.isRealTimeUpdatesEnabled())
-					{
-						continue;
-					}
-					
-					Vec3d playerPosition = serverPlayerState.getServerPlayer().getPosition();
-					int distanceFromPlayer = DhSectionPos.getChebyshevSignedBlockDistance(data.getPos(), new DhBlockPos2D((int) playerPosition.x, (int) playerPosition.z)) / 16;
-					if (distanceFromPlayer <= serverPlayerState.sessionConfig.getMaxUpdateDistanceRadius())
-					{
-						serverPlayerState.fullDataPayloadSender.sendInChunks(payload, () ->
+						if (serverPlayerState.getServerPlayer().getLevel() != this.serverLevelWrapper)
 						{
-							serverPlayerState.networkSession.sendMessage(new FullDataPartialUpdateMessage(this.serverLevelWrapper, payload));
-						});
+							continue;
+						}
+						
+						if (!serverPlayerState.sessionConfig.isRealTimeUpdatesEnabled())
+						{
+							continue;
+						}
+						
+						Vec3d playerPosition = serverPlayerState.getServerPlayer().getPosition();
+						int distanceFromPlayer = DhSectionPos.getChebyshevSignedBlockDistance(data.getPos(), new DhBlockPos2D((int) playerPosition.x, (int) playerPosition.z)) / 16;
+						if (distanceFromPlayer <= serverPlayerState.sessionConfig.getMaxUpdateDistanceRadius())
+						{
+							serverPlayerState.fullDataPayloadSender.sendInChunks(payload, () ->
+							{
+								serverPlayerState.networkSession.sendMessage(new FullDataPartialUpdateMessage(this.serverLevelWrapper, payload));
+							});
+						}
 					}
 				}
 			});
@@ -328,8 +330,6 @@ public abstract class AbstractDhServerLevel extends AbstractDhLevel implements I
 	
 	@Override
 	public int getMinY() { return this.getLevelWrapper().getMinHeight(); }
-	@Override
-	public int getMaxY() { return this.getLevelWrapper().getMaxHeight(); }
 	
 	@Override
 	public IServerLevelWrapper getServerLevelWrapper() { return this.serverLevelWrapper; }

core/src/main/java/com/seibel/distanthorizons/core/level/DhClientLevel.java

@@ -36,14 +36,16 @@ import com.seibel.distanthorizons.core.multiplayer.client.SyncOnLoadRequestQueue
 import com.seibel.distanthorizons.core.network.event.ScopedNetworkEventSource;
 import com.seibel.distanthorizons.core.network.messages.fullData.FullDataPartialUpdateMessage;
 import com.seibel.distanthorizons.core.pos.DhChunkPos;
+import com.seibel.distanthorizons.core.pos.blockPos.DhBlockPos;
 import com.seibel.distanthorizons.core.render.RenderBufferHandler;
 import com.seibel.distanthorizons.core.render.renderer.generic.GenericObjectRenderer;
 import com.seibel.distanthorizons.core.pos.blockPos.DhBlockPos2D;
 import com.seibel.distanthorizons.core.render.renderer.DebugRenderer;
 import com.seibel.distanthorizons.core.sql.dto.FullDataSourceV2DTO;
-import com.seibel.distanthorizons.core.util.threading.ThreadPoolUtil;
+import com.seibel.distanthorizons.core.wrapperInterfaces.block.IBlockStateWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftClientWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IProfilerWrapper;
+import com.seibel.distanthorizons.core.wrapperInterfaces.world.IBiomeWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.world.IClientLevelWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.world.ILevelWrapper;
 import org.apache.logging.log4j.LogManager;
@@ -56,7 +58,7 @@ import java.io.File;
 import java.util.*;
 import java.util.List;
 import java.util.concurrent.CompletableFuture;
-import java.util.concurrent.Executor;
+import java.util.concurrent.ConcurrentHashMap;
 import java.util.concurrent.TimeUnit;
 
 /** The level used when connected to a server */
@@ -160,8 +162,7 @@ public class DhClientLevel extends AbstractDhLevel implements IDhClientLevel
 				return;
 			}
 			
-			
-			try (FullDataSourceV2DTO dataSourceDto = this.networkState.fullDataPayloadReceiver.decodeDataSource(message.payload))
+			try (FullDataSourceV2DTO dataSourceDto = this.networkState.fullDataPayloadReceiver.decodeDataSourceAndReleaseBuffer(message.payload))
 			{
 				boolean isSameLevel = message.isSameLevelAs(this.levelWrapper);
 				NETWORK_LOGGER.debug("Buffer {} isSameLevel: {}", message.payload.dtoBufferId, isSameLevel);
@@ -170,28 +171,10 @@ public class DhClientLevel extends AbstractDhLevel implements IDhClientLevel
 					return;
 				}
 				
-				
-				Executor executor = ThreadPoolUtil.getFileHandlerExecutor();
-				if (executor != null)
-				{
-					executor.execute(() ->
-					{
-						try
-						{
-							// TODO this has a lock which can cause stuttering/lag issues
-							this.updateBeaconBeamsForSectionPos(dataSourceDto.pos, message.payload.beaconBeams);
-						}
-						catch (Exception e)
-						{
-							LOGGER.error("Unexpected erorr while updating full data source, error: ["+e.getMessage()+"].", e);
-						}
-					});
-				}
-				
+				this.updateBeaconBeamsForSectionPos(dataSourceDto.pos, message.payload.beaconBeams);
 				
 				FullDataSourceV2 fullDataSource = dataSourceDto.createDataSource(this.levelWrapper);
-				this.updateDataSourcesAsync(fullDataSource)
-						.whenComplete((result, e) -> fullDataSource.close());
+				this.updateDataSourcesAsync(fullDataSource).whenComplete((result, e) -> fullDataSource.close());
 			}
 			catch (Exception e)
 			{
@@ -294,6 +277,9 @@ public class DhClientLevel extends AbstractDhLevel implements IDhClientLevel
 	// getters //
 	//=========//
 	
+	@Override
+	public int computeBaseColor(DhBlockPos pos, IBiomeWrapper biome, IBlockStateWrapper block) { return this.levelWrapper.getBlockColor(pos, biome, block); }
+	
 	@Override
 	public IClientLevelWrapper getClientLevelWrapper() { return this.levelWrapper; }
 	
@@ -308,8 +294,6 @@ public class DhClientLevel extends AbstractDhLevel implements IDhClientLevel
 	
 	@Override
 	public int getMinY() { return this.levelWrapper.getMinHeight(); }
-	@Override
-	public int getMaxY() { return this.levelWrapper.getMaxHeight(); }
 	
 	@Override
 	public FullDataSourceProviderV2 getFullDataProvider() { return this.dataFileHandler; }

core/src/main/java/com/seibel/distanthorizons/core/level/DhClientServerLevel.java

@@ -94,6 +94,20 @@ public class DhClientServerLevel extends AbstractDhServerLevel implements IDhCli
 	// level handling //
 	//================//
 	
+	@Override //FIXME this can fail if the clientLevel isn't available yet, maybe in that case we could return -1 and handle it upstream?
+	public int computeBaseColor(DhBlockPos pos, IBiomeWrapper biome, IBlockStateWrapper block)
+	{
+		IClientLevelWrapper clientLevel = this.getClientLevelWrapper();
+		if (clientLevel == null)
+		{
+			return 0;
+		}
+		else
+		{
+			return clientLevel.getBlockColor(pos, biome, block);
+		}
+	}
+	
 	@Nullable
 	@Override
 	public IClientLevelWrapper getClientLevelWrapper() { return MC_CLIENT.getWrappedClientLevel(); }

core/src/main/java/com/seibel/distanthorizons/core/level/IDhClientLevel.java

@@ -34,6 +34,8 @@ public interface IDhClientLevel extends IDhLevel
 	void render(DhApiRenderParam renderEventParam, IProfilerWrapper profiler);
 	void renderDeferred(DhApiRenderParam renderEventParam, IProfilerWrapper profiler);
 	
+	int computeBaseColor(DhBlockPos pos, IBiomeWrapper biome, IBlockStateWrapper block);
+	
 	@Nullable
 	IClientLevelWrapper getClientLevelWrapper();
 	

core/src/main/java/com/seibel/distanthorizons/core/level/IDhLevel.java

@@ -19,8 +19,6 @@
 
 package com.seibel.distanthorizons.core.level;
 
-import com.seibel.distanthorizons.api.interfaces.render.IDhApiRenderableBoxGroup;
-import com.seibel.distanthorizons.api.objects.render.DhApiRenderableBox;
 import com.seibel.distanthorizons.core.dataObjects.fullData.sources.FullDataSourceV2;
 import com.seibel.distanthorizons.core.file.fullDatafile.FullDataSourceProviderV2;
 import com.seibel.distanthorizons.core.file.fullDatafile.GeneratedFullDataSourceProvider;
@@ -31,7 +29,6 @@ import com.seibel.distanthorizons.core.render.renderer.generic.GenericObjectRend
 import com.seibel.distanthorizons.core.sql.dto.BeaconBeamDTO;
 import com.seibel.distanthorizons.core.sql.repo.BeaconBeamRepo;
 import com.seibel.distanthorizons.core.wrapperInterfaces.chunk.IChunkWrapper;
-import com.seibel.distanthorizons.core.wrapperInterfaces.world.IClientLevelWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.world.ILevelWrapper;
 import org.jetbrains.annotations.Nullable;
 
@@ -44,7 +41,6 @@ public interface IDhLevel extends AutoCloseable, GeneratedFullDataSourceProvider
 	void worldGenTick();
 	
 	int getMinY();
-	int getMaxY();
 	
 	/**
 	 * May return either a client or server level wrapper. <br>
@@ -64,7 +60,6 @@ public interface IDhLevel extends AutoCloseable, GeneratedFullDataSourceProvider
 	void updateBeaconBeamsForChunkPos(DhChunkPos chunkPos, List<BeaconBeamDTO> activeBeamList);
 	void updateBeaconBeamsForSectionPos(long sectionPos, List<BeaconBeamDTO> activeBeamList);
 	
-	/** @return null on server-only levels */
 	@Nullable
 	BeaconBeamRepo getBeaconBeamRepo();
 	

core/src/main/java/com/seibel/distanthorizons/core/level/ServerLevelModule.java

@@ -85,7 +85,7 @@ public class ServerLevelModule implements AutoCloseable
 				// since core world generator's should have the lowest override priority
 				WorldGeneratorInjector.INSTANCE.bind(level.getLevelWrapper(), worldGenerator);
 			}
-			this.worldGenerationQueue = new WorldGenerationQueue(worldGenerator, level);
+			this.worldGenerationQueue = new WorldGenerationQueue(worldGenerator);
 		}
 		
 	}

core/src/main/java/com/seibel/distanthorizons/core/level/WorldGenModule.java

@@ -290,7 +290,7 @@ public class WorldGenModule implements Closeable
 			remainingChunkCount += this.worldGenerationQueue.getQueuedChunkCount();
 			String remainingChunkCountStr = F3Screen.NUMBER_FORMAT.format(remainingChunkCount);
 			
-			String message = "DH is generating chunks. " + remainingChunkCountStr + " left.";
+			String message = "DH is loading chunks. " + remainingChunkCountStr + " left.";
 			
 			// show a message about how to disable progress logging if requested
 			int msToShowDisableInstructions = Config.Common.WorldGenerator.generationProgressDisableMessageDisplayTimeInSeconds.get() * 1_000;
@@ -312,12 +312,7 @@ public class WorldGenModule implements Closeable
 			if (chunksPerSec > 0)
 			{
 				long estimatedRemainingTime = (long) (remainingChunkCount / chunksPerSec);
-				message += " ETA: " + FormatUtil.formatEta(Duration.ofSeconds(estimatedRemainingTime));
-				
-				if (Config.Common.WorldGenerator.generationProgressIncludeChunksPerSecond.get())
-				{
-					message += " at " + F3Screen.NUMBER_FORMAT.format(chunksPerSec) + " chunks/sec";
-				}
+				message += " ETA: " + FormatUtil.formatEta(Duration.ofSeconds(estimatedRemainingTime));//+ " at " + F3Screen.NUMBER_FORMAT.format(chunksPerSec) + " chunks/sec";
 			}
 			
 			// only log if there are chunks needing to be generated

core/src/main/java/com/seibel/distanthorizons/core/logging/ConfigBasedLogger.java

@@ -62,11 +62,6 @@ public class ConfigBasedLogger
 		loggers.add(new WeakReference<>(this));
 	}
 	
-	private static boolean isLessSpecificThan(Level _this, Level other)
-	{
-		return _this.intLevel() >= other.intLevel();
-	}
-	
 	private String _throwableToDetailString(Throwable t)
 	{
 		StringBuilder sb = new StringBuilder();
@@ -100,16 +95,16 @@ public class ConfigBasedLogger
 				: this.logger.getMessageFactory().newMessage("{}", str);
 		
 		String msgStr = msg.getFormattedMessage();
-		if (isLessSpecificThan(mode.levelForFile, level))
+		if (mode.levelForFile.isLessSpecificThan(level))
 		{
-			Level logLevel = isLessSpecificThan(level, Level.INFO) ? Level.INFO : level;
+			Level logLevel = level.isLessSpecificThan(Level.INFO) ? Level.INFO : level;
 			if (param.length > 0 && param[param.length - 1] instanceof Throwable)
 				logger.log(logLevel, msgStr, (Throwable) param[param.length - 1]);
 			else
 				logger.log(logLevel, msgStr);
 		}
 		
-		if (MC != null && isLessSpecificThan(mode.levelForChat, level))
+		if (MC != null && mode.levelForChat.isLessSpecificThan(level))
 		{
 			if (param.length > 0 && param[param.length - 1] instanceof Throwable)
 				MC.logToChat(level, msgStr + "\n" +

core/src/main/java/com/seibel/distanthorizons/core/logging/ConfigBasedSpamLogger.java

@@ -67,11 +67,6 @@ public class ConfigBasedSpamLogger
 		loggers.add(new WeakReference<>(this));
 	}
 	
-	private static boolean isLessSpecificThan(Level _this, Level other)
-	{
-		return _this.intLevel() >= other.intLevel();
-	}
-	
 	public void reset()
 	{
 		logTries.set(0);
@@ -110,15 +105,15 @@ public class ConfigBasedSpamLogger
 		
 		Message msg = logger.getMessageFactory().newMessage(str, param);
 		String msgStr = msg.getFormattedMessage();
-		if (isLessSpecificThan(mode.levelForFile, level))
+		if (mode.levelForFile.isLessSpecificThan(level))
 		{
-			Level logLevel = isLessSpecificThan(level, Level.INFO) ? Level.INFO : level;
+			Level logLevel = level.isLessSpecificThan(Level.INFO) ? Level.INFO : level;
 			if (param.length > 0 && param[param.length - 1] instanceof Throwable)
 				logger.log(logLevel, msgStr, (Throwable) param[param.length - 1]);
 			else
 				logger.log(logLevel, msgStr);
 		}
-		if (isLessSpecificThan(mode.levelForChat, level))
+		if (mode.levelForChat.isLessSpecificThan(level))
 		{
 			if (param.length > 0 && param[param.length - 1] instanceof Throwable)
 				MC.logToChat(level, msgStr + "\n" +
@@ -165,15 +160,15 @@ public class ConfigBasedSpamLogger
 		
 		Message msg = logger.getMessageFactory().newMessage(str, param);
 		String msgStr = msg.getFormattedMessage();
-		if (isLessSpecificThan(mode.levelForFile, level))
+		if (mode.levelForFile.isLessSpecificThan(level))
 		{
-			Level logLevel = isLessSpecificThan(level, Level.INFO) ? Level.INFO : level;
+			Level logLevel = level.isLessSpecificThan(Level.INFO) ? Level.INFO : level;
 			if (param.length > 0 && param[param.length - 1] instanceof Throwable)
 				logger.log(logLevel, msgStr, (Throwable) param[param.length - 1]);
 			else
 				logger.log(logLevel, msgStr);
 		}
-		if (isLessSpecificThan(mode.levelForChat, level))
+		if (mode.levelForChat.isLessSpecificThan(level))
 		{
 			if (param.length > 0 && param[param.length - 1] instanceof Throwable)
 				MC.logToChat(level, msgStr + "\n" +

core/src/main/java/com/seibel/distanthorizons/core/logging/SpamReducedLogger.java

@@ -56,11 +56,6 @@ public class SpamReducedLogger
 		loggers.add(new WeakReference<SpamReducedLogger>(this));
 	}
 	
-	private static boolean isLessSpecificThan(Level _this, Level other)
-	{
-		return _this.intLevel() >= other.intLevel();
-	}
-	
 	public void reset()
 	{
 		logTries.set(0);
@@ -75,7 +70,7 @@ public class SpamReducedLogger
 	{
 		if (logTries.get() >= maxLogCount)
 			return;
-		LOGGER.log(isLessSpecificThan(level, Level.INFO) ? Level.INFO : level, str, param);
+		LOGGER.log(level.isLessSpecificThan(Level.INFO) ? Level.INFO : level, str, param);
 	}
 	
 	public void error(String str, Object... param)
@@ -112,7 +107,7 @@ public class SpamReducedLogger
 	{
 		if (logTries.getAndIncrement() >= maxLogCount)
 			return;
-		LOGGER.log(isLessSpecificThan(level, Level.INFO) ? Level.INFO : level, str, param);
+		LOGGER.log(level.isLessSpecificThan(Level.INFO) ? Level.INFO : level, str, param);
 	}
 	
 	public void errorInc(String str, Object... param)

core/src/main/java/com/seibel/distanthorizons/core/logging/f3/F3Screen.java

@@ -82,7 +82,6 @@ public class F3Screen
 		// multi thread pools
 		PriorityTaskPicker.Executor worldGenPool = ThreadPoolUtil.getWorldGenExecutor();
 		PriorityTaskPicker.Executor fileHandlerPool = ThreadPoolUtil.getFileHandlerExecutor();
-		PriorityTaskPicker.Executor renderLoadingPool = ThreadPoolUtil.getRenderLoadingExecutor();
 		PriorityTaskPicker.Executor updatePool = ThreadPoolUtil.getUpdatePropagatorExecutor();
 		PriorityTaskPicker.Executor lodBuilderPool = ThreadPoolUtil.getChunkToLodBuilderExecutor();
 		PriorityTaskPicker.Executor networkPool = ThreadPoolUtil.getNetworkCompressionExecutor();
@@ -93,11 +92,6 @@ public class F3Screen
 		ThreadPoolExecutor migrationPool = ThreadPoolUtil.getFullDataMigrationExecutor();
 		
 		AbstractDhWorld world = SharedApi.getAbstractDhWorld();
-		if (world == null)
-		{
-			return;
-		}
-		
 		Iterable<? extends IDhLevel> levelIterator = world.getAllLoadedLevels();
 		
 		
@@ -130,7 +124,6 @@ public class F3Screen
 		{
 			// multi thread pools
 			messageList.add(getThreadPoolStatString("World Gen/Import", worldGenPool));
-			messageList.add(getThreadPoolStatString("Render Load", renderLoadingPool));
 			messageList.add(getThreadPoolStatString("File Handler", fileHandlerPool));
 			messageList.add(getThreadPoolStatString("Update Propagator", updatePool));
 			messageList.add(getThreadPoolStatString("LOD Builder", lodBuilderPool));

core/src/main/java/com/seibel/distanthorizons/core/multiplayer/client/AbstractFullDataNetworkRequestQueue.java

@@ -256,7 +256,7 @@ public abstract class AbstractFullDataNetworkRequestQueue implements IDebugRende
 				
 				if (response.payload != null)
 				{
-					FullDataSourceV2DTO dataSourceDto = this.networkState.fullDataPayloadReceiver.decodeDataSource(response.payload);
+					FullDataSourceV2DTO dataSourceDto = this.networkState.fullDataPayloadReceiver.decodeDataSourceAndReleaseBuffer(response.payload);
 					
 					// set application flags based on the received detail level,
 					// this is needed so the data sources propagate correctly

core/src/main/java/com/seibel/distanthorizons/core/multiplayer/client/ClientNetworkState.java

@@ -153,7 +153,7 @@ public class ClientNetworkState implements Closeable
 		
 		if (Config.Server.enableAdaptiveTransferSpeed.get())
 		{
-			sessionConfig.constrainValue(Config.Server.playerBandwidthLimit, this.congestionControl.getDesiredRate());
+			sessionConfig.constrainValue(Config.Server.maxDataTransferSpeed, this.congestionControl.getDesiredRate());
 		}
 		
 		if (blocking)

core/src/main/java/com/seibel/distanthorizons/core/multiplayer/config/SessionConfig.java

@@ -32,7 +32,7 @@ public class SessionConfig implements INetworkObject
 		// Note: config values are transmitted in the insertion order
 		
 		registerConfigEntry(Config.Common.WorldGenerator.enableDistantGeneration, Boolean::logicalAnd);
-		registerConfigEntry(Config.Server.maxGenerationRequestDistance, Math::min);
+		registerConfigEntry(Config.Client.Advanced.Graphics.Quality.lodChunkRenderDistanceRadius, Math::min);
 		registerConfigEntry(Config.Server.generationBoundsX, (x, y) -> y);
 		registerConfigEntry(Config.Server.generationBoundsZ, (x, y) -> y);
 		registerConfigEntry(Config.Server.generationBoundsRadius, (x, y) -> y);
@@ -45,7 +45,7 @@ public class SessionConfig implements INetworkObject
 		registerConfigEntry(Config.Server.maxSyncOnLoadRequestDistance, Math::min);
 		registerConfigEntry(Config.Server.syncOnLoadRateLimit, Math::min);
 		
-		registerConfigEntry(Config.Server.playerBandwidthLimit, (x, y) -> {
+		registerConfigEntry(Config.Server.maxDataTransferSpeed, (x, y) -> {
 			if (x == 0 && y == 0)
 			{
 				return 0;
@@ -67,7 +67,7 @@ public class SessionConfig implements INetworkObject
 	//===============//
 	
 	public boolean isDistantGenerationEnabled() { return this.getValue(Config.Common.WorldGenerator.enableDistantGeneration); }
-	public int getMaxGenerationRequestDistance() { return this.getValue(Config.Server.maxGenerationRequestDistance); }
+	public int getMaxGenerationRequestDistance() { return this.getValue(Config.Client.Advanced.Graphics.Quality.lodChunkRenderDistanceRadius); }
 	public Integer getGenerationBoundsX() { return this.getValue(Config.Server.generationBoundsX); }
 	public Integer getGenerationBoundsZ() { return this.getValue(Config.Server.generationBoundsZ); }
 	public Integer getGenerationBoundsRadius() { return this.getValue(Config.Server.generationBoundsRadius); }
@@ -80,7 +80,7 @@ public class SessionConfig implements INetworkObject
 	public int getMaxSyncOnLoadDistance() { return this.getValue(Config.Server.maxSyncOnLoadRequestDistance); }
 	public int getSyncOnLoginRateLimit() { return this.getValue(Config.Server.syncOnLoadRateLimit); }
 	
-	public int getPlayerBandwidthLimit() { return this.getValue(Config.Server.playerBandwidthLimit); }
+	public int getMaxDataTransferSpeed() { return this.getValue(Config.Server.maxDataTransferSpeed); }
 	
 	
 	

core/src/main/java/com/seibel/distanthorizons/core/multiplayer/fullData/FullDataPayload.java

@@ -9,17 +9,18 @@ import com.seibel.distanthorizons.core.network.messages.fullData.FullDataSplitMe
 import com.seibel.distanthorizons.core.sql.dto.BeaconBeamDTO;
 import com.seibel.distanthorizons.core.sql.dto.FullDataSourceV2DTO;
 import io.netty.buffer.ByteBuf;
-import io.netty.buffer.Unpooled;
+import io.netty.buffer.ByteBufAllocator;
 import org.jetbrains.annotations.NotNull;
 
 import java.io.IOException;
 import java.util.*;
 import java.util.concurrent.atomic.AtomicInteger;
+import java.util.function.Consumer;
 
 /**
  * @see FullDataSplitMessage
  */
-public class FullDataPayload implements INetworkObject
+public class FullDataPayload implements INetworkObject, AutoCloseable
 {
 	private static final AtomicInteger lastBufferId = new AtomicInteger();
 	
@@ -46,7 +47,7 @@ public class FullDataPayload implements INetworkObject
 			EDhApiDataCompressionMode compressionMode = Config.Common.LodBuilding.dataCompression.get();
 			try (FullDataSourceV2DTO dataSourceDto = FullDataSourceV2DTO.CreateFromDataSource(fullDataSource, compressionMode))
 			{
-				this.dtoBuffer = Unpooled.buffer();
+				this.dtoBuffer = ByteBufAllocator.DEFAULT.buffer();
 				dataSourceDto.encode(this.dtoBuffer);
 			}
 		}
@@ -84,6 +85,12 @@ public class FullDataPayload implements INetworkObject
 	// base overrides //
 	//================//
 	
+	@Override
+	public void close()
+	{
+		this.dtoBuffer.release();
+	}
+	
 	@Override
 	public String toString()
 	{

core/src/main/java/com/seibel/distanthorizons/core/multiplayer/fullData/FullDataPayloadReceiver.java

@@ -9,9 +9,8 @@ import com.seibel.distanthorizons.core.network.INetworkObject;
 import com.seibel.distanthorizons.core.network.messages.fullData.FullDataSplitMessage;
 import com.seibel.distanthorizons.core.sql.dto.FullDataSourceV2DTO;
 import com.seibel.distanthorizons.core.util.LodUtil;
+import io.netty.buffer.ByteBufAllocator;
 import io.netty.buffer.CompositeByteBuf;
-import io.netty.buffer.Unpooled;
-import io.netty.buffer.UnpooledByteBufAllocator;
 import org.apache.logging.log4j.LogManager;
 
 import java.util.Objects;
@@ -25,7 +24,15 @@ public class FullDataPayloadReceiver implements AutoCloseable
 	
 	private final ConcurrentMap<Integer, CompositeByteBuf> buffersById = CacheBuilder.newBuilder()
 			.expireAfterAccess(10, TimeUnit.SECONDS)
-			.<Integer, CompositeByteBuf>build().asMap();
+			.removalListener((RemovalNotification<Integer, CompositeByteBuf> notification) ->
+			{
+				// If an entry was replaced without removing, the buffer has to be released manually
+				if (notification.getCause() != RemovalCause.REPLACED)
+				{
+					Objects.requireNonNull(notification.getValue()).release();
+				}
+			})
+			.build().asMap();
 	
 	@Override
 	public void close()
@@ -39,7 +46,13 @@ public class FullDataPayloadReceiver implements AutoCloseable
 		{
 			if (message.isFirst)
 			{
-				composite = UnpooledByteBufAllocator.DEFAULT.compositeBuffer();
+				if (composite != null)
+				{
+					composite.release();
+					LOGGER.debug("Released existing full data buffer [" + message.bufferId + "]");
+				}
+				
+				composite = ByteBufAllocator.DEFAULT.compositeBuffer();
 				LOGGER.debug("Created new full data buffer [" + message.bufferId + "]: [" + composite + "]");
 			}
 			else if (composite == null)
@@ -48,14 +61,13 @@ public class FullDataPayloadReceiver implements AutoCloseable
 				return null;
 			}
 			
-			composite.addComponent(message.buffer);
-			composite.writerIndex(composite.writerIndex() + message.buffer.writerIndex());
+			composite.addComponent(true, message.buffer);
 			LOGGER.debug("Updated full data buffer [" + message.bufferId + "]: [" + composite + "].");
 			return composite;
 		});
 	}
 	
-	public FullDataSourceV2DTO decodeDataSource(FullDataPayload payload)
+	public FullDataSourceV2DTO decodeDataSourceAndReleaseBuffer(FullDataPayload payload)
 	{
 		CompositeByteBuf compositeByteBuffer = this.buffersById.get(payload.dtoBufferId);
 		LodUtil.assertTrue(compositeByteBuffer != null);

core/src/main/java/com/seibel/distanthorizons/core/multiplayer/fullData/FullDataPayloadSender.java

@@ -8,6 +8,7 @@ import io.netty.buffer.ByteBuf;
 import java.util.Timer;
 import java.util.TimerTask;
 import java.util.concurrent.ConcurrentLinkedQueue;
+import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.function.*;
 
 public class FullDataPayloadSender implements AutoCloseable
@@ -25,14 +26,11 @@ public class FullDataPayloadSender implements AutoCloseable
 	private final IntSupplier maxKBpsSupplier;
 	private final ConcurrentLinkedQueue<PendingTransfer> transferQueue = new ConcurrentLinkedQueue<>();
 	
-	private final SharedBandwidthLimit sharedBandwidthLimit;
 	
-	
-	public FullDataPayloadSender(NetworkSession session, IntSupplier maxKBpsSupplier, SharedBandwidthLimit sharedBandwidthLimit)
+	public FullDataPayloadSender(NetworkSession session, IntSupplier maxKBpsSupplier)
 	{
 		this.session = session;
 		this.maxKBpsSupplier = maxKBpsSupplier;
-		this.sharedBandwidthLimit = sharedBandwidthLimit;
 		UPLOAD_TIMER.scheduleAtFixedRate(this.tickTimerTask, 0, 1000 / TICK_RATE);
 	}
 	
@@ -40,6 +38,12 @@ public class FullDataPayloadSender implements AutoCloseable
 	public void close()
 	{
 		this.tickTimerTask.cancel();
+		
+		PendingTransfer pendingTransfer;
+		while ((pendingTransfer = this.transferQueue.poll()) != null)
+		{
+			pendingTransfer.close();
+		}
 	}
 	
 	
@@ -50,16 +54,11 @@ public class FullDataPayloadSender implements AutoCloseable
 	
 	private void tick()
 	{
-		int bandwidthShare = this.sharedBandwidthLimit.getBandwidthShare();
-		int maxPlayerRate = Math.min(this.maxKBpsSupplier.getAsInt(), bandwidthShare);
+		int convertedMaxRate = this.maxKBpsSupplier.getAsInt();
+		convertedMaxRate = convertedMaxRate > 0 ? convertedMaxRate : Integer.MAX_VALUE / 1000;
 		
 		// + 1 to account for rounding errors on values of < 4
-		int bytesToSend = maxPlayerRate > 0
-				? (maxPlayerRate * 1000) / TICK_RATE + 1
-				: Integer.MAX_VALUE;
-		
-		this.sharedBandwidthLimit.setSenderActive(this, bytesToSend > 0);
-		
+		int bytesToSend = (convertedMaxRate * 1000) / TICK_RATE + 1;
 		while (bytesToSend > 0)
 		{
 			PendingTransfer pendingTransfer = this.transferQueue.peek();
@@ -71,7 +70,7 @@ public class FullDataPayloadSender implements AutoCloseable
 			int chunkSize = Math.min(Math.min(bytesToSend, FULL_DATA_SPLIT_SIZE_IN_BYTES), pendingTransfer.buffer.readableBytes());
 			boolean isFirstChunk = pendingTransfer.buffer.readerIndex() == 0;
 			
-			FullDataSplitMessage chunkMessage = new FullDataSplitMessage(pendingTransfer.bufferId, pendingTransfer.buffer.readSlice(chunkSize).retain(), isFirstChunk);
+			FullDataSplitMessage chunkMessage = new FullDataSplitMessage(pendingTransfer.bufferId, pendingTransfer.buffer.readRetainedSlice(chunkSize), isFirstChunk);
 			this.session.sendMessage(chunkMessage);
 			
 			bytesToSend -= chunkSize;
@@ -79,25 +78,36 @@ public class FullDataPayloadSender implements AutoCloseable
 			if (pendingTransfer.buffer.readableBytes() == 0)
 			{
 				pendingTransfer.sendFinalMessage.run();
+				pendingTransfer.close();
 				this.transferQueue.poll();
 			}
 		}
 	}
 	
 	
-	private static class PendingTransfer
+	private static class PendingTransfer implements AutoCloseable
 	{
 		public final int bufferId;
 		public final ByteBuf buffer;
 		public final Runnable sendFinalMessage;
+		private final AtomicBoolean isClosed = new AtomicBoolean();
 		
 		private PendingTransfer(FullDataPayload payload, Runnable sendFinalMessage)
 		{
 			this.bufferId = payload.dtoBufferId;
-			this.buffer = payload.dtoBuffer.duplicate().readerIndex(0);
+			this.buffer = payload.dtoBuffer.retainedDuplicate().readerIndex(0);
 			this.sendFinalMessage = sendFinalMessage;
 		}
 		
+		@Override
+		public void close()
+		{
+			if (this.isClosed.compareAndSet(false, true))
+			{
+				this.buffer.release();
+			}
+		}
+		
 	}
 	
 }

core/src/main/java/com/seibel/distanthorizons/core/multiplayer/fullData/SharedBandwidthLimit.java

@@ -1,36 +0,0 @@
-package com.seibel.distanthorizons.core.multiplayer.fullData;
-
-import com.seibel.distanthorizons.core.config.Config;
-
-import java.util.Collections;
-import java.util.Set;
-import java.util.concurrent.ConcurrentHashMap;
-
-public class SharedBandwidthLimit
-{
-	private final Set<FullDataPayloadSender> senders = Collections.newSetFromMap(new ConcurrentHashMap<>());
-	
-	public void setSenderActive(FullDataPayloadSender sender, boolean active)
-	{
-		if (active)
-		{
-			this.senders.add(sender);
-		}
-		else
-		{
-			this.senders.remove(sender);
-		}
-	}
-	
-	public int getBandwidthShare()
-	{
-		int globalBandwidthLimit = Config.Server.globalBandwidthLimit.get();
-		if (globalBandwidthLimit == 0)
-		{
-			globalBandwidthLimit = Integer.MAX_VALUE;
-		}
-		
-		return globalBandwidthLimit / Math.max(this.senders.size(), 1);
-	}
-	
-}

core/src/main/java/com/seibel/distanthorizons/core/multiplayer/server/FullDataSourceRequestHandler.java

@@ -2,7 +2,6 @@ package com.seibel.distanthorizons.core.multiplayer.server;
 
 import com.seibel.distanthorizons.api.enums.worldGeneration.EDhApiDistantGeneratorMode;
 import com.seibel.distanthorizons.core.config.Config;
-import com.seibel.distanthorizons.core.dataObjects.fullData.sources.FullDataSourceV2;
 import com.seibel.distanthorizons.core.file.fullDatafile.GeneratedFullDataSourceProvider;
 import com.seibel.distanthorizons.core.level.AbstractDhServerLevel;
 import com.seibel.distanthorizons.core.logging.ConfigBasedLogger;
@@ -77,19 +76,14 @@ public class FullDataSourceRequestHandler
 			return;
 		}
 		
-		
-		// get the data requested by the client
-		CompletableFuture<FullDataSourceV2> getServerDatasourceFuture = CompletableFuture.supplyAsync(() -> 
-			{
-				try
-				{
+		CompletableFuture.completedFuture(null)
+				.thenComposeAsync(v -> {
 					// the client timestamp will be null if we want to retrieve the LOD regardless of when it was last updated
 					long clientTimestamp = (message.clientTimestamp != null) ? message.clientTimestamp : -1;
-					
 					// the server timestamp will be null if no LOD data exists for this position
 					Long serverTimestamp = this.fullDataSourceProvider().getTimestampForPos(message.sectionPos);
 					if (serverTimestamp == null
-						|| serverTimestamp <= clientTimestamp)
+							|| serverTimestamp <= clientTimestamp)
 					{
 						// either no data exists to sync, or the client is already up to date
 						rateLimiterSet.syncOnLoginRateLimiter.release();
@@ -97,43 +91,29 @@ public class FullDataSourceRequestHandler
 						return null;
 					}
 					
-					// get the server's datasource
-					return this.fullDataSourceProvider().get(message.sectionPos);
-				}
-				catch (Exception e)
-				{
-					LOGGER.error("Unexpected issue getting server-side LOD for request at pos [" + DhSectionPos.toString(message.sectionPos) + "], error: [" + e.getMessage() + "].", e);
-					return null;
-				}
-			}, fileHandlerExecutor);
-		
-		// send the found data
-		getServerDatasourceFuture.thenAcceptAsync(fullDataSource ->
-			{
-				try
-				{
-					// no server data source found
+					return this.fullDataSourceProvider().getAsync(message.sectionPos);
+				}, fileHandlerExecutor)
+				.thenAcceptAsync(fullDataSource -> {
 					if (fullDataSource == null)
 					{
 						return;
 					}
 					
-					// send the found data source to client
-					FullDataPayload payload = new FullDataPayload(fullDataSource, this.getAllBeamsForPos(message.sectionPos));
-					fullDataSource.close();
-					
-					serverPlayerState.fullDataPayloadSender.sendInChunks(payload, () ->
+					try (FullDataPayload payload = new FullDataPayload(fullDataSource, this.getAllBeamsForPos(message.sectionPos)))
 					{
-						message.sendResponse(new FullDataSourceResponseMessage(payload));
-						rateLimiterSet.syncOnLoginRateLimiter.release();
-					});
-				}
-				catch (Exception e)
-				{
-					LOGGER.error("Unexpected issue sending request for pos [" + DhSectionPos.toString(message.sectionPos) + "], error: [" + e.getMessage() + "].", e);
-				}
-			}, networkCompressionExecutor);
-		
+						fullDataSource.close();
+						
+						serverPlayerState.fullDataPayloadSender.sendInChunks(payload, () ->
+						{
+							message.sendResponse(new FullDataSourceResponseMessage(payload));
+							rateLimiterSet.syncOnLoginRateLimiter.release();
+						});
+					}
+				}, networkCompressionExecutor)
+				.exceptionally(e -> {
+					LOGGER.error("Unexpected issue getting request for pos [" + DhSectionPos.toString(message.sectionPos) + "], error: [" + e.getMessage() + "].", e);
+					return null;
+				});
 	}
 	
 	public void queueWorldGenForRequestMessage(ServerPlayerState serverPlayerState, FullDataSourceRequestMessage message, ServerPlayerState.RateLimiterSet rateLimiterSet)
@@ -243,17 +223,19 @@ public class FullDataSourceRequestHandler
 			}
 			CompletableFuture.runAsync(() ->
 			{
-				FullDataPayload payload = new FullDataPayload(requestGroup.fullDataSource, this.getAllBeamsForPos(entry.getKey()));
-				requestGroup.fullDataSource.close();
-				
-				for (DataSourceRequestGroup.RequestData requestData : requestGroup.requestMessages.values())
+				try (FullDataPayload payload = new FullDataPayload(requestGroup.fullDataSource, this.getAllBeamsForPos(entry.getKey())))
 				{
-					this.requestGroupsByFutureId.remove(requestData.futureId());
+					requestGroup.fullDataSource.close();
 					
-					requestData.serverPlayerState.fullDataPayloadSender.sendInChunks(payload, () -> {
-						requestData.message.sendResponse(new FullDataSourceResponseMessage(payload));
-						requestData.rateLimiterSet.generationRequestRateLimiter.release();
-					});
+					for (DataSourceRequestGroup.RequestData requestData : requestGroup.requestMessages.values())
+					{
+						this.requestGroupsByFutureId.remove(requestData.futureId());
+						
+						requestData.serverPlayerState.fullDataPayloadSender.sendInChunks(payload, () -> {
+							requestData.message.sendResponse(new FullDataSourceResponseMessage(payload));
+							requestData.rateLimiterSet.generationRequestRateLimiter.release();
+						});
+					}
 				}
 			}, executor);
 		}

core/src/main/java/com/seibel/distanthorizons/core/multiplayer/server/ServerPlayerState.java

@@ -5,7 +5,6 @@ import com.seibel.distanthorizons.core.config.listeners.ConfigChangeListener;
 import com.seibel.distanthorizons.core.level.AbstractDhServerLevel;
 import com.seibel.distanthorizons.core.multiplayer.config.SessionConfig;
 import com.seibel.distanthorizons.core.multiplayer.fullData.FullDataPayloadSender;
-import com.seibel.distanthorizons.core.multiplayer.fullData.SharedBandwidthLimit;
 import com.seibel.distanthorizons.core.network.event.internal.IncompatibleMessageInternalEvent;
 import com.seibel.distanthorizons.core.network.messages.base.CloseReasonMessage;
 import com.seibel.distanthorizons.core.network.messages.base.LevelInitMessage;
@@ -49,10 +48,10 @@ public class ServerPlayerState implements Closeable
 	// constructors //
 	//==============//
 	
-	public ServerPlayerState(IServerPlayerWrapper serverPlayer, SharedBandwidthLimit sharedBandwidthLimit)
+	public ServerPlayerState(IServerPlayerWrapper serverPlayer)
 	{
 		this.networkSession = new NetworkSession(serverPlayer);
-		this.fullDataPayloadSender = new FullDataPayloadSender(this.networkSession, this.sessionConfig::getPlayerBandwidthLimit, sharedBandwidthLimit);
+		this.fullDataPayloadSender = new FullDataPayloadSender(this.networkSession, this.sessionConfig::getMaxDataTransferSpeed);
 		
 		this.networkSession.registerHandler(SessionConfigMessage.class, (sessionConfigMessage) ->
 		{

core/src/main/java/com/seibel/distanthorizons/core/multiplayer/server/ServerPlayerStateManager.java

@@ -1,6 +1,5 @@
 package com.seibel.distanthorizons.core.multiplayer.server;
 
-import com.seibel.distanthorizons.core.multiplayer.fullData.SharedBandwidthLimit;
 import com.seibel.distanthorizons.core.network.messages.AbstractNetworkMessage;
 import com.seibel.distanthorizons.core.wrapperInterfaces.misc.IServerPlayerWrapper;
 import org.jetbrains.annotations.Nullable;
@@ -17,7 +16,6 @@ public class ServerPlayerStateManager
 	private final ConcurrentMap<IServerPlayerWrapper, ServerPlayerState> connectedPlayerStateByPlayerWrapper = new ConcurrentHashMap<>();
 	private final ConcurrentMap<IServerPlayerWrapper, MessageQueueState> messageQueueByPlayerWrapper = new ConcurrentHashMap<>();
 	
-	private final SharedBandwidthLimit sharedBandwidthLimit = new SharedBandwidthLimit();
 	
 	
 	//========================//
@@ -26,7 +24,7 @@ public class ServerPlayerStateManager
 	
 	public ServerPlayerState registerJoinedPlayer(IServerPlayerWrapper serverPlayer)
 	{
-		ServerPlayerState playerState = new ServerPlayerState(serverPlayer, this.sharedBandwidthLimit);
+		ServerPlayerState playerState = new ServerPlayerState(serverPlayer);
 		this.connectedPlayerStateByPlayerWrapper.put(serverPlayer, playerState);
 		return playerState;
 	}
@@ -48,13 +46,6 @@ public class ServerPlayerStateManager
 	
 	public void handlePluginMessage(IServerPlayerWrapper player, AbstractNetworkMessage message)
 	{
-		// done to prevent a rare null-pointer on Neo/Forge
-		if (player == null || message == null)
-		{
-			return;
-		}
-		
-		
 		MessageQueueState messageQueue = this.messageQueueByPlayerWrapper.computeIfAbsent(player, k -> new MessageQueueState());
 		messageQueue.messageQueue.add(message);
 		

core/src/main/java/com/seibel/distanthorizons/core/network/messages/fullData/FullDataSplitMessage.java

@@ -22,8 +22,8 @@ package com.seibel.distanthorizons.core.network.messages.fullData;
 import com.google.common.base.MoreObjects;
 import com.seibel.distanthorizons.core.multiplayer.fullData.FullDataPayload;
 import com.seibel.distanthorizons.core.network.messages.AbstractNetworkMessage;
+import com.seibel.distanthorizons.core.util.TimerUtil;
 import io.netty.buffer.ByteBuf;
-import io.netty.buffer.Unpooled;
 
 import java.util.Timer;
 
@@ -34,10 +34,16 @@ import java.util.Timer;
  */
 public class FullDataSplitMessage extends AbstractNetworkMessage
 {
+	private static final long BUFFER_RELEASE_DELAY_MS = 5000L;
+	
 	public int bufferId;
 	public ByteBuf buffer;
 	public boolean isFirst;
 	
+	// Reference counting is unreliable here for some reason so this is a "fix"
+	private static final Timer bufferReleaseTimer = TimerUtil.CreateTimer("FullDataBufferCleanupTimer");
+	private boolean releaseScheduled = false;
+	
 	
 	//==============//
 	// constructors //
@@ -66,6 +72,12 @@ public class FullDataSplitMessage extends AbstractNetworkMessage
 		out.writeBytes(this.buffer.readerIndex(0));
 
 		out.writeBoolean(this.isFirst);
+		
+		if (!this.releaseScheduled)
+		{
+			bufferReleaseTimer.schedule(TimerUtil.createTimerTask(this.buffer::release), BUFFER_RELEASE_DELAY_MS);
+			this.releaseScheduled = true;
+		}
 	}
 	
 	@Override
@@ -74,7 +86,7 @@ public class FullDataSplitMessage extends AbstractNetworkMessage
 		this.bufferId = in.readInt();
 		
 		int bufferSize = in.readInt();
-		this.buffer = Unpooled.copiedBuffer(in.readSlice(bufferSize));
+		this.buffer = in.readBytes(bufferSize);
 
 		this.isFirst = in.readBoolean();
 	}

core/src/main/java/com/seibel/distanthorizons/core/pooling/PhantomArrayListCheckout.java

@@ -10,12 +10,13 @@ import org.jetbrains.annotations.Nullable;
 
 import java.lang.ref.SoftReference;
 import java.util.ArrayList;
+import java.util.concurrent.atomic.AtomicBoolean;
 
 /**
  * This keeps track of all the poolable
  * arrays that can be retrieved via the {@link PhantomArrayListPool}.
  * 
- * @see AbstractPhantomArrayList
+ * @see PhantomArrayListParent
  * @see PhantomArrayListPool
  */
 public class PhantomArrayListCheckout implements AutoCloseable

core/src/main/java/com/seibel/distanthorizons/core/pooling/PhantomArrayListParent.java

@@ -16,13 +16,13 @@ import java.lang.ref.PhantomReference;
  * @see PhantomArrayListCheckout
  * @see PhantomArrayListPool
  */
-public abstract class AbstractPhantomArrayList implements AutoCloseable
+public abstract class PhantomArrayListParent implements AutoCloseable
 {
 	private static final Logger LOGGER = LogManager.getLogger();
 	
 	
 	private final PhantomArrayListPool phantomArrayListPool;
-	private final PhantomReference<AbstractPhantomArrayList> phantomReference;
+	private final PhantomReference<PhantomArrayListParent> phantomReference;
 
 	/** 
 	 * It's recommended to set this as null after the child's constructor 
@@ -37,7 +37,7 @@ public abstract class AbstractPhantomArrayList implements AutoCloseable
 	//=============//
 	
 	/** The Array counts can be 0 or greater. */
-	public AbstractPhantomArrayList(PhantomArrayListPool phantomArrayListPool, int byteArrayCount, int shortArrayCount, int longArrayCount) 
+	public PhantomArrayListParent(PhantomArrayListPool phantomArrayListPool, int byteArrayCount, int shortArrayCount, int longArrayCount) 
 	{
 		if (byteArrayCount < 0 || shortArrayCount < 0 || longArrayCount < 0)
 		{

core/src/main/java/com/seibel/distanthorizons/core/pooling/PhantomArrayListPool.java

@@ -33,18 +33,18 @@ import java.util.concurrent.atomic.AtomicInteger;
  * we pool these arrays when possible. <br><br>
  * 
  * How pooled arrays can be returned: <br>
- * 1. <b> Closing the {@link AbstractPhantomArrayList} </b> <br>
+ * 1. <b> Closing the {@link PhantomArrayListParent} </b> <br>
  * The fastest and most efficient method of returning pooled arrays
  * is to call {@link AutoCloseable#close()}. <br><br>
  * 
- * 2. <b> {@link AbstractPhantomArrayList} Garbage Collection </b> <br>
+ * 2. <b> {@link PhantomArrayListParent} Garbage Collection </b> <br>
  * Some objects are used across many different threads and
- * cleanly closing them is impossible, so when the {@link AbstractPhantomArrayList}
+ * cleanly closing them is impossible, so when the {@link PhantomArrayListParent}
  * is automatically garbage collected we recover and recycle any
  * arrays it checked out.
  * This is less efficient since it may allow a lot of additional arrays to
  * be created while we wait for the garbage collector to run, but 
- * does prevent any leaks from {@link AbstractPhantomArrayList} that weren't closed.
+ * does prevent any leaks from {@link PhantomArrayListParent} that weren't closed.
  * 
  * <br><br>
  * <strong>Use Notes: </strong><br>
@@ -83,9 +83,9 @@ public class PhantomArrayListPool
 	 */
 	public final boolean logGarbageCollectedStacks;
 	
-	public final ConcurrentHashMap<Reference<? extends AbstractPhantomArrayList>, PhantomArrayListCheckout>
+	public final ConcurrentHashMap<Reference<? extends PhantomArrayListParent>, PhantomArrayListCheckout>
 			phantomRefToCheckout = new ConcurrentHashMap<>();
-	public final ReferenceQueue<AbstractPhantomArrayList> phantomRefQueue = new ReferenceQueue<>();
+	public final ReferenceQueue<PhantomArrayListParent> phantomRefQueue = new ReferenceQueue<>();
 	
 	
 	private final ConcurrentLinkedQueue<SoftReference<PhantomArrayListCheckout>> pooledCheckoutsRefs = new ConcurrentLinkedQueue<>();
@@ -274,7 +274,7 @@ public class PhantomArrayListPool
 					
 					allocationStackTraceCountPairList.clear();
 					
-					Reference<? extends AbstractPhantomArrayList> phantomRef = pool.phantomRefQueue.poll();
+					Reference<? extends PhantomArrayListParent> phantomRef = pool.phantomRefQueue.poll();
 					while (phantomRef != null)
 					{
 						// return the pooled arrays
@@ -306,9 +306,9 @@ public class PhantomArrayListPool
 					{
 						// we only want to log when something has been returned
 						if (checkoutCount != 0
-							|| returnedByteArrayCount != 0
-							|| returnedShortArrayCount != 0
-							|| returnedLongArrayCount != 0)
+								|| returnedByteArrayCount != 0
+								|| returnedShortArrayCount != 0
+								|| returnedLongArrayCount != 0)
 						{
 							LOGGER.warn("Pool: ["+ pool.name+"] phantom recovery. Returned checkouts:["+F3Screen.NUMBER_FORMAT.format(checkoutCount)+"], byte:["+F3Screen.NUMBER_FORMAT.format(returnedByteArrayCount)+"], short:["+F3Screen.NUMBER_FORMAT.format(returnedShortArrayCount)+"], long:["+F3Screen.NUMBER_FORMAT.format(returnedLongArrayCount)+"].");
 							
@@ -378,7 +378,7 @@ public class PhantomArrayListPool
 	// return checkout //
 	//=================//
 	
-	public void returnParentPhantomRef(@NotNull PhantomReference<AbstractPhantomArrayList> parentRef)
+	public void returnParentPhantomRef(@NotNull PhantomReference<PhantomArrayListParent> parentRef)
 	{
 		try
 		{

core/src/main/java/com/seibel/distanthorizons/core/pos/DhSectionPos.java

@@ -221,27 +221,11 @@ public class DhSectionPos
 		byte offset = (byte) (detailLevel - returnDetailLevel);
 		return BitShiftUtil.powerOfTwo(offset);
 	}
-	
-	
+
+	/** @return how wide this section is in blocks */
+	public static int getBlockWidth(long pos) { return BitShiftUtil.powerOfTwo(getDetailLevel(pos)); }
 	/** @return how wide this section is in chunks */
 	public static int getChunkWidth(long pos) { return DhSectionPos.getBlockWidth(pos) / LodUtil.CHUNK_WIDTH; }
-	/** @see DhSectionPos#getDetailLevelWidthInBlocks(byte) */
-	public static int getBlockWidth(long pos) { return getDetailLevelWidthInBlocks(getDetailLevel(pos)); }
-	/**
-	 * Returns how many blocks wide a single LOD at the given detail level would be in blocks. <br>
-	 * IE: <br>
-	 * <code>
-	 * 0 => 1 <br>
-	 * 1 => 2 <br>
-	 * 2 => 4 <br>
-	 * 3 => 8 <br>
-	 * 4 => 16 <br>
-	 * 5 => 32 <br>
-	 * 6 => 64 <br>
-	 * etc. <br>
-	 * </code>
-	 */
-	public static int getDetailLevelWidthInBlocks(byte detailLevel) { return BitShiftUtil.powerOfTwo(detailLevel); }
 	
 
 	public static DhBlockPos2D getCenterBlockPos(long pos) { return new DhBlockPos2D(getCenterBlockPosX(pos), getCenterBlockPosZ(pos)); }

core/src/main/java/com/seibel/distanthorizons/core/render/LodQuadTree.java

@@ -21,6 +21,8 @@ package com.seibel.distanthorizons.core.render;
 
 import com.google.common.cache.Cache;
 import com.google.common.cache.CacheBuilder;
+import com.google.common.cache.RemovalCause;
+import com.google.common.cache.RemovalNotification;
 import com.seibel.distanthorizons.core.config.Config;
 import com.seibel.distanthorizons.core.dataObjects.render.CachedColumnRenderSource;
 import com.seibel.distanthorizons.core.dataObjects.render.ColumnRenderSource;
@@ -243,10 +245,8 @@ public class LodQuadTree extends QuadTree<LodRenderSection> implements IDebugRen
 		}
 		
 		
-		// queue full data retrieval (world gen) requests if needed
-		if (nodesNeedingRetrieval.size() != 0
-			&& !this.fullDataRetrievalQueueRunning.get()
-			&& this.fullDataSourceProvider.canQueueRetrieval())
+		// full data retrieval (world gen)
+		if (!this.fullDataRetrievalQueueRunning.get())
 		{
 			this.fullDataRetrievalQueueRunning.set(true);
 			FULL_DATA_RETRIEVAL_QUEUE_THREAD.execute(() -> this.queueFullDataRetrievalTasks(playerPos, nodesNeedingRetrieval));
@@ -342,7 +342,7 @@ public class LodQuadTree extends QuadTree<LodRenderSection> implements IDebugRen
 					// outdated when child LODs are updated.
 					// (They'd have to be reloaded from file anyway during an update)
 					long parentPos = renderSection.pos;
-					while (DhSectionPos.getDetailLevel(parentPos) <= this.treeRootDetailLevel)
+					while (DhSectionPos.getDetailLevel(parentPos) <= this.treeMinDetailLevel)
 					{
 						QuadNode<LodRenderSection> parentNode = this.getNode(parentPos);
 						if (parentNode != null)
@@ -579,7 +579,7 @@ public class LodQuadTree extends QuadTree<LodRenderSection> implements IDebugRen
 		// If not done corners may not be flush with the other LODs, which looks bad.
 		byte minSectionDetailLevel = this.getDetailLevelFromDistance(this.blockRenderDistanceDiameter); // get the minimum allowed detail level
 		minSectionDetailLevel -= 1; // -1 so corners can't render lower than their adjacent neighbors. space
-		minSectionDetailLevel = (byte) Math.min(minSectionDetailLevel, this.treeRootDetailLevel); // don't allow rendering lower detail sections than what the tree contains
+		minSectionDetailLevel = (byte) Math.min(minSectionDetailLevel, this.treeMinDetailLevel); // don't allow rendering lower detail sections than what the tree contains
 		this.minRenderDetailLevel = (byte) Math.max(minSectionDetailLevel, this.maxRenderDetailLevel); // respect the user's selected max resolution if it is lower detail (IE they want 2x2 block, but minSectionDetailLevel is specifically for 1x1 block render resolution)
 	}
 	
@@ -685,6 +685,9 @@ public class LodQuadTree extends QuadTree<LodRenderSection> implements IDebugRen
 	{
 		try
 		{
+			// add a slight delay since we don't need to check the world gen queue every tick
+			Thread.sleep(WORLD_GEN_QUEUE_UPDATE_DELAY_IN_MS);
+			
 			// sort the nodes from nearest to farthest
 			ArrayList<LodRenderSection> nodeList = new ArrayList<>(nodesNeedingRetrieval);
 			nodeList.sort((a, b) ->

core/src/main/java/com/seibel/distanthorizons/core/render/LodRenderSection.java

@@ -19,7 +19,6 @@
 
 package com.seibel.distanthorizons.core.render;
 
-import com.google.common.base.Supplier;
 import com.google.common.base.Suppliers;
 import com.google.common.cache.Cache;
 import com.seibel.distanthorizons.core.config.Config;
@@ -47,7 +46,6 @@ import com.seibel.distanthorizons.core.util.KeyedLockContainer;
 import com.seibel.distanthorizons.core.util.threading.PriorityTaskPicker;
 import com.seibel.distanthorizons.core.util.threading.ThreadPoolUtil;
 import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftClientWrapper;
-import com.seibel.distanthorizons.core.wrapperInterfaces.world.IClientLevelWrapper;
 import it.unimi.dsi.fastutil.longs.LongArrayList;
 import org.apache.logging.log4j.Logger;
 import org.jetbrains.annotations.Nullable;
@@ -59,6 +57,7 @@ import java.util.List;
 import java.util.concurrent.*;
 import java.util.concurrent.atomic.AtomicInteger;
 import java.util.concurrent.locks.ReentrantLock;
+import java.util.function.Supplier;
 
 /**
  * A render section represents an area that could be rendered.
@@ -74,7 +73,6 @@ public class LodRenderSection implements IDebugRenderable, AutoCloseable
 	public final long pos;
 	
 	private final IDhClientLevel level;
-	private final IClientLevelWrapper levelWrapper;
 	@WillNotClose
 	private final FullDataSourceProviderV2 fullDataSourceProvider;
 	private final LodQuadTree quadTree;
@@ -151,13 +149,12 @@ public class LodRenderSection implements IDebugRenderable, AutoCloseable
 		this.cachedRenderSourceByPos = cachedRenderSourceByPos;
 		this.renderLoadLockContainer = renderLoadLockContainer;
 		this.level = level;
-		this.levelWrapper = level.getClientLevelWrapper();
 		this.fullDataSourceProvider = fullDataSourceProvider;
 		this.uploadTaskCountRef = uploadTaskCountRef;
 		
 		this.beaconRenderHandler = this.quadTree.beaconRenderHandler;
 		this.beaconBeamRepo = this.level.getBeaconBeamRepo();
-			
+		
 		DebugRenderer.register(this, Config.Client.Advanced.Debugging.DebugWireframe.showRenderSectionStatus);
 	}
 	
@@ -183,7 +180,7 @@ public class LodRenderSection implements IDebugRenderable, AutoCloseable
 			return false;
 		}
 		
-		PriorityTaskPicker.Executor executor = ThreadPoolUtil.getRenderLoadingExecutor();
+		PriorityTaskPicker.Executor executor = ThreadPoolUtil.getFileHandlerExecutor();
 		if (executor == null || executor.isTerminated())
 		{
 			return false;
@@ -267,10 +264,6 @@ public class LodRenderSection implements IDebugRenderable, AutoCloseable
 					adjacentLoadFutures[1] = this.getRenderSourceForPosAsync(DhSectionPos.getAdjacentPos(this.pos, EDhDirection.SOUTH));
 					adjacentLoadFutures[2] = this.getRenderSourceForPosAsync(DhSectionPos.getAdjacentPos(this.pos, EDhDirection.EAST));
 					adjacentLoadFutures[3] = this.getRenderSourceForPosAsync(DhSectionPos.getAdjacentPos(this.pos, EDhDirection.WEST));
-					//adjacentLoadFutures[0] = CompletableFuture.completedFuture(null);
-					//adjacentLoadFutures[1] = CompletableFuture.completedFuture(null);
-					//adjacentLoadFutures[2] = CompletableFuture.completedFuture(null);
-					//adjacentLoadFutures[3] = CompletableFuture.completedFuture(null);
 					return CompletableFuture.allOf(adjacentLoadFutures).thenRun(() ->
 					{
 						try (CachedColumnRenderSource northRenderSource = adjacentLoadFutures[0].get();
@@ -333,7 +326,7 @@ public class LodRenderSection implements IDebugRenderable, AutoCloseable
 			
 			
 			
-			PriorityTaskPicker.Executor executor = ThreadPoolUtil.getRenderLoadingExecutor();
+			PriorityTaskPicker.Executor executor = ThreadPoolUtil.getFileHandlerExecutor();
 			if (executor == null || executor.isTerminated())
 			{
 				// should only happen if the threadpool is actively being re-sized
@@ -349,7 +342,7 @@ public class LodRenderSection implements IDebugRenderable, AutoCloseable
 				// generate new render source
 				try (FullDataSourceV2 fullDataSource = this.fullDataSourceProvider.get(pos))
 				{
-					newCachedRenderSource.columnRenderSource = FullDataToRenderDataTransformer.transformFullDataToRenderSource(fullDataSource, this.levelWrapper);
+					newCachedRenderSource.columnRenderSource = FullDataToRenderDataTransformer.transformFullDataToRenderSource(fullDataSource, this.level);
 				}
 				catch (Exception e)
 				{
@@ -510,8 +503,7 @@ public class LodRenderSection implements IDebugRenderable, AutoCloseable
 	
 	public void tryQueuingMissingLodRetrieval()
 	{
-		if (this.fullDataSourceProvider.canRetrieveMissingDataSources() 
-			&& this.fullDataSourceProvider.canQueueRetrieval())
+		if (this.fullDataSourceProvider.canRetrieveMissingDataSources() && this.fullDataSourceProvider.canQueueRetrieval())
 		{
 			// calculate the missing positions if not already done
 			if (this.missingGenerationPosFunc == null)
@@ -631,6 +623,7 @@ public class LodRenderSection implements IDebugRenderable, AutoCloseable
 	
 	
 	
+	
 	//==============//
 	// base methods //
 	//==============//
@@ -693,7 +686,7 @@ public class LodRenderSection implements IDebugRenderable, AutoCloseable
 		{
 			// remove the task from our executor if present
 			// note: don't cancel the task since that prevents cleanup, we just don't want it to run
-			PriorityTaskPicker.Executor executor = ThreadPoolUtil.getRenderLoadingExecutor();
+			PriorityTaskPicker.Executor executor = ThreadPoolUtil.getFileHandlerExecutor();
 			if (executor != null && !executor.isTerminated())
 			{
 				Runnable runnable = this.getAndBuildRenderDataRunnable;

core/src/main/java/com/seibel/distanthorizons/core/render/RenderBufferHandler.java

@@ -33,13 +33,14 @@ import com.seibel.distanthorizons.core.logging.f3.F3Screen;
 import com.seibel.distanthorizons.core.pos.DhLodPos;
 import com.seibel.distanthorizons.core.pos.DhSectionPos;
 import com.seibel.distanthorizons.core.pos.Pos2D;
+import com.seibel.distanthorizons.core.render.glObject.buffer.QuadElementBuffer;
 import com.seibel.distanthorizons.core.render.renderer.LodRenderer;
 import com.seibel.distanthorizons.core.util.LodUtil;
-import com.seibel.distanthorizons.core.util.objects.RollingAverage;
 import com.seibel.distanthorizons.core.util.objects.SortedArraySet;
 import com.seibel.distanthorizons.core.util.objects.quadTree.QuadNode;
 import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftGLWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftRenderWrapper;
+import com.seibel.distanthorizons.core.wrapperInterfaces.misc.ILightMapWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.modAccessor.IIrisAccessor;
 import com.seibel.distanthorizons.core.wrapperInterfaces.world.IClientLevelWrapper;
 import com.seibel.distanthorizons.coreapi.interfaces.dependencyInjection.IOverrideInjector;
@@ -175,17 +176,50 @@ public class RenderBufferHandler implements AutoCloseable
 			}
 		}
 		
-		Pos2D centerPos = this.lodQuadTree.getCenterBlockPos().toPos2D();
+		Pos2D cPos = this.lodQuadTree.getCenterBlockPos().toPos2D();
 		
 		// Now that we have the axis directions, we can sort the render list
 		Comparator<LoadedRenderBuffer> farToNearComparator = (loadedBufferA, loadedBufferB) ->
 		{
 			Pos2D aPos = DhSectionPos.getCenterBlockPos(loadedBufferA.pos).toPos2D();
 			Pos2D bPos = DhSectionPos.getCenterBlockPos(loadedBufferB.pos).toPos2D();
+			if (true)
+			{
+				int aManhattanDistance = aPos.manhattanDist(cPos);
+				int bManhattanDistance = bPos.manhattanDist(cPos);
+				return bManhattanDistance - aManhattanDistance;
+			}
 			
-			int aManhattanDistance = aPos.manhattanDist(centerPos);
-			int bManhattanDistance = bPos.manhattanDist(centerPos);
-			return bManhattanDistance - aManhattanDistance;
+			for (EDhDirection axisDirection : axisDirections)
+			{
+				if (axisDirection.getAxis().isVertical())
+				{
+					continue; // We only sort in the horizontal direction
+				}
+				
+				int abPosDifference;
+				if (axisDirection.getAxis().equals(EDhDirection.Axis.X))
+				{
+					abPosDifference = aPos.getX() - bPos.getX();
+				}
+				else
+				{
+					abPosDifference = aPos.getY() - bPos.getY();
+				}
+				
+				if (abPosDifference == 0)
+				{
+					continue;
+				}
+				
+				if (axisDirection.getAxisDirection().equals(EDhDirection.AxisDirection.NEGATIVE))
+				{
+					abPosDifference = -abPosDifference; // Reverse the sign
+				}
+				return abPosDifference;
+			}
+			
+			return DhSectionPos.getDetailLevel(loadedBufferA.pos) - DhSectionPos.getDetailLevel(loadedBufferB.pos); // If all else fails, sort by detail
 		};
 		this.loadedNearToFarBuffers = new SortedArraySet<>((a, b) -> -farToNearComparator.compare(a, b)); // TODO is the comparator named wrong?
 		
@@ -245,21 +279,19 @@ public class RenderBufferHandler implements AutoCloseable
 			this.culledBufferCount = 0;
 		}
 		
-		// setup iterator with culling frustum
-		Iterator<QuadNode<LodRenderSection>> nodeIterator = this.lodQuadTree.nodeIteratorWithStoppingFilter((QuadNode<LodRenderSection> node) ->
+		boolean rebuildAllBuffers = this.rebuildAllBuffers.getAndSet(false);
+		Iterator<QuadNode<LodRenderSection>> nodeIterator = this.lodQuadTree.nodeIterator();
+		while (nodeIterator.hasNext())
 		{
-			if (node == null)
-			{
-				return true;
-			}
+			QuadNode<LodRenderSection> node = nodeIterator.next();
 			
+			long sectionPos = node.sectionPos;
 			LodRenderSection renderSection = node.value;
 			if (renderSection == null)
 			{
-				return false;
+				continue;
 			}
 			
-			
 			try
 			{
 				if (enableFrustumCulling)
@@ -279,48 +311,22 @@ public class RenderBufferHandler implements AutoCloseable
 							this.culledBufferCount++;
 						}
 						
-						return true;
+						continue;
 					}
 				}
 				
-				return false;
-			}
-			catch (Exception e)
-			{
-				LOGGER.error("Unexpected issue during culling for node pos: ["+DhSectionPos.toString(node.sectionPos)+"], error: ["+e.getMessage()+"].", e);
-				
-				// don't cull if there was an unexpected issue
-				return false;
-			}
-		});
-		
-		while (nodeIterator.hasNext())
-		{
-			QuadNode<LodRenderSection> node = nodeIterator.next();
-			
-			long sectionPos = node.sectionPos;
-			LodRenderSection renderSection = node.value;
-			if (renderSection == null)
-			{
-				continue;
-			}
-			
-			
-			
-			try
-			{
 				ColumnRenderBuffer buffer = renderSection.renderBuffer;
-				if (buffer == null 
-					|| !renderSection.getRenderingEnabled())
+				if (buffer == null || !renderSection.getRenderingEnabled())
 				{
 					continue;
 				}
 				
+				
 				this.loadedNearToFarBuffers.add(new LoadedRenderBuffer(buffer, sectionPos));
 			}
 			catch (Exception e)
 			{
-				LOGGER.error("Error updating QuadTree render source at [" + DhSectionPos.toString(renderSection.pos) + "], error: ["+e.getMessage()+"].", e);
+				LOGGER.error("Error updating QuadTree render source at " + renderSection.pos + ".", e);
 			}
 		}
 		

core/src/main/java/com/seibel/distanthorizons/core/render/glObject/GLProxy.java

@@ -23,12 +23,12 @@ import com.seibel.distanthorizons.api.enums.config.EDhApiGLErrorHandlingMode;
 import com.seibel.distanthorizons.api.enums.config.EDhApiGpuUploadMethod;
 import com.seibel.distanthorizons.core.config.Config;
 import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
-import com.seibel.distanthorizons.core.jar.EPlatform;
 import com.seibel.distanthorizons.core.logging.ConfigBasedLogger;
 import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
 import com.seibel.distanthorizons.core.util.objects.GLMessages.*;
 import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftClientWrapper;
 import com.seibel.distanthorizons.coreapi.ModInfo;
+import com.seibel.distanthorizons.coreapi.util.StringUtil;
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.lwjgl.glfw.GLFW;
@@ -39,6 +39,7 @@ import org.lwjgl.opengl.GLUtil;
 
 import java.io.PrintStream;
 import java.util.Collections;
+import java.util.HashSet;
 import java.util.Set;
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.concurrent.ConcurrentLinkedQueue;
@@ -172,26 +173,17 @@ public class GLProxy
 		
 		// get the best automatic upload method
 		String vendor = GL32.glGetString(GL32.GL_VENDOR).toUpperCase(); // example return: "NVIDIA CORPORATION"
-		if (EPlatform.get() != EPlatform.MACOS)
+		if (vendor.contains("NVIDIA") || vendor.contains("GEFORCE"))
 		{
-			if (vendor.contains("NVIDIA") || vendor.contains("GEFORCE"))
-			{
-				// NVIDIA card
-				this.preferredUploadMethod = this.bufferStorageSupported ? EDhApiGpuUploadMethod.BUFFER_STORAGE : EDhApiGpuUploadMethod.SUB_DATA;
-			}
-			else
-			{
-				// AMD or Intel card
-				this.preferredUploadMethod = this.bufferStorageSupported ? EDhApiGpuUploadMethod.BUFFER_STORAGE : EDhApiGpuUploadMethod.DATA;
-			}
+			// NVIDIA card
+			this.preferredUploadMethod = this.bufferStorageSupported ? EDhApiGpuUploadMethod.BUFFER_STORAGE : EDhApiGpuUploadMethod.SUB_DATA;
 		}
 		else
 		{
-			// Mac may have an issue with Buffer Storage, so default to the most basic
-			// form of uploading
-			this.preferredUploadMethod = EDhApiGpuUploadMethod.DATA;
+			// AMD or Intel card
+			this.preferredUploadMethod = this.bufferStorageSupported ? EDhApiGpuUploadMethod.BUFFER_STORAGE : EDhApiGpuUploadMethod.DATA;
 		}
-		GL_LOGGER.info("GPU Vendor [" + vendor + "] with OS [" + EPlatform.get().getName() + "], Preferred upload method is [" + this.preferredUploadMethod + "].");
+		GL_LOGGER.info("GPU Vendor [" + vendor + "], Preferred upload method is [" + this.preferredUploadMethod + "].");
 		
 		
 		
@@ -210,8 +202,7 @@ public class GLProxy
 	//=========//
 	
 	public static boolean hasInstance() { return instance != null; }
-	/** @throws IllegalStateException if the Proxy hasn't been created yet and this is called outside the render thread */
-	public static GLProxy getInstance() throws IllegalStateException
+	public static GLProxy getInstance()
 	{
 		if (instance == null)
 		{

core/src/main/java/com/seibel/distanthorizons/core/render/glObject/shader/Shader.java

@@ -25,15 +25,9 @@ import java.io.FileNotFoundException;
 import java.io.IOException;
 import java.io.InputStream;
 import java.io.InputStreamReader;
-import java.nio.ByteBuffer;
 
 import com.seibel.distanthorizons.core.render.glObject.GLProxy;
-import org.lwjgl.PointerBuffer;
 import org.lwjgl.opengl.GL32;
-import org.lwjgl.opengl.GL32C;
-import org.lwjgl.system.MemoryStack;
-import org.lwjgl.system.MemoryUtil;
-import org.lwjgl.system.NativeType;
 
 /**
  * This object holds a OpenGL reference to a shader
@@ -69,7 +63,7 @@ public class Shader
 		}
 		
 		StringBuilder source = loadFile(path, absoluteFilePath, new StringBuilder());
-		safeShaderSource(this.id, source);
+		GL32.glShaderSource(this.id, source);
 		
 		GL32.glCompileShader(this.id);
 		// check if the shader compiled
@@ -99,7 +93,7 @@ public class Shader
 			throw new IllegalArgumentException("Failed to create shader with type ["+type+"] and Source: \n["+sourceString+"].");
 		}
 		
-		safeShaderSource(this.id, sourceString);
+		GL32.glShaderSource(this.id, sourceString);
 		GL32.glCompileShader(this.id);
 		// check if the shader compiled
 		int status = GL32.glGetShaderi(this.id, GL32.GL_COMPILE_STATUS);
@@ -120,37 +114,6 @@ public class Shader
 	// helpers //
 	//=========//
 	
-	/**
-	 * Identical in function to {@link GL32C#glShaderSource(int, CharSequence)} but
-	 * passes a null pointer for string length to force the driver to rely on the null
-	 * terminator for string length.  This is a workaround for an apparent flaw with some
-	 * AMD drivers that don't receive or interpret the length correctly, resulting in
-	 * an access violation when the driver tries to read past the string memory.
-	 *
-	 * <p>Hat tip to fewizz for the find and the fix.
-	 * 
-	 * <p>Source: https://github.com/vram-guild/canvas/commit/820bf754092ccaf8d0c169620c2ff575722d7d96
-	 */
-	private static void safeShaderSource(@NativeType("GLuint") int glId, @NativeType("GLchar const **") CharSequence source)
-	{
-		final MemoryStack stack = MemoryStack.stackGet();
-		final int stackPointer = stack.getPointer();
-
-		try
-		{
-			final ByteBuffer sourceBuffer = MemoryUtil.memUTF8(source, true);
-			final PointerBuffer pointers = stack.mallocPointer(1);
-			pointers.put(sourceBuffer);
-
-			GL32.nglShaderSource(glId, 1, pointers.address0(), 0);
-			org.lwjgl.system.APIUtil.apiArrayFree(pointers.address0(), 1);
-		}
-		finally
-		{
-			stack.setPointer(stackPointer);
-		}
-	}
-	
 	public void free() { GL32.glDeleteShader(this.id); }
 	
 	public static StringBuilder loadFile(String path, boolean absoluteFilePath, StringBuilder stringBuilder)
@@ -188,6 +151,4 @@ public class Shader
 		return stringBuilder;
 	}
 	
-	
-	
 }

core/src/main/java/com/seibel/distanthorizons/core/render/renderer/DhTerrainShaderProgram.java

@@ -132,6 +132,15 @@ public class DhTerrainShaderProgram extends ShaderProgram implements IDhApiShade
 			throw e;
 		}
 		
+		if (this.uEarthRadius != -1) this.setUniform(this.uEarthRadius,
+				/*6371KM*/ 6371000.0f / Config.Client.Advanced.Graphics.Experimental.earthCurveRatio.get());
+		
+		
+		// Noise Uniforms
+		this.setUniform(this.uNoiseEnabled, Config.Client.Advanced.Graphics.NoiseTexture.enableNoiseTexture.get());
+		this.setUniform(this.uNoiseSteps, Config.Client.Advanced.Graphics.NoiseTexture.noiseSteps.get());
+		this.setUniform(this.uNoiseIntensity, Config.Client.Advanced.Graphics.NoiseTexture.noiseIntensity.get().floatValue());
+		this.setUniform(this.uNoiseDropoff, Config.Client.Advanced.Graphics.NoiseTexture.noiseDropoff.get());
 	}
 	
 	
@@ -182,15 +191,6 @@ public class DhTerrainShaderProgram extends ShaderProgram implements IDhApiShade
 		
 		if (this.uDitherDhRendering != -1) this.setUniform(this.uDitherDhRendering, Config.Client.Advanced.Graphics.Quality.ditherDhFade.get());
 		
-		if (this.uEarthRadius != -1) this.setUniform(this.uEarthRadius,
-				/*6371KM*/ 6371000.0f / Config.Client.Advanced.Graphics.Experimental.earthCurveRatio.get());
-		
-		// Noise Uniforms
-		this.setUniform(this.uNoiseEnabled, Config.Client.Advanced.Graphics.NoiseTexture.enableNoiseTexture.get());
-		this.setUniform(this.uNoiseSteps, Config.Client.Advanced.Graphics.NoiseTexture.noiseSteps.get());
-		this.setUniform(this.uNoiseIntensity, Config.Client.Advanced.Graphics.NoiseTexture.noiseIntensity.get().floatValue());
-		this.setUniform(this.uNoiseDropoff, Config.Client.Advanced.Graphics.NoiseTexture.noiseDropoff.get());
-		
 		// Debug
 		this.setUniform(this.uWhiteWorld, Config.Client.Advanced.Debugging.enableWhiteWorld.get());
 		

core/src/main/java/com/seibel/distanthorizons/core/render/renderer/FadeRenderer.java

@@ -20,6 +20,7 @@
 package com.seibel.distanthorizons.core.render.renderer;
 
 import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
+import com.seibel.distanthorizons.core.level.DhClientLevel;
 import com.seibel.distanthorizons.core.render.glObject.GLState;
 import com.seibel.distanthorizons.core.render.renderer.shaders.FadeApplyShader;
 import com.seibel.distanthorizons.core.render.renderer.shaders.FadeShader;

core/src/main/java/com/seibel/distanthorizons/core/render/renderer/LodRenderer.java

@@ -106,7 +106,7 @@ public class LodRenderer
 	// The shader program
 	private IDhApiShaderProgram lodRenderProgram = null;
 	public QuadElementBuffer quadIBO = null;
-	private boolean isSetupComplete = false;
+	public boolean isSetupComplete = false;
 	
 	// frameBuffer and texture ID's for this renderer
 	private IDhApiFramebuffer framebuffer;
@@ -252,11 +252,6 @@ public class LodRenderer
 			
 			ApiEventInjector.INSTANCE.fireAllEvents(DhApiBeforeRenderSetupEvent.class, renderEventParam);
 			this.setupGLStateAndRenderObjects(profiler, renderEventParam, renderingFirstPass);
-			if (!this.isSetupComplete)
-			{
-				// this shouldn't normally happen, but just in case
-				return;
-			}
 			
 			lightmap.bind();
 			this.quadIBO.bind();
@@ -547,17 +542,17 @@ public class LodRenderer
 			activeFrameBuffer = framebufferOverride;
 		}
 		
-		activeFramebufferId = activeFrameBuffer.getId();
-		activeDepthTextureId = this.depthTexture.getTextureId();
+		this.setActiveFramebufferId(activeFrameBuffer.getId());
+		this.setActiveDepthTextureId(this.depthTexture.getTextureId());
 		if (this.nullableColorTexture != null)
 		{
-			activeColorTextureId = this.nullableColorTexture.getTextureId();
+			this.setActiveColorTextureId(this.nullableColorTexture.getTextureId());
 		}
 		else
 		{
 			// get MC's color texture
 			int mcColorTextureId = GL32.glGetFramebufferAttachmentParameteri(GL32.GL_FRAMEBUFFER, GL32.GL_COLOR_ATTACHMENT0, GL32.GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME);
-			activeColorTextureId = mcColorTextureId;
+			this.setActiveColorTextureId(mcColorTextureId);
 		}
 		// Bind LOD frame buffer
 		activeFrameBuffer.bind();
@@ -638,7 +633,7 @@ public class LodRenderer
 			EVENT_LOGGER.warn("Renderer setup called but it has already completed setup!");
 			return;
 		}
-		if (!GLProxy.hasInstance())
+		if (GLProxy.getInstance() == null)
 		{
 			// shouldn't normally happen, but just in case
 			EVENT_LOGGER.warn("Renderer setup called but GLProxy has not yet been setup!");
@@ -651,6 +646,7 @@ public class LodRenderer
 			
 			
 			EVENT_LOGGER.info("Setting up renderer");
+			this.isSetupComplete = true;
 			this.lodRenderProgram = new DhTerrainShaderProgram();
 			
 			this.quadIBO = new QuadElementBuffer();
@@ -679,11 +675,9 @@ public class LodRenderer
 			{
 				// This generally means something wasn't bound, IE missing either the color or depth texture
 				EVENT_LOGGER.warn("FrameBuffer ["+this.framebuffer.getId()+"] isn't complete.");
-				return;
 			}
 			
 			
-			this.isSetupComplete = true;
 			EVENT_LOGGER.info("Renderer setup complete");
 		}
 		finally
@@ -750,12 +744,15 @@ public class LodRenderer
 	// API functions //
 	//===============//
 	
+	private void setActiveFramebufferId(int frameBufferId) { activeFramebufferId = frameBufferId; }
 	/** Returns -1 if no frame buffer has been bound yet */
 	public static int getActiveFramebufferId() { return activeFramebufferId; }
 	
+	private void setActiveColorTextureId(int colorTextureId) { activeColorTextureId = colorTextureId; }
 	/** Returns -1 if no texture has been bound yet */
 	public static int getActiveColorTextureId() { return activeColorTextureId; }
 	
+	private void setActiveDepthTextureId(int depthTextureId) { activeDepthTextureId = depthTextureId; }
 	/**
 	 * FIXME it's possible for this to return an invalid texture ID if the renderer is being re-built at the same time 
 	 * Returns -1 if no texture has been bound yet 
@@ -774,7 +771,7 @@ public class LodRenderer
 	 */
 	private void cleanup()
 	{
-		if (!GLProxy.hasInstance())
+		if (GLProxy.getInstance() == null)
 		{
 			// shouldn't normally happen, but just in case
 			EVENT_LOGGER.warn("Renderer Cleanup called but the GLProxy has never been initialized!");
@@ -807,10 +804,6 @@ public class LodRenderer
 				if (this.depthTexture != null)
 					this.depthTexture.destroy();
 				
-				activeFramebufferId = -1;
-				activeColorTextureId = -1;
-				activeDepthTextureId = -1;
-				
 				EVENT_LOGGER.info("Renderer Cleanup Complete");
 			});
 		}

core/src/main/java/com/seibel/distanthorizons/core/render/renderer/TestRenderer.java

@@ -106,7 +106,6 @@ public class TestRenderer
 	
 	public void render()
 	{
-		// TODO fix for MC 1.21.5
 		this.init();
 		
 		GLMC.glBindFramebuffer(GL32.GL_FRAMEBUFFER, MC_RENDER.getTargetFrameBuffer());

core/src/main/java/com/seibel/distanthorizons/core/render/renderer/generic/GenericObjectRenderer.java

@@ -76,8 +76,6 @@ public class GenericObjectRenderer implements IDhApiCustomRenderRegister
 	private static final ISodiumAccessor SODIUM = ModAccessorInjector.INSTANCE.get(ISodiumAccessor.class);
 	private static final IMinecraftGLWrapper GLMC = SingletonInjector.INSTANCE.get(IMinecraftGLWrapper.class);
 	
-	private static final DhApiRenderableBoxGroupShading DEFAULT_SHADING = DhApiRenderableBoxGroupShading.getUnshaded();
-	
 	/** 
 	 * Can be used to troubleshoot the renderer. 
 	 * If enabled several debug objects will render around (0,150,0). 
@@ -521,13 +519,13 @@ public class GenericObjectRenderer implements IDhApiCustomRenderRegister
 	{
 		// update instance data //
 		
-		profiler.push("vertex setup");
+		profiler.push("setup");
 		boxGroup.updateVertexAttributeData();
 		
 		DhApiRenderableBoxGroupShading shading = boxGroup.shading;
 		if (shading == null)
 		{
-			shading = DEFAULT_SHADING;
+			shading = DhApiRenderableBoxGroupShading.getUnshaded();
 		}
 		
 		shaderProgram.fillIndirectUniformData(
@@ -538,7 +536,6 @@ public class GenericObjectRenderer implements IDhApiCustomRenderRegister
 		
 		
 		// Bind instance data //
-		profiler.popPush("binding");
 		
 		GL32.glBindBuffer(GL32.GL_ARRAY_BUFFER, boxGroup.instanceColorVbo);
 		GL32.glEnableVertexAttribArray(1);

core/src/main/java/com/seibel/distanthorizons/core/render/renderer/generic/RenderableBoxGroup.java

@@ -211,10 +211,6 @@ public class RenderableBoxGroup
 		@Override 
 		public boolean removeIf(Predicate<? super DhApiRenderableBox> filter) { return this.boxList.removeIf(filter); }
 		@Override 
-		public boolean remove(Object obj) { return this.boxList.remove(obj); }
-		@Override 
-		public DhApiRenderableBox remove(int index) { return this.boxList.remove(index); }
-		@Override 
 		public void replaceAll(UnaryOperator<DhApiRenderableBox> operator) { this.boxList.replaceAll(operator); }
 		@Override 
 		public void sort(Comparator<? super DhApiRenderableBox> comparator) { this.boxList.sort(comparator); }

core/src/main/java/com/seibel/distanthorizons/core/render/renderer/shaders/FadeShader.java

@@ -19,7 +19,6 @@
 
 package com.seibel.distanthorizons.core.render.renderer.shaders;
 
-import com.seibel.distanthorizons.core.config.Config;
 import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
 import com.seibel.distanthorizons.core.render.glObject.GLState;
 import com.seibel.distanthorizons.core.render.glObject.shader.ShaderProgram;
@@ -37,6 +36,7 @@ public class FadeShader extends AbstractShaderRenderer
 {
 	public static FadeShader INSTANCE = new FadeShader();
 	
+	private static final IMinecraftClientWrapper MC_CLIENT = SingletonInjector.INSTANCE.get(IMinecraftClientWrapper.class);
 	private static final IMinecraftRenderWrapper MC_RENDER = SingletonInjector.INSTANCE.get(IMinecraftRenderWrapper.class);
 	private static final IMinecraftGLWrapper GLMC = SingletonInjector.INSTANCE.get(IMinecraftGLWrapper.class);
 	
@@ -60,9 +60,9 @@ public class FadeShader extends AbstractShaderRenderer
 	
 	public int uStartFadeBlockDistance = -1;
 	public int uEndFadeBlockDistance = -1;
+	
 	public int uMaxLevelHeight = -1;
 	
-	public int uOnlyRenderLods = -1;
 	
 	
 	
@@ -87,16 +87,15 @@ public class FadeShader extends AbstractShaderRenderer
 		this.uDhInvMvmProj = this.shader.tryGetUniformLocation("uDhInvMvmProj");
 		this.uMcInvMvmProj = this.shader.tryGetUniformLocation("uMcInvMvmProj");
 		
-		this.uMcDepthTexture = this.shader.tryGetUniformLocation("uMcDepthTexture");
+		this.uMcDepthTexture = this.shader.tryGetUniformLocation("uMcDepthMap");
 		this.uDhDepthTexture = this.shader.tryGetUniformLocation("uDhDepthTexture");
 		this.uCombinedMcDhColorTexture = this.shader.tryGetUniformLocation("uCombinedMcDhColorTexture");
 		this.uDhColorTexture = this.shader.tryGetUniformLocation("uDhColorTexture");
 		
 		this.uStartFadeBlockDistance = this.shader.tryGetUniformLocation("uStartFadeBlockDistance");
 		this.uEndFadeBlockDistance = this.shader.tryGetUniformLocation("uEndFadeBlockDistance");
-		this.uMaxLevelHeight = this.shader.tryGetUniformLocation("uMaxLevelHeight");
 		
-		this.uOnlyRenderLods = this.shader.tryGetUniformLocation("uOnlyRenderLods");
+		this.uMaxLevelHeight = this.shader.tryGetUniformLocation("uMaxLevelHeight");
 		
 	}
 	
@@ -109,8 +108,8 @@ public class FadeShader extends AbstractShaderRenderer
 	@Override
 	protected void onApplyUniforms(float partialTicks)
 	{
-		this.shader.setUniform(this.uMcInvMvmProj, this.inverseMcMvmProjMatrix);
-		this.shader.setUniform(this.uDhInvMvmProj, this.inverseDhMvmProjMatrix);
+		if (this.inverseMcMvmProjMatrix != null) this.shader.setUniform(this.uMcInvMvmProj, this.inverseMcMvmProjMatrix);
+		if (this.inverseDhMvmProjMatrix != null) this.shader.setUniform(this.uDhInvMvmProj, this.inverseDhMvmProjMatrix);
 		
 		
 		float dhNearClipDistance = RenderUtil.getNearClipPlaneInBlocksForFading(partialTicks);
@@ -123,12 +122,10 @@ public class FadeShader extends AbstractShaderRenderer
 		float fadeStartDistance = dhNearClipDistance * 1.5f;
 		float fadeEndDistance = dhNearClipDistance * 1.9f;
 		
-		this.shader.setUniform(this.uStartFadeBlockDistance, fadeStartDistance);
-		this.shader.setUniform(this.uEndFadeBlockDistance, fadeEndDistance);
+		if (this.uStartFadeBlockDistance != -1) this.shader.setUniform(this.uStartFadeBlockDistance, fadeStartDistance);
+		if (this.uEndFadeBlockDistance != -1) this.shader.setUniform(this.uEndFadeBlockDistance, fadeEndDistance);
 		
-		this.shader.setUniform(this.uMaxLevelHeight, this.levelMaxHeight);
-		
-		this.shader.setUniform(this.uOnlyRenderLods, Config.Client.Advanced.Debugging.lodOnlyMode.get());
+		if (this.uMaxLevelHeight != -1) this.shader.setUniform(this.uMaxLevelHeight, this.levelMaxHeight);
 	}
 	
 	public void setProjectionMatrix(Mat4f mcModelViewMatrix, Mat4f mcProjectionMatrix, float partialTicks)
@@ -158,19 +155,6 @@ public class FadeShader extends AbstractShaderRenderer
 	@Override
 	protected void onRender()
 	{
-		int depthTextureId = LodRenderer.getActiveDepthTextureId();
-		int colorTextureId = LodRenderer.getActiveColorTextureId();
-		
-		if (depthTextureId == -1
-			|| colorTextureId == -1)
-		{
-			// the renderer is currently being re-built and/or inactive,
-			// we don't need to/can't render fading
-			return;
-		}
-		
-		
-		
 		GLMC.glBindFramebuffer(GL32.GL_FRAMEBUFFER, this.frameBuffer);
 		GLMC.disableScissorTest();
 		GLMC.disableDepthTest();
@@ -181,7 +165,8 @@ public class FadeShader extends AbstractShaderRenderer
 		GL32.glUniform1i(this.uMcDepthTexture, 0);
 		
 		GLMC.glActiveTexture(GL32.GL_TEXTURE1);
-		GLMC.glBindTexture(depthTextureId);
+		// FIXME it's possible for this to return an invalid texture ID if the renderer is being re-built at the same time
+		GLMC.glBindTexture(LodRenderer.getActiveDepthTextureId());
 		GL32.glUniform1i(this.uDhDepthTexture, 1);
 		
 		GLMC.glActiveTexture(GL32.GL_TEXTURE2);
@@ -189,7 +174,7 @@ public class FadeShader extends AbstractShaderRenderer
 		GL32.glUniform1i(this.uCombinedMcDhColorTexture, 2);
 		
 		GLMC.glActiveTexture(GL32.GL_TEXTURE3);
-		GLMC.glBindTexture(colorTextureId);
+		GLMC.glBindTexture(LodRenderer.getActiveColorTextureId());
 		GL32.glUniform1i(this.uDhColorTexture, 3);
 		
 		

core/src/main/java/com/seibel/distanthorizons/core/render/renderer/shaders/FogShader.java

@@ -28,6 +28,7 @@ import com.seibel.distanthorizons.core.render.glObject.shader.ShaderProgram;
 import com.seibel.distanthorizons.core.render.renderer.LodRenderer;
 import com.seibel.distanthorizons.core.render.renderer.ScreenQuad;
 import com.seibel.distanthorizons.core.util.LodUtil;
+import com.seibel.distanthorizons.core.wrapperInterfaces.IVersionConstants;
 import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftClientWrapper;
 import com.seibel.distanthorizons.core.util.math.Mat4f;
 import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftGLWrapper;

core/src/main/java/com/seibel/distanthorizons/core/render/renderer/shaders/SSAOShader.java

@@ -50,14 +50,14 @@ public class SSAOShader extends AbstractShaderRenderer
 	
 	
 	// uniforms
-	public int uProj;
-	public int uInvProj;
-	public int uSampleCount;
-	public int uRadius;
-	public int uStrength;
-	public int uMinLight;
-	public int uBias;
-	public int uDepthMap;
+	public int gProjUniform;
+	public int gInvProjUniform;
+	public int gSampleCountUniform;
+	public int gRadiusUniform;
+	public int gStrengthUniform;
+	public int gMinLightUniform;
+	public int gBiasUniform;
+	public int gDepthMapUniform;
 	
 	
 	
@@ -73,14 +73,14 @@ public class SSAOShader extends AbstractShaderRenderer
 		);
 		
 		// uniform setup
-		this.uProj = this.shader.getUniformLocation("uProj");
-		this.uInvProj = this.shader.getUniformLocation("uInvProj");
-		this.uSampleCount = this.shader.getUniformLocation("uSampleCount");
-		this.uRadius = this.shader.getUniformLocation("uRadius");
-		this.uStrength = this.shader.getUniformLocation("uStrength");
-		this.uMinLight = this.shader.getUniformLocation("uMinLight");
-		this.uBias = this.shader.getUniformLocation("uBias");
-		this.uDepthMap = this.shader.getUniformLocation("uDepthMap");
+		this.gProjUniform = this.shader.getUniformLocation("gProj");
+		this.gInvProjUniform = this.shader.getUniformLocation("gInvProj");
+		this.gSampleCountUniform = this.shader.getUniformLocation("gSampleCount");
+		this.gRadiusUniform = this.shader.getUniformLocation("gRadius");
+		this.gStrengthUniform = this.shader.getUniformLocation("gStrength");
+		this.gMinLightUniform = this.shader.getUniformLocation("gMinLight");
+		this.gBiasUniform = this.shader.getUniformLocation("gBias");
+		this.gDepthMapUniform = this.shader.getUniformLocation("gDepthMap");
 	}
 	
 	
@@ -100,26 +100,28 @@ public class SSAOShader extends AbstractShaderRenderer
 	@Override
 	protected void onApplyUniforms(float partialTicks)
 	{
-		this.shader.setUniform(this.uProj, this.projection);
+		this.shader.setUniform(this.gProjUniform, this.projection);
 		
-		this.shader.setUniform(this.uInvProj, this.invertedProjection);
+		this.shader.setUniform(this.gInvProjUniform, this.invertedProjection);
 		
-		this.shader.setUniform(this.uSampleCount, Config.Client.Advanced.Graphics.Ssao.sampleCount.get());
+		this.shader.setUniform(this.gSampleCountUniform,
+				Config.Client.Advanced.Graphics.Ssao.sampleCount.get());
 		
-		// Explicit Number casts need to be done to prevent issues with the default value being an int
+		// Implicit Number cast needs to be done to prevent issues with the default value being a int
 		Number radius = Config.Client.Advanced.Graphics.Ssao.radius.get(); 
-		this.shader.setUniform(this.uRadius, radius.floatValue());
+		this.shader.setUniform(this.gRadiusUniform, radius.floatValue());
+		
 		
 		Number strength = Config.Client.Advanced.Graphics.Ssao.strength.get();
-		this.shader.setUniform(this.uStrength, strength.floatValue());
+		this.shader.setUniform(this.gStrengthUniform, strength.floatValue());
 		
 		Number minLight = Config.Client.Advanced.Graphics.Ssao.minLight.get();
-		this.shader.setUniform(this.uMinLight, minLight.floatValue());
+		this.shader.setUniform(this.gMinLightUniform, minLight.floatValue());
 		
 		Number bias = Config.Client.Advanced.Graphics.Ssao.bias.get();
-		this.shader.setUniform(this.uBias, bias.floatValue());
+		this.shader.setUniform(this.gBiasUniform, bias.floatValue());
 		
-		GL32.glUniform1i(this.uDepthMap, 0);
+		GL32.glUniform1i(this.gDepthMapUniform, 0);
 	}
 	
 	

core/src/main/java/com/seibel/distanthorizons/core/sql/dto/FullDataSourceV2DTO.java

@@ -25,7 +25,7 @@ import com.seibel.distanthorizons.api.enums.config.EDhApiWorldCompressionMode;
 import com.seibel.distanthorizons.api.enums.worldGeneration.EDhApiWorldGenerationStep;
 import com.seibel.distanthorizons.core.dataObjects.fullData.FullDataPointIdMap;
 import com.seibel.distanthorizons.core.dataObjects.fullData.sources.FullDataSourceV2;
-import com.seibel.distanthorizons.core.pooling.AbstractPhantomArrayList;
+import com.seibel.distanthorizons.core.pooling.PhantomArrayListParent;
 import com.seibel.distanthorizons.core.pooling.PhantomArrayListPool;
 import com.seibel.distanthorizons.core.pos.DhSectionPos;
 import com.seibel.distanthorizons.core.network.INetworkObject;
@@ -47,7 +47,7 @@ import java.io.*;
 
 /** handles storing {@link FullDataSourceV2}'s in the database. */
 public class FullDataSourceV2DTO 
-		extends AbstractPhantomArrayList
+		extends PhantomArrayListParent
 		implements IBaseDTO<Long>, INetworkObject, AutoCloseable
 {
 	public static final boolean VALIDATE_INPUT_DATAPOINTS = true;
@@ -142,16 +142,7 @@ public class FullDataSourceV2DTO
 	public FullDataSourceV2 createDataSource(@NotNull ILevelWrapper levelWrapper) throws IOException, InterruptedException, DataCorruptedException
 	{
 		FullDataSourceV2 dataSource = FullDataSourceV2.createEmpty(this.pos);
-		try
-		{	
-			this.internalPopulateDataSource(dataSource, levelWrapper, false);
-		}
-		catch (Exception e)
-		{
-			dataSource.close();
-			throw e;
-		}
-		
+		this.internalPopulateDataSource(dataSource, levelWrapper, false);
 		return dataSource;
 	}
 	
@@ -237,63 +228,63 @@ public class FullDataSourceV2DTO
 		
 		// normally a DhStream should be the topmost stream to prevent closing the stream accidentally, 
 		// but since this stream will be closed immediately after writing anyway, it won't be an issue
-		try (DhDataOutputStream compressedOut = new DhDataOutputStream(byteArrayOutputStream, compressionModeEnum))
+		DhDataOutputStream compressedOut = new DhDataOutputStream(byteArrayOutputStream, compressionModeEnum);
+		
+		
+		// write the data
+		int dataArrayLength = FullDataSourceV2.WIDTH * FullDataSourceV2.WIDTH;
+		for (int xz = 0; xz < dataArrayLength; xz++)
 		{
-			// write the data
-			int dataArrayLength = FullDataSourceV2.WIDTH * FullDataSourceV2.WIDTH;
-			for (int xz = 0; xz < dataArrayLength; xz++)
+			LongArrayList dataColumn = inputDataArray[xz];
+			
+			// write column length
+			short columnLength = (dataColumn != null) ? (short) dataColumn.size() : 0;
+			// a short is used instead of an int because at most we store 4096 vertical slices and a 
+			// short fits that with less wasted spaces vs an int (short has max value of 32,767 vs int's max of 2 billion)
+			compressedOut.writeShort(columnLength);
+			
+			// write column data (will be skipped if no data was present)
+			for (int y = 0; y < columnLength; y++)
 			{
-				LongArrayList dataColumn = inputDataArray[xz];
-				
-				// write column length
-				short columnLength = (dataColumn != null) ? (short) dataColumn.size() : 0;
-				// a short is used instead of an int because at most we store 4096 vertical slices and a 
-				// short fits that with less wasted spaces vs an int (short has max value of 32,767 vs int's max of 2 billion)
-				compressedOut.writeShort(columnLength);
-				
-				// write column data (will be skipped if no data was present)
-				for (int y = 0; y < columnLength; y++)
-				{
-					compressedOut.writeLong(dataColumn.getLong(y));
-				}
+				compressedOut.writeLong(dataColumn.getLong(y));
 			}
-			
-			
-			// generate the checksum
-			compressedOut.flush();
-			byteArrayOutputStream.close();
-			outputByteArray.addElements(0, byteArrayOutputStream.toByteArray());
 		}
+		
+		
+		// generate the checksum
+		compressedOut.flush();
+		byteArrayOutputStream.close();
+		outputByteArray.addElements(0, byteArrayOutputStream.toByteArray());
 	}
 	private static void readBlobToDataSourceDataArray(ByteArrayList inputCompressedDataByteArray, LongArrayList[] outputDataLongArray, EDhApiDataCompressionMode compressionModeEnum) throws IOException, DataCorruptedException
 	{
 		ByteArrayInputStream byteArrayInputStream = new ByteArrayInputStream(inputCompressedDataByteArray.elements());
-		try (DhDataInputStream compressedIn = new DhDataInputStream(byteArrayInputStream, compressionModeEnum))
+		DhDataInputStream compressedIn = new DhDataInputStream(byteArrayInputStream, compressionModeEnum);
+		
+		
+		// read the data
+		int dataArrayLength = FullDataSourceV2.WIDTH * FullDataSourceV2.WIDTH;
+		for (int xz = 0; xz < dataArrayLength; xz++)
 		{
-			// read the data
-			int dataArrayLength = FullDataSourceV2.WIDTH * FullDataSourceV2.WIDTH;
-			for (int xz = 0; xz < dataArrayLength; xz++)
+			// read the column length
+			short dataColumnLength = compressedIn.readShort(); // separate variables are used for debugging and in case validation wants to be added later 
+			if (dataColumnLength < 0)
 			{
-				// read the column length
-				short dataColumnLength = compressedIn.readShort(); // separate variables are used for debugging and in case validation wants to be added later 
-				if (dataColumnLength < 0)
+				throw new DataCorruptedException("Read DataSource Blob data at index ["+xz+"], column length ["+dataColumnLength+"] should be greater than zero.");
+			}
+			
+			LongArrayList dataColumn = outputDataLongArray[xz];
+			ListUtil.clearAndSetSize(dataColumn, dataColumnLength);
+			
+			// read column data (will be skipped if no data was present)
+			for (int y = 0; y < dataColumnLength; y++)
+			{
+				long dataPoint = compressedIn.readLong();
+				if (VALIDATE_INPUT_DATAPOINTS)
 				{
-					throw new DataCorruptedException("Read DataSource Blob data at index [" + xz + "], column length [" + dataColumnLength + "] should be greater than zero.");
-				}
-				
-				LongArrayList dataColumn = outputDataLongArray[xz];
-				ListUtil.clearAndSetSize(dataColumn, dataColumnLength);
-				
-				// read column data (will be skipped if no data was present)
-				for (int y = 0; y < dataColumnLength; y++)
-				{
-					long dataPoint = compressedIn.readLong();
-					if (VALIDATE_INPUT_DATAPOINTS)
-					{
-						FullDataPointUtil.validateDatapoint(dataPoint);
-					}
-					dataColumn.set(y, dataPoint);
+					FullDataPointUtil.validateDatapoint(dataPoint);
 				}
+				dataColumn.set(y, dataPoint);
 			}
 		}
 	}
@@ -302,23 +293,23 @@ public class FullDataSourceV2DTO
 	private static void writeGenerationStepsToBlob(ByteArrayList inputColumnGenStepByteArray, ByteArrayList outputByteArray, EDhApiDataCompressionMode compressionModeEnum) throws IOException
 	{
 		ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream();
-		try (DhDataOutputStream compressedOut = new DhDataOutputStream(byteArrayOutputStream, compressionModeEnum))
+		DhDataOutputStream compressedOut = new DhDataOutputStream(byteArrayOutputStream, compressionModeEnum);
+		
+		for (int i = 0; i < inputColumnGenStepByteArray.size(); i++)
 		{
-			for (int i = 0; i < inputColumnGenStepByteArray.size(); i++)
-			{
-				compressedOut.writeByte(inputColumnGenStepByteArray.getByte(i));
-			}
-			
-			compressedOut.flush();
-			byteArrayOutputStream.close();
-			outputByteArray.addElements(0, byteArrayOutputStream.toByteArray());
+			compressedOut.writeByte(inputColumnGenStepByteArray.getByte(i));
 		}
+		
+		compressedOut.flush();
+		byteArrayOutputStream.close();
+		outputByteArray.addElements(0, byteArrayOutputStream.toByteArray());
 	}
 	private static void readBlobToGenerationSteps(ByteArrayList inputCompressedDataByteArray, ByteArrayList outputByteArray, EDhApiDataCompressionMode compressionModeEnum) throws IOException, DataCorruptedException
 	{
 		ByteArrayInputStream byteArrayInputStream = new ByteArrayInputStream(inputCompressedDataByteArray.elements());
+		DhDataInputStream compressedIn = new DhDataInputStream(byteArrayInputStream, compressionModeEnum);
 		
-		try(DhDataInputStream compressedIn = new DhDataInputStream(byteArrayInputStream, compressionModeEnum))
+		try
 		{
 			compressedIn.readFully(outputByteArray.elements(), 0, FullDataSourceV2.WIDTH * FullDataSourceV2.WIDTH);
 		}
@@ -332,23 +323,23 @@ public class FullDataSourceV2DTO
 	private static void writeWorldCompressionModeToBlob(ByteArrayList inputWorldCompressionModeByteArray, ByteArrayList outputByteArray, EDhApiDataCompressionMode compressionModeEnum) throws IOException
 	{
 		ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream();
-		try (DhDataOutputStream compressedOut = new DhDataOutputStream(byteArrayOutputStream, compressionModeEnum))
+		DhDataOutputStream compressedOut = new DhDataOutputStream(byteArrayOutputStream, compressionModeEnum);
+		
+		for (int i = 0; i < inputWorldCompressionModeByteArray.size(); i++)
 		{
-			for (int i = 0; i < inputWorldCompressionModeByteArray.size(); i++)
-			{
-				compressedOut.write(inputWorldCompressionModeByteArray.getByte(i));
-			}
-			
-			compressedOut.flush();
-			byteArrayOutputStream.close();
-			outputByteArray.addElements(0, byteArrayOutputStream.toByteArray());
+			compressedOut.write(inputWorldCompressionModeByteArray.getByte(i));
 		}
+		
+		compressedOut.flush();
+		byteArrayOutputStream.close();
+		outputByteArray.addElements(0, byteArrayOutputStream.toByteArray());
 	}
 	private static void readBlobToWorldCompressionMode(ByteArrayList inputCompressedDataByteArray, ByteArrayList outputByteArray, EDhApiDataCompressionMode compressionModeEnum) throws IOException, DataCorruptedException
 	{
 		ByteArrayInputStream byteArrayInputStream = new ByteArrayInputStream(inputCompressedDataByteArray.elements());
+		DhDataInputStream compressedIn = new DhDataInputStream(byteArrayInputStream, compressionModeEnum);
 		
-		try(DhDataInputStream compressedIn = new DhDataInputStream(byteArrayInputStream, compressionModeEnum))
+		try
 		{
 			compressedIn.readFully(outputByteArray.elements(), 0, FullDataSourceV2.WIDTH * FullDataSourceV2.WIDTH);
 		}
@@ -362,23 +353,21 @@ public class FullDataSourceV2DTO
 	private static void writeDataMappingToBlob(FullDataPointIdMap mapping, ByteArrayList outputByteArray, EDhApiDataCompressionMode compressionModeEnum) throws IOException
 	{
 		ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream();
-		try(DhDataOutputStream compressedOut = new DhDataOutputStream(byteArrayOutputStream, compressionModeEnum))
-		{
-			mapping.serialize(compressedOut);
-			
-			compressedOut.flush();
-			byteArrayOutputStream.close();
-			outputByteArray.addElements(0, byteArrayOutputStream.toByteArray());
-		}
+		DhDataOutputStream compressedOut = new DhDataOutputStream(byteArrayOutputStream, compressionModeEnum);
+		
+		mapping.serialize(compressedOut);
+		
+		compressedOut.flush();
+		byteArrayOutputStream.close();
+		outputByteArray.addElements(0, byteArrayOutputStream.toByteArray());
 	}
 	private static FullDataPointIdMap readBlobToDataMapping(ByteArrayList compressedMappingByteArray, long pos, @NotNull ILevelWrapper levelWrapper, EDhApiDataCompressionMode compressionModeEnum) throws IOException, InterruptedException, DataCorruptedException
 	{
 		ByteArrayInputStream byteArrayInputStream = new ByteArrayInputStream(compressedMappingByteArray.elements());
-		try (DhDataInputStream compressedIn = new DhDataInputStream(byteArrayInputStream, compressionModeEnum))
-		{
-			FullDataPointIdMap mapping = FullDataPointIdMap.deserialize(compressedIn, pos, levelWrapper);
-			return mapping;
-		}
+		DhDataInputStream compressedIn = new DhDataInputStream(byteArrayInputStream, compressionModeEnum);
+		
+		FullDataPointIdMap mapping = FullDataPointIdMap.deserialize(compressedIn, pos, levelWrapper);
+		return mapping;
 	}
 	
 	

core/src/main/java/com/seibel/distanthorizons/core/sql/repo/BeaconBeamRepo.java

@@ -35,6 +35,7 @@ import java.sql.ResultSet;
 import java.sql.SQLException;
 import java.util.ArrayList;
 import java.util.List;
+import java.util.Map;
 
 public class BeaconBeamRepo extends AbstractDhRepo<DhBlockPos, BeaconBeamDTO>
 {
@@ -95,20 +96,20 @@ public class BeaconBeamRepo extends AbstractDhRepo<DhBlockPos, BeaconBeamDTO>
 		return dto;
 	}
 	
-	private final String insertSqlTemplate =
-		"INSERT INTO "+this.getTableName() + " (\n" +
-		"   BlockPosX, BlockPosY, BlockPosZ, \n" +
-		"   ColorR, ColorG, ColorB, \n" +
-		"   LastModifiedUnixDateTime, CreatedUnixDateTime) \n" +
-		"VALUES( \n" +
-		"    ?, ?, ?, \n" +
-		"    ?, ?, ?, \n" +
-		"    ?, ? \n" +
-		");";
 	@Override
 	public PreparedStatement createInsertStatement(BeaconBeamDTO dto) throws SQLException
 	{
-		PreparedStatement statement = this.createPreparedStatement(this.insertSqlTemplate);
+		String sql =
+			"INSERT INTO "+this.getTableName() + " (\n" +
+			"   BlockPosX, BlockPosY, BlockPosZ, \n" +
+			"   ColorR, ColorG, ColorB, \n" +
+			"   LastModifiedUnixDateTime, CreatedUnixDateTime) \n" +
+			"VALUES( \n" +
+			"    ?, ?, ?, \n" +
+			"    ?, ?, ?, \n" +
+			"    ?, ? \n" +
+			");";
+		PreparedStatement statement = this.createPreparedStatement(sql);
 		if (statement == null)
 		{
 			return null;
@@ -130,16 +131,16 @@ public class BeaconBeamRepo extends AbstractDhRepo<DhBlockPos, BeaconBeamDTO>
 		return statement;
 	}
 	
-	private final String updateSqlTemplate =
-		"UPDATE "+this.getTableName()+" \n" +
-		"SET \n" +
-		"    ColorR = ?, ColorG = ?, ColorB = ?,  \n" +
-		"    LastModifiedUnixDateTime = ? \n" +
-		"WHERE BlockPosX = ? AND BlockPosY = ? AND BlockPosZ = ?";
 	@Override
 	public PreparedStatement createUpdateStatement(BeaconBeamDTO dto) throws SQLException
 	{
-		PreparedStatement statement = this.createPreparedStatement(this.updateSqlTemplate);
+		String sql =
+			"UPDATE "+this.getTableName()+" \n" +
+			"SET \n" +
+			"    ColorR = ?, ColorG = ?, ColorB = ?,  \n" +
+			"    LastModifiedUnixDateTime = ? \n" +
+			"WHERE BlockPosX = ? AND BlockPosY = ? AND BlockPosZ = ?";
+		PreparedStatement statement = this.createPreparedStatement(sql);
 		if (statement == null)
 		{
 			return null;

core/src/main/java/com/seibel/distanthorizons/core/sql/repo/ChunkHashRepo.java

@@ -21,6 +21,7 @@ package com.seibel.distanthorizons.core.sql.repo;
 
 import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
 import com.seibel.distanthorizons.core.pos.DhChunkPos;
+import com.seibel.distanthorizons.core.sql.dto.BeaconBeamDTO;
 import com.seibel.distanthorizons.core.sql.dto.ChunkHashDTO;
 import org.apache.logging.log4j.Logger;
 import org.jetbrains.annotations.Nullable;
@@ -29,6 +30,7 @@ import java.io.File;
 import java.sql.PreparedStatement;
 import java.sql.ResultSet;
 import java.sql.SQLException;
+import java.util.Map;
 
 public class ChunkHashRepo extends AbstractDhRepo<DhChunkPos, ChunkHashDTO>
 {
@@ -85,25 +87,20 @@ public class ChunkHashRepo extends AbstractDhRepo<DhChunkPos, ChunkHashDTO>
 		return dto;
 	}
 	
-	private final String insertSqlTemplate =
-		"INSERT INTO "+this.getTableName() + " (\n" +
-		"   ChunkPosX, ChunkPosZ, \n" +
-		"   ChunkHash, \n" +
-		"   LastModifiedUnixDateTime, CreatedUnixDateTime) \n" +
-		"VALUES( \n" +
-		"    ?, ?, \n" +
-		"    ?, \n" +
-		"    ?, ? \n" +
-		");";
 	@Override
 	public PreparedStatement createInsertStatement(ChunkHashDTO dto) throws SQLException
 	{
-		PreparedStatement statement = this.createPreparedStatement(this.insertSqlTemplate);
-		if (statement == null)
-		{
-			return null;
-		}
-		
+		String sql =
+			"INSERT INTO "+this.getTableName() + " (\n" +
+			"   ChunkPosX, ChunkPosZ, \n" +
+			"   ChunkHash, \n" +
+			"   LastModifiedUnixDateTime, CreatedUnixDateTime) \n" +
+			"VALUES( \n" +
+			"    ?, ?, \n" +
+			"    ?, \n" +
+			"    ?, ? \n" +
+			");";
+		PreparedStatement statement = this.createPreparedStatement(sql);
 		
 		int i = 1;
 		statement.setObject(i++, dto.pos.getX());
@@ -117,21 +114,16 @@ public class ChunkHashRepo extends AbstractDhRepo<DhChunkPos, ChunkHashDTO>
 		return statement;
 	}
 	
-	private final String updateSqlTemplate =
-		"UPDATE "+this.getTableName()+" \n" +
-		"SET \n" +
-		"    ChunkHash = ? \n" +
-		"   ,LastModifiedUnixDateTime = ? \n" +
-		"WHERE ChunkPosX = ? AND ChunkPosZ = ?";
 	@Override
 	public PreparedStatement createUpdateStatement(ChunkHashDTO dto) throws SQLException
 	{
-		PreparedStatement statement = this.createPreparedStatement(updateSqlTemplate);
-		if (statement == null)
-		{
-			return null;
-		}
-		
+		String sql =
+			"UPDATE "+this.getTableName()+" \n" +
+			"SET \n" +
+			"    ChunkHash = ? \n" +
+			"   ,LastModifiedUnixDateTime = ? \n" +
+			"WHERE ChunkPosX = ? AND ChunkPosZ = ?";
+		PreparedStatement statement = this.createPreparedStatement(sql);
 		
 		int i = 1;
 		statement.setObject(i++, dto.chunkHash);

core/src/main/java/com/seibel/distanthorizons/core/sql/repo/FullDataSourceV2Repo.java

@@ -312,22 +312,22 @@ public class FullDataSourceV2Repo extends AbstractDhRepo<Long, FullDataSourceV2D
 	/** should be be very similar to {@link FullDataSourceV2Repo#getChildPositionsToUpdateSql} */
 	private final String getParentPositionsToUpdateSql =
 			"SELECT DetailLevel, PosX, PosZ, " +
-			"   abs((PosX << (6 + DetailLevel)) - ?) + abs((PosZ << (6 + DetailLevel)) - ?) AS Distance " +
-			"FROM " + this.getTableName() + " " +
-			"WHERE ApplyToParent = 1 " +
-			"ORDER BY DetailLevel ASC, Distance ASC " +
-			"LIMIT ?; ";
+					"   abs((PosX << (6 + DetailLevel)) - ?) + abs((PosZ << (6 + DetailLevel)) - ?) AS Distance " +
+					"FROM " + this.getTableName() + " " +
+					"WHERE ApplyToParent = 1 " +
+					"ORDER BY DetailLevel ASC, Distance ASC " +
+					"LIMIT ?; ";
 	public LongArrayList getPositionsToUpdate(int targetBlockPosX, int targetBlockPosZ, int returnCount)
 	{ return this.getPositionsToUpdate(targetBlockPosX, targetBlockPosZ, returnCount, true); }
 	
 	/** should be be very similar to {@link FullDataSourceV2Repo#getParentPositionsToUpdateSql} */
 	private final String getChildPositionsToUpdateSql =
 			"SELECT DetailLevel, PosX, PosZ, " +
-			"   abs((PosX << (6 + DetailLevel)) - ?) + abs((PosZ << (6 + DetailLevel)) - ?) AS Distance " +
-			"FROM " + this.getTableName() + " " +
-			"WHERE ApplyToChildren = 1 " +
-			"ORDER BY DetailLevel ASC, Distance ASC " +
-			"LIMIT ?; ";
+					"   abs((PosX << (6 + DetailLevel)) - ?) + abs((PosZ << (6 + DetailLevel)) - ?) AS Distance " +
+					"FROM " + this.getTableName() + " " +
+					"WHERE ApplyToChildren = 1 " +
+					"ORDER BY DetailLevel ASC, Distance ASC " +
+					"LIMIT ?; ";
 	public LongArrayList getChildPositionsToUpdate(int targetBlockPosX, int targetBlockPosZ, int returnCount)
 	{ return this.getPositionsToUpdate(targetBlockPosX, targetBlockPosZ, returnCount, false); }
 	
@@ -410,9 +410,10 @@ public class FullDataSourceV2Repo extends AbstractDhRepo<Long, FullDataSourceV2D
 				byte compressionModeEnumValue = result.getByte("CompressionMode");
 				EDhApiDataCompressionMode compressionModeEnum = EDhApiDataCompressionMode.getFromValue(compressionModeEnumValue);
 				
-				// decompress the data
-				try(DhDataInputStream compressedIn = new DhDataInputStream(result.getBinaryStream("ColumnGenerationStep"), compressionModeEnum))
+				try
 				{
+					// decompress the data
+					DhDataInputStream compressedIn = new DhDataInputStream(result.getBinaryStream("ColumnGenerationStep"), compressionModeEnum);
 					putAllBytes(compressedIn, outputByteArray);
 				}
 				catch (IOException e)

core/src/main/java/com/seibel/distanthorizons/core/util/RenderDataPointReducingList.java

@@ -22,7 +22,7 @@ package com.seibel.distanthorizons.core.util;
 import com.google.common.annotations.VisibleForTesting;
 import com.seibel.distanthorizons.core.dataObjects.render.columnViews.ColumnArrayView;
 import com.seibel.distanthorizons.core.dataObjects.render.columnViews.IColumnDataView;
-import com.seibel.distanthorizons.core.pooling.AbstractPhantomArrayList;
+import com.seibel.distanthorizons.core.pooling.PhantomArrayListParent;
 import com.seibel.distanthorizons.core.pooling.PhantomArrayListPool;
 import com.seibel.distanthorizons.core.util.LodUtil.AssertFailureException;
 import it.unimi.dsi.fastutil.longs.LongArrayList;
@@ -46,7 +46,7 @@ import it.unimi.dsi.fastutil.shorts.ShortArrays;
  *
  * @author Builderb0y
  */
-public class RenderDataPointReducingList extends AbstractPhantomArrayList
+public class RenderDataPointReducingList extends PhantomArrayListParent
 {
 
 	/**

core/src/main/java/com/seibel/distanthorizons/core/util/objects/dataStreams/DhDataInputStream.java

@@ -19,9 +19,10 @@
 
 package com.seibel.distanthorizons.core.util.objects.dataStreams;
 
-import com.github.luben.zstd.RecyclingBufferPool;
-import com.github.luben.zstd.ZstdInputStream;
 import com.seibel.distanthorizons.api.enums.config.EDhApiDataCompressionMode;
+import com.seibel.distanthorizons.core.Initializer;
+import com.seibel.distanthorizons.core.util.objects.DataCorruptedException;
+import com.seibel.distanthorizons.coreapi.ModInfo;
 import net.jpountz.lz4.LZ4FrameInputStream;
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
@@ -61,8 +62,6 @@ public class DhDataInputStream extends DataInputStream
 					return stream;
 				case LZ4:
 					return new LZ4FrameInputStream(stream);
-				case Z_STD:
-					return new ZstdInputStream(stream, RecyclingBufferPool.INSTANCE);
 				case LZMA2:
 					// using an array cache significantly reduces GC pressure
 					ResettableArrayCache arrayCache = LZMA_RESETTABLE_ARRAY_CACHE_GETTER.get();
@@ -113,10 +112,7 @@ public class DhDataInputStream extends DataInputStream
 		}
 	}
 	
-	// TODO at one point closing the streams caused errors, is that due to a bug with LZMA streams or some bug in DH's code that was since fixed?
-	//  if streams aren't closed that cause cause higher-than-expected native memory use if the GC decides
-	//  it doesn't want to clear the stream objects
-	//@Override
-	//public void close() throws IOException { /* Do nothing. */ }
+	@Override
+	public void close() throws IOException { /* Do nothing. */ }
 	
 }

core/src/main/java/com/seibel/distanthorizons/core/util/objects/dataStreams/DhDataOutputStream.java

@@ -19,7 +19,6 @@
 
 package com.seibel.distanthorizons.core.util.objects.dataStreams;
 
-import com.github.luben.zstd.ZstdOutputStream;
 import com.seibel.distanthorizons.api.enums.config.EDhApiDataCompressionMode;
 import net.jpountz.lz4.LZ4Factory;
 import net.jpountz.lz4.LZ4FrameOutputStream;
@@ -54,9 +53,6 @@ public class DhDataOutputStream extends DataOutputStream
 			{
 				case UNCOMPRESSED:
 					return stream;
-				
-				case Z_STD:
-					return new ZstdOutputStream(stream, 3, true, true);
 				case LZ4:
 					return new LZ4FrameOutputStream(stream, 
 							LZ4FrameOutputStream.BLOCKSIZE.SIZE_64KB, -1L,
@@ -73,7 +69,7 @@ public class DhDataOutputStream extends DataOutputStream
 					arrayCache.reset();
 					// Note: if the LZMA2Options are changed the array cache may need to be re-tested.
 					// the array cache was specifically tested and tuned for LZMA preset 3/4
-					return new XZOutputStream(stream, new LZMA2Options(3),
+					return new XZOutputStream(stream, new LZMA2Options(3), 
 							XZ.CHECK_CRC64, arrayCache);
 				
 				default:
@@ -88,11 +84,7 @@ public class DhDataOutputStream extends DataOutputStream
 			}
 	}
 	
-	
-	// TODO at one point closing the streams caused errors, is that due to a bug with LZMA streams or some bug in DH's code that was since fixed?
-	//  if streams aren't closed that cause cause higher-than-expected native memory use if the GC decides
-	//  it doesn't want to clear the stream objects
-	//@Override
-	//public void close() throws IOException { /* Do nothing. */ }
+	@Override
+	public void close() throws IOException { /* Do nothing. */ }
 	
 }

core/src/main/java/com/seibel/distanthorizons/core/util/objects/dataStreams/LzmaArrayCache.java

@@ -63,16 +63,8 @@ public class LzmaArrayCache extends ArrayCache
 		{
 			return new byte[size];
 		}
-		
-		// the array only sometimes needs to be cleared,
-		// clearing all the time results in unnecessary slowdowns
-		if (fillWithZeros)
-		{
-			// TODO it appears that this can prevent the CPU from working on
-			//  other tasks, thus causing render thread lag even when run on a separate thread 
-			Arrays.fill(array, (byte) 0);
-		}
-		
+		// the array needs to be cleared to prevent accidentally sending dirty data
+		Arrays.fill(array, (byte)0);
 		return array;
 	}
 	
@@ -115,16 +107,8 @@ public class LzmaArrayCache extends ArrayCache
 		{
 			return new int[size];
 		}
-		
-		// the array only sometimes needs to be cleared,
-		// clearing all the time results in unnecessary slowdowns
-		if (fillWithZeros)
-		{
-			// TODO it appears that this can prevent the CPU from working on
-			//  other tasks, thus causing render thread lag even when run on a separate thread
-			Arrays.fill(array, (byte) 0);
-		}
-		
+		// the array needs to be cleared to prevent accidentally sending dirty data
+		Arrays.fill(array, (byte)0);
 		return array;
 	}
 	

core/src/main/java/com/seibel/distanthorizons/core/util/objects/dataStreams/ZstdArrayCache.java

@@ -1,85 +0,0 @@
-package com.seibel.distanthorizons.core.util.objects.dataStreams;
-
-//import com.github.luben.zstd.BufferPool;
-import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
-import it.unimi.dsi.fastutil.ints.Int2ReferenceArrayMap;
-import org.apache.logging.log4j.Logger;
-
-import java.nio.ByteBuffer;
-import java.util.ArrayList;
-import java.util.Arrays;
-import java.util.concurrent.atomic.AtomicInteger;
-import java.util.function.IntUnaryOperator;
-
-/** 
- * LZMA requires a custom object to cache it's backend arrays. 
- */
-public class ZstdArrayCache //implements BufferPool
-{
-	private static final Logger LOGGER = DhLoggerBuilder.getLogger();
-	
-	/**
-	 * In James' testing the byte and int caches only ever had to store 2 and 4 arrays respectively.
-	 * With the in mind we could take a few shortcuts, but if that changes then we need to be 
-	 * notified as it might cause issues with the current logic.
-	 */
-	public static final int WARN_CACHE_LENGTH_EXCEEDED = 10;
-	
-	public static final AtomicInteger MAX_BYTE_CACHE_LENGTH_REF = new AtomicInteger(WARN_CACHE_LENGTH_EXCEEDED);
-	
-	public final IntUnaryOperator maxByteCacheSizeUnaryOperator = (x) -> Math.max(this.bufferCache.size(), x);
-	
-	
-	/** 
-	 * generally only 2 items long <br>
-	 * {@link Int2ReferenceArrayMap} can be used since the cache should only be a few items long.
-	 * If the array ends up being longer then this design will need to be changed.
-	 */
-	public final Int2ReferenceArrayMap<ArrayList<ByteBuffer>> bufferCache = new Int2ReferenceArrayMap<>();
-	
-	
-	
-	//=============//
-	// byte arrays //
-	//=============//
-	
-	//@Override
-	public ByteBuffer get(int size)
-	{
-		ArrayList<ByteBuffer> cacheList = this.bufferCache.computeIfAbsent(size, (newSize) -> new ArrayList<>(4));
-		if (cacheList.isEmpty())
-		{
-			return ByteBuffer.allocate(size);
-		}
-		
-		ByteBuffer array = cacheList.remove(cacheList.size()-1);
-		if (array == null)
-		{
-			return ByteBuffer.allocate(size);
-		}
-		
-		return array;
-	}
-	
-	//@Override
-	public void release(ByteBuffer buffer)
-	{
-		int size = buffer.array().length;
-		this.bufferCache.computeIfAbsent(size, (newSize) -> new ArrayList<>());
-		this.bufferCache.get(size).add(buffer);
-		
-		
-		if (this.bufferCache.size() > WARN_CACHE_LENGTH_EXCEEDED)
-		{
-			int previousMax = MAX_BYTE_CACHE_LENGTH_REF.getAndUpdate(this.maxByteCacheSizeUnaryOperator);
-			int newMax = MAX_BYTE_CACHE_LENGTH_REF.get();
-			if (newMax > previousMax)
-			{
-				LOGGER.warn("LZMA byte array cache expected size exceeded. Expected max length ["+WARN_CACHE_LENGTH_EXCEEDED+"], actual length ["+this.bufferCache.size()+"].");
-			}
-		}
-	}
-	
-	
-	
-}