Bump protocol version

Add isLocalChunkUseAllowed config value
2025-08-01 23:11:17 +05:00 · 2025-08-01 23:10:37 +05:00
454 changed files with 26312 additions and 24490 deletions
@@ -10,7 +10,7 @@ insert_final_newline = false
 max_line_length = 1000
 tab_width = 4
 trim_trailing_whitespace = false
-ij_continuation_indent_size = 4
+ij_continuation_indent_size = 8
 ij_formatter_off_tag = @formatter:off
 ij_formatter_on_tag = @formatter:on
 ij_formatter_tags_enabled = true
@@ -2,63 +2,48 @@ import com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar

 plugins {
    id "java"
-    id "com.gradleup.shadow"
+
+    id "com.github.johnrengelman.shadow" version '8.1.1' apply false
 }

-repositories {
-    mavenCentral()
+
+shadowJar {
+    // required for basic shadowJar setup
+    configurations = [project.configurations.shadow]
 }

-tasks.withType(JavaCompile).configureEach {
-    options.release = 8
-    options.encoding = "UTF-8"
-}
-
-configurations {
-    testImplementation.extendsFrom compileOnly
-}
-
-dependencies {
-    compileOnly "org.apache.logging.log4j:log4j-api:${rootProject.log4j_version}"
-    testImplementation "junit:junit:4.13"
-}
-
-java {
-    withSourcesJar()
-}
-
-task createReleaseApiJar(type: ShadowJar) {
-
-    mustRunAfter sourcesJar
-    dependsOn shadowJar
+task addSourcesToCompiledJar(type: ShadowJar) {
    
-    // the compiled "-all" jar is used since it's available at the time this task is run 
-    def compiledJarPath = "build/libs/DistantHorizonsApi-${rootProject.api_version}-all.jar"
-    def compiledJarFile = file(compiledJarPath)
+    def sourceJarPath = "build/libs/DistantHorizons-api-${rootProject.versionStr}-sources.jar"
+    def secondJarFile = file(sourceJarPath)
    
    // doFirst is so these only run when the task is actually executed
    doFirst {
-        System.out.println("Adding class files from: \n" +
-                "[" + compiledJarPath + "] to source API jar: \n" +
-                "[" + shadowJar.archiveFile.get().asFile + "]")
+        System.out.println("Adding source files from: \n" +
+                "[" + sourceJarPath + "] to compiled API jar: \n" +
+                "[" + shadowJar.archivePath + "]")
        
        // Validate the input JAR file
-        if (!compiledJarFile.exists()) {
-            throw new GradleException("Compiled JAR file not found: [${compiledJarFile}]")
+        if (!secondJarFile.exists()) {
+            throw new GradleException("Second JAR file not found: [${secondJarFile}]")
        }
    }
    
-    archiveFileName.set("DistantHorizonsApi-${rootProject.api_version}-combined.jar") // jar name
-    destinationDirectory = file('build/libs/') // jar location
+    // Set the name of the combined JAR file
+    archiveFileName.set("DistantHorizonsApi-${rootProject.api_version}.jar")
+    
+    // Set the destination directory for the combined JAR file
+    destinationDirectory = file('build/libs/merged/')
    
    // Set the input JAR files to be combined
    from sourceSets.main.allJava
    from {
-        project.configurations.shadow.collect { it.isDirectory() ? it : zipTree(it) }
+        configurations.shadow.collect { it.isDirectory() ? it : zipTree(it) }
    }
    
-    // add the class files
-    from zipTree(compiledJarFile)
+    // set the jars to merge
+    from shadowJar.archivePath
+    from secondJarFile
    
    // alternative method to Include the source files in the combined JAR
    // and/or see which files are being included
@@ -92,13 +77,6 @@ task createReleaseApiJar(type: ShadowJar) {
    }
    
 }
-// always create a combined jar for easy deployment
-assemble.dependsOn(createReleaseApiJar)
-
-shadowJar {
-    // required for basic shadowJar setup
-    configurations = [project.configurations.shadow]
-}

 javadoc {
    options {
@@ -109,17 +87,3 @@ javadoc {
        addStringOption('Xdoclint:all,-missing', '-quiet')
    }
 }
-
-// set the jar name
-def configureJar = { task ->
-    // outputs in the format:
-    // "DistantHorizonsApi-6.0.0.jar"
-    // "DistantHorizonsApi-6.0.0-sources.jar"
-    task.archiveBaseName = rootProject.api_name
-    task.archiveVersion = rootProject.api_version
-}
-configureJar(tasks.named("jar").get())
-configureJar(tasks.named("sourcesJar").get())
-configureJar(tasks.named("shadowJar").get())
-
-
@@ -39,6 +39,10 @@ package com.seibel.distanthorizons.api.enums;
 */
 public enum EDhApiDetailLevel
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
 	/**
 	 * detail level: 0 <Br>
 	 * width in Blocks: 1
@@ -28,6 +28,10 @@ package com.seibel.distanthorizons.api.enums.config;
 */
 public enum EDhApiBlocksToAvoid
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
 	NONE(false),
 	NON_COLLIDING(true);
 	
@@ -22,9 +22,7 @@ package com.seibel.distanthorizons.api.enums.config;
 /**
 * UNCOMPRESSED <br>
 * LZ4 <br>
- * Z_STD <br>
- * Z_STD_STREAM <br>
- * LZMA2 <br><br>
+ * XZ <br><br>
 * 
 * Note: speed and compression ratios are examples
 * and should only be used for estimated comparisons.
@@ -34,6 +32,10 @@ package com.seibel.distanthorizons.api.enums.config;
 */
 public enum EDhApiDataCompressionMode
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
 	/** 
 	 * Should only be used internally and for unit testing. <br><br> 
 	 * 
@@ -53,33 +55,20 @@ public enum EDhApiDataCompressionMode
 	 */
 	LZ4(1),
 	
-	/**
-	 * Great speed and good compression. <br><br> 
-	 *
-	 * Read Speed: 2.1 MS / DTO <br>
-	 * Write Speed: 4.9 MS / DTO <br>
-	 * Compression ratio: 0.2606 <br>
-	 */
-	Z_STD_BLOCK(4),
+	///**
+	// * 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>
+	// */
+	////@DisallowSelectingViaConfigGui
+	//Z_STD(2),
 	
-	/**
-	 * Similar to {@link EDhApiDataCompressionMode#Z_STD_BLOCK}
-	 * except slower. <br><br>
-	 * 
-	 * This option is only provided for legacy support when processing old databases. <br><br>
-	 * 
-	 * Read Speed: 9.31 MS / DTO <br>
-	 * Write Speed: 15.13 MS / DTO <br>
-	 * Compression ratio: 0.2606 <br>
-	 */
-	@Deprecated
-	@DisallowSelectingViaConfigGui
-	Z_STD_STREAM(2),
 	
 	/** 
-	 * Extremely slow, but very good compression. <br>
-	 * Often causes whole computer stuttering due to memory bandwidth saturation. <br><br>
-	 * 
+	 * 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>
@@ -35,12 +35,25 @@ public enum EDhApiGpuUploadMethod
 	/** Picks the best option based on the GPU the user has. */
 	AUTO(false, false),
 	
+	// commented out since it isn't currently in use
+	//BUFFER_STORAGE_MAPPING(true, true),
+	
 	/** Fast rendering, no stuttering. */
 	BUFFER_STORAGE(false, true),
 	
 	/** Fast rendering but may stutter when uploading. */
 	SUB_DATA(false, false),
 	
+	/**
+	 * May end up storing buffers in System memory. <br>
+	 * Fast rending if in GPU memory, slow if in system memory, <br>
+	 * but won't stutter when uploading.
+	 * 
+	 * @deprecated not currently supported
+	 */
+	@Deprecated
+	BUFFER_MAPPING(true, false),
+	
 	/** Fast rendering but may stutter when uploading. */
 	DATA(false, false);
 	
@@ -29,6 +29,10 @@ package com.seibel.distanthorizons.api.enums.config;
 */
 public enum EDhApiGrassSideRendering
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
 	AS_GRASS,
 	FADE_TO_DIRT,
 	AS_DIRT;
@@ -31,6 +31,11 @@ package com.seibel.distanthorizons.api.enums.config;
 */
 public enum EDhApiHorizontalQuality
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
+	
 	// Note: any quadraticBase less than 2.0f has issues with DetailDistanceUtil, and will always return the lowest detail level.
 	//  So for now we are limiting the lowest value to 2.0
 	//  LOWEST was originally 1.0f and LOW was 1.5f
@@ -29,6 +29,10 @@ package com.seibel.distanthorizons.api.enums.config;
 */
 public enum EDhApiLodShading
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
 	/** 
 	 * Uses Minecraft's shading for LODs. <Br>
 	 * This means if Minecraft's shading is disabled DH's shading will be as well.
@@ -0,0 +1,55 @@
+/*
+ *    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.enums.config;
+
+import org.apache.logging.log4j.Level;
+
+/**
+ * @since API 2.0.0
+ * @version 2024-4-6
+ */
+public enum EDhApiLoggerMode
+{
+	DISABLED(Level.OFF, Level.OFF),
+	LOG_ALL_TO_FILE(Level.ALL, Level.OFF),
+	LOG_ERROR_TO_CHAT(Level.ALL, Level.ERROR),
+	LOG_WARNING_TO_CHAT(Level.ALL, Level.WARN),
+	LOG_INFO_TO_CHAT(Level.ALL, Level.INFO),
+	LOG_DEBUG_TO_CHAT(Level.ALL, Level.DEBUG),
+	LOG_ALL_TO_CHAT(Level.ALL, Level.ALL),
+	LOG_ERROR_TO_CHAT_AND_FILE(Level.ERROR, Level.ERROR),
+	LOG_WARNING_TO_CHAT_AND_FILE(Level.WARN, Level.WARN),
+	LOG_INFO_TO_CHAT_AND_FILE(Level.INFO, Level.INFO),
+	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;
+	public final Level levelForChat;
+	
+	EDhApiLoggerMode(Level levelForFile, Level levelForChat)
+	{
+		this.levelForFile = levelForFile;
+		this.levelForChat = levelForChat;
+	}
+	
+}
@@ -64,7 +64,10 @@ public enum EDhApiMaxHorizontalResolution
 	/** How wide each LOD DataPoint is */
 	public final int dataPointWidth;
 	
-	/** This is the same as detailLevel in LodQuadTreeNode */
+	/**
+	 * This is the same as detailLevel in LodQuadTreeNode,
+	 * lowest is 0 highest is 9
+	 */
 	public final byte detailLevel;
 	
 	/* Start/End X/Z give the block positions
@@ -33,6 +33,10 @@ package com.seibel.distanthorizons.api.enums.config;
 */
 public enum EDhApiMcRenderingFadeMode
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
 	/**
 	 * No fading is done, there will be a pronounced border between
 	 * Minecraft and Distant Horizons. <br>
@@ -1,19 +0,0 @@
-package com.seibel.distanthorizons.api.enums.config;
-
-import com.seibel.distanthorizons.coreapi.ModInfo;
-
-/**
- * AUTO, <br>
- * OPEN_GL, <br>
- * BLAZE_3D, <br><br>
- *
- * @since API 6.0.0
- * @version 2026-3-10
- */
-public enum EDhApiRenderApi
-{
-	AUTO,
-	OPEN_GL,
-	BLAZE_3D;
-	
-}
@@ -35,6 +35,11 @@ package com.seibel.distanthorizons.api.enums.config;
 */
 public enum EDhApiServerFolderNameMode
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
+	
 	/** Only use the server name */
 	NAME_ONLY,
 	
@@ -34,6 +34,11 @@ package com.seibel.distanthorizons.api.enums.config;
@Deprecated // not currently in use, if the config this enum represents is re-implemented, the deprecated flag can be removed
 public enum EDhApiVanillaOverdraw
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
+	
 	/**
 	 * Don't draw LODs where a minecraft chunk could be.
 	 * Use Overdraw Offset to tweak the border thickness.
@@ -53,7 +53,7 @@ public enum EDhApiVerticalQuality
 	
 	
 	
-	public int calculateMaxNumberOfVerticalSlicesAtDetailLevel(byte dataDetail)
+	public int calculateMaxVerticalData(byte dataDetail)
 	{
 		// for detail levels lower than what the enum defines, use the lowest quality item
 		int index = MathUtil.clamp(0, dataDetail, this.maxVerticalData.length - 1);
@@ -28,6 +28,10 @@ package com.seibel.distanthorizons.api.enums.config;
 */
 public enum EDhApiWorldCompressionMode
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
 	/** 
 	 * Every block/biome change is recorded in the database. <br>
 	 * This is what DH 2.0 and 2.0.1 all used by default and will store a lot of data. 
@@ -35,6 +35,10 @@ import com.seibel.distanthorizons.api.enums.config.DisallowSelectingViaConfigGui
 */
 public enum EDhApiQualityPreset
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
 	@DisallowSelectingViaConfigGui
 	CUSTOM,
 	
@@ -34,6 +34,10 @@ import com.seibel.distanthorizons.api.enums.config.DisallowSelectingViaConfigGui
 */
 public enum EDhApiThreadPreset
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
 	@DisallowSelectingViaConfigGui
 	CUSTOM,
 	
@@ -33,6 +33,11 @@ package com.seibel.distanthorizons.api.enums.rendering;
 */
 public enum EDhApiDebugRendering
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
+	
 	/** LODs are rendered normally */
 	OFF,
 	
@@ -43,7 +48,11 @@ public enum EDhApiDebugRendering
 	SHOW_BLOCK_MATERIAL,
 	
 	/** Only draw overlapping LOD quads. */
-	SHOW_OVERLAPPING_QUADS;
+	SHOW_OVERLAPPING_QUADS,
+	
+	/** LOD colors are based on renderSource flags. */
+	SHOW_RENDER_SOURCE_FLAG;
+	
 	
 	public static EDhApiDebugRendering next(EDhApiDebugRendering type)
 	{
@@ -56,7 +65,7 @@ public enum EDhApiDebugRendering
 			case SHOW_BLOCK_MATERIAL:
 				return SHOW_OVERLAPPING_QUADS;
 			case SHOW_OVERLAPPING_QUADS:
-				return OFF;
+				return SHOW_RENDER_SOURCE_FLAG;
 			default:
 				return OFF;
 		}
@@ -67,6 +76,8 @@ public enum EDhApiDebugRendering
 		switch (type)
 		{
 			case OFF:
+				return SHOW_RENDER_SOURCE_FLAG;
+			case SHOW_RENDER_SOURCE_FLAG:
 				return SHOW_OVERLAPPING_QUADS;
 			case SHOW_OVERLAPPING_QUADS:
 				return SHOW_DETAIL;
@@ -33,6 +33,10 @@ package com.seibel.distanthorizons.api.enums.rendering;
@Deprecated
 public enum EDhApiFogDrawMode
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
 	/**
 	 * Use whatever Fog setting Optifine is using.
 	 * If Optifine isn't installed this defaults to {@link EDhApiFogDrawMode#FOG_ENABLED}.
@@ -30,6 +30,11 @@ package com.seibel.distanthorizons.api.enums.rendering;
 */
 public enum EDhApiFogFalloff
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
+	
 	LINEAR(0),
 	EXPONENTIAL(1),
 	EXPONENTIAL_SQUARED(2);
@@ -33,6 +33,11 @@ package com.seibel.distanthorizons.api.enums.rendering;
 */
 public enum EDhApiHeightFogDirection
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
+	
 	ABOVE_CAMERA                (true,  true,  false),
 	BELOW_CAMERA                (true,  false, true),
 	ABOVE_AND_BELOW_CAMERA      (true,  true,  true),
@@ -20,17 +20,22 @@
 package com.seibel.distanthorizons.api.enums.rendering;

 /**
- * DEFAULT <br>
- * DEBUG_TRIANGLE <br>
- * DISABLED <br>
+ * Default <br>
+ * Debug <br>
+ * Disabled <br>
 *
 * @since API 2.0.0
- * @version 2026-03-23
+ * @version 2024-4-6
 */
 public enum EDhApiRendererMode
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
+	
 	DEFAULT,
-	DEBUG_TRIANGLE,
+	DEBUG,
 	DISABLED;
 	
 	
@@ -40,8 +45,8 @@ public enum EDhApiRendererMode
 		switch (type)
 		{
 			case DEFAULT:
-				return DEBUG_TRIANGLE;
-			case DEBUG_TRIANGLE:
+				return DEBUG;
+			case DEBUG:
 				return DISABLED;
 			default:
 				return DEFAULT;
@@ -55,10 +60,10 @@ public enum EDhApiRendererMode
 		{
 			case DEFAULT:
 				return DISABLED;
-			case DEBUG_TRIANGLE:
+			case DEBUG:
 				return DEFAULT;
 			default:
-				return DEBUG_TRIANGLE;
+				return DEBUG;
 		}
 	}
 	
@@ -29,6 +29,11 @@ package com.seibel.distanthorizons.api.enums.rendering;
 */
 public enum EDhApiTransparency
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
+	
 	DISABLED(false, false),
 	FAKE(true, true),
 	COMPLETE(true, false);
@@ -34,6 +34,11 @@ package com.seibel.distanthorizons.api.enums.worldGeneration;
 */
 public enum EDhApiDistantGeneratorMode
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
+	
 	/** Don't generate any new terrain, just generate LODs for already generated chunks. */
 	PRE_EXISTING_ONLY((byte) 1),
 	
@@ -31,6 +31,11 @@ package com.seibel.distanthorizons.api.enums.worldGeneration;
 */
 public enum EDhApiDistantGeneratorProgressDisplayLocation
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
+	
 	OVERLAY,
 	CHAT,
 	LOG,
@@ -19,8 +19,6 @@

 package com.seibel.distanthorizons.api.interfaces;

-import com.seibel.distanthorizons.api.interfaces.block.IDhApiBlockStateWrapper;
-
 /**
 * Implemented by wrappers so developers can
 * access the underlying Minecraft object(s).
@@ -40,11 +38,7 @@ public interface IDhApiUnsafeWrapper
 	 * In order to cast this object to something usable, you may want
 	 * to use <code>obj.getClass()</code> when in your IDE
 	 * in order to determine what object this method returns for
-	 * the specific version of Minecraft you are developing for. <br><br>
-	 * 
-	 * Note:<br>
-	 * This method may return null in some cases, IE {@link IDhApiBlockStateWrapper}
-	 * when it is wrapping air.
+	 * the specific version of Minecraft you are developing for.
 	 */
 	Object getWrappedMcObject();
 	
@@ -23,10 +23,7 @@ import com.seibel.distanthorizons.api.enums.rendering.EDhApiBlockMaterial;
 import com.seibel.distanthorizons.api.interfaces.IDhApiUnsafeWrapper;

 /**
- * A Minecraft version independent way of handling Blocks. <br><br>
- * 
- * Note: the wrapped object (IE the object returned by {@link IDhApiUnsafeWrapper#getWrappedMcObject}) 
- * will be null if this object is wrapping air.
+ * A Minecraft version independent way of handling Blocks.
 *
 * @author James Seibel
 * @version 2023-6-11
@@ -23,10 +23,10 @@ import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigGroup;
 import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigValue;

 /**
- * Distant Horizons' SSAO configuration. <br><br>
+ * Distant Horizons' fog configuration. <br><br>
 *
 * @author James Seibel
- * @version 2026-02-05
+ * @version 2022-9-6
 * @since API 1.0.0
 */
 public interface IDhApiAmbientOcclusionConfig extends IDhApiConfigGroup
@@ -34,4 +34,32 @@ public interface IDhApiAmbientOcclusionConfig extends IDhApiConfigGroup
 	/** Determines if Ambient Occlusion is rendered */
 	IDhApiConfigValue<Boolean> enabled();
 	
+	/** 
+	 * Determines how many points in space are sampled for the occlusion test. 
+	 * Higher numbers will improve quality and reduce banding, but will increase GPU load. 
+	 */
+	IDhApiConfigValue<Integer> sampleCount();
+	
+	/** Determines the radius Screen Space Ambient Occlusion is applied, measured in blocks. */
+	IDhApiConfigValue<Double> radius();
+	
+	/** Determines how dark the Screen Space Ambient Occlusion effect will be. */
+	IDhApiConfigValue<Double> strength();
+	
+	/** Increasing the value can reduce banding at the cost of reducing the strength of the effect. */
+	IDhApiConfigValue<Double> bias();
+	
+	/** 
+	 * Determines how dark the occlusion shadows can be. <br> 
+	 * 0 = totally black at the corners <br>
+	 * 1 = no shadow
+	 */
+	IDhApiConfigValue<Double> minLight();
+	
+	/**
+	 * The radius, measured in pixels, that blurring is calculated. <br>
+	 * Higher numbers will reduce banding at the cost of GPU performance.
+	 */
+	IDhApiConfigValue<Integer> blurRadius();
+	
 }
@@ -44,7 +44,7 @@ public interface IDhApiFarFogConfig extends IDhApiConfigGroup
 	 * 0.0 = fog starts at the camera <br>
 	 * 1.0 = fog starts at the edge of the fake chunk render distance <br>
 	 */
-	IDhApiConfigValue<Float> farFogStartDistance();
+	IDhApiConfigValue<Double> farFogStartDistance();
 	
 	/**
 	 * Defines where the fog ends as a percent of the radius
@@ -54,18 +54,18 @@ public interface IDhApiFarFogConfig extends IDhApiConfigGroup
 	 * 0.0 = fog ends at the camera <br>
 	 * 1.0 = fog ends at the edge of the fake chunk render distance <br>
 	 */
-	IDhApiConfigValue<Float> farFogEndDistance();
+	IDhApiConfigValue<Double> farFogEndDistance();
 	
 	/** Defines how opaque the fog is at its thinnest point. */
-	IDhApiConfigValue<Float> farFogMinThickness();
+	IDhApiConfigValue<Double> farFogMinThickness();
 	
 	/** Defines how opaque the fog is at its thickest point. */
-	IDhApiConfigValue<Float> farFogMaxThickness();
+	IDhApiConfigValue<Double> farFogMaxThickness();
 	
 	/** Defines how the fog changes in thickness. */
 	IDhApiConfigValue<EDhApiFogFalloff> farFogFalloff();
 	
 	/** Defines the fog density. */
-	IDhApiConfigValue<Float> farFogDensity();
+	IDhApiConfigValue<Double> farFogDensity();
 	
 }
@@ -104,7 +104,7 @@ public interface IDhApiGraphicsConfig extends IDhApiConfigGroup
 	 * 2 = blending of 5x5			<br>
 	 * ...							<br>
 	 */
-	IDhApiConfigValue<Integer> getBiomeBlending();
+//	IDhApiConfigValue<Integer> getBiomeBlending();
 	
 	
 	
@@ -124,19 +124,19 @@ public interface IDhApiGraphicsConfig extends IDhApiConfigGroup
 	 * 
 	 * @since API 2.0.0
 	 */
-	IDhApiConfigValue<Float> overdrawPreventionRadius();
+	IDhApiConfigValue<Double> overdrawPreventionRadius();
 	
 	/**
 	 * Modifies how bright fake chunks are. <br>
 	 * This is done when generating the vertex data and is applied before any shaders.
 	 */
-	IDhApiConfigValue<Float> brightnessMultiplier();
+	IDhApiConfigValue<Double> brightnessMultiplier();
 	
 	/**
 	 * Modifies how saturated fake chunks are. <br>
 	 * This is done when generating the vertex data and is applied before any shaders.
 	 */
-	IDhApiConfigValue<Float> saturationMultiplier();
+	IDhApiConfigValue<Double> saturationMultiplier();
 	
 	/** Defines if Distant Horizons should attempt to cull fake chunk cave geometry. */
 	IDhApiConfigValue<Boolean> caveCullingEnabled();
@@ -150,6 +150,12 @@ public interface IDhApiGraphicsConfig extends IDhApiConfigGroup
 	/** If enabled vanilla chunk rendering is disabled and only fake chunks are rendered. */
 	IDhApiConfigValue<Boolean> lodOnlyMode();
 	
+	/**
+	 * Setting this to a non-zero number will modify vanilla Minecraft's LOD Bias,
+	 * increasing how quickly its textures fade away.
+	 */
+	IDhApiConfigValue<Double> lodBias();
+	
 	/**
 	 * Determines how LODs should be shaded.
 	 *
@@ -52,24 +52,24 @@ public interface IDhApiHeightFogConfig extends IDhApiConfigGroup
 	 * Defines the height fog's base height if {@link IDhApiHeightFogConfig#heightFogDirection()}
 	 * is set to use a specific height.
 	 */
-	IDhApiConfigValue<Float> heightFogBaseHeight();
+	IDhApiConfigValue<Double> heightFogBaseHeight();
 	
 	/** Defines the height fog's starting height as a percent of the world height. */
-	IDhApiConfigValue<Float> heightFogStartingHeightPercent();
+	IDhApiConfigValue<Double> heightFogStartingHeightPercent();
 	
 	/** Defines the height fog's ending height as a percent of the world height. */
-	IDhApiConfigValue<Float> heightFogEndingHeightPercent();
+	IDhApiConfigValue<Double> heightFogEndingHeightPercent();
 	
 	/** Defines how opaque the height fog is at its thinnest point. */
-	IDhApiConfigValue<Float> heightFogMinThickness();
+	IDhApiConfigValue<Double> heightFogMinThickness();
 	
 	/** Defines how opaque the height fog is at its thickest point. */
-	IDhApiConfigValue<Float> heightFogMaxThickness();
+	IDhApiConfigValue<Double> heightFogMaxThickness();
 	
 	/** Defines how the height fog changes in thickness. */
 	IDhApiConfigValue<EDhApiFogFalloff> heightFogFalloff();
 	
 	/** Defines the height fog's density. */
-	IDhApiConfigValue<Float> heightFogDensity();
+	IDhApiConfigValue<Double> heightFogDensity();
 	
 }
@@ -37,8 +37,8 @@ public interface IDhApiNoiseTextureConfig extends IDhApiConfigGroup
 	/** Defines how many steps of noise should be applied. */
 	IDhApiConfigValue<Integer> noiseSteps();
 	
-	/** Defines how intense the noise will be, between 0.0 and 1.0. */
-	IDhApiConfigValue<Float> noiseIntensity();
+	/** Defines how intense the noise will be. */
+	IDhApiConfigValue<Double> noiseIntensity();
 	
 	/**
 	 * Defines how far should the noise texture render before it fades away. (in blocks) <br>
@@ -1,18 +1,15 @@
 package com.seibel.distanthorizons.api.interfaces.data;

 /**
- * Can be used to drastically speed up repeat read operations in {@link IDhApiTerrainDataRepo}. <br><br>
- * 
- * Once you are done with this cache, closing it will free up any objects
- * the cache is holding. This can reduce Garbage Collector overhead and reduce stuttering.
- * 
+ * Can be used to drastically speed up repeat read operations in {@link IDhApiTerrainDataRepo}.
+ *
 * @see IDhApiTerrainDataRepo
 * 
 * @author James Seibel
- * @version 2026-1-29
+ * @version 2024-7-14
 * @since API 3.0.0
 */
-public interface IDhApiTerrainDataCache extends AutoCloseable
+public interface IDhApiTerrainDataCache // TODO should this be AutoClosable?
 {
 	/**
 	 * Removes any data that's currently stored in this cache.
@@ -24,10 +21,4 @@ public interface IDhApiTerrainDataCache extends AutoCloseable
 	 */
 	void clear();
 	
-	// override without an exception
-	@Override
-	void close();
-	
-	
-	
 }
@@ -32,7 +32,7 @@ import com.seibel.distanthorizons.api.objects.data.DhApiTerrainDataPoint;
 * @see IDhApiTerrainDataCache
 * 
 * @author James Seibel
- * @version 2026-02-03
+ * @version 2023-6-22
 * @since API 1.0.0
 */
 public interface IDhApiTerrainDataRepo
@@ -42,17 +42,24 @@ public interface IDhApiTerrainDataRepo
 	// getters //
 	//=========//
 	
+	/** @see IDhApiTerrainDataRepo#getSingleDataPointAtBlockPos(IDhApiLevelWrapper, int, int, int, IDhApiTerrainDataCache) */
+	default DhApiResult<DhApiTerrainDataPoint> getSingleDataPointAtBlockPos(IDhApiLevelWrapper levelWrapper, int blockPosX, int blockPosY, int blockPosZ) { return this.getSingleDataPointAtBlockPos(levelWrapper, blockPosX, blockPosY, blockPosZ, null); }
 	/** 
 	 * Returns the terrain datapoint at the given block position, at/or containing the given Y position. 
 	 * @since API 3.0.0
 	 */
 	DhApiResult<DhApiTerrainDataPoint> getSingleDataPointAtBlockPos(IDhApiLevelWrapper levelWrapper, int blockPosX, int blockPosY, int blockPosZ, IDhApiTerrainDataCache dataCache);
+	
+	/** @see IDhApiTerrainDataRepo#getColumnDataAtBlockPos(IDhApiLevelWrapper, int, int, IDhApiTerrainDataCache) */
+	default DhApiResult<DhApiTerrainDataPoint[]> getColumnDataAtBlockPos(IDhApiLevelWrapper levelWrapper, int blockPosX, int blockPosZ) { return this.getColumnDataAtBlockPos(levelWrapper, blockPosX, blockPosZ, null); }
 	/** 
 	 * Returns every datapoint in the column located at the given block X and Z position top to bottom. 
 	 * @since API 3.0.0 
 	 */
 	DhApiResult<DhApiTerrainDataPoint[]> getColumnDataAtBlockPos(IDhApiLevelWrapper levelWrapper, int blockPosX, int blockPosZ, IDhApiTerrainDataCache dataCache);
 	
+	/** @see IDhApiTerrainDataRepo#getAllTerrainDataAtChunkPos(IDhApiLevelWrapper, int, int, IDhApiTerrainDataCache) */
+	default DhApiResult<DhApiTerrainDataPoint[][][]> getAllTerrainDataAtChunkPos(IDhApiLevelWrapper levelWrapper, int chunkPosX, int chunkPosZ) { return this.getAllTerrainDataAtChunkPos(levelWrapper, chunkPosX, chunkPosZ, null); }
 	/**
 	 * Returns every datapoint in the given chunk's X and Z position. <br><br>
 	 *
@@ -64,6 +71,8 @@ public interface IDhApiTerrainDataRepo
 	 */
 	DhApiResult<DhApiTerrainDataPoint[][][]> getAllTerrainDataAtChunkPos(IDhApiLevelWrapper levelWrapper, int chunkPosX, int chunkPosZ, IDhApiTerrainDataCache dataCache);
 	
+	/** @see IDhApiTerrainDataRepo#getAllTerrainDataAtRegionPos(IDhApiLevelWrapper, int, int, IDhApiTerrainDataCache) */
+	default DhApiResult<DhApiTerrainDataPoint[][][]> getAllTerrainDataAtRegionPos(IDhApiLevelWrapper levelWrapper, int regionPosX, int regionPosZ) { return this.getAllTerrainDataAtRegionPos(levelWrapper, regionPosX, regionPosZ, null); }
 	/**
 	 * Returns every datapoint in the given region's X and Z position. <br><br>
 	 *
@@ -75,6 +84,8 @@ public interface IDhApiTerrainDataRepo
 	 */
 	DhApiResult<DhApiTerrainDataPoint[][][]> getAllTerrainDataAtRegionPos(IDhApiLevelWrapper levelWrapper, int regionPosX, int regionPosZ, IDhApiTerrainDataCache dataCache);
 	
+	/** @see IDhApiTerrainDataRepo#getAllTerrainDataAtDetailLevelAndPos(IDhApiLevelWrapper, byte, int, int, IDhApiTerrainDataCache) */
+	default DhApiResult<DhApiTerrainDataPoint[][][]> getAllTerrainDataAtRegionPos(IDhApiLevelWrapper levelWrapper, byte detailLevel, int posX, int posZ) { return this.getAllTerrainDataAtDetailLevelAndPos(levelWrapper, detailLevel, posX, posZ, null); }
 	/**
 	 * Returns every datapoint in the column located at the given detail level and X/Z position. <br>
 	 * This can be used to return terrain data for non-standard sizes (IE 2x2 blocks or 2x2 chunks).
@@ -90,6 +101,21 @@ public interface IDhApiTerrainDataRepo
 	
 	
 	
+	/** @see IDhApiTerrainDataRepo#raycast(IDhApiLevelWrapper, double, double, double, float, float, float, int, IDhApiTerrainDataCache) */
+	default DhApiResult<DhApiRaycastResult> raycast(
+			IDhApiLevelWrapper levelWrapper,
+			double rayOriginX, double rayOriginY, double rayOriginZ,
+			float rayDirectionX, float rayDirectionY, float rayDirectionZ,
+			int maxRayBlockLength)
+	{
+		return this.raycast(
+				levelWrapper,
+				rayOriginX, rayOriginY, rayOriginZ,
+				rayDirectionX, rayDirectionY, rayDirectionZ,
+				maxRayBlockLength,
+				null);
+	}
+	
 	/**
 	 * Returns the datapoint and position of the LOD
 	 * at the end of the given ray. <br><br>
@@ -135,16 +161,9 @@ public interface IDhApiTerrainDataRepo
 	//=========//
 	
 	/** 
-	 * Creates a new cache you manage that can be used to speed up repeat
-	 * read operations. <br>
-	 * Without a cache each operation must: hit the backing database file,
-	 * decompress it, and parse it; which is a fairly slow process. <br>
-	 * 
 	 * @return a {@link IDhApiTerrainDataCache} backed by {@link java.lang.ref.SoftReference}'s.
-	 * @since API 5.0.0
+	 * @since API 3.0.0
 	 */
-	IDhApiTerrainDataCache createSoftCache();
-	
-	
+	IDhApiTerrainDataCache getSoftCache();
 	
 }
@@ -40,7 +40,7 @@ public interface IDhApiEventInjector extends IDependencyInjector<IDhApiEvent>
 	 * @return true if the handler was unbound, false if the handler wasn't bound.
 	 * @throws IllegalArgumentException if the implementation object doesn't implement the interface
 	 */
-	// Note to DH Devs: Don't try adding a generic type to IDhApiEvent, the constructor won't accept it
+	// Note to self: Don't try adding a generic type to IDhApiEvent, the constructor won't accept it
 	boolean unbind(Class<? extends IDhApiEvent> dependencyInterface, Class<? extends IDhApiEvent> dependencyClassToRemove) throws IllegalArgumentException;
 	
 	
@@ -169,7 +169,7 @@ public interface IDhApiWorldGenerator extends Closeable, IDhApiOverrideable
 	 *
 	 * After the {@link IDhApiWorldGenerator} has been generated, it should be passed into the
 	 * resultConsumer's {@link Consumer#accept(Object)} method.
-	 * Note: if air blocks aren't included in the {@link IDhApiFullDataSource} with proper lighting, lower detail levels will appear as black/unlit.
+	 * Note: if air blocks aren't included in the with the {@link DhApiChunk} with proper lighting, lower detail levels will appear as black/unlit.
 	 *
 	 * @implNote the default implementation of this method throws an {@link UnsupportedOperationException},
 	 * and must be overridden when {@link #getReturnType()} returns {@link EDhApiWorldGeneratorReturnType#API_CHUNKS}.
@@ -3,7 +3,6 @@ package com.seibel.distanthorizons.api.interfaces.render;
 import com.seibel.distanthorizons.api.objects.math.DhApiVec3d;
 import com.seibel.distanthorizons.api.objects.math.DhApiVec3f;
 import com.seibel.distanthorizons.api.objects.render.DhApiRenderableBox;
-import com.seibel.distanthorizons.coreapi.interfaces.dependencyInjection.IBindable;

 import java.util.List;

@@ -19,7 +18,7 @@ import java.util.List;
 * @version 2024-7-3
 * @since API 3.0.0
 */
-public interface IDhApiCustomRenderObjectFactory extends IBindable
+public interface IDhApiCustomRenderObjectFactory
 {
 	/**
 	 * Creates a {@link IDhApiRenderableBoxGroup} from for the given {@link DhApiRenderableBox}
@@ -51,16 +51,14 @@ public interface IDhApiRenderProxy
 	//=======================//
 	
 	/**
-	 * Returns the OpenGL name of Distant Horizons' depth texture. <br>
-	 * Will return {@link DhApiResult#success} = false and {@link DhApiResult#payload} = -1 if the texture hasn't been created yet
-	 * or a rendering API other than OpenGL is in use.
+	 * Returns the name of Distant Horizons' depth texture. <br>
+	 * Will return {@link DhApiResult#success} = false and {@link DhApiResult#payload} = -1 if the texture hasn't been created yet.
 	 */
 	DhApiResult<Integer> getDhDepthTextureId();
 	
 	/**
-	 * Returns the OpenGL name of Distant Horizons' color texture. <br>
-	 * Will return {@link DhApiResult#success} = false and {@link DhApiResult#payload} = -1 if the texture hasn't been created yet
-	 * or a rendering API other than OpenGL is in use
+	 * Returns the name of Distant Horizons' color texture. <br>
+	 * Will return {@link DhApiResult#success} = false and {@link DhApiResult#payload} = -1 if the texture hasn't been created yet.
 	 */
 	DhApiResult<Integer> getDhColorTextureId();
 	
@@ -73,7 +73,7 @@ public interface IDhApiRenderableBoxGroup extends List<DhApiRenderableBox>
 	 * This is a good place to change the origin or notify of any box changes. 
 	 */
 	void setPreRenderFunc(Consumer<DhApiRenderParam> renderEventParam);
-	void setPostRenderFunc(Consumer<DhApiRenderParam> renderEventParam);
+	void setPostRenderFunc(Consumer<DhApiRenderParam> renderEventParam); // TODO name?
 	
 	/**
 	 * If a cube's color, position, or other property is changed this method
@@ -27,7 +27,7 @@ import com.seibel.distanthorizons.api.objects.math.DhApiVec3f;

 /**
 * Called before Distant Horizons starts rendering a buffer. <br>
- * This event cannot be canceled, use {@link DhApiBeforeRenderEvent} if you want to cancel rendering.
+ * This event cannot be cancelled, use {@link DhApiBeforeRenderEvent} if you want to cancel rendering.
 * 
 * @author James Seibel
 * @version 2023-1-31
@@ -31,10 +31,7 @@ import com.seibel.distanthorizons.api.methods.events.sharedParameterObjects.DhAp
 * @author James Seibel
 * @version 2025-6-9
 * @since API 4.1.0
- * @deprecated Only used for the legacy OpenGL renderer <Br>
- *             Using {@link DhApiAfterColorDepthTextureCreatedEvent} instead is recommended.
 */
-@Deprecated
 public abstract class DhApiBeforeColorDepthTextureCreatedEvent implements IDhApiEvent<DhApiTextureCreatedParam>
 {
 	/** Fired before Distant Horizons creates. */
@@ -1,148 +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.enums.rendering.EDhApiBlockMaterial;
-import com.seibel.distanthorizons.api.interfaces.block.IDhApiBlockStateWrapper;
-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;
-import com.seibel.distanthorizons.coreapi.util.ColorUtil;
-
-import java.awt.*;
-import java.util.concurrent.atomic.AtomicInteger;
-
-/**
- * Performance note: this event will be fired thousands of times on concurrent threads, 
- * make it thread safe and as fast as possible. <Br><Br>
- * 
- * This event is fired when DH needs to convert a {@link IDhApiBlockStateWrapper}
- * into a color for rendering. This event is fired after DH attempts to determine
- * the color itself (using the base color, tinting, etc.). <Br>
- * Using this event will override the tinting config for this block
- * unless you re-implement that logic yourself.
- * <Br><Br>
- * 
- * This event will only trigger for {@link IDhApiBlockStateWrapper}s that have been registered
- * via {@link DhApiBlockStateWrapperCreatedEvent.EventParam#setAllowApiColorOverride(boolean)}.
- * 
- * @author James Seibel
- * @version 2026-04-14
- * @since API 6.0.0
- * @see IDhApiBlockStateWrapper
- */
-public abstract class DhApiBlockColorOverrideEvent implements IDhApiEvent<DhApiBlockColorOverrideEvent.EventParam>
-{
-	public abstract void blockStateWrapperCreated(DhApiEventParam<EventParam> event);
-	
-	
-	//=========================//
-	// internal DH API methods //
-	//=========================//
-	
-	@Override
-	public final void fireEvent(DhApiEventParam<EventParam> event) { this.blockStateWrapperCreated(event); }
-	
-	
-	//==================//
-	// parameter object //
-	//==================//
-	
-	public static class EventParam implements IDhApiEventParam
-	{
-		private IDhApiLevelWrapper levelWrapper;
-		private IDhApiBlockStateWrapper blockStateWrapper = null;
-		private int colorAsInt = -1;
-		private int blockPosX = 0, blockPosY = 0, blockPosZ = 0;
-		
-		
-		
-		//=============//
-		// constructor //
-		//=============//
-		
-		public EventParam() {}
-		
-		public void update(
-			IDhApiLevelWrapper levelWrapper,
-			IDhApiBlockStateWrapper blockStateWrapper, 
-			int colorAsInt,
-			int blockPosX, int blockPosY, int blockPosZ)
-		{
-			this.levelWrapper = levelWrapper;
-			this.blockStateWrapper = blockStateWrapper;
-			this.colorAsInt = colorAsInt;
-			
-			this.blockPosX = blockPosX;
-			this.blockPosY = blockPosY;
-			this.blockPosZ = blockPosZ;
-		}
-		
-		
-		
-		//=================//
-		// getters/setters //
-		//=================//
-		
-		public IDhApiBlockStateWrapper getBlockStateWrapper() { return this.blockStateWrapper; }
-		
-		public IDhApiLevelWrapper getLevelWrapper() { return levelWrapper; }
-		
-		public int getColorAsInt() { return this.colorAsInt; }
-		public int getRed() { return ColorUtil.getRed(this.colorAsInt); }
-		public int getGreen() { return ColorUtil.getGreen(this.colorAsInt); }
-		public int getBlue() { return ColorUtil.getBlue(this.colorAsInt); }
-		public void setColor(int red, int green, int blue) throws IllegalArgumentException
-		{
-			ColorUtil.throwIfColorValueOutOfIntRange("red", red);
-			ColorUtil.throwIfColorValueOutOfIntRange("green", green);
-			ColorUtil.throwIfColorValueOutOfIntRange("blue", blue);
-			
-			this.colorAsInt = ColorUtil.rgbToInt(red, green, blue);
-		}
-		
-		/** @return the block's X value in the world */
-		public int getBlockPosX() { return blockPosX; }
-		/** @return the block's Y value in the world */
-		public int getBlockPosY() { return blockPosY; }
-		/** @return the block's Z value in the world */
-		public int getBlockPosZ() { return blockPosZ; }
-		
-		
-		
-		/** 
-		 * Returns the same instance of this event.
-		 * Copying this event isn't supported
-		 * since the internal parameters must be mutated
-		 * by API users in order to be tracked by DH's internal
-		 * logic.
-		 */
-		@Override
-		public EventParam copy() { return this; }
-		
-		@Override 
-		public boolean getCopyBeforeFire() { return false; }
-		
-		
-		
-	}
-	
-}
@@ -1,131 +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.enums.rendering.EDhApiBlockMaterial;
-import com.seibel.distanthorizons.api.interfaces.block.IDhApiBlockStateWrapper;
-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;
-
-/**
- * Can be used to modify {@link IDhApiBlockStateWrapper}'s as they're created.
- * This can be helpful for modded blocks that are mis-categorized by DH's base logic. <br><br>
- *
- * Note: this is only fired once per {@link IDhApiBlockStateWrapper} that is created
- * and those {@link IDhApiBlockStateWrapper} will only be created once per JVM session.
- * 
- * @author James Seibel
- * @version 2026-04-14
- * @since API 6.0.0
- * @see IDhApiBlockStateWrapper
- */
-public abstract class DhApiBlockStateWrapperCreatedEvent implements IDhApiEvent<DhApiBlockStateWrapperCreatedEvent.EventParam>
-{
-	public abstract void blockStateWrapperCreated(DhApiEventParam<EventParam> event);
-	
-	
-	//=========================//
-	// internal DH API methods //
-	//=========================//
-	
-	@Override
-	public final void fireEvent(DhApiEventParam<EventParam> event) { this.blockStateWrapperCreated(event); }
-	
-	
-	//==================//
-	// parameter object //
-	//==================//
-	
-	public static class EventParam implements IDhApiEventParam
-	{
-		/** 
-		 * A copy of the wrapper that will be created. <Br>
-		 * Note: modifying this object won't change anything
-		 * a new wrapper will be created after this event finishes.
-		 */
-		private final IDhApiBlockStateWrapper blockStateWrapper;
-		
-		private boolean overridesSet = false;
-		private EDhApiBlockMaterial blockMaterial = null;
-		private Integer opacity = null;
-		private Boolean allowApiColorOverride = null;
-		
-		
-		
-		//=============//
-		// constructor //
-		//=============//
-		
-		public EventParam(IDhApiBlockStateWrapper blockStateWrapper) { this.blockStateWrapper = blockStateWrapper; }
-		
-		
-		
-		//=================//
-		// getters/setters //
-		//=================//
-		
-		public IDhApiBlockStateWrapper getBlockStateWrapper() { return this.blockStateWrapper; }
-		
-		/** if set this will override the value currently set in the given {@link IDhApiBlockStateWrapper} */
-		public void setBlockMaterial(EDhApiBlockMaterial blockMaterial) 
-		{
-			this.blockMaterial = blockMaterial; 
-			this.overridesSet = true;
-		}
-		public EDhApiBlockMaterial getBlockMaterial() { return this.blockMaterial; }
-		
-		/** if set this will override the value currently set in the given {@link IDhApiBlockStateWrapper} */
-		public void setOpacity(int opacity) 
-		{
-			this.opacity = opacity;
-			this.overridesSet = true;
-		}
-		public Integer getOpacity() { return this.opacity; }
-		
-		/** if set to true this {@link IDhApiBlockStateWrapper} will trigger {@link DhApiBlockColorOverrideEvent} */
-		public void setAllowApiColorOverride(boolean allowApiColorOverride) 
-		{
-			this.allowApiColorOverride = allowApiColorOverride;
-			this.overridesSet = true;
-		}
-		public Boolean getAllowApiColorOverride() { return this.allowApiColorOverride; }
-		
-		/** If true then one or more options for this block were set to be changed */
-		public boolean getOverridesSet() { return this.overridesSet; }
-		
-		
-		
-		/** 
-		 * Returns the same instance of this event.
-		 * Copying this event isn't supported
-		 * since the internal parameters must be mutated
-		 * by API users in order to be tracked by DH's internal
-		 * logic.
-		 */
-		@Override
-		public EventParam copy() { return this; }
-		
-		@Override 
-		public boolean getCopyBeforeFire() { return false; }
-		
-	}
-	
-}
@@ -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; }
-		
-	}
-	
-}
@@ -31,11 +31,9 @@ import com.seibel.distanthorizons.api.methods.events.sharedParameterObjects.DhAp
 * @author James Seibel
 * @version 2024-3-2
 * @since API 2.0.0
- * @deprecated Only used for the legacy OpenGL renderer <Br>
- *              Replaced by {@link DhApiBeforeColorDepthTextureCreatedEvent} since this event's name isn't obvious when it fires.
- *              Using {@link DhApiAfterColorDepthTextureCreatedEvent} instead is recommended
+ * @deprecated Replaced by {@link DhApiBeforeColorDepthTextureCreatedEvent} since this event's name isn't obvious when it fires.
 */
-@Deprecated // internal notes: this method must be kept around due to Iris using it and we don't want to break old Iris support
+@Deprecated
 public abstract class DhApiColorDepthTextureCreatedEvent implements IDhApiEvent<DhApiColorDepthTextureCreatedEvent.EventParam>
 {
 	/** Fired before Distant Horizons creates. */
@@ -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; }
 	
 }
