Made forge actually run! Renamed com.seibel.lod.core to com.seibel.lod.coreapi

I liked the terms "sparse" and "spotty", however the difference between the two based on their names was not obvious, which made differentiating between the two difficult.

Readme.md

@@ -17,5 +17,11 @@ It should be automatically included when pulling the full mod.
 XZ for Java (data compression)\
 https://tukaani.org/xz/java.html
 
-Toml for Java (config handeling)\
+Json & Toml for Java (config handling)\
 https://github.com/TheElectronWill/night-config
+
+SVG Salamander for SVG's\
+https://github.com/blackears/svgSalamander
+
+FlatLaf for theming (for development testing, may remove later)\
+https://www.formdev.com/flatlaf/

_Misc Files/IDE files/Gitlab Docker Container Setup.txt

@@ -0,0 +1,46 @@
+
+The following is short tutorial to setup and register a gitlab runner in a docker container on windows.
+Docker can be installed via a installer from their website and these instructions assume that has already been done.
+
+longer tutorials can be found at the following links:
+https://faun.pub/gitlab-runner-setup-run-in-docker-container-on-windows-44fee102d02e
+https://datawookie.dev/blog/2021/03/install-gitlab-runner-with-docker/
+
+
+1. install the gitlab runner
+run the following command in powershell, changing the config file location if need be
+Note: This will NOT work in git bash, only powershell
+
+docker run -d --name gitlab-runner --restart always -v C:\DistantHorizonsWorkspace\Docker\config:/etc/gitlab-runner -v /var/run/docker.sock:/var/run/docker.sock gitlab/gitlab-runner:latest
+
+
+2. to make sure the docker container was set up correctly run:
+docker container list
+
+it will display the docker containers that have been created
+
+
+3. start and register the runner
+run the following command in powershell. change the <ITEM>'s to whatever they should be for the runner you are creating.
+
+docker run --rm -t -i -v C:\gitlab-runner\config:/etc/gitlab-runner gitlab/gitlab-runner register --non-interactive --executor "docker" --docker-image alpine:latest --url "https://gitlab.com/" --registration-token "<TOKEN>" --description "<DESCRIPTION THAT SHOWS UP ON GITLAB>" --run-untagged="true" --locked="false"
+
+
+4. done
+at this point the runner should be up and running, to confirm this go to your:
+gitlab project -> settings (on the left menu bar) -> CI/CD -> Runners
+and you should see the newly registered runner (the description should show up under the runner's auto generated ID)
+
+
+
+Additional commands:
+
+manual registering (shouldn't be needed)
+docker exec -it gitlab-runner gitlab-runner register
+
+list gitlab runner info
+docker exec -it gitlab-runner gitlab-runner list
+
+list all commands the runner can use
+(replace "help" with whatever command you want to use)
+docker exec -it gitlab-runner gitlab-runner help

_Misc Files/logo files/LOD.svg

@@ -0,0 +1,64 @@
+<?xml version="1.0" standalone="yes"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="2040" height="2040">
+    <!-- Distant Horizons logo in svg format -->
+    <!-- Converted svg made by coolGi -->
+    <!-- Made by hand so there may be inaccuracies -->
+
+
+
+    <!--
+        Colors used
+
+        Blue:         "fill:#465AA8"
+        Green:        "fill:#5C7E3C"
+        Wierd green:  "fill:#DCD7AA"
+    -->
+
+
+    <!-- Big Blue -->
+    <polygon points="1018.5,15 1434,255 1018.5,486 603,255" style="fill:#465AA8" />
+    <polygon points="1460,270 1875.5,509.5 1460,750 1045,509" style="fill:#465AA8" />
+    <polygon points="1889,531.5 1889,1012 1473,1252 1473,772" style="fill:#465AA8" />
+    <!-- Big Green -->
+    <polygon points="577,269 992,510 577,750 162,509.5" style="fill:#5C7E3C" />
+    <polygon points="149,532 564,772 564,1252 149,1012" style="fill:#5C7E3C" />
+    <polygon points="1889,1041 1889,1522 1474,1762 1473,1281" style="fill:#5C7E3C" />
+    <!-- Big Wierd Green -->
+    <polygon points="149,1042 564,1282 564,1762 149,1522" style="fill:#DCD7AA" />
+    <polygon points="590,1297 1006,1537 1006,2017 590,1777" style="fill:#DCD7AA" />
+    <polygon points="1031,1537 1447,1297 1447,1777 1031,2017" style="fill:#DCD7AA" />
+
+
+    <!-- Mid Blue -->
+    <polygon points="1239.5,652 1434,764.5 1239.5,877 1045,764.5" style="fill:#465AA8" />
+    <polygon points="1447,787 1447,1012 1252,1125 1252,899" style="fill:#465AA8" />
+    <!-- Mid Green -->
+    <polygon points="1018.5,525 1214,637 1018.5,749 824,637" style="fill:#5C7E3C" />
+    <polygon points="798,652 992,764.5 798,877 603,764.5" style="fill:#5C7E3C" />
+    <polygon points="590,787 785,899 785,1125 590,1012" style="fill:#5C7E3C" />
+    <polygon points="1447,1042 1447,1267 1252,1380 1252,1154" style="fill:#5C7E3C" />
+    <polygon points="1226,1170 1226,1395 1031,1507 1031,1282" style="fill:#5C7E3C" />
+    <!-- Mid Wierd Green -->
+    <polygon points="590,1042 785,1154 785,1379 590,1267" style="fill:#DCD7AA" />
+    <polygon points="811,1169 1006,1282 1006,1507 811,1395" style="fill:#DCD7AA" />
+
+    <!-- Out Small Blue -->
+    <polygon points="1018.5,779.5 1103,828 1018.5,877 934,828" style="fill:#465AA8" />
+    <polygon points="1129,843 1214,892 1129,941 1044,892" style="fill:#465AA8" />
+    <polygon points="1226,914 1226,1012 1142,1061 1142,963" style="fill:#465AA8" />
+    <polygon points="1226,1042 1226,1140 1142,1188 1142,1090" style="fill:#465AA8" />
+    <polygon points="1116,1105 1116,1203 1031,1252 1031,1154" style="fill:#465AA8" />
+    <!-- Out Small Green -->
+    <polygon points="908,843 993,892 908,941 823,892" style="fill:#5C7E3C" />
+    <polygon points="811,914 895,963 895,1061 811,1012" style="fill:#5C7E3C" />
+    <polygon points="921,1105 1006,1154 1006,1252 921,1203" style="fill:#5C7E3C" />
+    <!-- Out Small Wierd Green -->
+    <polygon points="811,1042 895,1090 895,1188 811,1140" style="fill:#DCD7AA" />
+
+    <!-- In Small Blue -->
+    <polygon points="1116,978 1116,1076 1031,1125 1031,1027" style="fill:#465AA8" />
+    <!-- In Small Green -->
+    <polygon points="1018.5,907 1103,956 1018.5,1004 934,956" style="fill:#5C7E3C" />
+    <polygon points="921,978 1006,1027 1006,1125 921,1076" style="fill:#5C7E3C" />
+</svg>
+

_Misc Files/setup documentation/AnotherQuestion/Dockerfile

@@ -0,0 +1,4 @@
+FROM anapsix/alpine-java
+MAINTAINER Ran 
+COPY anotherquestion-1.0-SNAPSHOT.jar /home/anotherquestion-1.0-SNAPSHOT.jar
+CMD ["java","-jar","/home/anotherquestion-1.0-SNAPSHOT.jar"]

api/src/main/java/com/seibel/lod/api/DhApiMain.java

@@ -0,0 +1,93 @@
+package com.seibel.lod.api;
+
+import com.seibel.lod.api.interfaces.config.IDhApiConfig;
+import com.seibel.lod.api.interfaces.override.IDhApiOverrideable;
+import com.seibel.lod.api.interfaces.override.worldGenerator.IDhApiWorldGeneratorOverrideRegister;
+import com.seibel.lod.api.interfaces.render.IDhApiRenderProxy;
+import com.seibel.lod.api.interfaces.world.IDhApiWorldProxy;
+import com.seibel.lod.api.methods.override.DhApiWorldGeneratorOverrideRegister;
+import com.seibel.lod.coreapi.DependencyInjection.ApiEventInjector;
+import com.seibel.lod.coreapi.DependencyInjection.OverrideInjector;
+import com.seibel.lod.coreapi.ModInfo;
+import com.seibel.lod.api.interfaces.data.IDhApiTerrainDataRepo;
+import com.seibel.lod.api.interfaces.events.IDhApiEventInjector;
+import com.seibel.lod.coreapi.interfaces.dependencyInjection.IOverrideInjector;
+
+/**
+ * This is the masthead of the API, almost everything you could want to do
+ * can be achieved from here. <br>
+ * For example: you can access singletons which handle the config or event binding. <br><br>
+ * 
+ * <strong>Q:</strong> Why should I use this class instead of just getting the API singleton I need? <br>
+ * 
+ * <strong>A:</strong> This way there is a lower chance of your code breaking if we change something on our end.
+ * For example, if we realized there is a much better way of handling dependency injection we would keep the
+ * interface the same so your code doesn't have to change. Whereas if you were directly referencing 
+ * the concrete object we replaced, there would be issues.
+ *
+ * @author James Seibel
+ * @version 2023-2-9
+ */
+public class DhApiMain
+{
+	/** 
+	 * <strong>WARNING:</strong> 
+	 * All objects in this class will be null until after DH initializes for the first time. <br><br>
+	 * 
+	 * Bind a custom {@link com.seibel.lod.api.methods.events.abstractEvents.DhApiAfterDhInitEvent DhApiAfterDhInitEvent}
+	 * to {@link DhApiMain#events ApiCoreInjectors.events} in order to be notified when this class can
+	 * be safely used.
+	 */
+	public static class Delayed
+	{
+		/** Used to interact with Distant Horizons' Configs. */
+		public static IDhApiConfig configs = null;
+		
+		/** 
+		 * Used to interact with Distant Horizons' terrain data. 
+		 * Designed to be used in conjunction with {@link DhApiMain.Delayed#worldProxy}.
+		 */
+		public static IDhApiTerrainDataRepo terrainRepo = null;
+		
+		/**
+		 * Used to interact with Distant Horizons' currently loaded world.
+		 * Designed to be used in conjunction with {@link DhApiMain.Delayed#terrainRepo}.
+		 */
+		public static IDhApiWorldProxy worldProxy = null;
+		
+		/** Used to interact with Distant Horizons' rendering system. */
+		public static IDhApiRenderProxy renderProxy = null;
+		
+	}
+	
+	
+	// always available //
+	
+	/** Used to bind/unbind Distant Horizons Api events. */
+	public static final IDhApiEventInjector events = ApiEventInjector.INSTANCE;
+	
+	/** Used to bind/unbind Distant Horizons Api events. */
+	public static final IDhApiWorldGeneratorOverrideRegister worldGenOverrides = DhApiWorldGeneratorOverrideRegister.INSTANCE;
+	
+	/** Used to bind overrides to change Distant Horizons' core behavior. */
+	public static final IOverrideInjector<IDhApiOverrideable> overrides = OverrideInjector.INSTANCE;
+	
+	
+	/** This version should only be updated when breaking changes are introduced to the Distant Horizons API. */
+	public static int getApiMajorVersion() { return ModInfo.API_MAJOR_VERSION; }
+	/** This version should be updated whenever new methods are added to the Distant Horizons API. */
+	public static int getApiMinorVersion() { return ModInfo.API_MINOR_VERSION; }
+	
+	/** 
+	 * Returns the mod's semantic version number in the format: Major.Minor.Patch 
+	 * with optional extensions "-a" for alpha, "-b" for beta, and -dev for unstable development builds. <br>
+	 * Examples: "1.6.9-a", "1.7.0-a-dev", "2.1.0-b", "3.0.0", "3.1.4-dev"
+	 */
+	public static String getModVersion() { return ModInfo.VERSION; }
+	/** Returns true if the mod is a development version, false if it is a release version. */
+	public static boolean getIsDevVersion() { return ModInfo.IS_DEV_BUILD; }
+	
+	/** Returns the network protocol version. */
+	public static int getNetworkProtocolVersion() { return ModInfo.PROTOCOL_VERSION; }
+	
+}

api/src/main/java/com/seibel/lod/api/Readme.md

@@ -0,0 +1 @@
+The external api package holds any code that interfaces between Distant Horizons and other mods or projects.

api/src/main/java/com/seibel/lod/api/enums/EDhApiDetailLevel.java

@@ -0,0 +1,52 @@
+package com.seibel.lod.api.enums;
+
+/**
+ * BLOCK  - Detail Level: 0, width 1 block, <br>
+ * CHUNK  - Detail Level: 4, width 16 block, <br>
+ * REGION - Detail Level: 9, width 512 block <br> <br>
+ *
+ * Detail levels in Distant Horizons represent how large a section (of either LODs or MC chunks)
+ * is, with the smallest being 0 (1 block wide). <br>
+ * The width of a detail level can be calculated by putting the detail level to the power of 2. <br>
+ * Example for the chunk detail level (4): 2^4 = 16 blocks wide <Br><br>
+ * 
+ * This enum doesn't contain all valid detail levels, only those most likely to be needed.
+ * Detail levels 1,2,3, ... 255 are all technically valid detail levels 
+ * (although anything beyond {@link EDhApiDetailLevel#REGION} may be difficult deal with). 
+ * 
+ * @author James Seibel
+ * @version 2022-12-5
+ */
+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 
+	 */
+	BLOCK(0, 1),
+	/**
+	 * detail level: 4 <Br>
+	 * width in Blocks: 16 
+	 */
+	CHUNK(4, 16),
+	/**
+	 * detail level: 9 <Br>
+	 * width in Blocks: 512
+	 */
+	REGION(9, 512);
+	
+	
+	public final byte detailLevel;
+	public final byte widthInBlocks;
+	
+	EDhApiDetailLevel(int detailLevel, int widthInBlocks)
+	{
+		this.detailLevel = (byte) detailLevel;
+		this.widthInBlocks = (byte) widthInBlocks;
+	}
+	
+}

api/src/main/java/com/seibel/lod/api/enums/config/EBlocksToAvoid.java

@@ -1,33 +1,39 @@
 /*
  *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
- *    licensed under the GNU GPL v3 License.
+ *    licensed under the GNU LGPL v3 License.
  *
  *    Copyright (C) 2020-2022  James Seibel
  *
  *    This program is free software: you can redistribute it and/or modify
- *    it under the terms of the GNU General Public License as published by
+ *    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 General Public License for more details.
+ *    GNU Lesser General Public License for more details.
  *
- *    You should have received a copy of the GNU General Public License
+ *    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.lod.core.enums.config;
+package com.seibel.lod.api.enums.config;
 
 /**
- * heightmap <br>
- * multi_lod <br>
- * 
+ * NONE, <br>
+ * NON_FULL, <br>
+ * NO_COLLISION, <br>
+ * BOTH, <br>
+ *
  * @author Leonardo Amato
- * @version 11-16-2021
+ * @version 2022-7-1
  */
-public enum BlocksToAvoid
+public enum EBlocksToAvoid
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
 	NONE(false, false),
 	
 	NON_FULL(true, false),
@@ -39,7 +45,7 @@ public enum BlocksToAvoid
 	public final boolean nonFull;
 	public final boolean noCollision;
 	
-	BlocksToAvoid(boolean nonFull, boolean noCollision)
+	EBlocksToAvoid(boolean nonFull, boolean noCollision)
 	{
 		this.nonFull = nonFull;
 		this.noCollision = noCollision;

api/src/main/java/com/seibel/lod/api/enums/config/EBufferRebuildTimes.java

@@ -1,35 +1,36 @@
 /*
  *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
- *    licensed under the GNU GPL v3 License.
+ *    licensed under the GNU LGPL v3 License.
  *
  *    Copyright (C) 2020-2022  James Seibel
  *
  *    This program is free software: you can redistribute it and/or modify
- *    it under the terms of the GNU General Public License as published by
+ *    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 General Public License for more details.
+ *    GNU Lesser General Public License for more details.
  *
- *    You should have received a copy of the GNU General Public License
+ *    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.lod.core.enums.config;
+package com.seibel.lod.api.enums.config;
 
 /**
+ * CONSTANT <br>
  * FREQUENT <br>
  * NORMAL <br>
- * RARE <br>
- * <br>
- * Determines how fast the buffers need to be regenerated
+ * RARE <br> <br>
+ *
+ * Determines how fast the buffers should be regenerated
  * 
  * @author Leonardo Amato
  * @version 9-25-2021
  */
-public enum BufferRebuildTimes
+public enum EBufferRebuildTimes
 {
 	CONSTANT(0, 0, 0, 1),
 	
@@ -44,7 +45,7 @@ public enum BufferRebuildTimes
 	public final int chunkChangeTimeout;
 	public final int playerMoveDistance;
 	
-	BufferRebuildTimes(int playerMoveTimeout, int renderedChunkTimeout, int chunkChangeTimeout, int playerMoveDistance)
+	EBufferRebuildTimes(int playerMoveTimeout, int renderedChunkTimeout, int chunkChangeTimeout, int playerMoveDistance)
 	{
 		this.playerMoveTimeout = playerMoveTimeout;
 		this.renderedChunkTimeout = renderedChunkTimeout;

api/src/main/java/com/seibel/lod/api/enums/config/EGenerationPriority.java

@@ -1,37 +1,41 @@
 /*
  *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
- *    licensed under the GNU GPL v3 License.
+ *    licensed under the GNU LGPL v3 License.
  *
  *    Copyright (C) 2020-2022  James Seibel
  *
  *    This program is free software: you can redistribute it and/or modify
- *    it under the terms of the GNU General Public License as published by
+ *    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 General Public License for more details.
+ *    GNU Lesser General Public License for more details.
  *
- *    You should have received a copy of the GNU General Public License
+ *    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.lod.core.enums.config;
+package com.seibel.lod.api.enums.config;
 
 /**
  * AUTO <br>
  * Near_First <br>
- * Far_First <br>
- * <br>
+ * Far_First <br> <br>
+ *
  * Determines which LODs should have priority when generating
  * outside the normal view distance.
  * 
  * @author Leonardo Amato
  * @version 12-1-2021
  */
-public enum GenerationPriority
+public enum EGenerationPriority
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
 	/** NEAR_FIRST when connected to servers and BALANCED when on single player */
 	AUTO,
 	

api/src/main/java/com/seibel/lod/api/enums/config/EGpuUploadMethod.java

@@ -1,38 +1,42 @@
 /*
  *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
- *    licensed under the GNU GPL v3 License.
+ *    licensed under the GNU LGPL v3 License.
  *
  *    Copyright (C) 2020-2022  James Seibel
  *
  *    This program is free software: you can redistribute it and/or modify
- *    it under the terms of the GNU General Public License as published by
+ *    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 General Public License for more details.
+ *    GNU Lesser General Public License for more details.
  *
- *    You should have received a copy of the GNU General Public License
+ *    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.lod.core.enums.config;
+package com.seibel.lod.api.enums.config;
 
 /**
- * Auto, BUFFER_STORAGE_MAPPING, Buffer_Storage, Sub_Data, Buffer_Mapping, Data
- * 
+ * AUTO, 					<br>
+ * BUFFER_STORAGE, 			<br>
+ * SUB_DATA, 				<br>
+ * BUFFER_MAPPING, 			<br>
+ * DATA						<br>
+ *
+ * @author Leetom
  * @author James Seibel
- * @version 12-1-2021
+ * @version 2022-7-2
  */
-public enum GpuUploadMethod
+public enum EGpuUploadMethod
 {
 	/** Picks the best option based on the GPU the user has. */
 	AUTO(false, false),
 
-	/*
-	 */
-	BUFFER_STORAGE_MAPPING(true, true),
+	// commented out since it isn't currently in use
+	//BUFFER_STORAGE_MAPPING(true, true),
 	
 	/**
 	 * Default for NVIDIA if OpenGL 4.5 is supported. <br>
@@ -60,9 +64,13 @@ public enum GpuUploadMethod
 	 */
 	DATA(false, false);
 	
+	
+	
 	public final boolean useEarlyMapping;
 	public final boolean useBufferStorage;
-	GpuUploadMethod(boolean useEarlyMapping, boolean useBufferStorage) {
+	
+	EGpuUploadMethod(boolean useEarlyMapping, boolean useBufferStorage)
+	{
 		this.useEarlyMapping = useEarlyMapping;
 		this.useBufferStorage = useBufferStorage;
 	}

api/src/main/java/com/seibel/lod/api/enums/config/EHorizontalQuality.java

@@ -1,37 +1,42 @@
 /*
  *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
- *    licensed under the GNU GPL v3 License.
+ *    licensed under the GNU LGPL v3 License.
  *
  *    Copyright (C) 2020-2022  James Seibel
  *
  *    This program is free software: you can redistribute it and/or modify
- *    it under the terms of the GNU General Public License as published by
+ *    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 General Public License for more details.
+ *    GNU Lesser General Public License for more details.
  *
- *    You should have received a copy of the GNU General Public License
+ *    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.lod.core.enums.config;
+package com.seibel.lod.api.enums.config;
 
 /**
- * Lowest <br>
- * Low <br>
- * Medium <br>
- * High <br>
- * <br>
- * this indicates the base of the quadratic function we use for the quality drop off
+ * LOWEST <br>
+ * LOW <br>
+ * MEDIUM <br>
+ * HIGH <br> <br>
+ *
+ * this indicates the base of the quadratic function we use for the quality drop-off
  * 
  * @author Leonardo Amato
  * @version 9-29-2021
  */
-public enum HorizontalQuality
+public enum EHorizontalQuality
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
+	
 	/** 1.0 AKA Linear */
 	LOWEST(1.0f),
 	
@@ -46,7 +51,7 @@ public enum HorizontalQuality
 	
 	public final double quadraticBase;
 	
-	HorizontalQuality(double distanceUnit)
+	EHorizontalQuality(double distanceUnit)
 	{
 		this.quadraticBase = distanceUnit;
 	}

api/src/main/java/com/seibel/lod/api/enums/config/EHorizontalResolution.java

@@ -1,41 +1,41 @@
 /*
  *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
- *    licensed under the GNU GPL v3 License.
+ *    licensed under the GNU LGPL v3 License.
  *
  *    Copyright (C) 2020-2022  James Seibel
  *
  *    This program is free software: you can redistribute it and/or modify
- *    it under the terms of the GNU General Public License as published by
+ *    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 General Public License for more details.
+ *    GNU Lesser General Public License for more details.
  *
- *    You should have received a copy of the GNU General Public License
+ *    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.lod.core.enums.config;
+package com.seibel.lod.api.enums.config;
 
 import java.util.ArrayList;
 import java.util.Collections;
 
-import com.seibel.lod.core.util.LodUtil;
+import com.seibel.lod.coreapi.util.MathUtil;
 
 /**
- * chunk <Br>
- * half_chunk <Br>
- * four_blocks <br>
- * two_blocks <Br>
- * block <br>
+ * BLOCK <Br>
+ * TWO_BLOCKS <Br>
+ * FOUR_BLOCKS <br>
+ * HALF_CHUNK <Br>
+ * CHUNK <br>
  * 
  * @author James Seibel
  * @author Leonardo Amato
- * @version 9-25-2021
+ * @version 2022-7-5
  */
-public enum HorizontalResolution
+public enum EHorizontalResolution
 {
 	/** render 256 LODs for each chunk */
 	BLOCK(16, 0),
@@ -85,12 +85,12 @@ public enum HorizontalResolution
 	 * 2nd dimension: An array of all LodDetails that are less than or <br>
 	 * equal to that detailLevel
 	 */
-	private static HorizontalResolution[][] lowerDetailArrays;
+	private static EHorizontalResolution[][] lowerDetailArrays;
 	
 	
 	
 	
-	HorizontalResolution(int newLengthCount, int newDetailLevel)
+	EHorizontalResolution(int newLengthCount, int newDetailLevel)
 	{
 		detailLevel = (byte) newDetailLevel;
 		dataPointLengthCount = newLengthCount;
@@ -129,20 +129,20 @@ public enum HorizontalResolution
 	 * Returns an array of all LodDetails that have a detail level
 	 * that is less than or equal to the given LodDetail
 	 */
-	public static HorizontalResolution[] getSelfAndLowerDetails(HorizontalResolution detail)
+	public static EHorizontalResolution[] getSelfAndLowerDetails(EHorizontalResolution detail)
 	{
 		if (lowerDetailArrays == null)
 		{
 			// run first time setup
-			lowerDetailArrays = new HorizontalResolution[HorizontalResolution.values().length][];
+			lowerDetailArrays = new EHorizontalResolution[EHorizontalResolution.values().length][];
 			
 			// go through each LodDetail
-			for (HorizontalResolution currentDetail : HorizontalResolution.values())
+			for (EHorizontalResolution currentDetail : EHorizontalResolution.values())
 			{
-				ArrayList<HorizontalResolution> lowerDetails = new ArrayList<>();
+				ArrayList<EHorizontalResolution> lowerDetails = new ArrayList<>();
 				
 				// find the details lower than currentDetail
-				for (HorizontalResolution compareDetail : HorizontalResolution.values())
+				for (EHorizontalResolution compareDetail : EHorizontalResolution.values())
 				{
 					if (currentDetail.detailLevel <= compareDetail.detailLevel)
 					{
@@ -154,7 +154,7 @@ public enum HorizontalResolution
 				Collections.sort(lowerDetails);
 				Collections.reverse(lowerDetails);
 				
-				lowerDetailArrays[currentDetail.detailLevel] = lowerDetails.toArray(new HorizontalResolution[lowerDetails.size()]);
+				lowerDetailArrays[currentDetail.detailLevel] = lowerDetails.toArray(new EHorizontalResolution[lowerDetails.size()]);
 			}
 		}
 		
@@ -162,11 +162,11 @@ public enum HorizontalResolution
 	}
 	
 	/** Returns what detail level should be used at a given distance and maxDistance. */
-	public static HorizontalResolution getDetailForDistance(HorizontalResolution maxDetailLevel, int distance, int maxDistance)
+	public static EHorizontalResolution getDetailForDistance(EHorizontalResolution maxDetailLevel, int distance, int maxDistance)
 	{
-		HorizontalResolution[] lowerDetails = getSelfAndLowerDetails(maxDetailLevel);
+		EHorizontalResolution[] lowerDetails = getSelfAndLowerDetails(maxDetailLevel);
 		int distanceBetweenDetails = maxDistance / lowerDetails.length;
-		int index = LodUtil.clamp(0, distance / distanceBetweenDetails, lowerDetails.length - 1);
+		int index = MathUtil.clamp(0, distance / distanceBetweenDetails, lowerDetails.length - 1);
 		
 		return lowerDetails[index];
 		

api/src/main/java/com/seibel/lod/api/enums/config/EHorizontalScale.java

@@ -1,23 +1,23 @@
 /*
  *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
- *    licensed under the GNU GPL v3 License.
+ *    licensed under the GNU LGPL v3 License.
  *
  *    Copyright (C) 2020-2022  James Seibel
  *
  *    This program is free software: you can redistribute it and/or modify
- *    it under the terms of the GNU General Public License as published by
+ *    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 General Public License for more details.
+ *    GNU Lesser General Public License for more details.
  *
- *    You should have received a copy of the GNU General Public License
+ *    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.lod.core.enums.config;
+package com.seibel.lod.api.enums.config;
 
 /**
  * Low <br>
@@ -29,7 +29,7 @@ package com.seibel.lod.core.enums.config;
  * @author Leonardo Amato
  * @version 9-25-2021
  */
-public enum HorizontalScale
+public enum EHorizontalScale
 {
 	/** Lods are 2D with heightMap */
 	LOW(64),
@@ -42,7 +42,7 @@ public enum HorizontalScale
 	
 	public final int distanceUnit;
 	
-	HorizontalScale(int distanceUnit)
+	EHorizontalScale(int distanceUnit)
 	{
 		this.distanceUnit = distanceUnit;
 	}

api/src/main/java/com/seibel/lod/api/enums/config/ELightGenerationMode.java

@@ -0,0 +1,40 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.enums.config;
+
+/**
+ * FAST, <br>
+ * FANCY,
+ *
+ * @author Leetom
+ * @version 2022-7-1
+ */
+public enum ELightGenerationMode
+{
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
+	/** Fake light values using a height map */
+	FAST,
+	
+	/** Run the lighting engine though the chunk to generate proper light values */
+	FANCY
+}

api/src/main/java/com/seibel/lod/api/enums/config/ELoggerMode.java

@@ -1,26 +1,27 @@
 /*
  *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
- *    licensed under the GNU GPL v3 License.
+ *    licensed under the GNU LGPL v3 License.
  *
  *    Copyright (C) 2020-2022  James Seibel
  *
  *    This program is free software: you can redistribute it and/or modify
- *    it under the terms of the GNU General Public License as published by
+ *    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 General Public License for more details.
+ *    GNU Lesser General Public License for more details.
  *
- *    You should have received a copy of the GNU General Public License
+ *    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.lod.core.enums.config;
+package com.seibel.lod.api.enums.config;
 import org.apache.logging.log4j.Level;
 
-public enum LoggerMode {
+public enum ELoggerMode
+{
     DISABLED(Level.OFF, Level.OFF),
     LOG_ALL_TO_FILE(Level.ALL, Level.OFF),
     LOG_ERROR_TO_CHAT(Level.ALL, Level.ERROR),
@@ -37,7 +38,7 @@ public enum LoggerMode {
     ;
     public final Level levelForFile;
     public final Level levelForChat;
-    LoggerMode(Level levelForFile, Level levelForChat) {
+    ELoggerMode(Level levelForFile, Level levelForChat) {
         this.levelForFile = levelForFile;
         this.levelForChat = levelForChat;
     }

api/src/main/java/com/seibel/lod/api/enums/config/EServerFolderNameMode.java

@@ -1,38 +1,43 @@
 /*
  *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
- *    licensed under the GNU GPL v3 License.
+ *    licensed under the GNU LGPL v3 License.
  *
  *    Copyright (C) 2022  Tom Lee (TomTheFurry)
  *    Copyright (C) 2020-2022  James Seibel
  *
  *    This program is free software: you can redistribute it and/or modify
- *    it under the terms of the GNU General Public License as published by
+ *    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 General Public License for more details.
+ *    GNU Lesser General Public License for more details.
  *
- *    You should have received a copy of the GNU General Public License
+ *    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.lod.core.enums.config;
+package com.seibel.lod.api.enums.config;
 
 /**
- * AUTO <br>
- * NAME_ONLY <br>
- * NAME_IP <br>
- * NAME_IP_PORT <br>
- * <br>
+ * AUTO, <br>
+ * NAME_ONLY, <br>
+ * NAME_IP, <br>
+ * NAME_IP_PORT, <br> <br>
+ *
  * Determines how the multiplayer folders should be named.
  * 
  * @author James Seibel
- * @version 3-7-2022
+ * @version 2022-7-1
  */
-public enum ServerFolderNameMode
+public enum EServerFolderNameMode
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
+	
 	/**
 	 * NAME_IP for LAN connections <Br>
 	 * NAME_IP_PORT for all others
@@ -44,25 +49,23 @@ public enum ServerFolderNameMode
 	
 	/** 
 	 * {SERVER_NAME} IP {IP} <br>
-	 * Minecraft Server IP 192.168.1.40 
+	 * Example: Minecraft Server IP 192.168.1.40
 	 */
 	NAME_IP,
 	
-	/** 
-	 * {SERVER_NAME} IP {IP} <br>
-	 * Minecraft Server IP 192.168.1.40:25565
+	/**
+	 * {SERVER_NAME} IP {IP}:{PORT} <br>
+	 * Example: Minecraft Server IP 192.168.1.40:25565
 	 */
 	NAME_IP_PORT,
 	
 	/** 
 	 * {SERVER_NAME} IP {IP} <br>
-	 * Minecraft Server IP 192.168.1.40:25565 GameVersion 1.16.5 <Br> <br>
+	 * Example: Minecraft Server IP 192.168.1.40:25565 GameVersion 1.16.5 <Br> <br>
 	 * 
 	 * Not normally recommended, since the game version can change if the
 	 * server installs paper or some other jar. <br>
 	 * This is just here to provide backwards compatibility.
-	 * 
-	 * TODO add this to config desc
 	 */
 	NAME_IP_PORT_MC_VERSION;
 	

api/src/main/java/com/seibel/lod/api/enums/config/EShadingMode.java

@@ -1,23 +1,23 @@
 /*
  *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
- *    licensed under the GNU GPL v3 License.
+ *    licensed under the GNU LGPL v3 License.
  *
  *    Copyright (C) 2020-2022  James Seibel
  *
  *    This program is free software: you can redistribute it and/or modify
- *    it under the terms of the GNU General Public License as published by
+ *    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 General Public License for more details.
+ *    GNU Lesser General Public License for more details.
  *
- *    You should have received a copy of the GNU General Public License
+ *    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.lod.core.enums.config;
+package com.seibel.lod.api.enums.config;
 
 /**
  * NONE, GAME_SHADING
@@ -25,7 +25,7 @@ package com.seibel.lod.core.enums.config;
  * @author James Seibel
  * @version 7-25-2020
  */
-public enum ShadingMode
+public enum EShadingMode
 {
 	/**
 	 * LODs will have darker sides and bottoms to simulate
@@ -34,7 +34,7 @@ public enum ShadingMode
 	GAME_SHADING,
 	
 	/**
-	 * LODs will use ambient occlusion to mimic Minecarft's
+	 * LODs will use ambient occlusion to mimic Minecraft's
 	 * Fancy lighting.
 	 */
 	AMBIENT_OCCLUSION

api/src/main/java/com/seibel/lod/api/enums/config/EVanillaOverdraw.java

@@ -1,40 +1,52 @@
 /*
  *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
- *    licensed under the GNU GPL v3 License.
+ *    licensed under the GNU LGPL v3 License.
  *
  *    Copyright (C) 2020-2022  James Seibel
  *
  *    This program is free software: you can redistribute it and/or modify
- *    it under the terms of the GNU General Public License as published by
+ *    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 General Public License for more details.
+ *    GNU Lesser General Public License for more details.
  *
- *    You should have received a copy of the GNU General Public License
+ *    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.lod.core.enums.config;
+package com.seibel.lod.api.enums.config;
 
 /**
- * None, Dynamic, Always
+ * NEVER, 	<br>
+ * DYNAMIC, <br>
+ * ALWAYS	<br> <br>
  *
- * <p>
  * This represents how far the LODs should overlap with
  * the vanilla Minecraft terrain.
  * 
  * @author James Seibel
- * @version 10-11-2021
+ * @version 2022-6-30
  */
-public enum VanillaOverdraw
+public enum EVanillaOverdraw
 {
-	/** Dont draw LODs where a minecraft chunk could be. Use Overdraw Offset to tweak the border thickness */
+	// 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.
+	 */
 	NEVER,
 	
-	/** Draw LODs over the farther minecraft chunks. Dynamically decides the border thickness */
+	/**
+	 * Draw LODs over the farther minecraft chunks.
+	 * Dynamically decides the border thickness
+	 */
 	DYNAMIC,
 	
 	/** Draw LODs over all minecraft chunks. */

api/src/main/java/com/seibel/lod/api/enums/config/EVerticalQuality.java

@@ -0,0 +1,88 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.enums.config;
+
+/**
+ * heightmap <br>
+ * multi_lod <br>
+ *
+ * @author Leonardo Amato
+ * @version 2023-2-5
+ */
+public enum EVerticalQuality
+{
+//	HEIGHT_MAP(new int[] { 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1 }), // commented out for now since it causes issues with transparency, may be re-added if the transparency issue is fixed
+	LOW(new int[] { 4, 2, 2, 2, 2, 1, 1, 1, 1, 1, 1 }),
+	MEDIUM(new int[] { 6, 4, 3, 2, 2, 1, 1, 1, 1, 1, 1 }),
+	HIGH(new int[] { 8, 6, 4, 2, 2, 2, 2, 1, 1, 1, 1 }),
+	ULTRA(new int[] { 16, 8, 4, 2, 2, 2, 2, 1, 1, 1, 1 });
+	
+	public final int[] maxVerticalData;
+	
+	
+	
+	EVerticalQuality(int[] maxVerticalData) { this.maxVerticalData = maxVerticalData; }
+	
+	
+	
+	/** returns null if out of range */
+	public static EVerticalQuality previous(EVerticalQuality mode)
+	{
+		switch (mode)
+		{
+		case ULTRA:
+			return EVerticalQuality.HIGH;
+		case HIGH:
+			return EVerticalQuality.MEDIUM;
+		case MEDIUM:
+			return EVerticalQuality.LOW;
+		case LOW:
+		default:
+			return null;
+		}
+	}
+	
+	/** returns null if out of range */
+	public static EVerticalQuality next(EVerticalQuality mode)
+	{
+		switch (mode)
+		{
+		case MEDIUM:
+			return EVerticalQuality.HIGH;
+		case LOW:
+			return EVerticalQuality.MEDIUM;
+		case HIGH:
+			return EVerticalQuality.ULTRA;
+		case ULTRA:
+		default:
+			return null;
+		}
+	}
+	
+    public int calculateMaxVerticalData(byte dataDetail)
+	{
+		if (dataDetail >= this.maxVerticalData.length)
+		{
+			dataDetail = (byte) (this.maxVerticalData.length - 1);
+		}
+		return this.maxVerticalData[dataDetail];
+    }
+	
+}

api/src/main/java/com/seibel/lod/api/enums/rendering/EDebugMode.java

@@ -0,0 +1,112 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.enums.rendering;
+
+/**
+ * OFF,									<br>
+ * SHOW_WIREFRAME,						<br>
+ * SHOW_DETAIL,							<br>
+ * SHOW_DETAIL_WIREFRAME,				<br>
+ * SHOW_GENMODE,						<br>
+ * SHOW_GENMODE_WIREFRAME,				<br>
+ * SHOW_OVERLAPPING_QUADS,				<br>
+ * SHOW_OVERLAPPING_QUADS_WIREFRAME,	<br>
+ * SHOW_RENDER_SOURCE_FLAG,	<br>
+ * SHOW_RENDER_SOURCE_FLAG_WIREFRAME,	<br>
+ *
+ * @author Leetom
+ * @author James Seibel
+ * @version 2022-7-2
+ */
+public enum EDebugMode
+{
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
+	
+	/** LODs are rendered normally */
+	OFF,
+
+	/** LOD draws in wireframe. */
+	SHOW_WIREFRAME,
+	
+	/** LOD colors are based on their detail */
+	SHOW_DETAIL,
+	
+	/** LOD colors are based on their detail, and draws in wireframe. */
+	SHOW_DETAIL_WIREFRAME,
+	
+	/** LOD colors are based on their gen mode. */
+	SHOW_GENMODE,
+	
+	/** LOD colors are based on their gen mode, and draws in wireframe. */
+	SHOW_GENMODE_WIREFRAME,
+
+	/** Only draw overlapping LOD quads. */
+	SHOW_OVERLAPPING_QUADS,
+
+	/** Only draw overlapping LOD quads, and draws in wireframe. */
+	SHOW_OVERLAPPING_QUADS_WIREFRAME,
+
+	/** LOD colors are based on renderSource flags. */
+	SHOW_RENDER_SOURCE_FLAG,
+
+	/** LOD colors are based on renderSource flags, and draws in wireframe. */
+	SHOW_RENDER_SOURCE_FLAG_WIREFRAME;
+
+	/** returns the next debug mode */
+	// Deprecated: use DebugMode.next() instead
+	@Deprecated
+	public EDebugMode getNext()
+	{
+		return next(this);
+	}
+
+	public static EDebugMode next(EDebugMode type) {
+		switch (type) {
+			case OFF: return SHOW_WIREFRAME;
+			case SHOW_WIREFRAME: return SHOW_DETAIL;
+			case SHOW_DETAIL: return SHOW_DETAIL_WIREFRAME;
+			case SHOW_DETAIL_WIREFRAME: return SHOW_GENMODE;
+			case SHOW_GENMODE: return SHOW_GENMODE_WIREFRAME;
+			case SHOW_GENMODE_WIREFRAME: return SHOW_OVERLAPPING_QUADS;
+			case SHOW_OVERLAPPING_QUADS: return SHOW_OVERLAPPING_QUADS_WIREFRAME;
+			case SHOW_OVERLAPPING_QUADS_WIREFRAME: return SHOW_RENDER_SOURCE_FLAG;
+			case SHOW_RENDER_SOURCE_FLAG: return SHOW_RENDER_SOURCE_FLAG_WIREFRAME;
+			default: return OFF;
+		}
+	}
+
+	public static EDebugMode previous(EDebugMode type) {
+		switch (type) {
+			case OFF: return SHOW_RENDER_SOURCE_FLAG_WIREFRAME;
+			case SHOW_RENDER_SOURCE_FLAG_WIREFRAME: return SHOW_RENDER_SOURCE_FLAG;
+			case SHOW_RENDER_SOURCE_FLAG: return SHOW_OVERLAPPING_QUADS_WIREFRAME;
+			case SHOW_OVERLAPPING_QUADS_WIREFRAME: return SHOW_OVERLAPPING_QUADS;
+			case SHOW_OVERLAPPING_QUADS: return SHOW_GENMODE_WIREFRAME;
+			case SHOW_GENMODE_WIREFRAME: return SHOW_GENMODE;
+			case SHOW_GENMODE: return SHOW_DETAIL_WIREFRAME;
+			case SHOW_DETAIL_WIREFRAME: return SHOW_DETAIL;
+			case SHOW_DETAIL: return SHOW_WIREFRAME;
+			default: return OFF;
+		}
+	}
+}

api/src/main/java/com/seibel/lod/api/enums/rendering/EFogColorMode.java

@@ -1,42 +1,46 @@
 /*
  *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
- *    licensed under the GNU GPL v3 License.
+ *    licensed under the GNU LGPL v3 License.
  *
  *    Copyright (C) 2020-2022  James Seibel
  *
  *    This program is free software: you can redistribute it and/or modify
- *    it under the terms of the GNU General Public License as published by
+ *    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 General Public License for more details.
+ *    GNU Lesser General Public License for more details.
  *
- *    You should have received a copy of the GNU General Public License
+ *    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.lod.core.enums.rendering;
+package com.seibel.lod.api.enums.rendering;
 
 /**
  * USE_DEFAULT_FOG_COLOR, <br>
  * USE_SKY_COLOR, <br>
  * 
  * @author James Seibel
- * @version 11-27-2021
+ * @version 2022-6-9
  */
-public enum FogColorMode
+public enum EFogColorMode
 {
+	// Reminder:
+	// when adding items: up the API minor version
+	// when removing items: up the API major version
+	
 	/** Fog uses Minecraft's fog color. */
 	USE_WORLD_FOG_COLOR,
 	
 	/**
 	 * Replicates the effect of the clear sky mod.
 	 * Making the fog blend in with the sky better
+	 * For it to look good you need one of the following mods:
 	 * https://www.curseforge.com/minecraft/mc-mods/clear-skies
 	 * https://www.curseforge.com/minecraft/mc-mods/clear-skies-forge-port
-	 * For it to look good you need one of those mods
 	 */
 	USE_SKY_COLOR,
 }

api/src/main/java/com/seibel/lod/api/enums/rendering/EFogDistance.java

@@ -1,32 +1,36 @@
 /*
  *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
- *    licensed under the GNU GPL v3 License.
+ *    licensed under the GNU LGPL v3 License.
  *
  *    Copyright (C) 2020-2022  James Seibel
  *
  *    This program is free software: you can redistribute it and/or modify
- *    it under the terms of the GNU General Public License as published by
+ *    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 General Public License for more details.
+ *    GNU Lesser General Public License for more details.
  *
- *    You should have received a copy of the GNU General Public License
+ *    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.lod.core.enums.rendering;
+package com.seibel.lod.api.enums.rendering;
 
 /**
  * NEAR, FAR, or NEAR_AND_FAR.
  * 
  * @author James Seibel
- * @version 11-26-2021
+ * @version 2022-6-2
  */
-public enum FogDistance
+public enum EFogDistance
 {
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
 	NEAR,
 	FAR,
 	NEAR_AND_FAR

api/src/main/java/com/seibel/lod/api/enums/rendering/EFogDrawMode.java

@@ -1,23 +1,23 @@
 /*
  *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
- *    licensed under the GNU GPL v3 License.
+ *    licensed under the GNU LGPL v3 License.
  *
  *    Copyright (C) 2020-2022  James Seibel
  *
  *    This program is free software: you can redistribute it and/or modify
- *    it under the terms of the GNU General Public License as published by
+ *    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 General Public License for more details.
+ *    GNU Lesser General Public License for more details.
  *
- *    You should have received a copy of the GNU General Public License
+ *    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.lod.core.enums.rendering;
+package com.seibel.lod.api.enums.rendering;
 
 /**
  * USE_OPTIFINE_FOG_SETTING, <br>
@@ -25,16 +25,21 @@ package com.seibel.lod.core.enums.rendering;
  * FOG_DISABLED <br>
  * 
  * @author James Seibel
- * @version 11-27-2021
+ * @version 2022-6-2
  */
-public enum FogDrawMode
+public enum EFogDrawMode
 {
+	// 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 ALWAYS_DRAW_FOG.
+	 * If optifine isn't installed this defaults to FOG_ENABLED.
 	 */
 	USE_OPTIFINE_SETTING,
 	
 	FOG_ENABLED,
-	FOG_DISABLED
+	FOG_DISABLED;
+	
 }

api/src/main/java/com/seibel/lod/api/enums/rendering/EFogFalloff.java

@@ -0,0 +1,22 @@
+package com.seibel.lod.api.enums.rendering;
+
+/**
+ * LINEAR,				<br>
+ * EXPONENTIAL, 		<br>
+ * EXPONENTIAL_SQUARED 	<br>
+ *
+ * @author Leetom
+ * @version 2022-6-30
+ */
+public enum EFogFalloff
+{
+	// Reminder:
+	// when adding items up the API minor version
+	// when removing items up the API major version
+	
+	
+	LINEAR,
+	EXPONENTIAL,
+	EXPONENTIAL_SQUARED,
+	// TEXTURE_BASED, // TODO: Impl this
+}

api/src/main/java/com/seibel/lod/api/enums/rendering/EGLProxyContext.java

@@ -1,23 +1,23 @@
 /*
  *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
- *    licensed under the GNU GPL v3 License.
+ *    licensed under the GNU LGPL v3 License.
  *
  *    Copyright (C) 2020-2022  James Seibel
  *
  *    This program is free software: you can redistribute it and/or modify
- *    it under the terms of the GNU General Public License as published by
+ *    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 General Public License for more details.
+ *    GNU Lesser General Public License for more details.
  *
- *    You should have received a copy of the GNU General Public License
+ *    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.lod.core.enums.rendering;
+package com.seibel.lod.api.enums.rendering;
 
 /**
  * Minecraft, Lod_Builder, None
@@ -25,7 +25,7 @@ package com.seibel.lod.core.enums.rendering;
  * @author James Seibel
  * @version 10-1-2021
  */
-public enum GLProxyContext
+public enum EGLProxyContext
 {
 	/** Minecraft's render thread */
 	MINECRAFT,

api/src/main/java/com/seibel/lod/api/enums/rendering/EHeightFogMixMode.java

@@ -1,40 +1,40 @@
 /*
  *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
- *    licensed under the GNU GPL v3 License.
+ *    licensed under the GNU LGPL v3 License.
  *
  *    Copyright (C) 2020-2022  James Seibel
  *
  *    This program is free software: you can redistribute it and/or modify
- *    it under the terms of the GNU General Public License as published by
+ *    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 General Public License for more details.
+ *    GNU Lesser General Public License for more details.
  *
- *    You should have received a copy of the GNU General Public License
+ *    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.lod.core.enums.rendering;
+package com.seibel.lod.api.enums.rendering;
 
 /**
- * basic                        <br>
- * Ignore_Height                <br>
- * Addition                     <br>
- * Max                          <br>
- * Multiply                     <br>
- * Inverse_Multiply             <br>
- * Limited_Addition             <br>
- * Multiply_Addition            <br>
- * Inverse_Multiply_Addition    <br>
- * Average                      <br>
+ * BASIC                        <br>
+ * IGNORE_HEIGHT                <br>
+ * ADDITION                     <br>
+ * MAX                          <br>
+ * MULTIPLY                     <br>
+ * INVERSE_MULTIPLY             <br>
+ * LIMITED_ADDITION             <br>
+ * MULTIPLY_ADDITION            <br>
+ * INVERSE_MULTIPLY_ADDITION    <br>
+ * AVERAGE                      <br>
  *
  * @author Leetom
  * @version 2022-4-14
  */
-public enum HeightFogMixMode
+public enum EHeightFogMixMode
 {
     BASIC,
     IGNORE_HEIGHT,

api/src/main/java/com/seibel/lod/api/enums/rendering/EHeightFogMode.java

@@ -1,26 +1,42 @@
 /*
  *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
- *    licensed under the GNU GPL v3 License.
+ *    licensed under the GNU LGPL v3 License.
  *
  *    Copyright (C) 2020-2022  James Seibel
  *
  *    This program is free software: you can redistribute it and/or modify
- *    it under the terms of the GNU General Public License as published by
+ *    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 General Public License for more details.
+ *    GNU Lesser General Public License for more details.
  *
- *    You should have received a copy of the GNU General Public License
+ *    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.lod.core.enums.rendering;
+package com.seibel.lod.api.enums.rendering;
 
-public enum HeightFogMode
+/**
+ * ABOVE_CAMERA,				<br>
+ * BELOW_CAMERA,				<br>
+ * ABOVE_AND_BELOW_CAMERA,		<br>
+ * ABOVE_SET_HEIGHT,			<br>
+ * BELOW_SET_HEIGHT,			<br>
+ * ABOVE_AND_BELOW_SET_HEIGHT,	<br>
+ *
+ * @author Leetom
+ * @version 6-30-2022
+ */
+public enum EHeightFogMode
 {
+	// 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),
@@ -32,7 +48,7 @@ public enum HeightFogMode
 	public final boolean above;
 	public final boolean below;
 	
-	HeightFogMode(boolean basedOnCamera, boolean above, boolean below)
+	EHeightFogMode(boolean basedOnCamera, boolean above, boolean below)
 	{
 		this.basedOnCamera = basedOnCamera;
 		this.above = above;

api/src/main/java/com/seibel/lod/api/enums/rendering/ERendererMode.java

@@ -0,0 +1,63 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.enums.rendering;
+
+/**
+ * Default
+ * Debug
+ * Disabled
+ *
+ * @version 2022-6-2
+ */
+public enum ERendererMode
+{
+    // Reminder:
+    // when adding items up the API minor version
+    // when removing items up the API major version
+    
+    
+    DEFAULT,
+    DEBUG,
+    DISABLED;
+    
+    
+    /** Used by the config GUI to cycle through the available rendering options */
+    public static ERendererMode next(ERendererMode type)
+    {
+        switch (type)
+        {
+            case DEFAULT: return DEBUG;
+            case DEBUG: return DISABLED;
+            default: return DEFAULT;
+        }
+    }
+    
+    /** Used by the config GUI to cycle through the available rendering options */
+    public static ERendererMode previous(ERendererMode type)
+    {
+        switch (type)
+        {
+            case DEFAULT: return DISABLED;
+            case DEBUG: return DEFAULT;
+            default: return DEBUG;
+        }
+    }
+    
+}

api/src/main/java/com/seibel/lod/api/enums/rendering/ETransparency.java

@@ -0,0 +1,55 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.enums.rendering;
+
+/**
+ * OFF,									<br>
+ * SHOW_WIREFRAME,						<br>
+ * SHOW_DETAIL,							<br>
+ * SHOW_DETAIL_WIREFRAME,				<br>
+ * SHOW_GENMODE,						<br>
+ * SHOW_GENMODE_WIREFRAME,				<br>
+ * SHOW_OVERLAPPING_QUADS,				<br>
+ * SHOW_OVERLAPPING_QUADS_WIREFRAME,	<br>
+ *
+ * @author Leetom
+ * @author James Seibel
+ * @version 2022-7-2
+ */
+public enum ETransparency
+{
+	// 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);
+
+	public final boolean tranparencyEnabled;
+	public final boolean fakeTransparencyEnabled;
+
+	ETransparency(boolean tranparencyEnabled, boolean fakeTransparencyEnabled)
+	{
+		this.tranparencyEnabled = tranparencyEnabled;
+		this.fakeTransparencyEnabled = fakeTransparencyEnabled;
+	}
+}

api/src/main/java/com/seibel/lod/api/enums/worldGeneration/EDhApiDistantGeneratorMode.java

@@ -0,0 +1,142 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.enums.worldGeneration;
+
+/**
+ * PRE_EXISTING_ONLY <br>
+ * BIOME_ONLY <br>
+ * BIOME_ONLY_SIMULATE_HEIGHT <br>
+ * SURFACE <br>
+ * FEATURES <br>
+ * FULL <br><br>
+ *
+ * In order of fastest to slowest.
+ * 
+ * @author James Seibel
+ * @author Leonardo Amato
+ * @version 2022-12-10
+ */
+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),
+	
+	/**
+	 * Only generate the biomes and use biome
+	 * grass/foliage color, water color, or ice color
+	 * to generate the color. <br>
+	 * Doesn't generate height, everything is shown at sea level. <br>
+	 * Multithreaded - Fastest (2-5 ms)
+	 */
+	BIOME_ONLY((byte) 2),
+	
+	/**
+	 * Same as BIOME_ONLY, except instead
+	 * of always using sea level as the LOD height
+	 * different biome types (mountain, ocean, forest, etc.)
+	 * use predetermined heights to simulate having height data.
+	 */
+	BIOME_ONLY_SIMULATE_HEIGHT((byte) 3),
+	
+	/**
+	 * Generate the world surface,
+	 * this does NOT include caves, trees,
+	 * or structures. <br>
+	 * Multithreaded - Faster (10-20 ms)
+	 */
+	SURFACE((byte) 4),
+	
+	/**
+	 * Generate including structures.
+	 * NOTE: This may cause world generation bugs or instability,
+	 * since some features can cause concurrentModification exceptions. <br>
+	 * Multithreaded - Fast (15-20 ms)
+	 */
+	FEATURES((byte) 5),
+	
+	/**
+	 * Ask the server to generate/load each chunk.
+	 * This is the most compatible, but causes server/simulation lag.
+	 * This will also show player made structures if you
+	 * are adding the mod on a pre-existing world. <br>
+	 * Single-threaded - Slow (15-50 ms, with spikes up to 200 ms)
+	 */
+	FULL((byte) 6);
+	
+	
+	
+	public static final EDhApiDistantGeneratorMode RENDERABLE = EDhApiDistantGeneratorMode.BIOME_ONLY;
+	
+	/** The higher the number the more complete the generation is. */
+	public final byte complexity;
+	
+	
+	EDhApiDistantGeneratorMode(byte complexity) { this.complexity = complexity; }
+	
+	
+	
+	/** returns null if out of range */
+	public static EDhApiDistantGeneratorMode previous(EDhApiDistantGeneratorMode mode)
+	{
+		switch (mode)
+		{
+			case FULL:
+				return EDhApiDistantGeneratorMode.FEATURES;
+			case FEATURES:
+				return EDhApiDistantGeneratorMode.SURFACE;
+			case SURFACE:
+				return EDhApiDistantGeneratorMode.BIOME_ONLY_SIMULATE_HEIGHT;
+			case BIOME_ONLY_SIMULATE_HEIGHT:
+				return EDhApiDistantGeneratorMode.BIOME_ONLY;
+			case BIOME_ONLY:
+				return EDhApiDistantGeneratorMode.PRE_EXISTING_ONLY;
+			case PRE_EXISTING_ONLY:
+			default:
+				return null;
+		}
+	}
+	
+	/** returns null if out of range */
+	public static EDhApiDistantGeneratorMode next(EDhApiDistantGeneratorMode mode)
+	{
+		switch (mode)
+		{
+			case FEATURES:
+				return EDhApiDistantGeneratorMode.FULL;
+			case SURFACE:
+				return EDhApiDistantGeneratorMode.FEATURES;
+			case BIOME_ONLY_SIMULATE_HEIGHT:
+				return EDhApiDistantGeneratorMode.SURFACE;
+			case BIOME_ONLY:
+				return EDhApiDistantGeneratorMode.BIOME_ONLY_SIMULATE_HEIGHT;
+			case PRE_EXISTING_ONLY:
+				return EDhApiDistantGeneratorMode.BIOME_ONLY;
+			case FULL:
+			default:
+				return null;
+		}
+	}
+	
+}

api/src/main/java/com/seibel/lod/api/enums/worldGeneration/EDhApiLevelType.java

@@ -0,0 +1,16 @@
+package com.seibel.lod.api.enums.worldGeneration;
+
+/**
+ * SERVER_LEVEL, <br>
+ * CLIENT_LEVEL, <br>
+ * UNKNOWN <br>
+ *
+ * @author James Seibel
+ * @version 2022-7-13
+ */
+public enum EDhApiLevelType
+{
+	SERVER_LEVEL,
+	CLIENT_LEVEL,
+	UNKNOWN
+}

api/src/main/java/com/seibel/lod/api/enums/worldGeneration/EDhApiWorldGenThreadMode.java

@@ -0,0 +1,31 @@
+package com.seibel.lod.api.enums.worldGeneration;
+
+/**
+ * MULTI_THREADED, <br>
+ * SINGLE_THREADED, <br>
+ * SERVER_THREAD, <br>
+ *
+ * @author James Seibel
+ * @version 7-14-2022
+ */
+public enum EDhApiWorldGenThreadMode
+{
+	/**
+	 * This world generator can be run on an unlimited number
+	 * of concurrent threads.
+	 */
+	MULTI_THREADED,
+	
+	/**
+	 * This world generator can only be run on one thread at
+	 * a time, however that thread can run concurrently
+	 * to Minecraft's server thread.
+	 */
+	SINGLE_THREADED,
+	
+	/**
+	 * This world generator can only be run on Minecraft's
+	 * server thread.
+	 */
+	SERVER_THREAD,
+}

api/src/main/java/com/seibel/lod/api/enums/worldGeneration/EDhApiWorldGenerationStep.java

@@ -0,0 +1,52 @@
+package com.seibel.lod.api.enums.worldGeneration;
+
+/**
+ * EMPTY, <br>
+ * STRUCTURE_START, <br>
+ * STRUCTURE_REFERENCE, <br>
+ * BIOMES, <br>
+ * NOISE, <br>
+ * SURFACE, <br>
+ * CARVERS, <br>
+ * LIQUID_CARVERS, <br>
+ * FEATURES, <br>
+ * LIGHT, <br>
+ *
+ * @author James Seibel
+ * @version 2023-4-20
+ */
+public enum EDhApiWorldGenerationStep
+{
+	EMPTY(0),
+	STRUCTURE_START(1),
+	STRUCTURE_REFERENCE(2),
+	BIOMES(3),
+	NOISE(4),
+	SURFACE(5),
+	CARVERS(6),
+	LIQUID_CARVERS(7),
+	FEATURES(8),
+	LIGHT(9);
+	
+	
+	
+	/** used when serializing this enum. */
+	public final byte value;
+	
+	EDhApiWorldGenerationStep(int value) { this.value = (byte) value; }
+	
+	/** @return null if the value doesn't correspond to a {@link EDhApiWorldGenerationStep}. */
+	public static EDhApiWorldGenerationStep fromValue(int value)
+	{
+		for (EDhApiWorldGenerationStep genStep : EDhApiWorldGenerationStep.values())
+		{
+			if (genStep.value == value)
+			{
+				return genStep;
+			}
+		}
+		
+		return null;
+	}
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/IDhApiUnsafeWrapper.java

@@ -0,0 +1,26 @@
+package com.seibel.lod.api.interfaces;
+
+/**
+ * The Distant Horizons' API objects can't cover
+ * every potential use case. Sometimes developers just need
+ * the base Minecraft Objects.
+ *
+ * @author James Seibel
+ * @version 2022-9-16
+ */
+public interface IDhApiUnsafeWrapper
+{
+	
+	/**
+	 * Returns the Minecraft object this wrapper contains. <br>
+	 * <strong>Warning</strong>: This object will be Minecraft
+	 * version dependent and may change without notice. <br> <br>
+	 *
+	 * 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.
+	 */
+	Object getWrappedMcObject_UNSAFE();
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/block/IDhApiBiomeWrapper.java

@@ -0,0 +1,31 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.interfaces.block;
+
+import com.seibel.lod.api.interfaces.IDhApiUnsafeWrapper;
+
+/**
+ * @author James Seibel
+ * @version 3-5-2022
+ */
+public interface IDhApiBiomeWrapper extends IDhApiUnsafeWrapper
+{
+	String getName();
+}

api/src/main/java/com/seibel/lod/api/interfaces/block/IDhApiBlockStateWrapper.java

@@ -0,0 +1,15 @@
+package com.seibel.lod.api.interfaces.block;
+
+import com.seibel.lod.api.interfaces.IDhApiUnsafeWrapper;
+
+/**
+ * A Minecraft version independent way of handling Blocks.
+ * 
+ * @author James Seibel
+ * @version 2022-11-12
+ */
+public interface IDhApiBlockStateWrapper extends IDhApiUnsafeWrapper
+{
+    boolean isAir();
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/config/IDhApiConfig.java

@@ -0,0 +1,25 @@
+package com.seibel.lod.api.interfaces.config;
+
+import com.seibel.lod.api.interfaces.config.both.IDhApiWorldGenerationConfig;
+import com.seibel.lod.api.interfaces.config.client.IDhApiBuffersConfig;
+import com.seibel.lod.api.interfaces.config.client.IDhApiGraphicsConfig;
+import com.seibel.lod.api.interfaces.config.client.IDhApiMultiplayerConfig;
+import com.seibel.lod.api.interfaces.config.client.IDhApiThreadingConfig;
+
+/**
+ * This interfaces holds all of the config groups
+ * the API has access to for easy access to all config values.
+ * 
+ * @author James Seibel
+ * @version 9-15-2022
+ */
+public interface IDhApiConfig
+{
+	
+	IDhApiWorldGenerationConfig getWorldGeneratorConfig();
+	IDhApiBuffersConfig getBufferConfig();
+	IDhApiGraphicsConfig getGraphicsConfig();
+	IDhApiMultiplayerConfig getMultiplayerConfig();
+	IDhApiThreadingConfig getThreadingConfig();
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/config/IDhApiConfigGroup.java

@@ -0,0 +1,15 @@
+package com.seibel.lod.api.interfaces.config;
+
+import com.seibel.lod.coreapi.interfaces.dependencyInjection.IBindable;
+
+/**
+ * This interface is just used to organize API config groups so
+ * they can be more easily handled together.
+ * 
+ * @author James Seibel
+ * @version 9-15-2022
+ */
+public interface IDhApiConfigGroup extends IBindable
+{
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/config/IDhApiConfigValue.java

@@ -0,0 +1,51 @@
+package com.seibel.lod.api.interfaces.config;
+
+/**
+ * An interface for Distant Horizon's Config.
+ *
+ * @param <T> The data type of this config.
+ * 
+ * @author James Seibel
+ * @version 2022-9-15
+ */
+public interface IDhApiConfigValue<T>
+{
+	
+	/**
+	 * Returns the active value for this config. <br>
+	 * Returns the True value if either the config cannot be overridden by
+	 * the API or if it hasn't been set by the API.
+	 */
+	public T getValue();
+	/**
+	 * Returns the value held by this config. <br>
+	 * This is the value stored in the config file.
+	 */
+	public T getTrueValue();
+	/**
+	 * Returns the value of the config if it was set by the API.
+	 * Returns null if the config wasn't set by the API.
+	 */
+	public T getApiValue();
+	
+	/**
+	 * Sets the config's value. <br>
+	 * If the newValue is set to null then the config
+	 * will revert to using the True Value.<br>
+	 * If the config cannot be set via the API this method will return false.
+	 *
+	 * @return true if the value was set, false otherwise.
+	 */
+	public boolean setValue(T newValue);
+	
+	/** Returns true if this config can be set via the API, false otherwise. */
+	public boolean getCanBeOverrodeByApi();
+	
+	/** Returns the default value for this config. */
+	public T getDefaultValue();
+	/** Returns the max value for this config, null if there is no max. */
+	public T getMaxValue();
+	/** Returns the min value for this config, null if there is no min. */
+	public T getMinValue();
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/config/both/IDhApiWorldGenerationConfig.java

@@ -0,0 +1,77 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.interfaces.config.both;
+
+import com.seibel.lod.api.enums.config.EBlocksToAvoid;
+import com.seibel.lod.api.enums.worldGeneration.EDhApiDistantGeneratorMode;
+import com.seibel.lod.api.enums.config.EGenerationPriority;
+import com.seibel.lod.api.interfaces.config.IDhApiConfigValue;
+import com.seibel.lod.api.enums.config.ELightGenerationMode;
+import com.seibel.lod.api.interfaces.config.IDhApiConfigGroup;
+
+/**
+ * Distant Horizons' world generation configuration. <br><br>
+ *
+ * Note: Fake chunks are NOT saved in Minecraft's vanilla save system.
+ *
+ * @author James Seibel
+ * @version 2022-9-15
+ */
+public interface IDhApiWorldGenerationConfig extends IDhApiConfigGroup
+{
+	
+	/**
+	 * Defines whether fake chunks will be generated
+	 * outside Minecraft's vanilla render distance.
+	 */
+	IDhApiConfigValue<Boolean> getEnableDistantWorldGeneration();
+	
+	/** Defines to what level fake chunks will be generated. */
+	IDhApiConfigValue<EDhApiDistantGeneratorMode> getDistantGeneratorMode();
+	
+	/** Defines how generated fake chunks will be lit. */
+	IDhApiConfigValue<ELightGenerationMode> getLightingMode();
+	
+	/** Defines the order in which fake chunks will be generated. */
+	IDhApiConfigValue<EGenerationPriority> getGenerationPriority();
+	
+	/**
+	 * Defines what blocks will be ignored when generating LODs. <br><br>
+	 *
+	 * TODO if this isn't deprecated before 1.7 it should probably be moved to the graphics tab
+	 * @deprecated this method won't be needed once we transition to an ID based save system <br>
+	 * 				(vs the color based system we have currently)
+	 */
+	@Deprecated
+	IDhApiConfigValue<EBlocksToAvoid> getBlocksToAvoid();
+	
+	/**
+	 * Defines if the color of avoided blocks will color the block below them. <Br>
+	 * (IE: if flowers are avoided should they color the grass below them?)
+	 *
+	 * TODO if this isn't deprecated before 1.7 it should probably be moved to the graphics tab
+	 * @deprecated this method won't be needed once we transition to an ID based save system <br>
+	 * 				(vs the color based system we have currently)
+	 */
+	@Deprecated
+	IDhApiConfigValue<Boolean> getTintWithAvoidedBlocks();
+	
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/config/client/IDhApiBuffersConfig.java

@@ -0,0 +1,47 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.interfaces.config.client;
+
+import com.seibel.lod.api.enums.config.EGpuUploadMethod;
+import com.seibel.lod.api.interfaces.config.IDhApiConfigGroup;
+import com.seibel.lod.api.interfaces.config.IDhApiConfigValue;
+
+/**
+ * Distant Horizons' OpenGL buffer configuration.
+ *
+ * @author James Seibel
+ * @version 2022-9-15
+ */
+public interface IDhApiBuffersConfig extends IDhApiConfigGroup
+{
+	
+	/** Defines how geometry data is uploaded to the GPU. */
+	IDhApiConfigValue<EGpuUploadMethod> getGpuUploadMethod();
+	
+	/**
+	 * Defines how long we should wait after uploading one
+	 * Megabyte of geometry data to the GPU before uploading
+	 * the next Megabyte of data. <br>
+	 * This can be set to a non-zero number to reduce stuttering caused by
+	 * uploading buffers to the GPU.
+	 */
+	IDhApiConfigValue<Integer> getBufferUploadTimeoutPerMegabyteInMilliseconds();
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/config/client/IDhApiDebuggingConfig.java

@@ -0,0 +1,41 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.interfaces.config.client;
+
+import com.seibel.lod.api.enums.rendering.EDebugMode;
+import com.seibel.lod.api.interfaces.config.IDhApiConfigValue;
+import com.seibel.lod.api.interfaces.config.IDhApiConfigGroup;
+
+/**
+ * Distant Horizons' debug configuration.
+ *
+ * @author James Seibel
+ * @version 2022-9-15
+ */
+public interface IDhApiDebuggingConfig extends IDhApiConfigGroup
+{
+	/** Can be used to debug the standard fake chunk rendering. */
+	IDhApiConfigValue<EDebugMode> getDebugRenderMode();
+	
+	/** If enabled debug keybindings can be used. */
+	IDhApiConfigValue<Boolean> getEnableDebugKeybindings();
+	
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/config/client/IDhApiGraphicsConfig.java

@@ -0,0 +1,138 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.interfaces.config.client;
+
+import com.seibel.lod.api.enums.config.*;
+import com.seibel.lod.api.enums.rendering.ERendererMode;
+import com.seibel.lod.api.interfaces.config.IDhApiConfigValue;
+import com.seibel.lod.api.interfaces.config.IDhApiConfigGroup;
+
+/**
+ * Distant Horizons' graphics/rendering configuration.
+ *
+ * @author James Seibel
+ * @version 2022-9-15
+ */
+public interface IDhApiGraphicsConfig extends IDhApiConfigGroup
+{
+	
+	//========================//
+	// basic graphic settings //
+	//========================//
+	
+	/** The distance is the radius measured in chunks. */
+	IDhApiConfigValue<Integer> getChunkRenderDistance();
+	
+	/**
+	 * Simplified version of {@link IDhApiGraphicsConfig#getRenderingMode()}
+	 * that only enables/disables the fake chunk rendering. <br><br>
+	 *
+	 * Changing this config also changes {@link IDhApiGraphicsConfig#getRenderingMode()}'s value.
+	 */
+	IDhApiConfigValue<Boolean> getRenderingEnabled();
+	
+	/**
+	 * Can be used to enable/disable fake chunk rendering or enable the debug renderer. <br><br>
+	 *
+	 * The debug renderer is used to confirm rendering is working at and will draw
+	 * a single multicolor rhombus on the screen in skybox space (AKA behind MC's rendering). <br><br>
+	 *
+	 * Changing this config also changes {@link IDhApiGraphicsConfig#getRenderingEnabled()}'s value.
+	 */
+	IDhApiConfigValue<ERendererMode> getRenderingMode();
+	
+	
+	
+	//==================//
+	// graphic settings //
+	//==================//
+	
+	/** Defines how detailed fake chunks are in the horizontal direction */
+	IDhApiConfigValue<EHorizontalResolution> getMaxDetailLevel();
+	
+	/** Defines how detailed fake chunks are in the vertical direction */
+	IDhApiConfigValue<EVerticalQuality> getVerticalQuality();
+	
+	/** Modifies the quadratic function fake chunks use for horizontal quality drop-off. */
+	IDhApiConfigValue<EHorizontalQuality> getHorizontalQualityDropoff();
+
+	/**
+	 * The same as vanilla Minecraft's biome blending. <br><br>
+	 *
+	 * 0 = blending of 1x1 aka off	<br>
+	 * 1 = blending of 3x3			<br>
+	 * 2 = blending of 5x5			<br>
+	 * ...							<br>
+	 */
+	IDhApiConfigValue<Integer> getBiomeBlending();
+	
+	
+	
+	//===========================//
+	// advanced graphic settings //
+	//===========================//
+	
+	/** If directional culling is disabled fake chunks will be rendered behind the camera. */
+	IDhApiConfigValue<Boolean> getDisableDirectionalCulling();
+	
+	/** Determines how fake chunks are rendered in comparison to vanilla MC's chunks. */
+	IDhApiConfigValue<EVanillaOverdraw> getVanillaOverdraw();
+	
+	/** Modifies how far the vanilla overdraw is rendered in chunks. */
+	IDhApiConfigValue<Integer> getVanillaOverdrawOffset();
+	
+	/**
+	 * If enabled the near clip plane is extended to reduce
+	 * overdraw and improve Z-fighting at extreme render distances. <br>
+	 * Disabling this reduces holes in the world due to the near clip plane
+	 * being too close to the camera and the terrain not being covered by vanilla terrain.
+	 */
+	IDhApiConfigValue<Boolean> getUseExtendedNearClipPlane();
+	
+	/**
+	 * Modifies how bright fake chunks are. <br>
+	 * This is done when generating the vertex data and is applied before any shaders.
+	 */
+	IDhApiConfigValue<Double> getBrightnessMultiplier();
+	
+	/**
+	 * Modifies how saturated fake chunks are. <br>
+	 * This is done when generating the vertex data and is applied before any shaders.
+	 */
+	IDhApiConfigValue<Double> getSaturationMultiplier();
+	
+	/** Defines if Distant Horizons should attempt to cull fake chunk cave geometry. */
+	IDhApiConfigValue<Boolean> getCaveCullingEnabled();
+	
+	/** Defines what height cave culling should be used below if enabled. */
+	IDhApiConfigValue<Integer> getCaveCullingHeight();
+	
+	/** This ratio is relative to Earth's real world curvature. */
+	IDhApiConfigValue<Integer> getEarthCurvatureRatio();
+	
+	/** If enabled vanilla chunk rendering is disabled and only fake chunks are rendered. */
+	IDhApiConfigValue<Boolean> getEnableLodOnlyMode();
+	
+	/** Defines how often the geometry should be rebuilt when the player moves. */
+	IDhApiConfigValue<EBufferRebuildTimes> getGeometryRebuildFrequency();
+	
+	
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/config/client/IDhApiGraphicsFogConfig.java

@@ -0,0 +1,130 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.interfaces.config.client;
+
+import com.seibel.lod.api.enums.rendering.*;
+import com.seibel.lod.api.interfaces.config.IDhApiConfigGroup;
+import com.seibel.lod.api.interfaces.config.IDhApiConfigValue;
+
+/**
+ * Distant Horizons' fog configuration. <br><br>
+ *
+ * Note: unless an option explicitly states that it modifies
+ * Minecraft's vanilla rendering (like DisableVanillaFog)
+ * these settings will only affect Distant horizons' fog.
+ *
+ * @author James Seibel
+ * @version 2022-9-15
+ */
+public interface IDhApiGraphicsFogConfig extends IDhApiConfigGroup
+{
+	
+	//====================//
+	// basic fog settings //
+	//====================//
+	
+	/** Defines at what distance fog is rendered on fake chunks. */
+	IDhApiConfigValue<EFogDistance> getFogDistance();
+	
+	/** Should be used to enable/disable fog rendering. */
+	IDhApiConfigValue<EFogDrawMode> getFogRender();
+	
+	/** Can be used to enable support with mods that change vanilla MC's fog color. */
+	IDhApiConfigValue<EFogColorMode> getFogColor();
+	
+	/**
+	 * If enabled attempts to disable vanilla MC's fog on real chunks. <br>
+	 * May not play nice with other fog editing mods.
+	 */
+	IDhApiConfigValue<Boolean> getDisableVanillaFog();
+	
+	
+	//=======================//
+	// advanced fog settings //
+	//=======================//
+	
+	/**
+	 * Defines where the fog starts as a percent of the
+	 * fake chunks render distance radius. <br>
+	 * Can be greater than the fog end distance to invert the fog direction. <br> <br>
+	 *
+	 * 0.0 = fog starts at the camera <br>
+	 * 1.0 = fog starts at the edge of the fake chunk render distance <br>
+	 */
+	IDhApiConfigValue<Double> getFogStartDistance();
+	
+	/**
+	 * Defines where the fog ends as a percent of the radius
+	 * of the fake chunks render distance. <br>
+	 * Can be less than the fog start distance to invert the fog direction. <br> <br>
+	 *
+	 * 0.0 = fog ends at the camera <br>
+	 * 1.0 = fog ends at the edge of the fake chunk render distance <br>
+	 */
+	IDhApiConfigValue<Double> getFogEndDistance();
+	
+	/** Defines how opaque the fog is at its thinnest point. */
+	IDhApiConfigValue<Double> getFogMinThickness();
+	
+	/** Defines how opaque the fog is at its thickest point. */
+	IDhApiConfigValue<Double> getFogMaxThickness();
+	
+	/** Defines how the fog changes in thickness. */
+	IDhApiConfigValue<EFogFalloff> getFogFalloff();
+	
+	/** Defines the fog density. */
+	IDhApiConfigValue<Double> getFogDensity();
+	
+	
+	//=====================//
+	// height fog settings //
+	//=====================//
+	
+	/** Defines how the height fog mixes. */
+	IDhApiConfigValue<EHeightFogMixMode> getHeightFogMixMode();
+	
+	/** Defines how the height fog is drawn relative to the camera or world. */
+	IDhApiConfigValue<EHeightFogMode> getHeightFogMode();
+	
+	/**
+	 * Defines the height fog's base height if {@link IDhApiGraphicsFogConfig#getHeightFogMode()}
+	 * is set to use a specific height.
+	 */
+	IDhApiConfigValue<Double> getHeightFogBaseHeight();
+	
+	/** Defines the height fog's starting height as a percent of the world height. */
+	IDhApiConfigValue<Double> getHeightFogStartingHeightPercent();
+	
+	/** Defines the height fog's ending height as a percent of the world height. */
+	IDhApiConfigValue<Double> getHeightFogEndingHeightPercent();
+	
+	/** Defines how opaque the height fog is at its thinnest point. */
+	IDhApiConfigValue<Double> getHeightFogMinThickness();
+	
+	/** Defines how opaque the height fog is at its thickest point. */
+	IDhApiConfigValue<Double> getHeightFogMaxThickness();
+	
+	/** Defines how the height fog changes in thickness. */
+	IDhApiConfigValue<EFogFalloff> getHeightFogFalloff();
+	
+	/** Defines the height fog's density. */
+	IDhApiConfigValue<Double> getHeightFogDensity();
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/config/client/IDhApiMultiplayerConfig.java

@@ -0,0 +1,53 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.interfaces.config.client;
+
+import com.seibel.lod.api.interfaces.config.IDhApiConfigValue;
+import com.seibel.lod.api.enums.config.EServerFolderNameMode;
+import com.seibel.lod.api.interfaces.config.IDhApiConfigGroup;
+
+/**
+ * Distant Horizons' client-side multiplayer configuration.
+ *
+ * @author James Seibel
+ * @version 2022-9-15
+ */
+public interface IDhApiMultiplayerConfig extends IDhApiConfigGroup
+{
+	
+	/**
+	 * Defines how multiplayer server folders are named. <br>
+	 * Note: Changing this while connected to a multiplayer world will cause undefined behavior!
+	 */
+	IDhApiConfigValue<EServerFolderNameMode> getFolderSavingMode();
+	
+	/**
+	 * Defines the necessary similarity (as a percent) that two potential levels
+	 * need in order to be considered the same. <br> <br>
+	 *
+	 * Setting this to zero causes every level of a specific dimension type to be consider
+	 * the same level. <br>
+	 * Setting this to a non-zero value allows for usage in servers that user Multiverse
+	 * or similar mods.
+	 */
+	IDhApiConfigValue<Double> getMultiverseSimilarityRequirement();
+	
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/config/client/IDhApiThreadingConfig.java

@@ -0,0 +1,64 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.interfaces.config.client;
+
+import com.seibel.lod.api.interfaces.config.IDhApiConfigValue;
+import com.seibel.lod.api.interfaces.config.IDhApiConfigGroup;
+
+/**
+ * Distant Horizons' threading configuration.
+ *
+ * @author James Seibel
+ * @version 2022-9-15
+ */
+public interface IDhApiThreadingConfig extends IDhApiConfigGroup
+{
+	
+	/**
+	 * Defines how many world generator threads are used to generate
+	 * terrain outside Minecraf's vanilla render distance. <br>
+	 * <br>
+	 * If the number of threads is less than 1 it will be treated as a percentage
+	 * representing how often the single thread will actively generate terrain. <br> <br>
+	 *
+	 * 0.1 = 1 thread active 10% of the time <br>
+	 * 0.5 = 1 thread active 50% of the time <br>
+	 * 1.0 = 1 thread active 100% of the time <br>
+	 * 1.5 = 2 threads active 100% of the time (partial values are rounded up) <br>
+	 * 2.0 = 2 threads active 100% of the time <br>
+	 *
+	 * @deprecated this (and the related config) should be replaced with an int
+	 * 				count of threads and then a double percent active config.
+	 */
+	@Deprecated
+	IDhApiConfigValue<Double> getWorldGeneratorThread();
+	
+	// TODO the above should be replaced with these
+//	IDhApiConfig<Integer> getWorldGeneratorThreadConfig()
+//	{ return new DhApiConfig<>(Threading.numberOfWorldGenerationThreads); }
+	
+//	IDhApiConfig<Double> getWorldGeneratorThreadActivePercentConfig()
+//	{ return new DhApiConfig<>(Threading.ToBeDetermined); }
+	
+	
+	/** Defines how many buffer (GPU Terrain data) builder threads are used. */
+	IDhApiConfigValue<Integer> getBufferBuilderThread();
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/data/IDhApiTerrainDataRepo.java

@@ -0,0 +1,64 @@
+package com.seibel.lod.api.interfaces.data;
+
+import com.seibel.lod.api.interfaces.world.IDhApiLevelWrapper;
+import com.seibel.lod.api.objects.DhApiResult;
+import com.seibel.lod.api.objects.data.DhApiRaycastResult;
+import com.seibel.lod.api.objects.data.DhApiTerrainDataPoint;
+
+/**
+ * Used to interface with Distant Horizons' terrain data.
+ * 
+ * @author James Seibel
+ * @version 2022-11-19
+ */
+public interface IDhApiTerrainDataRepo
+{
+	/** Returns the terrain datapoint at the given block position, at or containing the given Y position. */
+	DhApiResult<DhApiTerrainDataPoint> getSingleDataPointAtBlockPos(IDhApiLevelWrapper levelWrapper, int blockPosX, int blockPosY, int blockPosZ);
+	/** Returns every datapoint in the column located at the given block X and Z position top to bottom. */
+	DhApiResult<DhApiTerrainDataPoint[]> getColumnDataAtBlockPos(IDhApiLevelWrapper levelWrapper, int blockPosX, int blockPosZ);
+	
+	
+	/** 
+	 * Returns every datapoint in the given chunk's X and Z position. <br><br>
+	 * 
+	 * The returned array is ordered: [relativeBlockX][relativeBlockZ][columnIndex] <br>
+	 * RelativeBlockX/Z are relative to the block position closest to negative infinity in the chunk's position. <br>
+	 * The column data is ordered from top to bottom. Note: each column may have a different number of values. <br>
+	 */
+	DhApiResult<DhApiTerrainDataPoint[][][]> getAllTerrainDataAtChunkPos(IDhApiLevelWrapper levelWrapper, int chunkPosX, int chunkPosZ);
+	
+	
+	/**
+	 * Returns every datapoint in the given region's X and Z position. <br><br>
+	 *
+	 * The returned array is ordered: [relativeBlockX][relativeBlockZ][columnIndex] <br>
+	 * RelativeBlockX/Z are relative to the block position closest to negative infinity in the region's position. <br>
+	 * The column data is ordered from top to bottom. Note: each column may have a different number of values. <br>
+	 */
+	DhApiResult<DhApiTerrainDataPoint[][][]> getAllTerrainDataAtRegionPos(IDhApiLevelWrapper levelWrapper, int regionPosX, int regionPosZ);
+	
+	
+	/**
+	 * 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).
+	 * 
+	 * @param detailLevel a positive byte defining the detail level of the returned data. <br>
+	 * 					  Every increase doubles the width of the returned area. <br>
+	 * 					  Example values: 0 = block, 1 = 2x2 blocks, 2 = 4x4 blocks, ... 4 = chunk (16x16 blocks), ... 9 = region (512x512 blocks)
+	 */
+	DhApiResult<DhApiTerrainDataPoint[][][]> getAllTerrainDataAtDetailLevelAndPos(IDhApiLevelWrapper levelWrapper, byte detailLevel, int posX, int posZ);
+	
+	
+	/**
+	 * Returns the datapoint and position of the LOD
+	 * at the end of the given ray. <br><br>
+	 * 
+	 * Will return "success" with a null datapoint if the ray reaches the max length without finding any data.
+	 */
+	DhApiResult<DhApiRaycastResult> raycast(IDhApiLevelWrapper levelWrapper,
+			double rayOriginX, double rayOriginY, double rayOriginZ,
+			float rayDirectionX, float rayDirectionY, float rayDirectionZ,
+			int maxRayBlockLength);
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/events/IDhApiEventInjector.java

@@ -0,0 +1,54 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.interfaces.events;
+
+import com.seibel.lod.api.methods.events.interfaces.IDhApiEvent;
+import com.seibel.lod.coreapi.interfaces.dependencyInjection.IDependencyInjector;
+
+/**
+ * This class takes care of dependency injection for API events.
+ *
+ * @author James Seibel
+ * @version 2022-9-13
+ */
+public interface IDhApiEventInjector extends IDependencyInjector<IDhApiEvent>
+{
+	
+	/**
+	 * Unlinks the given event handler, preventing the handler from being called in the future.
+	 *
+	 * @throws IllegalArgumentException if the implementation object doesn't implement the interface
+	 * @return true if the handler was unbound, false if the handler wasn't bound.
+	 */
+	// 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;
+	
+	
+	/**
+	 * Fires all bound events of the given type (does nothing if no events are bound).
+	 *
+	 * @param abstractEvent event type
+	 * @param eventParameterObject event parameter
+	 * @return if any of bound event handlers returned that this event should be canceled.
+	 * @param <T> the parameter type taken by the event handlers.
+	 */
+	<T, U extends IDhApiEvent<T>> boolean fireAllEvents(Class<U> abstractEvent, T eventParameterObject);
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/override/AbstractDhApiWorldGenerator.java

@@ -0,0 +1,31 @@
+package com.seibel.lod.api.interfaces.override;
+
+import com.seibel.lod.api.enums.worldGeneration.EDhApiDistantGeneratorMode;
+import com.seibel.lod.api.interfaces.world.IDhApiLevelWrapper;
+import com.seibel.lod.api.enums.worldGeneration.EDhApiWorldGenThreadMode;
+import com.seibel.lod.api.interfaces.world.IDhApiChunkWrapper;
+
+/**
+ * @author James Seibel
+ * @version 2022-9-8
+ */
+public abstract class AbstractDhApiWorldGenerator implements IDhApiOverrideable
+{	
+	/** Returns which thread chunk generation requests can be created on. */
+	public abstract EDhApiWorldGenThreadMode getThreadingMode();
+	
+	public EDhApiWorldGenThreadMode getCoreThreadingMode()
+	{
+		return this.getThreadingMode();
+	}
+	
+	public abstract IDhApiChunkWrapper generateChunk(int chunkPosX, int chunkPosZ, IDhApiLevelWrapper serverLevelWrapper, EDhApiDistantGeneratorMode maxStepToGenerate);
+	
+	public final IDhApiChunkWrapper generateCoreChunk(int chunkPosX, int chunkPosZ, IDhApiLevelWrapper serverLevelWrapper, EDhApiDistantGeneratorMode maxStepToGenerate)
+	{
+		// TODO probably need to change the return type
+		return null; //generateChunk(chunkPosX, chunkPosZ, null, generationStepEnumConverter.convertToApiType(maxStepToGenerate));
+	}
+	
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/override/IDhApiOverrideable.java

@@ -0,0 +1,20 @@
+package com.seibel.lod.api.interfaces.override;
+
+import com.seibel.lod.coreapi.interfaces.dependencyInjection.IBindable;
+import com.seibel.lod.coreapi.interfaces.dependencyInjection.IOverrideInjector;
+
+/**
+ * Implemented by all DhApi objects that can be overridden.
+ *
+ * @author James Seibel
+ * @version 2022-9-5
+ */
+public interface IDhApiOverrideable extends IBindable
+{
+	/**
+	 * Higher (larger numerical) priorities override lower (smaller numerical) priorities . <br>
+	 * For most developers this can be left at the default.
+	 */
+	default int getPriority() { return IOverrideInjector.DEFAULT_NON_CORE_OVERRIDE_PRIORITY; }
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/override/worldGenerator/IDhApiWorldGenerator.java

@@ -0,0 +1,126 @@
+package com.seibel.lod.api.interfaces.override.worldGenerator;
+
+import com.seibel.lod.api.enums.EDhApiDetailLevel;
+import com.seibel.lod.api.enums.worldGeneration.EDhApiDistantGeneratorMode;
+import com.seibel.lod.api.enums.worldGeneration.EDhApiWorldGenThreadMode;
+import com.seibel.lod.api.interfaces.override.IDhApiOverrideable;
+
+import java.io.Closeable;
+import java.util.concurrent.CompletableFuture;
+import java.util.function.Consumer;
+
+/**
+ * @author James Seibel
+ * @version 2022-12-10
+ */
+public interface IDhApiWorldGenerator extends Closeable, IDhApiOverrideable
+{
+	//============//
+	// parameters //
+	//============//
+	
+	/** 
+	 * Returns which thread chunk generation requests will be run on. <br>
+	 * TODO: only {@link EDhApiWorldGenThreadMode#SINGLE_THREADED} is currently supported
+	 */
+	EDhApiWorldGenThreadMode getThreadingMode();
+	
+	/**
+	 * Defines the smallest datapoint size that can be generated at a time. <br>
+	 * Minimum detail level is 0 (1 block) <br>
+	 * Default detail level is 0 <br>
+	 * For more information on what detail levels represent see: {@link EDhApiDetailLevel}. <br><br>
+	 * 
+	 * TODO: System currently only supports 1x1 block per data.
+	 * 
+	 * @see	EDhApiDetailLevel
+	 */
+	default byte getMinDataDetailLevel() { return EDhApiDetailLevel.BLOCK.detailLevel; }
+	/**
+	 * Defines the largest datapoint size that can be generated at a time. <br>
+	 * Minimum detail level is 0 (1 block) <br>
+	 * Default detail level is 0 <br>
+	 * For more information on what detail levels represent see: {@link EDhApiDetailLevel}.
+	 * 
+	 * @see	EDhApiDetailLevel
+	 */
+	default byte getMaxDataDetailLevel() { return EDhApiDetailLevel.BLOCK.detailLevel; }
+	
+	/**
+	 * When creating generation requests the system will attempt to group nearby tasks together. <br><br>
+	 * What is the minimum size a single generation call can batch together? <br>
+	 * 
+	 * Minimum detail level is 4 (the size of a MC chunk) <br>
+	 * Default detail level is 4 <br>
+	 * For more information on what detail levels represent see: {@link EDhApiDetailLevel}.
+	 * 
+	 * @see	EDhApiDetailLevel
+	 */
+	default byte getMinGenerationGranularity() { return EDhApiDetailLevel.CHUNK.detailLevel; }
+	
+	/**
+	 * When creating generation requests the system will attempt to group nearby tasks together. <br><br>
+	 * What is the maximum size a single generation call can batch together? <br>
+	 * 
+	 * Minimum detail level is 4 (the size of a MC chunk) <br>
+	 * Default detail level is 6 (4x4 chunks) <br>
+	 * For more information on what detail levels represent see: {@link EDhApiDetailLevel}.
+	 *  
+	 * @see	EDhApiDetailLevel
+	 */
+	default byte getMaxGenerationGranularity() { return (byte) (EDhApiDetailLevel.CHUNK.detailLevel + 2); }
+	
+	/** Returns true if the generator is unable to accept new generation requests. */
+	boolean isBusy();
+	
+	
+	
+	
+	//=================//
+	// world generator //
+	//=================//
+	
+	/**
+	 * This method is called by Distant Horizons to generate terrain over a given area
+	 * from a thread defined by {@link IDhApiWorldGenerator#getThreadingMode}. <br><br>
+	 * 
+	 * After a chunk has been generated it (and any necessary supporting objects as listed below) should be passed into the 
+	 * resultConsumer's {@link Consumer#accept} method. If the Consumer is given the wrong data
+	 * type(s) it will throw a {@link ClassCastException} with a list of what objects it was expecting. <br>
+	 * <strong>Note:</strong> these objects are minecraft version dependent and will change without notice!
+	 * Please run your generator in game at least once to confirm the objects you are returning are correct. <br><br>
+	 * 
+	 * Consumer expected inputs for each minecraft version (in order): <br>
+	 * <strong>1.18:</strong> {@link net.minecraft.world.level.chunk.ChunkAccess} and {@link net.minecraft.world.level.LevelReader} <br>
+	 * 
+	 * @throws ClassCastException if incompatible objects are passed into the resultConsumer.
+	 */
+	CompletableFuture<Void> generateChunks(int chunkPosMinX, int chunkPosMinZ,
+			byte granularity, byte targetDataDetail, EDhApiDistantGeneratorMode generatorMode,
+			Consumer<Object[]> resultConsumer) throws ClassCastException;
+	
+	
+	
+	//===============//
+	// event methods //
+	//===============//
+	
+	/**
+	 * Called before a new generator task is started. <br>
+	 * This can be used to run cleanup on existing tasks before new tasks are started.
+	 */
+	void preGeneratorTaskStart();
+	
+	
+	
+	//===========//
+	// overrides //
+	//===========//
+	
+	// This is overridden to remove the "throws IOException" 
+	// that is present in the default Closeable.close() method 
+	@Override
+	void close();
+	
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/override/worldGenerator/IDhApiWorldGeneratorOverrideRegister.java

@@ -0,0 +1,23 @@
+package com.seibel.lod.api.interfaces.override.worldGenerator;
+
+import com.seibel.lod.api.interfaces.world.IDhApiLevelWrapper;
+import com.seibel.lod.api.objects.DhApiResult;
+
+/**
+ * Handles adding world generator overrides.
+ *
+ * @author James Seibel
+ * @version 2022-12-10
+ */
+public interface IDhApiWorldGeneratorOverrideRegister
+{
+	/**
+	 * Registers the given world generator for the given level. <Br> <Br>
+	 *
+	 * Only one world generator can be registered for a specific level at a given time. <Br>
+	 * If another world generator has already been registered, DhApiResult will return
+	 * the name of the previously registered generator and success = false.
+	 */
+	DhApiResult<Void> registerWorldGeneratorOverride(IDhApiLevelWrapper levelWrapper, IDhApiWorldGenerator worldGenerator);
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/render/IDhApiRenderProxy.java

@@ -0,0 +1,47 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.interfaces.render;
+
+import com.seibel.lod.api.objects.DhApiResult;
+
+/**
+ * Used to interact with Distant Horizons rendering systems.
+ * 
+ * @author James Seibel
+ * @version 2023-2-8
+ */
+public interface IDhApiRenderProxy
+{
+	/** 
+	 * Forces any cached render data to be deleted and regenerated.
+	 * This is generally called whenever resource packs are changed or specific
+	 * rendering settings are changed in Distant Horizon's config. <Br><Br>
+	 * 
+	 * If this is called on a dedicated server it won't do anything and will return {@link DhApiResult#success} = false <Br><Br>
+	 * 
+	 * Background: <Br>
+	 * Distant Horizons has two different file formats: Full data and Render data. <Br>
+	 * - Full data files store the block, biome, etc. information and is the result of loading or generating new chunks. <Br>
+	 * - Render data files store LOD colors and are created using the Full data and currently loaded resource packs. <Br>
+	 *   This is the data cleared by this method.
+	 */
+	DhApiResult<Boolean> clearRenderDataCache();
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/world/IDhApiChunkWrapper.java

@@ -0,0 +1,68 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.interfaces.world;
+
+import com.seibel.lod.api.interfaces.IDhApiUnsafeWrapper;
+
+/**
+ * @author James Seibel
+ * @version 2022-7-14
+ */
+public interface IDhApiChunkWrapper extends IDhApiUnsafeWrapper
+{
+	/** Returns the absolute Y coordinate of the highest block for the given relative X and Z coordinates. */
+	int getMaxY(int relativeX, int relativeZ);
+	/** Returns the maximum absolute block position in the X direction. */
+	int getMaxX();
+	/** Returns the maximum absolute block position in the Z direction. */
+	int getMaxZ();
+	
+	/** Returns the absolute Y coordinate of the lowest block for the given relative X and Z coordinates. */
+	int getMinY(int relativeX, int relativeZ);
+	/** Returns the minimum absolute block position in the X direction. */
+	int getMinX();
+	/** Returns the minimum absolute block position in the Z direction. */
+	int getMinZ();
+	
+	/**
+	 * Returns true if this chunk's lighting has been built. <br>
+	 * Note: for some versions of Minecraft this value may be unreliable.
+	 */
+	boolean isLightCorrect();
+	
+	/** TODO what side of the block should this return the light for? */
+	default int getBlockLight(int x, int y, int z) {return -1;}
+	/** TODO what side of the block should this return the light for? */
+	default int getSkyLight(int x, int y, int z) {return -1;}
+	
+	/**
+	 * Returns true if chunks exist in all 4 cardinal and 4 ordinal directions
+	 * relative to this chunk. <br>
+	 * IE: returns true if there are chunks to the North, South, East, West, NE, SE, SW, and NW
+	 * of this chunk.
+	 */
+	boolean doNearbyChunksExist();
+	
+	
+	// TODO these will probably need replacing once 1.7's ID system is done
+	//IBlockStateWrapper getBlockState(int x, int y, int z);
+	//IBiomeWrapper getBiome(int x, int y, int z);
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/world/IDhApiDimensionTypeWrapper.java

@@ -1,35 +1,35 @@
 /*
  *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
- *    licensed under the GNU GPL v3 License.
+ *    licensed under the GNU LGPL v3 License.
  *
  *    Copyright (C) 2020-2022  James Seibel
  *
  *    This program is free software: you can redistribute it and/or modify
- *    it under the terms of the GNU General Public License as published by
+ *    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 General Public License for more details.
+ *    GNU Lesser General Public License for more details.
  *
- *    You should have received a copy of the GNU General Public License
+ *    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.lod.core.wrapperInterfaces.world;
+package com.seibel.lod.api.interfaces.world;
 
-import com.seibel.lod.core.handlers.dependencyInjection.IBindable;
+import com.seibel.lod.api.interfaces.IDhApiUnsafeWrapper;
 
 /**
  * @author James Seibel
- * @version 3-5-2022
+ * @version 2022-7-14
  */
-public interface IDimensionTypeWrapper extends IBindable
+public interface IDhApiDimensionTypeWrapper extends IDhApiUnsafeWrapper
 {
 	String getDimensionName();
 	
 	boolean hasCeiling();
-
+	
 	boolean hasSkyLight();
 }

api/src/main/java/com/seibel/lod/api/interfaces/world/IDhApiLevelWrapper.java

@@ -0,0 +1,50 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.interfaces.world;
+
+import com.seibel.lod.api.interfaces.IDhApiUnsafeWrapper;
+import com.seibel.lod.api.enums.worldGeneration.EDhApiLevelType;
+
+/**
+ * Can be either a Server or Client level.
+ * 
+ * @author James Seibel
+ * @version 2022-7-14
+ */
+public interface IDhApiLevelWrapper extends IDhApiUnsafeWrapper
+{
+	IDhApiDimensionTypeWrapper getDimensionType();
+	
+	EDhApiLevelType getLevelType();
+	
+	boolean hasCeiling();
+	
+	boolean hasSkyLight();
+	
+	/** Returns the max block height of the level(?) */
+	int getHeight();
+	
+	/** 
+	 * Returns the lowest possible block position for the level. <br>
+	 * For MC versions before 1.18 this will return 0.
+	 */
+	default int getMinHeight() { return 0; }
+	
+}

api/src/main/java/com/seibel/lod/api/interfaces/world/IDhApiWorldProxy.java

@@ -0,0 +1,62 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.interfaces.world;
+
+import com.seibel.lod.api.interfaces.IDhApiUnsafeWrapper;
+
+/**
+ * Used to interact with Distant Horizons current world.
+ * 
+ * @author James Seibel
+ * @version 2022-11-20
+ */
+public interface IDhApiWorldProxy
+{
+	/** Returns true if a world is loaded. */
+	boolean worldLoaded();
+	
+	
+	/** 
+	 * In singleplayer this will return the level the player is currently in. <br>
+	 * In multiplayer this will return null.
+	 * 
+	 * @throws IllegalStateException if no world is loaded
+	 */
+	IDhApiLevelWrapper getSinglePlayerLevel() throws IllegalStateException;
+	
+	/** @throws IllegalStateException if no world is loaded */
+	Iterable<IDhApiLevelWrapper> getAllLoadedLevelWrappers() throws IllegalStateException;
+	
+	/** 
+	 * In the case of servers running multiverse there may be multiple levels for the same dimensionType.
+	 *
+	 * @throws IllegalStateException if no world is loaded 
+	 */
+	Iterable<IDhApiLevelWrapper> getAllLoadedLevelsForDimensionType(IDhApiDimensionTypeWrapper dimensionTypeWrapper) throws IllegalStateException;
+	
+	/**
+	 * Returns any dimensions that have names containing the given string (case-insensitive). <br>
+	 * In the case of servers running multiverse there may be multiple levels for the same dimensionType. 
+	 *
+	 * @throws IllegalStateException if no world is loaded 
+	 */
+	Iterable<IDhApiLevelWrapper> getAllLoadedLevelsWithDimensionNameLike(String dimensionName) throws IllegalStateException;
+	
+}

api/src/main/java/com/seibel/lod/api/methods/events/DhApiEventRegister.java

@@ -0,0 +1,51 @@
+package com.seibel.lod.api.methods.events;
+
+import com.seibel.lod.api.objects.DhApiResult;
+import com.seibel.lod.api.methods.events.interfaces.IDhApiEvent;
+import com.seibel.lod.coreapi.DependencyInjection.ApiEventInjector;
+
+/**
+ * Handles adding/removing event handlers.
+ *
+ * @author James Seibel
+ * @version 2022-9-16
+ */
+public class DhApiEventRegister
+{
+	/**
+	 * Registers the given event handler. <Br>
+	 * Only one eventHandler of a specific class can be registered at a time.
+	 * If multiple of the same eventHandler are added DhApiResult will return
+	 * the name of the already added handler and success = false.
+	 */
+	public static DhApiResult<Void> on(Class<? extends IDhApiEvent> eventInterface, IDhApiEvent eventHandlerImplementation)
+	{
+		try
+		{
+			ApiEventInjector.INSTANCE.bind(eventInterface, eventHandlerImplementation);
+			return DhApiResult.createSuccess();
+		}
+		catch (IllegalStateException e)
+		{
+			return DhApiResult.createFail(e.getMessage());
+		}
+	}
+
+	/**
+	 * Unregisters the given event handler for this event if one has been registered. <br>
+	 * If no eventHandler of the given class has been registered the result will return
+	 * success = false.
+	 */
+	public static DhApiResult<Void> off(Class<? extends IDhApiEvent> eventInterface, Class<IDhApiEvent> eventHandlerClass)
+	{
+		if (ApiEventInjector.INSTANCE.unbind(eventInterface, eventHandlerClass))
+		{
+			return DhApiResult.createSuccess();
+		}
+		else
+		{
+			return DhApiResult.createFail("No event handler [" + eventHandlerClass.getSimpleName() + "] was bound for the event [" + eventInterface.getSimpleName() + "].");
+		}
+	}
+	
+}

api/src/main/java/com/seibel/lod/api/methods/events/Readme.md

@@ -0,0 +1,3 @@
+The events api package holds objects and methods for listening to events fired by Distant Horizons'.
+
+Each interface should only contain one method and that method should match the name of the file. This is done so Developers can mix and match what events they want their classes to handle.

api/src/main/java/com/seibel/lod/api/methods/events/abstractEvents/DhApiAfterDhInitEvent.java

@@ -0,0 +1,31 @@
+package com.seibel.lod.api.methods.events.abstractEvents;
+
+import com.seibel.lod.api.methods.events.interfaces.IDhApiEvent;
+import com.seibel.lod.api.objects.events.DhApiEventDefinition;
+
+/**
+ * @author James Seibel
+ * @version 2022-11-21
+ */
+public abstract class DhApiAfterDhInitEvent implements IDhApiEvent<Void>
+{
+	/** Fired after Distant Horizons finishes its initial setup on Minecraft startup. */
+	public abstract void afterDistantHorizonsInit();
+	
+	
+	//=========================//
+	// internal DH API methods //
+	//=========================//
+	
+	@Override
+	public final boolean fireEvent(Void ignoredParam)
+	{
+		this.afterDistantHorizonsInit();
+		return false;
+	}
+		
+	public final static DhApiEventDefinition EVENT_DEFINITION = new DhApiEventDefinition(false, true);
+	@Override
+	public final DhApiEventDefinition getEventDefinition() { return EVENT_DEFINITION; }
+	
+}

api/src/main/java/com/seibel/lod/api/methods/events/abstractEvents/DhApiAfterRenderEvent.java

@@ -0,0 +1,45 @@
+package com.seibel.lod.api.methods.events.abstractEvents;
+
+import com.seibel.lod.api.methods.events.interfaces.IDhApiEvent;
+import com.seibel.lod.api.methods.events.sharedParameterObjects.DhApiRenderParam;
+import com.seibel.lod.api.objects.events.DhApiEventDefinition;
+
+/**
+ * @author James Seibel
+ * @version 2022-11-21
+ */
+public abstract class DhApiAfterRenderEvent implements IDhApiEvent<DhApiAfterRenderEvent.EventParam>
+{
+	/** Fired after Distant Horizons finishes rendering fake chunks. */
+	public abstract void afterRender(EventParam input);
+	
+	
+	//=========================//
+	// internal DH API methods //
+	//=========================//
+	
+	@Override
+	public final boolean fireEvent(EventParam input)
+	{
+		this.afterRender(input);
+		return false;
+	}
+	
+	public final static DhApiEventDefinition EVENT_DEFINITION = new DhApiEventDefinition(false, false);
+	@Override
+	public final DhApiEventDefinition getEventDefinition() { return EVENT_DEFINITION; }
+	
+	
+	//==================//
+	// parameter object //
+	//==================//
+	
+	public static class EventParam extends DhApiRenderParam
+	{
+		public EventParam(DhApiRenderParam parent)
+		{
+			super(parent.mcProjectionMatrix, parent.mcModelViewMatrix, parent.dhProjectionMatrix, parent.dhModelViewMatrix, parent.partialTicks);
+		}
+	}
+	
+}

api/src/main/java/com/seibel/lod/api/methods/events/abstractEvents/DhApiBeforeDhInitEvent.java

@@ -0,0 +1,33 @@
+package com.seibel.lod.api.methods.events.abstractEvents;
+
+
+
+import com.seibel.lod.api.methods.events.interfaces.IDhApiEvent;
+import com.seibel.lod.api.objects.events.DhApiEventDefinition;
+
+/**
+ * @author James Seibel
+ * @version 2022-11-21
+ */
+public abstract class DhApiBeforeDhInitEvent implements IDhApiEvent<Void>
+{
+	/** Fired before Distant Horizons starts its initial setup on Minecraft startup. */
+	public abstract void beforeDistantHorizonsInit();
+	
+	
+	//=========================//
+	// internal DH API methods //
+	//=========================//
+	
+	@Override
+	public final boolean fireEvent(Void ignoredParam)
+	{
+		this.beforeDistantHorizonsInit();
+		return false;
+	}
+	
+	public final static DhApiEventDefinition EVENT_DEFINITION = new DhApiEventDefinition(false, true);
+	@Override
+	public final DhApiEventDefinition getEventDefinition() { return EVENT_DEFINITION; }
+	
+}

api/src/main/java/com/seibel/lod/api/methods/events/abstractEvents/DhApiBeforeRenderEvent.java

@@ -0,0 +1,45 @@
+package com.seibel.lod.api.methods.events.abstractEvents;
+
+import com.seibel.lod.api.methods.events.interfaces.IDhApiEvent;
+import com.seibel.lod.api.methods.events.sharedParameterObjects.DhApiRenderParam;
+import com.seibel.lod.api.objects.events.DhApiEventDefinition;
+
+/**
+ * @author James Seibel
+ * @version 2022-11-21
+ */
+public abstract class DhApiBeforeRenderEvent implements IDhApiEvent<DhApiBeforeRenderEvent.EventParam>
+{
+	/**
+	 * Fired before Distant Horizons renders fake chunks.
+	 *
+	 * @return whether the event should be canceled or not.
+	 */
+	public abstract boolean beforeRender(EventParam input);
+	
+	
+	//=========================//
+	// internal DH API methods //
+	//=========================//
+	
+	@Override
+	public final boolean fireEvent(EventParam input) { return this.beforeRender(input); }
+	
+	public final static DhApiEventDefinition EVENT_DEFINITION = new DhApiEventDefinition(true, false);
+	@Override
+	public final DhApiEventDefinition getEventDefinition() { return EVENT_DEFINITION; }
+	
+	
+	//==================//
+	// parameter object //
+	//==================//
+	
+	public static class EventParam extends DhApiRenderParam
+	{
+		public EventParam(DhApiRenderParam parent)
+		{
+			super(parent.mcProjectionMatrix, parent.mcModelViewMatrix, parent.dhProjectionMatrix, parent.dhModelViewMatrix, parent.partialTicks);
+		}
+	}
+	
+}

api/src/main/java/com/seibel/lod/api/methods/events/abstractEvents/DhApiLevelLoadEvent.java

@@ -0,0 +1,46 @@
+package com.seibel.lod.api.methods.events.abstractEvents;
+
+import com.seibel.lod.api.interfaces.world.IDhApiLevelWrapper;
+import com.seibel.lod.api.methods.events.interfaces.IDhApiEvent;
+import com.seibel.lod.api.objects.events.DhApiEventDefinition;
+
+/**
+ * @author James Seibel
+ * @version 2022-11-21
+ */
+public abstract class DhApiLevelLoadEvent implements IDhApiEvent<DhApiLevelLoadEvent.EventParam>
+{
+	/** Fired after Distant Horizons loads a new level. */
+	public abstract void onLevelLoad(EventParam input);
+	
+	
+	//=========================//
+	// internal DH API methods //
+	//=========================//
+	
+	@Override
+	public final boolean fireEvent(EventParam input)
+	{
+		this.onLevelLoad(input);
+		return false;
+	}
+	
+	public final static DhApiEventDefinition EVENT_DEFINITION = new DhApiEventDefinition(false, false);
+	@Override
+	public final DhApiEventDefinition getEventDefinition() { return EVENT_DEFINITION; }
+	
+	
+	//==================//
+	// parameter object //
+	//==================//
+	
+	public static class EventParam
+	{
+		/** The newly loaded level. */
+		public final IDhApiLevelWrapper levelWrapper;
+		
+		
+		public EventParam(IDhApiLevelWrapper newLevelWrapper) { this.levelWrapper = newLevelWrapper; }
+	}
+	
+}

api/src/main/java/com/seibel/lod/api/methods/events/abstractEvents/DhApiLevelSaveEvent.java

@@ -0,0 +1,46 @@
+package com.seibel.lod.api.methods.events.abstractEvents;
+
+import com.seibel.lod.api.interfaces.world.IDhApiLevelWrapper;
+import com.seibel.lod.api.methods.events.interfaces.IDhApiEvent;
+import com.seibel.lod.api.objects.events.DhApiEventDefinition;
+
+/**
+ * @author James Seibel
+ * @version 2022-11-21
+ */
+public abstract class DhApiLevelSaveEvent implements IDhApiEvent<DhApiLevelSaveEvent.EventParam>
+{
+	/** Fired after Distant Horizons saves LOD data for the server. */
+	public abstract void onLevelSave(EventParam input);
+	
+	
+	//=========================//
+	// internal DH API methods //
+	//=========================//
+	
+	@Override
+	public final boolean fireEvent(EventParam input)
+	{
+		this.onLevelSave(input);
+		return false;
+	}
+	
+	public final static DhApiEventDefinition EVENT_DEFINITION = new DhApiEventDefinition(false, false);
+	@Override
+	public final DhApiEventDefinition getEventDefinition() { return EVENT_DEFINITION; }
+	
+	
+	//==================//
+	// parameter object //
+	//==================//
+	
+	public static class EventParam
+	{
+		/** The saved level. */
+		public final IDhApiLevelWrapper levelWrapper;
+		
+		
+		public EventParam(IDhApiLevelWrapper newLevelWrapper) { this.levelWrapper = newLevelWrapper; }
+	}
+	
+}

api/src/main/java/com/seibel/lod/api/methods/events/abstractEvents/DhApiLevelUnloadEvent.java

@@ -0,0 +1,45 @@
+package com.seibel.lod.api.methods.events.abstractEvents;
+
+import com.seibel.lod.api.interfaces.world.IDhApiLevelWrapper;
+import com.seibel.lod.api.methods.events.interfaces.IDhApiEvent;
+import com.seibel.lod.api.objects.events.DhApiEventDefinition;
+
+/**
+ * @author James Seibel
+ * @version 2022-11-21
+ */
+public abstract class DhApiLevelUnloadEvent implements IDhApiEvent<DhApiLevelUnloadEvent.EventParam>
+{
+	/** Fired before Distant Horizons unloads a level. */
+	public abstract void onLevelUnload(EventParam input);
+	
+	
+	//=========================//
+	// internal DH API methods //
+	//=========================//
+	
+	@Override
+	public final boolean fireEvent(EventParam input)
+	{
+		this.onLevelUnload(input);
+		return false;
+	}
+	
+	public final static DhApiEventDefinition EVENT_DEFINITION = new DhApiEventDefinition(false, false);
+	@Override
+	public final DhApiEventDefinition getEventDefinition() { return EVENT_DEFINITION; }
+	
+	
+	//==================//
+	// parameter object //
+	//==================//
+	
+	public static class EventParam
+	{
+		/** The recently unloaded level. */
+		public final IDhApiLevelWrapper levelWrapper;
+		
+		public EventParam(IDhApiLevelWrapper newLevelWrapper) { this.levelWrapper = newLevelWrapper; }
+	}
+	
+}

api/src/main/java/com/seibel/lod/api/methods/events/interfaces/IDhApiEvent.java

@@ -0,0 +1,52 @@
+package com.seibel.lod.api.methods.events.interfaces;
+
+import com.seibel.lod.api.objects.events.DhApiEventDefinition;
+import com.seibel.lod.coreapi.interfaces.dependencyInjection.IBindable;
+
+/**
+ * The interface used by all DH Api events.
+ * 
+ * @param <T> This is the datatype that will be passed into the event handler's method.
+ * 
+ * @author James Seibel
+ * @version 2022-11-20
+ */
+public interface IDhApiEvent<T> extends IBindable
+{
+	//==========//
+	// external //
+	//==========//
+	
+	/**
+	 * Returns true if the event should be automatically unbound
+	 * after firing. <br>
+	 * Can be useful for one time setup events or waiting for a specific game state. <br> <Br>
+	 *
+	 * Defaults to False
+	 * IE: The event will not be removed after firing and will continue firing until removed.
+	 */
+	default boolean removeAfterFiring() { return false; };
+	
+	
+	//==========//
+	// internal //
+	//==========//
+	
+	/** 
+	 * The event definition includes meta information about how the event will behave. <br>
+	 * For example: if the event is cancelable or not.
+	 */
+	DhApiEventDefinition getEventDefinition();
+	
+	/**
+	 * Called internally by Distant Horizons when the event happens.
+	 * This method shouldn't directly be overridden and
+	 * should call a more specific method instead.
+	 *
+	 * @param input the parameter object passed in from the event source. Can be null.
+	 * @return whether the event should be canceled or not.
+	 * 		   A canceled event will still fire the other event handlers that are queued.
+	 */
+	boolean fireEvent(T input);
+	
+}

api/src/main/java/com/seibel/lod/api/methods/events/sharedParameterObjects/DhApiRenderParam.java

@@ -0,0 +1,42 @@
+package com.seibel.lod.api.methods.events.sharedParameterObjects;
+
+import com.seibel.lod.coreapi.util.math.Mat4f;
+
+/**
+ * Parameter passed into Render events.
+ *
+ * @author James Seibel
+ * @version 2022-9-5
+ */
+public class DhApiRenderParam
+{
+	/** The projection matrix Minecraft is using to render this frame. */
+	public final Mat4f mcProjectionMatrix;
+	/** The model view matrix Minecraft is using to render this frame. */
+	public final Mat4f mcModelViewMatrix;
+	
+	/** The projection matrix Distant Horizons is using to render this frame. */
+	public final Mat4f dhProjectionMatrix;
+	/** The model view matrix Distant Horizons is using to render this frame. */
+	public final Mat4f dhModelViewMatrix;
+	
+	/** Indicates how far into this tick the frame is. */
+	public final float partialTicks;
+	
+	
+	
+	public DhApiRenderParam(
+			Mat4f newMcProjectionMatrix, Mat4f newMcModelViewMatrix,
+			Mat4f newDhProjectionMatrix, Mat4f newDhModelViewMatrix,
+			float newPartialTicks)
+	{
+		this.mcProjectionMatrix = newMcProjectionMatrix;
+		this.mcModelViewMatrix = newMcModelViewMatrix;
+		
+		this.dhProjectionMatrix = newDhProjectionMatrix;
+		this.dhModelViewMatrix = newDhModelViewMatrix;
+		
+		this.partialTicks = newPartialTicks;
+	}
+	
+}

api/src/main/java/com/seibel/lod/api/methods/override/DhApiWorldGeneratorOverrideRegister.java

@@ -0,0 +1,37 @@
+package com.seibel.lod.api.methods.override;
+
+import com.seibel.lod.api.interfaces.override.worldGenerator.IDhApiWorldGenerator;
+import com.seibel.lod.api.interfaces.override.worldGenerator.IDhApiWorldGeneratorOverrideRegister;
+import com.seibel.lod.api.interfaces.world.IDhApiLevelWrapper;
+import com.seibel.lod.api.objects.DhApiResult;
+import com.seibel.lod.coreapi.DependencyInjection.WorldGeneratorInjector;
+
+/**
+ * Handles adding world generator overrides.
+ *
+ * @author James Seibel
+ * @version 2022-12-10
+ */
+public class DhApiWorldGeneratorOverrideRegister implements IDhApiWorldGeneratorOverrideRegister
+{
+	public static DhApiWorldGeneratorOverrideRegister INSTANCE = new DhApiWorldGeneratorOverrideRegister();
+	
+	private DhApiWorldGeneratorOverrideRegister() {  }
+	
+	
+	
+	@Override
+	public DhApiResult<Void> registerWorldGeneratorOverride(IDhApiLevelWrapper levelWrapper, IDhApiWorldGenerator worldGenerator)
+	{
+		try
+		{
+			WorldGeneratorInjector.INSTANCE.bind(levelWrapper, worldGenerator);
+			return DhApiResult.createSuccess();
+		}
+		catch (Exception e)
+		{
+			return DhApiResult.createFail(e.getMessage());
+		}
+	}
+	
+}

api/src/main/java/com/seibel/lod/api/methods/override/Readme.md

@@ -0,0 +1 @@
+The overide api package holds objects and methods for overriding Distant Horizons' backend systems, so they can be replaced and improved.

api/src/main/java/com/seibel/lod/api/objects/DhApiResult.java

@@ -0,0 +1,51 @@
+package com.seibel.lod.api.objects;
+
+/**
+ * Allows for more descriptive non-critical failure states.
+ * 
+ * @param <T> The payload type this result contains, can be Void if the result is just used to notify success/failure. 
+ * 
+ * @author James Seibel
+ * @version 2022-11-24
+ */
+public class DhApiResult<T>
+{
+	/** True if the action succeeded, false otherwise. */
+	public final boolean success;
+	
+	/**
+	 * If the action failed this will contain the reason as to why. <br>
+	 * If the action was successful this will generally be the empty string.
+	 */
+	public final String message;
+	
+	/** 
+	 * Whatever object the API Method generated/returned. <br>
+	 * Will be null/Void if this result is just used to notify success/failure. 
+	 */
+	public final T payload;
+	
+	
+	
+	// these constructors are private because the create... methods below are easier to understand
+	private DhApiResult(boolean success, String message) { this(success, message, null); }
+	private DhApiResult(boolean success, String message, T payload)
+	{
+		this.success = success;
+		// don't allow null messages, in the case of a null message return the empty string to prevent potential null pointers
+		this.message = (message == null) ? "" : message; 
+		this.payload = payload;
+	}
+	
+	
+	
+	public static <Pt> DhApiResult<Pt> createSuccess() { return new DhApiResult<>(true, ""); }
+	public static <Pt> DhApiResult<Pt> createSuccess(Pt payload) { return new DhApiResult<Pt>(true, "", payload); }
+	// There is no createSuccess(String message) method because it would be too easy to confuse with createSuccess(Pt payload) when returning null
+	public static <Pt> DhApiResult<Pt> createSuccess(String message, Pt payload) { return new DhApiResult<Pt>(true, message, payload); }
+	
+	public static <Pt> DhApiResult<Pt> createFail() { return new DhApiResult<>(false, ""); }
+	public static <Pt> DhApiResult<Pt> createFail(String message) { return new DhApiResult<>(false, message); }
+	public static <Pt> DhApiResult<Pt> createFail(String message, Pt payload) { return new DhApiResult<Pt>(false, message, payload); }
+	
+}

api/src/main/java/com/seibel/lod/api/objects/config/DhApiConfigValue.java

@@ -0,0 +1,75 @@
+package com.seibel.lod.api.objects.config;
+
+import com.seibel.lod.api.interfaces.config.IDhApiConfigValue;
+import com.seibel.lod.coreapi.interfaces.config.IConfigEntry;
+import com.seibel.lod.coreapi.interfaces.config.IConverter;
+import com.seibel.lod.coreapi.util.converters.DefaultConverter;
+
+/**
+ * A wrapper used to interface with Distant Horizon's Config. <br> <br>
+ *
+ * When using this object you need to explicitly define the generic types,
+ * otherwise Intellij won't do any type checking and the wrong types can be used. <br>
+ * For example a method returning IDhApiConfig<Integer> when the config should be a Boolean.
+ *
+ * @param <apiType> The datatype you, an API dev will use.
+ * @param <coreType> The datatype Distant Horizons uses in the background; implementing developers can ignore this.
+ *     
+ * @author James Seibel
+ * @version 2022-6-30
+ */
+public class DhApiConfigValue<coreType, apiType> implements IDhApiConfigValue<apiType>
+{
+	private final IConfigEntry<coreType> configEntry;
+	
+	private final IConverter<coreType, apiType> configConverter;
+	
+	
+	/**
+	 * This constructor should only be called internally. <br>
+	 * There is no reason for API users to create this object. <br><br>
+	 *
+	 * Uses the default object converter, this requires coreType and apiType to be the same.
+	 */
+	@SuppressWarnings("unchecked") // DefaultConverter's cast is safe
+	public DhApiConfigValue(IConfigEntry<coreType> newConfigEntry)
+	{
+		this.configEntry = newConfigEntry;
+		this.configConverter = (IConverter<coreType, apiType>) new DefaultConverter<coreType>();
+	}
+	
+	/**
+	 * This constructor should only be called internally. <br>
+	 * There is no reason for API users to create this object. <br><br>
+	 */
+	public DhApiConfigValue(IConfigEntry<coreType> newConfigEntry, IConverter<coreType, apiType> newConverter)
+	{
+		this.configEntry = newConfigEntry;
+		this.configConverter = newConverter;
+	}
+	
+	
+	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()); }
+	
+	public boolean setValue(apiType newValue)
+	{
+		if (this.configEntry.getAllowApiOverride())
+		{
+			this.configEntry.setApiValue(this.configConverter.convertToCoreType(newValue));
+			return true;
+		}
+		else
+		{
+			return false;
+		}
+	}
+	
+	public boolean getCanBeOverrodeByApi() { return this.configEntry.getAllowApiOverride(); }
+	
+	public apiType getDefaultValue() { return this.configConverter.convertToApiType(configEntry.getDefaultValue()); }
+	public apiType getMaxValue() { return this.configConverter.convertToApiType(this.configEntry.getMax()); }
+	public apiType getMinValue() { return this.configConverter.convertToApiType(this.configEntry.getMin()); }
+	
+}

api/src/main/java/com/seibel/lod/api/objects/data/DhApiRaycastResult.java

@@ -0,0 +1,36 @@
+package com.seibel.lod.api.objects.data;
+
+import com.seibel.lod.api.objects.math.DhApiVec3i;
+import com.seibel.lod.coreapi.util.math.Vec3i;
+
+/**
+ * Holds a single datapoint of terrain data
+ * and the block position from the raycast.
+ * 
+ * @author James Seibel
+ * @version 2022-11-19
+ */
+public class DhApiRaycastResult
+{
+	/** 
+	 * LOD position of this raycast. <br><br>
+	 * 
+	 * <strong>Note: </strong>
+	 * This will NOT be the exact block position if the LOD the ray
+	 * hits is more than one block tall. In that case this will
+	 * be the bottom block position for that LOD.
+	 */
+	public final DhApiVec3i pos;
+	
+	/** The LOD data at this position. */
+	public final DhApiTerrainDataPoint dataPoint;
+	
+	
+	
+	public DhApiRaycastResult(DhApiTerrainDataPoint dataPoint, Vec3i blockPos)
+	{
+		this.dataPoint = dataPoint;
+		this.pos = blockPos;
+	}
+	
+}

api/src/main/java/com/seibel/lod/api/objects/data/DhApiTerrainDataPoint.java

@@ -0,0 +1,44 @@
+package com.seibel.lod.api.objects.data;
+
+import com.seibel.lod.api.interfaces.block.IDhApiBiomeWrapper;
+import com.seibel.lod.api.interfaces.block.IDhApiBlockStateWrapper;
+
+/**
+ * Holds a single datapoint of terrain data.
+ * 
+ * @author James Seibel
+ * @version 2022-11-13
+ */
+public class DhApiTerrainDataPoint
+{
+	/**
+	 * 0 = block <br>
+	 * 1 = 2x2 blocks <br>
+	 * 2 = 4x4 blocks <br>
+	 * 4 = chunk (16x16 blocks) <br>
+	 * 9 = region (512x512 blocks) <br>
+	 */
+	public final byte detailLevel;
+	
+	public final int lightLevel;
+	public final int topYBlockPos;
+	public final int bottomYBlockPos;
+	
+	public final IDhApiBlockStateWrapper blockStateWrapper;
+	public final IDhApiBiomeWrapper biomeWrapper;
+	
+	
+	
+	public DhApiTerrainDataPoint(byte detailLevel, int lightLevel, int topYBlockPos, int bottomYBlockPos, IDhApiBlockStateWrapper blockStateWrapper, IDhApiBiomeWrapper biomeWrapper)
+	{
+		this.detailLevel = detailLevel;
+		
+		this.lightLevel = lightLevel;
+		this.topYBlockPos = topYBlockPos;
+		this.bottomYBlockPos = bottomYBlockPos;
+		
+		this.blockStateWrapper = blockStateWrapper;
+		this.biomeWrapper = biomeWrapper;
+	}
+	
+}

api/src/main/java/com/seibel/lod/api/objects/events/DhApiEventDefinition.java

@@ -0,0 +1,55 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.objects.events;
+
+import com.seibel.lod.api.methods.events.interfaces.IDhApiEvent;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+
+import java.util.HashMap;
+
+/**
+ * The event definition includes meta information about how the event will behave.
+ * 
+ * @author James Seibel
+ * @version 2022-11-20
+ */
+public class DhApiEventDefinition
+{
+	/** True if the event can be canceled. */
+	public final boolean isCancelable;
+	
+	/**
+	 * True if the event will only ever be fired once. <Br>
+	 * An example of this would be initial setup methods, DH won't run its initial setup more than once. <br><br>
+	 *
+	 * If a handler is bound for a one time event after the event has been fired, the handler will be immediately fired.
+	 */
+	public final boolean isOneTimeEvent;
+	
+	
+	
+	public DhApiEventDefinition(boolean isCancelable, boolean isOneTimeEvent)
+	{
+		this.isCancelable = isCancelable;
+		this.isOneTimeEvent = isOneTimeEvent;
+	}
+	
+}

api/src/main/java/com/seibel/lod/api/objects/math/DhApiVec3i.java

@@ -0,0 +1,92 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.api.objects.math;
+
+/**
+ * Often used to store block positions or any other 
+ * position in 3D space.
+ * 
+ * @author James Seibel
+ * @version 2022-11-19
+ */
+public class DhApiVec3i
+{
+	public int x;
+	public int y;
+	public int z;
+	
+	
+	
+	/** creates a Vec3 at (0,0,0) */
+	public DhApiVec3i()
+	{
+		this.x = 0;
+		this.y = 0;
+		this.z = 0;
+	}
+	
+	public DhApiVec3i(int x, int y, int z)
+	{
+		this.x = x;
+		this.y = y;
+		this.z = z;
+	}
+	
+	@Override
+	public boolean equals(Object obj)
+	{
+		if (this == obj)
+		{
+			return true;
+		}
+		else if (obj != null && this.getClass() == obj.getClass())
+		{
+			DhApiVec3i Vec3f = (DhApiVec3i) obj;
+			if (Float.compare(Vec3f.x, this.x) != 0)
+			{
+				return false;
+			}
+			else if (Float.compare(Vec3f.y, this.y) != 0)
+			{
+				return false;
+			}
+			else
+			{
+				return Float.compare(Vec3f.z, this.z) == 0;
+			}
+		}
+		else
+		{
+			return false;
+		}
+	}
+	
+	@Override
+	public int hashCode()
+	{
+		int i = Float.floatToIntBits(this.x);
+		i = 31 * i + Float.floatToIntBits(this.y);
+		return 31 * i + Float.floatToIntBits(this.z);
+	}
+	
+	@Override
+	public String toString() { return "[" + this.x + ", " + this.y + ", " + this.z + "]"; }
+	
+}

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

@@ -0,0 +1,155 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.coreapi.DependencyInjection;
+
+import com.seibel.lod.api.methods.events.interfaces.IDhApiEvent;
+import com.seibel.lod.coreapi.events.ApiEventDefinitionHandler;
+import com.seibel.lod.coreapi.interfaces.dependencyInjection.IBindable;
+import com.seibel.lod.api.interfaces.events.IDhApiEventInjector;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+
+/**
+ * This class takes care of dependency injection for API events.
+ * 
+ * @author James Seibel
+ * @version 2022-11-24
+ */
+public class ApiEventInjector extends DependencyInjector<IDhApiEvent> implements IDhApiEventInjector // Note to self: Don't try adding a generic type to IDhApiEvent, the constructor won't accept it
+{
+	public static final ApiEventInjector INSTANCE = new ApiEventInjector();
+	
+	private static final Logger LOGGER = LogManager.getLogger(ApiEventInjector.class.getSimpleName());
+	
+	private final HashMap<Class<? extends IDhApiEvent>, Object> firedOneTimeEventParamsByEventInterface = new HashMap<>();
+	
+	
+	
+	private ApiEventInjector() { super(IDhApiEvent.class, true); }
+	
+	
+
+	@SuppressWarnings("unchecked")
+	@Override
+	public void bind(Class<? extends IDhApiEvent> abstractEvent, IDhApiEvent eventImplementation) throws IllegalStateException, IllegalArgumentException
+	{
+		// is this a one time event?
+		if (ApiEventDefinitionHandler.INSTANCE.getEventDefinition(abstractEvent).isOneTimeEvent)
+		{
+			// has this one time event been fired yet?
+			if (this.firedOneTimeEventParamsByEventInterface.containsKey(abstractEvent))
+			{
+				// the one time event has happened, fire the handler
+				
+				// this has to be an unsafe cast since the hash map can't hold the generic objects
+				Object parameter = this.firedOneTimeEventParamsByEventInterface.get(abstractEvent);
+				eventImplementation.fireEvent(parameter);
+			}
+		}
+		
+		// bind the event handler
+		super.bind(abstractEvent, eventImplementation);
+	}
+	
+	@Override
+	public boolean unbind(Class<? extends IDhApiEvent> abstractEvent, Class<? extends IDhApiEvent> eventClassToRemove) throws IllegalArgumentException
+	{
+		// make sure the given dependency implements the necessary interfaces
+		boolean implementsInterface = this.checkIfClassImplements(eventClassToRemove, abstractEvent) ||
+									  this.checkIfClassExtends(eventClassToRemove, abstractEvent);
+		boolean implementsBindable = this.checkIfClassImplements(eventClassToRemove, this.bindableInterface);
+		
+		// display any errors
+		if (!implementsInterface)
+		{
+			throw new IllegalArgumentException("The event handler [" + eventClassToRemove.getSimpleName() + "] doesn't implement or extend: [" + abstractEvent.getSimpleName() + "].");
+		}
+		if (!implementsBindable)
+		{
+			throw new IllegalArgumentException("The event handler [" + eventClassToRemove.getSimpleName() + "] doesn't implement the interface: [" + IBindable.class.getSimpleName() + "].");
+		}
+		
+		
+		// actually remove the dependency
+		if (this.dependencies.containsKey(abstractEvent))
+		{
+			ArrayList<IDhApiEvent> dependencyList = this.dependencies.get(abstractEvent);
+			int indexToRemove = -1;
+			for(int i = 0; i < dependencyList.size(); i++)
+			{
+				IBindable dependency = dependencyList.get(i);
+				if (dependency.getClass().equals(eventClassToRemove))
+				{
+					indexToRemove = i;
+					break;
+				}
+			}
+			
+			if (indexToRemove != -1)
+			{
+				return dependencyList.remove(indexToRemove) != null;
+			}
+		}
+		
+		// no item was removed
+		return false;
+	}
+	
+	@Override
+	public <T, U extends IDhApiEvent<T>> boolean fireAllEvents(Class<U> abstractEvent, T eventParameterObject)
+	{
+		boolean cancelEvent = false;
+		
+		// if this is a one time event, record that it was called
+		if (ApiEventDefinitionHandler.INSTANCE.getEventDefinition(abstractEvent).isOneTimeEvent && 
+			!this.firedOneTimeEventParamsByEventInterface.containsKey(abstractEvent))
+		{
+			this.firedOneTimeEventParamsByEventInterface.put(abstractEvent, eventParameterObject);
+		}
+		
+		
+		
+		
+		// fire each bound event
+		ArrayList<U> eventList = this.getAll(abstractEvent);
+		for (IDhApiEvent<T> event : eventList)
+		{
+			if (event != null)
+			{
+				try
+				{
+					// fire each event and record if any of them
+					// request to cancel the event.
+					cancelEvent |= event.fireEvent(eventParameterObject);
+				}
+				catch (Exception e)
+				{
+					LOGGER.error("Exception thrown by event handler [" + event.getClass().getSimpleName() + "] for event type [" + abstractEvent.getSimpleName() + "], error:" + e.getMessage(), e);
+				}
+			}
+		}
+		
+		return cancelEvent;
+	}
+	
+}

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

@@ -0,0 +1,205 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.coreapi.DependencyInjection;
+
+import com.seibel.lod.coreapi.interfaces.dependencyInjection.IBindable;
+import com.seibel.lod.coreapi.interfaces.dependencyInjection.IDependencyInjector;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * This class takes care of tracking objects used in dependency injection.
+ *
+ * @param <BindableType> extends IBindable and defines what interfaces this dependency handler can deal with.
+ * @author James Seibel
+ * @version 2022-11-24
+ */
+public class DependencyInjector<BindableType extends IBindable> implements IDependencyInjector<BindableType> // Note to self: Don't try adding a generic type to IDhApiEvent, the constructor won't accept it
+{
+	protected final Map<Class<? extends BindableType>, ArrayList<BindableType>> dependencies = new HashMap<>();
+	
+	/** Internal class reference to BindableType since we can't get it any other way. */
+	protected final Class<? extends BindableType> bindableInterface;
+	
+	protected final boolean allowDuplicateBindings;
+	
+	
+	public DependencyInjector(Class<BindableType> newBindableInterface)
+	{
+		this.bindableInterface = newBindableInterface;
+		this.allowDuplicateBindings = false;
+	}
+	
+	public DependencyInjector(Class<BindableType> newBindableInterface, boolean newAllowDuplicateBindings)
+	{
+		this.bindableInterface = newBindableInterface;
+		this.allowDuplicateBindings = newAllowDuplicateBindings;
+	}
+	
+	
+	
+	
+	@Override
+	public void bind(Class<? extends BindableType> dependencyInterface, BindableType dependencyImplementation) throws IllegalStateException, IllegalArgumentException
+	{
+		// duplicate check if requested
+		if (this.dependencies.containsKey(dependencyInterface) && !this.allowDuplicateBindings)
+		{
+			throw new IllegalStateException("The dependency [" + dependencyInterface.getSimpleName() + "] has already been bound.");
+		}
+		
+		
+		// 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>());
+		}
+		
+		// add the dependency
+		this.dependencies.get(dependencyInterface).add(dependencyImplementation);
+	}
+	@Override
+	public boolean checkIfClassImplements(Class<?> classToTest, Class<?> interfaceToLookFor)
+	{
+		// check the parent class (if applicable)
+		if (classToTest.getSuperclass() != Object.class && classToTest.getSuperclass() != null)
+		{
+			if (this.checkIfClassImplements(classToTest.getSuperclass(), interfaceToLookFor))
+			{
+				return true;
+			}
+		}
+		
+		
+		// check interfaces
+		for (Class<?> implementationInterface : classToTest.getInterfaces())
+		{
+			// recurse to check interface parents if necessary
+			if (implementationInterface.getInterfaces().length != 0)
+			{
+				if (this.checkIfClassImplements(implementationInterface, interfaceToLookFor))
+				{
+					return true;
+				}
+			}
+			
+			if (implementationInterface.equals(interfaceToLookFor))
+			{
+				return true;
+			}
+		}
+		
+		return false;
+	}
+	@Override
+	public boolean checkIfClassExtends(Class<?> classToTest, Class<?> extensionToLookFor) { return extensionToLookFor.isAssignableFrom(classToTest); }
+	
+	
+	@SuppressWarnings("unchecked")
+	@Override
+	public <T extends BindableType> T get(Class<T> interfaceClass) throws ClassCastException
+	{
+		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);
+	}
+	
+	@Override
+	public <T extends BindableType> T get(Class<T> interfaceClass, boolean allowIncompleteDependencies) throws ClassCastException
+	{
+		return (T) this.getInternalLogic(interfaceClass, allowIncompleteDependencies).get(0);
+	}
+	
+	/**
+	 * Always returns a list of size 1 or greater,
+	 * if no dependencies have been bound the list will contain null.
+	 */
+	@SuppressWarnings("unchecked")
+	private <T extends BindableType> ArrayList<T> getInternalLogic(Class<T> interfaceClass, boolean allowIncompleteDependencies) throws ClassCastException
+	{
+		ArrayList<BindableType> dependencyList = this.dependencies.get(interfaceClass);
+		if (dependencyList != null && dependencyList.size() != 0)
+		{
+			// check if each dependencies' delayed setup has been completed
+			for (IBindable dependency : dependencyList)
+			{
+				if (!dependency.getDelayedSetupComplete() && !allowIncompleteDependencies)
+				{
+					// a warning can be used here instead if desired
+					//this.logger.warn("Got dependency of type [" + interfaceClass.getSimpleName() + "], but the dependency's delayed setup hasn't been run!");
+					throw new IllegalStateException("Got dependency of type [" + interfaceClass.getSimpleName() + "], but the dependency's delayed setup hasn't been run!");
+				}
+			}
+			
+			return (ArrayList<T>) dependencyList;
+		}
+		
+		
+		// return an empty list to prevent null pointers
+		ArrayList<T> emptyList = new ArrayList<T>();
+		emptyList.add(null);
+		return emptyList;
+	}
+	
+	
+	
+	/** Removes all bound dependencies. */
+	@Override
+	public void clear() { this.dependencies.clear(); }
+	
+	
+	
+	/** Runs delayed setup for any dependencies that require it. */
+	@Override
+	public void runDelayedSetup()
+	{
+		for (Class<? extends BindableType> interfaceKey : this.dependencies.keySet())
+		{
+			IBindable concreteObject = this.get(interfaceKey, true);
+			if (!concreteObject.getDelayedSetupComplete())
+			{
+				concreteObject.finishDelayedSetup();
+			}
+		}
+	}
+	
+}

api/src/main/java/com/seibel/lod/coreapi/DependencyInjection/OverrideInjector.java

@@ -0,0 +1,132 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.coreapi.DependencyInjection;
+
+import com.seibel.lod.api.interfaces.override.IDhApiOverrideable;
+import com.seibel.lod.coreapi.interfaces.dependencyInjection.IOverrideInjector;
+import com.seibel.lod.coreapi.util.StringUtil;
+
+import java.util.HashMap;
+
+/**
+ * This class takes care of dependency injection for overridable objects. <Br>
+ * This is done so other mods can override our methods to improve features down the line.
+ *
+ * @author James Seibel
+ * @version 2022-9-8
+ */
+public class OverrideInjector implements IOverrideInjector<IDhApiOverrideable>
+{
+	public static final OverrideInjector INSTANCE = new OverrideInjector();
+
+	private final HashMap<Class<? extends IDhApiOverrideable>, OverridePriorityListContainer> overrideContainerByInterface = new HashMap<>();
+	
+	
+	/**
+	 * This is used to determine if an override is part of Distant Horizons'
+	 * Core or not.
+	 * This probably isn't the best way of going about this, but it works for now.
+	 */
+	private final String corePackagePath;
+	
+	
+	
+	public OverrideInjector()
+	{
+		String thisPackageName = this.getClass().getPackage().getName();
+		int secondPackageEndingIndex = StringUtil.nthIndexOf(thisPackageName, ".", 3);
+		
+		this.corePackagePath = thisPackageName.substring(0, secondPackageEndingIndex); // this should be "com.seibel.lod"
+	}
+	
+	public OverrideInjector(String newCorePackagePath) { this.corePackagePath = newCorePackagePath; }
+	
+	
+	
+	@Override
+	public void bind(Class<? extends IDhApiOverrideable> dependencyInterface, IDhApiOverrideable dependencyImplementation)  throws IllegalStateException, IllegalArgumentException
+	{
+		// make sure a override container exists
+		OverridePriorityListContainer overrideContainer = this.overrideContainerByInterface.get(dependencyInterface);
+		if (overrideContainer == null)
+		{
+			overrideContainer = new OverridePriorityListContainer();
+			this.overrideContainerByInterface.put(dependencyInterface, overrideContainer);
+		}
+		
+		
+		// validate the new override //
+		
+		// check if this override is a core override
+		if (dependencyImplementation.getPriority() == CORE_PRIORITY)
+		{
+			// this claims to be a core override, is that true?
+			String packageName = dependencyImplementation.getClass().getPackage().getName();
+			if (!packageName.startsWith(this.corePackagePath))
+			{
+				throw new IllegalArgumentException("Only Distant Horizons internal objects can use the Override Priority [" + CORE_PRIORITY + "]. Please use a higher number.");
+			}
+		}
+		
+		// make sure the override has a valid priority
+		else if (dependencyImplementation.getPriority() < MIN_NON_CORE_OVERRIDE_PRIORITY)
+		{
+			throw new IllegalArgumentException("Invalid priority value [" + dependencyImplementation.getPriority() + "], override priorities must be [" + MIN_NON_CORE_OVERRIDE_PRIORITY + "] or greater.");
+		}
+		
+		// check if an override already exists with this priority
+		IDhApiOverrideable existingOverride = overrideContainer.getOverrideWithPriority(dependencyImplementation.getPriority());
+		if (existingOverride != null)
+		{
+			throw new IllegalStateException("An override already exists with the priority [" + dependencyImplementation.getPriority() + "].");
+		}
+		
+		
+		// bind the override
+		overrideContainer.addOverride(dependencyImplementation);
+	}
+	
+	@Override
+	@SuppressWarnings("unchecked")
+	public <T extends IDhApiOverrideable> T get(Class<T> interfaceClass) throws ClassCastException
+	{
+		OverridePriorityListContainer overrideContainer = this.overrideContainerByInterface.get(interfaceClass);
+		return overrideContainer != null ? (T) overrideContainer.getOverrideWithHighestPriority() : null;
+	}
+	
+	@Override
+	@SuppressWarnings("unchecked")
+	public <T extends IDhApiOverrideable> T get(Class<T> interfaceClass, int priority) throws ClassCastException
+	{
+		OverridePriorityListContainer overrideContainer = this.overrideContainerByInterface.get(interfaceClass);
+		return overrideContainer != null ? (T) overrideContainer.getOverrideWithPriority(priority) : null;
+	}
+	
+	
+	
+	@Override
+	public void clear() { this.overrideContainerByInterface.clear(); }
+	
+	
+	
+	
+	
+	
+}

api/src/main/java/com/seibel/lod/coreapi/DependencyInjection/OverridePriorityListContainer.java

@@ -0,0 +1,116 @@
+package com.seibel.lod.coreapi.DependencyInjection;
+
+import com.seibel.lod.api.interfaces.override.IDhApiOverrideable;
+import com.seibel.lod.coreapi.interfaces.dependencyInjection.IBindable;
+
+import java.util.ArrayList;
+
+/**
+ * Contains a list of overrides and their priorities.
+ * 
+ * @author James Seibel 
+ * @version 2022-9-5
+ */
+public class OverridePriorityListContainer implements IBindable
+{
+	/** Sorted highest priority to lowest */
+	private final ArrayList<OverridePriorityPair> overridePairList = new ArrayList<>();
+	
+	
+	/** Doesn't do any validation */
+	public void addOverride(IDhApiOverrideable override)
+	{
+		OverridePriorityPair priorityPair = new OverridePriorityPair(override, override.getPriority());
+		this.overridePairList.add(priorityPair);
+		
+		sortList();
+	}
+	
+	/** @return true if the override was removed from the list, false otherwise. */
+	public boolean removeOverride(IDhApiOverrideable override)
+	{
+		if (this.overridePairList.contains(override))
+		{
+			this.overridePairList.remove(override);
+			sortList();
+			
+			return true;
+		}
+		else
+		{
+			return false;
+		}
+	}
+	
+	
+	// getters //
+	
+	public IDhApiOverrideable getOverrideWithLowestPriority()
+	{
+		if (this.overridePairList.size() == 0)
+		{
+			return null;
+		}
+		else
+		{
+			// last item should have the highest priority
+			return this.overridePairList.get(this.overridePairList.size() - 1).override;
+		}
+	}
+	public IDhApiOverrideable getOverrideWithHighestPriority()
+	{
+		if (this.overridePairList.size() != 0)
+		{
+			return this.overridePairList.get(0).override;
+		}
+		else
+		{
+			return null;
+		}
+	}
+	public IDhApiOverrideable getCoreOverride()
+	{
+		int lastIndex = this.overridePairList.size() - 1;
+		if (this.overridePairList.get(lastIndex) != null && this.overridePairList.get(lastIndex).priority == OverrideInjector.CORE_PRIORITY)
+		{
+			return this.overridePairList.get(lastIndex).override;
+		}
+		else
+		{
+			return null;
+		}
+	}
+	/** Returns null if no override with the given priority is found */
+	public IDhApiOverrideable getOverrideWithPriority(int priority)
+	{
+		for (OverridePriorityPair pair : this.overridePairList)
+		{
+			if (pair.priority == priority)
+			{
+				return pair.override;
+			}
+		}
+		
+		return null;
+	}
+	
+	
+	// utils //
+	
+	/** sort the list so the highest priority item is first in the list */
+	private void sortList() { this.overridePairList.sort((x,y) -> Integer.compare(y.priority, x.priority)); }
+	
+	
+	
+	private class OverridePriorityPair
+	{
+		public final IDhApiOverrideable override;
+		public int priority;
+		
+		public OverridePriorityPair(IDhApiOverrideable newOverride, int newPriority)
+		{
+			this.override = newOverride;
+			this.priority = newPriority;
+		}
+	}
+}

api/src/main/java/com/seibel/lod/coreapi/DependencyInjection/WorldGeneratorInjector.java

@@ -0,0 +1,124 @@
+/*
+ *    This file is part of the Distant Horizons mod (formerly the LOD Mod),
+ *    licensed under the GNU LGPL v3 License.
+ *
+ *    Copyright (C) 2020-2022  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.lod.coreapi.DependencyInjection;
+
+import com.seibel.lod.api.interfaces.override.worldGenerator.IDhApiWorldGenerator;
+import com.seibel.lod.api.interfaces.world.IDhApiLevelWrapper;
+import com.seibel.lod.coreapi.interfaces.dependencyInjection.IBindable;
+import com.seibel.lod.coreapi.util.StringUtil;
+
+import java.util.HashMap;
+
+/**
+ * This class takes care of dependency injection for world generators. <Br>
+ * This is done so other mods can override our world generator(s) to improve or replace them.
+ * @author James Seibel
+ * @version 2022-12-10
+ */
+public class WorldGeneratorInjector
+{
+	public static final WorldGeneratorInjector INSTANCE = new WorldGeneratorInjector();
+	
+	private final HashMap<IDhApiLevelWrapper, OverrideInjector> worldGeneratorByLevelWrapper = new HashMap<>();
+	
+	/**
+	 * This is used to determine if an override is part of Distant Horizons'
+	 * Core or not.
+	 * This probably isn't the best way of going about this, but it works for now.
+	 */
+	private final String corePackagePath;
+	
+	
+	
+	public WorldGeneratorInjector()
+	{
+		String thisPackageName = this.getClass().getPackage().getName();
+		int secondPackageEndingIndex = StringUtil.nthIndexOf(thisPackageName, ".", 3);
+		this.corePackagePath = thisPackageName.substring(0, secondPackageEndingIndex); // this should be "com.seibel.lod"
+	}
+	
+	/** This constructor should only be used for testing different corePackagePaths. */
+	public WorldGeneratorInjector(String newCorePackagePath)
+	{
+		this.corePackagePath = newCorePackagePath;
+	}
+	
+	
+	
+	/**
+	 * Binds a world generator to the given level. <Br>
+	 * See {@link DependencyInjector#bind(Class, IBindable) bind(Class, IBindable)} for full documentation.
+	 * 
+	 * @throws NullPointerException if any parameter is null
+	 * @throws IllegalArgumentException if a non-Distant Horizons world generator with the priority CORE is passed in
+	 * 
+	 * @see DependencyInjector#bind(Class, IBindable)
+	 */
+	public void bind(IDhApiLevelWrapper levelForWorldGenerator, IDhApiWorldGenerator worldGeneratorImplementation) throws NullPointerException, IllegalArgumentException
+	{
+		// validate inputs
+		if (levelForWorldGenerator == null)
+		{
+			throw new NullPointerException("A [" + IDhApiLevelWrapper.class.getSimpleName() + "] is required when binding a world generator.");
+		}
+		
+		if (worldGeneratorImplementation == null)
+		{
+			throw new NullPointerException("No [" + IDhApiWorldGenerator.class.getSimpleName() + "] given.");
+		}
+		
+		
+		// bind this generator to the given level
+		if (!this.worldGeneratorByLevelWrapper.containsKey(levelForWorldGenerator))
+		{
+			this.worldGeneratorByLevelWrapper.put(levelForWorldGenerator, new OverrideInjector(this.corePackagePath));
+		}
+		this.worldGeneratorByLevelWrapper.get(levelForWorldGenerator).bind(IDhApiWorldGenerator.class, worldGeneratorImplementation);
+	}
+	
+	
+	
+	/**
+	 * Returns the bound world generator with the highest priority. <br>
+	 * Returns null if no world generators have been bound for this specific level. <br><br>
+	 * 
+	 * See {@link OverrideInjector#get(Class) get(Class)} for full documentation.
+	 * @see OverrideInjector#get(Class)
+	 */
+	public IDhApiWorldGenerator get(IDhApiLevelWrapper levelForWorldGenerator) throws ClassCastException
+	{
+		if (!this.worldGeneratorByLevelWrapper.containsKey(levelForWorldGenerator))
+		{
+			// no generator exists for this specific level.
+			return null;
+		}
+		
+		// use the existing world generator
+		return this.worldGeneratorByLevelWrapper.get(levelForWorldGenerator).get(IDhApiWorldGenerator.class);
+	}
+	
+	
+	
+	/** Removes all bound world generators. */
+	public void clear() { this.worldGeneratorByLevelWrapper.clear(); }
+	
+	
+	
+}