Add Javadoc "since API 1.0.0" to API methods and objects

2023-08-16 07:42:12 -05:00
parent 468c8b134c
commit 7aa432951c
75 changed files with 145 additions and 28 deletions
@@ -28,6 +28,7 @@ import com.seibel.distanthorizons.coreapi.interfaces.dependencyInjection.IOverri
 *
 * @author James Seibel
 * @version 2023-6-29
+ * @since API 1.0.0
 */
 public class DhApi
 {
@@ -38,25 +39,35 @@ public class DhApi
 	 * Bind a custom {@link DhApiAfterDhInitEvent DhApiAfterDhInitEvent}
 	 * to {@link DhApi#events ApiCoreInjectors.events} in order to be notified when this class can
 	 * be safely used.
+	 *
+	 * @since API 1.0.0
 	 */
 	public static class Delayed
 	{
-		/** Used to interact with Distant Horizons' Configs. */
+		/** 
+		 * Used to interact with Distant Horizons' Configs.
+		 * @since API 1.0.0 
+		 */
 		public static IDhApiConfig configs = null;
 		
 		/**
 		 * Used to interact with Distant Horizons' terrain data.
 		 * Designed to be used in conjunction with {@link DhApi.Delayed#worldProxy}.
+		 * @since API 1.0.0
 		 */
 		public static IDhApiTerrainDataRepo terrainRepo = null;
 		
 		/**
 		 * Used to interact with Distant Horizons' currently loaded world.
 		 * Designed to be used in conjunction with {@link DhApi.Delayed#terrainRepo}.
+		 * @since API 1.0.0
 		 */
 		public static IDhApiWorldProxy worldProxy = null;
 		
-		/** Used to interact with Distant Horizons' rendering system. */
+		/** 
+		 * Used to interact with Distant Horizons' rendering system.
+		 * @since API 1.0.0
+		 */
 		public static IDhApiRenderProxy renderProxy = null;
 		
 	}
@@ -64,33 +75,58 @@ public class DhApi
 	
 	// always available //
 	
-	/** Used to bind/unbind Distant Horizons Api events. */
+	/** 
+	 * Used to bind/unbind Distant Horizons Api events. 
+	 * @since API 1.0.0 
+	 */
 	public static final IDhApiEventInjector events = ApiEventInjector.INSTANCE;
 	
-	/** Used to bind/unbind Distant Horizons Api events. */
+	/** 
+	 * Used to bind/unbind Distant Horizons Api events. 
+	 * @since API 1.0.0 
+	 */
 	public static final IDhApiWorldGeneratorOverrideRegister worldGenOverrides = DhApiWorldGeneratorOverrideRegister.INSTANCE;
 	
-	/** Used to bind overrides to change Distant Horizons' core behavior. */
+	/** 
+	 * Used to bind overrides to change Distant Horizons' core behavior. 
+	 * @since API 1.0.0 
+	 */
 	public static final IOverrideInjector<IDhApiOverrideable> overrides = OverrideInjector.INSTANCE;
 	
 	
-	/** This version should only be updated when breaking changes are introduced to the Distant Horizons API. */
+	/** 
+	 * This version should only be updated when breaking changes are introduced to the Distant Horizons API.
+	 * @since API 1.0.0
+	 */
 	public static int getApiMajorVersion() { return ModInfo.API_MAJOR_VERSION; }
-	/** This version should be updated whenever new methods are added to the Distant Horizons API. */
+	/** 
+	 * This version should be updated whenever new methods are added to the Distant Horizons API. 
+	 * @since API 1.0.0 
+	 */
 	public static int getApiMinorVersion() { return ModInfo.API_MINOR_VERSION; }
-	/** This version should be updated whenever non-breaking fixes are added to the Distant Horizons API. */
+	/** 
+	 * This version should be updated whenever non-breaking fixes are added to the Distant Horizons API. 
+	 * @since API 1.0.0 
+	 */
 	public static int getApiPatchVersion() { return ModInfo.API_PATH_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"
+	 * @since API 1.0.0
 	 */
 	public static String getModVersion() { return ModInfo.VERSION; }
-	/** Returns true if the mod is a development version, false if it is a release version. */
+	/** 
+	 * Returns true if the mod is a development version, false if it is a release version. 
+	 * @since API 1.0.0 
+	 */
 	public static boolean getIsDevVersion() { return ModInfo.IS_DEV_BUILD; }
 	
-	/** Returns the network protocol version. */
+	/** 
+	 * Returns the network protocol version. 
+	 * @since API 1.0.0 
+	 */
 	public static int getNetworkProtocolVersion() { return ModInfo.PROTOCOL_VERSION; }
 	
 }
@@ -16,6 +16,7 @@ package com.seibel.distanthorizons.api.enums;
 *
 * @author James Seibel
 * @version 2022-12-5
+ * @since API 1.0.0
 */
 public enum EDhApiDetailLevel
 {
@@ -22,6 +22,8 @@ package com.seibel.distanthorizons.api.enums.config;
 /**
 * NONE, <br>
 * NON_COLLIDING, <br>
+ *
+ * @since API 1.0.0
 */
 public enum EBlocksToAvoid
 {
@@ -29,6 +29,7 @@ package com.seibel.distanthorizons.api.enums.config;
 * @author Leetom
 * @author James Seibel
 * @version 2022-7-2
+ * @since API 1.0.0
 */
 public enum EGpuUploadMethod
 {
@@ -25,6 +25,8 @@ package com.seibel.distanthorizons.api.enums.config;
 * MEDIUM <br>
 * HIGH <br>
 * UNLIMITED <br>
+ *
+ * @since API 1.0.0
 */
 public enum EHorizontalQuality
 {
@@ -25,6 +25,7 @@ package com.seibel.distanthorizons.api.enums.config;
 *
 * @author Leetom
 * @version 2023-6-7
+ * @since API 1.0.0
 */
 public enum ELightGenerationMode
 {
@@ -23,6 +23,8 @@ package com.seibel.distanthorizons.api.enums.config;
 * MINECRAFT <br>
 * OLD_LIGHTING <br>
 * NONE <br>
+ *
+ * @since API 1.0.0
 */
 public enum ELodShading
 {
@@ -21,6 +21,9 @@ package com.seibel.distanthorizons.api.enums.config;

 import org.apache.logging.log4j.Level;

+/**
+ * @since API 1.0.0
+ */
 public enum ELoggerMode
 {
 	DISABLED(Level.OFF, Level.OFF),
@@ -34,6 +34,7 @@ import com.seibel.distanthorizons.coreapi.util.MathUtil;
 * @author James Seibel
 * @author Leonardo Amato
 * @version 2023-6-14
+ * @since API 1.0.0
 */
 public enum EMaxHorizontalResolution
 {
@@ -23,7 +23,9 @@ package com.seibel.distanthorizons.api.enums.config;
 * NONE <br>
 * LIGHT <br>
 * MEDIUM <br>
- * HEAVY <br> <br>
+ * HEAVY <br>
+ *
+ * @since API 1.0.0
 */
 public enum EOverdrawPrevention
 {
@@ -30,6 +30,7 @@ package com.seibel.distanthorizons.api.enums.config;
 *
 * @author James Seibel
 * @version 2022-7-1
+ * @since API 1.0.0
 */
 public enum EServerFolderNameMode
 {
@@ -30,6 +30,7 @@ import com.seibel.distanthorizons.coreapi.util.MathUtil;
 *
 * @author Leonardo Amato
 * @version 2023-2-5
+ * @since API 1.0.0
 */
 public enum EVerticalQuality
 {
@@ -29,6 +29,8 @@ import com.seibel.distanthorizons.api.enums.config.DisallowSelectingViaConfigGui
 * MEDIUM, <br>
 * HIGH, <br>
 * EXTREME, <br>
+ * 
+ * @since API 1.0.0
 */
 public enum EQualityPreset
 {
@@ -28,7 +28,8 @@ import com.seibel.distanthorizons.api.enums.config.DisallowSelectingViaConfigGui
 * LOW_IMPACT, <br>
 * BALANCED, <br>
 * AGGRESSIVE, <br>
- * I_PAID_FOR_THE_WHOLE_CPU, <br>
+ * 
+ * @since API 1.0.0
 */
 public enum EThreadPreset
 {
@@ -29,6 +29,7 @@ package com.seibel.distanthorizons.api.enums.rendering;
 * @author Leetom
 * @author James Seibel
 * @version 2023-6-7
+ * @since API 1.0.0
 */
 public enum EDebugRendering
 {
@@ -25,6 +25,7 @@ package com.seibel.distanthorizons.api.enums.rendering;
 *
 * @author James Seibel
 * @version 2022-6-9
+ * @since API 1.0.0
 */
 public enum EFogColorMode
 {
@@ -20,10 +20,13 @@
 package com.seibel.distanthorizons.api.enums.rendering;

 /**
- * NEAR, FAR, or NEAR_AND_FAR.
+ * NEAR, <br> 
+ * FAR, <br> 
+ * NEAR_AND_FAR <br>
 *
 * @author James Seibel
 * @version 2022-6-2
+ * @since API 1.0.0
 */
 public enum EFogDistance
 {
@@ -26,6 +26,7 @@ package com.seibel.distanthorizons.api.enums.rendering;
 *
 * @author James Seibel
 * @version 2022-6-2
+ * @since API 1.0.0
 */
 public enum EFogDrawMode
 {
@@ -7,6 +7,7 @@ package com.seibel.distanthorizons.api.enums.rendering;
 *
 * @author Leetom
 * @version 2022-6-30
+ * @since API 1.0.0
 */
 public enum EFogFalloff
 {
@@ -33,6 +33,7 @@ package com.seibel.distanthorizons.api.enums.rendering;
 *
 * @author Leetom
 * @version 2022-4-14
+ * @since API 1.0.0
 */
 public enum EHeightFogMixMode
 {
@@ -29,6 +29,7 @@ package com.seibel.distanthorizons.api.enums.rendering;
 *
 * @author Leetom
 * @version 6-30-2022
+ * @since API 1.0.0
 */
 public enum EHeightFogMode
 {
@@ -20,11 +20,12 @@
 package com.seibel.distanthorizons.api.enums.rendering;

 /**
- * Default
- * Debug
- * Disabled
+ * Default <br>
+ * Debug <br>
+ * Disabled <br>
 *
 * @version 2022-6-2
+ * @since API 1.0.0
 */
 public enum ERendererMode
 {
@@ -23,6 +23,8 @@ package com.seibel.distanthorizons.api.enums.rendering;
 * DISABLED,					<br>
 * FAKE,						<br>
 * COMPLETE,					<br>
+ * 
+ * @since API 1.0.0
 */
 public enum ETransparency
 {
@@ -32,6 +32,7 @@ package com.seibel.distanthorizons.api.enums.worldGeneration;
 * @author James Seibel
 * @author Leonardo Amato
 * @version 2022-12-10
+ * @since API 1.0.0
 */
 public enum EDhApiDistantGeneratorMode
 {
@@ -7,6 +7,7 @@ package com.seibel.distanthorizons.api.enums.worldGeneration;
 *
 * @author James Seibel
 * @version 2022-7-13
+ * @since API 1.0.0
 */
 public enum EDhApiLevelType
 {
@@ -14,6 +14,7 @@ package com.seibel.distanthorizons.api.enums.worldGeneration;
 *
 * @author James Seibel
 * @version 2023-4-20
+ * @since API 1.0.0
 */
 public enum EDhApiWorldGenerationStep
 {
@@ -6,6 +6,7 @@ package com.seibel.distanthorizons.api.interfaces;
 *
 * @author James Seibel
 * @version 2023-6-17
+ * @since API 1.0.0
 */
 public interface IDhApiUnsafeWrapper
 {
@@ -26,6 +26,7 @@ import com.seibel.distanthorizons.api.interfaces.IDhApiUnsafeWrapper;
 *
 * @author James Seibel
 * @version 3-5-2022
+ * @since API 1.0.0
 */
 public interface IDhApiBiomeWrapper extends IDhApiUnsafeWrapper
 {
@@ -7,6 +7,7 @@ import com.seibel.distanthorizons.api.interfaces.IDhApiUnsafeWrapper;
 *
 * @author James Seibel
 * @version 2023-6-11
+ * @since API 1.0.0
 */
 public interface IDhApiBlockStateWrapper extends IDhApiUnsafeWrapper
 {
@@ -9,6 +9,7 @@ import com.seibel.distanthorizons.api.interfaces.config.client.*;
 *
 * @author James Seibel
 * @version 2023-6-14
+ * @since API 1.0.0
 */
 public interface IDhApiConfig
 {
@@ -8,6 +8,7 @@ import com.seibel.distanthorizons.coreapi.interfaces.dependencyInjection.IBindab
 *
 * @author James Seibel
 * @version 9-15-2022
+ * @since API 1.0.0
 */
 public interface IDhApiConfigGroup extends IBindable
 {
@@ -6,6 +6,7 @@ package com.seibel.distanthorizons.api.interfaces.config;
 * @param <T> The data type of this config.
 * @author James Seibel
 * @version 2022-9-15
+ * @since API 1.0.0
 */
 public interface IDhApiConfigValue<T>
 {
@@ -31,6 +31,7 @@ import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigGroup;
 *
 * @author James Seibel
 * @version 2022-9-15
+ * @since API 1.0.0
 */
 public interface IDhApiWorldGenerationConfig extends IDhApiConfigGroup
 {
@@ -28,6 +28,7 @@ import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigGroup;
 *
 * @author James Seibel
 * @version 2022-9-15
+ * @since API 1.0.0
 */
 public interface IDhApiDebuggingConfig extends IDhApiConfigGroup
 {
@@ -33,6 +33,7 @@ import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigValue;
 *
 * @author James Seibel
 * @version 2022-6-14
+ * @since API 1.0.0
 */
 public interface IDhApiFarFogConfig extends IDhApiConfigGroup
 {
@@ -35,6 +35,7 @@ import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigValue;
 *
 * @author James Seibel
 * @version 2022-6-14
+ * @since API 1.0.0
 */
 public interface IDhApiFogConfig extends IDhApiConfigGroup
 {
@@ -28,6 +28,7 @@ import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigValue;
 *
 * @author James Seibel
 * @version 2023-6-14
+ * @since API 1.0.0
 */
 public interface IDhApiGpuBuffersConfig extends IDhApiConfigGroup
 {
@@ -31,6 +31,7 @@ import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigGroup;
 *
 * @author James Seibel
 * @version 2023-6-14
+ * @since API 1.0.0
 */
 public interface IDhApiGraphicsConfig extends IDhApiConfigGroup
 {
@@ -34,6 +34,7 @@ import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigValue;
 *
 * @author James Seibel
 * @version 2022-6-14
+ * @since API 1.0.0
 */
 public interface IDhApiHeightFogConfig extends IDhApiConfigGroup
 {
@@ -26,6 +26,7 @@ import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigGroup;
 *
 * @author James Seibel
 * @version 2022-6-14
+ * @since API 1.0.0
 */
 public interface IDhApiLoggingConfig extends IDhApiConfigGroup
 {
@@ -27,6 +27,7 @@ import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigGroup;
 *
 * @author James Seibel
 * @version 2023-6-14
+ * @since API 1.0.0
 */
 public interface IDhApiMultiThreadingConfig extends IDhApiConfigGroup
 {
@@ -28,6 +28,7 @@ import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigGroup;
 *
 * @author James Seibel
 * @version 2023-6-14
+ * @since API 1.0.0
 */
 public interface IDhApiMultiplayerConfig extends IDhApiConfigGroup
 {
@@ -27,6 +27,7 @@ import com.seibel.distanthorizons.api.interfaces.config.IDhApiConfigValue;
 *
 * @author James Seibel
 * @version 2022-6-14
+ * @since API 1.0.0
 */
 public interface IDhApiNoiseTextureConfig extends IDhApiConfigGroup
 {
@@ -12,6 +12,7 @@ import com.seibel.distanthorizons.api.objects.data.DhApiTerrainDataPoint;
 *
 * @author James Seibel
 * @version 2023-6-22
+ * @since API 1.0.0
 */
 public interface IDhApiTerrainDataRepo
 {
@@ -27,6 +27,7 @@ import com.seibel.distanthorizons.coreapi.interfaces.dependencyInjection.IDepend
 *
 * @author James Seibel
 * @version 2022-9-13
+ * @since API 1.0.0
 */
 public interface IDhApiEventInjector extends IDependencyInjector<IDhApiEvent>
 {
@@ -8,6 +8,7 @@ import com.seibel.distanthorizons.coreapi.interfaces.dependencyInjection.IOverri
 *
 * @author James Seibel
 * @version 2022-9-5
+ * @since API 1.0.0
 */
 public interface IDhApiOverrideable extends IBindable
 {
@@ -13,6 +13,7 @@ import java.util.function.Consumer;
 /**
 * @author James Seibel
 * @version 2023-6-22
+ * @since API 1.0.0
 */
 public abstract class AbstractDhApiChunkWorldGenerator implements Closeable, IDhApiOverrideable, IDhApiWorldGenerator
 {
@@ -12,6 +12,7 @@ import java.util.function.Consumer;
 /**
 * @author James Seibel
 * @version 2023-6-22
+ * @since API 1.0.0
 */
 public interface IDhApiWorldGenerator extends Closeable, IDhApiOverrideable
 {
@@ -19,12 +20,6 @@ public interface IDhApiWorldGenerator extends Closeable, IDhApiOverrideable
 	// parameters //
 	//============//
 	
-	/*
-	 * Returns which thread chunk generation requests will be run on. <br>
-	 * TODO: only {@link EDhApiWorldGenThreadMode#MULTI_THREADED} is implemented
-	 */
-	//EDhApiWorldGenThreadMode getThreadingMode();
-	
 	/**
 	 * Defines the smallest datapoint size that can be generated at a time. <br>
 	 * Minimum detail level is 0 (1 block) <br>
@@ -8,6 +8,7 @@ import com.seibel.distanthorizons.api.objects.DhApiResult;
 *
 * @author James Seibel
 * @version 2022-12-10
+ * @since API 1.0.0
 */
 public interface IDhApiWorldGeneratorOverrideRegister
 {
@@ -26,6 +26,7 @@ import com.seibel.distanthorizons.api.objects.DhApiResult;
 *
 * @author James Seibel
 * @version 2023-2-8
+ * @since API 1.0.0
 */
 public interface IDhApiRenderProxy
 {
@@ -24,6 +24,7 @@ import com.seibel.distanthorizons.api.interfaces.IDhApiUnsafeWrapper;
 /**
 * @author James Seibel
 * @version 2022-7-14
+ * @since API 1.0.0
 */
 public interface IDhApiDimensionTypeWrapper extends IDhApiUnsafeWrapper
 {
@@ -28,6 +28,7 @@ import com.seibel.distanthorizons.api.enums.worldGeneration.EDhApiLevelType;
 *
 * @author James Seibel
 * @version 2022-7-14
+ * @since API 1.0.0
 */
 public interface IDhApiLevelWrapper extends IDhApiUnsafeWrapper
 {
@@ -25,6 +25,7 @@ package com.seibel.distanthorizons.api.interfaces.world;
 *
 * @author James Seibel
 * @version 2022-11-20
+ * @since API 1.0.0
 */
 public interface IDhApiWorldProxy
 {
@@ -9,6 +9,7 @@ import com.seibel.distanthorizons.coreapi.DependencyInjection.ApiEventInjector;
 *
 * @author James Seibel
 * @version 2022-9-16
+ * @since API 1.0.0
 */
 public class DhApiEventRegister
 {
@@ -9,6 +9,7 @@ import com.seibel.distanthorizons.api.methods.events.sharedParameterObjects.DhAp
 *
 * @author James Seibel
 * @version 2023-6-23
+ * @since API 1.0.0
 */
 public abstract class DhApiAfterDhInitEvent implements IDhApiEvent<Void>, IDhApiOneTimeEvent<Void>
 {
@@ -12,6 +12,7 @@ import com.seibel.distanthorizons.api.methods.events.sharedParameterObjects.DhAp
 * @author James Seibel
 * @version 2023-6-23
 * @see DhApiRenderParam
+ * @since API 1.0.0
 */
 public abstract class DhApiAfterRenderEvent implements IDhApiEvent<DhApiAfterRenderEvent.EventParam>
 {
@@ -9,6 +9,7 @@ import com.seibel.distanthorizons.api.methods.events.sharedParameterObjects.DhAp
 *
 * @author James Seibel
 * @version 2023-6-23
+ * @since API 1.0.0
 */
 public abstract class DhApiBeforeDhInitEvent implements IDhApiEvent<Void>
 {
@@ -10,6 +10,7 @@ import com.seibel.distanthorizons.api.methods.events.sharedParameterObjects.DhAp
 *
 * @author James Seibel
 * @version 2023-6-23
+ * @since API 1.0.0
 */
 public abstract class DhApiBeforeRenderEvent implements IDhApiCancelableEvent<DhApiBeforeRenderEvent.EventParam>
 {
@@ -14,6 +14,7 @@ import com.seibel.distanthorizons.api.methods.events.sharedParameterObjects.DhAp
 * @author James Seibel
 * @version 2023-6-23
 * @see IDhApiTerrainDataRepo
+ * @since API 1.0.0
 */
 public abstract class DhApiChunkModifiedEvent implements IDhApiEvent<DhApiChunkModifiedEvent.EventParam>
 {
@@ -10,6 +10,7 @@ import com.seibel.distanthorizons.api.methods.events.sharedParameterObjects.DhAp
 *
 * @author James Seibel
 * @version 2023-6-23
+ * @since API 1.0.0
 */
 public abstract class DhApiLevelLoadEvent implements IDhApiEvent<DhApiLevelLoadEvent.EventParam>
 {
@@ -10,6 +10,7 @@ import com.seibel.distanthorizons.api.methods.events.sharedParameterObjects.DhAp
 *
 * @author James Seibel
 * @version 2023-6-23
+ * @since API 1.0.0
 */
 public abstract class DhApiLevelUnloadEvent implements IDhApiEvent<DhApiLevelUnloadEvent.EventParam>
 {
@@ -9,6 +9,7 @@ import com.seibel.distanthorizons.api.methods.events.sharedParameterObjects.DhAp
 *
 * @author James Seibel
 * @version 2023-6-23
+ * @since API 1.0.0
 */
 public interface IDhApiCancelableEvent<T> extends IDhApiEvent<T>
 {
@@ -9,6 +9,7 @@ import com.seibel.distanthorizons.coreapi.interfaces.dependencyInjection.IBindab
 * @param <T> This is the datatype that will be passed into the event handler's method.
 * @author James Seibel
 * @version 2023-6-23
+ * @since API 1.0.0
 */
 public interface IDhApiEvent<T> extends IBindable
 {
@@ -5,6 +5,8 @@ package com.seibel.distanthorizons.api.methods.events.interfaces;
 * 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 to a one time event after the event has been fired, the handler will immediately fire.
+ *
+ * @since API 1.0.0
 */
 public interface IDhApiOneTimeEvent<T> extends IDhApiEvent<T>
 {
@@ -1,6 +1,10 @@
 package com.seibel.distanthorizons.api.methods.events.sharedParameterObjects;

-/** Extension of {@link DhApiEventParam} that allows the event to be canceled. */
+/** 
+ * Extension of {@link DhApiEventParam} that allows the event to be canceled. 
+ * 
+ * @since API 1.0.0
+ */
 public class DhApiCancelableEventParam<T> extends DhApiEventParam<T>
 {
 	public DhApiCancelableEventParam(T value) { super(value); }
@@ -2,7 +2,11 @@ package com.seibel.distanthorizons.api.methods.events.sharedParameterObjects;

 import com.seibel.distanthorizons.api.methods.events.interfaces.IDhApiEvent;

-/** Wraps the event parameter to allow for additional control over the event */
+/** 
+ * Wraps the event parameter to allow for additional control over the event 
+ *
+ * @since API 1.0.0
+ */
 public class DhApiEventParam<T>
 {
 	/** Depending on the {@link IDhApiEvent} this can be null. */
@@ -7,6 +7,7 @@ import com.seibel.distanthorizons.coreapi.util.math.Mat4f;
 *
 * @author James Seibel
 * @version 2022-9-5
+ * @since API 1.0.0
 */
 public class DhApiRenderParam
 {
@@ -11,6 +11,7 @@ import com.seibel.distanthorizons.coreapi.DependencyInjection.WorldGeneratorInje
 *
 * @author James Seibel
 * @version 2022-12-10
+ * @since API 1.0.0
 */
 public class DhApiWorldGeneratorOverrideRegister implements IDhApiWorldGeneratorOverrideRegister
 {
@@ -6,6 +6,7 @@ package com.seibel.distanthorizons.api.objects;
 * @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
+ * @since API 1.0.0
 */
 public class DhApiResult<T>
 {
@@ -16,6 +16,7 @@ import com.seibel.distanthorizons.coreapi.util.converters.DefaultConverter;
 * @param <coreType> The datatype Distant Horizons uses in the background; implementing developers can ignore this.
 * @author James Seibel
 * @version 2022-6-30
+ * @since API 1.0.0
 */
 public class DhApiConfigValue<coreType, apiType> implements IDhApiConfigValue<apiType>
 {
@@ -9,6 +9,7 @@ import com.seibel.distanthorizons.coreapi.util.math.Vec3i;
 *
 * @author James Seibel
 * @version 2022-11-19
+ * @since API 1.0.0
 */
 public class DhApiRaycastResult
 {
@@ -8,6 +8,7 @@ import com.seibel.distanthorizons.api.interfaces.block.IDhApiBlockStateWrapper;
 *
 * @author James Seibel
 * @version 2022-11-13
+ * @since API 1.0.0
 */
 public class DhApiTerrainDataPoint
 {
@@ -25,6 +25,7 @@ package com.seibel.distanthorizons.api.objects.math;
 *
 * @author James Seibel
 * @version 2022-11-19
+ * @since API 1.0.0
 */
 public class DhApiVec3i
 {
@@ -87,10 +87,6 @@ public class BatchGenerator implements IDhApiWorldGenerator
 	// generator parameters //
 	//======================//
 	
-	// TODO implement
-//	@Override 
-//	public EDhApiWorldGenThreadMode getThreadingMode() { return EDhApiWorldGenThreadMode.MULTI_THREADED; }
-	
 	@Override
 	public byte getSmallestDataDetailLevel() { return LodUtil.BLOCK_DETAIL_LEVEL; }
 	@Override
@@ -97,6 +97,8 @@ public class GLState
 	
 	public void restore()
 	{
+		// TODO this can cause issues if any of the values don't exist any more 
+		
 		GL32.glBindFramebuffer(GL32.GL_FRAMEBUFFER, this.fbo);
 		if (this.blend)
 		{