@@ -20,8 +20,6 @@
 package com.seibel.distanthorizons.api.methods.events.sharedParameterObjects;

 import com.seibel.distanthorizons.api.enums.rendering.EDhApiRenderPass;
-import com.seibel.distanthorizons.api.interfaces.world.IDhApiLevelWrapper;
-import com.seibel.distanthorizons.api.methods.events.abstractEvents.DhApiWorldLoadEvent;
 import com.seibel.distanthorizons.api.methods.events.interfaces.IDhApiEventParam;
 import com.seibel.distanthorizons.api.objects.math.DhApiMat4f;

@@ -29,7 +27,7 @@ import com.seibel.distanthorizons.api.objects.math.DhApiMat4f;
 * Contains information relevant to Distant Horizons and Minecraft rendering.
 *
 * @author James Seibel
- * @version 2025-12-23
+ * @version 2024-1-31
 * @since API 1.0.0
 */
 public class DhApiRenderParam implements IDhApiEventParam
@@ -40,7 +38,7 @@ public class DhApiRenderParam implements IDhApiEventParam
 	/** Indicates how far into this tick the frame is. */
 	public final float partialTicks;
 	
-	/**
+	/** 
 	 * Indicates DH's near clip plane, measured in blocks. 
 	 * Note: this may change based on time, player speed, and other factors. 
 	 */
@@ -60,34 +58,25 @@ public class DhApiRenderParam implements IDhApiEventParam
 	public final DhApiMat4f dhProjectionMatrix;
 	/** The model view matrix Distant Horizons is using to render this frame. */
 	public final DhApiMat4f dhModelViewMatrix;
-	/** combination of the MVM and projection matrices */
-	public final DhApiMat4f dhMvmProjMatrix;
 	
 	public final int worldYOffset;
 	
-	/**
-	 * The level currently being rendered.
-	 * 
-	 * @since API 5.1.0 
-	 */
-	public final IDhApiLevelWrapper clientLevelWrapper;
-	
 	
 	
 	//==============//
 	// constructors //
 	//==============//
 	
+	
 	public DhApiRenderParam(DhApiRenderParam parent)
 	{
 		this(
-			parent.renderPass,
-			parent.partialTicks,
-			parent.nearClipPlane, parent.farClipPlane,
-			parent.mcProjectionMatrix.copy(), parent.mcModelViewMatrix.copy(),
-			parent.dhProjectionMatrix.copy(), parent.dhModelViewMatrix.copy(),
-			parent.worldYOffset,
-			parent.clientLevelWrapper
+				parent.renderPass,
+				parent.partialTicks,
+				parent.nearClipPlane, parent.farClipPlane,
+				parent.mcProjectionMatrix.copy(), parent.mcModelViewMatrix.copy(),
+				parent.dhProjectionMatrix.copy(), parent.dhModelViewMatrix.copy(),
+				parent.worldYOffset
 		);
 	}
 	public DhApiRenderParam(
@@ -96,9 +85,8 @@ public class DhApiRenderParam implements IDhApiEventParam
 			float nearClipPlane, float farClipPlane,
 			DhApiMat4f newMcProjectionMatrix, DhApiMat4f newMcModelViewMatrix,
 			DhApiMat4f newDhProjectionMatrix, DhApiMat4f newDhModelViewMatrix,
-			int worldYOffset,
-			IDhApiLevelWrapper clientLevelWrapper
-		)
+			int worldYOffset
+			)
 	{
 		this.renderPass = renderPass;
 		
@@ -113,12 +101,7 @@ public class DhApiRenderParam implements IDhApiEventParam
 		this.dhProjectionMatrix = newDhProjectionMatrix;
 		this.dhModelViewMatrix = newDhModelViewMatrix;
 		
-		DhApiMat4f combinedMatrix = new DhApiMat4f(this.dhProjectionMatrix);
-		combinedMatrix.multiply(this.dhModelViewMatrix);
-		this.dhMvmProjMatrix = combinedMatrix;
-		
 		this.worldYOffset = worldYOffset;
-		this.clientLevelWrapper = clientLevelWrapper;
 		
 	}
 	
@@ -128,9 +111,10 @@ public class DhApiRenderParam implements IDhApiEventParam
 	// base overrides //
 	//================//
 	
-	@Override
-	public DhApiRenderParam copy() { return new DhApiRenderParam(this); }
-	
-	
+	@Override 
+	public DhApiRenderParam copy()
+	{
+		return new DhApiRenderParam(this); 
+	}
 	
 }
@@ -17,12 +17,12 @@
 *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */

-package com.seibel.distanthorizons.core.config.api;
+package com.seibel.distanthorizons.api.objects.config;

 import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigValue;
-import com.seibel.distanthorizons.core.config.types.ConfigEntry;
+import com.seibel.distanthorizons.coreapi.interfaces.config.IConfigEntry;
 import com.seibel.distanthorizons.coreapi.interfaces.config.IConverter;
-import com.seibel.distanthorizons.core.config.api.converters.DefaultConverter;
+import com.seibel.distanthorizons.coreapi.util.converters.DefaultConverter;

 import java.util.function.Consumer;

@@ -41,17 +41,11 @@ import java.util.function.Consumer;
 */
 public class DhApiConfigValue<coreType, apiType> implements IDhApiConfigValue<apiType>
 {
-	private final ConfigEntry<coreType> configBase;
+	private final IConfigEntry<coreType> configEntry;
 	
 	private final IConverter<coreType, apiType> configConverter;
 	
 	
-	
-	//==============//
- 	// constructors //
-	//==============//
-	//region
-	
 	/**
 	 * This constructor should only be called internally. <br>
 	 * There is no reason for API users to create this object. <br><br>
@@ -59,9 +53,9 @@ public class DhApiConfigValue<coreType, apiType> implements IDhApiConfigValue<ap
 	 * Uses the default object converter, this requires coreType and apiType to be the same.
 	 */
 	@SuppressWarnings("unchecked") // DefaultConverter's cast is safe
-	public DhApiConfigValue(ConfigEntry<coreType> configBase)
+	public DhApiConfigValue(IConfigEntry<coreType> newConfigEntry)
 	{
-		this.configBase = configBase;
+		this.configEntry = newConfigEntry;
 		this.configConverter = (IConverter<coreType, apiType>) new DefaultConverter<coreType>();
 	}
 	
@@ -69,40 +63,22 @@ public class DhApiConfigValue<coreType, apiType> implements IDhApiConfigValue<ap
 	 * This constructor should only be called internally. <br>
 	 * There is no reason for API users to create this object. <br><br>
 	 */
-	public DhApiConfigValue(ConfigEntry<coreType> configBase, IConverter<coreType, apiType> newConverter)
+	public DhApiConfigValue(IConfigEntry<coreType> newConfigEntry, IConverter<coreType, apiType> newConverter)
 	{
-		this.configBase = configBase;
+		this.configEntry = newConfigEntry;
 		this.configConverter = newConverter;
 	}
 	
-	//endregion
 	
+	public apiType getValue() { return this.configConverter.convertToApiType(this.configEntry.get()); }
+	public apiType getTrueValue() { return this.configConverter.convertToApiType(this.configEntry.getTrueValue()); }
+	public apiType getApiValue() { return this.configConverter.convertToApiType(this.configEntry.getApiValue()); }
 	
-	
-	//===========//
- 	// overrides //
-	//===========//
-	//region
-	
-	@Override public apiType getValue() { return this.configConverter.convertToApiType(this.configBase.get()); }
-	@Override public apiType getTrueValue() { return this.configConverter.convertToApiType(this.configBase.getTrueValue()); }
-	@Override public apiType getApiValue() 
-	{
-		// if no API value is set, this should return null
-		if (this.configBase.getApiValue() == null)
-		{
-			return null;
-		}
-		
-		return this.configConverter.convertToApiType(this.configBase.getApiValue()); 
-	}
-	
-	@Override
 	public boolean setValue(apiType newValue)
 	{
-		if (this.configBase.getAllowApiOverride())
+		if (this.configEntry.getAllowApiOverride())
 		{
-			this.configBase.setApiValue(this.configConverter.convertToCoreType(newValue));
+			this.configEntry.setApiValue(this.configConverter.convertToCoreType(newValue));
 			return true;
 		}
 		else
@@ -111,13 +87,13 @@ public class DhApiConfigValue<coreType, apiType> implements IDhApiConfigValue<ap
 		}
 	}
 	
-	@Override
 	public boolean clearValue()
 	{
-		if (this.configBase.getAllowApiOverride())
+		if (this.configEntry.getAllowApiOverride())
 		{
 			// no converter should be used here since null objects may need to be handled differently
-			this.configBase.setApiValue(null);
+			// TODO the API should just have a bool to keep track of whether the API value is in use instead of using NULL
+			this.configEntry.setApiValue(null);
 			return true;
 		}
 		else
@@ -126,24 +102,20 @@ public class DhApiConfigValue<coreType, apiType> implements IDhApiConfigValue<ap
 		}
 	}
 	
-	@Override
-	public boolean getCanBeOverrodeByApi() { return this.configBase.getAllowApiOverride(); }
+	public boolean getCanBeOverrodeByApi() { return this.configEntry.getAllowApiOverride(); }
 	
-	@Override public apiType getDefaultValue() { return this.configConverter.convertToApiType(this.configBase.getDefaultValue()); }
-	@Override public apiType getMaxValue() { return this.configConverter.convertToApiType(this.configBase.getMax()); }
-	@Override public apiType getMinValue() { return this.configConverter.convertToApiType(this.configBase.getMin()); }
+	public apiType getDefaultValue() { return this.configConverter.convertToApiType(this.configEntry.getDefaultValue()); }
+	public apiType getMaxValue() { return this.configConverter.convertToApiType(this.configEntry.getMax()); }
+	public apiType getMinValue() { return this.configConverter.convertToApiType(this.configEntry.getMin()); }
 	
 	
-	@Override
 	public void addChangeListener(Consumer<apiType> onValueChangeFunc) 
 	{
-		this.configBase.addValueChangeListener((coreValue) -> 
+		this.configEntry.addValueChangeListener((coreValue) -> 
 		{
 			apiType apiValue = this.configConverter.convertToApiType(coreValue);
 			onValueChangeFunc.accept(apiValue);
 		}); 
 	}
 	
-	//endregion
-	
 }
@@ -31,7 +31,7 @@ import java.util.List;
 * Contains a list of {@link DhApiTerrainDataPoint} representing the blocks in a Minecraft chunk.
 *
 * @author Builderb0y, James Seibel
- * @version 2025-12-11
+ * @version 2024-7-21
 * @since API 2.0.0
 * 
 * @see IDhApiWrapperFactory
@@ -54,12 +54,27 @@ public class DhApiChunk
 	// constructors //
 	//==============//
 	
-	/** @since API 3.0.0 */
-	public static DhApiChunk create(int chunkPosX, int chunkPosZ, int bottomYBlockPos, int topYBlockPos)
-	{ return new DhApiChunk(chunkPosX, chunkPosZ, bottomYBlockPos, topYBlockPos); }
+	/** 
+	 * Deprecated due to the topYBlockPos and bottomYBlockPos variables being put in the wrong order. 
+	 * They should have been in bottom -> top order. 
+	 * 
+	 * @see DhApiChunk#create(int, int, int, int) 
+	 */
+	@Deprecated
+	public DhApiChunk(int chunkPosX, int chunkPosZ, int topYBlockPos, int bottomYBlockPos) 
+	{ this(chunkPosX, chunkPosZ, bottomYBlockPos, topYBlockPos, false); }
 	
-	/** Only visible to internal DH methods */
-	private DhApiChunk(int chunkPosX, int chunkPosZ, int bottomYBlockPos, int topYBlockPos)
+	/**
+	 * @since API 3.0.0 
+	 */
+	public static DhApiChunk create(int chunkPosX, int chunkPosZ, int bottomYBlockPos, int topYBlockPos)
+	{ return new DhApiChunk(chunkPosX, chunkPosZ, bottomYBlockPos, topYBlockPos, false); }
+	
+	/** 
+	 * Only visible to internal DH methods 
+	 * @param ignoredParameter is only present to differentiate the two constructors and isn't actually used
+	 */
+	private DhApiChunk(int chunkPosX, int chunkPosZ, int bottomYBlockPos, int topYBlockPos, boolean ignoredParameter)
 	{
 		this.chunkPosX = chunkPosX;
 		this.chunkPosZ = chunkPosZ;
@@ -29,7 +29,7 @@ import java.util.ArrayList;
 * Holds a single datapoint of terrain data.
 *
 * @author James Seibel
- * @version 2025-11-15
+ * @version 2024-7-20
 * @since API 1.0.0
 */
 public class DhApiTerrainDataPoint
@@ -47,10 +47,6 @@ public class DhApiTerrainDataPoint
 	
 	public final int blockLightLevel;
 	public final int skyLightLevel;
-	/**
-	 * An unsigned block position of the bottom vertex for this LOD relative to the level's minimum height. 
-	 * Should be greater than or equal to 0.
-	 */
 	public final int bottomYBlockPos;
 	public final int topYBlockPos;
 	
@@ -63,7 +59,28 @@ public class DhApiTerrainDataPoint
 	// constructors //
 	//==============//
 	
-	/** @since API 3.0.0 */
+	/**
+	 * Deprecated due to the topYBlockPos and bottomYBlockPos variables being put in the wrong order. 
+	 * They should have been in bottom -> top order. 
+	 *
+	 * @see DhApiTerrainDataPoint#create(byte, int, int, int, int, IDhApiBlockStateWrapper, IDhApiBiomeWrapper) 
+	 */
+	@Deprecated
+	public DhApiTerrainDataPoint(
+			byte detailLevel, 
+			int blockLightLevel, int skyLightLevel, 
+			int topYBlockPos, int bottomYBlockPos, 
+			IDhApiBlockStateWrapper blockStateWrapper, IDhApiBiomeWrapper biomeWrapper)
+	{
+		this(detailLevel, blockLightLevel, skyLightLevel,
+			bottomYBlockPos, topYBlockPos,
+			blockStateWrapper, biomeWrapper, 
+			false);
+	}
+	
+	/**
+	 * @since API 3.0.0 
+	 */
 	public static DhApiTerrainDataPoint create(
 			byte detailLevel,
 			int blockLightLevel, int skyLightLevel,
@@ -74,15 +91,20 @@ public class DhApiTerrainDataPoint
 		return new DhApiTerrainDataPoint(
 			detailLevel, blockLightLevel, skyLightLevel,
 			bottomYBlockPos, topYBlockPos,
-			blockStateWrapper, biomeWrapper); 
+			blockStateWrapper, biomeWrapper,
+			false); 
 	}
 	
-	/** Only visible to internal DH methods */
+	/**
+	 * Only visible to internal DH methods 
+	 * @param ignoredParameter is only present to differentiate the two constructors and isn't actually used
+	 */
 	private DhApiTerrainDataPoint(
 			byte detailLevel,
 			int blockLightLevel, int skyLightLevel,
 			int bottomYBlockPos, int topYBlockPos,
-			IDhApiBlockStateWrapper blockStateWrapper, IDhApiBiomeWrapper biomeWrapper
+			IDhApiBlockStateWrapper blockStateWrapper, IDhApiBiomeWrapper biomeWrapper,
+			boolean ignoredParameter
 		)
 	{
 		this.detailLevel = detailLevel;
@@ -96,24 +118,4 @@ public class DhApiTerrainDataPoint
 		this.biomeWrapper = biomeWrapper;
 	}
 	
-	
-	
-	//================//
-	// base overrides //
-	//================//
-	
-	@Override 
-	public String toString()
-	{
-		return "[Block:" + this.blockStateWrapper.getSerialString() + 
-				",Biome:" + this.biomeWrapper.getName() + 
-				",TopY:" + this.topYBlockPos + 
-				",BottomY:" + this.bottomYBlockPos + 
-				",BlockLight:" + this.blockLightLevel +
-				",SkyLight:" + this.skyLightLevel + 
-				"]";
-	}
-	
-	
-	
 }
@@ -23,7 +23,6 @@ public class DhApiRenderableBox
 	public DhApiVec3d maxPos;
 	
 	public Color color;
-	/** @see EDhApiBlockMaterial */
 	public byte material;
 	
 	
@@ -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);
 						}
 					}
 					
@@ -43,11 +43,11 @@ public class DependencyInjector<BindableType extends IBindable> implements IDepe
 	protected final boolean allowDuplicateBindings;
 	
 	
-	
-	//==============//
-	// constructors //
-	//==============//
-	//region
+	public DependencyInjector(Class<BindableType> newBindableInterface)
+	{
+		this.bindableInterface = newBindableInterface;
+		this.allowDuplicateBindings = false;
+	}
 	
 	public DependencyInjector(Class<BindableType> newBindableInterface, boolean newAllowDuplicateBindings)
 	{
@@ -55,30 +55,18 @@ public class DependencyInjector<BindableType extends IBindable> implements IDepe
 		this.allowDuplicateBindings = newAllowDuplicateBindings;
 	}
 	
-	//endregion
 	
 	
 	
-	//=========//
-	// binding //
-	//=========//
-	//region
-	
 	@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.");
 		}
 		
-		if (dependencyImplementation == null)
-		{
-			throw new NullPointerException("Can't bind null to ["+dependencyInterface.getSimpleName()+"]");
-		}
-		
 		
 		// make sure the given dependency implements the necessary interfaces
 		boolean implementsInterface = this.checkIfClassImplements(dependencyImplementation.getClass(), dependencyInterface) ||
@@ -141,84 +129,25 @@ public class DependencyInjector<BindableType extends IBindable> implements IDepe
 	@Override
 	public boolean checkIfClassExtends(Class<?> classToTest, Class<?> extensionToLookFor) { return extensionToLookFor.isAssignableFrom(classToTest); }
 	
-	//endregion
-	
-	
-	
-	//===========//
-	// unbinding //
-	//===========//
-	//region
-	
-	public void replaceBinding(Class<? extends BindableType> dependencyInterface, BindableType dependencyImplementation) throws IllegalStateException, IllegalArgumentException
-	{
-		this.unbindAll(dependencyInterface);
-		this.bind(dependencyInterface, dependencyImplementation);
-	}
-	
-	public void unbindAll(Class<? extends BindableType> dependencyInterface) throws IllegalStateException, IllegalArgumentException
-	{
-		// remove the dependency if present
-		this.dependencies.remove(dependencyInterface);
-	}
-	
-	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);
-	}
-	
-	//endregion
-	
-	
-	
-	//=========//
-	// getters //
-	//=========//
-	//region
 	
 	@SuppressWarnings("unchecked")
 	@Override
 	public <T extends BindableType> T get(Class<T> interfaceClass) throws ClassCastException
-	{ return (T) this.getInternalLogic(interfaceClass, false).get(0); }
+	{
+		return (T) this.getInternalLogic(interfaceClass, false).get(0);
+	}
 	
 	@Override
 	public <T extends BindableType> ArrayList<T> getAll(Class<T> interfaceClass) throws ClassCastException
-	{ return this.getInternalLogic(interfaceClass, false); }
+	{
+		return this.getInternalLogic(interfaceClass, false);
+	}
 	
 	@Override
 	public <T extends BindableType> T get(Class<T> interfaceClass, boolean allowIncompleteDependencies) throws ClassCastException
-	{ return (T) this.getInternalLogic(interfaceClass, allowIncompleteDependencies).get(0); }
+	{
+		return (T) this.getInternalLogic(interfaceClass, allowIncompleteDependencies).get(0);
+	}
 	
 	/**
 	 * Always returns a list of size 1 or greater,
@@ -251,7 +180,6 @@ public class DependencyInjector<BindableType extends IBindable> implements IDepe
 		return emptyList;
 	}
 	
-	//endregion
 	
 	
 	/** Removes all bound dependencies. */
@@ -31,31 +31,26 @@ public final class ModInfo
 	public static final String DEDICATED_SERVER_INITIAL_PATH = "dedicated_server_initial";
 	
 	/** Incremented every time any packets are added, changed or removed, with a few exceptions. */
-	public static final int PROTOCOL_VERSION = 13;
-
-	/** 
-	 * The full plugin channel name (RESOURCE_NAMESPACE:WRAPPER_PACKET_PATH) 
-	 * must be 20 characters or fewer for compatibility with MC 1.13 and older. 
-	 */
-	public static final String WRAPPER_PACKET_PATH = "msg";
+	public static final int PROTOCOL_VERSION = 12;
+	public static final String WRAPPER_PACKET_PATH = "message";
 	
 	/** The internal mod name */
 	public static final String NAME = "DistantHorizons";
 	/** Human-readable version of NAME */
 	public static final String READABLE_NAME = "Distant Horizons";
-	public static final String VERSION = "3.0.1-b";
+	public static final String VERSION = "2.3.5-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");
 	
 	/** This version should only be updated when breaking changes are introduced to the DH API */
-	public static final int API_MAJOR_VERSION = 6;
+	public static final int API_MAJOR_VERSION = 4;
 	/** This version should be updated whenever new methods are added to the DH API */
-	public static final int API_MINOR_VERSION = 0;
+	public static final int API_MINOR_VERSION = 1;
 	/** This version should be updated whenever non-breaking fixes are added to the DH API */
 	public static final int API_PATCH_VERSION = 0;
 	
 	/** If the config file has an older version it'll be re-created from scratch. */
-	public static final int CONFIG_FILE_VERSION = 4;
+	public static final int CONFIG_FILE_VERSION = 3;
 	
 	/** All DH owned threads should start with this string to allow for easier debugging and profiling. */
 	public static final String THREAD_NAME_PREFIX = "DH-";
@@ -0,0 +1,83 @@
+/*
+ *    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.coreapi.interfaces.config;
+
+
+import java.util.function.Consumer;
+
+/**
+ * Use for making the config variables
+ *
+ * @author coolGi
+ * @version 2022-5-26
+ */
+public interface IConfigEntry<T>
+{
+	
+	/** Gets the default value of the option */
+	T getDefaultValue();
+	
+	void setApiValue(T newApiValue);
+	T getApiValue();
+	
+	/** Returns true if this config can be set via the API. */
+	boolean getAllowApiOverride();
+	
+	void set(T newValue);
+	T get();
+	T getTrueValue();
+	
+	/** Sets the value without saving */
+	void setWithoutSaving(T newValue);
+	
+	/** Gets the min value */
+	T getMin();
+	/** Sets the min value */
+	void setMin(T newMin);
+	/** Gets the max value */
+	T getMax();
+	/** Sets the max value */
+	void setMax(T newMax);
+	/** Sets the min and max in 1 setter */
+	void setMinMax(T newMin, T newMax);
+	
+	/** Gets the comment */
+	String getComment();
+	/** Sets the comment */
+	void setComment(String newComment);
+	
+	/**
+	 * Checks if the option is valid
+	 *
+	 * 0 == valid
+	 * 2 == invalid
+	 * 1 == number too high
+	 * -1 == number too low
+	 */
+	byte isValid(); // TODO replace with an enum
+	/** Checks if a value is valid */
+	byte isValid(T value);
+	
+	/** Is the value of this equal to another */
+	boolean equals(IConfigEntry<?> obj);
+	
+	void addValueChangeListener(Consumer<T> onValueChangeFunc);
+	
+}
@@ -17,7 +17,7 @@
 *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */

-package com.seibel.distanthorizons.core.config.api.converters;
+package com.seibel.distanthorizons.coreapi.util.converters;

 import com.seibel.distanthorizons.api.enums.rendering.EDhApiFogDrawMode;
 import com.seibel.distanthorizons.coreapi.interfaces.config.IConverter;
@@ -17,7 +17,7 @@
 *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */

-package com.seibel.distanthorizons.core.config.api.converters;
+package com.seibel.distanthorizons.coreapi.util.converters;

 import com.seibel.distanthorizons.coreapi.interfaces.config.IConverter;

@@ -17,7 +17,7 @@
 *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */

-package com.seibel.distanthorizons.core.config.api.converters;
+package com.seibel.distanthorizons.coreapi.util.converters;

 import com.seibel.distanthorizons.api.enums.rendering.EDhApiRendererMode;
 import com.seibel.distanthorizons.coreapi.interfaces.config.IConverter;
@@ -1,23 +1,18 @@
 plugins {
    id "java"
-    id "com.gradleup.shadow"
+    id "com.github.johnrengelman.shadow" version '8.1.1' apply false // Set this to true if you're using the standalone Core project
 }

-repositories {
-    mavenCentral()
-    maven { url "https://repo.enonic.com/public/" }
-}
+apply plugin: "application"

-tasks.withType(JavaCompile).configureEach {
-    options.release = 8
-    options.encoding = "UTF-8"
+application {
+    mainClass.set("com.seibel.distanthorizons.core.jar.JarMain")
 }

 configurations {
    shadowedArtifact // Used by DH to specify that we want to implement the shadowed core JAR file instead of the regular JAR file
    shade
    implementation.extendsFrom shade
-    testImplementation.extendsFrom compileOnly
 }

 OperatingSystem os = org.gradle.nativeplatform.platform.internal.DefaultNativePlatform.currentOperatingSystem;
@@ -25,45 +20,36 @@ OperatingSystem os = org.gradle.nativeplatform.platform.internal.DefaultNativePl
 // Set the OS lwjgl is using to the current os
 project.ext.lwjglNatives = "natives-" + os.toFamilyName()

-dependencies {
-    // API project dependency
-    implementation project(":api")
+dependencies { // All of these dependencies are in Vanilla Minecraft, but we need to depend on it as we arent importing Minecraft in the core
+    // Imports most of lwjgl's libraries (well, only the ones that we need)
+    implementation platform("org.lwjgl:lwjgl-bom:${rootProject.lwjgl_version}") // TODO: Use Minecraft's version for lwjgl_version (which changes in nearly every version) instead of a hard defined version for all versions

-    // MC-provided libraries (available at runtime via Minecraft)
-    compileOnly platform("org.lwjgl:lwjgl-bom:${rootProject.lwjgl_version}")
-    compileOnly "org.lwjgl:lwjgl"
-    compileOnly "org.lwjgl:lwjgl-assimp"
-    compileOnly "org.lwjgl:lwjgl-glfw"
-    compileOnly "org.lwjgl:lwjgl-stb"
-    compileOnly "org.lwjgl:lwjgl-tinyfd"
-    testRuntimeOnly platform("org.lwjgl:lwjgl-bom:${rootProject.lwjgl_version}")
-    testRuntimeOnly "org.lwjgl:lwjgl::$lwjglNatives"
-    testRuntimeOnly "org.lwjgl:lwjgl-assimp::$lwjglNatives"
-    testRuntimeOnly "org.lwjgl:lwjgl-glfw::$lwjglNatives"
-    testRuntimeOnly "org.lwjgl:lwjgl-stb::$lwjglNatives"
-    testRuntimeOnly "org.lwjgl:lwjgl-tinyfd::$lwjglNatives"
+    // REMEMBER: Dont shadow stuff here, these are just the libs that are included in Minecraft so that the core can use
+    implementation "org.lwjgl:lwjgl"
+    implementation "org.lwjgl:lwjgl-assimp"
+    implementation "org.lwjgl:lwjgl-glfw"
+    implementation "org.lwjgl:lwjgl-openal"
+    implementation "org.lwjgl:lwjgl-opengl"
+    implementation "org.lwjgl:lwjgl-stb"
+    implementation "org.lwjgl:lwjgl-tinyfd"
+    runtimeOnly "org.lwjgl:lwjgl::$lwjglNatives"
+    runtimeOnly "org.lwjgl:lwjgl-assimp::$lwjglNatives"
+    runtimeOnly "org.lwjgl:lwjgl-glfw::$lwjglNatives"
+    runtimeOnly "org.lwjgl:lwjgl-openal::$lwjglNatives"
+    runtimeOnly "org.lwjgl:lwjgl-opengl::$lwjglNatives"
+    runtimeOnly "org.lwjgl:lwjgl-stb::$lwjglNatives"
+    runtimeOnly "org.lwjgl:lwjgl-tinyfd::$lwjglNatives"

-    compileOnly("org.apache.logging.log4j:log4j-api:${rootProject.log4j_version}")
-    compileOnly("org.apache.logging.log4j:log4j-core:${rootProject.log4j_version}")
-    compileOnly("it.unimi.dsi:fastutil:${rootProject.fastutil_version}")
-    compileOnly("org.joml:joml:${rootProject.joml_version}")
-    compileOnly("io.netty:netty-buffer:${rootProject.netty_version}")
-    compileOnly("org.jetbrains:annotations:16.0.2")
-    compileOnly("com.google.code.findbugs:jsr305:3.0.2")
-    compileOnly("com.google.guava:guava:31.1-jre")
+    // FIXME for some reason this line doesn't actually shade in the library
+//    shade "it.unimi.dsi:fastutil:${rootProject.fastutil_version}" // Add our own fastutil version

-    // DH's bundled libraries (shadowed + relocated in loader jars)
-    implementation("com.github.luben:zstd-jni:${rootProject.zstd_version}")
-    implementation("org.lz4:lz4-java:${rootProject.lz4_version}")
-    implementation("org.tukaani:xz:${rootProject.xz_version}")
-    implementation("org.xerial:sqlite-jdbc:${rootProject.sqlite_jdbc_version}")
-    implementation("com.electronwill.night-config:toml:${rootProject.nightconfig_version}")
-    implementation("com.electronwill.night-config:json:${rootProject.nightconfig_version}")

-    // JUnit (core tests only)
-    compileOnly("junit:junit:4.13")
-    compileOnly("org.junit.jupiter:junit-jupiter:5.8.2")
-    compileOnly("org.junit.jupiter:junit-jupiter-engine:5.8.2")
+    // Some other dependencies
+    implementation("org.jetbrains:annotations:16.0.2")
+    implementation("com.google.code.findbugs:jsr305:3.0.2")
+    implementation("com.google.common:google-collect:0.5")
+    implementation("com.google.guava:guava:31.1-jre")
+    
 }

 artifacts {
@@ -19,69 +19,43 @@

 package com.seibel.distanthorizons.core;

-import com.github.luben.zstd.ZstdOutputStream;
-import com.seibel.distanthorizons.api.interfaces.render.IDhApiCustomRenderObjectFactory;
-import com.seibel.distanthorizons.api.methods.events.abstractEvents.DhApiBeforeRenderEvent;
-import com.seibel.distanthorizons.core.api.internal.ClientApi;
-import com.seibel.distanthorizons.core.config.Config;
-import com.seibel.distanthorizons.core.config.eventHandlers.IgnoredDimensionCsvHandler;
 import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
-import com.seibel.distanthorizons.core.enums.MinecraftTextFormat;
-import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
+import com.seibel.distanthorizons.core.render.renderer.generic.GenericRenderObjectFactory;
 import com.seibel.distanthorizons.core.sql.DatabaseUpdater;
 import com.seibel.distanthorizons.core.wrapperInterfaces.IWrapperFactory;
+import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftClientWrapper;
+import com.seibel.distanthorizons.coreapi.ModInfo;
 import com.seibel.distanthorizons.core.world.DhApiWorldProxy;
 import com.seibel.distanthorizons.core.api.external.methods.config.DhApiConfig;
 import com.seibel.distanthorizons.core.api.external.methods.data.DhApiTerrainDataRepo;
 import com.seibel.distanthorizons.api.DhApi;
 import com.seibel.distanthorizons.core.render.DhApiRenderProxy;
-import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftClientWrapper;
 import net.jpountz.lz4.LZ4FrameOutputStream;
-import com.seibel.distanthorizons.core.logging.DhLogger;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.sqlite.SQLiteJDBCLoader;
+import org.sqlite.util.OSInfo;
 import org.tukaani.xz.XZOutputStream;

-import java.lang.management.GarbageCollectorMXBean;
-import java.lang.management.ManagementFactory;
-import java.util.List;
+import java.awt.*;
+import java.io.File;

 /** Handles first time Core setup. */
 public class Initializer
 {
-	private static final DhLogger LOGGER = new DhLoggerBuilder().build();
-	
+	private static final Logger LOGGER = LogManager.getLogger(ModInfo.NAME + "-" + Initializer.class.getSimpleName());
 	private static final IMinecraftClientWrapper MC_CLIENT = SingletonInjector.INSTANCE.get(IMinecraftClientWrapper.class);
 	
 	
-	
 	public static void init()
 	{
-		//============================//
-		// check referenced libraries //
-		//============================//
-		//region
-		
-		LOGGER.info("Running library validation...");
-		
 		// confirm that all referenced libraries are available to use
 		try
 		{
 			// 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;
-			
-			{
-				byte[] testCompressByteArray = new byte[1024];
-				for (int i = 0; i < testCompressByteArray.length; i++)
-				{
-					testCompressByteArray[i] = (byte) (i % 126);
-				}
-				byte[] compressedBytes = com.github.luben.zstd.Zstd.compress(testCompressByteArray);
-				com.github.luben.zstd.Zstd.decompress(compressedBytes);
-			}
-			
-			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
@@ -89,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)
 			{
@@ -97,18 +95,12 @@ public class Initializer
 		}
 		catch (Throwable e)
 		{
-			MC_CLIENT.crashMinecraft("Distant Horizons critical setup error: One or more libraries are either in-accessible, corrupted, or overwritten by another mod. Error: [" + e.getMessage() + "].", e);
+			LOGGER.fatal("Critical programmer error: One or more libraries aren't present. Error: [" + e.getMessage() + "].", e);
+			// throwing here should crash the game, notifying the developer that something is wrong
+			throw new RuntimeException(e);
 		}
 		
-		//endregion
-		
-		
-		
-		//==========================//
-		// check resource directory //
-		//==========================//
-		//region
-		
+		// confirm the resource directory is present
 		try
 		{
 			int scriptCount = DatabaseUpdater.getAutoUpdateScriptCount();
@@ -119,18 +111,10 @@ public class Initializer
 		}
 		catch (Exception e)
 		{
-			MC_CLIENT.crashMinecraft("Critical programmer error: Can't read SQL Scripts resource folder is either missing or malformed. Error: [" + e.getMessage() + "].", e);
+			LOGGER.fatal("Critical programmer error: Can't read SQL Scripts resource folder is either missing or malformed. Error: [" + e.getMessage() + "].");
+			throw new RuntimeException(e);
 		}
 		
-		//endregion
-		
-		
-		
-		//===========================//
-		// Java AWT Headless setting // 
-		//===========================//
-		//region
-		
 		// This code has been disabled since it can cause Mac
 		// to lock up and refuse the load (there's a bug with Java.awt texture loading)
 		//if (MC_CLIENT != null)
@@ -147,99 +131,18 @@ public class Initializer
 		//	}
 		//}
 		
-		//endregion
-		
-		
-		
-		//===================//
-		// API delayed setup //
-		//===================//
-		//region
-		
 		// link Core's config to the API
 		DhApi.Delayed.configs = DhApiConfig.INSTANCE;
 		DhApi.Delayed.terrainRepo = DhApiTerrainDataRepo.INSTANCE;
 		DhApi.Delayed.worldProxy = DhApiWorldProxy.INSTANCE;
 		DhApi.Delayed.renderProxy = DhApiRenderProxy.INSTANCE;
+		DhApi.Delayed.customRenderObjectFactory = GenericRenderObjectFactory.INSTANCE;
 		DhApi.Delayed.wrapperFactory = SingletonInjector.INSTANCE.get(IWrapperFactory.class);
 		if (DhApi.Delayed.wrapperFactory == null)
 		{
-			MC_CLIENT.crashMinecraft("Programmer Error: No ["+IWrapperFactory.class.getSimpleName()+"] assigned to the DhApi.", new Exception());
+			LOGGER.error("Programmer Error: No ["+IWrapperFactory.class.getSimpleName()+"] assigned to the DhApi.");
 		}
 		
-		DhApi.Delayed.customRenderObjectFactory = SingletonInjector.INSTANCE.get(IDhApiCustomRenderObjectFactory.class);
-		if (DhApi.Delayed.customRenderObjectFactory == null)
-		{
-			MC_CLIENT.crashMinecraft("Programmer Error: No ["+IDhApiCustomRenderObjectFactory.class.getSimpleName()+"] assigned to the DhApi.", new Exception());
-		}
-		
-		DhApi.events.bind(DhApiBeforeRenderEvent.class, IgnoredDimensionCsvHandler.INSTANCE);
-		
-		//endregion
-		
-		
-		
-		//==============================//
-		// G1 Garbage collector warning //
-		//==============================//
-		//region
-		
-		// log a warning if G1GC is being used
-		// (this garbage collector is known to cause stuttering)
-		{
-			boolean g1GcInUse = false;
-			
-			StringBuilder garbageCollectorNames = new StringBuilder();
-			List<GarbageCollectorMXBean> gcMxBeans = ManagementFactory.getGarbageCollectorMXBeans();
-			for (GarbageCollectorMXBean gcMxBean : gcMxBeans)
-			{
-				if (!garbageCollectorNames.toString().isEmpty())
-				{
-					garbageCollectorNames.append(", ");
-				}
-				garbageCollectorNames.append(gcMxBean.getName());
-				
-				// "G1 Young Generation" // "G1 Concurrent GC" // "G1 Old Generation"
-				if (gcMxBean.getName().toLowerCase().contains("g1 "))
-				{
-					g1GcInUse = true;
-				}
-			}
-			LOGGER.info("Garbage collectors: ["+garbageCollectorNames+"]");
-			
-			
-			if (g1GcInUse)
-			{
-				String warningMessageHeader = "Distant Horizons: G1 Garbage collector detected.";
-				String warningMessageBody = 
-					"This can cause FPS stuttering. \n" +
-					"It's recommended to use a concurrent garbage collector \n" +
-					"like ZGC (Java 21+) or Shenandoah (Java 8 through 17) \n" +
-					"for a smoother experience."
-					;
-				
-				if (Config.Common.Logging.Warning.logGarbageCollectorWarning.get())
-				{
-					LOGGER.warn(
-						warningMessageHeader + "\n" +
-						warningMessageBody +
-						"");
-				}
-				
-				if (Config.Common.Logging.Warning.showGarbageCollectorWarning.get())
-				{
-					ClientApi.INSTANCE.showChatMessageNextFrame(
-						MinecraftTextFormat.ORANGE + warningMessageHeader + MinecraftTextFormat.CLEAR_FORMATTING + "\n" +
-						warningMessageBody +
-						"");
-				}
-			}
-		}
-		
-		//endregion
-		
-		
-		
 	}
 	
 }
@@ -21,7 +21,7 @@ package com.seibel.distanthorizons.core.api.external.methods.config.client;

 import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigValue;
 import com.seibel.distanthorizons.api.interfaces.config.client.IDhApiAmbientOcclusionConfig;
-import com.seibel.distanthorizons.core.config.api.DhApiConfigValue;
+import com.seibel.distanthorizons.api.objects.config.DhApiConfigValue;
 import com.seibel.distanthorizons.core.config.Config;

 public class DhApiAmbientOcclusionConfig implements IDhApiAmbientOcclusionConfig
@@ -35,6 +35,30 @@ public class DhApiAmbientOcclusionConfig implements IDhApiAmbientOcclusionConfig
 	
 	@Override
 	public IDhApiConfigValue<Boolean> enabled()
-	{ return new DhApiConfigValue<Boolean, Boolean>(Config.Client.Advanced.Graphics.enableSsao); }
+	{ return new DhApiConfigValue<Boolean, Boolean>(Config.Client.Advanced.Graphics.Ssao.enableSsao); }
+	
+	@Override
+	public IDhApiConfigValue<Integer> sampleCount()
+	{ return new DhApiConfigValue<Integer, Integer>(Config.Client.Advanced.Graphics.Ssao.sampleCount); }
+	
+	@Override
+	public IDhApiConfigValue<Double> radius()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Ssao.radius); }
+	
+	@Override
+	public IDhApiConfigValue<Double> strength()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Ssao.strength); }
+	
+	@Override
+	public IDhApiConfigValue<Double> bias()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Ssao.bias); }
+	
+	@Override
+	public IDhApiConfigValue<Double> minLight()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Ssao.minLight); }
+	
+	@Override
+	public IDhApiConfigValue<Integer> blurRadius()
+	{ return new DhApiConfigValue<Integer, Integer>(Config.Client.Advanced.Graphics.Ssao.blurRadius); }
 	
 }
@@ -21,7 +21,7 @@ package com.seibel.distanthorizons.core.api.external.methods.config.client;

 import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigValue;
 import com.seibel.distanthorizons.api.interfaces.config.client.IDhApiDebuggingConfig;
-import com.seibel.distanthorizons.core.config.api.DhApiConfigValue;
+import com.seibel.distanthorizons.api.objects.config.DhApiConfigValue;
 import com.seibel.distanthorizons.core.config.Config;
 import com.seibel.distanthorizons.api.enums.rendering.EDhApiDebugRendering;

@@ -34,7 +34,7 @@ public class DhApiDebuggingConfig implements IDhApiDebuggingConfig
 	
 	
 	public IDhApiConfigValue<EDhApiDebugRendering> debugRendering()
-	{ return new DhApiConfigValue<EDhApiDebugRendering, EDhApiDebugRendering>(Config.Client.Advanced.Debugging.debugRenderingColors); }
+	{ return new DhApiConfigValue<EDhApiDebugRendering, EDhApiDebugRendering>(Config.Client.Advanced.Debugging.debugRendering); }
 	
 	public IDhApiConfigValue<Boolean> debugKeybindings()
 	{ return new DhApiConfigValue<Boolean, Boolean>(Config.Client.Advanced.Debugging.enableDebugKeybindings); }
@@ -22,7 +22,7 @@ package com.seibel.distanthorizons.core.api.external.methods.config.client;
 import com.seibel.distanthorizons.api.enums.rendering.EDhApiFogFalloff;
 import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigValue;
 import com.seibel.distanthorizons.api.interfaces.config.client.IDhApiFarFogConfig;
-import com.seibel.distanthorizons.core.config.api.DhApiConfigValue;
+import com.seibel.distanthorizons.api.objects.config.DhApiConfigValue;
 import com.seibel.distanthorizons.core.config.Config;

 public class DhApiFarFogConfig implements IDhApiFarFogConfig
@@ -34,27 +34,27 @@ public class DhApiFarFogConfig implements IDhApiFarFogConfig
 	
 	
 	@Override
-	public IDhApiConfigValue<Float> farFogStartDistance()
-	{ return new DhApiConfigValue<Float, Float>(Config.Client.Advanced.Graphics.Fog.farFogStart); }
+	public IDhApiConfigValue<Double> farFogStartDistance()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Fog.farFogStart); }
 	
 	@Override
-	public IDhApiConfigValue<Float> farFogEndDistance()
-	{ return new DhApiConfigValue<Float, Float>(Config.Client.Advanced.Graphics.Fog.farFogEnd); }
+	public IDhApiConfigValue<Double> farFogEndDistance()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Fog.farFogEnd); }
 	
 	@Override
-	public IDhApiConfigValue<Float> farFogMinThickness()
-	{ return new DhApiConfigValue<Float, Float>(Config.Client.Advanced.Graphics.Fog.farFogMin); }
+	public IDhApiConfigValue<Double> farFogMinThickness()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Fog.farFogMin); }
 	
 	@Override
-	public IDhApiConfigValue<Float> farFogMaxThickness()
-	{ return new DhApiConfigValue<Float, Float>(Config.Client.Advanced.Graphics.Fog.farFogMax); }
+	public IDhApiConfigValue<Double> farFogMaxThickness()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Fog.farFogMax); }
 	
 	@Override
 	public IDhApiConfigValue<EDhApiFogFalloff> farFogFalloff()
 	{ return new DhApiConfigValue<EDhApiFogFalloff, EDhApiFogFalloff>(Config.Client.Advanced.Graphics.Fog.farFogFalloff); }
 	
 	@Override
-	public IDhApiConfigValue<Float> farFogDensity()
-	{ return new DhApiConfigValue<Float, Float>(Config.Client.Advanced.Graphics.Fog.farFogDensity); }
+	public IDhApiConfigValue<Double> farFogDensity()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Fog.farFogDensity); }
 	
 }
@@ -25,10 +25,9 @@ import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigValue;
 import com.seibel.distanthorizons.api.interfaces.config.client.IDhApiFarFogConfig;
 import com.seibel.distanthorizons.api.interfaces.config.client.IDhApiFogConfig;
 import com.seibel.distanthorizons.api.interfaces.config.client.IDhApiHeightFogConfig;
-import com.seibel.distanthorizons.core.config.api.DhApiConfigValue;
+import com.seibel.distanthorizons.api.objects.config.DhApiConfigValue;
 import com.seibel.distanthorizons.core.config.Config;
-import com.seibel.distanthorizons.core.config.api.converters.ApiFogDrawModeConverter;
-import com.seibel.distanthorizons.core.config.api.converters.InvertedBoolConverter;
+import com.seibel.distanthorizons.coreapi.util.converters.ApiFogDrawModeConverter;

 public class DhApiFogConfig implements IDhApiFogConfig
 {
@@ -68,7 +67,7 @@ public class DhApiFogConfig implements IDhApiFogConfig
 	@Override
 	@Deprecated
 	public IDhApiConfigValue<Boolean> disableVanillaFog()
-	{ return new DhApiConfigValue<>(Config.Client.Advanced.Graphics.Fog.enableVanillaFog, new InvertedBoolConverter()); }
+	{ return new DhApiConfigValue<>(Config.Client.Advanced.Graphics.Fog.disableVanillaFog); }
 	@Override
 	public IDhApiConfigValue<Boolean> enableVanillaFog()
 	{ return new DhApiConfigValue<>(Config.Client.Advanced.Graphics.Fog.enableVanillaFog); }
@@ -21,7 +21,7 @@ package com.seibel.distanthorizons.core.api.external.methods.config.client;

 import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigValue;
 import com.seibel.distanthorizons.api.interfaces.config.client.IDhApiGenericRenderingConfig;
-import com.seibel.distanthorizons.core.config.api.DhApiConfigValue;
+import com.seibel.distanthorizons.api.objects.config.DhApiConfigValue;
 import com.seibel.distanthorizons.core.config.Config;

 public class DhApiGenericRenderingConfig implements IDhApiGenericRenderingConfig
@@ -23,10 +23,10 @@ import com.seibel.distanthorizons.api.enums.config.*;
 import com.seibel.distanthorizons.api.enums.rendering.EDhApiTransparency;
 import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigValue;
 import com.seibel.distanthorizons.api.interfaces.config.client.*;
-import com.seibel.distanthorizons.core.config.api.DhApiConfigValue;
+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.core.config.api.converters.RenderModeEnabledConverter;
+import com.seibel.distanthorizons.coreapi.util.converters.RenderModeEnabledConverter;

 public class DhApiGraphicsConfig implements IDhApiGraphicsConfig
 {
@@ -97,9 +97,10 @@ public class DhApiGraphicsConfig implements IDhApiGraphicsConfig
 	public IDhApiConfigValue<Boolean> tintWithAvoidedBlocks()
 	{ return new DhApiConfigValue<Boolean, Boolean>(Config.Client.Advanced.Graphics.Quality.tintWithAvoidedBlocks); }
 	
-	@Override
-	public IDhApiConfigValue<Integer> getBiomeBlending()
-	{ return new DhApiConfigValue<Integer, Integer>(Config.Client.Advanced.Graphics.Quality.lodBiomeBlending); }
+	// TODO re-implement
+//	@Override
+//	public IDhApiConfigValue<Integer> getBiomeBlending()
+//	{ return new DhApiConfigValue<Integer, Integer>(Quality.lodBiomeBlending); }
 	
 	
 	
@@ -108,16 +109,16 @@ public class DhApiGraphicsConfig implements IDhApiGraphicsConfig
 	//===========================//

 	@Override
-	public IDhApiConfigValue<Float> overdrawPreventionRadius()
-	{ return new DhApiConfigValue<Float, Float>(Config.Client.Advanced.Graphics.Culling.overdrawPrevention); }
+	public IDhApiConfigValue<Double> overdrawPreventionRadius()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Culling.overdrawPrevention); }
 	
 	@Override
-	public IDhApiConfigValue<Float> brightnessMultiplier()
-	{ return new DhApiConfigValue<Float, Float>(Config.Client.Advanced.Graphics.Quality.brightnessMultiplier); }
+	public IDhApiConfigValue<Double> brightnessMultiplier()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Quality.brightnessMultiplier); }
 	
 	@Override
-	public IDhApiConfigValue<Float> saturationMultiplier()
-	{ return new DhApiConfigValue<Float, Float>(Config.Client.Advanced.Graphics.Quality.saturationMultiplier); }
+	public IDhApiConfigValue<Double> saturationMultiplier()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Quality.saturationMultiplier); }
 	
 	@Override
 	public IDhApiConfigValue<Boolean> caveCullingEnabled()
@@ -135,6 +136,10 @@ public class DhApiGraphicsConfig implements IDhApiGraphicsConfig
 	public IDhApiConfigValue<Boolean> lodOnlyMode()
 	{ return new DhApiConfigValue<Boolean, Boolean>(Config.Client.Advanced.Debugging.lodOnlyMode); }
 	
+	@Override
+	public IDhApiConfigValue<Double> lodBias()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Quality.lodBias); }
+	
 	@Override
 	public IDhApiConfigValue<EDhApiLodShading> lodShading()
 	{ return new DhApiConfigValue<EDhApiLodShading, EDhApiLodShading>(Config.Client.Advanced.Graphics.Quality.lodShading); }
@@ -24,7 +24,7 @@ import com.seibel.distanthorizons.api.enums.rendering.EDhApiHeightFogMixMode;
 import com.seibel.distanthorizons.api.enums.rendering.EDhApiHeightFogDirection;
 import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigValue;
 import com.seibel.distanthorizons.api.interfaces.config.client.IDhApiHeightFogConfig;
-import com.seibel.distanthorizons.core.config.api.DhApiConfigValue;
+import com.seibel.distanthorizons.api.objects.config.DhApiConfigValue;
 import com.seibel.distanthorizons.core.config.Config;

 public class DhApiHeightFogConfig implements IDhApiHeightFogConfig
@@ -44,31 +44,31 @@ public class DhApiHeightFogConfig implements IDhApiHeightFogConfig
 	{ return new DhApiConfigValue<EDhApiHeightFogDirection, EDhApiHeightFogDirection>(Config.Client.Advanced.Graphics.Fog.HeightFog.heightFogDirection); }
 	
 	@Override
-	public IDhApiConfigValue<Float> heightFogBaseHeight()
-	{ return new DhApiConfigValue<Float, Float>(Config.Client.Advanced.Graphics.Fog.HeightFog.heightFogBaseHeight); }
+	public IDhApiConfigValue<Double> heightFogBaseHeight()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Fog.HeightFog.heightFogBaseHeight); }
 	
 	@Override
-	public IDhApiConfigValue<Float> heightFogStartingHeightPercent()
-	{ return new DhApiConfigValue<Float, Float>(Config.Client.Advanced.Graphics.Fog.HeightFog.heightFogStart); }
+	public IDhApiConfigValue<Double> heightFogStartingHeightPercent()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Fog.HeightFog.heightFogStart); }
 	
 	@Override
-	public IDhApiConfigValue<Float> heightFogEndingHeightPercent()
-	{ return new DhApiConfigValue<Float, Float>(Config.Client.Advanced.Graphics.Fog.HeightFog.heightFogEnd); }
+	public IDhApiConfigValue<Double> heightFogEndingHeightPercent()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Fog.HeightFog.heightFogEnd); }
 	
 	@Override
-	public IDhApiConfigValue<Float> heightFogMinThickness()
-	{ return new DhApiConfigValue<Float, Float>(Config.Client.Advanced.Graphics.Fog.HeightFog.heightFogMin); }
+	public IDhApiConfigValue<Double> heightFogMinThickness()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Fog.HeightFog.heightFogMin); }
 	
 	@Override
-	public IDhApiConfigValue<Float> heightFogMaxThickness()
-	{ return new DhApiConfigValue<Float, Float>(Config.Client.Advanced.Graphics.Fog.HeightFog.heightFogMax); }
+	public IDhApiConfigValue<Double> heightFogMaxThickness()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Fog.HeightFog.heightFogMax); }
 	
 	@Override
 	public IDhApiConfigValue<EDhApiFogFalloff> heightFogFalloff()
 	{ return new DhApiConfigValue<EDhApiFogFalloff, EDhApiFogFalloff>(Config.Client.Advanced.Graphics.Fog.HeightFog.heightFogFalloff); }
 	
 	@Override
-	public IDhApiConfigValue<Float> heightFogDensity()
-	{ return new DhApiConfigValue<Float, Float>(Config.Client.Advanced.Graphics.Fog.HeightFog.heightFogDensity); }
+	public IDhApiConfigValue<Double> heightFogDensity()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.Fog.HeightFog.heightFogDensity); }
 	
 }
@@ -21,7 +21,7 @@ package com.seibel.distanthorizons.core.api.external.methods.config.client;

 import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigValue;
 import com.seibel.distanthorizons.api.interfaces.config.client.IDhApiMultiThreadingConfig;
-import com.seibel.distanthorizons.core.config.api.DhApiConfigValue;
+import com.seibel.distanthorizons.api.objects.config.DhApiConfigValue;
 import com.seibel.distanthorizons.core.config.Config;

 public class DhApiMultiThreadingConfig implements IDhApiMultiThreadingConfig
@@ -21,7 +21,7 @@ package com.seibel.distanthorizons.core.api.external.methods.config.client;

 import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigValue;
 import com.seibel.distanthorizons.api.interfaces.config.client.IDhApiMultiplayerConfig;
-import com.seibel.distanthorizons.core.config.api.DhApiConfigValue;
+import com.seibel.distanthorizons.api.objects.config.DhApiConfigValue;
 import com.seibel.distanthorizons.core.config.Config;
 import com.seibel.distanthorizons.api.enums.config.EDhApiServerFolderNameMode;

@@ -21,7 +21,7 @@ package com.seibel.distanthorizons.core.api.external.methods.config.client;

 import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigValue;
 import com.seibel.distanthorizons.api.interfaces.config.client.IDhApiNoiseTextureConfig;
-import com.seibel.distanthorizons.core.config.api.DhApiConfigValue;
+import com.seibel.distanthorizons.api.objects.config.DhApiConfigValue;
 import com.seibel.distanthorizons.core.config.Config;

 public class DhApiNoiseTextureConfig implements IDhApiNoiseTextureConfig
@@ -41,8 +41,8 @@ public class DhApiNoiseTextureConfig implements IDhApiNoiseTextureConfig
 	{ return new DhApiConfigValue<Integer, Integer>(Config.Client.Advanced.Graphics.NoiseTexture.noiseSteps); }
 	
 	@Override
-	public IDhApiConfigValue<Float> noiseIntensity()
-	{ return new DhApiConfigValue<Float, Float>(Config.Client.Advanced.Graphics.NoiseTexture.noiseIntensity); }
+	public IDhApiConfigValue<Double> noiseIntensity()
+	{ return new DhApiConfigValue<Double, Double>(Config.Client.Advanced.Graphics.NoiseTexture.noiseIntensity); }
 	
 	@Override
 	public IDhApiConfigValue<Integer> noiseDropoff()
@@ -21,7 +21,7 @@ package com.seibel.distanthorizons.core.api.external.methods.config.common;

 import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigValue;
 import com.seibel.distanthorizons.api.interfaces.config.both.IDhApiWorldGenerationConfig;
-import com.seibel.distanthorizons.core.config.api.DhApiConfigValue;
+import com.seibel.distanthorizons.api.objects.config.DhApiConfigValue;
 import com.seibel.distanthorizons.api.enums.worldGeneration.EDhApiDistantGeneratorMode;
 import com.seibel.distanthorizons.core.config.Config;

@@ -2,10 +2,10 @@ package com.seibel.distanthorizons.core.api.external.methods.data;

 import com.seibel.distanthorizons.api.interfaces.data.IDhApiTerrainDataCache;
 import com.seibel.distanthorizons.core.dataObjects.fullData.sources.FullDataSourceV2;
-import com.seibel.distanthorizons.core.logging.DhLogger;
-import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
 import it.unimi.dsi.fastutil.longs.Long2ReferenceOpenHashMap;
 import it.unimi.dsi.fastutil.longs.LongSet;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.jetbrains.annotations.Nullable;

 import java.lang.ref.SoftReference;
@@ -13,16 +13,15 @@ import java.lang.ref.SoftReference;
 public class DhApiTerrainDataCache implements IDhApiTerrainDataCache
 {
 	private final Object modificationLock = new Object();
-	private final Long2ReferenceOpenHashMap<SoftReference<FullDataSourceV2>> posToFullDataRef = new Long2ReferenceOpenHashMap<>();
+	private Long2ReferenceOpenHashMap<SoftReference<FullDataSourceV2>> posToFullDataRef = new Long2ReferenceOpenHashMap<>();
 	
-	private static final DhLogger LOGGER = new DhLoggerBuilder().build();
+	private static final Logger LOGGER = LogManager.getLogger(DhApiTerrainDataCache.class.getSimpleName());
 	
 	
 	
 	//==================//
 	// internal methods //
 	//==================//
-	//region
 	
 	public void add(long pos, FullDataSourceV2 dataSource)
 	{
@@ -49,14 +48,11 @@ public class DhApiTerrainDataCache implements IDhApiTerrainDataCache
 		}
 	}
 	
-	//endregion
-	
 	
 	
 	//=============//
 	// API methods //
 	//=============//
-	//region
 	
 	@Override 
 	public void clear()
@@ -86,23 +82,6 @@ public class DhApiTerrainDataCache implements IDhApiTerrainDataCache
 		}
 	}
 	
-	//endregion
-	
-	
-	
-	//================//
- 	// base overrides //
-	//================//
-	//region
-	
-	@Override 
-	public void close() { this.clear(); }
-	
-	@Override 
-	public String toString() { return "Size: " + this.posToFullDataRef.size(); }
-	
-	//endregion
-	
 	
 	
 }
@@ -31,10 +31,9 @@ import com.seibel.distanthorizons.core.dataObjects.fullData.FullDataPointIdMap;
 import com.seibel.distanthorizons.core.dataObjects.fullData.sources.FullDataSourceV2;
 import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
 import com.seibel.distanthorizons.core.level.IDhLevel;
-import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
-import com.seibel.distanthorizons.core.pos.DhChunkPos;
+import com.seibel.distanthorizons.core.pos.DhLodPos;
 import com.seibel.distanthorizons.core.pos.DhSectionPos;
-import com.seibel.distanthorizons.core.render.renderer.AbstractDebugWireframeRenderer;
+import com.seibel.distanthorizons.core.render.renderer.DebugRenderer;
 import com.seibel.distanthorizons.core.util.DhApiTerrainDataPointUtil;
 import com.seibel.distanthorizons.core.util.FullDataPointUtil;
 import com.seibel.distanthorizons.core.util.LodUtil;
@@ -49,7 +48,8 @@ import com.seibel.distanthorizons.coreapi.util.BitShiftUtil;
 import com.seibel.distanthorizons.core.util.math.Vec3d;
 import com.seibel.distanthorizons.core.util.math.Vec3i;
 import it.unimi.dsi.fastutil.longs.LongArrayList;
-import com.seibel.distanthorizons.core.logging.DhLogger;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.jetbrains.annotations.Nullable;

 import java.awt.*;
@@ -64,9 +64,7 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 {
 	public static DhApiTerrainDataRepo INSTANCE = new DhApiTerrainDataRepo();
 	
-	private static final DhLogger LOGGER = new DhLoggerBuilder().build();
-	
-	private static final AbstractDebugWireframeRenderer DEBUG_RENDERER = SingletonInjector.INSTANCE.get(AbstractDebugWireframeRenderer.class);
+	private static final Logger LOGGER = LogManager.getLogger(DhApiTerrainDataRepo.class.getSimpleName());
 	
 	// debugging values
 	private static volatile boolean debugThreadRunning = false;
@@ -91,30 +89,30 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 	//================//
 	
 	@Override
-	public DhApiResult<DhApiTerrainDataPoint> getSingleDataPointAtBlockPos(IDhApiLevelWrapper levelWrapper, int blockPosX, int blockPosY, int blockPosZ, IDhApiTerrainDataCache dataCache)
-	{ return getTerrainDataAtBlockYPos(levelWrapper, DhSectionPos.encode(LodUtil.BLOCK_DETAIL_LEVEL, blockPosX, blockPosZ), blockPosY, dataCache); }
+	public DhApiResult<DhApiTerrainDataPoint> getSingleDataPointAtBlockPos(IDhApiLevelWrapper levelWrapper, int blockPosX, int blockPosY, int blockPosZ, @Nullable IDhApiTerrainDataCache dataCache)
+	{ return getTerrainDataAtBlockYPos(levelWrapper, new DhLodPos(LodUtil.BLOCK_DETAIL_LEVEL, blockPosX, blockPosZ), blockPosY, dataCache); }
 	@Override
-	public DhApiResult<DhApiTerrainDataPoint[]> getColumnDataAtBlockPos(IDhApiLevelWrapper levelWrapper, int blockPosX, int blockPosZ, IDhApiTerrainDataCache dataCache)
-	{ return getTerrainDataColumnArray(levelWrapper, DhSectionPos.encode(LodUtil.BLOCK_DETAIL_LEVEL, blockPosX, blockPosZ), null, dataCache); }
+	public DhApiResult<DhApiTerrainDataPoint[]> getColumnDataAtBlockPos(IDhApiLevelWrapper levelWrapper, int blockPosX, int blockPosZ, @Nullable IDhApiTerrainDataCache dataCache)
+	{ return getTerrainDataColumnArray(levelWrapper, new DhLodPos(LodUtil.BLOCK_DETAIL_LEVEL, blockPosX, blockPosZ), null, dataCache); }
 	
 	@Override
-	public DhApiResult<DhApiTerrainDataPoint[][][]> getAllTerrainDataAtChunkPos(IDhApiLevelWrapper levelWrapper, int chunkPosX, int chunkPosZ, IDhApiTerrainDataCache dataCache)
-	{ return getTerrainDataOverAreaForPositionDetailLevel(levelWrapper, DhSectionPos.encode(LodUtil.CHUNK_DETAIL_LEVEL, chunkPosX, chunkPosZ), dataCache); }
+	public DhApiResult<DhApiTerrainDataPoint[][][]> getAllTerrainDataAtChunkPos(IDhApiLevelWrapper levelWrapper, int chunkPosX, int chunkPosZ, @Nullable IDhApiTerrainDataCache dataCache)
+	{ return getTerrainDataOverAreaForPositionDetailLevel(levelWrapper, new DhLodPos(LodUtil.CHUNK_DETAIL_LEVEL, chunkPosX, chunkPosZ), dataCache); }
 	
 	@Override
-	public DhApiResult<DhApiTerrainDataPoint[][][]> getAllTerrainDataAtRegionPos(IDhApiLevelWrapper levelWrapper, int regionPosX, int regionPosZ, IDhApiTerrainDataCache dataCache)
-	{ return getTerrainDataOverAreaForPositionDetailLevel(levelWrapper, DhSectionPos.encode(LodUtil.REGION_DETAIL_LEVEL, regionPosX, regionPosZ), dataCache); }
+	public DhApiResult<DhApiTerrainDataPoint[][][]> getAllTerrainDataAtRegionPos(IDhApiLevelWrapper levelWrapper, int regionPosX, int regionPosZ, @Nullable IDhApiTerrainDataCache dataCache)
+	{ return getTerrainDataOverAreaForPositionDetailLevel(levelWrapper, new DhLodPos(LodUtil.REGION_DETAIL_LEVEL, regionPosX, regionPosZ), dataCache); }
 	
 	@Override
-	public DhApiResult<DhApiTerrainDataPoint[][][]> getAllTerrainDataAtDetailLevelAndPos(IDhApiLevelWrapper levelWrapper, byte detailLevel, int posX, int posZ, IDhApiTerrainDataCache dataCache)
-	{ return getTerrainDataOverAreaForPositionDetailLevel(levelWrapper, DhSectionPos.encode(detailLevel, posX, posZ), dataCache); }
+	public DhApiResult<DhApiTerrainDataPoint[][][]> getAllTerrainDataAtDetailLevelAndPos(IDhApiLevelWrapper levelWrapper, byte detailLevel, int posX, int posZ, @Nullable IDhApiTerrainDataCache dataCache)
+	{ return getTerrainDataOverAreaForPositionDetailLevel(levelWrapper, new DhLodPos(detailLevel, posX, posZ), dataCache); }
 	
 	
 	
 	// private getters //
 	
 	/** Returns a single API terrain datapoint that contains the given Y block position */
-	private static DhApiResult<DhApiTerrainDataPoint> getTerrainDataAtBlockYPos(IDhApiLevelWrapper levelWrapper, long requestedColumnPos, Integer blockYPos, IDhApiTerrainDataCache dataCache)
+	private static DhApiResult<DhApiTerrainDataPoint> getTerrainDataAtBlockYPos(IDhApiLevelWrapper levelWrapper, DhLodPos requestedColumnPos, Integer blockYPos, @Nullable IDhApiTerrainDataCache dataCache)
 	{
 		DhApiResult<DhApiTerrainDataPoint[]> result = getTerrainDataColumnArray(levelWrapper, requestedColumnPos, blockYPos, dataCache);
 		if (result.success && result.payload.length > 0)
@@ -128,7 +126,7 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 	}
 	
 	/**
-	 * Returns all the block columns represented by the given {@link DhSectionPos}. <br>
+	 * Returns all the block columns represented by the given {@link DhLodPos}. <br>
 	 * IE, A position with the detail level: <br>
 	 * 0 (block): will return a 1x1 matrix of data. (don't do this, we have a specific method for that.) <br>
 	 * 1 (2 blocks): will return a 2x2 matrix of data. <br>
@@ -137,14 +135,11 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 	 * will stop and return the in progress data if any errors are encountered.
 	 */
 	private static DhApiResult<DhApiTerrainDataPoint[][][]> getTerrainDataOverAreaForPositionDetailLevel(
-			IDhApiLevelWrapper levelWrapper, long requestedAreaPos, 
-			IDhApiTerrainDataCache dataCache)
+			IDhApiLevelWrapper levelWrapper, DhLodPos requestedAreaPos, 
+			@Nullable IDhApiTerrainDataCache dataCache)
 	{
-		byte requestedDetailLevel = DhSectionPos.getDetailLevel(requestedAreaPos);
-		long startingBlockPos = DhSectionPos.encode(LodUtil.BLOCK_DETAIL_LEVEL,
-			DhSectionPos.getX(requestedAreaPos) * BitShiftUtil.powerOfTwo(requestedDetailLevel - LodUtil.BLOCK_DETAIL_LEVEL),
-			DhSectionPos.getZ(requestedAreaPos) * BitShiftUtil.powerOfTwo(requestedDetailLevel - LodUtil.BLOCK_DETAIL_LEVEL));
-		int widthOfAreaInBlocks = BitShiftUtil.powerOfTwo(requestedDetailLevel);
+		DhLodPos startingBlockPos = requestedAreaPos.getCornerLodPos(LodUtil.BLOCK_DETAIL_LEVEL);
+		int widthOfAreaInBlocks = BitShiftUtil.powerOfTwo(requestedAreaPos.detailLevel);
 		
 		DhApiTerrainDataPoint[][][] returnArray = new DhApiTerrainDataPoint[widthOfAreaInBlocks][widthOfAreaInBlocks][];
 		int dataColumnsReturned = 0;
@@ -154,7 +149,7 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 		{
 			for (int z = 0; z < widthOfAreaInBlocks; z++)
 			{
-				long blockColumnPos = DhSectionPos.encode(LodUtil.BLOCK_DETAIL_LEVEL, DhSectionPos.getX(startingBlockPos) + x, DhSectionPos.getZ(startingBlockPos) + z);
+				DhLodPos blockColumnPos = new DhLodPos(LodUtil.BLOCK_DETAIL_LEVEL, startingBlockPos.x + x, startingBlockPos.z + z);
 				DhApiResult<DhApiTerrainDataPoint[]> result = getTerrainDataColumnArray(levelWrapper, blockColumnPos, null, dataCache);
 				if (result.success)
 				{
@@ -180,8 +175,8 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 	 */
 	private static DhApiResult<DhApiTerrainDataPoint[]> getTerrainDataColumnArray(
 			IDhApiLevelWrapper levelWrapper, 
-			long requestedColumnPos, Integer nullableBlockYPos, 
-			IDhApiTerrainDataCache apiDataCache)
+			DhLodPos requestedColumnPos, Integer nullableBlockYPos, 
+			@Nullable IDhApiTerrainDataCache apiDataCache)
 	{
 		//============//
 		// validation //
@@ -202,14 +197,9 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 		ILevelWrapper coreLevelWrapper = (ILevelWrapper) levelWrapper;
 		
 		
-		// require a data cache to prevent horrible performance (especially on ray-casts)
-		if (apiDataCache == null)
-		{
-			return DhApiResult.createFail("Missing [" + IDhApiTerrainDataCache.class.getSimpleName() + "], if a cache isn't provided your repo operations will be significantly slower.");
-		}
-		
-		// the data cache must be our own implementation
-		if (!(apiDataCache instanceof DhApiTerrainDataCache))
+		// the data cache can be null, but must be our own implementation
+		if (apiDataCache != null
+			&& !(apiDataCache instanceof DhApiTerrainDataCache))
 		{
 			return DhApiResult.createFail("Unsupported [" + IDhApiTerrainDataCache.class.getSimpleName() + "] implementation, only the core class [" + DhApiTerrainDataCache.class.getSimpleName() + "] is a valid parameter.");
 		}
@@ -223,12 +213,12 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 		}
 		
 		// get the detail levels for this request
-		byte requestedDetailLevel = DhSectionPos.getDetailLevel(requestedColumnPos);
+		byte requestedDetailLevel = requestedColumnPos.detailLevel;
 		byte sectionDetailLevel = (byte) (requestedDetailLevel + DhSectionPos.SECTION_MINIMUM_DETAIL_LEVEL);
 		
 		// get the positions for this request
-		long sectionPos = DhSectionPos.convertToDetailLevel(requestedColumnPos, sectionDetailLevel);
-		long relativePos = DhSectionPos.getDhSectionRelativePositionForDetailLevel(requestedColumnPos, DhSectionPos.getDetailLevel(requestedColumnPos));
+		long sectionPos = requestedColumnPos.getSectionPosWithSectionDetailLevel(sectionDetailLevel);
+		DhLodPos relativePos = requestedColumnPos.getDhSectionRelativePositionForDetailLevel();
 		
 		
 		
@@ -268,7 +258,7 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 			//===============================//
 			
 			FullDataPointIdMap mapping = dataSource.mapping;
-			LongArrayList dataColumn = dataSource.getColumnAtRelPos(DhSectionPos.getX(relativePos), DhSectionPos.getZ(relativePos));
+			LongArrayList dataColumn = dataSource.get(relativePos.x, relativePos.z);
 			if (dataColumn != null)
 			{
 				int dataColumnIndexCount = dataColumn.size();
@@ -287,7 +277,7 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 					if (!getSpecificYCoordinate)
 					{
 						// if we aren't look for a specific datapoint, add each datapoint to the return array
-						returnArray[i] = DhApiTerrainDataPointUtil.createApiDatapoint(levelWrapper.getMinHeight(), mapping, requestedDetailLevel, dataPoint);
+						returnArray[i] = DhApiTerrainDataPointUtil.createApiDatapoint(levelWrapper, mapping, requestedDetailLevel, dataPoint);
 					}
 					else
 					{
@@ -304,7 +294,7 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 							if (bottomY <= requestedY && requestedY < topY) // blockPositions start from the bottom of the block, thus "<=" for bottomY, just "<" for topY
 							{
 								// this datapoint contains the requested block position, return it
-								DhApiTerrainDataPoint apiTerrainData = DhApiTerrainDataPointUtil.createApiDatapoint(levelWrapper.getMinHeight(), mapping, requestedDetailLevel, dataPoint);
+								DhApiTerrainDataPoint apiTerrainData = DhApiTerrainDataPointUtil.createApiDatapoint(levelWrapper, mapping, requestedDetailLevel, dataPoint);
 								return DhApiResult.createSuccess(new DhApiTerrainDataPoint[]{apiTerrainData});
 							}
 						}
@@ -355,10 +345,7 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 			@Nullable
 			IDhApiTerrainDataCache dataCache)
 	{
-		return this.raycastLodData(levelWrapper, 
-				new Vec3d(rayOriginX, rayOriginY, rayOriginZ), 
-				new Vec3f(rayDirectionX, rayDirectionY, rayDirectionZ), 
-				maxRayBlockLength, dataCache);
+		return this.raycastLodData(levelWrapper, new Vec3d(rayOriginX, rayOriginY, rayOriginZ), new Vec3f(rayDirectionX, rayDirectionY, rayDirectionZ), maxRayBlockLength, dataCache);
 	}
 	
 	/**
@@ -376,8 +363,8 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 	{
 		rayDirection.normalize();
 		
-		int minLevelBlockHeight = levelWrapper.getMinHeight();
-		int maxLevelBlockHeight = levelWrapper.getMaxHeight();
+		int minBlockHeight = levelWrapper.getMinHeight();
+		int maxBlockHeight = levelWrapper.getMaxHeight();
 		
 		
 		
@@ -393,8 +380,7 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 		DhApiRaycastResult closetFoundDataPoint = null;
 		
 		
-		while (blockPos.y >= minLevelBlockHeight 
-				&& blockPos.y < maxLevelBlockHeight
+		while (blockPos.y >= minBlockHeight && blockPos.y < maxBlockHeight
 				&& currentLength <= maxRayBlockLength)
 		{
 			// get the LOD columns around this position
@@ -417,8 +403,7 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 					{
 						// does this LOD contain the given Y position?
 						Vec3i dataPointPos = new Vec3i(columnPos.x, dataPoint.bottomYBlockPos, columnPos.z);
-						if (exactPos.y >= dataPoint.bottomYBlockPos 
-							&& exactPos.y <= dataPoint.topYBlockPos)
+						if (exactPos.y >= dataPoint.bottomYBlockPos && exactPos.y <= dataPoint.topYBlockPos)
 						{
 							if (closetFoundDataPoint == null)
 							{
@@ -518,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());
+		SharedApi.INSTANCE.applyChunkUpdate(chunk, dhLevel.getLevelWrapper(), true);
 		
 		
 		return DhApiResult.createSuccess();
@@ -531,7 +516,7 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 	//=============//
 	
 	@Override
-	public IDhApiTerrainDataCache createSoftCache() { return new DhApiTerrainDataCache(); }
+	public IDhApiTerrainDataCache getSoftCache() { return new DhApiTerrainDataCache(); }
 	
 	
 	
@@ -551,10 +536,10 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 			Thread thread = new Thread(() -> {
 				try
 				{
-					DhApiResult<DhApiTerrainDataPoint> single = getTerrainDataAtBlockYPos(levelWrapper, DhSectionPos.encode(LodUtil.BLOCK_DETAIL_LEVEL, blockPosX, blockPosZ), blockPosY, debugDataCache);
-					DhApiResult<DhApiTerrainDataPoint[]> column = getTerrainDataColumnArray(levelWrapper, DhSectionPos.encode(LodUtil.BLOCK_DETAIL_LEVEL, blockPosX, blockPosZ), null, debugDataCache);
+					DhApiResult<DhApiTerrainDataPoint> single = getTerrainDataAtBlockYPos(levelWrapper, new DhLodPos(LodUtil.BLOCK_DETAIL_LEVEL, blockPosX, blockPosZ), blockPosY, debugDataCache);
+					DhApiResult<DhApiTerrainDataPoint[]> column = getTerrainDataColumnArray(levelWrapper, new DhLodPos(LodUtil.BLOCK_DETAIL_LEVEL, blockPosX, blockPosZ), null, debugDataCache);
 					
-					long chunkPos = DhSectionPos.encodeContaining(LodUtil.CHUNK_DETAIL_LEVEL, new DhChunkPos(blockPosX, blockPosZ));
+					DhLodPos chunkPos = new DhLodPos(LodUtil.BLOCK_DETAIL_LEVEL, blockPosX, blockPosZ).convertToDetailLevel(LodUtil.CHUNK_DETAIL_LEVEL);
 					DhApiResult<DhApiTerrainDataPoint[][][]> area = getTerrainDataOverAreaForPositionDetailLevel(levelWrapper, chunkPos, debugDataCache);
 					
 					
@@ -587,16 +572,12 @@ public class DhApiTerrainDataRepo implements IDhApiTerrainDataRepo
 					}
 					
 					// draw raycast position
-					if (rayCast.success 
-						&& rayCast.payload != null)
+					if (rayCast.success && rayCast.payload != null)
 					{
-						DEBUG_RENDERER.makeParticle(
-							new AbstractDebugWireframeRenderer.BoxParticle(
-								new AbstractDebugWireframeRenderer.Box(
-									DhSectionPos.encode((byte) 0, rayCast.payload.pos.x, rayCast.payload.pos.z), 
-										rayCast.payload.dataPoint.bottomYBlockPos, 
-										rayCast.payload.dataPoint.topYBlockPos, 
-										-0.1f, Color.RED),
+						DebugRenderer.makeParticle(
+							new DebugRenderer.BoxParticle(
+								new DebugRenderer.Box(
+									DhSectionPos.encode((byte) 0, rayCast.payload.pos.x, rayCast.payload.pos.z), rayCast.payload.dataPoint.bottomYBlockPos, rayCast.payload.dataPoint.topYBlockPos, -0.1f, Color.RED),
 							1.0, 0f
 							)
 						);
@@ -23,27 +23,17 @@ import com.seibel.distanthorizons.api.DhApi;
 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.core.api.internal.rendering.DhRenderState;
-import com.seibel.distanthorizons.core.enums.MinecraftTextFormat;
+import com.seibel.distanthorizons.api.methods.events.sharedParameterObjects.DhApiRenderParam;
 import com.seibel.distanthorizons.core.file.structure.ClientOnlySaveStructure;
-import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
-import com.seibel.distanthorizons.core.logging.f3.F3Screen;
 import com.seibel.distanthorizons.core.network.messages.MessageRegistry;
 import com.seibel.distanthorizons.core.pos.DhChunkPos;
 import com.seibel.distanthorizons.core.render.DhApiRenderProxy;
-import com.seibel.distanthorizons.core.render.RenderParams;
-import com.seibel.distanthorizons.core.render.RenderThreadTaskHandler;
-import com.seibel.distanthorizons.core.render.renderer.*;
+import com.seibel.distanthorizons.core.render.renderer.FadeRenderer;
 import com.seibel.distanthorizons.core.util.TimerUtil;
-import com.seibel.distanthorizons.core.util.math.Vec3d;
 import com.seibel.distanthorizons.core.util.objects.Pair;
-import com.seibel.distanthorizons.core.util.objects.RollingAverage;
-import com.seibel.distanthorizons.core.util.threading.ThreadPoolUtil;
 import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftRenderWrapper;
-import com.seibel.distanthorizons.core.wrapperInterfaces.render.renderPass.IDhMetaRenderer;
-import com.seibel.distanthorizons.core.wrapperInterfaces.render.renderPass.IDhVanillaFadeRenderer;
-import com.seibel.distanthorizons.core.wrapperInterfaces.render.renderPass.IDhTestTriangleRenderer;
 import com.seibel.distanthorizons.coreapi.DependencyInjection.ApiEventInjector;
+import com.seibel.distanthorizons.core.level.IDhClientLevel;
 import com.seibel.distanthorizons.core.config.Config;
 import com.seibel.distanthorizons.core.network.messages.AbstractNetworkMessage;
 import com.seibel.distanthorizons.core.network.session.NetworkSession;
@@ -52,22 +42,30 @@ import com.seibel.distanthorizons.api.enums.rendering.EDhApiDebugRendering;
 import com.seibel.distanthorizons.api.enums.rendering.EDhApiRendererMode;
 import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
 import com.seibel.distanthorizons.core.level.IServerKeyedClientLevel;
+import com.seibel.distanthorizons.core.logging.ConfigBasedLogger;
+import com.seibel.distanthorizons.core.logging.ConfigBasedSpamLogger;
+import com.seibel.distanthorizons.core.logging.SpamReducedLogger;
+import com.seibel.distanthorizons.core.util.math.Mat4f;
+import com.seibel.distanthorizons.core.render.glObject.GLProxy;
+import com.seibel.distanthorizons.core.render.renderer.TestRenderer;
+import com.seibel.distanthorizons.core.util.RenderUtil;
 import com.seibel.distanthorizons.core.world.AbstractDhWorld;
+import com.seibel.distanthorizons.core.world.DhClientServerWorld;
 import com.seibel.distanthorizons.core.world.DhClientWorld;
+import com.seibel.distanthorizons.core.world.IDhClientWorld;
 import com.seibel.distanthorizons.core.wrapperInterfaces.chunk.IChunkWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftClientWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IProfilerWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.world.IClientLevelWrapper;
-import com.seibel.distanthorizons.core.logging.DhLogger;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
 import org.lwjgl.glfw.GLFW;

 import java.io.File;
 import java.util.*;
 import java.util.concurrent.LinkedBlockingQueue;
-import java.util.concurrent.RejectedExecutionException;
-import java.util.concurrent.ThreadPoolExecutor;
+import java.util.concurrent.TimeUnit;

 /**
 * This holds the methods that should be called
@@ -76,14 +74,18 @@ import java.util.concurrent.ThreadPoolExecutor;
 */
 public class ClientApi
 {
-	private static final DhLogger LOGGER = new DhLoggerBuilder().build();
-	private static final DhLogger RATE_LIMITED_LOGGER = new DhLoggerBuilder().maxCountPerSecond(1).build();
+	private static final Logger LOGGER = LogManager.getLogger();
+	
+	public static boolean prefLoggerEnabled = false;
 	
 	public static final ClientApi INSTANCE = new ClientApi();
+	public static final TestRenderer TEST_RENDERER = new TestRenderer();
 	
 	private static final IMinecraftClientWrapper MC_CLIENT = SingletonInjector.INSTANCE.get(IMinecraftClientWrapper.class);
 	private static final IMinecraftRenderWrapper MC_RENDER = SingletonInjector.INSTANCE.get(IMinecraftRenderWrapper.class);
 	
+	public static final long SPAM_LOGGER_FLUSH_NS = TimeUnit.NANOSECONDS.convert(1, TimeUnit.SECONDS);
+	
 	/** this includes the is dev build message and low allocated memory warning */
 	private static final int MS_BETWEEN_STATIC_STARTUP_MESSAGES = 4_000;
 	
@@ -95,20 +97,14 @@ public class ClientApi
 	 * 
 	 * Only downside is making sure each variable is populated before rendering.
 	 */
-	public static final DhRenderState RENDER_STATE = new DhRenderState();
-	
-	/**
-	 * 50ms = 20 FPS
-	 * @link https://fpstoms.com/ 
-	 * @see ClientApi#cameraSpeedRollingAverage
-	 */
-	private static final long MIN_MS_BETWEEN_SPEED_CHECKS = 50;
+	public static final RenderState RENDER_STATE = new RenderState();
 	
 	
 	private boolean isDevBuildMessagePrinted = false;
 	private boolean lowMemoryWarningPrinted = false;
 	private boolean highVanillaRenderDistanceWarningPrinted = false;
 	
+	/** when the last static */
 	private long lastStaticWarningMessageSentMsTime = 0L;
 	
 	private final Queue<String> chatMessageQueueForNextFrame = new LinkedBlockingQueue<>();
@@ -116,6 +112,8 @@ public class ClientApi
 	
 	public boolean rendererDisabledBecauseOfExceptions = false;
 	
+	private long lastFlushNanoTime = 0;
+	
 	private final ClientPluginChannelApi pluginChannelApi = new ClientPluginChannelApi(this::clientLevelLoadEvent, this::clientLevelUnloadEvent);
 	
 	/** Delay loading the first level to give the server some time to respond with level to actually load */
@@ -127,25 +125,8 @@ public class ClientApi
 	/** Holds any chunks that were loaded before the {@link ClientApi#clientLevelLoadEvent(IClientLevelWrapper)} was fired. */
 	public final HashMap<Pair<IClientLevelWrapper, DhChunkPos>, IChunkWrapper> waitingChunkByClientLevelAndPos = new HashMap<>();
 	
-	/** publicly available so {@link F3Screen} can display the error */
-	@Nullable
-	public String lastRenderParamValidationMessage = null;
-	
-	
-	/** 
-	 * measured in blocks/second <br>
-	 * 
-	 * The number of points tracked here is related
-	 * to the rate at which we check for speed.
-	 * So if the ms_between is changed the number of points
-	 * tracked should also be to keep the ratio roughly the same.
-	 * @see ClientApi#MIN_MS_BETWEEN_SPEED_CHECKS
-	 */
-	public RollingAverage cameraSpeedRollingAverage = new RollingAverage(40);
-	private Vec3d lastCameraPosForSpeedCheck = new Vec3d();
-	private long msSinceLastSpeedCheck = 0L;
-	
-	public static long firstRenderTimeMs = 0;
+	/** re-set every frame during the opaque rendering stage */
+	private boolean renderingCancelledForThisFrame;
 	
 	
 	
@@ -160,7 +141,6 @@ public class ClientApi
 	//==============//
 	// world events //
 	//==============//
-	//region
 	
 	/**
 	 * May be fired slightly before or after the associated
@@ -186,16 +166,17 @@ public class ClientApi
 				
 				if (Config.Common.Logging.Warning.showReplayWarningOnStartup.get())
 				{
-					MC_CLIENT.sendChatMessage(MinecraftTextFormat.ORANGE + "Distant Horizons: Replay detected." + MinecraftTextFormat.CLEAR_FORMATTING);
+					MC_CLIENT.sendChatMessage("\u00A76" + "Distant Horizons: Replay detected." + "\u00A7r"); // gold color
 					MC_CLIENT.sendChatMessage("DH may behave strangely or have missing functionality.");
 					MC_CLIENT.sendChatMessage("In order to use pre-generated LODs, put your DH database(s) in:");
-					MC_CLIENT.sendChatMessage(MinecraftTextFormat.GRAY +".Minecraft" + File.separator + ClientOnlySaveStructure.SERVER_DATA_FOLDER_NAME + File.separator + ClientOnlySaveStructure.REPLAY_SERVER_FOLDER_NAME + File.separator + "DIMENSION_NAME"+ MinecraftTextFormat.CLEAR_FORMATTING);
-					MC_CLIENT.sendChatMessage("This message can be disabled in DH's config under Advanced -> Logging.");
+					MC_CLIENT.sendChatMessage("\u00A77"+".Minecraft" + File.separator + ClientOnlySaveStructure.SERVER_DATA_FOLDER_NAME + File.separator + ClientOnlySaveStructure.REPLAY_SERVER_FOLDER_NAME + File.separator + "DIMENSION_NAME"+"\u00A7r"); // light gray color
+					MC_CLIENT.sendChatMessage("This can be disabled in DH's config under Advanced -> Logging.");
 					MC_CLIENT.sendChatMessage("");
 				}
 			}
 			
-			
+			// firing after clientLevelLoadEvent
+			// TODO if level has prepped to load it should fire level load event
 			DhClientWorld world = new DhClientWorld();
 			SharedApi.setDhWorld(world);
 			
@@ -238,14 +219,11 @@ public class ClientApi
 		this.waitingClientLevels.clear();
 	}
 	
-	//endregion
-	
 	
 	
 	//==============//
 	// level events //
 	//==============//
-	//region
 	
 	public void clientLevelUnloadEvent(IClientLevelWrapper level)
 	{
@@ -262,6 +240,7 @@ public class ClientApi
 			if (world != null)
 			{
 				world.unloadLevel(level);
+				SharedApi.INSTANCE.clearQueuedChunkUpdates();
 				ApiEventInjector.INSTANCE.fireAllEvents(DhApiLevelUnloadEvent.class, new DhApiLevelUnloadEvent.EventParam(level));
 			}
 			else
@@ -276,15 +255,8 @@ public class ClientApi
 		}
 	}
 	
-	public void clientLevelLoadEvent(@Nullable IClientLevelWrapper levelWrapper)
+	public void clientLevelLoadEvent(IClientLevelWrapper levelWrapper)
 	{
-		// can happen if there was an issue during level load
-		if (levelWrapper == null)
-		{
-			return;
-		}
-		
-		
 		// wait a moment before loading the level to give the server a chance to handle the client's login request
 		if (MC_CLIENT.clientConnectedToDedicatedServer())
 		{
@@ -345,7 +317,7 @@ public class ClientApi
 			if (levelWrapper.equals(level))
 			{
 				IChunkWrapper chunkWrapper = this.waitingChunkByClientLevelAndPos.get(levelChunkPair);
-				SharedApi.INSTANCE.applyChunkUpdate(chunkWrapper, levelWrapper);
+				SharedApi.INSTANCE.chunkLoadEvent(chunkWrapper, levelWrapper);
 				keysToRemove.add(levelChunkPair);
 			}
 		}
@@ -357,14 +329,54 @@ public class ClientApi
 		}
 	}
 	
-	//endregion
+	
+	
+	//===============//
+	// render events //
+	//===============//
+	
+	public void clientTickEvent()
+	{
+		IProfilerWrapper profiler = MC_CLIENT.getProfiler();
+		profiler.push("DH-ClientTick");
+		
+		try
+		{
+			boolean doFlush = System.nanoTime() - this.lastFlushNanoTime >= SPAM_LOGGER_FLUSH_NS;
+			if (doFlush)
+			{
+				this.lastFlushNanoTime = System.nanoTime();
+				SpamReducedLogger.flushAll();
+			}
+			ConfigBasedLogger.updateAll();
+			ConfigBasedSpamLogger.updateAll(doFlush);
+			
+			IDhClientWorld clientWorld = SharedApi.getIDhClientWorld();
+			if (clientWorld != null)
+			{
+				clientWorld.clientTick();
+				
+				// Ignore local world gen, as it's managed by server ticking
+				if (!(clientWorld instanceof DhClientServerWorld))
+				{
+					SharedApi.worldGenTick(clientWorld::worldGenTick);
+				}
+			}
+		}
+		catch (Exception e)
+		{
+			// handle errors here to prevent blowing up a mixin or API up stream
+			LOGGER.error("Unexpected error in ClientApi.clientTickEvent(), error: "+e.getMessage(), e);
+		}
+		
+		profiler.pop();
+	}
 	
 	
 	
 	//============//
 	// networking //
 	//============//
-	//region
 	
 	/**
 	 * Forwards a decoded message into the registered handlers.
@@ -373,194 +385,119 @@ public class ClientApi
 	 */
 	public void pluginMessageReceived(@NotNull AbstractNetworkMessage message)
 	{
-		@Nullable ThreadPoolExecutor executor = ThreadPoolUtil.networkClientHandlerExecutor();
-		if (executor == null)
+		NetworkSession networkSession = this.pluginChannelApi.networkSession;
+		if (networkSession != null)
 		{
-			LOGGER.warn("warn");
-			return;
-		}
-		
-		try
-		{
-			executor.execute(() ->
-			{
-				NetworkSession networkSession = this.pluginChannelApi.networkSession;
-				if (networkSession != null)
-				{
-					networkSession.tryHandleMessage(message);
-				}
-			});
-		}
-		catch (RejectedExecutionException e)
-		{
-			LOGGER.warn("Plugin message executor rejected");
+			networkSession.tryHandleMessage(message);
 		}
 	}
 	
-	//endregion
 	
 	
-	
-	//===============//
-	// LOD rendering //
-	//===============//
-	//region
+	//===========//
+	// rendering //
+	//===========//
 	
 	/** Should be called before {@link ClientApi#renderDeferredLodsForShaders} */
-	public void renderLods() { this.renderLodLayer(false); }
+	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 renderDeferredLodsForShaders(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)
 	{
+		// logging //
+		
+		this.sendQueuedChatMessages();
+		
 		IProfilerWrapper profiler = MC_CLIENT.getProfiler();
-		try (IProfilerWrapper.IProfileBlock dhRender_profile = profiler.push("DH-RenderLevel"))
+		profiler.pop(); // get out of "terrain"
+		profiler.push("DH-RenderLevel");
+		
+		
+		
+		// render parameter setup //
+		
+		EDhApiRenderPass renderPass;
+		if (DhApiRenderProxy.INSTANCE.getDeferTransparentRendering())
 		{
-			
-			
-			
-			//===========//
-			// debugging //
-			//===========//
-			//region
-			
-			//DhApiTerrainDataRepo.asyncDebugMethod(
-			//	RENDER_STATE.clientLevelWrapper,
-			//	MC_CLIENT.getPlayerBlockPos().getX(),
-			//	MC_CLIENT.getPlayerBlockPos().getY(),
-			//	MC_CLIENT.getPlayerBlockPos().getZ()
-			//);
-			
-			//endregion
-			
-			
-			
-			//=====================//
-			// render thread tasks //
-			//=====================//
-			//region
-			
-			// only run these tasks once per frame
-			if (!renderingDeferredLayer)
+			if (renderingDeferredLayer)
 			{
-				try (IProfilerWrapper.IProfileBlock renderTask_profile = profiler.push("DH render thread tasks"))
-				{
-					//===============//
-					// chat messages //
-					//===============//
-					
-					this.sendQueuedChatMessages();
-					
-					
-					
-					//======================//
-					// GL Proxy queued jobs //
-					//======================//
-					//region
-					
-					try
-					{
-						// these tasks always need to be called, regardless of whether the renderer is enabled or not to prevent memory leaks
-						RenderThreadTaskHandler.INSTANCE.runRenderThreadTasks();
-					}
-					catch (Exception e)
-					{
-						LOGGER.error("Unexpected issue running render thread tasks, error: [" + e.getMessage() + "].", e);
-					}
-					
-					//endregion
-					
-					
-					
-					//==============//
-					// camera speed //
-					//==============//
-					//region
-					
-					long nowMs = System.currentTimeMillis();
-					if (this.msSinceLastSpeedCheck + MIN_MS_BETWEEN_SPEED_CHECKS < nowMs)
-					{
-						// calc time since last check
-						double secSinceLastCheck = (nowMs - this.msSinceLastSpeedCheck) / 1_000.0;
-						this.msSinceLastSpeedCheck = nowMs;
-						
-						// get the distance traveled since last frame
-						Vec3d camPos = MC_RENDER.getCameraExactPosition();
-						double distanceInBlocks = camPos.getDistance(this.lastCameraPosForSpeedCheck);
-						double speed = distanceInBlocks / secSinceLastCheck;
-						
-						// record new values for next check
-						this.cameraSpeedRollingAverage.add(speed);
-						this.lastCameraPosForSpeedCheck = camPos;
-					}
-					
-					//endregion
-				}
-			}
-			
-			//endregion
-			
-			
-			
-			
-			//=================//
-			// parameter setup //
-			//=================//
-			//region
-			
-			EDhApiRenderPass renderPass;
-			if (DhApiRenderProxy.INSTANCE.getDeferTransparentRendering())
-			{
-				if (renderingDeferredLayer)
-				{
-					renderPass = EDhApiRenderPass.TRANSPARENT;
-				}
-				else
-				{
-					renderPass = EDhApiRenderPass.OPAQUE;
-				}
+				renderPass = EDhApiRenderPass.TRANSPARENT;
 			}
 			else
 			{
-				renderPass = EDhApiRenderPass.OPAQUE_AND_TRANSPARENT;
+				renderPass = EDhApiRenderPass.OPAQUE;
 			}
-			
-			// 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
-			RenderParams renderParams = new RenderParams(renderPass, RENDER_STATE);
-			
-			//endregion
-			
-			
-			
-			//============//
-			// validation //
-			//============//
-			//region
-			
-			if (firstRenderTimeMs == 0)
+		}
+		else
+		{
+			renderPass = EDhApiRenderPass.OPAQUE_AND_TRANSPARENT;
+		}
+		
+		DhApiRenderParam renderEventParam =
+				new DhApiRenderParam(
+						renderPass,
+						partialTicks,
+						RenderUtil.getNearClipPlaneDistanceInBlocks(partialTicks), RenderUtil.getFarClipPlaneDistanceInBlocks(),
+						mcProjectionMatrix, mcModelViewMatrix,
+						RenderUtil.createLodProjectionMatrix(mcProjectionMatrix, partialTicks), RenderUtil.createLodModelViewMatrix(mcModelViewMatrix),
+						levelWrapper.getMinHeight()
+				);
+		
+		
+		
+		//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
+		{
+			// TODO write this message to the F3 menu so people can see when a different mod screws with the lightmap
+			String reasonLodsCannotRender = RenderUtil.shouldLodsRender(levelWrapper, renderEventParam);
+			if (reasonLodsCannotRender != null)
 			{
-				firstRenderTimeMs = System.currentTimeMillis();
-			}
-			
-			String validationMessage = renderParams.getValidationErrorMessage(firstRenderTimeMs);
-			if (validationMessage != null)
-			{
-				// store the error message so it can be seen on the F3 screen
-				this.lastRenderParamValidationMessage = validationMessage;
 				return;
 			}
-			else
+			
+			IDhClientWorld dhClientWorld = SharedApi.getIDhClientWorld();
+			if (dhClientWorld == null)
 			{
-				this.lastRenderParamValidationMessage = null;
+				return;
 			}
 			
+			IDhClientLevel level = (IDhClientLevel) dhClientWorld.getLevel(levelWrapper);
+			if (level == null)
+			{
+				return;
+			}
+			
+			
 			if (this.rendererDisabledBecauseOfExceptions)
 			{
 				// re-enable rendering if the user toggles DH rendering
@@ -574,170 +511,108 @@ public class ClientApi
 				return;
 			}
 			
-			if (Config.Client.Advanced.Debugging.rendererMode.get() == EDhApiRendererMode.DISABLED)
+			
+			
+			// render pass //
+			
+			if (!renderingDeferredLayer)
 			{
-				return;
-			}
-			
-			//endregion
-			
-			
-			
-			//===========//
-			// rendering //
-			//===========//
-			//region
-			
-			try
-			{
-				// render pass //
 				if (Config.Client.Advanced.Debugging.rendererMode.get() == EDhApiRendererMode.DEFAULT)
 				{
-					if (!renderingDeferredLayer)
+					this.renderingCancelledForThisFrame = ApiEventInjector.INSTANCE.fireAllEvents(DhApiBeforeRenderEvent.class, renderEventParam);
+					if (!this.renderingCancelledForThisFrame)
 					{
-						boolean renderingCancelled = ApiEventInjector.INSTANCE.fireAllEvents(DhApiBeforeRenderEvent.class, renderParams);
-						if (!renderingCancelled)
-						{
-							LodRenderer.INSTANCE.render(renderParams, profiler);
-						}
-						
-						if (!DhApi.Delayed.renderProxy.getDeferTransparentRendering())
-						{
-							ApiEventInjector.INSTANCE.fireAllEvents(DhApiAfterRenderEvent.class, null);
-						}
+						level.render(renderEventParam, profiler);
 					}
-					else
+					
+					if (!DhApi.Delayed.renderProxy.getDeferTransparentRendering())
 					{
-						boolean renderingCancelled = ApiEventInjector.INSTANCE.fireAllEvents(DhApiBeforeDeferredRenderEvent.class, renderParams);
-						if (!renderingCancelled)
-						{
-							LodRenderer.INSTANCE.renderDeferred(renderParams, profiler);
-						}
-						
-						
-						if (DhApi.Delayed.renderProxy.getDeferTransparentRendering())
-						{
-							ApiEventInjector.INSTANCE.fireAllEvents(DhApiAfterRenderEvent.class, null);
-						}
+						ApiEventInjector.INSTANCE.fireAllEvents(DhApiAfterRenderEvent.class, null);
 					}
 				}
-				else
+				else if (Config.Client.Advanced.Debugging.rendererMode.get() == EDhApiRendererMode.DEBUG)
 				{
-					if (!renderingDeferredLayer)
-					{
-						IDhMetaRenderer metaRenderer = SingletonInjector.INSTANCE.get(IDhMetaRenderer.class);
-						IDhTestTriangleRenderer testRenderer = SingletonInjector.INSTANCE.get(IDhTestTriangleRenderer.class);
-						if (testRenderer != null
-							&& metaRenderer != null)
-						{
-							// meta renderer needed for render state/texture
-							// for setup on some APIs (IE openGL)
-							metaRenderer.runRenderPassSetup(renderParams);
-							
-							testRenderer.render(renderParams);
-							
-							metaRenderer.runRenderPassCleanup(renderParams);
-						}
-						else
-						{
-							RATE_LIMITED_LOGGER.warn("Unable to find singleton [" + IDhTestTriangleRenderer.class.getSimpleName() + "]");
-						}
-					}
+					profiler.push("Render Debug");
+					ClientApi.TEST_RENDERER.render();
+					profiler.pop();
 				}
 			}
+			else
+			{
+				boolean renderingCancelled = ApiEventInjector.INSTANCE.fireAllEvents(DhApiBeforeDeferredRenderEvent.class, renderEventParam);
+				if (!renderingCancelled)
+				{
+					level.renderDeferred(renderEventParam, profiler);
+				}
+				
+				
+				if (DhApi.Delayed.renderProxy.getDeferTransparentRendering())
+				{
+					ApiEventInjector.INSTANCE.fireAllEvents(DhApiAfterRenderEvent.class, null);
+				}
+			}
+		}
+		catch (Exception e)
+		{
+			this.rendererDisabledBecauseOfExceptions = true;
+			LOGGER.error("Unexpected Renderer error in render pass [" + renderPass + "]. Error: " + e.getMessage(), e);
+			
+			MC_CLIENT.sendChatMessage("\u00A74\u00A7l\u00A7uERROR: Distant Horizons renderer has encountered an exception!");
+			MC_CLIENT.sendChatMessage("\u00A74Renderer disabled to try preventing GL state corruption.");
+			MC_CLIENT.sendChatMessage("\u00A74Toggle DH rendering via the config UI to re-activate DH rendering.");
+			MC_CLIENT.sendChatMessage("\u00A74Error: " + e);
+		}
+		finally
+		{
+			try
+			{
+				// these tasks always need to be called, regardless of whether the renderer is enabled or not to prevent memory leaks
+				GLProxy.getInstance().runRenderThreadTasks();
+			}
 			catch (Exception e)
 			{
-				this.rendererDisabledBecauseOfExceptions = true;
-				LOGGER.error("Unexpected Renderer error in render pass [" + renderPass + "]. Error: " + e.getMessage(), e);
-				
-				MC_CLIENT.sendChatMessage(MinecraftTextFormat.DARK_RED + "" + MinecraftTextFormat.BOLD + "ERROR: Distant Horizons renderer has encountered an exception!" + MinecraftTextFormat.CLEAR_FORMATTING);
-				MC_CLIENT.sendChatMessage(MinecraftTextFormat.DARK_RED + "Renderer disabled to try preventing GL state corruption." + MinecraftTextFormat.CLEAR_FORMATTING);
-				MC_CLIENT.sendChatMessage(MinecraftTextFormat.DARK_RED + "Toggle DH rendering via the config UI to re-activate DH rendering." + MinecraftTextFormat.CLEAR_FORMATTING);
-				MC_CLIENT.sendChatMessage(MinecraftTextFormat.DARK_RED + "Error: " + MinecraftTextFormat.CLEAR_FORMATTING + e);
+				LOGGER.error("Unexpected issue running render thread tasks.", e);
 			}
 			
-			//endregion
+			
+			profiler.pop(); // end LOD
+			profiler.push("terrain"); // go back into "terrain"
 		}
 	}
 	
-	//endregion
-	
-	
-	
-	//================//
-	// fade rendering //
-	//================//
-	//region
-	
-	/** 
-	 * The first fade pass.
-	 * Called after MC finishes rendering the opaque passes. 
-	 */
-	public void renderFadeOpaque()
+	/** 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)
 	{
-		IDhVanillaFadeRenderer fadeRenderer = SingletonInjector.INSTANCE.get(IDhVanillaFadeRenderer.class);
-		if (fadeRenderer == null)
-		{
-			return;
-		}
-		
 		// only fade when DH is rendering
-		if (Config.Client.Advanced.Debugging.rendererMode.get() != EDhApiRendererMode.DISABLED
-			&&
-			(
-				// only fade when requested
-				Config.Client.Advanced.Graphics.Quality.vanillaFadeMode.get() == EDhApiMcRenderingFadeMode.DOUBLE_PASS
-				// or if LOD-only mode is enabled (fading is used to remove the MC render pass)
-				|| Config.Client.Advanced.Debugging.lodOnlyMode.get()
-			)
+		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())
 		{
-			RenderParams renderParams = new RenderParams(EDhApiRenderPass.OPAQUE, RENDER_STATE);
-			fadeRenderer.render(renderParams);
+			FadeRenderer.INSTANCE.render(mcModelViewMatrix, mcProjectionMatrix, partialTicks, level);
 		}
 	}
-	/** 
-	 * 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 renderFade(Mat4f mcModelViewMatrix, Mat4f mcProjectionMatrix, float partialTicks, IClientLevelWrapper level)
 	{
-		IDhVanillaFadeRenderer fadeRenderer = SingletonInjector.INSTANCE.get(IDhVanillaFadeRenderer.class);
-		if (fadeRenderer == null)
-		{
-			return;
-		}
-		
 		// only fade when DH is rendering
-		if (Config.Client.Advanced.Debugging.rendererMode.get() != EDhApiRendererMode.DISABLED)
+		if (Config.Client.Advanced.Debugging.rendererMode.get() == EDhApiRendererMode.DEFAULT
+			// only fade when requested
+			&& Config.Client.Advanced.Graphics.Quality.vanillaFadeMode.get() != EDhApiMcRenderingFadeMode.NONE
+			// don't fade when Iris shaders are active, otherwise the rendering can get weird
+			&& !DhApiRenderProxy.INSTANCE.getDeferTransparentRendering())
 		{
-			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)
-			{
-				RenderParams renderParams = new RenderParams(EDhApiRenderPass.TRANSPARENT, RENDER_STATE);
-				fadeRenderer.render(renderParams);
-			}
+			FadeRenderer.INSTANCE.render(mcModelViewMatrix, mcProjectionMatrix, partialTicks, level);
 		}
 	}
 	
-	//endregion
 	
 	
 	
-	//==========//
-	// keyboard //
-	//==========//
-	//region
+	//=================//
+	//    DEBUG USE    //
+	//=================//
 	
 	/** Trigger once on key press, with CLIENT PLAYER. */
 	public void keyPressedEvent(int glfwKey)
@@ -749,32 +624,23 @@ public class ClientApi
 		}
 		
 		
-		if (glfwKey == GLFW.GLFW_KEY_F6)
+		if (glfwKey == GLFW.GLFW_KEY_F8)
+		{
+			Config.Client.Advanced.Debugging.debugRendering.set(EDhApiDebugRendering.next(Config.Client.Advanced.Debugging.debugRendering.get()));
+			MC_CLIENT.sendChatMessage("F8: Set debug mode to " + Config.Client.Advanced.Debugging.debugRendering.get());
+		}
+		else if (glfwKey == GLFW.GLFW_KEY_F6)
 		{
 			Config.Client.Advanced.Debugging.rendererMode.set(EDhApiRendererMode.next(Config.Client.Advanced.Debugging.rendererMode.get()));
 			MC_CLIENT.sendChatMessage("F6: Set rendering to " + Config.Client.Advanced.Debugging.rendererMode.get());
 		}
-		else if (glfwKey == GLFW.GLFW_KEY_F7)
+		else if (glfwKey == GLFW.GLFW_KEY_P)
 		{
-			Config.Client.Advanced.Debugging.lodOnlyMode.set(!Config.Client.Advanced.Debugging.lodOnlyMode.get());
-			MC_CLIENT.sendChatMessage("F7: Set LOD only mode to " + Config.Client.Advanced.Debugging.lodOnlyMode.get());
-		}
-		else if (glfwKey == GLFW.GLFW_KEY_F8)
-		{
-			Config.Client.Advanced.Debugging.debugRenderingColors.set(EDhApiDebugRendering.next(Config.Client.Advanced.Debugging.debugRenderingColors.get()));
-			MC_CLIENT.sendChatMessage("F8: Set debug mode to " + Config.Client.Advanced.Debugging.debugRenderingColors.get());
+			prefLoggerEnabled = !prefLoggerEnabled;
+			MC_CLIENT.sendChatMessage("P: Debug Pref Logger is " + (prefLoggerEnabled ? "enabled" : "disabled"));
 		}
 	}
 	
-	//endregion
-	
-	
-	
-	//======//
-	// chat //
-	//======//
-	//region
-	
 	private void sendQueuedChatMessages()
 	{
 		// this includes if the current build is a dev build
@@ -817,15 +683,15 @@ public class ClientApi
 	{
 		// dev build
 		if (ModInfo.IS_DEV_BUILD 
-			&& !this.isDevBuildMessagePrinted 
-			&& MC_CLIENT.playerExists())
+			&& !this.isDevBuildMessagePrinted && MC_CLIENT.playerExists())
 		{
 			this.isDevBuildMessagePrinted = true;
 			this.lastStaticWarningMessageSentMsTime = System.currentTimeMillis();
 			
 			// remind the user that this is a development build
 			String message =
-					MinecraftTextFormat.DARK_GREEN + "Distant Horizons: nightly/unstable build, version: [" + ModInfo.VERSION+"]." + MinecraftTextFormat.CLEAR_FORMATTING + "\n" +
+					// green text
+					"\u00A72" + "Distant Horizons: nightly/unstable build, version: [" + ModInfo.VERSION+"]." + "\u00A7r\n" +
 							"Issues may occur with this version.\n" +
 							"Here be dragons!\n";
 			MC_CLIENT.sendChatMessage(message);
@@ -849,7 +715,7 @@ public class ClientApi
 			{
 				String message =
 						// orange text		
-						MinecraftTextFormat.ORANGE + "Distant Horizons: Low memory detected." + MinecraftTextFormat.CLEAR_FORMATTING + "\n" +
+						"\u00A76" + "Distant Horizons: Low memory detected." + "\u00A7r \n" +
 						"Stuttering or low FPS may occur. \n" +
 						"Please increase Minecraft's available memory to 4 GB or more. \n" +
 						"This warning can be disabled in DH's config under Advanced -> Logging. \n";
@@ -863,21 +729,22 @@ public class ClientApi
 		if (!this.highVanillaRenderDistanceWarningPrinted 
 			&& Config.Common.Logging.Warning.showHighVanillaRenderDistanceWarning.get())
 		{
-			this.highVanillaRenderDistanceWarningPrinted = true;
-			
 			// DH generally doesn't need a vanilla render distance above 12 
 			if (MC_RENDER.getRenderDistance() > 12)
 			{
+				this.highVanillaRenderDistanceWarningPrinted = true;
 				this.lastStaticWarningMessageSentMsTime = System.currentTimeMillis();
 				
 				String message =
-					MinecraftTextFormat.YELLOW + "Distant Horizons: High vanilla render distance detected." + MinecraftTextFormat.CLEAR_FORMATTING + "\n" +
-					"Using a high vanilla render distance uses a lot of CPU power \n" +
-					"and doesn't improve graphics much after about 12.\n" +
-					"Lowering your vanilla render distance will give you better FPS\n" +
-					"and reduce stuttering at a similar visual quality.\n" +
-					MinecraftTextFormat.GRAY + "A vanilla render distance of 8 is recommended." + MinecraftTextFormat.CLEAR_FORMATTING + "\n" +
-					"This message can be disabled in DH's config under Advanced -> Logging.\n";
+						// yellow text
+						"\u00A7e" + "Distant Horizons: High vanilla render distance detected." + "\u00A7r \n" +
+						"Using a high vanilla render distance uses a lot of CPU power \n" +
+						"and doesn't improve graphics much after about 12.\n" +
+						"Lowing your vanilla render distance will give you better FPS\n" +
+						"and reduce stuttering at a similar visual quality.\n" +
+						// gray text		
+						"\u00A77" + "A vanilla render distance of 8 is recommended." + "\u00A7r \n" +
+						"This message can be disabled in DH's config under Advanced -> Logging.\n";
 				MC_CLIENT.sendChatMessage(message);
 			}
 		}
@@ -907,7 +774,46 @@ public class ClientApi
 	 */
 	public void showOverlayMessageNextFrame(String message) { this.overlayMessageQueueForNextFrame.add(message); }
 	
-	//endregion
+	
+	
+	//================//
+	// helper classes //
+	//================//
+	
+	public static class RenderState
+	{
+		public Mat4f mcModelViewMatrix = null;
+		public Mat4f mcProjectionMatrix = null;
+		public float frameTime = -1;
+		
+		
+		public void canRenderOrThrow() throws IllegalStateException
+		{
+			String errorReasons = "";
+			
+			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 (!errorReasons.isEmpty())
+			{
+				throw new IllegalStateException(errorReasons);
+			}
+			
+		}
+	}
 	
 	
 	
@@ -4,15 +4,14 @@ import com.seibel.distanthorizons.core.config.Config;
 import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
 import com.seibel.distanthorizons.core.level.IKeyedClientLevelManager;
 import com.seibel.distanthorizons.core.level.IServerKeyedClientLevel;
-import com.seibel.distanthorizons.core.logging.DhLogger;
-import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
+import com.seibel.distanthorizons.core.logging.ConfigBasedLogger;
 import com.seibel.distanthorizons.core.network.event.internal.CloseInternalEvent;
 import com.seibel.distanthorizons.core.network.messages.base.LevelInitMessage;
 import com.seibel.distanthorizons.core.network.session.NetworkSession;
-import com.seibel.distanthorizons.core.render.RenderThreadTaskHandler;
 import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftClientWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.world.IClientLevelWrapper;
-import org.jetbrains.annotations.NotNull;
+import org.apache.logging.log4j.LogManager;
+import org.checkerframework.checker.nullness.qual.NonNull;
 import org.jetbrains.annotations.Nullable;

 import java.util.Objects;
@@ -23,10 +22,8 @@ import java.util.function.Consumer;
 */
 public class ClientPluginChannelApi
 {
-	private static final DhLogger LOGGER = new DhLoggerBuilder()
-			.fileLevelConfig(Config.Common.Logging.logNetworkEventToFile)
-			.build();  
-			
+	private static final ConfigBasedLogger LOGGER = new ConfigBasedLogger(LogManager.getLogger(),
+			() -> Config.Common.Logging.logNetworkEvent.get());
 	private static final IMinecraftClientWrapper MC = SingletonInjector.INSTANCE.get(IMinecraftClientWrapper.class);
 	private static final IKeyedClientLevelManager KEYED_CLIENT_LEVEL_MANAGER = SingletonInjector.INSTANCE.get(IKeyedClientLevelManager.class);
 	
@@ -68,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;
@@ -78,19 +75,14 @@ public class ClientPluginChannelApi
 	
 	private void onLevelInitMessage(LevelInitMessage msg)
 	{
-		if (!msg.serverKey.isEmpty() && !msg.serverKey.matches(LevelInitMessage.SERVER_KEY_REGEX))
-		{
-			throw new IllegalArgumentException("Server sent invalid server key.");
-		}
-		
-		if (!msg.levelKey.matches(LevelInitMessage.LEVEL_KEY_REGEX))
+		if (!msg.levelKey.matches(LevelInitMessage.VALIDATION_REGEX))
 		{
 			throw new IllegalArgumentException("Server sent invalid level key.");
 		}
 		
 		LOGGER.info("Server level key received: [" + msg.levelKey + "].");
 		
-		RenderThreadTaskHandler.INSTANCE.queueRunningOnRenderThread("ClientPluginChannelApi onLevelInitMessage", () -> 
+		MC.executeOnRenderThread(() -> 
 		{
 			IClientLevelWrapper clientLevel = MC.getWrappedClientLevel(true);
 			IServerKeyedClientLevel existingKeyedClientLevel = KEYED_CLIENT_LEVEL_MANAGER.getServerKeyedLevel();
@@ -113,12 +105,10 @@ public class ClientPluginChannelApi
 				this.levelUnloadHandler.accept(clientLevel);
 			}
 			
-			if (existingKeyedClientLevel == null
-					|| !existingKeyedClientLevel.getServerKey().equals(msg.serverKey)
-					|| !existingKeyedClientLevel.getServerLevelKey().equals(msg.levelKey))
+			if (existingKeyedClientLevel == null || !existingKeyedClientLevel.getServerLevelKey().equals(msg.levelKey))
 			{
 				LOGGER.info("Loading level with key: [" + msg.levelKey + "].");
-				IServerKeyedClientLevel keyedLevel = KEYED_CLIENT_LEVEL_MANAGER.setServerKeyedLevel(clientLevel, msg.serverKey, msg.levelKey);
+				IServerKeyedClientLevel keyedLevel = KEYED_CLIENT_LEVEL_MANAGER.setServerKeyedLevel(clientLevel, msg.levelKey);
 				this.levelLoadHandler.accept(keyedLevel);
 			}
 		});
@@ -30,7 +30,7 @@ import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
 import com.seibel.distanthorizons.core.wrapperInterfaces.chunk.IChunkWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.world.ILevelWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.world.IServerLevelWrapper;
-import com.seibel.distanthorizons.core.logging.DhLogger;
+import org.apache.logging.log4j.Logger;
 import org.jetbrains.annotations.NotNull;

 /**
@@ -41,7 +41,7 @@ public class ServerApi
 {
 	public static final ServerApi INSTANCE = new ServerApi();
 	
-	private static final DhLogger LOGGER = new DhLoggerBuilder().build();
+	private static final Logger LOGGER = DhLoggerBuilder.getLogger();
 	
 	
 	
@@ -53,6 +53,30 @@ public class ServerApi
 	
 	
 	
+	//=============//
+	// tick events //
+	//=============//
+	
+	public void serverTickEvent()
+	{
+		try
+		{
+			IDhServerWorld serverWorld = SharedApi.getIDhServerWorld();
+			if (serverWorld != null)
+			{
+				serverWorld.serverTick();
+				SharedApi.worldGenTick(serverWorld::worldGenTick);
+			}
+		}
+		catch (Exception e)
+		{
+			// try catch is necessary to prevent crashing the internal server when an exception is thrown
+			LOGGER.error("ServerTickEvent error: " + e.getMessage(), e);
+		}
+	}
+	
+	
+	
 	//===============//
 	// server events //
 	//===============//
@@ -82,15 +106,15 @@ public class ServerApi
 	// level events //
 	//==============//
 	
-	public void serverLevelLoadEvent(IServerLevelWrapper levelWrapper)
+	public void serverLevelLoadEvent(IServerLevelWrapper level)
 	{
-		LOGGER.debug("Server Level " + levelWrapper + " loading");
+		LOGGER.debug("Server Level " + level + " loading");
 		
 		AbstractDhWorld serverWorld = SharedApi.getAbstractDhWorld();
 		if (serverWorld != null)
 		{
-			serverWorld.getOrLoadLevel(levelWrapper);
-			ApiEventInjector.INSTANCE.fireAllEvents(DhApiLevelLoadEvent.class, new DhApiLevelLoadEvent.EventParam(levelWrapper));
+			serverWorld.getOrLoadLevel(level);
+			ApiEventInjector.INSTANCE.fireAllEvents(DhApiLevelLoadEvent.class, new DhApiLevelLoadEvent.EventParam(level));
 		}
 	}
 	public void serverLevelUnloadEvent(IServerLevelWrapper level)
@@ -101,6 +125,7 @@ public class ServerApi
 		if (serverWorld != null)
 		{
 			serverWorld.unloadLevel(level);
+			SharedApi.INSTANCE.clearQueuedChunkUpdates();
 			ApiEventInjector.INSTANCE.fireAllEvents(DhApiLevelUnloadEvent.class, new DhApiLevelUnloadEvent.EventParam(level));
 		}
 	}
@@ -111,8 +136,8 @@ public class ServerApi
 	// chunk modified events //
 	//=======================//
 	
-	public void serverChunkLoadEvent(IChunkWrapper chunkWrapper, ILevelWrapper level) { SharedApi.INSTANCE.applyChunkUpdate(chunkWrapper, level); }
-	public void serverChunkSaveEvent(IChunkWrapper chunkWrapper, ILevelWrapper level) { SharedApi.INSTANCE.applyChunkUpdate(chunkWrapper, level); }
+	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); }
 	
 	
 	
@@ -127,7 +152,7 @@ public class ServerApi
 			return;
 		}
 		
-		IDhServerWorld serverWorld = SharedApi.tryGetDhServerWorld();
+		IDhServerWorld serverWorld = SharedApi.getIDhServerWorld();
 		LOGGER.info("Player ["+player.getName()+"] joined.");
 		if (serverWorld != null)
 		{
@@ -141,7 +166,7 @@ public class ServerApi
 			return;
 		}
 		
-		IDhServerWorld serverWorld = SharedApi.tryGetDhServerWorld();
+		IDhServerWorld serverWorld = SharedApi.getIDhServerWorld();
 		LOGGER.info("Player ["+player.getName()+"] disconnected.");
 		if (serverWorld != null)
 		{
@@ -155,7 +180,7 @@ public class ServerApi
 			return;
 		}
 		
-		IDhServerWorld serverWorld = SharedApi.tryGetDhServerWorld();
+		IDhServerWorld serverWorld = SharedApi.getIDhServerWorld();
 		LOGGER.info("Player ["+player.getName()+"] changed level: ["+originLevel.getKeyedLevelDimensionName()+"] -> ["+destinationLevel.getKeyedLevelDimensionName()+"].");
 		if (serverWorld != null)
 		{
@@ -175,7 +200,7 @@ public class ServerApi
 			return;
 		}
 		
-		IDhServerWorld serverWorld = SharedApi.tryGetDhServerWorld();
+		IDhServerWorld serverWorld = SharedApi.getIDhServerWorld();
 		if (serverWorld != null)
 		{
 			serverWorld.getServerPlayerStateManager().handlePluginMessage(player, message);
@@ -22,28 +22,30 @@ 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.api.internal.chunkUpdating.WorldChunkUpdateManager;
-import com.seibel.distanthorizons.core.config.eventHandlers.IgnoredDimensionCsvHandler;
+import com.seibel.distanthorizons.core.config.Config;
 import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
+import com.seibel.distanthorizons.core.generation.DhLightingEngine;
 import com.seibel.distanthorizons.core.level.DhClientLevel;
 import com.seibel.distanthorizons.core.level.IDhLevel;
 import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
+import com.seibel.distanthorizons.core.logging.f3.F3Screen;
 import com.seibel.distanthorizons.core.pos.blockPos.DhBlockPos2D;
 import com.seibel.distanthorizons.core.pos.DhChunkPos;
-import com.seibel.distanthorizons.core.render.RenderThreadTaskHandler;
-import com.seibel.distanthorizons.core.render.renderer.AbstractDebugWireframeRenderer;
+import com.seibel.distanthorizons.core.render.renderer.DebugRenderer;
 import com.seibel.distanthorizons.core.sql.repo.AbstractDhRepo;
+import com.seibel.distanthorizons.core.util.LodUtil;
 import com.seibel.distanthorizons.core.util.objects.Pair;
+import com.seibel.distanthorizons.core.util.threading.PriorityTaskPicker;
 import com.seibel.distanthorizons.core.util.threading.ThreadPoolUtil;
 import com.seibel.distanthorizons.core.world.*;
 import com.seibel.distanthorizons.core.wrapperInterfaces.chunk.IChunkWrapper;
+import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftClientWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftRenderWrapper;
+import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftSharedWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.world.IClientLevelWrapper;
 import com.seibel.distanthorizons.core.wrapperInterfaces.world.ILevelWrapper;
 import com.seibel.distanthorizons.coreapi.DependencyInjection.ApiEventInjector;
-import com.seibel.distanthorizons.core.logging.DhLogger;
+import org.apache.logging.log4j.Logger;
 import org.jetbrains.annotations.Nullable;

 import java.util.*;
@@ -54,142 +56,144 @@ public class SharedApi
 {
 	public static final SharedApi INSTANCE = new SharedApi();
 	
-	private static final DhLogger LOGGER = new DhLoggerBuilder().build();
+	private static final Logger LOGGER = DhLoggerBuilder.getLogger();
 	/** will be null on the server-side */
 	@Nullable
 	private static final IMinecraftRenderWrapper MC_RENDER = SingletonInjector.INSTANCE.get(IMinecraftRenderWrapper.class);
-	
-	public static final WorldChunkUpdateManager WORLD_CHUNK_UPDATE_MANAGER = WorldChunkUpdateManager.INSTANCE; // local fariable for quick access
-	
-	
+	/** will be null on the server-side */
 	@Nullable
+	private static final IMinecraftClientWrapper MC_CLIENT = SingletonInjector.INSTANCE.get(IMinecraftClientWrapper.class);
+	private static final IMinecraftSharedWrapper MC_SHARED = SingletonInjector.INSTANCE.get(IMinecraftSharedWrapper.class);
+	
+	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 
+	 */
+	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 */
+	private static final int MIN_MS_BETWEEN_OVERLOADED_LOG_MESSAGE = 30_000;
+	
+	
 	private static AbstractDhWorld currentWorld;
-	private static final Object worldLockObject = new Object();
+	private static int lastWorldGenTickDelta = 0;
+	private static long lastOverloadedLogMessageMsTime = 0;
 	
 	
 	
 	//=============//
 	// constructor //
 	//=============//
-	//region
 	
 	private SharedApi() { }
 	public static void init() { Initializer.init(); }
 	
-	//endregion
-	
 	
 	
 	//===============//
 	// world methods //
 	//===============//
-	//region
 	
 	public static EWorldEnvironment getEnvironment() { return (currentWorld == null) ? null : currentWorld.environment; }
 	
 	public static void setDhWorld(AbstractDhWorld newWorld)
 	{
-		synchronized (worldLockObject)
+		AbstractDhWorld oldWorld = currentWorld;
+		if (oldWorld != null)
 		{
-			AbstractDhWorld oldWorld = currentWorld;
-			if (oldWorld != null)
-			{
-				oldWorld.close();
-			}
-			currentWorld = newWorld;
+			oldWorld.close();
+		}
+		currentWorld = newWorld;
+		
+		// starting and stopping the DataRenderTransformer is necessary to prevent attempting to
+		// access the MC level at inappropriate times, which can cause exceptions
+		if (currentWorld != null)
+		{
+			ThreadPoolUtil.setupThreadPools();
 			
-			// starting and stopping the DataRenderTransformer is necessary to prevent attempting to
-			// access the MC level at inappropriate times, which can cause exceptions
-			if (currentWorld != null)
+			ApiEventInjector.INSTANCE.fireAllEvents(DhApiWorldLoadEvent.class, new DhApiWorldLoadEvent.EventParam());
+		}
+		else
+		{
+			ThreadPoolUtil.shutdownThreadPools();
+			DebugRenderer.clearRenderables();
+			
+			if (MC_RENDER != null)
 			{
-				ThreadPoolUtil.setupThreadPools();
-				
-				ApiEventInjector.INSTANCE.fireAllEvents(DhApiWorldLoadEvent.class, new DhApiWorldLoadEvent.EventParam());
-			}
-			else
-			{
-				ThreadPoolUtil.shutdownThreadPools();
-				
-				// delayed get because SharedApi will be created before the singleton has been bound 
-				AbstractDebugWireframeRenderer debugWireframeRenderer = SingletonInjector.INSTANCE.get(AbstractDebugWireframeRenderer.class);
-				debugWireframeRenderer.clearRenderables();
-				
-				if (MC_RENDER != null)
-				{
-					MC_RENDER.clearTargetFrameBuffer();
-				}
-				
-				// 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
-				WORLD_CHUNK_UPDATE_MANAGER.clear();
-				
-				RenderThreadTaskHandler.INSTANCE.clearDebugStats();
-				
-				// recommend that the garbage collector cleans up any objects from the old world and thread pools
-				System.gc();
-				
-				ApiEventInjector.INSTANCE.fireAllEvents(DhApiWorldUnloadEvent.class, new DhApiWorldUnloadEvent.EventParam());
-				
-				// fired after the unload event so API users can't change the read-only for any new worlds
-				DhApiWorldProxy.INSTANCE.setReadOnly(false, false);
+				MC_RENDER.clearTargetFrameBuffer();
 			}
+			
+			// 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
+			UPDATE_POS_MANAGER.clear();
+			
+			// recommend that the garbage collector cleans up any objects from the old world and thread pools
+			System.gc();
+			
+			ApiEventInjector.INSTANCE.fireAllEvents(DhApiWorldUnloadEvent.class, new DhApiWorldUnloadEvent.EventParam());
+			
+			// fired after the unload event so API users can't change the read-only for any new worlds
+			DhApiWorldProxy.INSTANCE.setReadOnly(false, false);
+		}
+	}
+	
+	public static void worldGenTick(Runnable worldGenRunnable)
+	{
+		lastWorldGenTickDelta--;
+		if (lastWorldGenTickDelta <= 0)
+		{
+			worldGenRunnable.run();
+			lastWorldGenTickDelta = 20;
 		}
 	}
 	
-	@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; }
 	/** returns null if the {@link SharedApi#currentWorld} isn't a {@link DhClientWorld} or {@link DhClientServerWorld} */
-	@Nullable
-	public static IDhClientWorld tryGetDhClientWorld() { return (currentWorld instanceof IDhClientWorld) ? (IDhClientWorld) currentWorld : null; }
-	
+	public static IDhClientWorld getIDhClientWorld() { return (currentWorld instanceof IDhClientWorld) ? (IDhClientWorld) currentWorld : null; }
 	/** returns null if the {@link SharedApi#currentWorld} isn't a {@link DhServerWorld} or {@link DhClientServerWorld} */
-	@Nullable
-	public static IDhServerWorld tryGetDhServerWorld() { return (currentWorld instanceof IDhServerWorld) ? (IDhServerWorld) currentWorld : null; }
-	
-	//endregion
+	public static IDhServerWorld getIDhServerWorld() { return (currentWorld instanceof IDhServerWorld) ? (IDhServerWorld) currentWorld : null; }
 	
 	
 	
 	//==============//
 	// chunk update //
 	//==============//
-	//region
 	
 	/** 
 	 * Used to prevent getting a full chunk from MC if it isn't necessary. <br>
 	 * This is important since asking MC for a chunk is slow and may block the render thread.
 	 */
-	public static boolean isChunkAtBlockPosAlreadyUpdating(ILevelWrapper levelWrapper, int blockPosX, int blockPosZ)
+	public static boolean isChunkAtBlockPosAlreadyUpdating(int blockPosX, int blockPosZ)
+	{ return UPDATE_POS_MANAGER.contains(new DhChunkPos(new DhBlockPos2D(blockPosX, blockPosZ))); }
+	
+	public static boolean isChunkAtChunkPosAlreadyUpdating(int chunkPosX, int chunkPosZ)
+	{ return UPDATE_POS_MANAGER.contains(new DhChunkPos(chunkPosX, chunkPosZ)); }
+	
+	/** 
+	 * This is often fired when unloading a level.
+	 * This is done to prevent overloading the system when
+	 * rapidly changing dimensions.
+	 * (IE prevent DH from infinitely allocating memory 
+	 */
+	public void clearQueuedChunkUpdates() { UPDATE_POS_MANAGER.clear(); }
+	
+	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); }
+	public void chunkLoadEvent(IChunkWrapper chunk, ILevelWrapper level) { this.applyChunkUpdate(chunk, level, false); }
+	
+	public void applyChunkUpdate(IChunkWrapper chunkWrapper, ILevelWrapper level, boolean updateNeighborChunks)
 	{
-		ChunkUpdateQueueManager manager = WORLD_CHUNK_UPDATE_MANAGER.getByLevelWrapper(levelWrapper);
-		if (manager == null)
-		{
-			return true;
-		}
-		
-		return manager.contains(new DhChunkPos(new DhBlockPos2D(blockPosX, blockPosZ))); 
-	}
-	
-	public static boolean isChunkAtChunkPosAlreadyUpdating(ILevelWrapper levelWrapper, int chunkPosX, int chunkPosZ)
-	{
-		ChunkUpdateQueueManager manager = WORLD_CHUNK_UPDATE_MANAGER.getByLevelWrapper(levelWrapper);
-		if (manager == null)
-		{
-			return true;
-		}
-		
-		return manager.contains(new DhChunkPos(chunkPosX, chunkPosZ)); 
-	}
-	
-	
-	
-	public void applyChunkUpdate(IChunkWrapper chunkWrapper, ILevelWrapper levelWrapper)
-	{
-		//===================//
-		// validation checks //
-		//===================//
+		//========================//
+		// world and level checks //
+		//========================//
 		
 		if (chunkWrapper == null)
 		{
@@ -200,12 +204,12 @@ public class SharedApi
 		AbstractDhWorld dhWorld = SharedApi.getAbstractDhWorld();
 		if (dhWorld == null)
 		{
-			if (levelWrapper instanceof IClientLevelWrapper)
+			if (level instanceof IClientLevelWrapper)
 			{
 				// If the client world isn't loaded yet, keep track of which chunks were loaded so we can use them later.
 				// This may happen if the client world and client level load events happen out of order
-				IClientLevelWrapper clientLevel = (IClientLevelWrapper) levelWrapper;
-				ClientApi.INSTANCE.waitingChunkByClientLevelAndPos.put(new Pair<>(clientLevel, chunkWrapper.getChunkPos()), chunkWrapper);
+				IClientLevelWrapper clientLevel = (IClientLevelWrapper) level;
+				ClientApi.INSTANCE.waitingChunkByClientLevelAndPos.replace(new Pair<>(clientLevel, chunkWrapper.getChunkPos()), chunkWrapper);
 			}
 			
 			return;
@@ -217,21 +221,21 @@ public class SharedApi
 			return;
 		}
 		
+		
 		// only continue if the level is loaded
-		IDhLevel dhLevel = dhWorld.getLevel(levelWrapper);
+		IDhLevel dhLevel = dhWorld.getLevel(level);
 		if (dhLevel == null)
 		{
-			if (levelWrapper instanceof IClientLevelWrapper)
+			if (level instanceof IClientLevelWrapper)
 			{
 				// the client level isn't loaded yet
-				IClientLevelWrapper clientLevel = (IClientLevelWrapper) levelWrapper;
-				ClientApi.INSTANCE.waitingChunkByClientLevelAndPos.put(new Pair<>(clientLevel, chunkWrapper.getChunkPos()), chunkWrapper);
+				IClientLevelWrapper clientLevel = (IClientLevelWrapper) level;
+				ClientApi.INSTANCE.waitingChunkByClientLevelAndPos.replace(new Pair<>(clientLevel, chunkWrapper.getChunkPos()), chunkWrapper);
 			}
 			
 			return;
 		}
 		
-		// ignore chunk updates if the network should handle them
 		if (dhLevel instanceof DhClientLevel)
 		{
 			if (!((DhClientLevel) dhLevel).shouldProcessChunkUpdate(chunkWrapper.getChunkPos()))
@@ -240,47 +244,128 @@ public class SharedApi
 			}
 		}
 		
-		// ignore chunk updates for non-rendered levels
-		String dimName = dhLevel.getLevelWrapper().getDimensionName();
-		if (IgnoredDimensionCsvHandler.INSTANCE.dimensionNameShouldBeIgnored(dimName))
-		{
-			return;
-		}
-		
-		ChunkUpdateQueueManager chunkManager = WORLD_CHUNK_UPDATE_MANAGER.getByLevelWrapper(levelWrapper);
-		// ignore the wrong level wrapper type or
-		// if the chunk is already queued for handling
-		if (chunkManager == null 
-			|| chunkManager.contains(chunkWrapper.getChunkPos()))
+		// shoudln't normally happen, but just in case
+		if (UPDATE_POS_MANAGER.contains(chunkWrapper.getChunkPos()))
 		{
+			// TODO this will prevent some LODs from updating across dimensions if multiple levels are loaded
 			return;
 		}
 		
 		
-		queueChunkUpdate(chunkManager, chunkWrapper, dhLevel);
+		
+		//===============================//
+		// update the necessary chunk(s) //
+		//===============================//
+		
+		if (!updateNeighborChunks)
+		{
+			// only update the center chunk
+			
+			queueChunkUpdate(chunkWrapper, null, dhLevel);
+		}
+		else
+		{
+			// update the center with any existing neighbour chunks. 
+			// this is done so lighting changes are propagated correctly
+			queueChunkUpdate(chunkWrapper, getNeighbourChunkListForChunk(chunkWrapper,dhLevel), dhLevel);
+		}
+	}
+	private static ArrayList<IChunkWrapper> getNeighbourChunkListForChunk(IChunkWrapper chunkWrapper, IDhLevel dhLevel)
+	{
+		// get the neighboring chunk list
+		ArrayList<IChunkWrapper> neighbourChunkList = new ArrayList<>(9);
+		for (int xOffset = -1; xOffset <= 1; xOffset++)
+		{
+			for (int zOffset = -1; zOffset <= 1; zOffset++)
+			{
+				if (xOffset == 0 && zOffset == 0)
+				{
+					// center chunk
+					neighbourChunkList.add(chunkWrapper);
+				}
+				else
+				{
+					// neighboring chunk
+					DhChunkPos neighbourPos = new DhChunkPos(chunkWrapper.getChunkPos().getX() + xOffset, chunkWrapper.getChunkPos().getZ() + zOffset);
+					IChunkWrapper neighbourChunk = dhLevel.getLevelWrapper().tryGetChunk(neighbourPos);
+					if (neighbourChunk != null)
+					{
+						neighbourChunkList.add(neighbourChunk);
+					}
+				}
+			}
+		}
+		return neighbourChunkList;
 	}
 	
-	private static void queueChunkUpdate(ChunkUpdateQueueManager chunkManager, IChunkWrapper chunkWrapper, IDhLevel dhLevel)
+	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 (chunkManager.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, dhLevel);
-		chunkManager.addItemToPreUpdateQueue(chunkWrapper.getChunkPos(), updateData);
 		
-		
-		// queue the next position if there are still positions to process
-		AbstractExecutorService executor = ThreadPoolUtil.getChunkToLodBuilderExecutor();
-		if (executor != null)
+		// queue updates up to the number of CPU cores allocated for the job
+		// (this prevents doing extra work queuing tasks that may not be necessary)
+		// and makes sure the chunks closest to the player are updated first
+		PriorityTaskPicker.Executor executor = ThreadPoolUtil.getChunkToLodBuilderExecutor();
+		if (executor != null && executor.getQueueSize() < executor.getPoolSize())
 		{
 			try
 			{
-				executor.execute(WORLD_CHUNK_UPDATE_MANAGER::processEachQueue);
+				executor.execute(SharedApi::processQueuedChunkUpdate);
 			}
 			catch (RejectedExecutionException ignore)
 			{
@@ -288,19 +373,260 @@ public class SharedApi
 			}
 		}
 	}
-	
-	//endregion
+	private static void processQueuedChunkUpdate()
+	{
+		//LOGGER.trace(chunkWrapper.getChunkPos() + " " + executor.getActiveCount() + " / " + executor.getQueue().size() + " - " + executor.getCompletedTaskCount());
+		
+		UpdateChunkData updateData = UPDATE_POS_MANAGER.popClosest();
+		if (updateData == null)
+		{
+			return;
+		}
+		
+		IChunkWrapper chunkWrapper = updateData.chunkWrapper;
+		@Nullable ArrayList<IChunkWrapper> neighbourChunkList = updateData.neighbourChunkList;
+		IDhLevel dhLevel = updateData.dhLevel;
+		
+		
+		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);
+			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
+				}
+			}
+		}
+	}
 	
 	
 	
 	//=========//
 	// F3 Menu //
 	//=========//
-	//region
 	
-	public ArrayList<String> getDebugMenuString() { return WORLD_CHUNK_UPDATE_MANAGER.getDebugMenuString(); }
+	public String getDebugMenuString()
+	{
+		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;
+	}
 	
-	//endregion
+	
+	
+	//================//
+	// 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;
+		
+		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);
+		}
+		
+	}
 	
 	
 	
@@ -1,127 +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 org.jetbrains.annotations.Nullable;
-
-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);
-	}
-	@Nullable
-	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);
-	}
-}
-		
@@ -1,21 +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;
-	public IDhLevel dhLevel;
-	
-	
-	
-	public ChunkUpdateData(IChunkWrapper chunkWrapper, IDhLevel dhLevel)
-	{
-		this.chunkWrapper = chunkWrapper;
-		this.dhLevel = dhLevel;
-	}
-}
@@ -1,408 +0,0 @@
-package com.seibel.distanthorizons.core.api.internal.chunkUpdating;
-
-import com.google.common.cache.CacheBuilder;
-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.dependencyInjection.SingletonInjector;
-import com.seibel.distanthorizons.core.enums.MinecraftTextFormat;
-import com.seibel.distanthorizons.core.generation.DhLightingEngine;
-import com.seibel.distanthorizons.core.level.IDhLevel;
-import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
-import com.seibel.distanthorizons.core.logging.f3.F3Screen;
-import com.seibel.distanthorizons.core.pos.DhChunkPos;
-import com.seibel.distanthorizons.core.util.LodUtil;
-import com.seibel.distanthorizons.core.util.threading.ThreadPoolUtil;
-import com.seibel.distanthorizons.core.world.EWorldEnvironment;
-import com.seibel.distanthorizons.core.logging.DhLogger;
-import com.seibel.distanthorizons.core.wrapperInterfaces.chunk.IChunkWrapper;
-import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftClientWrapper;
-import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftSharedWrapper;
-import com.seibel.distanthorizons.core.wrapperInterfaces.world.ILevelWrapper;
-import org.jetbrains.annotations.Nullable;
-
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.Set;
-import java.util.concurrent.*;
-
-
-/**
- * @see WorldChunkUpdateManager
- */
-public class ChunkUpdateQueueManager
-{
-	private static final DhLogger LOGGER = new DhLoggerBuilder().build();
-	
-	private static final IMinecraftClientWrapper MC_CLIENT = SingletonInjector.INSTANCE.get(IMinecraftClientWrapper.class);
-	private static final IMinecraftSharedWrapper MC_SHARED = SingletonInjector.INSTANCE.get(IMinecraftSharedWrapper.class);
-	
-	/**
-	 * 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;
-	
-	/** 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 final Set<DhChunkPos> ignoredChunkPosSet = Collections.newSetFromMap(new ConcurrentHashMap<>());
-	private static long lastOverloadedLogMessageMsTime = 0;
-	
-	
-	
-	
-	public final ChunkPosQueue updateQueue;
-	public final ChunkPosQueue preUpdateQueue;
-	
-	public final ConcurrentMap<DhChunkPos, IChunkWrapper> queuedChunkWrapperByChunkPos = CacheBuilder.newBuilder()
-		.expireAfterWrite(20, TimeUnit.SECONDS)
-		.<DhChunkPos, IChunkWrapper>build()
-		.asMap();
-	
-	/** dynamically changes based on the number of threads currently available */
-	public int maxSize = 500;
-	
-	/** used to prevent flickering */
-	public long lastMsTimeShownActiveInF3Screen = System.currentTimeMillis();
-	
-	
-	
-	//=============//
-	// constructor //
-	//=============//
-	//region
-	
-	public ChunkUpdateQueueManager()
-	{
-		this.updateQueue = new ChunkPosQueue();
-		this.preUpdateQueue = new ChunkPosQueue();
-	}
-	
-	//endregion
-	
-	
-	
-	//==================//
-	// list/set methods //
-	//==================//
-	//region
-	
-	public boolean contains(DhChunkPos pos) 
-	{ 
-		return this.updateQueue.contains(pos)
-			|| this.ignoredChunkPosSet.contains(pos)	
-			|| this.preUpdateQueue.contains(pos); 
-	}
-	
-	public void clear()
-	{
-		this.updateQueue.clear();
-		this.preUpdateQueue.clear();
-		this.ignoredChunkPosSet.clear();
-	}
-	public int getQueuedCount() { return this.updateQueue.getQueuedCount() + this.preUpdateQueue.getQueuedCount(); }
-	
-	public boolean updateQueuesEmpty()
-	{
-		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)
-	{ this.addItemToQueue(pos, updateData, this.preUpdateQueue); }
-	
-	public void addItemToUpdateQueue(DhChunkPos pos, ChunkUpdateData updateData)
-	{ this.addItemToQueue(pos, updateData, this.updateQueue); }
-	
-	private void addItemToQueue(DhChunkPos pos, ChunkUpdateData updateData, ChunkPosQueue queue)
-	{
-		int remainingSlots = this.maxSize - this.getQueuedCount();
-		
-		// If no slots are left, get one by removing the item furthest from the center
-		if (remainingSlots <= 0)
-		{
-			ChunkUpdateData removedData = queue.popFurthest();
-			if (removedData != null)
-			{
-				this.queuedChunkWrapperByChunkPos.remove(removedData.chunkWrapper.getChunkPos());
-			}
-		}
-		
-		queue.addItem(pos,updateData);
-		this.queuedChunkWrapperByChunkPos.putIfAbsent(pos, updateData.chunkWrapper);
-		
-		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 >= MIN_MS_BETWEEN_OVERLOADED_LOG_MESSAGE)
-		{
-			lastOverloadedLogMessageMsTime = System.currentTimeMillis();
-			
-			String message = MinecraftTextFormat.ORANGE + "Distant Horizons overloaded, too many chunks queued for LOD processing. " + MinecraftTextFormat.CLEAR_FORMATTING +
-					"\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 [" + this.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);
-			}
-		}
-	}
-	
-	/** 
-	 * Tries to return a cloned chunk wrapper from memory.
-	 * Returns null if no chunk is available.
-	 * <br><br>
-	 * This is done instead of accessing the MC level since
-	 * accessing the level often requires running on the render or server
-	 * thread, which causes stuttering.
-	 */
-	@Nullable
-	public IChunkWrapper tryGetChunk(DhChunkPos pos)
-	{
-		IChunkWrapper existingWrapper = this.queuedChunkWrapperByChunkPos.get(pos);
-		if (existingWrapper == null)
-		{
-			return null;
-		}
-	
-		return existingWrapper.copy();
-	}
-	
-	//endregion
-	
-	
-	
-	//=========//
-	// ignores //
-	//=========//
-	//region
-	
-	public void addPosToIgnore(DhChunkPos chunkPos) { this.ignoredChunkPosSet.add(chunkPos); }
-	public void removePosToIgnore(DhChunkPos chunkPos) { this.ignoredChunkPosSet.remove(chunkPos); }
-	
-	//endregion
-	
-	
-	
-	//===================//
-	// update processing //
-	//===================//
-	//region
-	
-	public void processQueue()
-	{
-		// update the center & max size of the queue manager
-		int maxUpdateSizeMultiplier;
-		if (MC_CLIENT != null && MC_CLIENT.playerExists())
-		{
-			// Local worlds & multiplayer
-			this.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();
-		}
-		
-		this.maxSize = MAX_UPDATING_CHUNK_COUNT_PER_THREAD_AND_PLAYER
-			* Config.Common.MultiThreading.numberOfThreads.get()
-			* maxUpdateSizeMultiplier;
-		
-		
-		
-		//===============================//
-		// update the necessary chunk(s) //
-		//===============================//
-		
-		this.processQueuedChunkPreUpdate();
-		this.processQueuedChunkUpdate();
-		
-		// queue the next position if there are still positions to process
-		AbstractExecutorService executor = ThreadPoolUtil.getChunkToLodBuilderExecutor();
-		if (executor != null && !this.updateQueuesEmpty())
-		{
-			try
-			{
-				executor.execute(this::processQueue);
-			}
-			catch (RejectedExecutionException ignore)
-			{
-				// the executor was shut down, it should be back up shortly and able to accept new jobs
-			}
-		}
-		
-	}
-	
-	private void processQueuedChunkPreUpdate()
-	{
-		ChunkUpdateData preUpdateData = this.preUpdateQueue.popClosest();
-		if (preUpdateData == null)
-		{
-			return;
-		}
-		
-		IDhLevel dhLevel = preUpdateData.dhLevel;
-		IChunkWrapper chunkWrapper = preUpdateData.chunkWrapper;
-		chunkWrapper.createDhHeightMaps();
-		
-		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;
-				}
-			}
-			
-			this.addItemToUpdateQueue(chunkWrapper.getChunkPos(), preUpdateData);
-		}
-		catch (Exception e)
-		{
-			LOGGER.error("Unexpected error when pre-updating chunk at pos: [" + chunkWrapper.getChunkPos() + "]", e);
-		}
-	}
-	
-	private void processQueuedChunkUpdate()
-	{
-		ChunkUpdateData updateData = this.updateQueue.popClosest();
-		if (updateData == null)
-		{
-			return;
-		}
-		
-		IChunkWrapper chunkWrapper = updateData.chunkWrapper;
-		IDhLevel dhLevel = updateData.dhLevel;
-		ILevelWrapper levelWrapper = dhLevel.getLevelWrapper();
-		
-		// having a list of the nearby chunks is needed for lighting and beacon generation
-		ArrayList<IChunkWrapper> nearbyChunkList  = this.tryGetNeighborChunkListForChunk(chunkWrapper);
-		
-		
-		
-		try
-		{
-			// sky lighting is populated later at the data source level
-			DhLightingEngine.INSTANCE.bakeChunkBlockLighting(chunkWrapper, nearbyChunkList, levelWrapper.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);
-		}
-		
-		this.queuedChunkWrapperByChunkPos.remove(updateData.chunkWrapper.getChunkPos());
-	}
-	private ArrayList<IChunkWrapper> tryGetNeighborChunkListForChunk(IChunkWrapper chunkWrapper)
-	{
-		// get the neighboring chunk list
-		ArrayList<IChunkWrapper> neighborChunkList = new ArrayList<>(9);
-		for (int xOffset = -1; xOffset <= 1; xOffset++)
-		{
-			for (int zOffset = -1; zOffset <= 1; zOffset++)
-			{
-				if (xOffset == 0 && zOffset == 0)
-				{
-					// center chunk
-					neighborChunkList.add(chunkWrapper);
-				}
-				else
-				{
-					// neighboring chunk 
-					DhChunkPos neighborPos = new DhChunkPos(chunkWrapper.getChunkPos().getX() + xOffset, chunkWrapper.getChunkPos().getZ() + zOffset);
-					IChunkWrapper neighborChunk = this.tryGetChunk(neighborPos);
-					if (neighborChunk != null)
-					{
-						neighborChunkList.add(neighborChunk);
-					}
-				}
-			}
-		}
-		return neighborChunkList;
-	}
-	
-	//endregion
-	
-	
-	
-	//==================//
-	// position methods //
-	//==================//
-	//region
-	
-	public void setCenter(DhChunkPos newCenter)
-	{
-		this.updateQueue.setCenter(newCenter);
-		this.preUpdateQueue.setCenter(newCenter);
-	}
-	
-	//endregion
-	
-	
-	
-	//=========//
-	// F3 Menu //
-	//=========//
-	//region
-	
-	public String getDebugMenuString()
-	{
-		String y = MinecraftTextFormat.YELLOW;
-		String o = MinecraftTextFormat.ORANGE;
-		String cf = MinecraftTextFormat.CLEAR_FORMATTING;
-		
-		
-		String preUpdatingCountStr = F3Screen.NUMBER_FORMAT.format(this.preUpdateQueue.getQueuedCount());
-		String updatingCountStr = F3Screen.NUMBER_FORMAT.format(this.updateQueue.getQueuedCount());
-		String queuedCountStr = F3Screen.NUMBER_FORMAT.format(this.getQueuedCount());
-		
-		String maxUpdateCountStr = F3Screen.NUMBER_FORMAT.format(this.maxSize);
-		
-		return "Queued chunk updates: "+"("+y+preUpdatingCountStr+cf+" + "+o+updatingCountStr+cf+") ["+queuedCountStr+"/"+maxUpdateCountStr+"]";
-	}
-	
-	//endregion
-	
-	
-	
-}
@@ -1,190 +0,0 @@
-package com.seibel.distanthorizons.core.api.internal.chunkUpdating;
-
-import com.seibel.distanthorizons.core.api.internal.SharedApi;
-import com.seibel.distanthorizons.core.logging.DhLogger;
-import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
-import com.seibel.distanthorizons.core.world.AbstractDhWorld;
-import com.seibel.distanthorizons.core.world.EWorldEnvironment;
-import com.seibel.distanthorizons.core.wrapperInterfaces.world.IClientLevelWrapper;
-import com.seibel.distanthorizons.core.wrapperInterfaces.world.ILevelWrapper;
-import com.seibel.distanthorizons.core.wrapperInterfaces.world.IServerLevelWrapper;
-import org.jetbrains.annotations.Nullable;
-
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.Set;
-import java.util.concurrent.ConcurrentHashMap;
-import java.util.concurrent.atomic.AtomicInteger;
-
-/**
- * Holds all the {@link ChunkUpdateQueueManager} for a loaded world.
- * Different queues are needed for each level to prevent
- * chunks from bleeding between levels (IE a nether chunk applied to the overworld).
- * 
- * @see ChunkUpdateQueueManager
- */
-public class WorldChunkUpdateManager
-{
-	private static final DhLogger LOGGER = new DhLoggerBuilder().build();
-	
-	/** singleton since we only expect to have one world loaded at a time */
-	public static final WorldChunkUpdateManager INSTANCE = new WorldChunkUpdateManager();
-	
-	public static final Set<String> LOGGED_GET_ERROR_MESSAGES = Collections.newSetFromMap(new ConcurrentHashMap<String, Boolean>());
-	
-	
-	/** 
-	 * Queues are only removed during world shutdown.
-	 * The assumption is that there will be a limited number of {@link ILevelWrapper}'s
-	 * for a given world.
-	 */
-	private final ConcurrentHashMap<ILevelWrapper, ChunkUpdateQueueManager> updateQueueByLevelWrapper = new ConcurrentHashMap<>();
-	
-	
-	
-	
-	//=============//
-	// constructor //
-	//=============//
-	//region
-	
-	private WorldChunkUpdateManager() {  }
-	
-	//endregion
-	
-	
-	
-	//=================//
-	// manager methods //
-	//=================//
-	//region
-	
-	/**
-	 * @return null if the world is unloaded or the given level wrapper is the wrong type 
-	 */
-	@Nullable
-	public ChunkUpdateQueueManager getByLevelWrapper(ILevelWrapper levelWrapper)
-	{
-		AbstractDhWorld world = SharedApi.getAbstractDhWorld();
-		if (world == null)
-		{
-			// world isn't loaded, no warnings need to be logged
-			return null;
-		}
-		
-		// we only want to load chunks for certain level wrappers
-		// this is done specifically on a local-server to prevent
-		// loading both the server and client level wrappers
-		if (world.environment == EWorldEnvironment.CLIENT_ONLY
-			// when connected to a server we should only ever load client wrappers anyway
-			// but this check confirms it
-			&& !(levelWrapper instanceof IClientLevelWrapper))
-		{
-			// how did we get a server level wrapper on the client?
-			// this shouldn't happen, but just in case
-			return null;
-		}
-		else if (
-			(world.environment == EWorldEnvironment.SERVER_ONLY
-			|| world.environment == EWorldEnvironment.CLIENT_SERVER)
-				// when hosting a server we only care about the server wrappers
-				&& !(levelWrapper instanceof IServerLevelWrapper))
-		{
-			// ignore client updates on the server
-			return null;
-		}
-		
-		
-		ChunkUpdateQueueManager queueManager = this.updateQueueByLevelWrapper.get(levelWrapper);
-		if (queueManager != null)
-		{
-			return queueManager;
-		}
-		
-		return this.updateQueueByLevelWrapper.compute(levelWrapper,
-			(ILevelWrapper newLevelWrapper, ChunkUpdateQueueManager oldQueueManager) ->
-			{
-				if (oldQueueManager != null)
-				{
-					return oldQueueManager;
-				}
-				
-				oldQueueManager = new ChunkUpdateQueueManager();
-				return oldQueueManager;
-			});
-	}
-	
-	public void processEachQueue()
-	{
-		this.updateQueueByLevelWrapper.forEach(
-			(ILevelWrapper levelWrapper, ChunkUpdateQueueManager updateManager) -> 
-		{
-			updateManager.processQueue();
-		});
-	}
-	
-	public int getTotalQueuedCount()
-	{
-		AtomicInteger queueCountRef = new AtomicInteger(0);
-		
-		this.updateQueueByLevelWrapper.forEach(
-			(ILevelWrapper levelWrapper, ChunkUpdateQueueManager updateManager) ->
-			{
-				queueCountRef.addAndGet(updateManager.getQueuedCount());
-			});
-		
-		return queueCountRef.get();
-	}
-	
-	public void clear() { this.updateQueueByLevelWrapper.clear(); }
-	
-	//endregion
-	
-	
-	
-	//=========//
-	// F3 Menu //
-	//=========//
-	//region
-	
-	public ArrayList<String> getDebugMenuString()
-	{
-		ArrayList<String> stringList = new ArrayList<>();
-		stringList.add("");// placeholder for the total count
-		
-		// add each queue to the list
-		AtomicInteger totalQueueCountRef = new AtomicInteger(0);
-		AtomicInteger activeQueueCountRef = new AtomicInteger(0);
-		this.updateQueueByLevelWrapper.forEach(
-			(ILevelWrapper levelWrapper, ChunkUpdateQueueManager updateManager) ->
-			{
-				// is this queue active?
-				if (!updateManager.updateQueuesEmpty())
-				{
-					updateManager.lastMsTimeShownActiveInF3Screen = System.currentTimeMillis();
-					activeQueueCountRef.incrementAndGet();
-				}
-				
-				// show this queue if it hasn't been empty long enough
-				// (done to prevent flickering on the F3 screen when the queue rapidly fills/empties)
-				long timeSinceQueueLastShownActiveMs = System.currentTimeMillis() - updateManager.lastMsTimeShownActiveInF3Screen;
-				if (timeSinceQueueLastShownActiveMs < 4_000)
-				{
-					stringList.add(levelWrapper.getDimensionName() + ": " + updateManager.getDebugMenuString());
-				}
-				
-				totalQueueCountRef.incrementAndGet();
-			});
-		
-		// replace the first line with the number of total/active queues
-		// (helpful if we need to diagnose a leak due to a massive number of queue level wrappers)
-		stringList.set(0, "Chunk Update Queues: "+activeQueueCountRef.get()+"/"+totalQueueCountRef.get());
-		
-		return stringList;
-	}
-	
-	//endregion
-	
-	
-	
-}
@@ -1,89 +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.minecraft.IMinecraftRenderWrapper;
-import com.seibel.distanthorizons.core.wrapperInterfaces.world.IClientLevelWrapper;
-
-/**
- * Used to track the rendering state for the current frame.
- * 
- * @see ClientApi
- */
-public class DhRenderState
-{
-	public Mat4f mcModelViewMatrix = null;
-	public Mat4f mcProjectionMatrix = null;
-	/** 
-	 * percentage of time into the current client tick. <br><br>
-	 * 
-	 * Can be converted to a millisecond frametime 
-	 * (IE time between frames in milliseconds) using the formula: <br>
-	 * <code>
-	 * (partialTickTime/20*1000)
-	 * </code> <br>
-	 * IE 60 FPS = 16.6 MS <br>
-	 * 
-	 * @link https://fpstoms.com/
-	 * @see IMinecraftRenderWrapper#getPartialTickTime()
-	 */
-	public float partialTickTime = -1; 
-	public IClientLevelWrapper clientLevelWrapper = null;
-	
-	/**
-	 * This will generally be true if the player is: <br>
-	 * - blinded <br>
-	 * - under lava/water <br>
-	 * <br>
-	 * In those cases some rendering logic may need to be changed
-	 * to look correct.
-	 */
-	public boolean vanillaFogEnabled = false;
-	
-	
-	
-	//========//
-	// 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.partialTickTime == -1)
-		{
-			errorReasons += "no Frame Time, ";
-		}
-		
-		if (this.clientLevelWrapper == null)
-		{
-			errorReasons += "no Level Wrapper, ";
-		}
-		
-		return errorReasons;
-	}
-	
-	public void canRenderOrThrow() throws IllegalStateException
-	{
-		String errorReasons = this.unableToRenderBecause();
-		if (!errorReasons.isEmpty())
-		{
-			throw new IllegalStateException(errorReasons);
-		}
-	}
-	
-	
-	
-}
@@ -17,20 +17,38 @@
 *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */

-package com.seibel.distanthorizons.core.wrapperInterfaces.render.objects;
+package com.seibel.distanthorizons.core.config;

-import com.seibel.distanthorizons.core.wrapperInterfaces.render.AbstractDhRenderApiDefinition;
-import com.seibel.distanthorizons.coreapi.interfaces.dependencyInjection.IBindable;
+import com.seibel.distanthorizons.core.config.types.ConfigEntry;

-import java.nio.ByteBuffer;
-
-public interface IVertexBufferWrapper extends IBindable, AutoCloseable
+// TODO: Make this integrate with the config system
+public class AppliedConfigState<T>
 {
-	void uploadVertexBuffer(ByteBuffer buffer, int vertexCount);
-	/** Does nothing if {@link AbstractDhRenderApiDefinition#useSingleIbo()} returns true */
-	void uploadIndexBuffer(ByteBuffer buffer, int vertexCount);
+	final ConfigEntry<T> entry;
+	T activeValue;
 	
-	@Override
-	void close();
+	
+	
+	public AppliedConfigState(ConfigEntry<T> entryToWatch)
+	{
+		this.entry = entryToWatch;
+		this.activeValue = entryToWatch.get();
+	}
+	
+	
+	
+	/** Returns true if the value was changed */
+	public boolean pollNewValue()
+	{
+		T newValue = this.entry.get();
+		if (newValue.equals(this.activeValue))
+		{
+			return false;
+		}
+		this.activeValue = newValue;
+		return true;
+	}
+	
+	public T get() { return this.activeValue; }
 	
 }
@@ -0,0 +1,275 @@
+/*
+ *    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;
+
+import com.seibel.distanthorizons.core.config.file.ConfigFileHandling;
+import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
+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 org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+
+import java.lang.reflect.Field;
+import java.nio.file.Path;
+import java.util.*;
+
+/**
+ * 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;
+	
+	
+	
+	/**
+	 *      What the config works with
+	 * <br> 
+	 * <br> {@link Enum}
+	 * <br> {@link Boolean}
+	 * <br> {@link Byte}
+	 * <br> {@link Integer}
+	 * <br> {@link Double}
+	 * <br> {@link Short}
+	 * <br> {@link Long}
+	 * <br> {@link Float}
+	 * <br> {@link String}
+	 * <br> 
+	 * <br> // Below, "T" should be a value from above
+	 * <br> // Note: This is not checked, so we trust that you are doing the right thing (TODO: Check it)
+	 * <br> List<T>
+	 * <br> ArrayList<T>
+	 * <br> Map<String, T>
+	 * <br> HashMap<String, T>
+	 */
+	public static final List<Class<?>> acceptableInputs = new ArrayList<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
+		add(List.class);
+		add(ArrayList.class);
+		add(Map.class);
+		add(HashMap.class);
+	}};
+	
+	/** 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<>();
+	
+	
+	public ConfigBase(String modID, String modName, Class<?> configClass)
+	{
+		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);
+	}
+	
+	public ConfigBase(String modID, String modName, Class<?> configClass, Path configPath, int configVersion)
+	{
+		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
+		
+		// File handling (load from file)
+		this.configFileINSTANCE = new ConfigFileHandling(this, configPath);
+		this.configFileINSTANCE.loadFromFile();
+		
+		this.isLoaded = true;
+		this.logger.info("Config for " + modName + " initialised");
+	}
+	
+	private void initNestedClass(Class<?> configClass, String category)
+	{
+		// Put all the entries in entries
+		
+		for (Field field : configClass.getFields())
+		{
+			if (AbstractConfigType.class.isAssignableFrom(field.getType()))
+			{
+				try
+				{
+					this.entries.add((AbstractConfigType<?, ?>) field.get(field.getType()));
+				}
+				catch (IllegalAccessException exception)
+				{
+					this.logger.warn(exception);
+				}
+				
+				AbstractConfigType<?, ?> entry = this.entries.get(this.entries.size() - 1);
+				entry.category = category;
+				entry.name = field.getName();
+				entry.configBase = this;
+				
+				if (ConfigEntry.class.isAssignableFrom(field.getType()))
+				{ // If item is type ConfigEntry
+					if (!isAcceptableType(entry.getType()))
+					{
+						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
+					}
+				}
+				
+				if (ConfigCategory.class.isAssignableFrom(field.getType()))
+				{ // If it's a category then init the stuff inside it and put it in the category list
+					assert entry instanceof ConfigCategory;
+					if (((ConfigCategory) entry).getDestination() == null)
+						((ConfigCategory) entry).destination = entry.getNameWCategory();
+					if (entry.get() != null)
+					{
+						this.initNestedClass(((ConfigCategory) entry).get(), ((ConfigCategory) entry).getDestination());
+					}
+				}
+			}
+		}
+	}
+	
+	private static boolean isAcceptableType(Class<?> Clazz)
+	{
+		if (Clazz.isEnum())
+			return true;
+		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");
+	}
+	
+	
+	/**
+	 * Used for checking that all the lang files for the config exist
+	 *
+	 * @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 onlyShowNew, boolean checkEnums)
+	{
+		ILangWrapper langWrapper = SingletonInjector.INSTANCE.get(ILangWrapper.class);
+		List<Class<? extends Enum<?>>> enumList = new ArrayList<>();
+		
+		String generatedLang = "";
+		
+		String starter = "  \"";
+		String separator = "\":\n    \"";
+		String ending = "\",\n";
+		
+		for (AbstractConfigType<?, ?> entry : this.entries)
+		{
+			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
+				enumList.add((Class<? extends Enum<?>>) entry.getType());
+			}
+			if (!onlyShowNew || langWrapper.langExists(entryPrefix))
+			{
+				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
+					;
+				}
+			}
+		}
+		if (!enumList.isEmpty())
+		{
+			generatedLang += "\n"; // Separate the main lang with the enum's
+			
+			for (Class<? extends Enum> anEnum : enumList)
+			{
+				for (Object enumStr : new ArrayList<>(EnumSet.allOf(anEnum)))
+				{
+					String enumPrefix = "lod.config.enum." + anEnum.getSimpleName() + "." + enumStr.toString();
+					
+					if (!onlyShowNew || langWrapper.langExists(enumPrefix))
+					{
+						generatedLang += starter
+								+ enumPrefix
+								+ separator
+								+ langWrapper.getLang(enumPrefix)
+								+ ending
+						;
+					}
+				}
+			}
+		}
+		
+		return generatedLang;
+	}
+	
+}
@@ -24,7 +24,7 @@ import com.seibel.distanthorizons.core.config.types.ConfigEntry;
 import java.util.HashMap;
 import java.util.HashSet;

-public class ConfigPresetOptions<TQuickEnum, TConfig>
+public class ConfigEntryWithPresetOptions<TQuickEnum, TConfig>
 {
 	public final ConfigEntry<TConfig> configEntry;
 	
@@ -32,11 +32,7 @@ public class ConfigPresetOptions<TQuickEnum, TConfig>
 	
 	
 	
-	//=============//
-	// constructor //
-	//=============//
-	
-	public ConfigPresetOptions(ConfigEntry<TConfig> configEntry, HashMap<TQuickEnum, TConfig> configOptionByQualityOption)
+	public ConfigEntryWithPresetOptions(ConfigEntry<TConfig> configEntry, HashMap<TQuickEnum, TConfig> configOptionByQualityOption)
 	{
 		this.configEntry = configEntry;
 		this.configOptionByQualityOption = configOptionByQualityOption;
@@ -44,10 +40,6 @@ public class ConfigPresetOptions<TQuickEnum, TConfig>
 	
 	
 	
-	//=========//
-	// methods //
-	//=========//
-	
 	public void updateConfigEntry(TQuickEnum quickQuality)
 	{
 		TConfig newValue = this.configOptionByQualityOption.get(quickQuality);
@@ -56,9 +48,7 @@ public class ConfigPresetOptions<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())
@@ -1,330 +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;
-
-import com.seibel.distanthorizons.core.config.file.ConfigFileHandler;
-import com.seibel.distanthorizons.core.config.types.*;
-import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
-import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
-import com.seibel.distanthorizons.core.wrapperInterfaces.config.ILangWrapper;
-import com.seibel.distanthorizons.core.wrapperInterfaces.minecraft.IMinecraftSharedWrapper;
-import com.seibel.distanthorizons.coreapi.ModInfo;
-import com.seibel.distanthorizons.core.logging.DhLogger;
-
-import java.lang.reflect.Field;
-import java.nio.file.Path;
-import java.util.*;
-
-/**
- * Sets up everything in {@link Config} for the file/GUI and keeps track of all
- * entries therein. <br>
- * This should be run after the singletons have been bound.
- *
- * @author coolGi
- * @author Ran
- * 
- * @see Config
- */
-public class ConfigHandler
-{
-	private static final DhLogger LOGGER = new DhLoggerBuilder().build();
-	
-	private static final IMinecraftSharedWrapper MC_SHARED = SingletonInjector.INSTANCE.get(IMinecraftSharedWrapper.class);
-	
-	/**
-	 * What the config works with
-	 * <br> 
-	 * <br> {@link Enum}
-	 * <br> {@link Boolean}
-	 * <br> {@link Byte}
-	 * <br> {@link Integer}
-	 * <br> {@link Double}
-	 * <br> {@link Short}
-	 * <br> {@link Long}
-	 * <br> {@link Float}
-	 * <br> {@link String}
-	 * <br> 
-	 * <br> // Below, "T" should be a value from above
-	 * <br> // Note: This is not checked, so we trust that you are doing the right thing
-	 * <br> List<T>
-	 * <br> ArrayList<T>
-	 * <br> Map<String, T>
-	 * <br> HashMap<String, T>
-	 */
-	private static final List<Class<?>> ACCEPTABLE_INPUTS = 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);
-		
-		// partially implemented but not entirely
-		this.add(List.class);
-		this.add(ArrayList.class);
-		this.add(Map.class);
-		this.add(HashMap.class);
-	}};
-	
-	
-	
-	public static final ConfigHandler INSTANCE = new ConfigHandler();
-	
-	public final ConfigFileHandler configFileHandler = new ConfigFileHandler(getConfigPath());
-	public final List<AbstractConfigBase<?>> configBaseList = new ArrayList<>();
-	
-	public boolean isLoaded = false;
-	/** 
-	 * Disables the minimum and maximum validation. <Br>
-	 * Fun to use, but should be disabled by default.
-	 */
-	public boolean runMinMaxValidation = true;
-	
-	
-	
-	//=============//
-	// constructor //
-	//=============//
-	
-	public static void tryRunFirstTimeSetup()
-	{
-		if (INSTANCE.isLoaded)
-		{
-			LOGGER.debug("ConfigHandler setup already run, ignoring.");
-			return;
-		}
-		
-		INSTANCE.runFirstTimeSetup();
-	}
-	private void runFirstTimeSetup()
-	{
-		LOGGER.info("Initialising config for [" + ModInfo.NAME + "]");
-		
-		this.initNestedClass(Config.class, ""); // Init root category
-		
-		this.configFileHandler.loadFromFile();
-		this.runMinMaxValidation = !Config.Client.Advanced.Debugging.allowUnsafeValues.get();
-		
-		this.isLoaded = true;
-		LOGGER.info("[" + ModInfo.NAME + "] Config initialised");
-	}
-	/** Gets the default config path given a mod name */
-	private static Path getConfigPath()
-	{
-		return MC_SHARED
-				.getInstallationDirectory().toPath()
-				.resolve("config")
-				.resolve(ModInfo.NAME + ".toml");
-	}
-	/** Put all the config entries into configEntryList */
-	private void initNestedClass(Class<?> configClass, String category)
-	{
-		Field[] fields = configClass.getFields();
-		for (Field field : fields)
-		{
-			// ignore any non-config variables
-			if (!AbstractConfigBase.class.isAssignableFrom(field.getType()))
-			{
-				continue;
-			}
-			
-			
-			// add this config to the master list
-			try
-			{
-				this.configBaseList.add((AbstractConfigBase<?>) field.get(field.getType()));
-			}
-			catch (IllegalAccessException e)
-			{
-				LOGGER.warn("Unable to add config ["+field.getType().getName()+"], error: ["+e.getMessage()+"].", e);
-				continue;
-			}
-			
-			
-			// set any necessary variables in this config
-			AbstractConfigBase<?> configBase = this.configBaseList.get(this.configBaseList.size() - 1);
-			configBase.category = category;
-			configBase.name = field.getName();
-			
-			
-			// validate the config's input type
-			if (ConfigEntry.class.isAssignableFrom(field.getType()))
-			{
-				if (!isAcceptableType(configBase.getType()))
-				{
-					LOGGER.error("Invalid variable type at [" + (category.isEmpty() ? "" : category + ".") + field.getName() + "].");
-					LOGGER.error("Type [" + configBase.getType() + "] is not one of these types [" + ACCEPTABLE_INPUTS.toString() + "]");
-					this.configBaseList.remove(this.configBaseList.size() - 1); // Delete the entry if it is invalid so the game can still run
-				}
-			}
-			
-			// recursively add deeper categories if present
-			if (ConfigCategory.class.isAssignableFrom(field.getType()))
-			{
-				ConfigCategory configCategory = (ConfigCategory) configBase;
-				
-				if (configCategory.getDestination() == null)
-				{
-					configCategory.destination = configBase.getNameAndCategory();
-				}
-				
-				// shouldn't happen, but just in case
-				if (configBase.get() != null)
-				{
-					this.initNestedClass(configCategory.get(), configCategory.getDestination());
-				}
-			}
-		}
-	}
-	private static boolean isAcceptableType(Class<?> inputClass)
-	{
-		if (inputClass.isEnum())
-		{
-			return true;
-		}
-		
-		return ACCEPTABLE_INPUTS.contains(inputClass);
-	}
-	
-	
-	
-	//===============//
-	// 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
-	 *
-	 * @param onlyShowMissing If false then this will remake the entire config lang
-	 * @param checkEnums Checks if all the lang for the enum's exist
-	 */
-	@SuppressWarnings("unchecked")
-	public String generateLang(boolean onlyShowMissing, boolean checkEnums)
-	{
-		ILangWrapper langWrapper = SingletonInjector.INSTANCE.get(ILangWrapper.class);
-		List<Class<? extends Enum<?>>> enumList = new ArrayList<>();
-		
-		String generatedLang = "";
-		
-		String starter = "  \"";
-		String separator = "\":\n    \"";
-		String ending = "\",\n";
-		
-		// config entries
-		for (AbstractConfigBase<?> entry : this.configBaseList)
-		{
-			String entryPrefix = "distanthorizons.config." + entry.getNameAndCategory();
-			
-			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)
-			{
-				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)
-			{
-				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
-				;
-			}
-		}
-		
-		
-		// 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)))
-				{
-					String enumPrefix = "distanthorizons.config.enum." + anEnum.getSimpleName() + "." + enumStr.toString();
-					
-					if (!langWrapper.langExists(enumPrefix) 
-						|| !onlyShowMissing)
-					{
-						generatedLang += starter
-								+ enumPrefix
-								+ separator
-								+ langWrapper.getLang(enumPrefix)
-								+ ending
-						;
-					}
-				}
-			}
-		}
-		
-		return generatedLang;
-	}
-	
-	
-	
-}
@@ -17,50 +17,54 @@
 *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */

-package com.seibel.distanthorizons.core.util;
+package com.seibel.distanthorizons.core.config;

 import java.util.HashMap;
 import java.util.Map;

 /**
- * Helps when working with numbers where the type is unknown.
+ * Helps with working with numbers that the value of which is unknown
 *
 * @author coolGi
+ * @version 2023-7-16
 */
+// TODO: Should this be moved out of here into somewhere like the util section
 public class NumberUtil
 {
 	// Is there no better way of doing this?
 	public static Map<Class<?>, Number> minValues = new HashMap<Class<?>, Number>()
 	{{
-		this.put(Byte.class, Byte.MIN_VALUE);
-		this.put(Short.class, Short.MIN_VALUE);
-		this.put(Integer.class, Integer.MIN_VALUE);
-		this.put(Long.class, Long.MIN_VALUE);
-		this.put(Double.class, Double.MIN_VALUE);
-		this.	put(Float.class, Float.MIN_VALUE);
+		put(Byte.class, Byte.MIN_VALUE);
+		put(Short.class, Short.MIN_VALUE);
+		put(Integer.class, Integer.MIN_VALUE);
+		put(Long.class, Long.MIN_VALUE);
+		put(Double.class, Double.MIN_VALUE);
+		put(Float.class, Float.MIN_VALUE);
 	}};
 	public static Map<Class<?>, Number> maxValues = new HashMap<Class<?>, Number>()
 	{{
-		this.put(Byte.class, Byte.MAX_VALUE);
-		this.put(Short.class, Short.MAX_VALUE);
-		this.put(Integer.class, Integer.MAX_VALUE);
-		this.put(Long.class, Long.MAX_VALUE);
-		this.put(Double.class, Double.MAX_VALUE);
-		this.put(Float.class, Float.MAX_VALUE);
+		put(Byte.class, Byte.MAX_VALUE);
+		put(Short.class, Short.MAX_VALUE);
+		put(Integer.class, Integer.MAX_VALUE);
+		put(Long.class, Long.MAX_VALUE);
+		put(Double.class, Double.MAX_VALUE);
+		put(Float.class, Float.MAX_VALUE);
 	}};
 	
-	
-	
-	public static Number getMinimum(Class<?> c) { return minValues.get(c); }
-	public static Number getMaximum(Class<?> c) { return maxValues.get(c); }
+	public static Number getMinimum(Class<?> c)
+	{
+		return minValues.get(c);
+	}
+	public static Number getMaximum(Class<?> c)
+	{
+		return maxValues.get(c);
+	}
 	
 	/** Does a greater than (>) operator on any number */
 	public static boolean greaterThan(Number a, Number b)
 	{
 		if (a.getClass() != b.getClass())
-		{
 			return false;
-		}
 		Class<?> typeClass = a.getClass();
 		
 		if (typeClass == Byte.class) return a.byteValue() > b.byteValue();
@@ -69,7 +73,6 @@ public class NumberUtil
 		if (typeClass == Long.class) return a.longValue() > b.longValue();
 		if (typeClass == Double.class) return a.doubleValue() > b.doubleValue();
 		if (typeClass == Float.class) return a.floatValue() > b.floatValue();
-		
 		return false;
 	}
 	
@@ -77,9 +80,7 @@ public class NumberUtil
 	public static boolean lessThan(Number a, Number b)
 	{
 		if (a.getClass() != b.getClass())
-		{
 			return false;
-		}
 		Class<?> typeClass = a.getClass();
 		
 		if (typeClass == Byte.class) return a.byteValue() < b.byteValue();
@@ -88,7 +89,6 @@ public class NumberUtil
 		if (typeClass == Long.class) return a.longValue() < b.longValue();
 		if (typeClass == Double.class) return a.doubleValue() < b.doubleValue();
 		if (typeClass == Float.class) return a.floatValue() < b.floatValue();
-		
 		return false;
 	}
 	
@@ -1,125 +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.eventHandlers;
-
-import com.seibel.distanthorizons.api.enums.config.EDhApiMcRenderingFadeMode;
-import com.seibel.distanthorizons.api.methods.events.abstractEvents.DhApiBeforeRenderEvent;
-import com.seibel.distanthorizons.api.methods.events.sharedParameterObjects.DhApiCancelableEventParam;
-import com.seibel.distanthorizons.api.methods.events.sharedParameterObjects.DhApiRenderParam;
-import com.seibel.distanthorizons.core.config.Config;
-import com.seibel.distanthorizons.core.config.listeners.IConfigListener;
-import com.seibel.distanthorizons.core.logging.DhLogger;
-import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
-import com.seibel.distanthorizons.coreapi.util.StringUtil;
-
-public class IgnoredDimensionCsvHandler extends DhApiBeforeRenderEvent implements IConfigListener
-{
-	private static final DhLogger LOGGER = new DhLoggerBuilder().build();
-	
-	public static IgnoredDimensionCsvHandler INSTANCE = new IgnoredDimensionCsvHandler();
-	
-	private String[] dimensionNames = null;
-	
-	
-	
-	//=============//
- 	// constructor //
-	//=============//
-	
-	/** private since we only ever need one handler at a time */
-	private IgnoredDimensionCsvHandler() { }
-	
-	
-	
-	//=================//
-	// config handling //
-	//=================//
-	
-	@Override
-	public void onConfigValueSet()
-	{
-		String ignoredDimensionCsvString = Config.Client.Advanced.Graphics.Experimental.ignoredDimensionCsv.get();
-		if (ignoredDimensionCsvString == null 
-			|| ignoredDimensionCsvString.isEmpty())
-		{
-			LOGGER.info("Dimension ignoring disabled, DH will render all dimensions.");
-			this.dimensionNames = null;
-		}
-		else
-		{
-			try
-			{
-				this.dimensionNames = ignoredDimensionCsvString.split(",");
-				LOGGER.info("DH set to ignore dimensions: ["+ StringUtil.join(", ", this.dimensionNames)+"].");
-			}
-			catch (Exception e)
-			{
-				LOGGER.error("Failed to separate ignored dimensions from CSV string, error: ["+e.getMessage()+"].", e);
-				this.dimensionNames = null;
-			}
-		}
-		
-	}
-	
-	
-	
-	//===================//
-	// external handling //
-	//===================//
-	
-	@Override
-	public void beforeRender(DhApiCancelableEventParam<DhApiRenderParam> event)
-	{
-		String dimName = event.value.clientLevelWrapper.getDimensionName();
-		if (IgnoredDimensionCsvHandler.INSTANCE.dimensionNameShouldBeIgnored(dimName))
-		{
-			event.cancelEvent();
-			Config.Client.Advanced.Graphics.Fog.enableVanillaFog.setApiValue(true);
-			Config.Client.Advanced.Graphics.Quality.vanillaFadeMode.setApiValue(EDhApiMcRenderingFadeMode.NONE);
-		}
-		else
-		{
-			Config.Client.Advanced.Graphics.Fog.enableVanillaFog.setApiValue(null);
-			Config.Client.Advanced.Graphics.Quality.vanillaFadeMode.setApiValue(null);
-		}
-	}
-	
-	public boolean dimensionNameShouldBeIgnored(String dimName)
-	{
-		if (this.dimensionNames == null 
-			|| this.dimensionNames.length == 0)
-		{
-			return false;
-		}
-		
-		for (int i = 0; i < this.dimensionNames.length; i++)
-		{
-			String dimNameToIgnore = this.dimensionNames[i];
-			if (dimName.equalsIgnoreCase(dimNameToIgnore))
-			{
-				return true;
-			}
-		}
-		
-		return false;
-	}
-	
-	
-}
@@ -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
 		}
 	}
 	
-	
 }
@@ -1,69 +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.eventHandlers;
-
-import com.seibel.distanthorizons.api.DhApi;
-import com.seibel.distanthorizons.api.enums.config.EDhApiMcRenderingFadeMode;
-import com.seibel.distanthorizons.api.methods.events.abstractEvents.DhApiBeforeRenderEvent;
-import com.seibel.distanthorizons.api.methods.events.sharedParameterObjects.DhApiCancelableEventParam;
-import com.seibel.distanthorizons.api.methods.events.sharedParameterObjects.DhApiRenderParam;
-import com.seibel.distanthorizons.core.config.Config;
-import com.seibel.distanthorizons.core.config.listeners.IConfigListener;
-import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
-import com.seibel.distanthorizons.core.logging.DhLogger;
-import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
-import com.seibel.distanthorizons.core.wrapperInterfaces.IWrapperFactory;
-import com.seibel.distanthorizons.coreapi.util.StringUtil;
-
-public class RenderBlockCacheCsvHandler implements IConfigListener
-{
-	private static final DhLogger LOGGER = new DhLoggerBuilder().build();
-	
-	public static RenderBlockCacheCsvHandler INSTANCE = new RenderBlockCacheCsvHandler();
-	
-	
-	
-	//=============//
- 	// constructor //
-	//=============//
-	
-	/** private since we only ever need one handler at a time */
-	private RenderBlockCacheCsvHandler() { }
-	
-	
-	
-	//=================//
-	// config handling //
-	//=================//
-	
-	@Override
-	public void onConfigValueSet()
-	{
-		IWrapperFactory wrapperFactory = SingletonInjector.INSTANCE.get(IWrapperFactory.class);
-		if (wrapperFactory != null)
-		{
-			wrapperFactory.resetCachedIgnoredBlocksSets();
-			DhApi.Delayed.renderProxy.clearRenderDataCache();
-		}
-	}
-	
-	
-	
-}
@@ -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);
+	}
+	
+}
@@ -20,22 +20,23 @@
 package com.seibel.distanthorizons.core.config.eventHandlers;

 import com.seibel.distanthorizons.core.config.Config;
-import com.seibel.distanthorizons.core.config.ConfigHandler;
 import com.seibel.distanthorizons.core.config.listeners.IConfigListener;

-/** 
- * handles enabling/disabling config validation when the
- * {@link Config.Client.Advanced.Debugging#allowUnsafeValues} option
- * is changed.
- */
 public class UnsafeValuesConfigListener implements IConfigListener
 {
 	public static UnsafeValuesConfigListener INSTANCE = new UnsafeValuesConfigListener();
 	
 	@Override
 	public void onConfigValueSet()
-	{ ConfigHandler.INSTANCE.runMinMaxValidation = !Config.Client.Advanced.Debugging.allowUnsafeValues.get(); }
-	
+	{
+		Config.Client.Advanced.Debugging.allowUnsafeValues.configBase.disableMinMax =
+				Config.Client.Advanced.Debugging.allowUnsafeValues.get();
+	}
 	
+	@Override
+	public void onUiModify()
+	{
+		
+	}
 	
 }
@@ -35,7 +35,7 @@ public class WorldCurvatureConfigEventHandler implements IConfigListener
 {
 	public static WorldCurvatureConfigEventHandler INSTANCE = new WorldCurvatureConfigEventHandler();
 	
-	public static final int MIN_VALID_CURVE_VALUE = 50; 
+	private static final int MIN_VALID_CURVE_VALUE = 50; 
 	
 	
 	/** private since we only ever need one handler at a time */
@@ -52,11 +52,6 @@ public class WorldCurvatureConfigEventHandler implements IConfigListener
 			// shouldn't update the UI, otherwise we may end up fighting the user
 			Config.Client.Advanced.Graphics.Experimental.earthCurveRatio.set(MIN_VALID_CURVE_VALUE);
 		}
-		else if (curveRatio < 0 && curveRatio > -MIN_VALID_CURVE_VALUE)
-		{
-			// same as above, but in the negative direction
-			Config.Client.Advanced.Graphics.Experimental.earthCurveRatio.set(-MIN_VALID_CURVE_VALUE);
-		}
 		
 	}
 	
@@ -19,30 +19,30 @@

 package com.seibel.distanthorizons.core.config.eventHandlers.presets;

-import com.seibel.distanthorizons.core.config.ConfigHandler;
-import com.seibel.distanthorizons.core.config.ConfigPresetOptions;
+import com.seibel.distanthorizons.core.config.ConfigBase;
+import com.seibel.distanthorizons.core.config.ConfigEntryWithPresetOptions;
 import com.seibel.distanthorizons.core.config.listeners.IConfigListener;
-import com.seibel.distanthorizons.core.config.types.AbstractConfigBase;
 import com.seibel.distanthorizons.core.dependencyInjection.SingletonInjector;
-import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
 import com.seibel.distanthorizons.core.util.TimerUtil;
 import com.seibel.distanthorizons.core.wrapperInterfaces.config.IConfigGui;
+import com.seibel.distanthorizons.coreapi.interfaces.config.IConfigEntry;
 import com.seibel.distanthorizons.coreapi.util.StringUtil;
 import org.apache.logging.log4j.LogManager;
-import com.seibel.distanthorizons.core.logging.DhLogger;
+import org.apache.logging.log4j.Logger;
 import org.jetbrains.annotations.Nullable;

 import java.util.*;

 public abstract class AbstractPresetConfigEventHandler<TPresetEnum extends Enum<?>> implements IConfigListener
 {
-	private static final DhLogger LOGGER = new DhLoggerBuilder().build();
+	private static final Logger LOGGER = LogManager.getLogger();
 	private static final long MS_DELAY_BEFORE_APPLYING_PRESET = 3_000;
 	
 	@Nullable
-	private static final IConfigGui CONFIG_GUI = SingletonInjector.INSTANCE.get(IConfigGui.class);
+	private static IConfigGui configGui = SingletonInjector.INSTANCE.get(IConfigGui.class);
+	private static boolean guiListenersAdded = false;
 	
-	protected final ArrayList<ConfigPresetOptions<TPresetEnum, ?>> configList = new ArrayList<>();
+	protected final ArrayList<ConfigEntryWithPresetOptions<TPresetEnum, ?>> configList = new ArrayList<>();
 	/** this timer is used so each preset isn't applied while a user is clicking through the config options */
 	protected Timer applyPresetTimer = null;
 	/** the enum to apply after the timer expires or the UI screen changes. */
@@ -59,9 +59,9 @@ public abstract class AbstractPresetConfigEventHandler<TPresetEnum extends Enum<
 	public AbstractPresetConfigEventHandler()
 	{
 		// don't update the UI when running on a server
-		if (CONFIG_GUI != null) 
+		if (configGui != null) 
 		{
-			CONFIG_GUI.addOnScreenChangeListener(this::onConfigUiClosed);
+			configGui.addOnScreenChangeListener(this::onConfigUiClosed);
 		}
 	}
 	
@@ -90,7 +90,7 @@ public abstract class AbstractPresetConfigEventHandler<TPresetEnum extends Enum<
 	public void onConfigValueSet()
 	{
 		// don't try modifying the config before it's been loaded from file
-		if (!ConfigHandler.INSTANCE.isLoaded)
+		if (!ConfigBase.INSTANCE.isLoaded)
 		{
 			return;
 		}
@@ -140,11 +140,11 @@ public abstract class AbstractPresetConfigEventHandler<TPresetEnum extends Enum<
 		
 		
 		
-		LOGGER.debug("changing preset to: [" + newPresetEnum + "].");
+		LOGGER.info("changing preset to: " + newPresetEnum);
 		this.changingPreset = true;
 		
 		// update the controlled config values
-		for (ConfigPresetOptions<TPresetEnum, ?> configEntry : this.configList)
+		for (ConfigEntryWithPresetOptions<TPresetEnum, ?> configEntry : this.configList)
 		{
 			configEntry.updateConfigEntry(newPresetEnum);
 		}
@@ -152,7 +152,7 @@ public abstract class AbstractPresetConfigEventHandler<TPresetEnum extends Enum<
 		this.setUiOnlyConfigValues();
 		
 		this.changingPreset = false;
-		LOGGER.debug("preset active: [" + newPresetEnum + "].");
+		LOGGER.info("preset active: " + newPresetEnum);
 	}
 	
 	/**
@@ -200,7 +200,7 @@ public abstract class AbstractPresetConfigEventHandler<TPresetEnum extends Enum<
 		
 		
 		// remove any quick options that aren't possible with the currently selected options
-		for (ConfigPresetOptions<TPresetEnum, ?> configEntry : this.configList)
+		for (ConfigEntryWithPresetOptions<TPresetEnum, ?> configEntry : this.configList)
 		{
 			HashSet<TPresetEnum> optionPresetSet = configEntry.getPossibleQualitiesFromCurrentOptionValue();
 			possiblePresetSet.retainAll(optionPresetSet);
@@ -230,7 +230,7 @@ public abstract class AbstractPresetConfigEventHandler<TPresetEnum extends Enum<
 	// abstract methods //
 	//==================//
 	
-	protected abstract AbstractConfigBase<TPresetEnum> getPresetConfigEntry();
+	protected abstract IConfigEntry<TPresetEnum> getPresetConfigEntry();
 	
 	protected abstract List<TPresetEnum> getPresetEnumList();
 	protected abstract TPresetEnum getCustomPresetEnum();
@@ -0,0 +1,63 @@
+/*
+ *    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.presets;
+
+import com.seibel.distanthorizons.api.enums.rendering.EDhApiRendererMode;
+import com.seibel.distanthorizons.api.enums.worldGeneration.EDhApiDistantGeneratorProgressDisplayLocation;
+import com.seibel.distanthorizons.core.config.Config;
+import com.seibel.distanthorizons.core.config.listeners.ConfigChangeListener;
+
+public class QuickShowWorldGenProgressConfigEventHandler
+{
+	public static QuickShowWorldGenProgressConfigEventHandler INSTANCE = new QuickShowWorldGenProgressConfigEventHandler();
+	
+	private final ConfigChangeListener<Boolean> quickChangeListener;
+	private final ConfigChangeListener<EDhApiDistantGeneratorProgressDisplayLocation> fullChangeListener;
+	
+	
+	
+	/** private since we only ever need one handler at a time */
+	private QuickShowWorldGenProgressConfigEventHandler()
+	{
+		this.quickChangeListener = new ConfigChangeListener<>(Config.Client.quickShowWorldGenProgress, 
+				(val) -> 
+				{
+					Config.Common.WorldGenerator.showGenerationProgress.set(Config.Client.quickShowWorldGenProgress.get() 
+							? Config.Common.WorldGenerator.showGenerationProgress.getDefaultValue()
+							: EDhApiDistantGeneratorProgressDisplayLocation.DISABLED); 
+				});
+		this.fullChangeListener = new ConfigChangeListener<>(Config.Common.WorldGenerator.showGenerationProgress, 
+				(val) -> 
+				{
+					Config.Client.quickShowWorldGenProgress.set(Config.Common.WorldGenerator.showGenerationProgress.get() != EDhApiDistantGeneratorProgressDisplayLocation.DISABLED); 
+				});
+	}
+	
+	/**
+	 * Set the UI only config based on what is set in the file. <br>
+	 * This should only be called once.
+	 */
+	public void setUiOnlyConfigValues()
+	{
+		boolean showProgress = Config.Common.WorldGenerator.showGenerationProgress.get() != EDhApiDistantGeneratorProgressDisplayLocation.DISABLED;
+		Config.Client.quickShowWorldGenProgress.set(showProgress);
+	}
+	
+}
@@ -26,11 +26,11 @@ import com.seibel.distanthorizons.api.enums.config.EDhApiVerticalQuality;
 import com.seibel.distanthorizons.api.enums.config.quickOptions.EDhApiQualityPreset;
 import com.seibel.distanthorizons.api.enums.rendering.EDhApiTransparency;
 import com.seibel.distanthorizons.core.config.Config;
-import com.seibel.distanthorizons.core.config.ConfigPresetOptions;
+import com.seibel.distanthorizons.core.config.ConfigEntryWithPresetOptions;
 import com.seibel.distanthorizons.core.config.listeners.ConfigChangeListener;
-import com.seibel.distanthorizons.core.config.types.AbstractConfigBase;
-import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
-import com.seibel.distanthorizons.core.logging.DhLogger;
+import com.seibel.distanthorizons.coreapi.interfaces.config.IConfigEntry;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;

 import java.util.*;

@@ -39,10 +39,10 @@ public class RenderQualityPresetConfigEventHandler extends AbstractPresetConfigE
 {
 	public static final RenderQualityPresetConfigEventHandler INSTANCE = new RenderQualityPresetConfigEventHandler();
 	
-	private static final DhLogger LOGGER = new DhLoggerBuilder().build();
+	private static final Logger LOGGER = LogManager.getLogger();
 	
 	
-	private final ConfigPresetOptions<EDhApiQualityPreset, EDhApiMaxHorizontalResolution> drawResolution = new ConfigPresetOptions<>(Config.Client.Advanced.Graphics.Quality.maxHorizontalResolution,
+	private final ConfigEntryWithPresetOptions<EDhApiQualityPreset, EDhApiMaxHorizontalResolution> drawResolution = new ConfigEntryWithPresetOptions<>(Config.Client.Advanced.Graphics.Quality.maxHorizontalResolution,
 			new HashMap<EDhApiQualityPreset, EDhApiMaxHorizontalResolution>()
 			{{
 				this.put(EDhApiQualityPreset.MINIMUM, EDhApiMaxHorizontalResolution.TWO_BLOCKS);
@@ -51,7 +51,7 @@ public class RenderQualityPresetConfigEventHandler extends AbstractPresetConfigE
 				this.put(EDhApiQualityPreset.HIGH, EDhApiMaxHorizontalResolution.BLOCK);
 				this.put(EDhApiQualityPreset.EXTREME, EDhApiMaxHorizontalResolution.BLOCK);
 			}});
-	private final ConfigPresetOptions<EDhApiQualityPreset, EDhApiVerticalQuality> verticalQuality = new ConfigPresetOptions<>(Config.Client.Advanced.Graphics.Quality.verticalQuality,
+	private final ConfigEntryWithPresetOptions<EDhApiQualityPreset, EDhApiVerticalQuality> verticalQuality = new ConfigEntryWithPresetOptions<>(Config.Client.Advanced.Graphics.Quality.verticalQuality,
 			new HashMap<EDhApiQualityPreset, EDhApiVerticalQuality>()
 			{{
 				this.put(EDhApiQualityPreset.MINIMUM, EDhApiVerticalQuality.HEIGHT_MAP);
@@ -60,7 +60,7 @@ public class RenderQualityPresetConfigEventHandler extends AbstractPresetConfigE
 				this.put(EDhApiQualityPreset.HIGH, EDhApiVerticalQuality.HIGH);
 				this.put(EDhApiQualityPreset.EXTREME, EDhApiVerticalQuality.EXTREME);
 			}});
-	private final ConfigPresetOptions<EDhApiQualityPreset, EDhApiHorizontalQuality> horizontalQuality = new ConfigPresetOptions<>(Config.Client.Advanced.Graphics.Quality.horizontalQuality,
+	private final ConfigEntryWithPresetOptions<EDhApiQualityPreset, EDhApiHorizontalQuality> horizontalQuality = new ConfigEntryWithPresetOptions<>(Config.Client.Advanced.Graphics.Quality.horizontalQuality,
 			new HashMap<EDhApiQualityPreset, EDhApiHorizontalQuality>()
 			{{
 				this.put(EDhApiQualityPreset.MINIMUM, EDhApiHorizontalQuality.LOWEST);
@@ -69,7 +69,7 @@ public class RenderQualityPresetConfigEventHandler extends AbstractPresetConfigE
 				this.put(EDhApiQualityPreset.HIGH, EDhApiHorizontalQuality.HIGH);
 				this.put(EDhApiQualityPreset.EXTREME, EDhApiHorizontalQuality.EXTREME);
 			}});
-	private final ConfigPresetOptions<EDhApiQualityPreset, EDhApiTransparency> transparency = new ConfigPresetOptions<>(Config.Client.Advanced.Graphics.Quality.transparency,
+	private final ConfigEntryWithPresetOptions<EDhApiQualityPreset, EDhApiTransparency> transparency = new ConfigEntryWithPresetOptions<>(Config.Client.Advanced.Graphics.Quality.transparency,
 			new HashMap<EDhApiQualityPreset, EDhApiTransparency>()
 			{{
 				this.put(EDhApiQualityPreset.MINIMUM, EDhApiTransparency.DISABLED);
@@ -78,7 +78,7 @@ public class RenderQualityPresetConfigEventHandler extends AbstractPresetConfigE
 				this.put(EDhApiQualityPreset.HIGH, EDhApiTransparency.COMPLETE);
 				this.put(EDhApiQualityPreset.EXTREME, EDhApiTransparency.COMPLETE);
 			}});
-	private final ConfigPresetOptions<EDhApiQualityPreset, Boolean> ssaoEnabled = new ConfigPresetOptions<>(Config.Client.Advanced.Graphics.enableSsao,
+	private final ConfigEntryWithPresetOptions<EDhApiQualityPreset, Boolean> ssaoEnabled = new ConfigEntryWithPresetOptions<>(Config.Client.Advanced.Graphics.Ssao.enableSsao,
 			new HashMap<EDhApiQualityPreset, Boolean>()
 			{{
 				this.put(EDhApiQualityPreset.MINIMUM, false);
@@ -87,7 +87,7 @@ public class RenderQualityPresetConfigEventHandler extends AbstractPresetConfigE
 				this.put(EDhApiQualityPreset.HIGH, true);
 				this.put(EDhApiQualityPreset.EXTREME, true);
 			}});
-	private final ConfigPresetOptions<EDhApiQualityPreset, EDhApiMcRenderingFadeMode> vanillaFade = new ConfigPresetOptions<>(Config.Client.Advanced.Graphics.Quality.vanillaFadeMode,
+	private final ConfigEntryWithPresetOptions<EDhApiQualityPreset, EDhApiMcRenderingFadeMode> vanillaFade = new ConfigEntryWithPresetOptions<>(Config.Client.Advanced.Graphics.Quality.vanillaFadeMode,
 			new HashMap<EDhApiQualityPreset, EDhApiMcRenderingFadeMode>()
 			{{
 				this.put(EDhApiQualityPreset.MINIMUM, EDhApiMcRenderingFadeMode.NONE);
@@ -96,16 +96,7 @@ public class RenderQualityPresetConfigEventHandler extends AbstractPresetConfigE
 				this.put(EDhApiQualityPreset.HIGH, EDhApiMcRenderingFadeMode.DOUBLE_PASS);
 				this.put(EDhApiQualityPreset.EXTREME, EDhApiMcRenderingFadeMode.DOUBLE_PASS);
 			}});
-	private final ConfigPresetOptions<EDhApiQualityPreset, Boolean> dhFadeFarClipPlane = new ConfigPresetOptions<>(Config.Client.Advanced.Graphics.Quality.dhFadeFarClipPlane,
-			new HashMap<EDhApiQualityPreset, Boolean>()
-			{{
-				this.put(EDhApiQualityPreset.MINIMUM, false);
-				this.put(EDhApiQualityPreset.LOW, false);
-				this.put(EDhApiQualityPreset.MEDIUM, true);
-				this.put(EDhApiQualityPreset.HIGH, true);
-				this.put(EDhApiQualityPreset.EXTREME, true);
-			}});
-	private final ConfigPresetOptions<EDhApiQualityPreset, Boolean> dhDither = new ConfigPresetOptions<>(Config.Client.Advanced.Graphics.Quality.ditherDhFade,
+	private final ConfigEntryWithPresetOptions<EDhApiQualityPreset, Boolean> dhDither = new ConfigEntryWithPresetOptions<>(Config.Client.Advanced.Graphics.Quality.ditherDhFade,
 			new HashMap<EDhApiQualityPreset, Boolean>()
 			{{
 				this.put(EDhApiQualityPreset.MINIMUM, false);
@@ -114,7 +105,7 @@ public class RenderQualityPresetConfigEventHandler extends AbstractPresetConfigE
 				this.put(EDhApiQualityPreset.HIGH, true);
 				this.put(EDhApiQualityPreset.EXTREME, true);
 			}});
-	private final ConfigPresetOptions<EDhApiQualityPreset, Boolean> caveCulling = new ConfigPresetOptions<>(Config.Client.Advanced.Graphics.Culling.enableCaveCulling,
+	private final ConfigEntryWithPresetOptions<EDhApiQualityPreset, Boolean> caveCulling = new ConfigEntryWithPresetOptions<>(Config.Client.Advanced.Graphics.Culling.enableCaveCulling,
 			new HashMap<EDhApiQualityPreset, Boolean>()
 			{{
 				this.put(EDhApiQualityPreset.MINIMUM, true);
@@ -123,15 +114,6 @@ public class RenderQualityPresetConfigEventHandler extends AbstractPresetConfigE
 				this.put(EDhApiQualityPreset.HIGH, false);
 				this.put(EDhApiQualityPreset.EXTREME, false);
 			}});
-	private final ConfigPresetOptions<EDhApiQualityPreset, Integer> biomeBlending = new ConfigPresetOptions<>(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);
-			}});
 		
 	
 	
@@ -148,14 +130,12 @@ public class RenderQualityPresetConfigEventHandler extends AbstractPresetConfigE
 		this.configList.add(this.horizontalQuality);
 		this.configList.add(this.transparency);
 		this.configList.add(this.ssaoEnabled);
-		this.configList.add(this.dhFadeFarClipPlane);
 		this.configList.add(this.vanillaFade);
 		this.configList.add(this.dhDither);
 		this.configList.add(this.caveCulling);
-		this.configList.add(this.biomeBlending);
 		
 		
-		for (ConfigPresetOptions<EDhApiQualityPreset, ?> config : this.configList)
+		for (ConfigEntryWithPresetOptions<EDhApiQualityPreset, ?> config : this.configList)
 		{
 			// ignore try-using, the listener should only ever be added once and should never be removed
 			new ConfigChangeListener<>(config.configEntry, (val) -> { this.onConfigValueChanged(); });
@@ -169,7 +149,7 @@ public class RenderQualityPresetConfigEventHandler extends AbstractPresetConfigE
 	//==============//
 	
 	@Override
-	protected AbstractConfigBase<EDhApiQualityPreset> getPresetConfigEntry() { return Config.Client.qualityPresetSetting; }
+	protected IConfigEntry<EDhApiQualityPreset> getPresetConfigEntry() { return Config.Client.qualityPresetSetting; }
 	
 	@Override
 	protected List<EDhApiQualityPreset> getPresetEnumList() { return Arrays.asList(EDhApiQualityPreset.values()); }
@@ -22,12 +22,11 @@ package com.seibel.distanthorizons.core.config.eventHandlers.presets;
 import com.seibel.distanthorizons.api.enums.config.quickOptions.EDhApiThreadPreset;
 import com.seibel.distanthorizons.core.config.listeners.ConfigChangeListener;
 import com.seibel.distanthorizons.core.config.Config;
-import com.seibel.distanthorizons.core.config.ConfigPresetOptions;
-import com.seibel.distanthorizons.core.config.types.AbstractConfigBase;
-import com.seibel.distanthorizons.core.logging.DhLoggerBuilder;
+import com.seibel.distanthorizons.core.config.ConfigEntryWithPresetOptions;
+import com.seibel.distanthorizons.coreapi.interfaces.config.IConfigEntry;
 import com.seibel.distanthorizons.coreapi.util.MathUtil;
 import org.apache.logging.log4j.LogManager;
-import com.seibel.distanthorizons.core.logging.DhLogger;
+import org.apache.logging.log4j.Logger;

 import java.util.Arrays;
 import java.util.HashMap;
@@ -38,11 +37,11 @@ public class ThreadPresetConfigEventHandler extends AbstractPresetConfigEventHan
 {
 	public static final ThreadPresetConfigEventHandler INSTANCE = new ThreadPresetConfigEventHandler();
 	
-	private static final DhLogger LOGGER = new DhLoggerBuilder().build();
+	private static final Logger LOGGER = LogManager.getLogger();
 	
 	
 	public static int getDefaultThreadCount() { return getThreadCountByPercent(0.5); }
-	private final ConfigPresetOptions<EDhApiThreadPreset, Integer> threadCount = new ConfigPresetOptions<>(Config.Common.MultiThreading.numberOfThreads,
+	private final ConfigEntryWithPresetOptions<EDhApiThreadPreset, Integer> threadCount = new ConfigEntryWithPresetOptions<>(Config.Common.MultiThreading.numberOfThreads,
 			new HashMap<EDhApiThreadPreset, Integer>()
 			{{
 				this.put(EDhApiThreadPreset.MINIMAL_IMPACT, getThreadCountByPercent(0.1));
@@ -52,7 +51,7 @@ public class ThreadPresetConfigEventHandler extends AbstractPresetConfigEventHan
 				this.put(EDhApiThreadPreset.I_PAID_FOR_THE_WHOLE_CPU, getThreadCountByPercent(1.0));
 			}});
 	public static double getDefaultRunTimeRatio() { return 1.0; }
-	private final ConfigPresetOptions<EDhApiThreadPreset, Double> threadRunTime = new ConfigPresetOptions<>(Config.Common.MultiThreading.threadRunTimeRatio,
+	private final ConfigEntryWithPresetOptions<EDhApiThreadPreset, Double> threadRunTime = new ConfigEntryWithPresetOptions<>(Config.Common.MultiThreading.threadRunTimeRatio,
 			new HashMap<EDhApiThreadPreset, Double>()
 			{{
 				this.put(EDhApiThreadPreset.MINIMAL_IMPACT, 0.5);
@@ -75,7 +74,7 @@ public class ThreadPresetConfigEventHandler extends AbstractPresetConfigEventHan
 		this.configList.add(this.threadCount);
 		this.configList.add(this.threadRunTime);
 		
-		for (ConfigPresetOptions<EDhApiThreadPreset, ?> config : this.configList)
+		for (ConfigEntryWithPresetOptions<EDhApiThreadPreset, ?> config : this.configList)
 		{
 			// ignore try-using, the listeners should only ever be added once and should never be removed
 			new ConfigChangeListener<>(config.configEntry, (val) -> { this.onConfigValueChanged(); });
@@ -120,7 +119,7 @@ public class ThreadPresetConfigEventHandler extends AbstractPresetConfigEventHan
 	//==============//
 	
 	@Override
-	protected AbstractConfigBase<EDhApiThreadPreset> getPresetConfigEntry() { return Config.Client.threadPresetSetting; }
+	protected IConfigEntry<EDhApiThreadPreset> getPresetConfigEntry() { return Config.Client.threadPresetSetting; }
 	
 	@Override
 	protected List<EDhApiThreadPreset> getPresetEnumList() { return Arrays.asList(EDhApiThreadPreset.values()); }
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
s809	338bfb9f9e	Bump protocol version	2025-08-01 23:11:17 +05:00
s809	37cb00b8e2	Add isLocalChunkUseAllowed config value	2025-08-01 23:10:37 +05:00