Create pre-release a1.5.1

I made this version so hopefully someone could test if Vivecraft is just ignoring Minecraft's FOV when creating their projection matrices or if they are doing something more complicated.
auto-format
2021-09-28 22:56:17 -05:00 · 2021-09-28 22:18:38 -05:00 · 2021-09-28 21:29:25 -05:00 · 2021-09-28 21:06:15 -05:00 · 2021-09-29 02:38:19 +02:00 · 2021-09-29 02:16:23 +02:00
103 changed files with 12880 additions and 5841 deletions
@@ -22,4 +22,5 @@ eclipse
 run

 # Files from Forge MDK
+logs
 forge*changelog.txt
@@ -1,65 +0,0 @@
-Minecraft Forge: Credits/Thank You
-
-Forge is a set of tools and modifications to the Minecraft base game code to assist 
-mod developers in creating new and exciting content. It has been in development for 
-several years now, but I would like to take this time thank a few people who have 
-helped it along it's way.
-
-First, the people who originally created the Forge projects way back in Minecraft 
-alpha. Eloraam of RedPower, and SpaceToad of Buildcraft, without their acceptiance 
-of me taking over the project, who knows what Minecraft modding would be today.
-
-Secondly, someone who has worked with me, and developed some of the core features
-that allow modding to be as functional, and as simple as it is, cpw. For developing
-FML, which stabelized the client and server modding ecosystem. As well as the base
-loading system that allows us to modify Minecraft's code as elegently as possible.
-
-Mezz, who has stepped up as the issue and pull request manager. Helping to keep me
-sane as well as guiding the community into creating better additions to Forge.
-
-Searge, Bspks, Fesh0r, ProfMobious, and all the rest over on the MCP team {of which 
-I am a part}. For creating some of the core tools needed to make Minecraft modding 
-both possible, and as stable as can be.
-  On that note, here is some specific information of the MCP data we use:
-    * Minecraft Coder Pack (MCP) *
-      Forge Mod Loader and Minecraft Forge have permission to distribute and automatically 
-      download components of MCP and distribute MCP data files. This permission is not 
-      transitive and others wishing to redistribute the Minecraft Forge source independently
-      should seek permission of MCP or remove the MCP data files and request their users 
-      to download MCP separately.
-      
-And lastly, the countless community members who have spent time submitting bug reports, 
-pull requests, and just helping out the community in general. Thank you.
-
--LexManos
-
-=========================================================================
-
-This is Forge Mod Loader.
-
-You can find the source code at all times at https://github.com/MinecraftForge/MinecraftForge/tree/1.12.x/src/main/java/net/minecraftforge/fml
-
-This minecraft mod is a clean open source implementation of a mod loader for minecraft servers
-and minecraft clients.
-
-The code is authored by cpw.
-
-It began by partially implementing an API defined by the client side ModLoader, authored by Risugami.
-http://www.minecraftforum.net/topic/75440-
-This support has been dropped as of Minecraft release 1.7, as Risugami no longer maintains ModLoader.
-
-It also contains suggestions and hints and generous helpings of code from LexManos, author of MinecraftForge.
-http://www.minecraftforge.net/
-
-Additionally, it contains an implementation of topological sort based on that 
-published at http://keithschwarz.com/interesting/code/?dir=topological-sort
-
-It also contains code from the Maven project for performing versioned dependency
-resolution. http://maven.apache.org/
-
-It also contains a partial repackaging of the javaxdelta library from http://sourceforge.net/projects/javaxdelta/
-with credit to it's authors.
-
-Forge Mod Loader downloads components from the Minecraft Coder Pack
-(http://mcp.ocean-labs.de/index.php/Main_Page) with kind permission from the MCP team.
-
@@ -4,17 +4,14 @@ allowing for an increased view distance without harming performance.

 Or in other words: this mod let's you see farther without turning your game into a slide show.
 If you want to see a quick demo, check out the video I made here:
-https://youtu.be/v61iOYZQWCs
+https://youtu.be/CCT-3s02tYA


-Forge version: 1.16.4-35.1.4
+Forge version: 1.16.5-36.1.0

 Notes:
-This version has been confirmed to work in Eclipse and retail Minecraft.
-(retail running forge 1.16.4-35.1.37)
-That being said only singleplayer is currently supported; connecting
-to servers (local or otherwise) will cause no LODs to be drawn and
-may cause instibility.
+This version has been confirmed to work in Eclipse and Retail Minecraft.
+(Retail running forge version 1.16.5-36.1.0)


 ========================
@@ -67,3 +64,7 @@ Note to self

 The Minecraft source code is NOT added to your workspace in a editable way. Minecraft is treated like a normal Library. Sources are there for documentation and research purposes only.

+Source code uses mcp mappings not Mojangs.
+
+The source code can be 'created' with the ./eclipse command and can be found in the following path:
+minecraft-lod-mod\build\fg_cache\mcp\ VERSION \joined\ RANDOM_STRING \patch\output.jar
@@ -0,0 +1,390 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<profiles version="21">
+    <profile kind="CodeFormatterProfile" name="Eclipse (James' Edit)" version="21">
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_ellipsis" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_enum_declarations" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_allocation_expression" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_for_statment" value="common_lines"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.new_lines_at_block_boundaries" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_constructor_declaration_parameters" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.insert_new_line_for_parameter" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_package" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_enum_constant" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_while" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_annotation_type_member_declaration" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.format_javadoc_comments" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.indentation.size" value="4"/>
+        <setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_enum_constant_declaration" value="common_lines"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_semicolon_in_for" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.align_with_spaces" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.continuation_indentation" value="2"/>
+        <setting id="org.eclipse.jdt.core.formatter.number_of_blank_lines_before_code_block" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_switch_case_expressions" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.blank_lines_after_package" value="1"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_multiple_local_declarations" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_arguments_in_enum_constant" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_angle_bracket_in_parameterized_type_reference" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.indent_root_tags" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.wrap_before_or_operator_multicatch" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.enabling_tag" value="@formatter:on"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.count_line_length_from_starting_position" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_record_components" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_throws_clause_in_method_declaration" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_parameter" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.wrap_before_multiplicative_operator" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_then_statement_on_same_line" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_explicitconstructorcall_arguments" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_prefix_operator" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_brace_in_array_initializer" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_angle_bracket_in_type_arguments" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_method" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_parameterized_type_references" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_logical_operator" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_parenthesized_expression" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_annotation_declaration_on_one_line" value="one_line_never"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_record_declaration" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_enum_constant" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_multiplicative_operator" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_and_in_type_parameter" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_method_invocation" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_assignment_operator" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_type_declaration" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_for" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.preserve_white_space_between_code_and_line_comments" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_local_variable" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.blank_lines_before_abstract_method" value="1"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_enum_constant_declaration_on_one_line" value="one_line_never"/>
+        <setting id="org.eclipse.jdt.core.formatter.align_variable_declarations_on_columns" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_method_invocation" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_union_type_in_multicatch" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.number_of_blank_lines_at_beginning_of_method_body" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_else_statement_on_same_line" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_catch_clause" value="common_lines"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_parameterized_type_reference" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_array_initializer" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_annotation" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_arguments_in_explicit_constructor_call" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_multiplicative_operator" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_anonymous_type_declaration_on_one_line" value="one_line_never"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_switch_case_expressions" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.wrap_before_shift_operator" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_annotation_declaration_header" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.brace_position_for_block" value="next_line"/>
+        <setting id="org.eclipse.jdt.core.formatter.number_of_blank_lines_at_end_of_code_block" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_bitwise_operator" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.put_empty_statement_on_new_line" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_parameters_in_constructor_declaration" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_type_parameters" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_compact_loops" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.clear_blank_lines_in_block_comment" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_simple_for_body_on_same_line" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_new_line_at_end_of_file_if_missing" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_array_initializer" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_unary_operator" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.format_line_comment_starting_on_first_column" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_annotation" value="common_lines"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_ellipsis" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_semicolon_in_try_resources" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_colon_in_assert" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_annotations_on_enum_constant" value="49"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_and_in_type_parameter" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_parenthesized_expression" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.text_block_indentation" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.align_type_members_on_columns" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_assignment" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_module_statements" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_type_header" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_method_declaration" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.align_tags_names_descriptions" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_enum_constant" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_if_then_body_block_on_one_line" value="one_line_never"/>
+        <setting id="org.eclipse.jdt.core.formatter.blank_lines_before_first_class_body_declaration" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_new_line_before_closing_brace_in_array_initializer" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_constructor_declaration_parameters" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.format_guardian_clause_on_one_line" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_if" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.align_assignment_statements_on_columns" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.brace_position_for_block_in_case" value="next_line"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_constructor_declaration" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_conditional_expression_chain" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.format_header" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_type_annotations" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_arguments_in_allocation_expression" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.wrap_before_assertion_message_operator" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_switch" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_method_declaration" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.align_fields_grouping_blank_lines" value="2147483647"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.new_lines_at_javadoc_boundaries" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_bitwise_operator" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.brace_position_for_annotation_type_declaration" value="next_line"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_colon_in_for" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_resources_in_try" value="80"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_selector_in_method_invocation" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.never_indent_block_comments_on_first_column" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_synchronized" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_allocation_expression" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.format_source_code" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_array_initializer" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.blank_lines_before_field" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_at_in_annotation" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.blank_lines_before_method" value="1"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_superclass_in_type_declaration" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_parenthesized_expression_in_throw" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_not_operator" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_type_annotation" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_brace_in_array_initializer" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_parenthesized_expression" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.format_html" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_at_in_annotation_type_declaration" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_method_delcaration" value="common_lines"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_compact_if" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.indent_empty_lines" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_type_arguments" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_unary_operator" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_enum_constant" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_arguments_in_annotation" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_enum_declarations" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_annotations_on_package" value="49"/>
+        <setting id="org.eclipse.jdt.core.formatter.indent_switchstatements_compare_to_switch" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_new_line_before_else_in_if_statement" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_assignment_operator" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_label" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_enum_declaration_header" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_colon_in_conditional" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_method_declaration_parameters" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_cast" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_arrow_in_switch_case" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_new_line_before_while_in_do_statement" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_bracket_in_array_type_reference" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_record_header" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_angle_bracket_in_parameterized_type_reference" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_opening_brace_in_array_initializer" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.indent_breaks_compare_to_cases" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_method_declaration" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.wrap_before_bitwise_operator" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_try" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_lambda_arrow" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_method_declaration" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.indent_tag_description" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_imple_if_on_one_line" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.brace_position_for_record_constructor" value="next_line"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_enum_declaration" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_between_brackets_in_array_type_reference" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_angle_bracket_in_type_parameters" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_string_concatenation" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_semicolon_in_for" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_bracket_in_array_allocation_expression" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_multiple_fields" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_enum_constant_arguments" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_prefix_operator" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.brace_position_for_array_initializer" value="end_of_line"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_shift_operator" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_method_declaration" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_type_parameters" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_catch" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_shift_operator" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_braces_in_array_initializer" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_multiple_local_declarations" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_simple_do_while_body_on_same_line" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_annotation_type_declaration" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_record_components" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.wrap_outer_expressions_when_nested" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_closing_paren_in_cast" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_synchronized" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_annotation_type_member_declaration" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_expressions_in_for_loop_header" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.wrap_before_additive_operator" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_simple_getter_setter_on_one_line" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_while" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_angle_bracket_in_type_parameters" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_string_concatenation" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_lambda_arrow" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.join_lines_in_comments" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_record_declaration" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_relational_operator" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_multiple_field_declarations" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.blank_lines_between_import_groups" value="1"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_at_in_annotation_type_declaration" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_logical_operator" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_method_invocation" value="common_lines"/>
+        <setting id="org.eclipse.jdt.core.formatter.blank_lines_after_imports" value="1"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.insert_new_line_before_root_tags" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_record_declaration" value="common_lines"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_method_declaration_throws" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_switch_statement" value="common_lines"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_postfix_operator" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_for_increments" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_type_arguments" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_arrow_in_switch_default" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_for_inits" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.disabling_tag" value="@formatter:off"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_enum_constants" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.blank_lines_before_imports" value="1"/>
+        <setting id="org.eclipse.jdt.core.formatter.number_of_blank_lines_at_end_of_method_body" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_if_while_statement" value="common_lines"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_closing_brace_in_block" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_parenthesized_expression_in_return" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_arrow_in_switch_case" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_field" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.blank_lines_between_type_declarations" value="1"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_for" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_catch" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_switch" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_anonymous_type_declaration" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.never_indent_line_comments_on_first_column" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_for_inits" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.indent_statements_compare_to_block" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.brace_position_for_anonymous_type_declaration" value="next_line"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_question_in_wildcard" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_annotation" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_method_invocation_arguments" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_switch" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.align_tags_descriptions_grouped" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.line_length" value="80"/>
+        <setting id="org.eclipse.jdt.core.formatter.use_on_off_tags" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_method_body_on_one_line" value="one_line_never"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_brackets_in_array_allocation_expression" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_loop_body_block_on_one_line" value="one_line_never"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_enum_constant" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.brace_position_for_method_declaration" value="next_line"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_colon_in_for" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_type_declaration_on_one_line" value="one_line_never"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_closing_angle_bracket_in_type_arguments" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_additive_operator" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_multiple_field_declarations" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_record_constructor" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_relational_operator" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_superinterfaces" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_record_declaration_on_one_line" value="one_line_never"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_colon_in_default" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_question_in_conditional" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.brace_position_for_constructor_declaration" value="next_line"/>
+        <setting id="org.eclipse.jdt.core.formatter.brace_position_for_lambda_body" value="next_line"/>
+        <setting id="org.eclipse.jdt.core.formatter.compact_else_if" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_type_parameters" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_catch" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_method_invocation" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_method_invocation_arguments" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_arguments_in_method_invocation" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_throws_clause_in_constructor_declaration" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_new_line_before_catch_in_try_statement" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_try" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_annotations_on_parameter" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.clear_blank_lines_in_javadoc_comment" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_relational_operator" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_expressions_in_array_initializer" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.number_of_empty_lines_to_preserve" value="99"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_colon_in_case" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_additive_operator" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_if" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_type_arguments" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_string_concatenation" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.format_line_comments" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.brace_position_for_record_declaration" value="next_line"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_colon_in_labeled_statement" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.number_of_blank_lines_after_code_block" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_superinterfaces_in_type_declaration" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_conditional_expression" value="80"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_type" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_annotations_on_type" value="49"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_block" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_annotations_on_local_variable" value="49"/>
+        <setting id="org.eclipse.jdt.core.formatter.brace_position_for_enum_declaration" value="next_line"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_arrow_in_switch_default" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.insert_new_line_between_different_tags" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_additive_operator" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_method_invocation" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_while" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.join_wrapped_lines" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_constructor_declaration" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_annotations_on_field" value="49"/>
+        <setting id="org.eclipse.jdt.core.formatter.wrap_before_conditional_operator" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.indent_switchstatements_compare_to_cases" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_bracket_in_array_allocation_expression" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_synchronized" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_shift_operator" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.use_tabs_only_for_leading_indentations" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_try_clause" value="common_lines"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_code_block_on_one_line" value="one_line_never"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_constructor_declaration_throws" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_record_components" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.tabulation.size" value="4"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_bitwise_operator" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_bracket_in_array_reference" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_colon_in_conditional" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_try" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_semicolon_in_try_resources" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.continuation_indentation_for_array_initializer" value="2"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_question_in_wildcard" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_record_declaration" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_superinterfaces_in_enum_declaration" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.wrap_before_assignment_operator" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_colon_in_labeled_statement" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.brace_position_for_switch" value="next_line"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_superinterfaces" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_method_declaration_parameters" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_closing_angle_bracket_in_type_parameters" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_lambda_body_block_on_one_line" value="one_line_never"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_annotations_on_method" value="49"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_parameterized_type_reference" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_record_constructor_on_one_line" value="one_line_never"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_record_declaration" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_empty_array_initializer_on_one_line" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_assertion_message" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_constructor_declaration" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.blank_lines_before_new_chunk" value="1"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_bracket_in_array_allocation_expression" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_constructor_declaration" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_angle_bracket_in_parameterized_type_reference" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_angle_bracket_in_type_arguments" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_colon_in_assert" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.blank_lines_before_member_type" value="1"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_logical_operator" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_arguments_in_qualified_allocation_expression" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_superinterfaces_in_record_declaration" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_if" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_semicolon" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.wrap_before_relational_operator" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_postfix_operator" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_angle_bracket_in_type_arguments" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_cast" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.format_block_comments" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.alignment_for_parameters_in_method_declaration" value="16"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_method_declaration_throws" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.blank_lines_after_last_class_body_declaration" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.indent_statements_compare_to_body" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_simple_while_body_on_same_line" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.wrap_before_logical_operator" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.blank_lines_between_statement_group_in_switch" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_bracket_in_array_reference" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_comma_in_annotation" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_enum_constant_arguments" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.parentheses_positions_in_lambda_declaration" value="common_lines"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_colon_in_case" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_bracket_in_array_reference" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.keep_enum_declaration_on_one_line" value="one_line_never"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_method_declaration" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.brace_position_for_enum_constant" value="next_line"/>
+        <setting id="org.eclipse.jdt.core.formatter.brace_position_for_type_declaration" value="next_line"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_multiplicative_operator" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.blank_lines_before_package" value="1"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_for" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_for_increments" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_enum_constant" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_explicitconstructorcall_arguments" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_annotation" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_enum_constant_header" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_constructor_declaration" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_constructor_declaration_throws" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_closing_angle_bracket_in_type_parameters" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_question_in_conditional" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.comment.indent_parameter_description" value="false"/>
+        <setting id="org.eclipse.jdt.core.formatter.number_of_blank_lines_at_beginning_of_code_block" value="0"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_new_line_before_finally_in_try_statement" value="insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.tabulation.char" value="tab"/>
+        <setting id="org.eclipse.jdt.core.formatter.wrap_before_string_concatenation" value="true"/>
+        <setting id="org.eclipse.jdt.core.formatter.lineSplit" value="1200"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_annotation" value="do not insert"/>
+        <setting id="org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_switch" value="insert"/>
+    </profile>
+</profiles>
@@ -1,9 +1,12 @@
 buildscript {
    repositories {
-        maven { url = 'https://files.minecraftforge.net/maven' }
-        jcenter()
+        maven { url = 'https://files.minecraftforge.net' }
        mavenCentral()
-		maven { url='https://dist.creeper.host/Sponge/maven' }
+        // potential replacement in case of problems:
+		// https://dist.creeper.host/Sponge/maven
+		maven { url = 'https://repo.spongepowered.org/maven/' }
+		// used to download and compile dependencies from git repos 
+		maven { url 'https://jitpack.io' }
    }
    dependencies {
        classpath group: 'net.minecraftforge.gradle', name: 'ForgeGradle', version: '3.+', changing: true
@@ -16,9 +19,10 @@ apply plugin: 'org.spongepowered.mixin'
 apply plugin: 'eclipse'
 apply plugin: 'maven-publish'

-version = 'a1'
-group = 'com.backsun.lod'
-archivesBaseName = 'lod_1.16.4'
+version = 'a1.5.1-pre'
+group = 'com.seibel.lod'
+archivesBaseName = 'lod_1.16.5'
+

 sourceCompatibility = targetCompatibility = compileJava.sourceCompatibility = compileJava.targetCompatibility = '1.8' // Need this here so eclipse task generates correctly.

@@ -29,7 +33,7 @@ minecraft {
    // stable_#            Stables are built at the discretion of the MCP team.
    // Use non-default mappings at your own risk. they may not always work.
    // Simply re-run your setup task after changing the mappings to update your workspace.
-    mappings channel: 'snapshot', version: '20201028-1.16.3'
+	mappings channel: 'official', version: '1.16.5'

    // makeObfSourceJar = false // an Srg named sources jar is made by default. uncomment this to disable.
    
@@ -43,9 +47,15 @@ minecraft {
 			arg "-mixin.config=lod.mixins.json"

            // Recommended logging data for a userdev environment
-            property 'forge.logging.markers', 'SCAN,REGISTRIES,REGISTRYDUMP'
+            // The markers can be changed as needed. 
+            // "SCAN": For mods scan.
+            // "REGISTRIES": For firing of registry events.
+            // "REGISTRYDUMP": For getting the contents of all registries.
+            property 'forge.logging.markers', 'REGISTRIES'

            // Recommended logging level for the console
+            // You can set various levels here.
+            // Please read: https://stackoverflow.com/questions/2031163/when-to-use-the-different-log-levels
            property 'forge.logging.console.level', 'debug'

            mods {
@@ -60,9 +70,15 @@ minecraft {
 			arg "-mixin.config=lod.mixins.json"
 			
            // Recommended logging data for a userdev environment
-            property 'forge.logging.markers', 'SCAN,REGISTRIES,REGISTRYDUMP'
+            // The markers can be changed as needed. 
+            // "SCAN": For mods scan.
+            // "REGISTRIES": For firing of registry events.
+            // "REGISTRYDUMP": For getting the contents of all registries.
+            property 'forge.logging.markers', 'REGISTRIES'

            // Recommended logging level for the console
+            // You can set various levels here.
+            // Please read: https://stackoverflow.com/questions/2031163/when-to-use-the-different-log-levels
            property 'forge.logging.console.level', 'debug'

            mods {
@@ -76,9 +92,15 @@ minecraft {
            workingDirectory project.file('run')

            // Recommended logging data for a userdev environment
-            property 'forge.logging.markers', 'SCAN,REGISTRIES,REGISTRYDUMP'
+            // The markers can be changed as needed. 
+            // "SCAN": For mods scan.
+            // "REGISTRIES": For firing of registry events.
+            // "REGISTRYDUMP": For getting the contents of all registries.
+            property 'forge.logging.markers', 'REGISTRIES'

            // Recommended logging level for the console
+            // You can set various levels here.
+            // Please read: https://stackoverflow.com/questions/2031163/when-to-use-the-different-log-levels
            property 'forge.logging.console.level', 'debug'

            // Specify the modid for data generation, where to output the resulting resource, and where to look for existing resources.
@@ -96,11 +118,52 @@ minecraft {
 // Include resources generated by data generators.
 sourceSets.main.resources { srcDir 'src/generated/resources' }

+// this is required so that we can use 
+// jitpack in the dependencies section below 
+repositories {
+    mavenCentral()
+	// used to download and compile dependencies from git repos 
+	maven { url 'https://jitpack.io' }
+}
+
 dependencies {
    // Specify the version of Minecraft to use, If this is any group other then 'net.minecraft' it is assumed
    // that the dep is a ForgeGradle 'patcher' dependency. And it's patches will be applied.
    // The userdev artifact is a special name and will get all sorts of transformations applied to it.
-    minecraft 'net.minecraftforge:forge:1.16.4-35.1.4'
+    minecraft 'net.minecraftforge:forge:1.16.5-36.1.0'
+	
+	// these aren't needed right now
+	//implementation ('com.github.KaptainWutax:TerrainUtils:1.0.0'){
+    //    transitive = false
+    //}
+	//implementation ('com.github.KaptainWutax:BiomeUtils:1.0.0'){
+    //    transitive = false
+    //}
+    //implementation ('com.github.KaptainWutax:SeedUtils:-SNAPSHOT'){
+    //    transitive = false
+    //}
+    //implementation ('com.github.KaptainWutax:MCUtils:1.0.0'){
+    //    transitive = false
+    //}
+    //implementation ('com.github.KaptainWutax:NoiseUtils:1.0.0'){
+    //    transitive = false
+    //}
+    //implementation ('com.github.KaptainWutax:MathUtils:-SNAPSHOT'){
+    //    transitive = false
+    //}
+    
+    // these were added to hopefully allow for cloning
+    // configuredFeatures to allow for safe
+    // multi threaded feature generation. Sadly I couldn't find
+    // a way to duplicate lambda functions (which features use)
+    // so for now I'm not sure what to do.
+    //implementation 'io.github.kostaskougios:cloning:1.10.3'
+    //
+    //implementation ('com.esotericsoftware:kryo:5.1.1') {
+    //  exclude group: "org.objenesis"
+    //}
+    //implementation 'org.objenesis:objenesis:3.2'
+

    // You may put jars on which you depend on in ./libs or you may define them like so..
    // compile "some.group:artifact:version:classifier"
@@ -126,10 +189,10 @@ dependencies {
 jar {
    manifest {
        attributes([
-            "Specification-Title": "Levels of Detail",
+            "Specification-Title": "LOD",
            "Specification-Version": "1", // We are version 1 of ourselves
            "Implementation-Title": project.name,
-            "Implementation-Version": "1.0",
+            "Implementation-Version": "1",
            "Implementation-Timestamp": new Date().format("yyyy-MM-dd'T'HH:mm:ssZ"),
 			"MixinConfigs": "lod.mixins.json",
        ])
@@ -157,4 +220,4 @@ publishing {

 mixin {
    add sourceSets.main, "lod.refmap.json"
-}
+}
@@ -1,15 +0,0 @@
-package com.backsun.lod;
-
-/**
- * This file is similar to mcmod.info
- * 
- * @author James Seibel
- * @version 02-17-2021
- */
-public final class ModInfo
-{	
-	public static final String MODID = "lod";
-	public static final String MODNAME = "Levels of Detail";
-	public static final String MODAPI = "LodAPI";
-	public static final String VERSION = "1.0";
-}
@@ -1,189 +0,0 @@
-package com.backsun.lod.builders;
-import java.awt.Color;
-
-import org.lwjgl.opengl.GL11;
-
-import com.backsun.lod.objects.NearFarBuffer;
-import com.backsun.lod.renderer.LodRenderer;
-import com.backsun.lod.util.enums.FogDistance;
-
-import net.minecraft.client.renderer.BufferBuilder;
-import net.minecraft.util.math.AxisAlignedBB;
-
-/**
- * This object is used to create NearFarBuffer objects.
- * 
- * @author James Seibel
- * @version 02-27-2021
- */
-public class LodBufferBuilder
-{
-	public BufferBuilder nearBuffer;
-	public BufferBuilder farBuffer;
-	public FogDistance distanceMode;
-	public AxisAlignedBB[][] lods;
-	public Color[][] colors;
-	
-	
-	
-	public LodBufferBuilder()
-	{
-		
-	}
-	
-	
-	
-	public NearFarBuffer createBuffers(
-			BufferBuilder newNearBufferBuilder, BufferBuilder newFarBufferBuilder,
-			FogDistance newDistanceMode, 
-			AxisAlignedBB[][] newLods, Color[][] newColors)
-	{
-		nearBuffer = newNearBufferBuilder;
-		farBuffer = newFarBufferBuilder;
-		distanceMode = newDistanceMode;
-		lods = newLods;
-		colors = newColors;
-		
-		
-		nearBuffer.begin(GL11.GL_QUADS, LodRenderer.LOD_VERTEX_FORMAT);
-		farBuffer.begin(GL11.GL_QUADS, LodRenderer.LOD_VERTEX_FORMAT);
-		
-		int numbChunksWide = lods.length;
-		
-		BufferBuilder currentBuffer;
-		AxisAlignedBB bb;
-		int red;
-		int green;
-		int blue;
-		int alpha;
-		
-		
-		// x axis
-		for (int i = 0; i < numbChunksWide; i++)
-		{
-			// z axis
-			for (int j = 0; j < numbChunksWide; j++)
-			{
-				if (lods[i][j] == null || colors[i][j] == null)
-					continue;
-				
-				bb = lods[i][j];
-				
-				// get the color of this LOD object
-				red = colors[i][j].getRed();
-				green = colors[i][j].getGreen();
-				blue = colors[i][j].getBlue();
-				alpha = colors[i][j].getAlpha();
-				
-				
-				if (isCoordinateInNearFogArea(i, j, numbChunksWide / 2))
-					currentBuffer = nearBuffer;
-				else
-					currentBuffer = farBuffer;
-				
-				
-				if (bb.minY != bb.maxY)
-				{
-					// top (facing up)
-					addPosAndColor(currentBuffer, bb.minX, bb.maxY, bb.minZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.minX, bb.maxY, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.maxX, bb.maxY, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.maxX, bb.maxY, bb.minZ, red, green, blue, alpha);
-					// bottom (facing down)
-					addPosAndColor(currentBuffer, bb.maxX, bb.minY, bb.minZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.maxX, bb.minY, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.minX, bb.minY, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.minX, bb.minY, bb.minZ, red, green, blue, alpha);
-
-					// south (facing -Z) 
-					addPosAndColor(currentBuffer, bb.maxX, bb.minY, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.maxX, bb.maxY, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.minX, bb.maxY, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.minX, bb.minY, bb.maxZ, red, green, blue, alpha);
-					// north (facing +Z)
-					addPosAndColor(currentBuffer, bb.minX, bb.minY, bb.minZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.minX, bb.maxY, bb.minZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.maxX, bb.maxY, bb.minZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.maxX, bb.minY, bb.minZ, red, green, blue, alpha);
-
-					// west (facing -X)
-					addPosAndColor(currentBuffer, bb.minX, bb.minY, bb.minZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.minX, bb.minY, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.minX, bb.maxY, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.minX, bb.maxY, bb.minZ, red, green, blue, alpha);
-					// east (facing +X)
-					addPosAndColor(currentBuffer, bb.maxX, bb.maxY, bb.minZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.maxX, bb.maxY, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.maxX, bb.minY, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.maxX, bb.minY, bb.minZ, red, green, blue, alpha);
-				}
-				else
-				{
-					// render this LOD as one block thick
-					
-					// top (facing up)
-					addPosAndColor(currentBuffer, bb.minX, bb.minY+1, bb.minZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.minX, bb.minY+1, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.maxX, bb.minY+1, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.maxX, bb.minY+1, bb.minZ, red, green, blue, alpha);
-					// bottom (facing down)
-					addPosAndColor(currentBuffer, bb.maxX, bb.minY, bb.minZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.maxX, bb.minY, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.minX, bb.minY, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.minX, bb.minY, bb.minZ, red, green, blue, alpha);
-
-					// south (facing -Z) 
-					addPosAndColor(currentBuffer, bb.maxX, bb.minY, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.maxX, bb.minY+1, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.minX, bb.minY+1, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.minX, bb.minY, bb.maxZ, red, green, blue, alpha);
-					// north (facing +Z)
-					addPosAndColor(currentBuffer, bb.minX, bb.minY, bb.minZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.minX, bb.minY+1, bb.minZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.maxX, bb.minY+1, bb.minZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.maxX, bb.minY, bb.minZ, red, green, blue, alpha);
-
-					// west (facing -X)
-					addPosAndColor(currentBuffer, bb.minX, bb.minY, bb.minZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.minX, bb.minY, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.minX, bb.minY+1, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.minX, bb.minY+1, bb.minZ, red, green, blue, alpha);
-					// east (facing +X)
-					addPosAndColor(currentBuffer, bb.maxX, bb.minY+1, bb.minZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.maxX, bb.minY+1, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.maxX, bb.minY, bb.maxZ, red, green, blue, alpha);
-					addPosAndColor(currentBuffer, bb.maxX, bb.minY, bb.minZ, red, green, blue, alpha);
-				}
-				
-			} // z axis
-		} // x axis
-		
-		nearBuffer.finishDrawing();
-		farBuffer.finishDrawing();
-		
-		return new NearFarBuffer(nearBuffer, farBuffer);
-	}
-	
-	private void addPosAndColor(BufferBuilder buffer, double x, double y, double z, int red, int green, int blue, int alpha)
-	{
-		buffer.pos(x, y, z).color(red, green, blue, alpha).endVertex();
-	}
-	
-	
-	
-	/**
-	 * Find the coordinates that are in the center half of the given
-	 * 2D matrix, starting at (0,0) and going to (2 * lodRadius, 2 * lodRadius).
-	 */
-	private static boolean isCoordinateInNearFogArea(int chunkX, int chunkZ, int lodRadius)
-	{
-		int halfRadius = lodRadius / 2;
-		
-		return (chunkX >= lodRadius - halfRadius 
-				&& chunkX <= lodRadius + halfRadius) 
-				&& 
-				(chunkZ >= lodRadius - halfRadius
-				&& chunkZ <= lodRadius + halfRadius);
-	}
-	
-}
@@ -1,124 +0,0 @@
-package com.backsun.lod.builders;
-
-import java.util.concurrent.ExecutorService;
-import java.util.concurrent.Executors;
-
-import com.backsun.lod.handlers.LodDimensionFileHandler;
-import com.backsun.lod.objects.LodChunk;
-import com.backsun.lod.objects.LodDimension;
-import com.backsun.lod.objects.LodWorld;
-import com.backsun.lod.util.LodUtils;
-
-import net.minecraft.world.DimensionType;
-import net.minecraft.world.chunk.Chunk;
-import net.minecraft.world.chunk.ChunkSection;
-import net.minecraft.world.server.ServerWorld;
-
-/**
- * This object is in charge of creating Lod
- * related objects. 
- * (specifically: Lod World, Dimension, Region, and Chunk objects)
- * 
- * @author James Seibel
- * @version 2-22-2021
- */
-public class LodBuilder
-{
-	private ExecutorService lodGenThreadPool = Executors.newSingleThreadExecutor();
-	public volatile LodWorld lodWorld;
-	
-	/** Default size of any LOD regions we use */
-	public int regionWidth = 5;
-	
-	public LodBuilder()
-	{
-		
-	}
-	
-	
-	
-	/**
-	 * Returns LodWorld so that it can be passed
-	 * to the LodRenderer.
-	 */
-	public LodWorld generateLodChunkAsync(Chunk chunk)
-	{
-		if (lodWorld != null)
-			// is this chunk from the same world as the lodWorld?
-			if (!lodWorld.worldName.equals(LodDimensionFileHandler.getCurrentWorldID()))
-				// we are not in the same world anymore,
-				// remove the old world so it can be recreated later
-				lodWorld = null;
-		
-		// don't try to create an LOD object
-		// if for some reason we aren't
-		// given a valid chunk object
-		// (Minecraft often gives back empty
-		// or null chunks in this method)
-		if (chunk == null || !isValidChunk(chunk))
-			return lodWorld;
-		
-		
-		DimensionType dim = chunk.getWorld().getDimensionType();
-		ServerWorld world = LodUtils.getServerWorldFromDimension(dim);
-		
-		
-		if (world == null)
-			return lodWorld;
-			
-		Thread thread = new Thread(() ->
-		{
-			try
-			{
-				LodChunk lod = new LodChunk(chunk, world);
-				LodDimension lodDim;
-				
-				if (lodWorld == null)
-				{
-					lodWorld = new LodWorld(LodDimensionFileHandler.getCurrentWorldID());
-				}
-				
-				
-				if (lodWorld.getLodDimension(dim) == null)
-				{
-					lodDim = new LodDimension(dim, regionWidth);
-					lodWorld.addLodDimension(lodDim);
-				}
-				else
-				{
-					lodDim = lodWorld.getLodDimension(dim);
-				}
-				
-				lodDim.addLod(lod);
-			}
-			catch(IllegalArgumentException | NullPointerException e)
-			{
-				// if the world changes while LODs are being generated
-				// they will throw errors as they try to access things that no longer
-				// exist.
-			}
-		});
-		lodGenThreadPool.execute(thread);
-		
-		return lodWorld;
-	}
-	
-	/**
-	 * Return whether the given chunk
-	 * has any data in it.
-	 */
-	public boolean isValidChunk(Chunk chunk)
-	{
-		ChunkSection[] blockStorage = chunk.getSections();
-		
-		for(ChunkSection section : blockStorage)
-		{
-			if(section != null && !section.isEmpty())
-			{
-				return true;
-			}
-		}
-		
-		return false;
-	}
-}
@@ -1,289 +0,0 @@
-package com.backsun.lod.handlers;
-
-import java.io.BufferedReader;
-import java.io.File;
-import java.io.FileReader;
-import java.io.FileWriter;
-import java.io.IOException;
-import java.util.concurrent.ExecutorService;
-import java.util.concurrent.Executors;
-
-import com.backsun.lod.objects.LodChunk;
-import com.backsun.lod.objects.LodDimension;
-import com.backsun.lod.objects.LodRegion;
-import com.backsun.lod.util.LodUtils;
-
-import net.minecraft.client.Minecraft;
-import net.minecraft.world.server.ServerChunkProvider;
-import net.minecraft.world.server.ServerWorld;
-
-/**
- * This object handles creating LodRegions
- * from files and saving LodRegion objects
- * to file.
- * 
- * @author James Seibel
- * @version 01-30-2021
- */
-public class LodDimensionFileHandler
-{
-	private LodDimension loadedDimension = null;
-	public long regionLastWriteTime[][];
-	
-	private File dimensionDataSaveFolder;
-	
-	private final String FILE_NAME_PREFIX = "lod";
-	private final String FILE_EXTENSION = ".txt";
-	
-	private ExecutorService fileWritingThreadPool = Executors.newFixedThreadPool(1);
-	
-	
-	public LodDimensionFileHandler(File newSaveFolder, LodDimension newLoadedDimension)
-	{
-		dimensionDataSaveFolder = newSaveFolder;
-		
-		loadedDimension = newLoadedDimension;
-		// these two variable are used in sync with the LodDimension
-		regionLastWriteTime = new long[loadedDimension.getWidth()][loadedDimension.getWidth()];
-		for(int i = 0; i < loadedDimension.getWidth(); i++)
-			for(int j = 0; j < loadedDimension.getWidth(); j++)
-				regionLastWriteTime[i][j] = -1;
-	}
-	
-	
-	
-	
-	
-	//================//
-	// read from file //
-	//================//
-	
-	
-	
-	/**
-	 * Return the LodRegion at the given coordinates.
-	 * (null if the file doesn't exist)
-	 */
-	public LodRegion loadRegionFromFile(int regionX, int regionZ)
-	{
-		// we don't currently support reading or writing
-		// files when connected to a server
-		if (!Minecraft.getInstance().isIntegratedServerRunning())
-			return null;
-		
-		if (!readyToReadAndWrite())
-			return null;
-		
-		String fileName = getFileNameForRegion(regionX, regionZ);
-		
-		File f = new File(fileName);
-		
-		if (!f.exists())
-		{
-			// there wasn't a file, don't
-			// return anything
-			return null;
-		}
-		
-		LodRegion region = new LodRegion(regionX, regionZ);
-		
-		try
-		{
-			BufferedReader br = new BufferedReader(new FileReader(f));
-			String s = br.readLine();
-			
-			while(s != null && !s.isEmpty())
-			{
-				try
-				{
-					// convert each line into an LOD object and add it to the region
-					LodChunk lod = new LodChunk(s);
-					
-					region.addLod(lod);
-				}
-				catch(IllegalArgumentException e)
-				{
-					// we were unable to create this chunk
-					// for whatever reason.
-					// skip to the next chunk
-				}
-				
-				s = br.readLine();
-			}
-			
-			br.close();
-		}
-		catch (IOException e)
-		{
-			// File not found
-			
-			// or the buffered reader encountered a 
-			// problem reading the file
-			return null;
-		}
-		
-		return region;
-	}
-	
-	
-	
-	
-	
-	
-	
-	
-	//==============//
-	// Save to File //
-	//==============//
-	
-	/**
-	 * Save all dirty regions in this LodDimension to file.
-	 */
-	public synchronized void saveDirtyRegionsToFileAsync()
-	{
-		// we don't currently support reading or writing
-		// files when connected to a server
-		if (!Minecraft.getInstance().isIntegratedServerRunning())
-			return;
-		
-		if (!readyToReadAndWrite())
-			// we aren't ready to read and write yet
-			return;
-		
-		fileWritingThreadPool.execute(saveDirtyRegionsThread);
-	}
-	private Thread saveDirtyRegionsThread = new Thread(() -> 
-	{
-		for(int i = 0; i < loadedDimension.getWidth(); i++)
-		{
-			for(int j = 0; j < loadedDimension.getWidth(); j++)
-			{
-				if(loadedDimension.isRegionDirty[i][j])
-				{
-					saveRegionToDisk(loadedDimension.regions[i][j]);
-					loadedDimension.isRegionDirty[i][j] = false;
-				}
-			}
-		}
-	});
- 	
-	/**
-	 * Save a specific region to disk.<br>
-	 * Note: it will save to the LodDimension that this
-	 * handler is associated with.
-	 */
-	private void saveRegionToDisk(LodRegion region)
-	{
-		if (!readyToReadAndWrite() || region == null)
-			return;
-		
-		// convert chunk coordinates to region
-		// coordinates
-		int x = region.x;
-		int z = region.z;
-		
-		File f = new File(getFileNameForRegion(x, z));
-		
-		try
-		{
-			// make sure the file and folder exists
-			if (!f.exists())
-				if(!f.getParentFile().exists())
-					f.getParentFile().mkdirs();
-				f.createNewFile();
-			
-			FileWriter fw = new FileWriter(f);
-			
-			for(LodChunk[] chunkArray : region.getAllLods())
-				for(LodChunk chunk : chunkArray)
-					if(chunk != null)
-						fw.write(chunk.toData() + "\n");
-			
-			fw.close();
-		}
-		catch(Exception e)
-		{
-			System.err.println("LOD file write error: " + e.getMessage());
-		}
-	}
-	
-	
- 	
-	
-	
-	
-	
-	//================//
-	// helper methods //
-	//================//
-	
-	
-	/**
-	 * Return the name of the file that should contain the 
-	 * region at the given x and z. <br>
-	 * Returns null if this object isn't ready to read and write.
-	 */
-	private String getFileNameForRegion(int regionX, int regionZ)
-	{
-		if (!readyToReadAndWrite())
-			return null;
-		
-		try
-		{
-			// saveFolder is something like
-			// ".\Super Flat\DIM-1\data"
-			// or
-			// ".\Super Flat\data"
-			return dimensionDataSaveFolder.getCanonicalPath() + "\\lod\\" +
-					FILE_NAME_PREFIX + "." + regionX + "." + regionZ + FILE_EXTENSION;
-		}
-		catch(IOException e)
-		{
-			return null;
-		}
-	}
-	
-	
-	/**
-	 * Returns if this FileHandler is ready to read
-	 * and write files.
-	 * <br>
-	 * This returns true when the world save directory is known.
-	 */
-	public boolean readyToReadAndWrite()
-	{
-		return dimensionDataSaveFolder != null;
-	}
-	
-	
-	
-	
-	/**
-	 * If on single player this will return the name of the user's
-	 * world, if in multiplayer it will return the server name
-	 * and game version.
-	 */
-	public static String getCurrentWorldID()
-	{
-		Minecraft mc = Minecraft.getInstance();
-		
-		if(mc.isIntegratedServerRunning())
-		{
-			ServerWorld serverWorld = LodUtils.getFirstValidServerWorld();
-			if (serverWorld == null)
-				return "";
-			
-			ServerChunkProvider provider = serverWorld.getChunkProvider();
-			if(provider != null)
-				return provider.getSavedData().folder.toString();
-			
-			return "";
-		}
-		else
-		{
-			return mc.getCurrentServerData().serverName + "_version_" + mc.getCurrentServerData().gameVersion;
-		}
-	}
-	
-	
-}
@@ -1,99 +0,0 @@
-package com.backsun.lod.handlers;
-
-import java.lang.reflect.Field;
-
-import com.backsun.lod.util.enums.FogQuality;
-
-import net.minecraft.client.Minecraft;
-
-/**
- * This object is used to get variables from methods
- * where they are private. Specifically the fog setting
- * in Optifine.
- * 
- * @author James Seibel
- * @version 09-21-2020
- */
-public class ReflectionHandler
-{
-	private Minecraft mc = Minecraft.getInstance();
-	public Field ofFogField = null;
-	
-	
-	public ReflectionHandler()
-	{
-		setupFogField();
-	}
-	
-	
-	
-	
-	/**
-	 * Similar to setupFovMethod.
-	 */
-	private void setupFogField()
-	{
-		// get every variable from the entity renderer
-		Field[] vars = mc.gameSettings.getClass().getDeclaredFields();
-				
-		// try and find the ofFogType variable in gameSettings
-		for(Field f : vars)
-		{
-			if(f.getName().equals("ofFogType"))
-			{
-				ofFogField = f;
-				return;
-			}
-		}
-		
-		// we didn't find the field,
-		// either optifine isn't installed, or
-		// optifine changed the name of the variable
-		ofFogField = null;
-	}
-	
-	
-	
-	
-	
-	/**
-	 * Get what type of fog optifine is currently set to render.
-	 */
-	public FogQuality getFogQuality()
-	{
-		if (ofFogField == null)
-		{
-			// either optifine isn't installed,
-			// the variable name was changed, or
-			// the setup method wasn't called yet.
-			return FogQuality.FANCY;
-		}
-		
-		int returnNum = 0;
-		
-		try
-		{
-			returnNum = (int)ofFogField.get(mc.gameSettings);
-		}
-		catch (IllegalArgumentException | IllegalAccessException e)
-		{
-			e.printStackTrace();
-		}
-		
-		switch (returnNum)
-		{
-			case 0:
-				return FogQuality.FAST;
-			case 1:
-				return FogQuality.FAST;
-			case 2:
-				return FogQuality.FANCY;
-			case 3:
-				return FogQuality.OFF;
-				
-			default:
-				return FogQuality.FAST;
-		}
-	}
-	
-}
@@ -1,22 +0,0 @@
-package com.backsun.lod.mixin;
-
-import org.spongepowered.asm.mixin.Mixin;
-import org.spongepowered.asm.mixin.injection.At;
-import org.spongepowered.asm.mixin.injection.Inject;
-import org.spongepowered.asm.mixin.injection.callback.CallbackInfo;
-
-import com.backsun.lod.renderer.RenderGlobalHook;
-import com.mojang.blaze3d.matrix.MatrixStack;
-
-import net.minecraft.client.renderer.RenderType;
-import net.minecraft.client.renderer.WorldRenderer;
-
-@Mixin(WorldRenderer.class)
-public class MixinWorldRenderer
-{
-	@Inject(at = @At("HEAD"), method = "renderBlockLayer(Lnet/minecraft/client/renderer/RenderType;Lcom/mojang/blaze3d/matrix/MatrixStack;DDD)V", cancellable = false)
-	private void renderBlockLayer(RenderType blockLayerIn, MatrixStack matrixStackIn, double xIn, double yIn, double zIn, CallbackInfo callback)
-	{
-		RenderGlobalHook.startRenderingStencil(blockLayerIn);
-	}
-}
@@ -1,776 +0,0 @@
-package com.backsun.lod.objects;
-
-import java.awt.Color;
-
-import com.backsun.lod.util.enums.ColorDirection;
-import com.backsun.lod.util.enums.LodCorner;
-import com.backsun.lod.util.enums.LodLocation;
-
-import net.minecraft.block.Blocks;
-import net.minecraft.client.Minecraft;
-import net.minecraft.client.renderer.color.BlockColors;
-import net.minecraft.world.World;
-import net.minecraft.world.chunk.Chunk;
-import net.minecraft.world.chunk.ChunkSection;
-
-/**
- * This object contains position
- * and color data for an LOD object.
- * 
- * @author James Seibel
- * @version 02-13-2021
- */
-public class LodChunk
-{
-	/** how many different pieces of data are in one line */
-	private static final int DATA_DELIMITER_COUNT = 28;
-
-	/** This is what separates each piece of data in the toData method */
-	public static final char DATA_DELIMITER = ',';
-	
-	public static final int WIDTH = 16;
-	
-	private static final int CHUNK_DATA_WIDTH = WIDTH;
-	private static final int CHUNK_DATA_HEIGHT = WIDTH;
-	
-	/**
-	 * This is how many blocks are
-	 * required at a specific y-value
-	 * to constitute a LOD point
-	 */
-	private final int LOD_BLOCK_REQ = 16;
-	// the max number of blocks per layer = 64 (8*8)
-	// since each layer is 1/4 the chunk
-	
-	
-	/** The x coordinate of the chunk. */
-	public int x;
-	/** The z coordinate of the chunk. */
-	public int z;
-	
-	// each short is the height of
-	// that 8th of the chunk.
-	public short top[];
-	public short bottom[];
-	
-	/** The average color of each 6 cardinal directions */
-	public Color colors[];
-	
-	
-	
-	
-	
-	
-	
-	
-	
-	//==============//
-	// constructors //
-	//==============//
-	
-	/**
-	 * Create an empty invisible LodChunk at (0,0)
-	 */
-	public LodChunk()
-	{
-		x = 0;
-		z = 0;
-		
-		top = new short[4];
-		bottom = new short[4];
-		colors = new Color[6];
-		
-		// by default have the colors invisible
-		for(ColorDirection dir : ColorDirection.values())
-		{
-			colors[dir.value] = new Color(0, 0, 0, 0);
-		}
-	}
-	
-	/**
-	 * Creates an LodChunk from the string
-	 * generated by the toData method.
-	 * 
-	 * @throws IllegalArgumentException if the data isn't valid to create a LodChunk
-	 * @throws NumberFormatException if the data can't be converted into an int at any point
-	 */
-	public LodChunk(String data) throws IllegalArgumentException, NumberFormatException
-	{
-		/*
-		 * data format:
-		 * x, z, top data, bottom data, rgb color data
-		 * 
-		 * example:
-		 * 5,8, 4,4,4,4, 0,0,0,0, 255,255,255, 255,255,255, 255,255,255, 255,255,255, 255,255,255, 255,255,255,
-		 */
-		
-		// make sure there are the correct number of entries
-		// in the data string (28)
-		int count = 0;
-		
-		for(int i = 0; i < data.length(); i++)
-		{
-			if(data.charAt(i) == DATA_DELIMITER)
-			{
-				count++;
-			}
-		}
-		
-		if(count != DATA_DELIMITER_COUNT)
-		{
-			throw new IllegalArgumentException("LodChunk constructor givin an invalid string. The data given had " + count + " delimiters when it should have had " + DATA_DELIMITER_COUNT + ".");
-		}
-		
-		
-		
-		// index we will use when going through the String
-		int index = 0;
-		int lastIndex = 0;
-		
-		
-		
-		// x and z position
-		index = data.indexOf(DATA_DELIMITER, 0);
-		x = Integer.parseInt(data.substring(0,index));
-		
-		lastIndex = index;
-		index = data.indexOf(DATA_DELIMITER, lastIndex + 1);
-		z = Integer.parseInt(data.substring(lastIndex+1,index));
-		
-		
-		
-		// top
-		top = new short[4];
-		for(LodLocation loc : LodLocation.values())
-		{
-			lastIndex = index;
-			index = data.indexOf(DATA_DELIMITER, lastIndex + 1);
-			
-			top[loc.value] = Short.parseShort(data.substring(lastIndex+1,index));
-		}
-		
-		
-		// bottom
-		bottom = new short[4];
-		for(LodLocation loc : LodLocation.values())
-		{
-			lastIndex = index;
-			index = data.indexOf(DATA_DELIMITER, lastIndex + 1);
-			
-			bottom[loc.value] = Short.parseShort(data.substring(lastIndex+1,index));
-		}
-		
-		
-		// color
-		colors = new Color[6];
-		for(ColorDirection dir : ColorDirection.values())
-		{
-			int red = 0;
-			int green = 0;
-			int blue = 0;
-			
-			// get r,g,b
-			for(int i = 0; i < 3; i++)
-			{
-				lastIndex = index;
-				index = data.indexOf(DATA_DELIMITER, lastIndex + 1);
-				
-				String raw = "";
-				switch(i)
-				{
-				case 0:
-					raw = data.substring(lastIndex+1,index);
-					red = Short.parseShort(raw);
-					break;
-				case 1:
-					raw = data.substring(lastIndex+1,index);
-					green = Short.parseShort(raw);
-					break;
-				case 2:
-					raw = data.substring(lastIndex+1,index);
-					blue = Short.parseShort(raw);
-					break;
-				}
-			}
-			
-			colors[dir.value] = new Color(red, green, blue);
-		}
-	}
-	
-	/**
-	 * Creates a LodChunk for a chunk in the given world. <br>
-	 * Note: The world is required to determine each block's color
-	 * 
-	 * @throws IllegalArgumentException 
-	 * thrown if either the chunk or world is null.
-	 */
-	public LodChunk(Chunk chunk, World world) throws IllegalArgumentException
-	{
-		if(chunk == null)
-		{
-			throw new IllegalArgumentException("LodChunk constructor given a null chunk");
-		}
-		if(world == null)
-		{
-			throw new IllegalArgumentException("LodChunk constructor given a null world");
-		}
-		
-		
-		x = chunk.getPos().x;
-		z = chunk.getPos().z;
-		
-		top = new short[4];
-		bottom = new short[4];
-		colors = new Color[6];
-		
-		// generate the top and bottom points of this LOD
-		for(LodLocation loc : LodLocation.values())
-		{
-			top[loc.value] = generateLodCorner(chunk, SectionGenerationMode.GENERATE_TOP, loc);
-			bottom[loc.value] = generateLodCorner(chunk, SectionGenerationMode.GENERATE_BOTTOM, loc);
-		}
-		
-		// determine the average color for each direction
-		for(ColorDirection dir : ColorDirection.values())
-		{
-			colors[dir.value] = generateLodColorForDirection(chunk, world, dir);
-		}
-	}
-	
-	
-	
-	
-	
-	
-	
-	//=====================//
-	// constructor helpers //
-	//=====================//
-	
-	
-	/**
-	 * Generate the height for the given LodLocation, either the top or bottom.
-	 * <br><br>
-	 * If invalid/null/empty chunks are given 
-	 * crashes may occur.
-	 */
-	public short generateLodCorner(Chunk chunk, SectionGenerationMode generationMode, LodLocation lodLoc)
-	{
-		// should have a length of 16
-		// (each storage is 16x16x16 and the
-		// world height is 256)
-		ChunkSection[] chunkSections = chunk.getSections();
-		
-		
-		
-		int startX = 0;
-		int endX = 0;
-		
-		int startZ = 0;
-		int endZ = 0;
-		
-		// determine where we should look in this
-		// chunk
-		switch(lodLoc)
-		{
-			case NE:
-				// -N
-				startZ = 0;
-				endZ = (CHUNK_DATA_WIDTH / 2) - 1;
-				// +E
-				startX = CHUNK_DATA_WIDTH / 2;
-				endX = CHUNK_DATA_WIDTH - 1;
-				break;
-				
-			case SE:
-				// +S
-				startZ = CHUNK_DATA_WIDTH / 2;
-				endZ = CHUNK_DATA_WIDTH;
-				// +E
-				startX = CHUNK_DATA_WIDTH / 2;
-				endX = CHUNK_DATA_WIDTH;
-				break;
-				
-			case SW:
-				// +S
-				startZ = CHUNK_DATA_WIDTH / 2;
-				endZ = CHUNK_DATA_WIDTH;
-				// -W
-				startX = 0;
-				endX = (CHUNK_DATA_WIDTH / 2) - 1;
-				break;
-				
-			case NW:
-				// -N
-				startZ = 0;
-				endZ = CHUNK_DATA_WIDTH / 2;
-				// -W
-				startX = 0;
-				endX = CHUNK_DATA_WIDTH / 2;
-				break;
-		}
-		
-		
-		if(generationMode == SectionGenerationMode.GENERATE_TOP)
-			return determineTopPoint(chunkSections, startX, endX, startZ, endZ);
-		else
-			return determineBottomPoint(chunkSections, startX, endX, startZ, endZ);
-	}
-	/** GENERATE_TOP, GENERATE_BOTTOM */
-	private enum SectionGenerationMode
-	{
-		GENERATE_TOP,
-		GENERATE_BOTTOM;
-	}
-	
-	/**
-	 * Find the lowest valid point from the bottom.
-	 */
-	private short determineBottomPoint(ChunkSection[] chunkSections, int startX, int endX, int startZ, int endZ)
-	{
-		// search from the bottom up
-		for(int i = 0; i < chunkSections.length; i++)
-		{
-			for(int y = 0; y < CHUNK_DATA_HEIGHT; y++)
-			{
-				
-				if(isLayerValidLodPoint(chunkSections, startX, endX, startZ, endZ, i, y))
-				{
-					// we found
-					// enough blocks in this
-					// layer to count as an
-					// LOD point
-					return (short) (y + (i * CHUNK_DATA_HEIGHT));
-				}
-			}
-		}
-		
-		// we never found a valid LOD point
-		return -1;
-	}
-	
-	/**
-	 * Find the highest valid point from the Top
-	 */
-	private short determineTopPoint(ChunkSection[] chunkSections, int startX, int endX, int startZ, int endZ)
-	{
-		// search from the top down
-		for(int i = chunkSections.length - 1; i >= 0; i--)
-		{
-			for(int y = CHUNK_DATA_WIDTH - 1; y >= 0; y--)
-			{
-				if(isLayerValidLodPoint(chunkSections, startX, endX, startZ, endZ, i, y))
-				{
-					// we found
-					// enough blocks in this
-					// layer to count as an
-					// LOD point
-					return (short) (y + (i * CHUNK_DATA_HEIGHT));
-				}
-			}
-		}
-		
-		// we never found a valid LOD point
-		return -1;
-	}
-	
-	/**
-	 * Is the layer between the given X, Z, and dataIndex
-	 * values a valid LOD point?
-	 */
-	private boolean isLayerValidLodPoint(
-			ChunkSection[] chunkSections, 
-			int startX, int endX, 
-			int startZ, int endZ, 
-			int sectionIndex, int y)
-	{
-		// search through this layer
-		int layerBlocks = 0;
-		
-		for(int x = startX; x < endX; x++)
-		{
-			for(int z = startZ; z < endZ; z++)
-			{
-				if(chunkSections[sectionIndex] == null)
-				{
-					// this section doesn't have any blocks,
-					// it is not a valid section
-					return false;
-				}
-				else
-				{
-					if(chunkSections[sectionIndex].getBlockState(x, y, z) != null && chunkSections[sectionIndex].getBlockState(x, y, z).getBlock() != Blocks.AIR)
-					{
-						// we found a valid block in
-						// in this layer
-						layerBlocks++;
-						
-						if(layerBlocks >= LOD_BLOCK_REQ)
-						{
-							return true;
-						}
-					}
-				}
-				
-			} // z
-		} // x
-		
-		return false;
-	}
-	
-	/**
-	 * Generate the color of the given ColorDirection at the given chunk
-	 * in the given world.
-	 */
-	private Color  generateLodColorForDirection(Chunk chunk, World world, ColorDirection colorDir)
-	{
-		Minecraft mc =  Minecraft.getInstance();
-		BlockColors bc = mc.getBlockColors();
-		
-		switch (colorDir)
-		{
-			case TOP:
-				return generateLodColorVertical(chunk, colorDir, world, bc);
-			case BOTTOM:
-				return generateLodColorVertical(chunk, colorDir, world, bc);
-				
-			case N:
-				return generateLodColorHorizontal(chunk, colorDir, world, bc);
-			case S:
-				return generateLodColorHorizontal(chunk, colorDir, world, bc);
-				
-			case E:
-				return generateLodColorHorizontal(chunk, colorDir, world, bc);
-			case W:
-				return generateLodColorHorizontal(chunk, colorDir, world, bc);
-		}
-		
-		return new Color(0, 0, 0, 0);
-	}
-	
-	/**
-	 * Generates the color of the top or bottom of a given chunk in the given world.
-	 * 
-	 * @throws IllegalArgumentException if given a ColorDirection other than TOP or BOTTOM
-	 */
-	private Color generateLodColorVertical(Chunk chunk, ColorDirection colorDir, World world, BlockColors bc)
-	{
-		if(colorDir != ColorDirection.TOP && colorDir != ColorDirection.BOTTOM)
-		{
-			throw new IllegalArgumentException("generateLodColorVertical only accepts the ColorDirection TOP or BOTTOM");
-		}
-		
-		ChunkSection[] chunkSections = chunk.getSections();
-		
-		int numbOfBlocks = 0;
-		int red = 0;
-		int green = 0;
-		int blue = 0;
-		
-		boolean goTopDown = (colorDir == ColorDirection.TOP);
-		
-		
-		// either go top down or bottom up
-		int dataStart = goTopDown? chunkSections.length - 1 : 0;
-		int dataMax = chunkSections.length; 
-		int dataMin = 0;
-		int dataIncrement = goTopDown? -1 : 1;
-		
-		int topStart = goTopDown? CHUNK_DATA_HEIGHT - 1 : 0;
-		int topMax = CHUNK_DATA_HEIGHT;
-		int topMin = 0;
-		int topIncrement =  goTopDown? -1 : 1;
-		
-		for(int x = 0; x < CHUNK_DATA_WIDTH; x++)
-		{
-			for(int z = 0; z < CHUNK_DATA_WIDTH; z++)
-			{
-				boolean foundBlock = false;
-				
-				for(int i = dataStart; !foundBlock && i >= dataMin && i < dataMax; i += dataIncrement)
-				{
-					if(!foundBlock && chunkSections[i] != null)
-					{
-						for(int y = topStart; !foundBlock && y >= topMin && y < topMax; y += topIncrement)
-						{
-							int ci;
-							ci = chunkSections[i].getBlockState(x, y, z).materialColor.colorValue;
-							
-							if(ci == 0)
-							{
-								// skip air or invisible blocks
-								continue;
-							}
-							
-							Color c = intToColor(ci);
-							
-							red += c.getRed();
-							green += c.getGreen();
-							blue += c.getBlue();
-							
-							numbOfBlocks++;
-							
-							
-							// we found a valid block, skip to the
-							// next x and z
-							foundBlock = true;
-						}
-					}
-				}
-				
-			}
-		}
-		
-		if(numbOfBlocks == 0)
-			numbOfBlocks = 1;
-		
-		red /= numbOfBlocks;
-		green /= numbOfBlocks;
-		blue /= numbOfBlocks;
-		
-		return new Color(red, green, blue);
-	}
-	
-	/**
-	 * Generates the color of the side of a given chunk in the given world for the given ColorDirection.
-	 * 
-	 * @throws IllegalArgumentException if given a ColorDirection other than N, S, W, E (North, South, East, West)
-	 */
-	private Color generateLodColorHorizontal(Chunk chunk, ColorDirection colorDir, World world, BlockColors bc)
-	{
-		if(colorDir != ColorDirection.N && colorDir != ColorDirection.S && colorDir != ColorDirection.E && colorDir != ColorDirection.W)
-		{
-			throw new IllegalArgumentException("generateLodColorHorizontal only accepts the ColorDirection N (North), S (South), E (East), or W (West)");
-		}
-		
-		ChunkSection[] chunkSections = chunk.getSections();
-		
-		int numbOfBlocks = 0;
-		int red = 0;
-		int green = 0;
-		int blue = 0;
-		
-		
-		// these don't change since the over direction doesn't matter
-		int overStart = 0;
-		int overIncrement = 1;
-		
-		// determine which direction is "in"
-		int inStart = 0;
-		int inIncrement = 1;
-		switch (colorDir)
-		{
-		case N:
-			inStart = 0;
-			inIncrement = 1;
-			break;
-		case S:
-			inStart = CHUNK_DATA_WIDTH - 1;
-			inIncrement = -1;
-			break;
-		case E:
-			inStart = 0;
-			inIncrement = 1;
-			break;
-		case W:
-			inStart = CHUNK_DATA_WIDTH - 1;
-			inIncrement = -1;
-			break;
-		default:
-			// we were given an invalid position, return invisible.
-			// this shouldn't happen and is mostly here to make the
-			// compiler happy
-			return new Color(0,0,0,0);
-		}
-		
-		
-		for (int i = 0; i < chunkSections.length; i++)
-		{
-			if (chunkSections[i] != null)
-			{
-				for (int y = 0; y < CHUNK_DATA_HEIGHT; y++)
-				{
-					boolean foundBlock = false;
-					
-					// over moves "over" the side of the chunk
-					// in moves "into" the chunk until it finds a block
-					
-					for (int over = overStart; !foundBlock && over >= 0 && over < CHUNK_DATA_WIDTH; over += overIncrement)
-					{
-						for (int in = inStart; !foundBlock && in >= 0 && in < CHUNK_DATA_WIDTH; in += inIncrement)
-						{
-							int x = -1;
-							int z = -1;
-							
-							// determine which should be X and Z							
-							switch(colorDir)
-							{
-							case N:
-								x = over;
-								z = in;
-								break;
-							case S:
-								x = over;
-								z = in;
-								break;
-							case E:
-								x = in;
-								z = over;
-								break;
-							case W:
-								x = in;
-								z = over;
-								break;
-							default:
-								// this will never happen, it would have
-								// been caught by the switch before the loops
-								break;
-							}
-							
-							int ci;
-							ci = chunkSections[i].getBlockState(x, y, z).getMaterial().getColor().colorValue;
-							
-							if (ci == 0) {
-								// skip air or invisible blocks
-								continue;
-							}
-							
-							Color c = intToColor(ci);
-							
-							red += c.getRed();
-							green += c.getGreen();
-							blue += c.getBlue();
-							
-							numbOfBlocks++;
-							
-							// we found a valid block, skip to the
-							// next x and z
-							foundBlock = true;
-						}
-					}
-				}
-				
-			}
-		}
-		
-		if(numbOfBlocks == 0)
-			numbOfBlocks = 1;
-		
-		red /= numbOfBlocks;
-		green /= numbOfBlocks;
-		blue /= numbOfBlocks;
-		
-		return new Color(red, green, blue);
-	}
-	
-	/**
-	 * Convert a BlockColors int into a Color object.
-	 */
-	private Color intToColor(int num)
-	{
-		int filter = 0b11111111;
-		
-		int red = (num >> 16 ) & filter;
-		int green = (num >> 8 ) & filter;
-		int blue = num & filter;
-		
-		return new Color(red, green, blue);
-	}
-	
-	/**
-	 * Convert a Color into a BlockColors object.
-	 */
-	@SuppressWarnings("unused")
-	private int colorToInt(Color color)
-	{
-		return color.getRGB();
-	}
-	
-	
-	
-	
-	//================//
-	// misc functions //
-	//================//
-	
-	/**
-	 * If this LOD is either invisible from every
-	 * direction or doesn't have a valid height 
-	 * it is empty.
-	 */
-	public boolean isLodEmpty()
-	{
-		for(LodCorner corner : LodCorner.values())
-			if(top[corner.value] != -1 || bottom[corner.value] != -1)
-				// at least one corner is valid
-				return false;
-		
-		Color invisible = new Color(0,0,0,0);
-		for(ColorDirection dir : ColorDirection.values())
-			if(!colors[dir.value].equals(invisible))
-				// at least one direction has a non-invisible color
-				return false;
-		
-		return true;
-	}
-	
-	
-	
-	
-	
-	//========//
-	// output //
-	//========//
-	
-	
-	
-	/**
-	 * Outputs all data in csv format
-	 * with the given delimiter.
-	 * <br>
-	 * Exports data in the form:
-	 * <br>
-	 * x, z, top data, bottom data, rgb color data
-	 * 
-	 * <br>
-	 * example output:
-	 * <br>
-	 * 5,8, 4,4,4,4, 0,0,0,0 255,255,255, 255,255,255, 255,255,255, 255,255,255, 255,255,255, 255,255,255,
-	 */
-	public String toData()
-	{
-		String s = "";
-		
-		s += Integer.toString(x) + DATA_DELIMITER +  Integer.toString(z) + DATA_DELIMITER;
-		
-		for(int i = 0; i < top.length; i++)
-		{
-			s += Short.toString(top[i]) + DATA_DELIMITER;
-		}
-		
-		for(int i = 0; i < bottom.length; i++)
-		{
-			s += Short.toString(bottom[i]) + DATA_DELIMITER;
-		}
-		
-		for(int i = 0; i < colors.length; i++)
-		{
-			s += Integer.toString(colors[i].getRed()) + DATA_DELIMITER + Integer.toString(colors[i].getGreen()) + DATA_DELIMITER + Integer.toString(colors[i].getBlue()) + DATA_DELIMITER;
-		}
-		
-		return s;
-	}
-	
-	
-	@Override
-	public String toString()
-	{
-		String s = "";
-		
-		s += "x: " + x + " z: " + z + "\t";
-		
-		s += "(" + colors[ColorDirection.TOP.value].getRed() + ", " + colors[ColorDirection.TOP.value].getGreen() + ", " + colors[ColorDirection.TOP.value].getBlue() + ")";
-		
-		return s;
-	}
-}
@@ -1,351 +0,0 @@
-package com.backsun.lod.objects;
-
-import com.backsun.lod.handlers.LodDimensionFileHandler;
-import com.backsun.lod.util.LodUtils;
-
-import net.minecraft.world.DimensionType;
-import net.minecraft.world.server.ServerChunkProvider;
-
-/**
- * This object holds all loaded LOD regions
- * for a given dimension.
- * 
- * @author James Seibel
- * @version 02-23-2021
- */
-public class LodDimension
-{
-	public final DimensionType dimension;
-	
-	private volatile int width;
-	private volatile int halfWidth;
-	
-	public LodRegion regions[][];
-	public boolean isRegionDirty[][];
-	
-	private int centerX;
-	private int centerZ;
-	
-	private LodDimensionFileHandler fileHandler;
-	
-	
-	public LodDimension(DimensionType newDimension, int newMaxWidth)
-	{
-		dimension = newDimension;
-		width = newMaxWidth;
-		
-		ServerChunkProvider provider = LodUtils.getServerWorldFromDimension(newDimension).getChunkProvider();
-		fileHandler = new LodDimensionFileHandler(provider.getSavedData().folder, this);
-		
-		regions = new LodRegion[width][width];
-		isRegionDirty = new boolean[width][width];
-		
-		// populate isRegionDirty
-		for(int i = 0; i < width; i++)
-			for(int j = 0; j < width; j++)
-				isRegionDirty[i][j] = false;
-		
-		centerX = 0;
-		centerZ = 0;
-		
-		halfWidth = (int)Math.floor(width / 2);
-	}
-	
-	
-	/**
-	 * Move the center of this LodDimension and move all owned
-	 * regions over by the given x and z offset.
-	 */
-	public void move(int xOffset, int zOffset)
-	{		
-		// if the x or z offset is equal to or greater than
-		// the total size, just delete the current data
-		// and update the centerX and/or centerZ
-		if (Math.abs(xOffset) >= width || Math.abs(zOffset) >= width)
-		{
-			for(int x = 0; x < width; x++)
-			{
-				for(int z = 0; z < width; z++)
-				{
-					regions[x][z] = null;
-				}
-			}
-			
-			// update the new center
-			centerX += xOffset;
-			centerZ += zOffset;
-			
-			return;
-		}
-		
-		
-		// X
-		if(xOffset > 0)
-		{
-			// move everything over to the left (as the center moves to the right)
-			for(int x = 0; x < width; x++)
-			{
-				for(int z = 0; z < width; z++)
-				{
-					if(x + xOffset < width)
-						regions[x][z] = regions[x + xOffset][z];
-					else
-						regions[x][z] = null;
-				}
-			}
-		}
-		else
-		{
-			// move everything over to the right (as the center moves to the left)
-			for(int x = width - 1; x >= 0; x--)
-			{
-				for(int z = 0; z < width; z++)
-				{
-					if(x + xOffset >= 0)
-						regions[x][z] = regions[x + xOffset][z];
-					else
-						regions[x][z] = null;
-				}
-			}
-		}
-		
-		
-		
-		// Z
-		if(zOffset > 0)
-		{
-			// move everything up (as the center moves down)
-			for(int x = 0; x < width; x++)
-			{
-				for(int z = 0; z < width; z++)
-				{
-					if(z + zOffset < width)
-						regions[x][z] = regions[x][z + zOffset];
-					else
-						regions[x][z] = null;
-				}
-			}
-		}
-		else
-		{
-			// move everything down (as the center moves up)
-			for(int x = 0; x < width; x++)
-			{
-				for(int z = width - 1; z >= 0; z--)
-				{
-					if(z + zOffset >= 0)
-						regions[x][z] = regions[x][z + zOffset];
-					else
-						regions[x][z] = null;
-				}
-			}
-		}
-		
-		
-		
-		// update the new center
-		centerX += xOffset;
-		centerZ += zOffset;
-	}
-	
-	
-	
-	
-	
-	
-	/**
-	 * Gets the region at the given X and Z
-	 * <br>
-	 * Returns null if the region doesn't exist
-	 * or is outside the loaded area.
-	 */
-	public LodRegion getRegion(int regionX, int regionZ)
-	{
-		int xIndex = (regionX - centerX) + halfWidth;
-		int zIndex = (regionZ - centerZ) + halfWidth;
-		
-		if (!regionIsInRange(regionX, regionZ))
-			// out of range
-			return null;
-		
-		if (regions[xIndex][zIndex] == null)
-		{
-			regions[xIndex][zIndex] = getRegionFromFile(regionX, regionZ);
-			if (regions[xIndex][zIndex] == null)
-			{
-				regions[xIndex][zIndex] = new LodRegion(regionX, regionZ);
-			}
-		}
-		
-		return regions[xIndex][zIndex];
-	}
-	
-	/**
-	 * Overwrite the LodRegion at the location of newRegion with newRegion.
-	 * @throws ArrayIndexOutOfBoundsException if newRegion is outside what can be stored in this LodDimension.
-	 */
-	public void setRegion(LodRegion newRegion) throws ArrayIndexOutOfBoundsException
-	{
-		int xIndex = (newRegion.x - centerX) + halfWidth;
-		int zIndex = (centerZ - newRegion.z) + halfWidth;
-		
-		if (!regionIsInRange(newRegion.x, newRegion.z))
-			// out of range
-			throw new ArrayIndexOutOfBoundsException();
-		
-		regions[xIndex][zIndex] = newRegion;
-	}
-	
-	
-	
-	
-	
-	/**
-	 * Add the given LOD to this dimension at the coordinate
-	 * stored in the LOD. If an LOD already exists at the given
-	 * coordinates it will be overwritten.
-	 */
-	public void addLod(LodChunk lod)
-	{
-		int regionX = lod.x / LodRegion.SIZE;
-		int regionZ = lod.z / LodRegion.SIZE;
-		
-		// prevent issues if X/Z is negative and less than 16
-		if (lod.x < 0)
-		{
-			regionX = (Math.abs(regionX) * -1) - 1; 
-		}
-		if (lod.z < 0)
-		{
-			regionZ = (Math.abs(regionZ) * -1) - 1; 
-		}
-		
-		// don't continue if the region can't be saved
-		if (!regionIsInRange(regionX, regionZ))
-			return;
-		
-		LodRegion region = getRegion(regionX, regionZ);
-		
-		if (region == null)
-		{
-			// if no region exists, create it
-			region = new LodRegion(regionX, regionZ);
-			setRegion(region);
-		}
-		
-		region.addLod(lod);
-		
-		// mark the region as dirty so it will be saved to disk
-		int xIndex = (regionX - centerX) + halfWidth;
-		int zIndex = (regionZ - centerZ) + halfWidth;
-		isRegionDirty[xIndex][zIndex] = true;
-		fileHandler.saveDirtyRegionsToFileAsync();
-	}
-	
-	/**
-	 * Get the LodChunk at the given X and Z coordinates
-	 * in this dimension.
-	 * <br>
-	 * Returns null if the LodChunk doesn't exist or 
-	 * is outside the loaded area.
-	 */
-	public LodChunk getLodFromCoordinates(int chunkX, int chunkZ)
-	{
-		int regionX = chunkX / LodRegion.SIZE;
-		int regionZ = chunkZ / LodRegion.SIZE;
-		
-		// prevent issues if chunkX/Z is negative and less than width
-		if (chunkX < 0)
-		{
-			regionX = (Math.abs(regionX) * -1) - 1; 
-		}
-		if (chunkZ < 0)
-		{
-			regionZ = (Math.abs(regionZ) * -1) - 1; 
-		}
-		
-		LodRegion region = getRegion(regionX, regionZ);
-		
-		if(region == null)
-			return null;
-		
-		return region.getLod(chunkX, chunkZ);
-	}
-	
-	
-	/**
-	 * Get the region at the given X and Z coordinates from the
-	 * RegionFileHandler.
-	 */
-	public LodRegion getRegionFromFile(int regionX, int regionZ)
-	{
-		return fileHandler.loadRegionFromFile(regionX, regionZ);
-	}
-	
-	
-	/**
-	 * Returns whether the region at the given X and Z coordinates
-	 * is within the loaded range.
-	 */
-	private boolean regionIsInRange(int regionX, int regionZ)
-	{
-		int xIndex = (regionX - centerX) + halfWidth;
-		int zIndex = (regionZ - centerZ) + halfWidth;
-		
-		return xIndex >= 0 && xIndex < width && zIndex >= 0 && zIndex < width;
-	}
-
-	
-	
-	
-	
-	
-
-	public int getCenterX()
-	{
-		return centerX;
-	}
-	
-	public int getCenterZ()
-	{
-		return centerZ;
-	}
-	
-	
-	
-	public int getWidth()
-	{
-		return width;
-	}
-	
-	public void setRegionWidth(int newWidth)
-	{
-		width = newWidth;
-		halfWidth = (int)Math.floor(width / 2);
-		
-		regions = new LodRegion[width][width];
-		isRegionDirty = new boolean[width][width];
-		
-		// populate isRegionDirty
-		for(int i = 0; i < width; i++)
-			for(int j = 0; j < width; j++)
-				isRegionDirty[i][j] = false;
-	}
-	
-	
-	@Override
-	public String toString()
-	{
-		String s = "";
-		
-		s += "dim: " + dimension.toString() + "\t";
-		s += "(" + centerX + "," + centerZ + ")";
-		
-		return s;
-	}
-}
-
-
-
-
-
@@ -1,90 +0,0 @@
-package com.backsun.lod.objects;
-
-/**
- * A LodRegion is the a 32x32
- * 2D array of LodChunk objects.
- * Each LodRegion corresponds to
- * one file in the file system.
- * 
- * @author James Seibel
- * @version 1-22-2021
- */
-public class LodRegion
-{
-	/** number of chunks wide */
-	public static final int SIZE = 32;
-	
-	/**	X coordinate of this region */
-	public final int x;
-	/** Z coordinate of this region */
-	public final int z;
-	
-	private LodChunk chunks[][];
-	
-	
-	public LodRegion(int regionX, int regionZ)
-	{
-		x = regionX;
-		z = regionZ;
-		
-		chunks = new LodChunk[SIZE][SIZE];
-	}
-	
-	
-	/**
-	 * Add the given LOD to this region at the coordinate
-	 * stored in the LOD. If an LOD already exists at the given
-	 * coordinates it will be overwritten.
-	 */
-	public void addLod(LodChunk lod)
-	{
-		// we use ABS since LODs can be negative, but if they are
-		// the region will negative first, therefore we don't have to
-		// store the LOD chunks at negative indexes since we search 
-		// LOD the region first
-		int xIndex = Math.abs(lod.x % SIZE);
-		int zIndex = Math.abs(lod.z % SIZE);
-		
-		chunks[xIndex][zIndex] = lod;
-	}
-	
-	/**
-	 * Get the LodChunk at the given X and Z coordinates
-	 * in this region.
-	 * <br>
-	 * Returns null if the LodChunk doesn't exist or 
-	 * is outside the loaded area.
-	 */
-	public LodChunk getLod(int chunkX, int chunkZ)
-	{
-		// since we add LOD's with ABS, we get them the same way
-		int arrayX = Math.abs(chunkX % SIZE);
-		int arrayZ = Math.abs(chunkZ % SIZE);
-		
-		if(arrayX >= SIZE || arrayZ >= SIZE)
-			return null;
-		
-		return chunks[arrayX][arrayZ];
-	}
-	
-	
-	/**
-	 * Returns all LodChunks in this region
-	 */
-	public LodChunk[][] getAllLods()
-	{
-		return chunks;
-	}
-	
-	
-	
-	@Override
-	public String toString()
-	{
-		String s = "";
-		
-		s += "x: " + x + " z: " + z + "\t";
-		
-		return s;
-	}
-}
@@ -1,65 +0,0 @@
-package com.backsun.lod.objects;
-
-import java.util.Hashtable;
-import java.util.Map;
-
-import net.minecraft.world.DimensionType;
-
-/**
- * This stores all LODs for a given world.
- * 
- * @author James Seibel
- * @version 02-22-2021
- */
-public class LodWorld
-{
-	public String worldName;
-	
-	/**
-	 * Key = Dimension id (as an int)
-	 */
-	private Map<DimensionType, LodDimension> lodDimensions;
-	
-	
-	public LodWorld(String newWorldName)
-	{
-		worldName = newWorldName;
-		lodDimensions = new Hashtable<DimensionType, LodDimension>();
-	}
-	
-	
-	
-	public void addLodDimension(LodDimension newStorage)
-	{
-		lodDimensions.put(newStorage.dimension, newStorage);
-	}
-	
-	public LodDimension getLodDimension(DimensionType dimension)
-	{
-		return lodDimensions.get(dimension);
-	}
-	
-	/**
-	 * Resizes the max width in regions that each LodDimension
-	 * should use. 
-	 */
-	public void resizeDimensionRegionWidth(int newWidth)
-	{
-		for(DimensionType key : lodDimensions.keySet())
-			lodDimensions.get(key).setRegionWidth(newWidth);
-	}
-	
-	
-	
-	@Override
-	public String toString()
-	{
-		String s = "";
-		
-		s += worldName + "\t - dimensions: ";
-		for(DimensionType key : lodDimensions.keySet())
-			s += lodDimensions.get(key).dimension.toString() + ", ";
-		
-		return s;
-	}
-}
@@ -1,25 +0,0 @@
-package com.backsun.lod.objects;
-
-import net.minecraft.client.renderer.BufferBuilder;
-
-/**
- * This object is just a replacement for an array
- * to make things easier to understand in the LodRenderer
- * and BuildBufferThread.
- * 
- * @author James Seibel
- * @version 02-21-2021
- */
-public class NearFarBuffer
-{
-	public BufferBuilder nearBuffer;
-	
-	public BufferBuilder farBuffer;
-	
-	
-	public NearFarBuffer(BufferBuilder newNearBuffer, BufferBuilder newFarBuffer)
-	{
-		nearBuffer = newNearBuffer;
-		farBuffer = newFarBuffer;
-	}
-}
@@ -1,28 +0,0 @@
-package com.backsun.lod.objects;
-
-import com.backsun.lod.util.enums.FogDistance;
-
-/**
- * This object is just a replacement for an array
- * to make things easier to understand in the LodRenderer.
- * 
- * @author James Seibel
- * @version 02-27-2021
- */
-public class NearFarFogSetting
-{
-	public FogDistance nearFogSetting = FogDistance.NEAR;
-	public FogDistance farFogSetting = FogDistance.FAR;
-	
-	
-	public NearFarFogSetting()
-	{
-		
-	}
-	
-	public NearFarFogSetting(FogDistance newNearFogSetting, FogDistance newFarFogSetting)
-	{
-		nearFogSetting = newNearFogSetting;
-		farFogSetting = newFarFogSetting;
-	}
-}
@@ -1,129 +0,0 @@
-package com.backsun.lod.proxy;
-
-import org.lwjgl.opengl.GL11;
-
-import com.backsun.lod.builders.LodBuilder;
-import com.backsun.lod.handlers.LodDimensionFileHandler;
-import com.backsun.lod.objects.LodChunk;
-import com.backsun.lod.objects.LodDimension;
-import com.backsun.lod.objects.LodRegion;
-import com.backsun.lod.objects.LodWorld;
-import com.backsun.lod.renderer.LodRenderer;
-import com.backsun.lod.renderer.RenderGlobalHook;
-import com.backsun.lod.util.LodConfig;
-
-import net.minecraft.client.Minecraft;
-import net.minecraft.world.chunk.Chunk;
-import net.minecraftforge.client.event.RenderWorldLastEvent;
-import net.minecraftforge.event.world.ChunkEvent;
-import net.minecraftforge.eventbus.api.SubscribeEvent;
-
-//TODO Find a way to replace getIntegratedServer so this mod could be used on non-local worlds.
-// Minecraft.getMinecraft().getIntegratedServer()
-
-/**
- * This handles all events sent to the client,
- * and is the starting point for most of this program.
- * 
- * @author James_Seibel
- * @version 02-23-2021
- */
-public class ClientProxy
-{
-	private LodRenderer renderer;
-	private LodWorld lodWorld;
-	private LodBuilder lodBuilder;
-	Minecraft mc = Minecraft.getInstance();
-	
-	public ClientProxy()
-	{
-		lodBuilder = new LodBuilder();
-		renderer = new LodRenderer();
-	}
-	
-	
-	
-	
-	//==============//
-	// render event //
-	//==============//
-	
-	@SubscribeEvent
-	public void renderWorldLast(RenderWorldLastEvent event)
-	{
-		RenderGlobalHook.endRenderingStencil();
-		GL11.glStencilFunc(GL11.GL_EQUAL, 0, 0xFF);
-		
-		if (LodConfig.CLIENT.drawLODs.get())
-			renderLods(event.getPartialTicks());
-		
-		GL11.glDisable(GL11.GL_STENCIL_TEST);
-	}
-	
-	/**
-	 * Do any setup that is required to draw LODs
-	 * and then tell the LodRenderer to draw.
-	 */
-	public void renderLods(float partialTicks)
-	{
-		// update the 
-		int newWidth = Math.max(4, (mc.gameSettings.renderDistanceChunks * LodChunk.WIDTH * 2) / LodRegion.SIZE);
-		if (lodWorld != null && lodBuilder.regionWidth != newWidth)
-		{
-			lodWorld.resizeDimensionRegionWidth(newWidth);
-			lodBuilder.regionWidth = newWidth;
-			
-			// skip this frame, hopefully the lodWorld
-			// should have everything set up by then
-			return;
-		}
-		
-		// are we still in the same world?
-		if (!lodWorld.worldName.equals(LodDimensionFileHandler.getCurrentWorldID()))
-			// no, don't render the wrong world
-			return;
-		
-		
-		if (mc == null || mc.player == null || lodWorld == null)
-			return;
-		
-		LodDimension lodDim = lodWorld.getLodDimension(mc.player.world.getDimensionType());
-		if (lodDim == null)
-			return;
-		
-		
-		
-		// offset the regions
-		double playerX = mc.player.getPosX();
-		double playerZ = mc.player.getPosZ();
-		
-		int xOffset = ((int)playerX / (LodChunk.WIDTH * LodRegion.SIZE)) - lodDim.getCenterX();
-		int zOffset = ((int)playerZ / (LodChunk.WIDTH * LodRegion.SIZE)) - lodDim.getCenterZ();
-		
-		if (xOffset != 0 || zOffset != 0)
-		{
-			lodDim.move(xOffset, zOffset);
-		}
-		
-		
-		
-		renderer.drawLODs(lodDim, partialTicks, mc.getProfiler());
-	}	
-	
-	
-	
-	
-	
-	//=====================//
-	// lod creation events //
-	//=====================//
-	
-	@SubscribeEvent
-	public void chunkLoadEvent(ChunkEvent.Load event)
-	{
-		if (event.getChunk().getClass() == Chunk.class)
-			lodWorld = lodBuilder.generateLodChunkAsync((Chunk) event.getChunk());
-	}
-	
-	
-}
@@ -1,828 +0,0 @@
-package com.backsun.lod.renderer;
-
-import java.awt.Color;
-import java.nio.ByteBuffer;
-import java.nio.ByteOrder;
-import java.nio.FloatBuffer;
-import java.util.concurrent.ExecutorService;
-import java.util.concurrent.Executors;
-
-import org.lwjgl.opengl.GL11;
-
-import com.backsun.lod.builders.LodBufferBuilder;
-import com.backsun.lod.handlers.ReflectionHandler;
-import com.backsun.lod.objects.LodChunk;
-import com.backsun.lod.objects.LodDimension;
-import com.backsun.lod.objects.NearFarBuffer;
-import com.backsun.lod.objects.NearFarFogSetting;
-import com.backsun.lod.util.LodConfig;
-import com.backsun.lod.util.enums.ColorDirection;
-import com.backsun.lod.util.enums.FogDistance;
-import com.backsun.lod.util.enums.FogQuality;
-import com.backsun.lod.util.enums.LodCorner;
-import com.mojang.blaze3d.matrix.MatrixStack;
-import com.mojang.blaze3d.platform.GlStateManager;
-import com.mojang.blaze3d.systems.RenderSystem;
-
-import net.minecraft.client.Minecraft;
-import net.minecraft.client.entity.player.ClientPlayerEntity;
-import net.minecraft.client.renderer.ActiveRenderInfo;
-import net.minecraft.client.renderer.BufferBuilder;
-import net.minecraft.client.renderer.FogRenderer;
-import net.minecraft.client.renderer.GameRenderer;
-import net.minecraft.client.renderer.vertex.DefaultVertexFormats;
-import net.minecraft.client.renderer.vertex.VertexBuffer;
-import net.minecraft.client.renderer.vertex.VertexFormat;
-import net.minecraft.potion.Effects;
-import net.minecraft.profiler.IProfiler;
-import net.minecraft.util.math.AxisAlignedBB;
-import net.minecraft.util.math.MathHelper;
-import net.minecraft.util.math.vector.Matrix4f;
-import net.minecraft.util.math.vector.Vector3d;
-import net.minecraft.util.math.vector.Vector3f;
-
-
-/**
- * This is where all the magic happens.
- * This is where LODs are draw to the world. 
- * 
- * @author James Seibel
- * @version 2-27-2021
- */
-public class LodRenderer
-{
-	/** this is the light used when rendering the LODs,
-	 * it should be something different than what is used by Minecraft */
-	private static final int LOD_GL_LIGHT_NUMBER = GL11.GL_LIGHT2;
-
-	/** If true the LODs colors will be replaced with
-	 * a checkerboard, this can be used for debugging. */
-	public boolean debugging = false;
-	
-	private Minecraft mc;
-	private GameRenderer gameRender;
-	private IProfiler profiler;
-	private float farPlaneDistance;
-	/** this is the radius of the LODs */
-	private static final int LOD_CHUNK_DISTANCE_RADIUS = 6;
-	
-	private ReflectionHandler reflectionHandler;
-	
-	public LodDimension lodDimension = null;
-	
-	
-	/** This is used to generate the buildable buffers */
-	private LodBufferBuilder lodBufferBuilder = null;
-	
-	/** The buffers that are used to draw LODs using near fog */
-	private volatile BufferBuilder drawableNearBuffer = null;
-	/** The buffers that are used to draw LODs using far fog */
-	private volatile BufferBuilder drawableFarBuffer = null;
-	
-	/** The buffers that are used to create LODs using near fog */
-	private volatile BufferBuilder buildableNearBuffer = null;
-	/** The buffers that are used to create LODs using far fog */
-	private volatile BufferBuilder buildableFarBuffer = null;
-	
-	/** This is the VertexBuffer used to draw any LODs that use near fog */
-	private volatile VertexBuffer nearVbo = null;
-	/** This is the VertexBuffer used to draw any LODs that use far fog */
-	private volatile VertexBuffer farVbo = null;
-	public static final VertexFormat LOD_VERTEX_FORMAT = DefaultVertexFormats.POSITION_COLOR;
-	
-	/** This holds the thread used to generate new LODs off the main thread. */
-	private ExecutorService genThread = Executors.newSingleThreadExecutor();
-	
-	/** This is used to determine if the LODs should be regenerated */
-	private int previousChunkRenderDistance = 0;
-	/** This is used to determine if the LODs should be regenerated */
-	private int prevChunkX = 0;
-	/** This is used to determine if the LODs should be regenerated */
-	private int prevChunkZ = 0;
-	/** This is used to determine if the LODs should be regenerated */
-	private FogDistance prevFogDistance = FogDistance.NEAR_AND_FAR;
-	
-	/** if this is true the LOD buffers should be regenerated,
-	 * provided they aren't already being regenerated. */
-	private boolean regen = false;
-	/** if this is true the LOD buffers are currently being
-	 * regenerated. */
-	private volatile boolean regenerating = false;
-	/** if this is true new LOD buffers have been generated 
-	 * and are waiting to be swapped with the drawable buffers*/
-	private volatile boolean switchBuffers = false;
-	
-	
-	
-	
-	
-	
-	public LodRenderer()
-	{
-		mc = Minecraft.getInstance();
-		gameRender = mc.gameRenderer;
-		
-		reflectionHandler = new ReflectionHandler();
-	}
-	
-	
-	/**
-	 * Besides drawing the LODs this method also starts
-	 * the async process of generating the Buffers that hold those LODs.
-	 * 
-	 * @param newDimension The dimension to draw, if null doesn't replace the current dimension.
-	 * @param partialTicks how far into the current tick this method was called.
-	 */
-	public void drawLODs(LodDimension newDimension, float partialTicks, IProfiler newProfiler)
-	{		
-		if (lodDimension == null && newDimension == null)
-		{
-			// if there aren't any loaded LodChunks
-			// don't try drawing anything
-			return;
-		}
-		
-		
-		
-		
-		
-		
-		//===============//
-		// initial setup //
-		//===============//
-		
-		
-		// used for debugging and viewing how long different processes take
-		profiler = newProfiler;
-		profiler.endSection();
-		profiler.startSection("LOD");
-		profiler.startSection("LOD setup");
-		
-		ClientPlayerEntity player = mc.player;
-		
-		// should LODs be regenerated?
-		if ((int)player.getPosX() / LodChunk.WIDTH != prevChunkX ||
-			(int)player.getPosZ() / LodChunk.WIDTH != prevChunkZ ||
-			previousChunkRenderDistance != mc.gameSettings.renderDistanceChunks ||
-			prevFogDistance != LodConfig.CLIENT.fogDistance.get() ||
-			lodDimension != newDimension)
-		{
-			// yes
-			regen = true;
-			
-			prevChunkX = (int)player.getPosX() / LodChunk.WIDTH;
-			prevChunkZ = (int)player.getPosZ() / LodChunk.WIDTH;
-			prevFogDistance = LodConfig.CLIENT.fogDistance.get();
-		}
-		else
-		{
-			// nope, the player hasn't moved, the
-			// render distance hasn't changed, and
-			// the dimension is the same
-		}
-		
-		lodDimension = newDimension;
-		if (lodDimension == null)
-		{
-			// if there aren't any loaded LodChunks
-			// don't try drawing anything
-			return;
-		}
-		
-		if (LodConfig.CLIENT.drawCheckerBoard.get())
-		{
-			if (debugging != LodConfig.CLIENT.drawCheckerBoard.get())
-				regen = true;
-			debugging = true;
-		}
-		else
-		{
-			if (debugging != LodConfig.CLIENT.drawCheckerBoard.get())
-				regen = true;
-			debugging = false;
-		}
-		
-		
-		
-		// determine how far the game's render distance is currently set
-		int renderDistWidth = mc.gameSettings.renderDistanceChunks;
-		farPlaneDistance = renderDistWidth * LodChunk.WIDTH;
-		
-		// set how big the LODs will be and how far they will go
-		int totalLength = (int) farPlaneDistance * LOD_CHUNK_DISTANCE_RADIUS * 2;
-		int numbChunksWide = (totalLength / LodChunk.WIDTH);
-		
-		
-		
-		
-		
-		
-		//=================//
-		// create the LODs //
-		//=================//
-		
-		// only regenerate the LODs if:
-		// 1. we want to regenerate LODs
-		// 2. we aren't already regenerating the LODs
-		// 3. we aren't waiting for the build and draw buffers to swap
-		//		(this is to prevent thread conflicts)
-		if (regen && !regenerating && !switchBuffers)
-		{
-			regenerating = true;
-			
-			if (lodBufferBuilder == null)
-				lodBufferBuilder = new LodBufferBuilder();
-			
-			// this will mainly happen when the view distance is changed
-			if (drawableNearBuffer == null || drawableFarBuffer == null || 
-				previousChunkRenderDistance != mc.gameSettings.renderDistanceChunks)
-				setupBuffers(numbChunksWide);
-			
-			// generate the LODs on a separate thread to prevent stuttering or freezing
-			generateLodBuffersAsync(player.getPosX(), player.getPosZ(), numbChunksWide);
-			
-			// the regen process has been started
-			regen = false;
-		}
-		
-		// replace the buffers used to draw and build,
-		// this is only done when the createLodBufferGenerationThread
-		// has finished executing on a parallel thread.
-		if (switchBuffers)
-		{
-			swapBuffers();
-			switchBuffers = false;
-		}
-		
-		
-		
-		
-		
-		//===========================//
-		// GL settings for rendering //
-		//===========================//
-		
-		// set the required open GL settings
-		GL11.glPolygonMode(GL11.GL_FRONT_AND_BACK, GL11.GL_FILL);
-		GL11.glBlendFunc(GL11.GL_SRC_ALPHA, GL11.GL_ONE_MINUS_SRC_ALPHA);
-		GL11.glDisable(GL11.GL_TEXTURE_2D);
-		GL11.glEnable(GL11.GL_CULL_FACE);
-		GL11.glEnable(GL11.GL_COLOR_MATERIAL);
-		GL11.glEnable(GL11.GL_DEPTH_TEST);
-		
-		Matrix4f modelViewMatrix = generateModelViewMatrix(partialTicks);
-		
-		setupProjectionMatrix(partialTicks);
-		setupLighting(partialTicks);
-		
-		NearFarFogSetting fogSetting = determineFogSettings();
-
-
-		
-		
-		
-		
-		
-		
-		//===========//
-		// rendering //
-		//===========//
-		
-		setupFog(fogSetting.nearFogSetting, reflectionHandler.getFogQuality());
-		sendLodsToGpuAndDraw(nearVbo, modelViewMatrix);
-		
-		setupFog(fogSetting.farFogSetting, reflectionHandler.getFogQuality());
-		sendLodsToGpuAndDraw(farVbo, modelViewMatrix);
-		
-		
-		
-		//=========//
-		// cleanup //
-		//=========//
-		
-		profiler.endStartSection("LOD cleanup");
-		
-		// this must be done otherwise other parts of the screen may be drawn with a fog effect
-		// IE the GUI
-		FogRenderer.resetFog();
-		RenderSystem.disableFog();
-		
-		GL11.glPolygonMode(GL11.GL_FRONT_AND_BACK, GL11.GL_FILL);
-		GL11.glEnable(GL11.GL_TEXTURE_2D);
-		GL11.glDisable(LOD_GL_LIGHT_NUMBER);
-		
-		// this can't be called until after the buffers are built
-		// because otherwise the buffers may be set to the wrong size
-		previousChunkRenderDistance = mc.gameSettings.renderDistanceChunks;
-		
-		
-		// end of profiler tracking
-		profiler.endSection();
-	}
-	
-	
-	/**
-	 * Create the model view matrix to move the LODs
-	 * from object space into world space.
-	 */
-	private Matrix4f generateModelViewMatrix(float partialTicks)
-	{
-		// get all relevant camera info
-		ActiveRenderInfo renderInfo = mc.gameRenderer.getActiveRenderInfo();
-        Vector3d projectedView = renderInfo.getProjectedView();
-		
-		
-		// generate the model view matrix
-		MatrixStack matrixStack = new MatrixStack();
-        matrixStack.push();
-        // translate and rotate to the current camera location
-        matrixStack.rotate(Vector3f.XP.rotationDegrees(renderInfo.getPitch()));
-        matrixStack.rotate(Vector3f.YP.rotationDegrees(renderInfo.getYaw() + 180));
-        matrixStack.translate(-projectedView.x, -projectedView.y, -projectedView.z);
-        
-        return matrixStack.getLast().getMatrix();
-	}
-
-
-	/**
-	 * This is where the actual drawing happens.
-	 * 
-	 * @param buffers the buffers sent to the GPU to draw
-	 */
-	private void sendLodsToGpuAndDraw(VertexBuffer vbo, Matrix4f modelViewMatrix)
-	{
-		if (vbo == null)
-			return;
-		
-		profiler.endStartSection("LOD draw setup");
-        vbo.bindBuffer();
-        // 0L is the starting pointer, and the value doesn't appear to matter
-        LOD_VERTEX_FORMAT.setupBufferState(0L);
-        
-        profiler.endStartSection("LOD draw");
-        vbo.draw(modelViewMatrix, GL11.GL_QUADS);
-        
-        profiler.endStartSection("LOD draw cleanup");
-        VertexBuffer.unbindBuffer();
-        LOD_VERTEX_FORMAT.clearBufferState();
-	}
-	
-	
-	
-	
-	
-	
-	
-	//=================//
-	// Setup Functions //
-	//=================//
-	
-	@SuppressWarnings("deprecation")
-	private void setupFog(FogDistance fogDistance, FogQuality fogQuality)
-	{
-		if(fogQuality == FogQuality.OFF)
-		{
-			FogRenderer.resetFog();
-			RenderSystem.disableFog();
-			return;
-		}
-		
-		if(fogDistance == FogDistance.NEAR_AND_FAR)
-		{
-			throw new IllegalArgumentException("setupFog doesn't accept the NEAR_AND_FAR fog distance.");
-		}
-
-		// the multipliers are percentages
-		// of the regular view distance.
-		
-		if(fogDistance == FogDistance.NEAR)
-		{
-			// the reason that I wrote fogEnd then fogStart backwards
-			// is because we are using fog backwards to how
-			// it is normally used, with it hiding near objects
-			// instead of far objects.
-			
-			if (fogQuality == FogQuality.FANCY)
-			{
-				RenderSystem.fogEnd(farPlaneDistance * 0.3f * LOD_CHUNK_DISTANCE_RADIUS);
-				RenderSystem.fogStart(farPlaneDistance * 0.35f * LOD_CHUNK_DISTANCE_RADIUS);
-			}
-			else if(fogQuality == FogQuality.FAST)
-			{
-				// for the far fog of the normal chunks
-				// to start right where the LODs' end use:
-				// end = 0.8f, start = 1.5f
-				
-				RenderSystem.fogEnd(farPlaneDistance * 1.5f);
-				RenderSystem.fogStart(farPlaneDistance * 2.0f);
-			}
-		}
-		else if(fogDistance == FogDistance.FAR)
-		{
-			if (fogQuality == FogQuality.FANCY)
-			{
-				RenderSystem.fogStart(farPlaneDistance * 0.78f * LOD_CHUNK_DISTANCE_RADIUS);
-				RenderSystem.fogEnd(farPlaneDistance * 1.0f * LOD_CHUNK_DISTANCE_RADIUS);
-			}
-			else if(fogQuality == FogQuality.FAST)
-			{
-				RenderSystem.fogStart(farPlaneDistance * 0.5f * LOD_CHUNK_DISTANCE_RADIUS);
-				RenderSystem.fogEnd(farPlaneDistance * 0.75f * LOD_CHUNK_DISTANCE_RADIUS);
-			}
-		}
-		
-		RenderSystem.fogMode(GlStateManager.FogMode.LINEAR);
-		RenderSystem.enableFog();
-	}
-	
-
-	/**
-	 * create a new projection matrix and send it over to the GPU
-	 * <br><br>
-	 * A lot of this code is copied from renderWorld (line 578)
-	 * in the GameRender class. The code copied is anything with
-	 * a matrixStack and is responsible for making sure the LOD
-	 * objects distort correctly relative to the rest of the world.
-	 * Distortions are caused by: standing in a nether portal,
-	 * nausea potion effect, walking bobbing.
-	 * 
-	 * @param partialTicks how many ticks into the frame we are
-	 */
-	private void setupProjectionMatrix(float partialTicks)
-	{
-		// Note: if the LOD objects don't distort correctly
-		// compared to regular minecraft terrain, make sure
-		// all the transformations in renderWorld are here too
-		
-		MatrixStack matrixStack = new MatrixStack();
-        matrixStack.push();
-		
-		gameRender.hurtCameraEffect(matrixStack, partialTicks);
-		if (this.mc.gameSettings.viewBobbing) {
-			gameRender.applyBobbing(matrixStack, partialTicks);
-		}
-		
-		// potion and nausea effects
-		float f = MathHelper.lerp(partialTicks, mc.player.prevTimeInPortal, mc.player.timeInPortal) * mc.gameSettings.screenEffectScale * mc.gameSettings.screenEffectScale;
-		if (f > 0.0F) {
-			int i = this.mc.player.isPotionActive(Effects.NAUSEA) ? 7 : 20;
-			float f1 = 5.0F / (f * f + 5.0F) - f * 0.04F;
-			f1 = f1 * f1;
-			Vector3f vector3f = new Vector3f(0.0F, MathHelper.SQRT_2 / 2.0F, MathHelper.SQRT_2 / 2.0F);
-			matrixStack.rotate(vector3f.rotationDegrees((gameRender.rendererUpdateCount + partialTicks) * i));
-			matrixStack.scale(1.0F / f1, 1.0F, 1.0F);
-			float f2 = -(gameRender.rendererUpdateCount + partialTicks) * i;
-			matrixStack.rotate(vector3f.rotationDegrees(f2));
-		}
-		
-		
-		
-		// this projection matrix allows us to see past the normal 
-		// world render distance
-		Matrix4f projectionMatrix = 
-				Matrix4f.perspective(
-				getFov(partialTicks, true), 
-				(float)this.mc.getMainWindow().getFramebufferWidth() / (float)this.mc.getMainWindow().getFramebufferHeight(), 
-				0.5F, 
-				this.farPlaneDistance * LOD_CHUNK_DISTANCE_RADIUS * 2);
-		
-		// add the screen space distortions
-		projectionMatrix.mul(matrixStack.getLast().getMatrix());
-		gameRender.resetProjectionMatrix(projectionMatrix);
-		return;
-	}
-	
-	
-	/**
-	 * setup the lighting to be used for the LODs
-	 */
-	private void setupLighting(float partialTicks)
-	{
-		float sunBrightness = lodDimension.dimension.hasSkyLight() ? mc.world.getSunBrightness(partialTicks) : 0.2f;
-		float gammaMultiplyer = (float)mc.gameSettings.gamma - 0.5f;
-		float lightStrength = sunBrightness - 0.7f + (gammaMultiplyer * 0.2f);
-		
-		float lightAmbient[] = {lightStrength, lightStrength, lightStrength, 1.0f};
-		
-		ByteBuffer temp = ByteBuffer.allocateDirect(16);
-		temp.order(ByteOrder.nativeOrder());
-		GL11.glLightfv(LOD_GL_LIGHT_NUMBER, GL11.GL_AMBIENT, (FloatBuffer) temp.asFloatBuffer().put(lightAmbient).flip());
-		GL11.glEnable(LOD_GL_LIGHT_NUMBER); // Enable the above lighting
-		
-		RenderSystem.enableLighting();
-	}
-	
-	/**
-	 * Create all buffers that will be used.
-	 */
-	private void setupBuffers(int numbChunksWide)
-	{
-		// calculate the max amount of storage needed (in bytes)
-		int bufferMaxCapacity = (numbChunksWide * numbChunksWide * (6 * 4 * (3 + 4)));
-		// (numbChunksWide * numbChunksWide * 
-		// (sidesOnACube * pointsInASquare * (positionPoints + colorPoints)))
-		
-		// TODO complain or do something when memory is too low
-		// currently the VM will just crash and complain there is no more memory
-		// issue #4
-		drawableNearBuffer = new BufferBuilder(bufferMaxCapacity);
-		drawableFarBuffer = new BufferBuilder(bufferMaxCapacity);
-		
-		buildableNearBuffer = new BufferBuilder(bufferMaxCapacity);
-		buildableFarBuffer = new BufferBuilder(bufferMaxCapacity);
-	}
-	
-	
-	
-	
-	
-	
-	
-	//======================//
-	// Other Misc Functions // 
-	//======================//
-	
-	
-	/**
-	 * @Returns -1 if there are no valid points
-	 */
-	private int getValidHeightPoint(short[] heightPoints)
-	{
-		if (heightPoints[LodCorner.NE.value] != -1)
-			return heightPoints[LodCorner.NE.value];
-		if (heightPoints[LodCorner.NW.value] != -1)
-			return heightPoints[LodCorner.NW.value];
-		if (heightPoints[LodCorner.SE.value] != -1)
-			return heightPoints[LodCorner.NE.value];
-		return heightPoints[LodCorner.NE.value];
-	}
-	
-	
-	/**
-	 * Create a thread to asynchronously generate LOD buffers
-	 * centered around the given camera X and Z.
-	 * <br>
-	 * This thread will write to the drawableNearBuffers and drawableFarBuffers.
-	 * <br>
-	 * After the buildable buffers have been generated they must be
-	 * swapped with the drawable buffers to be drawn.
-	 */
-	private void generateLodBuffersAsync(double playerX, double playerZ,
-			int numbChunksWide)
-	{
-		// this is where we store the points for each LOD object
-		AxisAlignedBB lodArray[][] = new AxisAlignedBB[numbChunksWide][numbChunksWide];
-		// this is where we store the color for each LOD object
-		Color colorArray[][] = new Color[numbChunksWide][numbChunksWide];
-		
-		int alpha = 255; // 0 - 255
-		Color red = new Color(255, 0, 0, alpha);
-		Color black = new Color(0, 0, 0, alpha);
-		Color white = new Color(255, 255, 255, alpha);
-		@SuppressWarnings("unused")
-		Color invisible = new Color(0,0,0,0);
-		@SuppressWarnings("unused")
-		Color error = new Color(255, 0, 225, alpha); // bright pink
-		
-		// this seemingly useless math is required,
-		// just using (int) camera doesn't work
-		int playerXChunkOffset = ((int) playerX / LodChunk.WIDTH) * LodChunk.WIDTH;
-		int playerZChunkOffset = ((int) playerZ / LodChunk.WIDTH) * LodChunk.WIDTH;
-		// this is where we will start drawing squares
-		// (exactly half the total width)
-		int startX = (-LodChunk.WIDTH * (numbChunksWide / 2)) + playerXChunkOffset;
-		int startZ = (-LodChunk.WIDTH * (numbChunksWide / 2)) + playerZChunkOffset;
-		
-		Thread t = new Thread(()->
-		{
-			// x axis
-			for (int i = 0; i < numbChunksWide; i++)
-			{
-				// z axis
-				for (int j = 0; j < numbChunksWide; j++)
-				{
-					// skip the middle
-					// (As the player moves some chunks will overlap or be missing,
-					// this is just how chunk loading/unloading works. This can hopefully
-					// be hidden with careful use of fog)
-					int middle = (numbChunksWide / 2);
-					if (isCoordInCenterArea(i, j, middle))
-					{
-						continue;
-					}
-					
-					
-					// set where this square will be drawn in the world
-					double xOffset = (LodChunk.WIDTH * i) + // offset by the number of LOD blocks
-									startX; // offset so the center LOD block is centered underneath the player
-					double yOffset = 0;
-					double zOffset = (LodChunk.WIDTH * j) + startZ;
-					
-					int chunkX = i + (startX / LodChunk.WIDTH);
-					int chunkZ = j + (startZ / LodChunk.WIDTH);
-					
-					LodChunk lod = lodDimension.getLodFromCoordinates(chunkX, chunkZ);
-					if (lod == null)
-					{
-						// note: for some reason if any color or lod objects are set here
-						// it causes the game to use 100% gpu; 
-						// undefined in the debug menu
-						// and drop to ~6 fps.
-						colorArray[i][j] = null;
-						lodArray[i][j] = null;
-						
-						// This is something I would like to have done someday
-						// but currently world generation is too slow to have it
-						// here, maybe it could be put in a loop 
-						// that happens every tick for a specific number of chunks?
-//						LodChunk tmpLod = new LodChunk();
-//						tmpLod.x = chunkX;
-//						tmpLod.z = chunkZ;
-//						lodDimension.addLod(tmpLod);
-//						
-//						world.getChunkProvider().getChunk(chunkX, chunkZ, true);
-//						System.out.println(chunkX + "," + chunkZ);
-						
-						continue;
-					}
-					
-					
-					Color c = new Color(
-							(lod.colors[ColorDirection.TOP.value].getRed()),
-							(lod.colors[ColorDirection.TOP.value].getGreen()),
-							(lod.colors[ColorDirection.TOP.value].getBlue()),
-							lod.colors[ColorDirection.TOP.value].getAlpha());
-										
-					if (!debugging)
-					{
-						// add the color to the array
-						colorArray[i][j] = c;
-					}
-					else
-					{
-						// if debugging draw the squares as a black and white checker board
-						if ((chunkX + chunkZ) % 2 == 0)
-							c = white;
-						else
-							c = black;
-						// draw the first square as red
-						if (i == 0 && j == 0)
-							c = red;
-						
-						colorArray[i][j] = c;
-					}
-					
-					
-					// add the new box to the array
-					int topPoint = getValidHeightPoint(lod.top);
-					int bottomPoint = getValidHeightPoint(lod.bottom);
-					
-					// don't draw an LOD if it is empty
-					if (topPoint == -1 && bottomPoint == -1)
-						continue;
-					
-					lodArray[i][j] = new AxisAlignedBB(0, bottomPoint, 0, LodChunk.WIDTH, topPoint, LodChunk.WIDTH).offset(xOffset, yOffset, zOffset);
-				}
-			}
-			
-			// generate our new buildable buffers
-			NearFarBuffer nearFarBuffers = lodBufferBuilder.createBuffers(
-					buildableNearBuffer, buildableFarBuffer, 
-					LodConfig.CLIENT.fogDistance.get(), lodArray, colorArray);
-			
-			// update our buffers
-			buildableNearBuffer = nearFarBuffers.nearBuffer;
-			buildableFarBuffer = nearFarBuffers.farBuffer;
-			
-			// mark the buildable buffers as ready to swap
-			regenerating = false;
-			switchBuffers = true;
-		});
-		
-		genThread.execute(t);
-		
-		return;
-	}
-	
-	
-	
-	/**
-	 * Swap buildable and drawable buffers.
-	 */
-	private void swapBuffers()
-	{
-		// swap the BufferBuilders
-		BufferBuilder tmp = buildableNearBuffer;
-		buildableNearBuffer = drawableNearBuffer;
-		drawableNearBuffer = tmp;
-		
-		tmp = buildableFarBuffer;
-		buildableFarBuffer = drawableFarBuffer;
-		drawableFarBuffer = tmp;
-		
-		
-		// bind the buffers with their respective VBOs
-		if (nearVbo != null)
-			nearVbo.close();
-		
-		nearVbo = new VertexBuffer(LOD_VERTEX_FORMAT);
-		nearVbo.upload(drawableNearBuffer);
-		
-		
-		if (farVbo != null)
-			farVbo.close();
-		
-		farVbo = new VertexBuffer(LOD_VERTEX_FORMAT);
-		farVbo.upload(drawableFarBuffer);
-	}
-	
-	
-	/**
-	 * Returns if the given coordinate is in the loaded area of the world.
-	 * @param centerCoordinate the center of the loaded world
-	 */
-	private boolean isCoordInCenterArea(int i, int j, int centerCoordinate)
-	{
-		return (i >= centerCoordinate - mc.gameSettings.renderDistanceChunks
-				&& i <= centerCoordinate + mc.gameSettings.renderDistanceChunks) 
-				&& 
-				(j >= centerCoordinate - mc.gameSettings.renderDistanceChunks
-				&& j <= centerCoordinate + mc.gameSettings.renderDistanceChunks);
-	}
-	
-	
-	public double getFov(float partialTicks, boolean useFovSetting)
-	{
-		return mc.gameRenderer.getFOVModifier(mc.gameRenderer.getActiveRenderInfo(), partialTicks, useFovSetting);
-	}
-	
-	
-	/**
-	 * Based on the fogDistance setting and
-	 * optifine's fogQuality setting return what fog
-	 * settings should be used when rendering.
-	 */
-	private NearFarFogSetting determineFogSettings()
-	{
-		NearFarFogSetting fogSetting = new NearFarFogSetting();
-		
-		LodConfig.CLIENT.fogDistance.get();
-		switch(reflectionHandler.getFogQuality())
-		{
-		case FANCY:
-			
-			switch(LodConfig.CLIENT.fogDistance.get())
-			{
-			case NEAR_AND_FAR:
-				fogSetting.nearFogSetting = FogDistance.NEAR;
-				fogSetting.farFogSetting = FogDistance.FAR;
-				break;
-				
-			case NEAR:
-				fogSetting.nearFogSetting = FogDistance.NEAR;
-				fogSetting.farFogSetting = FogDistance.NEAR;
-				break;
-				
-			case FAR:
-				fogSetting.nearFogSetting = FogDistance.FAR;
-				fogSetting.farFogSetting = FogDistance.FAR;
-				break;
-			}
-			
-			break;
-		case FAST:
-			// fast fog setting should only have one type of
-			// fog, since the LODs are separated into a near
-			// and far portion; and fast fog is rendered from the
-			// frustrum's perspective instead of the camera
-			
-			switch(LodConfig.CLIENT.fogDistance.get())
-			{
-			case NEAR_AND_FAR:
-				fogSetting.nearFogSetting = FogDistance.NEAR;
-				fogSetting.farFogSetting = FogDistance.NEAR;
-				break;
-				
-			case NEAR:
-				fogSetting.nearFogSetting = FogDistance.NEAR;
-				fogSetting.farFogSetting = FogDistance.NEAR;
-				break;
-				
-			case FAR:
-				fogSetting.nearFogSetting = FogDistance.FAR;
-				fogSetting.farFogSetting = FogDistance.FAR;
-				break;
-			}
-			
-			break;
-		case OFF:
-			break;
-		
-		}
-		
-		return fogSetting;
-	}
-	
-	
-	
-}
@@ -1,82 +0,0 @@
-package com.backsun.lod.renderer;
-
-
-import org.lwjgl.opengl.GL11;
-
-import net.minecraft.client.renderer.RenderType;
-
-/**
- * This code is used for drawing 
- * to the stencil buffer.
- * 
- * @author James Seibel
- * @version 02-17-2021
- */
-public class RenderGlobalHook
-{
-	/** 
-	 * this variable should be the same as the method name below.
-	 * It is used when transforming the RenderGlobal class' 
-	 * renderBlockLayer method.
-	 */
-	public static final String START_STENCIL_METHOD_NAME = "startRenderingStencil";
-	
-	/**
-	 * This method tells OpenGL to start drawing everything to the stencil.
-	 * This is done to prevent LODs from being rendered on top of the world.
-	 * <br><br>
-	 * Called in the order (as of minecraft 1.16.4): <br>
-	 * RenderType.getSolid() <br>
-	 * RenderType.getCutoutMipped() <br>
-	 * RenderType.getCutout() <br>
-	 * RenderType.getTranslucent() <br>
-	 * RenderType.getTripwire() <br>
-	 */
-	public static void startRenderingStencil(RenderType blockLayerIn)
-	{
-		// we only enable drawing to the stencil once since
-		// we want to skip the rendering of the out of world fog
-		// but catch everything else
-		if (blockLayerIn == RenderType.getSolid())
-		{
-			// solid is the first layer rendered
-			// clear the buffer so we can start fresh.
-			// if this isn't cleared first we will have overlap with the fog
-			// outside the world
-			GL11.glClearStencil(0);
-			GL11.glStencilMask(0x11111111);
-			GL11.glClear(GL11.GL_STENCIL_BUFFER_BIT);
-			
-			GL11.glEnable(GL11.GL_STENCIL_TEST);
-			GL11.glStencilFunc(GL11.GL_ALWAYS, 1, 0x11111111);
-			GL11.glStencilMask(0b11111111);
-			GL11.glStencilOp(GL11.GL_KEEP, // this doesn't mater since GL_ALWAYS is being used
-					GL11.GL_KEEP,  // stencil test passes
-					GL11.GL_REPLACE); // stencil + depth pass
-		}
-	}
-	
-	
-	/** 
-	 * this variable should be the same as the method name below.
-	 * It is used when transforming the RenderGlobal class' 
-	 * renderBlockLayer method.
-	 */
-	public static final String END_STENCIL_METHOD_NAME = "endRenderingStencil";
-	
-	/**
-	 * Currently this method isn't used in any transformations since we end
-	 * the stencil drawing in the ClientProxy right before we draw the LODs.
-	 */
-	public static void endRenderingStencil(RenderType blockLayerIn)
-	{
-		GL11.glStencilOp(GL11.GL_KEEP, // this doesn't mater since GL_ALWAYS is being used
-				GL11.GL_KEEP,  // stencil test passes
-				GL11.GL_KEEP); // stencil + depth pass
-	}
-	
-	public static void endRenderingStencil()
-	{
-		endRenderingStencil(null);
-	}
-}
@@ -1,45 +0,0 @@
-package com.backsun.lod.renderer;
-
-import net.minecraft.client.Minecraft;
-
-/**
- * This holds miscellaneous helper code
- * to be used in the rendering process.
- * 
- * @author James Seibel
- * @version 2-13-2021
- */
-public class RenderUtil
-{
-	/**
-	 * Returns if the given coordinate is in the loaded area of the world.
-	 * @param centerCoordinate the center of the loaded world
-	 */
-	public static boolean isCoordinateInLoadedArea(int i, int j, int centerCoordinate)
-	{
-		Minecraft mc = Minecraft.getInstance();
-		
-		return (i >= centerCoordinate - mc.gameSettings.renderDistanceChunks 
-				&& i <= centerCoordinate + mc.gameSettings.renderDistanceChunks) 
-				&& 
-				(j >= centerCoordinate - mc.gameSettings.renderDistanceChunks 
-				&& j <= centerCoordinate + mc.gameSettings.renderDistanceChunks);
-	}
-	
-	
-	/**
-	 * Find the coordinates that are in the center half of the given
-	 * 2D matrix, starting at (0,0) and going to (2 * lodRadius, 2 * lodRadius).
-	 */
-	public static boolean isCoordinateInNearFogArea(int i, int j, int lodRadius)
-	{
-		int halfRadius = lodRadius / 2;
-		
-		return (i >= lodRadius - halfRadius 
-				&& i <= lodRadius + halfRadius) 
-				&& 
-				(j >= lodRadius - halfRadius
-				&& j <= lodRadius + halfRadius);
-	}
-	
-}
@@ -1,105 +0,0 @@
-package com.backsun.lod.util;
-
-import java.nio.file.Path;
-import java.nio.file.Paths;
-
-import org.apache.commons.lang3.tuple.Pair;
-import org.apache.logging.log4j.LogManager;
-
-import com.backsun.lod.ModInfo;
-import com.backsun.lod.util.enums.FogDistance;
-import com.electronwill.nightconfig.core.file.CommentedFileConfig;
-import com.electronwill.nightconfig.core.io.WritingMode;
-
-import net.minecraftforge.common.ForgeConfigSpec;
-import net.minecraftforge.eventbus.api.SubscribeEvent;
-import net.minecraftforge.fml.common.Mod;
-import net.minecraftforge.fml.config.ModConfig;
-
-/**
- * 
- * @author James Seibel
- * @version 02-27-2021
- */
-@Mod.EventBusSubscriber
-public class LodConfig
-{
-	public static class Client
-	{
-		public ForgeConfigSpec.BooleanValue drawLODs;
-		
-		public ForgeConfigSpec.EnumValue<FogDistance> fogDistance;
-		
-		public ForgeConfigSpec.BooleanValue drawCheckerBoard;
-		
-		
-		Client(ForgeConfigSpec.Builder builder)
-		{
-	        builder.comment(ModInfo.MODNAME + " configuration settings").push("client");
-	        
-	        drawLODs = builder
-	        		.comment("If false LODs will not be drawn, \n"
-	        				+ "however they will still be generated \n"
-	        				+ "and saved to file for later use.")
-	        		.define("drawLODs", true);
-	        
-	        fogDistance = builder
-	                .comment("\n"
-	                		+ "At what distance should Fog be drawn on the LODs? \n"
-	                		+ "If fog cuts off ubruptly or you are using Optifine's \"fast\" \n"
-	                		+ "fog option set this to " + FogDistance.NEAR.toString() + " or " + FogDistance.FAR.toString() + ".")
-	                .defineEnum("fogDistance", FogDistance.NEAR_AND_FAR);
-	        
-	        drawCheckerBoard = builder
-	                .comment("\n"
-	                		+ "If false the LODs will draw with their normal world colors. \n"
-	                		+ "If true they will draw as a black and white checkerboard. \n"
-	                		+ "This can be used for debugging or imagining you are playing a \n"
-	                		+ "giant game of chess ;)")
-	                .define("drawCheckerBoard", false);
-	        
-	        builder.pop();
-	    }
-	}
-	
-	
-
-    /**
-     * {@link Path} to the configuration file of this mod
-     */
-    private static final Path CONFIG_PATH =
-            Paths.get("config", ModInfo.MODID + ".toml");
-
-    public static final ForgeConfigSpec clientSpec;
-    public static final Client CLIENT;
-    static {
-        final Pair<Client, ForgeConfigSpec> specPair = new ForgeConfigSpec.Builder().configure(Client::new);
-        clientSpec = specPair.getRight();
-        CLIENT = specPair.getLeft();
-        
-        // setup the config file
-        CommentedFileConfig config = CommentedFileConfig.builder(CONFIG_PATH)
-                .writingMode(WritingMode.REPLACE)
-                .build();
-        config.load();
-        config.save();
-        clientSpec.setConfig(config);
-    }
-    
-    
-    @SubscribeEvent
-    public static void onLoad(final ModConfig.Loading configEvent)
-    {
-        LogManager.getLogger().debug(ModInfo.MODNAME, "Loaded forge config file {}", configEvent.getConfig().getFileName());
-    }
-    
-    @SubscribeEvent
-    public static void onFileChange(final ModConfig.Reloading configEvent)
-    {
-        LogManager.getLogger().debug(ModInfo.MODNAME, "Forge config just got changed on the file system!");
-    }
-    
-    
-    
-    
-}
@@ -1,63 +0,0 @@
-package com.backsun.lod.util;
-
-import net.minecraft.client.Minecraft;
-import net.minecraft.server.integrated.IntegratedServer;
-import net.minecraft.world.DimensionType;
-import net.minecraft.world.server.ServerWorld;
-
-/**
- * This class holds methods that may be used in multiple places.
- * 
- * @author James Seibel
- * @version 02-26-2021
- */
-public class LodUtils
-{
-	private static Minecraft mc = Minecraft.getInstance();
-	
-	
-	
-	/**
-	 * Gets the first valid ServerWorld.
-	 * 
-	 * @return null if there are no ServerWorlds
-	 */
-	public static ServerWorld getFirstValidServerWorld()
-	{
-		if (mc.getIntegratedServer() == null)
-			return null;
-		
-		Iterable<ServerWorld> worlds = mc.getIntegratedServer().getWorlds();
-		
-		for (ServerWorld world : worlds)
-			return world;
-				
-		return null;
-	}
-	
-	/**
-	 * Gets the ServerWorld for the relevant dimension.
-	 * 
-	 * @return null if there is no ServerWorld for the given dimension
-	 */
-	public static ServerWorld getServerWorldFromDimension(DimensionType dimension)
-	{
-		IntegratedServer server = mc.getIntegratedServer();
-		if (server == null)
-			return null;
-		
-		Iterable<ServerWorld> worlds = server.getWorlds();
-		ServerWorld returnWorld = null;
-		
-		for (ServerWorld world : worlds)
-		{
-			if(world.getDimensionType() == dimension)
-			{
-				returnWorld = world;
-				break;
-			}
-		}
-				
-		return returnWorld;
-	}
-}
@@ -1,26 +0,0 @@
-package com.backsun.lod.util;
-
-/**
- * This holds meta information about the mod.
- * 
- * @author James Seibel
- * @version 04-16-2020
- */
-public class Reference
-{
-	/** the mod's identifier  */
-	public static final String MOD_ID = "lod";
-	/** the mod's name */
-	public static final String NAME = "LOD Mod";
-	/** the mod's version */
-	public static final String VERSION = "1.0";
-	/** the version of minecraft this mod is built for */
-	public static final String ACCEPTED_VERSIONS = "[1.16.4]";
-	
-	/** where the client proxy class is */
-	public static final String CLIENT_PROXY_CLASS = "com.backsun.lod.proxy.ClientProxy";
-	/** where the  common proxy class is*/
-	public static final String COMMON_PROXY_CLASS = "com.backsun.lod.proxy.CommonProxy";
-	
-	
-}
@@ -1,96 +0,0 @@
-package com.backsun.lod.util;
-
-import java.lang.reflect.Field;
-
-import com.backsun.lod.util.enums.FogQuality;
-
-import net.minecraft.client.Minecraft;
-
-/**
- * This object is used to get variables from methods
- * where they are private.
- * 
- * @author James Seibel
- * @version 02-18-2021
- */
-public class ReflectionHandler
-{
-	private Minecraft mc = Minecraft.getInstance();
-	
-	public Field ofFogField = null;
-	
-	
-	public ReflectionHandler()
-	{
-		setupFogField();
-	}
-	
-	/**
-	 * Similar to setupFovMethod.
-	 */
-	private void setupFogField()
-	{
-		// get every variable from the entity renderer
-		Field[] vars = mc.gameSettings.getClass().getDeclaredFields();
-				
-		// try and find the ofFogType variable in gameSettings
-		for(Field f : vars)
-		{
-			if(f.getName().equals("ofFogType"))
-			{
-				ofFogField = f;
-				return;
-			}
-		}
-		
-		// we didn't find the field,
-		// either optifine isn't installed, or
-		// optifine changed the name of the variable
-		ofFogField = null;
-	}
-	
-	
-	
-	
-	
-	/**
-	 * Get what type of fog optifine is currently set to render.
-	 */
-	public FogQuality getFogQuality()
-	{
-		if (ofFogField == null)
-		{
-			// either optifine isn't installed,
-			// the variable name was changed, or
-			// the setup method wasn't called yet.
-			return FogQuality.OFF;
-		}
-		
-		int returnNum = 0;
-		
-		try
-		{
-			returnNum = (int)ofFogField.get(mc.gameSettings);
-		}
-		catch (IllegalArgumentException | IllegalAccessException e)
-		{
-			e.printStackTrace();
-		}
-		
-		switch (returnNum)
-		{
-			case 0:
-				return FogQuality.FAST;
-			case 1:
-				return FogQuality.FAST;
-			case 2:
-				return FogQuality.FANCY;
-			case 3:
-				return FogQuality.OFF;
-				
-			default:
-				return FogQuality.FAST;
-		}
-	}
-	
-}
@@ -1,34 +0,0 @@
-package com.backsun.lod.util.enums;
-
-/**
- * TOP, N, S, E, W, BOTTOM
- * 
- * @author James Seibel
- * @version 10-17-2020
- */
-public enum ColorDirection
-{
-	// used for colors
-	/** +Y */
-	TOP(0),
-	
-	/** -Z */
-	N(1),
-	/** +Z */
-	S(2),
-	
-	/** +X */
-	E(3),
-	/** -X */
-	W(4),
-	
-	/** -Y */
-	BOTTOM(5);
-	
-	public final int value;
-	
-	private ColorDirection(int newValue)
-	{
-		value = newValue;
-	}
-}
@@ -1,32 +0,0 @@
-package com.backsun.lod.util.enums;
-
-/**
- * @author James Seibel
- * @version 1-23-2021
- */
-public enum DrawMode
-{
-	/** Draw the LOD objects in groups.
-	 * <br>
-	 * <br>
-	 * Fancy fog: render the center and outside LOD
-	 * objects in 2 different groups.
-	 * <br>
-	 * Fast fog: render all LOD objects at one time. 
-	 */
-	BATCH(0),
-	
-	/** Draw each LOD objects separately.
-	 * <br>
-	 * <br>
-	 * Not suggested normally since draw calls are GPU expensive.
-	 */
-	INDIVIDUAL(5);
-	
-	public final int value;
-	
-	private DrawMode(int newValue)
-	{
-		value = newValue;
-	}
-}
@@ -1,17 +0,0 @@
-package com.backsun.lod.util.enums;
-
-/**
- * Near, far, or NEAR_AND_FAR.
- * 
- * @author James Seibel
- * @version 02-14-2021
- */
-public enum FogDistance
-{
-	/** good for fast or fancy fog qualities. */
-	NEAR,
-	/** good for fast or fancy fog qualities. */
-	FAR,
-	/** only looks good if the fog quality is set to Fancy. */
-	NEAR_AND_FAR;
-}
@@ -1,14 +0,0 @@
-package com.backsun.lod.util.enums;
-
-/**
- * fast, fancy, or off
- * 
- * @author James Seibel
- * @version 02-14-2021
- */
-public enum FogQuality
-{
-	FAST,
-	FANCY,
-	OFF;
-}
@@ -1,28 +0,0 @@
-package com.backsun.lod.util.enums;
-
-/**
- * NE, SE, SW, NW
- * 
- * @author James Seibel
- * @version 1-20-2020
- */
-public enum LodCorner
-{
-	// used for position
-	
-	/** -Z, +X */
-	NE(0),
-	/** +Z, +X */
-	SE(1),
-	/** +Z, -X */
-	SW(2),
-	/** -Z, -X */
-	NW(3);
-	
-	public final int value;
-	
-	private LodCorner(int newValue)
-	{
-		value = newValue;
-	}
-}
@@ -1,29 +0,0 @@
-package com.backsun.lod.util.enums;
-
-/**
- * 
- * @author James Seibel
- * @version 1-20-2020
- * 
- * NE, SE, SW, NW
- */
-public enum LodLocation
-{
-	// used for position
-	
-	/** -Z, +X */
-	NE(0),
-	/** +Z, +X */
-	SE(1),
-	/** +Z, -X */
-	SW(2),
-	/** -Z, -X */
-	NW(3);
-	
-	public final int value;
-	
-	private LodLocation(int newValue)
-	{
-		value = newValue;
-	}
-}
@@ -1,9 +1,25 @@
-package com.backsun.lod;
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod;

-import com.backsun.lod.proxy.ClientProxy;
-import com.backsun.lod.util.LodConfig;
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.proxy.ClientProxy;

-import net.minecraft.client.Minecraft;
 import net.minecraftforge.common.MinecraftForge;
 import net.minecraftforge.eventbus.api.SubscribeEvent;
 import net.minecraftforge.fml.ModLoadingContext;
@@ -21,7 +37,7 @@ import net.minecraftforge.fml.javafmlmod.FMLJavaModLoadingContext;
 * check out the ClientProxy.
 * 
 * @author James Seibel
- * @version 02-07-2021
+ * @version 7-3-2021
 */
@Mod(ModInfo.MODID)
 public class LodMain
@@ -33,8 +49,7 @@ public class LodMain
 	
 	private void init(final FMLCommonSetupEvent event)
 	{
-		Minecraft.getInstance().getFramebuffer().enableStencil();
-		ModLoadingContext.get().registerConfig(ModConfig.Type.CLIENT, LodConfig.clientSpec);
+		ModLoadingContext.get().registerConfig(ModConfig.Type.CLIENT, LodConfig.CLIENT_SPEC);
 	}
 	
 	
@@ -0,0 +1,43 @@
+package com.seibel.lod;
+
+import java.util.HashMap;
+import java.util.Map;
+
+import com.seibel.lod.builders.lodTemplates.Box;
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.HorizontalQuality;
+import com.seibel.lod.enums.HorizontalScale;
+import com.seibel.lod.util.DataPointUtil;
+
+import net.minecraft.util.Direction;
+
+public class Main
+{
+	public static void main(String[] args)
+	{
+		for(byte detail = 0; detail < 13; detail++)
+		{
+			byte minGenDetail = 0;
+			byte maxDetail = 10;
+			int distance;
+			if (detail <= minGenDetail)
+				distance = 0;
+			else if (detail >= maxDetail)
+				distance = 10000;
+			else
+			{
+				int distanceUnit = HorizontalScale.LOW.distanceUnit;
+				switch (HorizontalQuality.HIGH)
+				{
+					case LINEAR:
+						;
+						distance = (detail * distanceUnit);
+					default:
+						double base = HorizontalQuality.HIGH.quadraticBase;
+						distance = (int) (Math.pow(base, detail) * distanceUnit);
+				}
+			}
+			System.out.println(distance);
+		}
+	}
+}
@@ -0,0 +1,32 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod;
+
+/**
+ * This file is similar to mcmod.info
+ * 
+ * @author James Seibel
+ * @version 08-29-2021
+ */
+public final class ModInfo
+{	
+	public static final String MODID = "lod";
+	public static final String MODNAME = "LOD";
+	public static final String MODAPI = "LodAPI";
+	public static final String VERSION = "a1.5.1-pre";
+}
@@ -0,0 +1,588 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.builders;
+
+import java.nio.ByteBuffer;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.concurrent.Callable;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+import java.util.concurrent.Future;
+import java.util.concurrent.locks.ReentrantLock;
+
+import org.lwjgl.opengl.GL11;
+import org.lwjgl.opengl.GL15;
+import org.lwjgl.opengl.GL15C;
+
+import com.seibel.lod.builders.lodTemplates.Box;
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.VerticalQuality;
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.objects.LodRegion;
+import com.seibel.lod.objects.PosToRenderContainer;
+import com.seibel.lod.objects.RegionPos;
+import com.seibel.lod.proxy.ClientProxy;
+import com.seibel.lod.proxy.GlProxy;
+import com.seibel.lod.proxy.GlProxy.GlProxyContext;
+import com.seibel.lod.render.LodRenderer;
+import com.seibel.lod.util.DataPointUtil;
+import com.seibel.lod.util.LevelPosUtil;
+import com.seibel.lod.util.LodThreadFactory;
+import com.seibel.lod.util.LodUtil;
+
+import net.minecraft.client.renderer.BufferBuilder;
+import net.minecraft.client.renderer.vertex.VertexBuffer;
+import net.minecraft.util.Direction;
+import net.minecraft.util.math.BlockPos;
+import net.minecraft.util.math.ChunkPos;
+
+/**
+ * This object is used to create NearFarBuffer objects.
+ *
+ * @author James Seibel
+ * @version 9-25-2021
+ */
+public class LodBufferBuilder
+{
+	/**
+	 * This holds the thread used to generate new LODs off the main thread.
+	 */
+	public static ExecutorService mainGenThread = Executors.newSingleThreadExecutor(new LodThreadFactory(LodBufferBuilder.class.getSimpleName() + " - main"));
+	/**
+	 * This holds the threads used to generate buffers.
+	 */
+	public static ExecutorService bufferBuilderThreads = Executors.newFixedThreadPool(LodConfig.CLIENT.threading.numberOfBufferBuilderThreads.get(), new LodThreadFactory(LodBufferBuilder.class.getSimpleName() + " - builder"));
+	
+	/**
+	 * The buffers that are used to create LODs using far fog
+	 */
+	public volatile BufferBuilder[][] buildableBuffers;
+	
+	/**
+	 * Used when building new VBOs
+	 */
+	public volatile VertexBuffer[][] buildableVbos;
+	
+	/**
+	 * VBOs that are sent over to the LodNodeRenderer
+	 */
+	public volatile VertexBuffer[][] drawableVbos;
+	
+	/**
+	 * if this is true the LOD buffers are currently being
+	 * regenerated.
+	 */
+	public boolean generatingBuffers = false;
+	
+	/**
+	 * if this is true new LOD buffers have been generated
+	 * and are waiting to be swapped with the drawable buffers
+	 */
+	private boolean switchVbos = false;
+	
+	/**
+	 * Size of the buffer builders in bytes last time we created them
+	 */
+	public int previousBufferSize = 0;
+	
+	/**
+	 * Width of the dimension in regions last time we created the buffers
+	 */
+	public int previousRegionWidth = 0;
+	
+	/**
+	 * this is used to prevent multiple threads creating, destroying, or using the buffers at the same time
+	 */
+	private ReentrantLock bufferLock = new ReentrantLock();
+	
+	private volatile Box[][] boxCache;
+	private volatile PosToRenderContainer[][] setsToRender;
+	private volatile RegionPos center;
+	
+	/**
+	 * This is the ChunkPos the player was at the last time the buffers were built.
+	 * IE the center of the buffers last time they were built
+	 */
+	private volatile ChunkPos drawableCenterChunkPos = new ChunkPos(0, 0);
+	private volatile ChunkPos buildableCenterChunkPos = new ChunkPos(0, 0);
+	
+	
+	public LodBufferBuilder()
+	{
+		
+	}
+	
+	/**
+	 * Create a thread to asynchronously generate LOD buffers
+	 * centered around the given camera X and Z.
+	 * <br>
+	 * This method will write to the drawable near and far buffers.
+	 * <br>
+	 * After the buildable buffers have been generated they must be
+	 * swapped with the drawable buffers in the LodRenderer to be drawn.
+	 */
+	public void generateLodBuffersAsync(LodRenderer renderer, LodDimension lodDim,
+			BlockPos playerBlockPos, boolean fullRegen)
+	{
+		
+		// only allow one generation process to happen at a time
+		if (generatingBuffers)
+			return;
+		
+		if (buildableBuffers == null)
+			// setupBuffers hasn't been called yet
+			return;
+		
+		generatingBuffers = true;
+		
+		// round the player's block position down to the nearest chunk BlockPos
+		ChunkPos playerChunkPos = new ChunkPos(playerBlockPos);
+		BlockPos playerBlockPosRounded = playerChunkPos.getWorldPosition();
+		
+		Thread thread = new Thread(() ->
+		{
+			bufferLock.lock();
+			
+			try
+			{
+				long startTime = System.currentTimeMillis();
+				
+				ArrayList<Callable<Boolean>> nodeToRenderThreads = new ArrayList<>(lodDim.getWidth() * lodDim.getWidth());
+				
+				startBuffers(fullRegen, lodDim);
+				
+				
+				RegionPos playerRegionPos = new RegionPos(playerChunkPos);
+				if (center == null)
+					center = playerRegionPos;
+				
+				if (setsToRender == null)
+					setsToRender = new PosToRenderContainer[lodDim.getWidth()][lodDim.getWidth()];
+				
+				if (setsToRender.length != lodDim.getWidth())
+					setsToRender = new PosToRenderContainer[lodDim.getWidth()][lodDim.getWidth()];
+				
+				if (boxCache == null)
+					boxCache = new Box[lodDim.getWidth()][lodDim.getWidth()];
+				
+				if (boxCache.length != lodDim.getWidth())
+					boxCache = new Box[lodDim.getWidth()][lodDim.getWidth()];
+				
+				// this will be the center of the VBOs once they have been built
+				buildableCenterChunkPos = playerChunkPos;
+				
+				
+				
+				//================================//
+				// create the nodeToRenderThreads //
+				//================================//
+				
+				for (int xRegion = 0; xRegion < lodDim.getWidth(); xRegion++)
+				{
+					for (int zRegion = 0; zRegion < lodDim.getWidth(); zRegion++)
+					{
+						if (lodDim.doesRegionNeedBufferRegen(xRegion, zRegion) || fullRegen)
+						{
+							RegionPos regionPos = new RegionPos(
+									xRegion + lodDim.getCenterRegionPosX() - Math.floorDiv(lodDim.getWidth(), 2),
+									zRegion + lodDim.getCenterRegionPosZ() - Math.floorDiv(lodDim.getWidth(), 2));
+							
+							// local position in the vbo and bufferBuilder arrays
+							BufferBuilder currentBuffer = buildableBuffers[xRegion][zRegion];
+							LodRegion region = lodDim.getRegion(regionPos.x, regionPos.z);
+							
+							if (region == null)
+								continue;
+							
+							// make sure the buffers weren't
+							// changed while we were running this method
+							if (currentBuffer == null || !currentBuffer.building())
+								return;
+							
+							byte minDetail = region.getMinDetailLevel();
+							
+							
+							final int xR = xRegion;
+							final int zR = zRegion;
+							Callable<Boolean> dataToRenderThread = () ->
+							{
+								Map<Direction, long[]> adjData = new HashMap<>();
+								
+								// determine how many LODs we can stack vertically
+								int maxVerticalData = 1;
+								if (LodConfig.CLIENT.worldGenerator.lodQualityMode.get() == VerticalQuality.VOXEL)
+									maxVerticalData = 256;
+								
+								// create adjData's arrays
+								for (Direction direction : Box.ADJ_DIRECTIONS)
+									adjData.put(direction, new long[maxVerticalData]);
+								
+								//previous setToRender cache
+								if (setsToRender[xR][zR] == null)
+									setsToRender[xR][zR] = new PosToRenderContainer(minDetail, regionPos.x, regionPos.z);
+								
+								if (boxCache[xR][zR] == null)
+									boxCache[xR][zR] = new Box();
+								
+								PosToRenderContainer posToRender = setsToRender[xR][zR];
+								posToRender.clear(minDetail, regionPos.x, regionPos.z);
+								
+								lodDim.getDataToRender(
+										posToRender,
+										regionPos,
+										playerBlockPosRounded.getX(),
+										playerBlockPosRounded.getZ());
+								
+								byte detailLevel;
+								int posX;
+								int posZ;
+								int xAdj;
+								int zAdj;
+								int chunkXdist;
+								int chunkZdist;
+								
+								// keep a local version so we don't have to worry about indexOutOfBounds Exceptions
+								// if it changes in the LodRenderer while we are working here
+								boolean[][] vanillaRenderedChunks = renderer.vanillaRenderedChunks;
+								short gameChunkRenderDistance = (short) (vanillaRenderedChunks.length / 2 - 1);
+								
+								for (int index = 0; index < posToRender.getNumberOfPos(); index++)
+								{
+									detailLevel = posToRender.getNthDetailLevel(index);
+									posX = posToRender.getNthPosX(index);
+									posZ = posToRender.getNthPosZ(index);
+									
+									// skip any chunks that Minecraft is going to render
+									chunkXdist = LevelPosUtil.getChunkPos(detailLevel, posX) - playerChunkPos.x;
+									chunkZdist = LevelPosUtil.getChunkPos(detailLevel, posZ) - playerChunkPos.z;
+									
+									if (gameChunkRenderDistance >= Math.abs(chunkXdist)
+											&& gameChunkRenderDistance >= Math.abs(chunkZdist)
+											&& detailLevel <= LodUtil.CHUNK_DETAIL_LEVEL
+											&& vanillaRenderedChunks[chunkXdist + gameChunkRenderDistance + 1][chunkZdist + gameChunkRenderDistance + 1])
+									{
+										continue;
+									}
+									
+									// skip any chunks that Minecraft is going to render
+									for (Direction direction : Box.ADJ_DIRECTIONS)
+									{
+										xAdj = posX + direction.getNormal().getX();
+										zAdj = posZ + direction.getNormal().getZ();
+										chunkXdist = LevelPosUtil.getChunkPos(detailLevel, xAdj) - playerChunkPos.x;
+										chunkZdist = LevelPosUtil.getChunkPos(detailLevel, zAdj) - playerChunkPos.z;
+										boolean performFaceCulling = true;
+										
+										if (performFaceCulling
+												&& posToRender.contains(detailLevel, xAdj, zAdj)
+												&& (gameChunkRenderDistance < Math.abs(chunkXdist)
+														|| gameChunkRenderDistance < Math.abs(chunkZdist)
+														|| !vanillaRenderedChunks[chunkXdist + gameChunkRenderDistance + 1][chunkZdist + gameChunkRenderDistance + 1]))
+										{
+											if (!adjData.containsKey(direction) || adjData.get(direction) == null)
+												adjData.put(direction, new long[maxVerticalData]);
+											for (int verticalIndex = 0; verticalIndex < lodDim.getMaxVerticalData(detailLevel, xAdj, zAdj); verticalIndex++)
+											{
+												long data = lodDim.getData(detailLevel, xAdj, zAdj, verticalIndex);
+												adjData.get(direction)[verticalIndex] = data;
+											}
+										}
+										else
+										{
+											adjData.put(direction, null);
+										}
+									}
+									
+									long data;
+									for (int verticalIndex = 0; verticalIndex < lodDim.getMaxVerticalData(detailLevel, posX, posZ); verticalIndex++)
+									{
+										data = lodDim.getData(detailLevel, posX, posZ, verticalIndex);
+										if (DataPointUtil.isVoid(data) || !DataPointUtil.doesItExist(data))
+											break;
+										
+										LodConfig.CLIENT.graphics.lodTemplate.get().template.addLodToBuffer(currentBuffer, playerBlockPosRounded, data, adjData,
+												detailLevel, posX, posZ, boxCache[xR][zR], renderer.previousDebugMode, renderer.lightMap);
+									}
+									
+									
+								} // for pos to in list to render
+									// the thread executed successfully
+								return true;
+							};
+							nodeToRenderThreads.add(dataToRenderThread);
+						}
+					} // region z
+				} // region z
+				
+				
+				
+				long executeStart = System.currentTimeMillis();
+				// wait for all threads to finish
+				List<Future<Boolean>> futuresBuffer = bufferBuilderThreads.invokeAll(nodeToRenderThreads);
+				for (Future<Boolean> future : futuresBuffer)
+				{
+					// the future will be false if its thread failed
+					if (!future.get())
+					{
+						ClientProxy.LOGGER.warn("LodBufferBuilder ran into trouble and had to start over.");
+						closeBuffers(fullRegen, lodDim);
+						return;
+					}
+				}
+				long executeEnd = System.currentTimeMillis();
+				
+				
+				long endTime = System.currentTimeMillis();
+				@SuppressWarnings("unused")
+				long buildTime = endTime - startTime;
+				@SuppressWarnings("unused")
+				long executeTime = executeEnd - executeStart;
+		
+//				ClientProxy.LOGGER.info("Thread Build time: " + buildTime + " ms" + '\n' +
+//						                        "thread execute time: " + executeTime + " ms");
+				
+				// mark that the buildable buffers as ready to swap
+				switchVbos = true;
+			}
+			catch (Exception e)
+			{
+				ClientProxy.LOGGER.warn("\"LodNodeBufferBuilder.generateLodBuffersAsync\" ran into trouble: ");
+				e.printStackTrace();
+			}
+			finally
+			{
+				// regardless of if we successfully created the buffers
+				// we are done generating.
+				generatingBuffers = false;
+				
+				// clean up any potentially open resources
+				if (buildableBuffers != null)
+					closeBuffers(fullRegen, lodDim);
+				
+				// upload the new buffers
+				uploadBuffers(fullRegen, lodDim);
+				bufferLock.unlock();
+			}
+			
+		});
+		
+		mainGenThread.execute(thread);
+	}
+	
+	//===============================//
+	// BufferBuilder related methods //
+	//===============================//
+	
+	/**
+	 * Called from the LodRenderer to create the
+	 * BufferBuilders. <br><br>
+	 * <p>
+	 * May have to wait for the bufferLock to open.
+	 */
+	public void setupBuffers(LodDimension lodDimension)
+	{
+		bufferLock.lock();
+		int numbRegionsWide = lodDimension.getWidth();
+		int bufferMaxCapacity;
+		
+		previousRegionWidth = numbRegionsWide;
+		buildableBuffers = new BufferBuilder[numbRegionsWide][numbRegionsWide];
+		
+		buildableVbos = new VertexBuffer[numbRegionsWide][numbRegionsWide];
+		drawableVbos = new VertexBuffer[numbRegionsWide][numbRegionsWide];
+		
+		for (int x = 0; x < numbRegionsWide; x++)
+		{
+			for (int z = 0; z < numbRegionsWide; z++)
+			{
+				bufferMaxCapacity = lodDimension.getMemoryRequired(x, z, LodConfig.CLIENT.graphics.lodTemplate.get());
+				buildableBuffers[x][z] = new BufferBuilder(bufferMaxCapacity);
+				
+				buildableVbos[x][z] = new VertexBuffer(LodRenderer.LOD_VERTEX_FORMAT);
+				drawableVbos[x][z] = new VertexBuffer(LodRenderer.LOD_VERTEX_FORMAT);
+			}
+		}
+		
+		bufferLock.unlock();
+	}
+	
+	/**
+	 * sets the buffers and Vbos to null, forcing them to be recreated. <br><br>
+	 * <p>
+	 * May have to wait for the bufferLock to open.
+	 */
+	public void destroyBuffers()
+	{
+		bufferLock.lock();
+		
+		buildableBuffers = null;
+		buildableVbos = null;
+		drawableVbos = null;
+		
+		bufferLock.unlock();
+	}
+	
+	/**
+	 * Calls begin on each of the buildable BufferBuilders.
+	 */
+	private void startBuffers(boolean fullRegen, LodDimension lodDim)
+	{
+		for (int x = 0; x < buildableBuffers.length; x++)
+		{
+			for (int z = 0; z < buildableBuffers.length; z++)
+			{
+				if (fullRegen || lodDim.doesRegionNeedBufferRegen(x, z))
+				{
+					// for some reason BufferBuilder.vertexCounts
+					// isn't reset unless this is called, which can cause
+					// a false indexOutOfBoundsException
+					buildableBuffers[x][z].discard();
+					
+					buildableBuffers[x][z].begin(GL11.GL_QUADS, LodRenderer.LOD_VERTEX_FORMAT);
+				}
+			}
+		}
+	}
+	
+	/**
+	 * Calls end on each of the buildable BufferBuilders.
+	 */
+	private void closeBuffers(boolean fullRegen, LodDimension lodDim)
+	{
+		for (int x = 0; x < buildableBuffers.length; x++)
+			for (int z = 0; z < buildableBuffers.length; z++)
+				if (buildableBuffers[x][z] != null && buildableBuffers[x][z].building() && (fullRegen || lodDim.doesRegionNeedBufferRegen(x, z)))
+					buildableBuffers[x][z].end();
+	}
+	
+	/**
+	 * Upload all buildableBuffers to the GPU.
+	 */
+	private void uploadBuffers(boolean fullRegen, LodDimension lodDim)
+	{
+		GlProxy glProxy = GlProxy.getInstance();
+		
+		try
+		{
+			// make sure we are uploading to a different OpenGL context,
+			// to prevent interference (IE stuttering) with the Minecraft context.
+			glProxy.setGlContext(GlProxyContext.LOD_BUILDER);
+			
+			for (int x = 0; x < buildableVbos.length; x++)
+			{
+				for (int z = 0; z < buildableVbos.length; z++)
+				{
+					if (fullRegen || lodDim.doesRegionNeedBufferRegen(x, z))
+					{
+						ByteBuffer builderBuffer = buildableBuffers[x][z].popNextBuffer().getSecond();
+						vboUpload(buildableVbos[x][z], builderBuffer);
+						lodDim.setRegenRegionBufferByArrayIndex(x, z, false);
+					}
+				}
+			}
+		}
+		catch (IllegalStateException e)
+		{
+			ClientProxy.LOGGER.error(LodBufferBuilder.class.getSimpleName() + " - UploadBuffers failed: " + e.getMessage());
+			e.printStackTrace();
+		}
+		finally
+		{
+			// make sure the context is disabled
+			glProxy.setGlContext(GlProxyContext.NONE);
+		}
+	}
+	
+	/**
+	 * Uploads the uploadBuffer into the VBO in GPU memory.
+	 */
+	private void vboUpload(VertexBuffer vbo, ByteBuffer uploadBuffer)
+	{
+		// this shouldn't happen, but just to be safe
+		if (vbo.id != -1 && GlProxy.getInstance().getGlContext() == GlProxyContext.LOD_BUILDER)
+		{
+			// this is how many points will be rendered
+			vbo.vertexCount = (uploadBuffer.remaining() / vbo.format.getVertexSize());
+			
+			GL15C.glBindBuffer(GL15.GL_ARRAY_BUFFER, vbo.id);
+			
+			// subData only works if the memory is allocated beforehand.
+			GL15C.glBufferData(GL15.GL_ARRAY_BUFFER, uploadBuffer.remaining(), GL15C.GL_DYNAMIC_DRAW);
+			
+			// interestingly bufferSubData renders faster than glMapBuffer
+			// even though OpenGLInsights-AsynchronousBufferTransfers says glMapBuffer
+			// is faster for transferring data. They must put the data in different memory
+			// or something.
+			GL15C.glBufferSubData(GL15.GL_ARRAY_BUFFER, 0, uploadBuffer);
+			
+			GL15C.glBindBuffer(GL15.GL_ARRAY_BUFFER, 0);
+		}
+	}
+	
+	/**
+	 * Get the newly created VBOs
+	 */
+	public VertexBuffersAndOffset getVertexBuffers()
+	{
+		// don't wait for the lock to open
+		// since this is called on the main render thread
+		if (bufferLock.tryLock())
+		{
+			VertexBuffer[][] tmpVbo = drawableVbos;
+			drawableVbos = buildableVbos;
+			buildableVbos = tmpVbo;
+			
+			drawableCenterChunkPos = buildableCenterChunkPos;
+			
+			// the vbos have been swapped
+			switchVbos = false;
+			bufferLock.unlock();
+		}
+		
+		return new VertexBuffersAndOffset(drawableVbos, drawableCenterChunkPos);
+	}
+	
+	/**
+	 * A simple container to pass multiple objects back in the getVertexBuffers method.
+	 */
+	public class VertexBuffersAndOffset
+	{
+		public VertexBuffer[][] vbos;
+		public ChunkPos drawableCenterChunkPos;
+		
+		public VertexBuffersAndOffset(VertexBuffer[][] newVbos, ChunkPos newDrawableCenterChunkPos)
+		{
+			vbos = newVbos;
+			drawableCenterChunkPos = newDrawableCenterChunkPos;
+		}
+	}
+	
+	/**
+	 * If this is true the buildable near and far
+	 * buffers have been generated and are ready to be
+	 * sent to the LodRenderer.
+	 */
+	public boolean newBuffersAvaliable()
+	{
+		return switchVbos;
+	}
+	
+}
@@ -0,0 +1,978 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.builders;
+
+import java.awt.Color;
+import java.util.List;
+import java.util.Random;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.ConcurrentMap;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.enums.HorizontalResolution;
+import com.seibel.lod.enums.VerticalQuality;
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.objects.LodRegion;
+import com.seibel.lod.objects.LodWorld;
+import com.seibel.lod.util.ColorUtil;
+import com.seibel.lod.util.DataPointUtil;
+import com.seibel.lod.util.DetailDistanceUtil;
+import com.seibel.lod.util.LevelPosUtil;
+import com.seibel.lod.util.LodThreadFactory;
+import com.seibel.lod.util.LodUtil;
+import com.seibel.lod.util.ThreadMapUtil;
+import com.seibel.lod.wrappers.MinecraftWrapper;
+
+import net.minecraft.block.AbstractPlantBlock;
+import net.minecraft.block.AbstractTopPlantBlock;
+import net.minecraft.block.Block;
+import net.minecraft.block.BlockState;
+import net.minecraft.block.Blocks;
+import net.minecraft.block.BushBlock;
+import net.minecraft.block.FlowerBlock;
+import net.minecraft.block.GrassBlock;
+import net.minecraft.block.IGrowable;
+import net.minecraft.block.LeavesBlock;
+import net.minecraft.block.TallGrassBlock;
+import net.minecraft.block.material.MaterialColor;
+import net.minecraft.client.renderer.model.BakedQuad;
+import net.minecraft.client.renderer.texture.TextureAtlasSprite;
+import net.minecraft.client.world.ClientWorld;
+import net.minecraft.util.Direction;
+import net.minecraft.util.math.AxisAlignedBB;
+import net.minecraft.util.math.BlockPos;
+import net.minecraft.util.math.ChunkPos;
+import net.minecraft.util.math.shapes.VoxelShape;
+import net.minecraft.world.DimensionType;
+import net.minecraft.world.IWorld;
+import net.minecraft.world.LightType;
+import net.minecraft.world.World;
+import net.minecraft.world.biome.Biome;
+import net.minecraft.world.chunk.ChunkSection;
+import net.minecraft.world.chunk.IChunk;
+import net.minecraft.world.gen.Heightmap;
+import net.minecraftforge.client.model.data.ModelDataMap;
+
+/**
+ * This object is in charge of creating Lod related objects. (specifically: Lod
+ * World, Dimension, and Region objects)
+ *
+ * @author Leonardo Amato
+ * @author James Seibel
+ * @version 9-25-2021
+ */
+public class LodBuilder
+{
+	private static MinecraftWrapper mc = MinecraftWrapper.INSTANCE;
+	
+	private ExecutorService lodGenThreadPool = Executors.newSingleThreadExecutor(new LodThreadFactory(this.getClass().getSimpleName()));
+	
+	public static final Direction[] directions = new Direction[] { Direction.UP, Direction.EAST, Direction.SOUTH, Direction.WEST, Direction.NORTH, Direction.DOWN };
+	public static final int CHUNK_DATA_WIDTH = LodUtil.CHUNK_WIDTH;
+	public static final int CHUNK_SECTION_HEIGHT = CHUNK_DATA_WIDTH;
+	public static final Heightmap.Type DEFAULT_HEIGHTMAP = Heightmap.Type.WORLD_SURFACE_WG;
+	public static final ConcurrentMap<Block, Integer> colorMap = new ConcurrentHashMap<>();
+	public static final ConcurrentMap<Block, Boolean> toTint = new ConcurrentHashMap<>();
+	public static final ConcurrentMap<Block, VoxelShape> shapeMap = new ConcurrentHashMap<>();
+	
+	public static final ModelDataMap dataMap = new ModelDataMap.Builder().build();
+	
+	/** If no blocks are found in the area in determineBottomPointForArea return this */
+	public static final short DEFAULT_DEPTH = 0;
+	/** If no blocks are found in the area in determineHeightPointForArea return this */
+	public static final short DEFAULT_HEIGHT = 0;
+	/** Minecraft's max light value */
+	public static final short DEFAULT_MAX_LIGHT = 15;
+	
+	/** TODO is this needed / used? */
+	public static final boolean onlyUseFullBlock = false;
+	/** TODO is this needed / used? */
+	public static final boolean avoidSmallBlock = false;
+	
+	/** How wide LodDimensions should be in regions */
+	public int defaultDimensionWidthInRegions = 5;
+	
+	
+	
+	
+	public LodBuilder()
+	{
+		
+	}
+	
+	
+	
+	
+	
+	public void generateLodNodeAsync(IChunk chunk, LodWorld lodWorld, IWorld world)
+	{
+		generateLodNodeAsync(chunk, lodWorld, world, DistanceGenerationMode.SERVER);
+	}
+	
+	
+	public void generateLodNodeAsync(IChunk chunk, LodWorld lodWorld, IWorld world, DistanceGenerationMode generationMode)
+	{
+		if (lodWorld == null || !lodWorld.getIsWorldLoaded())
+			return;
+		
+		// don't try to create an LOD object
+		// if for some reason we aren't
+		// given a valid chunk object
+		if (chunk == null)
+			return;
+		
+		Thread thread = new Thread(() ->
+		{
+			try
+			{
+				// we need a loaded client world in order to
+				// get the textures for blocks
+				if (mc.getClientWorld() == null)
+					return;
+				
+				DimensionType dim = world.dimensionType();
+				
+				// make sure the dimension exists
+				LodDimension lodDim;
+				if (lodWorld.getLodDimension(dim) == null)
+				{
+					lodDim = new LodDimension(dim, lodWorld, defaultDimensionWidthInRegions);
+					lodWorld.addLodDimension(lodDim);
+				}
+				else
+				{
+					lodDim = lodWorld.getLodDimension(dim);
+				}
+				generateLodNodeFromChunk(lodDim, chunk, new LodBuilderConfig(generationMode));
+			}
+			catch (IllegalArgumentException | NullPointerException e)
+			{
+				e.printStackTrace();
+				// if the world changes while LODs are being generated
+				// they will throw errors as they try to access things that no longer
+				// exist.
+			}
+		});
+		lodGenThreadPool.execute(thread);
+	}
+	
+	/**
+	 * Creates a LodNode for a chunk in the given world.
+	 *
+	 * @throws IllegalArgumentException thrown if either the chunk or world is null.
+	 */
+	public void generateLodNodeFromChunk(LodDimension lodDim, IChunk chunk) throws IllegalArgumentException
+	{
+		generateLodNodeFromChunk(lodDim, chunk, new LodBuilderConfig());
+	}
+	
+	/**
+	 * Creates a LodNode for a chunk in the given world.
+	 *
+	 * @throws IllegalArgumentException thrown if either the chunk or world is null.
+	 */
+	public void generateLodNodeFromChunk(LodDimension lodDim, IChunk chunk, LodBuilderConfig config)
+			throws IllegalArgumentException
+	{
+		if (chunk == null)
+			throw new IllegalArgumentException("generateLodFromChunk given a null chunk");
+		
+		int startX;
+		int startZ;
+		int endX;
+		int endZ;
+		
+		
+		LodRegion region = lodDim.getRegion(chunk.getPos().getRegionX(), chunk.getPos().getRegionZ());
+		if (region == null)
+			return;
+		
+		// determine how many LODs to generate horizontally
+		HorizontalResolution detail;
+		byte minDetailLevel = region.getMinDetailLevel();
+		detail = DetailDistanceUtil.getLodGenDetail(minDetailLevel);
+		
+		
+		// determine how many LODs to generate vertically
+		VerticalQuality verticalQuality = LodConfig.CLIENT.worldGenerator.lodQualityMode.get();
+		byte detailLevel = detail.detailLevel;
+		
+		
+		// generate the LODs
+		int posX;
+		int posZ;
+		for (int i = 0; i < detail.dataPointLengthCount * detail.dataPointLengthCount; i++)
+		{
+			startX = detail.startX[i];
+			startZ = detail.startZ[i];
+			endX = detail.endX[i];
+			endZ = detail.endZ[i];
+			
+			posX = LevelPosUtil.convert((byte) 0, chunk.getPos().x * 16 + startX, detail.detailLevel);
+			posZ = LevelPosUtil.convert((byte) 0, chunk.getPos().z * 16 + startZ, detail.detailLevel);
+			
+			
+			long[] data;
+			switch (verticalQuality)
+			{
+			default:
+			case HEIGHTMAP:
+				long singleData;
+				long[] dataToMergeSingle = createSingleDataToMerge(detail, chunk, config, startX, startZ, endX, endZ);
+				singleData = DataPointUtil.mergeSingleData(dataToMergeSingle);
+				lodDim.addData(detailLevel,
+						posX,
+						posZ,
+						0,
+						singleData,
+						false);
+				break;
+				
+			case VOXEL:
+				long[] dataToMergeVertical = createVerticalDataToMerge(detail, chunk, config, startX, startZ, endX, endZ);
+				data = DataPointUtil.mergeMultiData(dataToMergeVertical, DataPointUtil.worldHeight, DetailDistanceUtil.getMaxVerticalData(detailLevel));
+				
+				
+				//lodDim.clear(detailLevel, posX, posZ);
+				if (data != null && data.length != 0)
+				{
+					for (int verticalIndex = 0; verticalIndex < lodDim.getMaxVerticalData(detailLevel, posX, posZ); verticalIndex++)
+					{
+						
+						if (!DataPointUtil.doesItExist(data[verticalIndex]))
+							break;
+						lodDim.addData(detailLevel,
+								posX,
+								posZ,
+								verticalIndex,
+								data[verticalIndex],
+								false);
+					}
+				}
+				break;
+			}
+		}
+		lodDim.updateData(LodUtil.CHUNK_DETAIL_LEVEL, chunk.getPos().x, chunk.getPos().z);
+	}
+	
+	/**
+	 * creates a vertical DataPoint
+	 */
+	private long[] createVerticalDataToMerge(HorizontalResolution detail, IChunk chunk, LodBuilderConfig config, int startX, int startZ, int endX, int endZ)
+	{
+		// equivalent to 2^detailLevel
+		int size = 1 << detail.detailLevel;
+		
+		long[] dataToMerge = ThreadMapUtil.getFreshBuilderVerticalArray(size * size * DataPointUtil.worldHeight + 1, detail.detailLevel);
+		
+		
+		int verticalData = DataPointUtil.worldHeight;
+		
+		ChunkPos chunkPos = chunk.getPos();
+		int height;
+		int depth;
+		int color;
+		int light;
+		int lightSky;
+		int lightBlock;
+		int generation = config.distanceGenerationMode.complexity;
+		
+		int xRel;
+		int zRel;
+		int xAbs;
+		int yAbs;
+		int zAbs;
+		boolean hasCeiling = mc.getClientWorld().dimensionType().hasCeiling();
+		boolean hasSkyLight = mc.getClientWorld().dimensionType().hasSkyLight();
+		
+		BlockPos.Mutable blockPos = new BlockPos.Mutable(0, 0, 0);
+		int index;
+		
+		for (index = 0; index < size * size; index++)
+		{
+			xRel = Math.floorMod(index, size) + startX;
+			zRel = Math.floorDiv(index, size) + startZ;
+			xAbs = chunkPos.getMinBlockX() + xRel;
+			zAbs = chunkPos.getMinBlockZ() + zRel;
+			
+			//Calculate the height of the lod
+			yAbs = DataPointUtil.worldHeight + 2;
+			int count = 0;
+			boolean topBlock = true;
+			while (yAbs > 0)
+			{
+				height = determineHeightPointFrom(chunk, config, xRel, zRel, yAbs, blockPos);
+				
+				// If the lod is at the default height, it must be void data
+				if (height == DEFAULT_HEIGHT)
+				{
+					if (topBlock)
+						dataToMerge[index * verticalData] = DataPointUtil.createVoidDataPoint(generation);
+					break;
+				}
+				
+				yAbs = height - 1;
+				// We search light on above air block
+				depth = determineBottomPointFrom(chunk, config, xRel, zRel, yAbs, blockPos);
+				if (hasCeiling && topBlock)
+				{
+					yAbs = depth;
+					blockPos.set(xAbs, yAbs, zAbs);
+					light = getLightValue(chunk, blockPos, hasCeiling, hasSkyLight, topBlock);
+					color = generateLodColor(chunk, config, xRel, yAbs, zRel, blockPos);
+					blockPos.set(xAbs, yAbs - 1, zAbs);
+				}
+				else
+				{
+					blockPos.set(xAbs, yAbs, zAbs);
+					light = getLightValue(chunk, blockPos, hasCeiling, hasSkyLight, topBlock);
+					color = generateLodColor(chunk, config, xRel, yAbs, zRel, blockPos);
+					blockPos.set(xAbs, yAbs + 1, zAbs);
+				}
+				lightBlock = light & 0b1111;
+				lightSky = (light >> 4) & 0b1111;
+				
+				
+				dataToMerge[index * verticalData + count] = DataPointUtil.createDataPoint(height, depth, color, lightSky, lightBlock, generation);
+				topBlock = false;
+				yAbs = depth - 1;
+				count++;
+			}
+		}
+		return dataToMerge;
+	}
+	
+	/**
+	 * Find the lowest valid point from the bottom.
+	 * Used when creating a vertical LOD.
+	 */
+	private short determineBottomPointFrom(IChunk chunk, LodBuilderConfig config, int xRel, int zRel, int yAbs, BlockPos.Mutable blockPos)
+	{
+		short depth = DEFAULT_DEPTH;
+		if (config.useHeightmap)
+		{
+			// when using the generated heightmap there is no data about the lowest point
+			depth = 0;
+		}
+		else
+		{
+			boolean voidData = true;
+			ChunkSection[] chunkSections = chunk.getSections();
+			for (int sectionIndex = chunkSections.length - 1; sectionIndex >= 0; sectionIndex--)
+			{
+				for (int yRel = CHUNK_DATA_WIDTH - 1; yRel >= 0; yRel--)
+				{
+					if (sectionIndex * CHUNK_DATA_WIDTH + yRel > yAbs)
+						continue;
+					
+					blockPos.set(chunk.getPos().getMinBlockX() + xRel, sectionIndex * CHUNK_DATA_WIDTH + yRel, chunk.getPos().getMinBlockZ() + zRel);
+					if (!isLayerValidLodPoint(chunk, blockPos))
+					{
+						depth = (short) (sectionIndex * CHUNK_DATA_WIDTH + yRel + 1);
+						voidData = false;
+						break;
+					}
+				}
+				
+				if (!voidData)
+					break;
+			}
+		}
+		return depth;
+	}
+	
+	/**
+	 * Find the highest valid point from the Top
+	 */
+	private short determineHeightPointFrom(IChunk chunk, LodBuilderConfig config, int xRel, int zRel, int yAbs, BlockPos.Mutable blockPos)
+	{
+		short height = DEFAULT_HEIGHT;
+		if (config.useHeightmap)
+		{
+			height = (short) chunk.getOrCreateHeightmapUnprimed(LodUtil.DEFAULT_HEIGHTMAP).getFirstAvailable(xRel, zRel);
+		}
+		else
+		{
+			boolean voidData = true;
+			ChunkSection[] chunkSections = chunk.getSections();
+			for (int sectionIndex = chunkSections.length - 1; sectionIndex >= 0; sectionIndex--)
+			{
+				for (int yRel = CHUNK_DATA_WIDTH - 1; yRel >= 0; yRel--)
+				{
+					if (sectionIndex * CHUNK_DATA_WIDTH + yRel > yAbs)
+						continue;
+					blockPos.set(chunk.getPos().getMinBlockX() + xRel, sectionIndex * CHUNK_DATA_WIDTH + yRel, chunk.getPos().getMinBlockZ() + zRel);
+					if (isLayerValidLodPoint(chunk, blockPos))
+					{
+						height = (short) (sectionIndex * CHUNK_DATA_WIDTH + yRel + 1);
+						voidData = false;
+						break;
+					}
+				}
+				if (!voidData)
+					break;
+			}
+		}
+		return height;
+	}
+	
+	/**
+	 * Creates a single HeightMap style LOD data point.
+	 */
+	private long[] createSingleDataToMerge(HorizontalResolution detail, IChunk chunk, LodBuilderConfig config, int startX, int startZ, int endX, int endZ)
+	{
+		long[] dataToMerge = ThreadMapUtil.getBuilderArray(detail.detailLevel);
+		ChunkPos chunkPos = chunk.getPos();
+		
+		int size = 1 << detail.detailLevel;
+		int height = 0;
+		int depth = 0;
+		int color = 0;
+		int light = 0;
+		int generation = config.distanceGenerationMode.complexity;
+		
+		int xRel;
+		int zRel;
+		int xAbs;
+		int yAbs;
+		int zAbs;
+		int lightBlock;
+		int lightSky;
+		
+		boolean hasCeiling = mc.getClientWorld().dimensionType().hasCeiling();
+		boolean hasSkyLight = mc.getClientWorld().dimensionType().hasSkyLight();
+		
+		BlockPos.Mutable blockPos = new BlockPos.Mutable(0, 0, 0);
+		int index = 0;
+		if (dataToMerge == null)
+		{
+			dataToMerge = new long[size * size];
+		}
+		
+		for (index = 0; index < size * size; index++)
+		{
+			xRel = Math.floorMod(index, size) + startX;
+			zRel = Math.floorDiv(index, size) + startZ;
+			xAbs = chunkPos.getMinBlockX() + xRel;
+			zAbs = chunkPos.getMinBlockZ() + zRel;
+			
+			//Calculate the height of the lod
+			height = determineHeightPoint(chunk, config, xRel, zRel, blockPos);
+			
+			//If the lod is at the default height it must be void
+			if (height == DEFAULT_HEIGHT)
+			{
+				dataToMerge[index] = DataPointUtil.createVoidDataPoint(generation);
+				continue;
+			}
+			
+			yAbs = height - 1;
+			
+			
+			color = generateLodColor(chunk, config, xRel, yAbs, zRel, blockPos);
+			depth = determineBottomPoint(chunk, config, xRel, zRel, blockPos);
+			
+			// get the light value from the above air block
+			blockPos.set(xAbs, yAbs + 1, zAbs);
+			light = getLightValue(chunk, blockPos, hasCeiling, hasSkyLight, true);
+			lightBlock = light & 0b1111;
+			
+			
+			lightSky = DEFAULT_MAX_LIGHT;
+			dataToMerge[index] = DataPointUtil.createDataPoint(height, depth, color, lightSky, lightBlock, generation);
+		}
+		return dataToMerge;
+	}
+	
+	
+	
+	// =====================//
+	// constructor helpers //
+	// =====================//
+	
+	/**
+	 * Find the lowest valid point from the bottom.
+	 */
+	private short determineBottomPoint(IChunk chunk, LodBuilderConfig config, int xRel, int zRel, BlockPos.Mutable blockPos)
+	{
+		ChunkSection[] chunkSections = chunk.getSections();
+		short depth = DEFAULT_DEPTH;
+		if (config.useHeightmap)
+		{
+			depth = 0;
+		}
+		else
+		{
+			boolean found = false;
+			for (int sectionIndex = 0; sectionIndex < chunkSections.length; sectionIndex++)
+			{
+				for (int yRel = 0; yRel < CHUNK_DATA_WIDTH; yRel++)
+				{
+					blockPos.set(chunk.getPos().getMinBlockX() + xRel, sectionIndex * CHUNK_DATA_WIDTH + yRel, chunk.getPos().getMinBlockZ() + zRel);
+					if (isLayerValidLodPoint(chunk, blockPos))
+					{
+						depth = (short) (sectionIndex * CHUNK_DATA_WIDTH + yRel);
+						found = true;
+						break;
+					}
+				}
+				
+				if (found)
+					break;
+			}
+		}
+		return depth;
+	}
+	
+	
+	/**
+	 * Find the highest valid point from the Top
+	 */
+	private short determineHeightPoint(IChunk chunk, LodBuilderConfig config, int xRel, int zRel, BlockPos.Mutable blockPos)
+	{
+		short height = DEFAULT_HEIGHT;
+		if (config.useHeightmap)
+		{
+			height = (short) chunk.getOrCreateHeightmapUnprimed(LodUtil.DEFAULT_HEIGHTMAP).getFirstAvailable(xRel, zRel);
+		}
+		else
+		{
+			boolean voidData = true;
+			ChunkSection[] chunkSections = chunk.getSections();
+			for (int sectionIndex = chunkSections.length - 1; sectionIndex >= 0; sectionIndex--)
+			{
+				for (int yRel = CHUNK_DATA_WIDTH - 1; yRel >= 0; yRel--)
+				{
+					blockPos.set(chunk.getPos().getMinBlockX() + xRel, sectionIndex * CHUNK_DATA_WIDTH + yRel, chunk.getPos().getMinBlockZ() + zRel);
+					if (isLayerValidLodPoint(chunk, blockPos))
+					{
+						height = (short) (sectionIndex * CHUNK_DATA_WIDTH + yRel + 1);
+						voidData = false;
+						break;
+					}
+				}
+				
+				if (!voidData)
+					break;
+			}
+		}
+		return height;
+	}
+	
+	/**
+	 * Generate the color for the given chunk using biome water color, foliage
+	 * color, and grass color.
+	 */
+	private int generateLodColor(IChunk chunk, LodBuilderConfig config, int xRel, int yAbs, int zRel, BlockPos.Mutable blockPos)
+	{
+		ChunkSection[] chunkSections = chunk.getSections();
+		int colorInt = 0;
+		if (config.useBiomeColors)
+		{
+			// I have no idea why I need to bit shift to the right, but
+			// if I don't the biomes don't show up correctly.
+			Biome biome = chunk.getBiomes().getNoiseBiome(xRel >> 2, yAbs >> 2, zRel >> 2);
+			colorInt = getColorForBiome(xRel, zRel, biome);
+		}
+		else
+		{
+			int sectionIndex = Math.floorDiv(yAbs, CHUNK_SECTION_HEIGHT);
+			int yRel = Math.floorMod(yAbs, CHUNK_SECTION_HEIGHT);
+			if (chunkSections[sectionIndex] != null)
+			{
+				blockPos.set(chunk.getPos().getMinBlockX() + xRel, sectionIndex * CHUNK_DATA_WIDTH + yRel, chunk.getPos().getMinBlockZ() + zRel);
+				colorInt = getColorForBlock(chunk, blockPos);
+			}
+			
+			if (colorInt == 0 && yAbs > 0)
+				// if this block is invisible, check the block below it
+				colorInt = generateLodColor(chunk, config, xRel, yAbs - 1, zRel, blockPos);
+		}
+		
+		return colorInt;
+	}
+	
+	/**
+	 * Gets the light value for the given block position
+	 */
+	private int getLightValue(IChunk chunk, BlockPos.Mutable blockPos, boolean hasCeiling, boolean hasSkyLight, boolean topBlock)
+	{
+		int skyLight;
+		int blockLight = 0;
+		
+		if (mc.getClientWorld() == null)
+			return 0;
+		
+		ClientWorld world = mc.getClientWorld();
+		
+		
+		int blockBrightness = chunk.getLightEmission(blockPos);
+		
+		if (hasCeiling && topBlock)
+			blockPos.set(blockPos.getX(), blockPos.getY() - 1, blockPos.getZ());
+		else
+			blockPos.set(blockPos.getX(), blockPos.getY() + 1, blockPos.getZ());
+		
+		
+		if (!hasSkyLight && hasCeiling)
+		{
+			skyLight = 0;
+		}
+		else if (topBlock)
+		{
+			skyLight = DEFAULT_MAX_LIGHT;
+		}
+		else
+		{
+			if (chunk.isLightCorrect())
+			{
+				skyLight = world.getBrightness(LightType.SKY, blockPos);
+			}
+			else
+			{
+				// we don't know what the light here is,
+				// lets just take a guess
+				if (blockPos.getY() >= mc.getClientWorld().getSeaLevel() - 5)
+					skyLight = 10;
+				else
+					skyLight = 0;
+			}
+		}
+		
+		blockLight = world.getBrightness(LightType.BLOCK, blockPos);
+		blockLight = LodUtil.clamp(0, blockLight + blockBrightness, DEFAULT_MAX_LIGHT);
+		
+		return blockLight + (skyLight << 4);
+	}
+	
+	
+	/**
+	 * Generate the color of the given block from its texture
+	 * and store it for later use.
+	 */
+	private int getColorTextureForBlock(BlockState blockState, BlockPos blockPos, boolean useTopTexture)
+	{
+		// use the pre-generated color if we can
+		Block block = blockState.getBlock();
+		if (colorMap.containsKey(block) && toTint.containsKey(block))
+			return colorMap.get(block);
+		
+		
+		
+		World world = mc.getClientWorld();
+		TextureAtlasSprite texture;
+		List<BakedQuad> quad = null;
+		
+		// get the first quad we can for this block
+		for (Direction direction : directions)
+		{
+			quad = mc.getModelManager().getBlockModelShaper().getBlockModel(blockState).getQuads(blockState, direction, new Random(0), dataMap);
+			if (!quad.isEmpty())
+				break;
+		}
+		
+		
+		if (!quad.isEmpty())
+			toTint.put(block, quad.get(0).isTinted());
+		else
+			toTint.put(blockState.getBlock(), false);
+		
+		
+		if (useTopTexture && !quad.isEmpty())
+			texture = quad.get(0).getSprite();
+		else
+			texture = mc.getModelManager().getBlockModelShaper().getTexture(blockState, world, blockPos);
+		
+		
+		
+		
+		int count = 0;
+		int alpha = 0;
+		int red = 0;
+		int green = 0;
+		int blue = 0;
+		int numberOfGreyPixel = 0;
+		int color;
+		int colorMultiplier;
+		
+		// generate the block's color
+		for (int frameIndex = 0; frameIndex < texture.getFrameCount(); frameIndex++)
+		{
+			// textures normally use u and v instead of x and y
+			for (int u = 0; u < texture.getHeight(); u++)
+			{
+				for (int v = 0; v < texture.getWidth(); v++)
+				{
+					if (texture.isTransparent(frameIndex, u, v))
+						continue;
+					
+					color = texture.getPixelRGBA(frameIndex, u, v);
+					
+					// determine if this pixel is gray
+					int colorMax = Math.max(Math.max(ColorUtil.getBlue(color), ColorUtil.getGreen(color)), ColorUtil.getRed(color));
+					int colorMin = 4 + Math.min(Math.min(ColorUtil.getBlue(color), ColorUtil.getGreen(color)), ColorUtil.getRed(color));
+					boolean isGray = colorMax < colorMin;
+					if (isGray)
+						numberOfGreyPixel++;
+					
+					
+					// for flowers, weight their non-green color higher
+					if (block instanceof FlowerBlock && (!(ColorUtil.getGreen(color) > (ColorUtil.getBlue(color) + 30)) || !(ColorUtil.getGreen(color) > (ColorUtil.getRed(color) + 30))))
+						colorMultiplier = 5;
+					else
+						colorMultiplier = 1;
+					
+					
+					// add to the running averages
+					count = colorMultiplier + count; // TODO shouldn't colorMultiplier be multiplied by?
+					alpha += ColorUtil.getAlpha(color) * colorMultiplier;
+					red += ColorUtil.getBlue(color) * colorMultiplier;
+					green += ColorUtil.getGreen(color) * colorMultiplier;
+					blue += ColorUtil.getRed(color) * colorMultiplier;
+				}
+			}
+		}
+		
+		
+		if (count == 0)
+		{
+			// this block is entirely transparent
+			color = 0;
+		}
+		else
+		{
+			// determine the average color
+			alpha /= count;
+			red /= count;
+			green /= count;
+			blue /= count;
+			color = ColorUtil.rgbToInt(alpha, red, green, blue);
+		}
+		
+		// determine if this block should use the biome color tint
+		if (block instanceof TallGrassBlock || (useGrassTint(block) || useLeafTint(block) || useWaterTint(block)) && numberOfGreyPixel / count > 0.75f)
+			toTint.replace(block, true);
+		
+		// add the newly generated block color to the map for later use
+		colorMap.put(block, color);
+		
+		return color;
+	}
+	
+	/** determine if the given block should use the biome's grass color */
+	private boolean useGrassTint(Block block)
+	{
+		return block instanceof GrassBlock
+				|| block instanceof BushBlock
+				|| block instanceof IGrowable
+				|| block instanceof AbstractPlantBlock
+				|| block instanceof AbstractTopPlantBlock
+				|| block instanceof TallGrassBlock;
+	}
+	
+	/** determine if the given block should use the biome's foliage color */
+	private boolean useLeafTint(Block block)
+	{
+		return block instanceof LeavesBlock
+				|| block == Blocks.VINE
+				|| block == Blocks.SUGAR_CANE;
+	}
+	
+	/** determine if the given block should use the biome's water color */
+	private boolean useWaterTint(Block block)
+	{
+		return block == Blocks.WATER;
+	}
+	
+	/** Returns a color int for the given block. */
+	private int getColorForBlock(IChunk chunk, BlockPos blockPos)
+	{
+		int blockColor;
+		int colorInt = 0;
+		
+		int xRel = blockPos.getX() - chunk.getPos().getMinBlockX();
+		int zRel = blockPos.getZ() - chunk.getPos().getMinBlockZ();
+		int x = blockPos.getX();
+		int y = blockPos.getY();
+		int z = blockPos.getZ();
+		
+		Biome biome = chunk.getBiomes().getNoiseBiome(xRel >> 2, y >> 2, zRel >> 2);
+		BlockState blockState = chunk.getBlockState(blockPos);
+		
+		
+		
+		// block special cases
+		// TODO: this needs to be replaced by a config file of some sort
+		if (blockState == Blocks.AIR.defaultBlockState()
+				|| blockState == Blocks.CAVE_AIR.defaultBlockState()
+				|| blockState == Blocks.BARRIER.defaultBlockState())
+		{
+			Color tmp = LodUtil.intToColor(biome.getGrassColor(x, z));
+			tmp = tmp.darker();
+			colorInt = LodUtil.colorToInt(tmp);
+		}
+		
+		blockColor = getColorTextureForBlock(blockState, blockPos, true);
+		if (toTint.get(blockState.getBlock()).booleanValue())
+		{
+			if (useLeafTint(blockState.getBlock()))
+			{
+				// leaves
+				colorInt = ColorUtil.multiplyRGBcolors(biome.getFoliageColor(), blockColor);
+			}
+			else if (useGrassTint(blockState.getBlock()))
+			{
+				// grass and green plants
+				colorInt = ColorUtil.multiplyRGBcolors(biome.getGrassColor(x, z), blockColor);
+			}
+			else if (useWaterTint(blockState.getBlock()))
+			{
+				// water
+				colorInt = ColorUtil.multiplyRGBcolors(biome.getWaterColor(), blockColor);
+			}
+		}
+		else
+		{
+			colorInt = blockColor;
+		}
+		
+		return colorInt;
+	}
+	
+	/**
+	 * Returns a color int for the given biome.
+	 */
+	private int getColorForBiome(int x, int z, Biome biome)
+	{
+		int colorInt;
+		
+		switch (biome.getBiomeCategory())
+		{
+		
+		case NETHER:
+			colorInt = LodUtil.NETHERRACK_COLOR_INT;
+			break;
+		
+		case THEEND:
+			colorInt = Blocks.END_STONE.defaultBlockState().materialColor.col;
+			break;
+		
+		case BEACH:
+		case DESERT:
+			colorInt = Blocks.SAND.defaultBlockState().materialColor.col;
+			break;
+		
+		case EXTREME_HILLS:
+			colorInt = Blocks.STONE.defaultMaterialColor().col;
+			break;
+		
+		case MUSHROOM:
+			colorInt = MaterialColor.COLOR_LIGHT_GRAY.col;
+			break;
+		
+		case ICY:
+			colorInt = Blocks.SNOW.defaultMaterialColor().col;
+			break;
+		
+		case MESA:
+			colorInt = Blocks.RED_SAND.defaultMaterialColor().col;
+			break;
+		
+		case OCEAN:
+		case RIVER:
+			colorInt = biome.getWaterColor();
+			break;
+		
+		case NONE:
+		case FOREST:
+		case TAIGA:
+		case JUNGLE:
+		case PLAINS:
+		case SAVANNA:
+		case SWAMP:
+		default:
+			Color tmp = LodUtil.intToColor(biome.getGrassColor(x, z));
+			tmp = tmp.darker();
+			colorInt = LodUtil.colorToInt(tmp);
+			break;
+		
+		}
+		
+		return colorInt;
+	}
+	
+	/** Is the block at the given blockPos a valid LOD point? */
+	private boolean isLayerValidLodPoint(IChunk chunk, BlockPos.Mutable blockPos)
+	{
+		BlockState blockState = chunk.getBlockState(blockPos);
+		
+		
+		if (blockState != null)
+		{
+			// TODO this code is dead since avoidSmallBlock and onlyUseFullBlock
+			// are set to false and are never changed.
+			// should this code be changed?
+			if (avoidSmallBlock || onlyUseFullBlock)
+			{
+				if (!blockState.getFluidState().isEmpty())
+					return true;
+				
+				
+				VoxelShape voxelShape;
+				if (shapeMap.containsKey(blockState.getBlock()))
+				{
+					voxelShape = shapeMap.get(blockState.getBlock());
+					
+				}
+				else
+				{
+					voxelShape = blockState.getShape(chunk, blockPos);
+					shapeMap.put(blockState.getBlock(), voxelShape);
+				}
+				if (!voxelShape.isEmpty())
+				{
+					AxisAlignedBB bbox = voxelShape.bounds();
+					int xWidth = (int) (bbox.maxX - bbox.minX);
+					int yWidth = (int) (bbox.maxY - bbox.minY);
+					int zWidth = (int) (bbox.maxZ - bbox.minZ);
+					if (xWidth < 1 && zWidth < 1 && yWidth < 1 && onlyUseFullBlock)
+					{
+						return false;
+					}
+					if (xWidth < 0.7 && zWidth < 0.7 && yWidth < 1 && avoidSmallBlock)
+					{
+						return false;
+					}
+				}
+				else
+				{
+					return false;
+				}
+			}
+			
+			return blockState.getBlock() != Blocks.AIR
+					&& blockState.getBlock() != Blocks.CAVE_AIR
+					&& blockState.getBlock() != Blocks.BARRIER;
+		}
+		
+		return false;
+	}
+}
@@ -0,0 +1,98 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.builders;
+
+import com.seibel.lod.enums.DistanceGenerationMode;
+
+/**
+ * This is used to easily configure how LodChunks are generated.
+ * Generally this will only be used if we want to generate a
+ * LodChunk using a incomplete Chunk, otherwise the defaults
+ * work best for a fully generated chunk (IE has correct surface blocks).
+ *
+ * @author James Seibel
+ * @version 8-14-2021
+ */
+public class LodBuilderConfig
+{
+	/** default: false */
+	public boolean useHeightmap;
+	/** default: false */
+	public boolean useBiomeColors;
+	/** default: true */
+	public boolean useSolidBlocksInColorGen;
+	/** default: server */
+	public DistanceGenerationMode distanceGenerationMode;
+
+	/**
+	 * default settings for a normal chunk <br>
+	 * useHeightmap = false <br>
+	 * useBiomeColors = false <br>
+	 * useSolidBlocksInColorGen = true <br>
+	 * generationMode = Server <br>
+	 */
+	public LodBuilderConfig()
+	{
+		useHeightmap = false;
+		useBiomeColors = false;
+		useSolidBlocksInColorGen = true;
+		distanceGenerationMode = DistanceGenerationMode.SERVER;
+	}
+
+	/**
+	 * @param newUseHeightmap               default = false
+	 * @param newUseBiomeColors             default = false
+	 * @param newUseSolidBlocksInBiomeColor default = true
+	 * @param newDistanceGenerationMode     default = Server
+	 */
+	public LodBuilderConfig(boolean newUseHeightmap, boolean newUseBiomeColors,
+	                        boolean newUseSolidBlocksInBiomeColor, DistanceGenerationMode newDistanceGenerationMode)
+	{
+		useHeightmap = newUseHeightmap;
+		useBiomeColors = newUseBiomeColors;
+		useSolidBlocksInColorGen = newUseSolidBlocksInBiomeColor;
+		distanceGenerationMode = newDistanceGenerationMode;
+	}
+
+	/**
+	 * @param newUseHeightmap               default = false
+	 * @param newUseBiomeColors             default = false
+	 * @param newUseSolidBlocksInBiomeColor default = true
+	 * @param newDistanceGenerationMode     default = Server
+	 */
+	public LodBuilderConfig(boolean newUseHeightmap, boolean newUseBiomeColors, boolean newUseSolidBlocksInBiomeColor)
+	{
+		this();
+		useHeightmap = newUseHeightmap;
+		useBiomeColors = newUseBiomeColors;
+		useSolidBlocksInColorGen = newUseSolidBlocksInBiomeColor;
+		distanceGenerationMode = newUseHeightmap? DistanceGenerationMode.BIOME_ONLY_SIMULATE_HEIGHT : DistanceGenerationMode.BIOME_ONLY;
+	}
+
+	/**
+	 * @param newUseHeightmap               default = false
+	 * @param newUseBiomeColors             default = false
+	 * @param newUseSolidBlocksInBiomeColor default = true
+	 * @param newDistanceGenerationMode     default = Server
+	 */
+	public LodBuilderConfig(DistanceGenerationMode newDistanceGenerationMode)
+	{
+		this();
+		distanceGenerationMode = newDistanceGenerationMode;
+	}
+}
@@ -0,0 +1,61 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.builders.lodTemplates;
+
+import java.util.Map;
+
+import com.seibel.lod.enums.DebugMode;
+import com.seibel.lod.util.ColorUtil;
+
+import net.minecraft.client.renderer.BufferBuilder;
+import net.minecraft.client.renderer.texture.NativeImage;
+import net.minecraft.util.Direction;
+import net.minecraft.util.math.BlockPos;
+
+/**
+ * This is the abstract class used to create different
+ * BufferBuilders.
+ *
+ * @author James Seibel
+ * @version 8-8-2021
+ */
+public abstract class AbstractLodTemplate
+{
+	
+	/**
+	 * Uploads the given LOD to the buffer.
+	 */
+	public abstract void addLodToBuffer(BufferBuilder buffer, BlockPos bufferCenterBlockPos, long data, Map<Direction, long[]> adjData,
+			byte detailLevel, int posX, int posZ, Box box, DebugMode debugging, NativeImage lightMap);
+	
+	/**
+	 * add the given position and color to the buffer
+	 */
+	protected void addPosAndColor(BufferBuilder buffer,
+			double x, double y, double z,
+			int color)
+	{
+		buffer.vertex(x, y, z).color(ColorUtil.getRed(color), ColorUtil.getGreen(color), ColorUtil.getBlue(color), ColorUtil.getAlpha(color)).endVertex();
+	}
+	
+	/**
+	 * Returns in bytes how much buffer memory is required
+	 * for one LOD object
+	 */
+	public abstract int getBufferMemoryForSingleNode(int maxVerticalData);
+}
@@ -0,0 +1,512 @@
+package com.seibel.lod.builders.lodTemplates;
+
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.Map;
+
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DebugMode;
+import com.seibel.lod.util.ColorUtil;
+import com.seibel.lod.util.DataPointUtil;
+import com.seibel.lod.wrappers.MinecraftWrapper;
+
+import net.minecraft.util.Direction;
+import net.minecraft.util.math.BlockPos;
+
+/**
+ * Similar to Minecraft's AxisAlignedBoundingBox.
+ * 
+ * @author Leonardo Amato
+ * @version 9-25-2021
+ */
+public class Box
+{
+	
+	public static final int ADJACENT_HEIGHT_INDEX = 0;
+	public static final int ADJACENT_DEPTH_INDEX = 1;
+	
+	public static final int X = 0;
+	public static final int Y = 1;
+	public static final int Z = 2;
+	
+	public static final int MIN = 0;
+	public static final int MAX = 1;
+	
+	public static final int VOID_FACE = 0;
+	
+	/** The six cardinal directions */
+	public static final Direction[] DIRECTIONS = new Direction[]{
+			Direction.UP,
+			Direction.DOWN,
+			Direction.WEST,
+			Direction.EAST,
+			Direction.NORTH,
+			Direction.SOUTH};
+	
+	/** North, South, East, West */
+	public static final Direction[] ADJ_DIRECTIONS = new Direction[]{
+			Direction.EAST,
+			Direction.WEST,
+			Direction.SOUTH,
+			Direction.NORTH};
+	
+	/** TODO what does this represent? I don't understand the name */
+	@SuppressWarnings("serial")
+	public static final Map<Direction, int[][]> DIRECTION_VERTEX_MAP = new HashMap<Direction, int[][]>()
+	{{
+		put(Direction.UP, new int[][]{
+			{0, 1, 0},
+			{0, 1, 1},
+			{1, 1, 1},
+			{1, 1, 0}});
+		put(Direction.DOWN, new int[][]{
+			{1, 0, 0},
+			{1, 0, 1},
+			{0, 0, 1},
+			{0, 0, 0}});
+		put(Direction.EAST, new int[][]{
+			{1, 1, 0},
+			{1, 1, 1},
+			{1, 0, 1},
+			{1, 0, 0}});
+		put(Direction.WEST, new int[][]{
+			{0, 0, 0},
+			{0, 0, 1},
+			{0, 1, 1},
+			{0, 1, 0}});
+		put(Direction.SOUTH, new int[][]{
+			{1, 0, 1},
+			{1, 1, 1},
+			{0, 1, 1},
+			{0, 0, 1}});
+		put(Direction.NORTH, new int[][]{
+			{0, 0, 0},
+			{0, 1, 0},
+			{1, 1, 0},
+			{1, 0, 0}});
+	}};
+	
+	
+	@SuppressWarnings("serial")
+	public static final Map<Direction, int[]> FACE_DIRECTION = new HashMap<Direction, int[]>()
+	{{
+		put(Direction.UP, new int[]{Y, MAX});
+		put(Direction.DOWN, new int[]{Y, MIN});
+		put(Direction.EAST, new int[]{X, MAX});
+		put(Direction.WEST, new int[]{X, MIN});
+		put(Direction.SOUTH, new int[]{Z, MAX});
+		put(Direction.NORTH, new int[]{Z, MIN});
+	}};
+	
+	@SuppressWarnings("serial")
+	public static final Map<Direction, int[]> DIRECTION_NORMAL_MAP = new HashMap<Direction, int[]>()
+	{{
+		put(Direction.UP, new int[]{0, 1, 0});
+		put(Direction.DOWN, new int[]{0, -1, 0});
+		put(Direction.EAST, new int[]{1, 0, 0});
+		put(Direction.WEST, new int[]{-1, 0, 0});
+		put(Direction.SOUTH, new int[]{0, 0, 1});
+		put(Direction.NORTH, new int[]{0, 0, -1});
+	}};
+	
+	/** holds the box's x, y, z offset */
+	public int[] boxOffset;
+	/** holds the box's x, y, z width */
+	public int[] boxWidth;
+	
+	/** Holds each direction's color */
+	public Map<Direction, Integer> colorMap;
+	/** The original color (before shading) of this box */
+	public int color;
+	/**  */
+	public Map<Direction, int[]> adjHeight;
+	public Map<Direction, int[]> adjDepth;
+	
+	/** Holds if the given direction should be culled or not */
+	public Map<Direction, Boolean> culling;
+	
+	
+	/** creates a empty box */
+	@SuppressWarnings("serial")
+	public Box()
+	{
+		boxOffset = new int[3];
+		boxWidth = new int[3];
+		
+		colorMap = new HashMap<Direction, Integer>()
+		{{
+			put(Direction.UP, 0);
+			put(Direction.DOWN, 0);
+			put(Direction.EAST, 0);
+			put(Direction.WEST, 0);
+			put(Direction.SOUTH, 0);
+			put(Direction.NORTH, 0);
+		}};
+		
+		// TODO what does the 32 represent?
+		adjHeight = new HashMap<Direction, int[]>()
+		{{
+			put(Direction.EAST, new int[32]);
+			put(Direction.WEST, new int[32]);
+			put(Direction.SOUTH, new int[32]);
+			put(Direction.NORTH, new int[32]);
+		}};
+		adjDepth = new HashMap<Direction, int[]>()
+		{{
+			put(Direction.EAST, new int[32]);
+			put(Direction.WEST, new int[32]);
+			put(Direction.SOUTH, new int[32]);
+			put(Direction.NORTH, new int[32]);
+		}};
+		
+		culling = new HashMap<Direction, Boolean>()
+		{{
+			put(Direction.UP, false);
+			put(Direction.DOWN, false);
+			put(Direction.EAST, false);
+			put(Direction.WEST, false);
+			put(Direction.SOUTH, false);
+			put(Direction.NORTH, false);
+		}};
+	}
+	
+	
+	
+	public void setColor(int color)
+	{
+		this.color = color;
+		for (Direction direction : DIRECTIONS)
+		{
+			colorMap.put(direction, ColorUtil.applyShade(color, MinecraftWrapper.INSTANCE.getClientWorld().getShade(direction, true)));
+		}
+	}
+	
+	public int getColor(Direction direction)
+	{
+		if (LodConfig.CLIENT.debugging.debugMode.get() != DebugMode.SHOW_DETAIL)
+		{
+			return colorMap.get(direction);
+		}
+		else
+		{
+			return ColorUtil.applyShade(color, MinecraftWrapper.INSTANCE.getClientWorld().getShade(direction, true));
+		}
+	}
+	
+	
+	/** clears this box, reseting everything to default values */
+	public void reset()
+	{
+		Arrays.fill(boxWidth, 0);
+		Arrays.fill(boxOffset, 0);
+		
+		for (Direction direction : DIRECTIONS)
+		{
+			colorMap.put(direction, 0);
+		}
+		
+		for (Direction direction : ADJ_DIRECTIONS)
+		{
+			// TODO wouldn't we want to set all adjHeightAndDepth
+			// to VOID_FACE regardless of the culled status?
+			if (isCulled(direction))
+				continue;
+			
+			for (int i = 0; i < adjHeight.get(direction).length; i++)
+			{
+				adjHeight.get(direction)[i] = VOID_FACE;
+				adjDepth.get(direction)[i] = VOID_FACE;
+			}
+		}
+	}
+	
+	/** determine which faces should be culled */
+	public void setUpCulling(int cullingDistance, BlockPos playerPos)
+	{
+		for (Direction direction : DIRECTIONS)
+		{
+			if (direction == Direction.DOWN)
+				culling.put(direction, playerPos.get(direction.getAxis()) > getFacePos(direction) + cullingDistance);
+			else if (direction == Direction.UP)
+				culling.put(direction, playerPos.get(direction.getAxis()) < getFacePos(direction) - cullingDistance);
+			else if (direction == Direction.WEST)
+				culling.put(direction, -playerPos.get(direction.getAxis()) > getFacePos(direction) + cullingDistance);
+			else if (direction == Direction.NORTH)
+				culling.put(direction, -playerPos.get(direction.getAxis()) > getFacePos(direction) + cullingDistance);
+			else if (direction == Direction.EAST)
+				culling.put(direction, -playerPos.get(direction.getAxis()) < getFacePos(direction) - cullingDistance);
+			else if (direction == Direction.SOUTH)
+				culling.put(direction, -playerPos.get(direction.getAxis()) < getFacePos(direction) - cullingDistance);
+		}
+	}
+	
+	public boolean isCulled(Direction direction)
+	{
+		return culling.get(direction);
+	}
+	
+	public void setAdjData(Map<Direction, long[]> adjData)
+	{
+		int height;
+		int depth;
+		int minY = getMinY();
+		int maxY = getMaxY();
+		for (Direction direction : ADJ_DIRECTIONS)
+		{
+			long[] dataPoint = adjData.get(direction);
+			if (dataPoint == null || DataPointUtil.isVoid(dataPoint[0]))
+			{
+				adjHeight.get(direction)[0] = maxY;
+				adjDepth.get(direction)[0] = minY;
+				adjHeight.get(direction)[1] = VOID_FACE;
+				adjDepth.get(direction)[1] = VOID_FACE;
+				continue;
+			}
+			
+			//We order the adj list
+			/**TODO remove this if the order is maintained naturally*/
+			/*order[0] = 0;
+			int count = 0;
+			for (int i = 0; i < dataPoint.length; i++)
+			{
+				int j = i - 1;
+				if(DataPointUtil.isItVoid(dataPoint[i]) || !DataPointUtil.doesItExist(dataPoint[i]))
+				{
+					continue;
+				}
+				while (j >= 0 && DataPointUtil.getHeight(order[j]) < DataPointUtil.getHeight(dataPoint[i]))
+				{
+					order[j + 1] = order[j];
+					j = j - 1;
+				}
+				order[j + 1] = dataPoint[i];
+				count++;
+			}*/
+			
+			int i;
+			int faceToDraw = 0;
+			boolean firstFace = true;
+			boolean toFinish = false;
+			boolean allAbove = true;
+			long singleAdjDataPoint;
+			for (i = 0; i < dataPoint.length; i++)
+			{
+				singleAdjDataPoint = dataPoint[i];
+				
+				if(DataPointUtil.isVoid(singleAdjDataPoint) || !DataPointUtil.doesItExist(singleAdjDataPoint))
+					break;
+				
+				height = DataPointUtil.getHeight(singleAdjDataPoint);
+				depth = DataPointUtil.getDepth(singleAdjDataPoint);
+				
+				if (depth <= maxY)
+				{
+					allAbove = false;
+					if (height < minY)
+					{
+						// the adj data is lower than the current data
+						
+						if (firstFace)
+						{
+							adjHeight.get(direction)[0] = getMaxY();
+							adjDepth.get(direction)[0] = getMinY();
+						}
+						else
+						{
+							adjDepth.get(direction)[faceToDraw] = getMinY();
+						}
+						faceToDraw++;
+						toFinish = false;
+						
+						// break since all the other data will be lower
+						break;
+					}
+					else if (depth <= minY && height >= maxY)
+					{
+						// the adj data is inside the current data
+						// don't draw the face
+						adjHeight.get(direction)[0] = VOID_FACE;
+						adjDepth.get(direction)[0] = VOID_FACE;
+						break;
+					}
+					else if (depth <= minY)//&& height < maxY
+					{
+						// the adj data intersects the lower part of the current data
+						// if this is the only face, use the maxY and break,
+						// if there was another face we finish the last one and break
+						if (firstFace)
+						{
+							adjHeight.get(direction)[0] = getMaxY();
+							adjDepth.get(direction)[0] = height;
+						}
+						else
+						{
+							adjDepth.get(direction)[faceToDraw] = height;
+						}
+						toFinish = false;
+						faceToDraw++;
+						break;
+					}
+					else if (height >= maxY)//depth > minY &&
+					{
+						// the adj data intersects the higher part of the current data
+						// we start the creation of a new face
+						adjHeight.get(direction)[faceToDraw] = depth;
+						firstFace = false;
+						toFinish = true;
+					}
+					else
+					{
+						// if (depth > minY && height < maxY)
+						
+						// the adj data is contained in the current data
+						if (firstFace)
+						{
+							adjHeight.get(direction)[0] = getMaxY();
+						}
+						
+						adjDepth.get(direction)[faceToDraw] = height;
+						faceToDraw++;
+						adjHeight.get(direction)[faceToDraw] = depth;
+						firstFace = false;
+						toFinish = true;
+					}
+				}
+				//else
+				//{
+				//	// the adj data is higher than the current data
+				//	// we continue since there could be some other data that intersect the current
+				//}
+			}
+			
+			if(allAbove)
+			{
+				adjHeight.get(direction)[0] = getMaxY();
+				adjDepth.get(direction)[0] = getMinY();
+				faceToDraw++;
+			}
+			else if (toFinish)
+			{
+				adjDepth.get(direction)[faceToDraw] = minY;
+				faceToDraw++;
+			}
+			
+			adjHeight.get(direction)[faceToDraw] = VOID_FACE;
+			adjDepth.get(direction)[faceToDraw] = VOID_FACE;
+		}
+	}
+	
+	public void setWidth(int xWidth, int yWidth, int zWidth)
+	{
+		boxWidth[X] = xWidth;
+		boxWidth[Y] = yWidth;
+		boxWidth[Z] = zWidth;
+	}
+	
+	public void setOffset(int xOffset, int yOffset, int zOffset)
+	{
+		boxOffset[X] = xOffset;
+		boxOffset[Y] = yOffset;
+		boxOffset[Z] = zOffset;
+	}
+	
+	
+	// TODO what does this mean?
+	public int getFacePos(Direction direction)
+	{
+		return boxOffset[FACE_DIRECTION.get(direction)[0]] + boxWidth[FACE_DIRECTION.get(direction)[0]] * FACE_DIRECTION.get(direction)[1];
+	}
+	
+	// TODO is this still needed?
+//	public int getCoord(Direction direction, int axis, int vertexIndex)
+//	{
+//		return box[OFFSET][axis] + boxWidth[axis] * DIRECTION_VERTEX_MAP.get(direction)[vertexIndex][axis];
+//	}
+	
+	/**
+	 * returns true if the given direction should be rendered.
+	 */
+	public boolean shouldRenderFace(Direction direction, int adjIndex)
+	{
+		if (direction == Direction.UP || direction == Direction.DOWN)
+		{
+			return adjIndex == 0;
+		}
+		return !(adjHeight.get(direction)[adjIndex] == VOID_FACE && adjDepth.get(direction)[adjIndex] == VOID_FACE);
+	}
+	
+	
+	
+	
+	// TODO what does vertexIndex mean, is it 0-3 and represent
+	// the 4 vertices in the quad we send to the bufferBuilder?
+	
+	public int getX(Direction direction, int vertexIndex)
+	{
+		return boxOffset[X] + boxWidth[X] * DIRECTION_VERTEX_MAP.get(direction)[vertexIndex][X];
+	}
+	
+	public int getY(Direction direction, int vertexIndex)
+	{
+		return boxOffset[Y] + boxWidth[Y] * DIRECTION_VERTEX_MAP.get(direction)[vertexIndex][Y];
+	}
+	
+	public int getY(Direction direction, int vertexIndex, int adjIndex)
+	{
+		if (direction == Direction.DOWN || direction == Direction.UP)
+		{
+			return boxOffset[Y] + boxWidth[Y] * DIRECTION_VERTEX_MAP.get(direction)[vertexIndex][Y];
+		}
+		else
+		{
+			// this could probably be cleaned up more,
+			// but it still works
+			if (1 - DIRECTION_VERTEX_MAP.get(direction)[vertexIndex][Y] == ADJACENT_HEIGHT_INDEX)
+			{
+				return adjHeight.get(direction)[adjIndex];
+			}
+			else
+			{
+				return adjDepth.get(direction)[adjIndex];	
+			}
+		}
+	}
+	
+	public int getZ(Direction direction, int vertexIndex)
+	{
+		return boxOffset[Z] + boxWidth[Z] * DIRECTION_VERTEX_MAP.get(direction)[vertexIndex][Z];
+	}
+	
+	
+	
+	public int getMinX()
+	{
+		return boxOffset[X];
+	}
+	
+	public int getMaxX()
+	{
+		return boxOffset[X] + boxWidth[X];
+	}
+	
+	public int getMinY()
+	{
+		return boxOffset[Y];
+	}
+	
+	public int getMaxY()
+	{
+		return boxOffset[Y] + boxWidth[Y];
+	}
+	
+	public int getMinZ()
+	{
+		return boxOffset[Z];
+	}
+	
+	public int getMaxZ()
+	{
+		return boxOffset[Z] + boxWidth[Z];
+	}
+	
+}
@@ -0,0 +1,134 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.builders.lodTemplates;
+
+import java.util.Map;
+
+import com.seibel.lod.enums.DebugMode;
+import com.seibel.lod.util.DataPointUtil;
+import com.seibel.lod.util.LodUtil;
+
+import net.minecraft.client.renderer.BufferBuilder;
+import net.minecraft.client.renderer.texture.NativeImage;
+import net.minecraft.util.Direction;
+import net.minecraft.util.math.BlockPos;
+
+/**
+ * Builds LODs as rectangular prisms.
+ *
+ * @author James Seibel
+ * @version 9-25-2021
+ */
+public class CubicLodTemplate extends AbstractLodTemplate
+{
+	
+	public CubicLodTemplate()
+	{
+		
+	}
+	
+	@Override
+	public void addLodToBuffer(BufferBuilder buffer, BlockPos bufferCenterBlockPos, long data, Map<Direction, long[]> adjData,
+			byte detailLevel, int posX, int posZ, Box box, DebugMode debugging, NativeImage lightMap)
+	{
+		if (box == null)
+			return;
+		
+		// equivalent to 2^detailLevel
+		int blockWidth = 1 << detailLevel;
+		
+		int color;
+		if (debugging != DebugMode.OFF)
+			color = LodUtil.DEBUG_DETAIL_LEVEL_COLORS[detailLevel].getRGB();
+		else
+			color = DataPointUtil.getLightColor(data, lightMap);
+		
+		
+		generateBoundingBox(
+				box,
+				DataPointUtil.getHeight(data),
+				DataPointUtil.getDepth(data),
+				blockWidth,
+				posX * blockWidth, 0, posZ * blockWidth, // x, y, z offset
+				bufferCenterBlockPos,
+				adjData,
+				color);
+		
+		addBoundingBoxToBuffer(buffer, box);
+	}
+	
+	private void generateBoundingBox(Box box, 
+			int height, int depth, int width, 
+			double xOffset, double yOffset, double zOffset, 
+			BlockPos bufferCenterBlockPos, 
+			Map<Direction, long[]> adjData, 
+			int color)
+	{
+		// don't add an LOD if it is empty
+		if (height == -1 && depth == -1)
+			return;
+		
+		if (depth == height)
+		{
+			// if the top and bottom points are at the same height
+			// render this LOD as 1 block thick
+			height++;
+		}
+		
+		// offset the AABB by it's x/z position in the world since
+		// it uses doubles to specify its location, unlike the model view matrix
+		// which only uses floats
+		double x = -bufferCenterBlockPos.getX();
+		double z = -bufferCenterBlockPos.getZ();
+		box.reset();
+		box.setColor(color);
+		box.setWidth(width, height - depth, width);
+		box.setOffset((int) (xOffset + x), (int) (depth + yOffset), (int) (zOffset + z));
+		box.setUpCulling(32, bufferCenterBlockPos);
+		box.setAdjData(adjData);
+	}
+	
+	private void addBoundingBoxToBuffer(BufferBuilder buffer, Box box)
+	{
+		for (Direction direction : Box.DIRECTIONS)
+		{
+			// TODO what does adjacentIndex mean?
+			int adjIndex = 0;
+			while (box.shouldRenderFace(direction, adjIndex))
+			{
+				for (int vertexIndex = 0; vertexIndex < 4; vertexIndex++)
+				{
+					addPosAndColor(buffer,
+							box.getX(direction, vertexIndex),
+							box.getY(direction, vertexIndex, adjIndex),
+							box.getZ(direction, vertexIndex),
+							box.getColor(direction));
+				}
+				adjIndex++;
+			}
+		}
+	}
+	
+	@Override
+	public int getBufferMemoryForSingleNode(int maxVerticalData)
+	{
+		// TODO, what do these magic numbers mean
+		return 2 * 4 * (3 + 4) + 4 * 4 * Math.max((maxVerticalData+1)/2,1) * (3 + 4);
+	}
+	
+}
@@ -0,0 +1,53 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.builders.lodTemplates;
+
+import java.util.Map;
+
+import com.seibel.lod.enums.DebugMode;
+import com.seibel.lod.proxy.ClientProxy;
+
+import net.minecraft.client.renderer.BufferBuilder;
+import net.minecraft.client.renderer.texture.NativeImage;
+import net.minecraft.util.Direction;
+import net.minecraft.util.math.BlockPos;
+
+/**
+ * TODO DynamicLodTemplate
+ * Chunks smoothly transition between
+ * each other, unless a neighboring chunk
+ * is at a significantly different height.
+ *
+ * @author James Seibel
+ * @version 06-16-2021
+ */
+public class DynamicLodTemplate extends AbstractLodTemplate
+{
+	@Override
+	public void addLodToBuffer(BufferBuilder buffer, BlockPos bufferCenterBlockPos, long data, Map<Direction, long[]> adjData,
+	                           byte detailLevel, int posX, int posZ, Box box, DebugMode debugging, NativeImage lightMap)
+	{
+		ClientProxy.LOGGER.error(DynamicLodTemplate.class.getSimpleName() + " is not implemented!");
+	}
+
+	@Override
+	public int getBufferMemoryForSingleNode(int maxVerticalData)
+	{
+		return 0;
+	}
+}
@@ -0,0 +1,51 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.builders.lodTemplates;
+
+import java.util.Map;
+
+import com.seibel.lod.enums.DebugMode;
+import com.seibel.lod.proxy.ClientProxy;
+
+import net.minecraft.client.renderer.BufferBuilder;
+import net.minecraft.client.renderer.texture.NativeImage;
+import net.minecraft.util.Direction;
+import net.minecraft.util.math.BlockPos;
+
+/**
+ * TODO #21 TriangularLodTemplate
+ * Builds each LOD chunk as a singular rectangular prism.
+ *
+ * @author James Seibel
+ * @version 06-16-2021
+ */
+public class TriangularLodTemplate extends AbstractLodTemplate
+{
+	@Override
+	public void addLodToBuffer(BufferBuilder buffer, BlockPos bufferCenterBlockPos, long data, Map<Direction, long[]> adjData,
+	                           byte detailLevel, int posX, int posZ, Box box, DebugMode debugging, NativeImage lightMap)
+	{
+		ClientProxy.LOGGER.error(DynamicLodTemplate.class.getSimpleName() + " is not implemented!");
+	}
+
+	@Override
+	public int getBufferMemoryForSingleNode(int maxVerticalData)
+	{
+		return 0;
+	}
+}
@@ -0,0 +1,651 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.builders.worldGeneration;
+
+import java.util.ConcurrentModificationException;
+import java.util.HashSet;
+import java.util.LinkedList;
+import java.util.List;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+import java.util.function.Supplier;
+
+import com.google.common.util.concurrent.ThreadFactoryBuilder;
+import com.seibel.lod.builders.LodBuilder;
+import com.seibel.lod.builders.LodBuilderConfig;
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.proxy.ClientProxy;
+import com.seibel.lod.util.LodThreadFactory;
+import com.seibel.lod.util.LodUtil;
+
+import net.minecraft.block.Block;
+import net.minecraft.block.BlockState;
+import net.minecraft.util.math.ChunkPos;
+import net.minecraft.util.palette.UpgradeData;
+import net.minecraft.util.registry.Registry;
+import net.minecraft.world.biome.Biome;
+import net.minecraft.world.chunk.ChunkPrimer;
+import net.minecraft.world.chunk.ChunkStatus;
+import net.minecraft.world.chunk.IChunk;
+import net.minecraft.world.gen.ChunkGenerator;
+import net.minecraft.world.gen.Heightmap;
+import net.minecraft.world.gen.blockstateprovider.WeightedBlockStateProvider;
+import net.minecraft.world.gen.feature.BlockClusterFeatureConfig;
+import net.minecraft.world.gen.feature.ConfiguredFeature;
+import net.minecraft.world.gen.feature.DecoratedFeatureConfig;
+import net.minecraft.world.gen.feature.FeatureSpread;
+import net.minecraft.world.gen.feature.FeatureSpreadConfig;
+import net.minecraft.world.gen.feature.IceAndSnowFeature;
+import net.minecraft.world.gen.feature.NoFeatureConfig;
+import net.minecraft.world.gen.placement.ConfiguredPlacement;
+import net.minecraft.world.gen.placement.DecoratedPlacementConfig;
+import net.minecraft.world.gen.placement.IPlacementConfig;
+import net.minecraft.world.gen.placement.NoiseDependant;
+import net.minecraft.world.server.ServerChunkProvider;
+import net.minecraft.world.server.ServerWorld;
+import net.minecraft.world.server.ServerWorldLightManager;
+import net.minecraftforge.common.WorldWorkerManager.IWorker;
+
+/**
+ * This is used to generate a LodChunk at a given ChunkPos.
+ *
+ * @author James Seibel
+ * @version 9-7-2021
+ */
+public class LodNodeGenWorker implements IWorker
+{
+	public static ExecutorService genThreads = Executors.newFixedThreadPool(LodConfig.CLIENT.threading.numberOfWorldGenerationThreads.get(), new ThreadFactoryBuilder().setNameFormat("Gen-Worker-Thread-%d").build());
+	
+	private boolean threadStarted = false;
+	private LodChunkGenThread thread;
+	
+	
+	/** If a configured feature fails for whatever reason,
+	 * add it to this list, this is to hopefully remove any
+	 * features that could cause issues down the line. */
+	private static ConcurrentHashMap<Integer, ConfiguredFeature<?, ?>> configuredFeaturesToAvoid = new ConcurrentHashMap<>();
+	
+	
+	
+	public LodNodeGenWorker(ChunkPos newPos, DistanceGenerationMode newGenerationMode,
+			LodBuilder newLodBuilder,
+			LodDimension newLodDimension, ServerWorld newServerWorld)
+	{
+		// just a few sanity checks
+		if (newPos == null)
+			throw new IllegalArgumentException("LodChunkGenWorker must have a non-null ChunkPos");
+		
+		if (newLodBuilder == null)
+			throw new IllegalArgumentException("LodChunkGenThread requires a non-null LodChunkBuilder");
+		
+		if (newLodDimension == null)
+			throw new IllegalArgumentException("LodChunkGenThread requires a non-null LodDimension");
+		
+		if (newServerWorld == null)
+			throw new IllegalArgumentException("LodChunkGenThread requires a non-null ServerWorld");
+		
+		
+		
+		thread = new LodChunkGenThread(newPos, newGenerationMode,
+				newLodBuilder,
+				newLodDimension, newServerWorld);
+	}
+	
+	@Override
+	public boolean doWork()
+	{
+		if (!threadStarted)
+		{
+			if (LodConfig.CLIENT.worldGenerator.distanceGenerationMode.get() == DistanceGenerationMode.SERVER)
+			{
+				// if we are using SERVER generation that has to be done
+				// synchronously to prevent crashing and harmful
+				// interactions with the normal world generator
+				thread.run();
+			}
+			else
+			{
+				// Every other method can
+				// be done asynchronously
+				Thread newThread = new Thread(thread);
+				newThread.setPriority(5);
+				genThreads.execute(newThread);
+			}
+			
+			threadStarted = true;
+			
+			// useful for debugging
+//        	ClientProxy.LOGGER.info(thread.lodDim.getNumberOfLods());
+//        	ClientProxy.LOGGER.info(genThreads.toString());
+		}
+		
+		return false;
+	}
+	
+	@Override
+	public boolean hasWork()
+	{
+		return !threadStarted;
+	}
+	
+	
+	
+	
+	private class LodChunkGenThread implements Runnable
+	{
+		public final ServerWorld serverWorld;
+		public final LodDimension lodDim;
+		public final DistanceGenerationMode generationMode;
+		public final LodBuilder lodBuilder;
+		
+		private ChunkPos pos;
+		
+		public LodChunkGenThread(ChunkPos newPos, DistanceGenerationMode newGenerationMode,
+				LodBuilder newLodBuilder,
+				LodDimension newLodDimension, ServerWorld newServerWorld)
+		{
+			pos = newPos;
+			generationMode = newGenerationMode;
+			lodBuilder = newLodBuilder;
+			lodDim = newLodDimension;
+			serverWorld = newServerWorld;
+		}
+		
+		@Override
+		public void run()
+		{
+			try
+			{
+				// only generate LodChunks if they can
+				// be added to the current LodDimension
+				
+				/**TODO i must disable this if, i will find a way to replace it*/
+				if (lodDim.regionIsInRange(pos.x / LodUtil.REGION_WIDTH_IN_CHUNKS, pos.z / LodUtil.REGION_WIDTH_IN_CHUNKS))
+				{
+//					long startTime = System.currentTimeMillis();
+					
+					switch(generationMode)
+					{
+					case NONE:
+						// don't generate
+						break;
+					case BIOME_ONLY:
+					case BIOME_ONLY_SIMULATE_HEIGHT:
+						// fastest
+						generateUsingBiomesOnly();
+						break;
+					case SURFACE:
+						// faster
+						generateUsingSurface();
+						break;
+					case FEATURES:
+						// fast
+						generateUsingFeatures();
+						break;
+					case SERVER:
+						// very slow
+						generateWithServer();
+						break;
+					}
+					
+					//lodRenderer.regenerateLODsNextFrame();
+					
+/*
+					boolean dataExistence = lodDim.doesDataExist(new LevelPos((byte) 3, pos.x, pos.z));
+					if (dataExistence)
+						ClientProxy.LOGGER.info(pos.x + " " + pos.z + " Success!");
+					else
+						ClientProxy.LOGGER.info(pos.x + " " + pos.z);
+ */
+					// shows the pool size, active threads, queued tasks and completed tasks
+//					ClientProxy.LOGGER.info(genThreads.toString());
+					
+//					long endTime = System.currentTimeMillis();
+//					System.out.println(endTime - startTime);
+					
+				}// if in range
+			}
+			catch (Exception e)
+			{
+				ClientProxy.LOGGER.error(LodChunkGenThread.class.getSimpleName() + ": ran into an error: " + e.getMessage());
+				e.printStackTrace();
+			}
+			finally
+			{
+				// decrement how many threads are running
+				LodWorldGenerator.INSTANCE.numberOfChunksWaitingToGenerate.addAndGet(-1);
+				
+				// this position is no longer being generated
+				LodWorldGenerator.INSTANCE.positionsWaitingToBeGenerated.remove(pos);
+			}
+			
+		}// run
+		
+		
+		
+		/**
+		 * takes about 2-5 ms
+		 */
+		private void generateUsingBiomesOnly()
+		{
+			List<IChunk> chunkList = new LinkedList<>();
+			ChunkPrimer chunk = new ChunkPrimer(pos, UpgradeData.EMPTY);
+			chunkList.add(chunk);
+			
+			ServerChunkProvider chunkSource = serverWorld.getChunkSource();
+			ChunkGenerator chunkGen = chunkSource.generator;
+			
+			// generate the terrain (this is thread safe)
+			ChunkStatus.EMPTY.generate(serverWorld, chunkGen, serverWorld.getStructureManager(), (ServerWorldLightManager) serverWorld.getLightEngine(), null, chunkList);
+			// override the chunk status so we can run the next generator stage
+			chunk.setStatus(ChunkStatus.STRUCTURE_REFERENCES);
+			chunkGen.createBiomes(serverWorld.registryAccess().registryOrThrow(Registry.BIOME_REGISTRY), chunk);
+			chunk.setStatus(ChunkStatus.STRUCTURE_REFERENCES);
+			
+			
+			
+			
+			// generate fake height data for this LOD
+			int seaLevel = serverWorld.getSeaLevel();
+			
+			boolean simulateHeight = generationMode == DistanceGenerationMode.BIOME_ONLY_SIMULATE_HEIGHT;
+			boolean inTheEnd = false;
+			
+			// add fake heightmap data so our LODs aren't at height 0
+			Heightmap heightmap = new Heightmap(chunk, LodUtil.DEFAULT_HEIGHTMAP);
+			for(int x = 0; x < LodUtil.CHUNK_WIDTH && !inTheEnd; x++)
+			{
+				for(int z = 0; z < LodUtil.CHUNK_WIDTH && !inTheEnd; z++)
+				{
+					if (simulateHeight)
+					{
+						// these heights are of course aren't super accurate,
+						// they are just to simulate height data where there isn't any
+						switch(chunk.getBiomes().getNoiseBiome(x >> 2, seaLevel >> 2, z >> 2).getBiomeCategory())
+						{
+						case NETHER:
+							heightmap.setHeight(x, z, serverWorld.getHeight() / 2);
+							break;
+							
+						case EXTREME_HILLS:
+							heightmap.setHeight(x, z, seaLevel + 30);
+							break;
+						case MESA:
+							heightmap.setHeight(x, z, seaLevel + 20);
+							break;
+						case JUNGLE:
+							heightmap.setHeight(x, z, seaLevel + 20);
+							break;
+						case BEACH:
+							heightmap.setHeight(x, z, seaLevel + 5);
+							break;
+						case NONE:
+							heightmap.setHeight(x, z, 0);
+							break;
+							
+						case OCEAN:
+						case RIVER:
+							heightmap.setHeight(x, z, seaLevel);
+							break;
+							
+						case THEEND:
+							inTheEnd = true;
+							break;
+							
+							// DESERT
+							// FOREST
+							// ICY
+							// MUSHROOM
+							// SAVANNA
+							// SWAMP
+							// TAIGA
+							// PLAINS
+						default:
+							heightmap.setHeight(x, z, seaLevel + 10);
+							break;
+						}// heightmap switch
+					}
+					else
+					{
+						// we aren't simulating height
+						// always use sea level
+						heightmap.setHeight(x, z, seaLevel);
+					}
+				}// z
+			}// x
+			
+			chunk.setHeightmap(LodUtil.DEFAULT_HEIGHTMAP, heightmap.getRawData());
+			
+			
+			if (!inTheEnd)
+			{
+				lodBuilder.generateLodNodeFromChunk(lodDim, chunk, new LodBuilderConfig(true, true, false));
+			}
+			else
+			{
+				// if we are in the end, don't generate any chunks.
+				// Since we don't know where the islands are, everything
+				// generates the same and it looks really bad.
+				lodBuilder.generateLodNodeFromChunk(lodDim, chunk, new LodBuilderConfig(true, true, false));
+			}
+			
+			
+//			long startTime = System.currentTimeMillis();
+//			long endTime = System.currentTimeMillis();
+//			System.out.println(endTime - startTime);
+		}
+		
+		
+		/**
+		 * takes about 10 - 20 ms
+		 */
+		private void generateUsingSurface()
+		{
+			List<IChunk> chunkList = new LinkedList<>();
+			ChunkPrimer chunk = new ChunkPrimer(pos, UpgradeData.EMPTY);
+			chunkList.add(chunk);
+			LodServerWorld lodServerWorld = new LodServerWorld(serverWorld, chunk);
+			
+			ServerChunkProvider chunkSource = serverWorld.getChunkSource();
+			ChunkGenerator chunkGen = chunkSource.generator;
+			
+			
+			// generate the terrain (this is thread safe)
+			ChunkStatus.EMPTY.generate(serverWorld, chunkGen, serverWorld.getStructureManager(), (ServerWorldLightManager) serverWorld.getLightEngine(), null, chunkList);
+			// override the chunk status so we can run the next generator stage
+			chunk.setStatus(ChunkStatus.STRUCTURE_REFERENCES);
+			chunkGen.createBiomes(serverWorld.registryAccess().registryOrThrow(Registry.BIOME_REGISTRY), chunk);
+			ChunkStatus.NOISE.generate(serverWorld, chunkGen, serverWorld.getStructureManager(), (ServerWorldLightManager) serverWorld.getLightEngine(), null, chunkList);
+			ChunkStatus.SURFACE.generate(serverWorld, chunkGen, serverWorld.getStructureManager(), (ServerWorldLightManager) serverWorld.getLightEngine(), null, chunkList);
+			
+			// this feature has been proven to be thread safe
+			// so we will add it
+			IceAndSnowFeature snowFeature = new IceAndSnowFeature(NoFeatureConfig.CODEC);
+			snowFeature.place(lodServerWorld, chunkGen, serverWorld.random, chunk.getPos().getWorldPosition(), null);
+			
+			lodBuilder.generateLodNodeFromChunk(lodDim, chunk, new LodBuilderConfig(DistanceGenerationMode.SURFACE));
+			
+			/**TODO if we want to use Biome utils and terrain utils for overworld
+			 * lodBuilder.generateLodNodeFromChunk(lodDim, pos ,detailLevel, serverWorld.getSeed());*/
+		}
+		
+		
+		/**
+		 * takes about 15 - 20 ms
+		 *
+		 * Causes concurrentModification Exceptions,
+		 * which could cause instability or world generation bugs
+		 */
+		private void generateUsingFeatures()
+		{
+			List<IChunk> chunkList = new LinkedList<>();
+			ChunkPrimer chunk = new ChunkPrimer(pos, UpgradeData.EMPTY);
+			chunkList.add(chunk);
+			LodServerWorld lodServerWorld = new LodServerWorld(serverWorld, chunk);
+			
+			ServerChunkProvider chunkSource = serverWorld.getChunkSource();
+			ChunkGenerator chunkGen = chunkSource.generator;
+			
+			
+			// generate the terrain (this is thread safe)
+			ChunkStatus.EMPTY.generate(serverWorld, chunkGen, serverWorld.getStructureManager(), (ServerWorldLightManager) serverWorld.getLightEngine(), null, chunkList);
+			// override the chunk status so we can run the next generator stage
+			chunk.setStatus(ChunkStatus.STRUCTURE_REFERENCES);
+			chunkGen.createBiomes(serverWorld.registryAccess().registryOrThrow(Registry.BIOME_REGISTRY), chunk);
+			ChunkStatus.NOISE.generate(serverWorld, chunkGen, serverWorld.getStructureManager(), (ServerWorldLightManager) serverWorld.getLightEngine(), null, chunkList);
+			ChunkStatus.SURFACE.generate(serverWorld, chunkGen, serverWorld.getStructureManager(), (ServerWorldLightManager) serverWorld.getLightEngine(), null, chunkList);
+			
+			
+			// get all the biomes in the chunk
+			HashSet<Biome> biomes = new HashSet<>();
+			for (int x = 0; x < LodUtil.CHUNK_WIDTH; x++)
+			{
+				for (int z = 0; z < LodUtil.CHUNK_WIDTH; z++)
+				{
+					Biome biome = chunk.getBiomes().getNoiseBiome(x >> 2, serverWorld.getSeaLevel() >> 2, z >> 2);
+					
+					// Issue #35
+					// For some reason Jungle biomes cause incredible lag
+					// the features here must be interacting with each other
+					// in unpredictable ways (specifically tree feature generation).
+					// When generating Features my CPU usage generally hovers around 30 - 40%
+					// when generating Jungles it spikes to 100%.
+					if (biome.getBiomeCategory() != Biome.Category.JUNGLE)
+					{
+						// should probably use the heightmap here instead of seaLevel,
+						// but this seems to get the job done well enough
+						biomes.add(biome);
+					}
+				}
+			}
+			
+			boolean allowUnstableFeatures = LodConfig.CLIENT.worldGenerator.allowUnstableFeatureGeneration.get();
+			
+			// generate all the features related to this chunk.
+			// this may or may not be thread safe
+			for (Biome biome : biomes)
+			{
+				List<List<Supplier<ConfiguredFeature<?, ?>>>> featuresForState = biome.generationSettings.features();
+				
+				for(int featureStateToGenerate = 0; featureStateToGenerate < featuresForState.size(); featureStateToGenerate++)
+				{
+					for(Supplier<ConfiguredFeature<?, ?>> featureSupplier : featuresForState.get(featureStateToGenerate))
+					{
+						ConfiguredFeature<?, ?> configuredFeature = featureSupplier.get();
+						
+						if (!allowUnstableFeatures &&
+								configuredFeaturesToAvoid.containsKey(configuredFeature.hashCode()))
+							continue;
+						
+						
+						try
+						{
+							configuredFeature.place(lodServerWorld, chunkGen, serverWorld.random, chunk.getPos().getWorldPosition());
+						}
+						catch(ConcurrentModificationException e)
+						{
+							// This will happen. I'm not sure what to do about it
+							// except pray that it doesn't effect the normal world generation
+							// in any harmful way.
+							// Update: this can cause crashes and high CPU usage.
+							
+							// Issue #35
+							// I tried cloning the config for each feature, but that
+							// path was blocked since I can't clone lambda methods.
+							// I tried using a deep cloning library and discovered
+							// the problem there.
+							// ( https://github.com/kostaskougios/cloning
+							//   and
+							//   https://github.com/EsotericSoftware/kryo )
+							
+							if (!allowUnstableFeatures)
+								configuredFeaturesToAvoid.put(configuredFeature.hashCode(), configuredFeature);
+//							ClientProxy.LOGGER.info(configuredFeaturesToAvoid.mappingCount());
+						}
+						catch(UnsupportedOperationException e)
+						{
+							// This will happen when the LodServerWorld
+							// isn't able to return something that a feature
+							// generator needs
+							
+							if (!allowUnstableFeatures)
+								configuredFeaturesToAvoid.put(configuredFeature.hashCode(), configuredFeature);
+//							ClientProxy.LOGGER.info(configuredFeaturesToAvoid.mappingCount());
+						}
+						catch(Exception e)
+						{
+							// I'm not sure what happened, print to the log
+							
+							e.printStackTrace();
+							
+							if (!allowUnstableFeatures)
+								configuredFeaturesToAvoid.put(configuredFeature.hashCode(), configuredFeature);
+//							ClientProxy.LOGGER.info(configuredFeaturesToAvoid.mappingCount());
+						}
+					}
+				}
+			}
+			
+			// generate a Lod like normal
+			lodBuilder.generateLodNodeFromChunk(lodDim, chunk, new LodBuilderConfig(DistanceGenerationMode.FEATURES));
+		}
+		
+		
+		/**
+		 * on pre generated chunks 0 - 1 ms
+		 * on un generated chunks 0 - 50 ms
+		 * 	with the median seeming to hover around 15 - 30 ms
+		 * 	and outliers in the 100 - 200 ms range
+		 *
+		 * Note this should not be multithreaded and does cause server/simulation lag
+		 * (Higher lag for generating than loading)
+		 */
+		private void generateWithServer()
+		{
+			lodBuilder.generateLodNodeAsync(serverWorld.getChunk(pos.x, pos.z, ChunkStatus.FEATURES), ClientProxy.getLodWorld(), serverWorld);
+		}
+		
+		
+		
+		
+		
+		
+		//================//
+		// Unused methods //
+		//================//
+		
+		// Sadly I wasn't able to get these to work,
+		// they are here for documentation purposes
+		
+		@SuppressWarnings({ "rawtypes", "unchecked", "unused" })
+		private DecoratedFeatureConfig cloneDecoratedFeatureConfig(DecoratedFeatureConfig config)
+		{
+			IPlacementConfig placementConfig = null;
+			
+			Class oldConfigClass = config.decorator.config().getClass();
+			
+			if (oldConfigClass == FeatureSpreadConfig.class)
+			{
+				FeatureSpreadConfig oldPlacementConfig = (FeatureSpreadConfig) config.decorator.config();
+				FeatureSpread oldSpread = oldPlacementConfig.count();
+				
+				placementConfig = new FeatureSpreadConfig(oldSpread);
+			}
+			else if(oldConfigClass == DecoratedPlacementConfig.class)
+			{
+				DecoratedPlacementConfig oldPlacementConfig = (DecoratedPlacementConfig) config.decorator.config();
+				placementConfig = new DecoratedPlacementConfig(oldPlacementConfig.inner(), oldPlacementConfig.outer());
+			}
+			else if(oldConfigClass == NoiseDependant.class)
+			{
+				NoiseDependant oldPlacementConfig = (NoiseDependant) config.decorator.config();
+				placementConfig = new NoiseDependant(oldPlacementConfig.noiseLevel, oldPlacementConfig.belowNoise, oldPlacementConfig.aboveNoise);
+			}
+			else
+			{
+//				ClientProxy.LOGGER.debug("unkown decorated placement config: \"" + config.decorator.config().getClass() + "\"");
+				return config;
+			}
+			
+			
+			ConfiguredPlacement<?> newPlacement = new ConfiguredPlacement(config.decorator.decorator, placementConfig);
+			return new DecoratedFeatureConfig(config.feature, newPlacement);
+		}
+		
+		
+		@SuppressWarnings("unused")
+		private BlockClusterFeatureConfig cloneBlockClusterFeatureConfig(BlockClusterFeatureConfig config)
+		{
+			WeightedBlockStateProvider provider = new WeightedBlockStateProvider();
+			provider.weightedList.entries.addAll(((WeightedBlockStateProvider) config.stateProvider).weightedList.entries);
+			
+			HashSet<Block> whitelist = new HashSet<>(config.whitelist);
+			
+			HashSet<BlockState> blacklist = new HashSet<>(config.blacklist);
+			
+			
+			BlockClusterFeatureConfig.Builder builder = new BlockClusterFeatureConfig.Builder(provider, config.blockPlacer);
+			builder.whitelist(whitelist);
+			builder.blacklist(blacklist);
+			builder.xspread(config.xspread);
+			builder.yspread(config.yspread);
+			builder.zspread(config.zspread);
+			if(config.canReplace) { builder.canReplace(); }
+			if(config.needWater) { builder.needWater(); }
+			if(config.project) { builder.noProjection(); }
+			builder.tries(config.tries);
+			
+			
+			return builder.build();
+		}
+		
+	}
+	
+	
+	/**
+	 * Stops the current genThreads if they are running
+	 * and then recreates the Executer service. <br><br>
+	 *
+	 * This is done to clear any outstanding tasks
+	 * that may exist after the player leaves their current world.
+	 * If this isn't done unfinished tasks may be left in the queue
+	 * preventing new LodChunks form being generated.
+	 */
+	public static void restartExecuterService()
+	{
+		if (genThreads != null && !genThreads.isShutdown())
+		{
+			genThreads.shutdownNow();
+		}
+		genThreads = Executors.newFixedThreadPool(LodConfig.CLIENT.threading.numberOfWorldGenerationThreads.get(), new LodThreadFactory(LodNodeGenWorker.class.getSimpleName()));
+	}
+	
+	
+	
+	
+	
+	/*
+	 * performance/generation tests related to
+	 * serverWorld.getChunk(x, z, ChunkStatus. *** )
+
+     true/false is whether they generated blocks or not
+     the time is how long it took to generate
+
+     ChunkStatus.EMPTY					0  - 1  ms	false	(empty, what did you expect? :P)
+     ChunkStatus.STRUCTURE_REFERENCES	1  - 2  ms  false	(no height, only generates some chunks)
+     ChunkStatus.BIOMES 				1  - 10 ms	false	(no height)
+     ChunkStatus.NOISE					4  - 15 ms	true	(all blocks are stone)
+     ChunkStatus.LIQUID_CARVERS			6  - 12 ms	true	(no snow/trees, just grass)
+     ChunkStatus.SURFACE				5  - 15 ms	true	(no snow/trees, just grass)
+     ChunkStatus.CARVERS				5  - 30 ms	true	(no snow/trees, just grass)
+     ChunkStatus.FEATURES				7  - 25 ms	true
+     ChunkStatus.HEIGHTMAPS 			20 - 40 ms	true
+     ChunkStatus.LIGHT					20 - 40 ms	true
+     ChunkStatus.FULL 					30 - 50 ms	true
+     ChunkStatus.SPAWN			   		50 - 80 ms	true
+
+
+     At this point I would suggest using FEATURES, as it generates snow and trees
+     (and any other object that is needed to make biomes distinct)
+
+     Otherwise if snow/trees aren't necessary SURFACE is the next fastest (although not by much)
+	 */
+}
@@ -0,0 +1,330 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.builders.worldGeneration;
+
+import java.util.HashMap;
+import java.util.List;
+import java.util.Random;
+import java.util.function.Predicate;
+import java.util.stream.Stream;
+
+import com.seibel.lod.util.LodUtil;
+
+import net.minecraft.block.Block;
+import net.minecraft.block.BlockState;
+import net.minecraft.entity.Entity;
+import net.minecraft.entity.player.PlayerEntity;
+import net.minecraft.fluid.Fluid;
+import net.minecraft.fluid.FluidState;
+import net.minecraft.particles.IParticleData;
+import net.minecraft.tileentity.TileEntity;
+import net.minecraft.util.Direction;
+import net.minecraft.util.SoundCategory;
+import net.minecraft.util.SoundEvent;
+import net.minecraft.util.math.AxisAlignedBB;
+import net.minecraft.util.math.BlockPos;
+import net.minecraft.util.math.SectionPos;
+import net.minecraft.util.registry.DynamicRegistries;
+import net.minecraft.world.DifficultyInstance;
+import net.minecraft.world.DimensionType;
+import net.minecraft.world.EmptyTickList;
+import net.minecraft.world.ISeedReader;
+import net.minecraft.world.ITickList;
+import net.minecraft.world.biome.Biome;
+import net.minecraft.world.biome.BiomeManager;
+import net.minecraft.world.border.WorldBorder;
+import net.minecraft.world.chunk.AbstractChunkProvider;
+import net.minecraft.world.chunk.ChunkStatus;
+import net.minecraft.world.chunk.IChunk;
+import net.minecraft.world.gen.Heightmap;
+import net.minecraft.world.gen.Heightmap.Type;
+import net.minecraft.world.gen.feature.structure.Structure;
+import net.minecraft.world.gen.feature.structure.StructureStart;
+import net.minecraft.world.lighting.WorldLightManager;
+import net.minecraft.world.server.ServerWorld;
+import net.minecraft.world.storage.IWorldInfo;
+
+
+/**
+ * This is a fake ServerWorld used when generating features.
+ * This allows us to keep each LodChunk generation independent
+ * of the actual ServerWorld, allowing us
+ * to multithread generation.
+ *
+ * @author James Seibel
+ * @version 7-26-2021
+ */
+public class LodServerWorld implements ISeedReader
+{
+
+	public HashMap<Heightmap.Type, Heightmap> heightmaps = new HashMap<>();
+
+	public IChunk chunk;
+
+	public ServerWorld serverWorld;
+
+	public LodServerWorld(ServerWorld newServerWorld, IChunk newChunk)
+	{
+		chunk = newChunk;
+		serverWorld = newServerWorld;
+	}
+
+
+	@Override
+	public int getHeight(Type heightmapType, int x, int z)
+	{
+		// make sure the block position is set relative to the chunk
+		x = x % LodUtil.CHUNK_WIDTH;
+		x = (x < 0) ? x + 16 : x;
+
+		z = z % LodUtil.CHUNK_WIDTH;
+		z = (z < 0) ? z + 16 : z;
+
+		return chunk.getOrCreateHeightmapUnprimed(LodUtil.DEFAULT_HEIGHTMAP).getFirstAvailable(x, z);
+	}
+
+	@Override
+	public Biome getBiome(BlockPos pos)
+	{
+		return chunk.getBiomes().getNoiseBiome(pos.getX() >> 2, pos.getY() >> 2, pos.getZ() >> 2);
+	}
+
+	@Override
+	public boolean setBlock(BlockPos pos, BlockState state, int flags, int recursionLeft)
+	{
+		return chunk.setBlockState(pos, state, false) == state;
+	}
+
+	@Override
+	public BlockState getBlockState(BlockPos pos)
+	{
+		return chunk.getBlockState(pos);
+	}
+
+	@Override
+	public FluidState getFluidState(BlockPos pos)
+	{
+		return chunk.getFluidState(pos);
+	}
+
+
+	@Override
+	public boolean isStateAtPosition(BlockPos pos, Predicate<BlockState> state)
+	{
+		return state.test(chunk.getBlockState(pos));
+	}
+
+	@Override
+	public ITickList<Block> getBlockTicks()
+	{
+		return EmptyTickList.empty();
+	}
+
+	@Override
+	public IChunk getChunk(int x, int z, ChunkStatus requiredStatus, boolean nonnull)
+	{
+		return chunk;
+	}
+
+	@Override
+	public Stream<? extends StructureStart<?>> startsForFeature(SectionPos p_241827_1_, Structure<?> p_241827_2_)
+	{
+		return serverWorld.startsForFeature(p_241827_1_, p_241827_2_);
+	}
+
+	@Override
+	public ITickList<Fluid> getLiquidTicks()
+	{
+		return EmptyTickList.empty();
+	}
+
+	@Override
+	public WorldLightManager getLightEngine()
+	{
+		return new WorldLightManager(null, false, false);
+	}
+
+	@Override
+	public long getSeed()
+	{
+		return serverWorld.getSeed();
+	}
+
+	@Override
+	public DynamicRegistries registryAccess()
+	{
+		return serverWorld.registryAccess();
+	}
+
+
+	/**
+	 * All methods below shouldn't be needed
+	 * and thus have been left unimplemented.
+	 */
+
+
+	@Override
+	public Random getRandom()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+	@Override
+	public void playSound(PlayerEntity player, BlockPos pos, SoundEvent soundIn, SoundCategory category, float volume,
+	                      float pitch)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+	@Override
+	public void addParticle(IParticleData particleData, double x, double y, double z, double xSpeed, double ySpeed,
+	                        double zSpeed)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+	@Override
+	public BiomeManager getBiomeManager()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+	@Override
+	public int getSeaLevel()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+	@Override
+	public float getShade(Direction p_230487_1_, boolean p_230487_2_)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+	@Override
+	public WorldBorder getWorldBorder()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+	@Override
+	public boolean removeBlock(BlockPos pos, boolean isMoving)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+	@Override
+	public boolean destroyBlock(BlockPos pos, boolean dropBlock, Entity entity, int recursionLeft)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public ServerWorld getLevel()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public AbstractChunkProvider getChunkSource()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public DifficultyInstance getCurrentDifficultyAt(BlockPos arg0)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public IWorldInfo getLevelData()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public void levelEvent(PlayerEntity arg0, int arg1, BlockPos arg2, int arg3)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+
+	}
+
+
+	@Override
+	public List<Entity> getEntities(Entity arg0, AxisAlignedBB arg1, Predicate<? super Entity> arg2)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public <T extends Entity> List<T> getEntitiesOfClass(Class<? extends T> arg0, AxisAlignedBB arg1,
+	                                                     Predicate<? super T> arg2)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public List<? extends PlayerEntity> players()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public int getSkyDarken()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public Biome getUncachedNoiseBiome(int p_225604_1_, int p_225604_2_, int p_225604_3_)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public boolean isClientSide()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public DimensionType dimensionType()
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+
+	@Override
+	public TileEntity getBlockEntity(BlockPos p_175625_1_)
+	{
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+
+}
@@ -0,0 +1,190 @@
+package com.seibel.lod.builders.worldGeneration;
+
+import java.util.HashSet;
+import java.util.Set;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+import java.util.concurrent.atomic.AtomicInteger;
+
+import com.seibel.lod.builders.LodBuilder;
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.objects.PosToGenerateContainer;
+import com.seibel.lod.render.LodRenderer;
+import com.seibel.lod.util.DetailDistanceUtil;
+import com.seibel.lod.util.LevelPosUtil;
+import com.seibel.lod.util.LodThreadFactory;
+import com.seibel.lod.util.LodUtil;
+import com.seibel.lod.wrappers.MinecraftWrapper;
+
+import net.minecraft.util.math.ChunkPos;
+import net.minecraft.world.server.ServerWorld;
+import net.minecraftforge.common.WorldWorkerManager;
+
+/**
+ * A singleton that handles all long distance LOD world generation.
+ *
+ * @author James Seibel
+ * @version 9-25-2021
+ */
+public class LodWorldGenerator
+{
+	public MinecraftWrapper mc = MinecraftWrapper.INSTANCE;
+	
+	/** This holds the thread used to generate new LODs off the main thread. */
+	private ExecutorService mainGenThread = Executors.newSingleThreadExecutor(new LodThreadFactory(this.getClass().getSimpleName() + " world generator"));
+	
+	/** we only want to queue up one generator thread at a time */
+	private boolean generatorThreadRunning = false;
+	
+	/**
+	 * How many chunks to generate outside of the player's view distance at one
+	 * time. (or more specifically how many requests to make at one time). I
+	 * multiply by 8 to make sure there is always a buffer of chunk requests, to
+	 * make sure the CPU is always busy and we can generate LODs as quickly as
+	 * possible.
+	 */
+	public int maxChunkGenRequests;
+	
+	/**
+	 * This keeps track of how many chunk generation requests are on going. This is
+	 * to limit how many chunks are queued at once. To prevent chunks from being
+	 * generated for a long time in an area the player is no longer in.
+	 */
+	public AtomicInteger numberOfChunksWaitingToGenerate = new AtomicInteger(0);
+	
+	public Set<ChunkPos> positionsWaitingToBeGenerated = new HashSet<>();
+	
+	/**
+	 * Singleton copy of this object
+	 */
+	public static final LodWorldGenerator INSTANCE = new LodWorldGenerator();
+	
+	
+	private LodWorldGenerator()
+	{
+		
+	}
+	
+	/**
+	 * Queues up LodNodeGenWorkers for the given lodDimension.
+	 *
+	 * @param renderer needed so the LodNodeGenWorkers can flag that the
+	 *                 buffers need to be rebuilt.
+	 */
+	public void queueGenerationRequests(LodDimension lodDim, LodRenderer renderer, LodBuilder lodBuilder)
+	{
+		if (LodConfig.CLIENT.worldGenerator.distanceGenerationMode.get() != DistanceGenerationMode.NONE
+				&& !generatorThreadRunning
+				&& mc.hasSingleplayerServer())
+		{
+			// the thread is now running, don't queue up another thread
+			generatorThreadRunning = true;
+			
+			// just in case the config changed
+			maxChunkGenRequests = LodConfig.CLIENT.threading.numberOfWorldGenerationThreads.get() * 8;
+			
+			Thread generatorThread = new Thread(() ->
+			{
+				try
+				{
+					// round the player's block position down to the nearest chunk BlockPos
+					int playerPosX = mc.getPlayer().blockPosition().getX();
+					int playerPosZ = mc.getPlayer().blockPosition().getZ();
+					
+					
+					//=======================================//
+					// fill in positionsWaitingToBeGenerated //
+					//=======================================//
+					
+					ServerWorld serverWorld = LodUtil.getServerWorldFromDimension(lodDim.dimension);
+					
+					PosToGenerateContainer posToGenerate = lodDim.getDataToGenerate(
+							maxChunkGenRequests,
+							playerPosX,
+							playerPosZ);
+					
+					
+					byte detailLevel;
+					int posX;
+					int posZ;
+					int nearIndex = 0;
+					int farIndex = 0;
+					
+					for (int i = 0; i < posToGenerate.getNumberOfPos(); i++)
+					{
+						// I wish there was a way to compress this code, but I'm not aware of 
+						// a easy way to do so.
+						
+						// add the near positions
+						if (posToGenerate.getNthDetail(nearIndex, true) != 0 && nearIndex < posToGenerate.getNumberOfNearPos())
+						{
+							detailLevel = (byte) (posToGenerate.getNthDetail(nearIndex, true) - 1);
+							posX = posToGenerate.getNthPosX(nearIndex, true);
+							posZ = posToGenerate.getNthPosZ(nearIndex, true);
+							nearIndex++;
+							
+							ChunkPos chunkPos = new ChunkPos(LevelPosUtil.getChunkPos(detailLevel, posX), LevelPosUtil.getChunkPos(detailLevel, posZ));
+							if (numberOfChunksWaitingToGenerate.get() < maxChunkGenRequests)
+							{
+								// prevent generating the same chunk multiple times
+								if (positionsWaitingToBeGenerated.contains(chunkPos))
+									continue;
+							}
+							
+							// don't add more to the generation queue then allowed
+							if (numberOfChunksWaitingToGenerate.get() >= maxChunkGenRequests)
+								break;
+							
+							positionsWaitingToBeGenerated.add(chunkPos);
+							numberOfChunksWaitingToGenerate.addAndGet(1);
+							LodNodeGenWorker genWorker = new LodNodeGenWorker(chunkPos, DetailDistanceUtil.getDistanceGenerationMode(detailLevel), lodBuilder, lodDim, serverWorld);
+							WorldWorkerManager.addWorker(genWorker);
+						}
+						
+						
+						// add the far positions
+						if (posToGenerate.getNthDetail(farIndex, false) != 0 && farIndex < posToGenerate.getNumberOfFarPos())
+						{
+							detailLevel = (byte) (posToGenerate.getNthDetail(farIndex, false) - 1);
+							posX = posToGenerate.getNthPosX(farIndex, false);
+							posZ = posToGenerate.getNthPosZ(farIndex, false);
+							farIndex++;
+							
+							ChunkPos chunkPos = new ChunkPos(LevelPosUtil.getChunkPos(detailLevel, posX), LevelPosUtil.getChunkPos(detailLevel, posZ));
+							if (numberOfChunksWaitingToGenerate.get() < maxChunkGenRequests)
+							{
+								// prevent generating the same chunk multiple times
+								if (positionsWaitingToBeGenerated.contains(chunkPos))
+									continue;
+							}
+							
+							// don't add more to the generation queue then allowed
+							if (numberOfChunksWaitingToGenerate.get() >= maxChunkGenRequests)
+								break;
+							
+							positionsWaitingToBeGenerated.add(chunkPos);
+							numberOfChunksWaitingToGenerate.addAndGet(1);
+							LodNodeGenWorker genWorker = new LodNodeGenWorker(chunkPos, DetailDistanceUtil.getDistanceGenerationMode(detailLevel), lodBuilder, lodDim, serverWorld);
+							WorldWorkerManager.addWorker(genWorker);
+						}
+					}
+					
+				}
+				catch (Exception e)
+				{
+					// this shouldn't ever happen, but just in case
+					e.printStackTrace();
+				}
+				finally
+				{
+					generatorThreadRunning = false;
+				}
+			});
+			
+			mainGenThread.execute(generatorThread);
+		} // if distanceGenerationMode != DistanceGenerationMode.NONE && !generatorThreadRunning
+	} // queueGenerationRequests
+	
+}
@@ -0,0 +1,473 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.config;
+
+import java.nio.file.Path;
+import java.nio.file.Paths;
+
+import org.apache.commons.lang3.tuple.Pair;
+import org.apache.logging.log4j.LogManager;
+
+import com.electronwill.nightconfig.core.file.CommentedFileConfig;
+import com.electronwill.nightconfig.core.io.WritingMode;
+import com.seibel.lod.ModInfo;
+import com.seibel.lod.enums.DebugMode;
+import com.seibel.lod.enums.DetailDropOff;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.enums.FogDistance;
+import com.seibel.lod.enums.FogDrawOverride;
+import com.seibel.lod.enums.GenerationPriority;
+import com.seibel.lod.enums.HorizontalQuality;
+import com.seibel.lod.enums.HorizontalResolution;
+import com.seibel.lod.enums.HorizontalScale;
+import com.seibel.lod.enums.LodTemplate;
+import com.seibel.lod.enums.VerticalQuality;
+import com.seibel.lod.render.LodRenderer.FovTest;
+
+import net.minecraftforge.common.ForgeConfigSpec;
+import net.minecraftforge.eventbus.api.SubscribeEvent;
+import net.minecraftforge.fml.common.Mod;
+import net.minecraftforge.fml.config.ModConfig;
+
+/**
+ * This handles any configuration the user has access to.
+ *
+ * @author James Seibel
+ * @version 9-26-2021
+ */
+@Mod.EventBusSubscriber
+public class LodConfig
+{
+	public static class Client
+	{
+		public final Graphics graphics;
+		public final WorldGenerator worldGenerator;
+		public final Threading threading;
+		public final Debugging debugging;
+		public final Buffers buffers;
+		
+		public Client(ForgeConfigSpec.Builder builder)
+		{
+			builder.push("client");
+			{
+				graphics = new Graphics(builder);
+				worldGenerator = new WorldGenerator(builder);
+				threading = new Threading(builder);
+				debugging = new Debugging(builder);
+				buffers = new Buffers(builder);
+			}
+			builder.pop();
+		}
+	}
+	
+	//================//
+	// Client Configs //
+	//================//
+	
+	public static class Graphics
+	{
+		public ForgeConfigSpec.BooleanValue drawLods;
+		
+		public ForgeConfigSpec.EnumValue<FogDistance> fogDistance;
+		public ForgeConfigSpec.EnumValue<FogDrawOverride> fogDrawOverride;
+		
+		public ForgeConfigSpec.EnumValue<LodTemplate> lodTemplate;
+		
+		public ForgeConfigSpec.EnumValue<HorizontalResolution> drawResolution;
+		
+//		public ForgeConfigSpec.EnumValue<ShadingMode> shadingMode;
+		
+		
+		public ForgeConfigSpec.EnumValue<DetailDropOff> detailDropOff;
+		
+		public ForgeConfigSpec.IntValue lodChunkRenderDistance;
+		
+		public ForgeConfigSpec.BooleanValue disableDirectionalCulling;
+		
+		public ForgeConfigSpec.BooleanValue alwaysDrawAtMaxQuality;
+		
+		public ForgeConfigSpec.EnumValue<FovTest> useFovSetting;
+		
+		
+		Graphics(ForgeConfigSpec.Builder builder)
+		{
+			builder.comment("These settings control how the LODs look.").push(this.getClass().getSimpleName());
+			
+			drawLods = builder
+					.comment("\n\n"
+							+ " If true, the mod is enabled and LODs will be drawn. \n"
+							+ " If false, the mod will still generate LODs, \n"
+							+ " but they won't be rendered. \n")
+					.define("drawLODs", true);
+			
+			fogDistance = builder
+					.comment("\n\n"
+							+ " At what distance should Fog be drawn on the LODs? \n"
+							+ " If the fog cuts off ubruptly or you are using Optifine's \"fast\" fog option \n"
+							+ " set this to " + FogDistance.NEAR + " or " + FogDistance.FAR + ". \n")
+					.defineEnum("fogDistance", FogDistance.NEAR_AND_FAR);
+			
+			fogDrawOverride = builder
+					.comment("\n\n"
+							+ " When should fog be drawn? \n"
+							+ " " + FogDrawOverride.USE_OPTIFINE_FOG_SETTING + ": Use whatever Fog setting Optifine is using. If Optifine isn't installed this defaults to " + FogDrawOverride.ALWAYS_DRAW_FOG_FANCY + ". \n"
+							+ " " + FogDrawOverride.NEVER_DRAW_FOG + ": Never draw fog on the LODs \n"
+							+ " " + FogDrawOverride.ALWAYS_DRAW_FOG_FAST + ": Always draw fast fog on the LODs \n"
+							+ " " + FogDrawOverride.ALWAYS_DRAW_FOG_FANCY + ": Always draw fancy fog on the LODs (if your graphics card supports it) \n")
+					.defineEnum("fogDrawOverride", FogDrawOverride.ALWAYS_DRAW_FOG_FANCY);
+			
+			lodTemplate = builder
+					.comment("\n\n"
+							+ " How should the LODs be drawn? \n"
+							+ " NOTE: Currently only " + LodTemplate.CUBIC + " is implemented! \n"
+							+ " \n"
+							+ " " + LodTemplate.CUBIC + ": LOD Chunks are drawn as rectangular prisms (boxes). \n"
+							+ " " + LodTemplate.TRIANGULAR + ": LOD Chunks smoothly transition between other. \n"
+							+ " " + LodTemplate.DYNAMIC + ": LOD Chunks smoothly transition between other, \n"
+							+ " " + "         unless a neighboring chunk is at a significantly different height. \n")
+					.defineEnum("lodTemplate", LodTemplate.CUBIC);
+			
+			detailDropOff = builder
+					.comment("\n\n"
+							+ " How smooth should the detail transition for LODs be? \n"
+							+ DetailDropOff.FANCY + ": quality is determined per-block (best quality option, may cause stuttering when moving)\n"
+							+ DetailDropOff.FAST + ": quality is determined per-region (performance option)\n")
+					.defineEnum("detailDropOff", DetailDropOff.FANCY);
+			
+			drawResolution = builder
+					.comment("\n\n"
+							+ " What is the maximum detail LODs should be drawn at? \n"
+							+ " " + HorizontalResolution.CHUNK + ": render 1 LOD for each Chunk. \n"
+							+ " " + HorizontalResolution.HALF_CHUNK + ": render 4 LODs for each Chunk. \n"
+							+ " " + HorizontalResolution.FOUR_BLOCKS + ": render 16 LODs for each Chunk. \n"
+							+ " " + HorizontalResolution.TWO_BLOCKS + ": render 64 LODs for each Chunk. \n"
+							+ " " + HorizontalResolution.BLOCK + ": render 256 LODs for each Chunk. \n")
+					.defineEnum("Draw resolution", HorizontalResolution.BLOCK);
+			
+			
+			lodChunkRenderDistance = builder
+					.comment("\n\n"
+							+ " The mod's render distance, measured in chunks. \n")
+					.defineInRange("lodChunkRenderDistance", 64, 32, 1024);
+			
+			useFovSetting = builder
+					.comment("\n\n"
+							+ " Experimental text value. \n"
+							+ " " + FovTest.BOTH + ": is the normal value \n")
+					.defineEnum("useFovSetting", FovTest.BOTH);
+			
+			disableDirectionalCulling = builder
+					.comment("\n\n"
+							+ " If false LODs that are behind the player's camera \n"
+							+ " aren't drawn, increasing performance. \n\n"
+							+ ""
+							+ " If true all LODs are drawn, even those behind \n"
+							+ " the player's camera, decreasing performance. \n\n"
+							+ ""
+							+ " Disable this if you see LODs disapearing. \n"
+							+ " (This may happen if you are using a camera mod) \n")
+					.define("disableDirectionalCulling", false);
+			
+//			shadingMode = builder
+//					.comment("\n\n"
+//							+ " What kind of shading should the LODs have? \n"
+//							+ " \n"
+//							+ " " + ShadingMode.NONE + " \n"
+//							+ " " + "LODs will have the same lighting on every side. \n"
+//							+ " " + "Can make large similarly colored areas hard to differentiate. \n"
+//							+ "\n"
+//							+ " " + ShadingMode.GAME_SHADING + " \n"
+//							+ " " + "LODs will have darker sides and bottoms to simulate Minecraft's flat lighting.")
+//					.defineEnum("lightingMode", ShadingMode.GAME_SHADING);
+			
+			alwaysDrawAtMaxQuality = builder
+					.comment("\n\n"
+							+ " Disable LOD quality falloff, "
+							+ " all LODs will be drawn at the highest "
+							+ " available detail level. "
+							+ " "
+							+ " WARNING "
+							+ " This could cause a Out Of Memory crash on render "
+							+ " distances higher than 128 \n")
+					.define("alwaysDrawAtMaxQuality", false);
+			
+			builder.pop();
+		}
+	}
+	
+	public static class WorldGenerator
+	{
+		public ForgeConfigSpec.EnumValue<VerticalQuality> lodQualityMode;
+		public ForgeConfigSpec.EnumValue<HorizontalResolution> generationResolution;
+		public ForgeConfigSpec.EnumValue<DistanceGenerationMode> distanceGenerationMode;
+		public ForgeConfigSpec.EnumValue<GenerationPriority> generationPriority;
+		public ForgeConfigSpec.BooleanValue allowUnstableFeatureGeneration;
+		public ForgeConfigSpec.EnumValue<HorizontalScale> horizontalScale;
+		public ForgeConfigSpec.EnumValue<HorizontalQuality> horizontalQuality;
+		
+		WorldGenerator(ForgeConfigSpec.Builder builder)
+		{
+			builder.comment("These settings control how LODs outside your normal view range are generated.").push(this.getClass().getSimpleName());
+			
+			lodQualityMode = builder
+					.comment("\n\n"
+							+ " Use 3d lods or 2d lods? \n"
+							+ " " + VerticalQuality.HEIGHTMAP + ": LODs are solid from the lowest point to the highest. Creates pillars for floating islands. Faster \n"
+							+ " " + VerticalQuality.VOXEL + ": LODs have gaps between vertical blocks. Good for floating islands and caves. Slower \n"
+							+ " " + "(Yes we know voxels are generally cubes, but voxel sounds better than rectangular_prism) \n")
+					.defineEnum("lodQualityMode", VerticalQuality.HEIGHTMAP);
+			
+			generationResolution = builder
+					.comment("\n\n"
+							+ " What is the maximum detail level that LODs should be generated at? \n"
+							+ " " + HorizontalResolution.CHUNK + ": render 1 LOD for each Chunk. \n"
+							+ " " + HorizontalResolution.HALF_CHUNK + ": render 4 LODs for each Chunk. \n"
+							+ " " + HorizontalResolution.FOUR_BLOCKS + ": render 16 LODs for each Chunk. \n"
+							+ " " + HorizontalResolution.TWO_BLOCKS + ": render 64 LODs for each Chunk. \n"
+							+ " " + HorizontalResolution.BLOCK + ": render 256 LODs for each Chunk. \n")
+					.defineEnum("Generation Resolution", HorizontalResolution.BLOCK);
+			
+			horizontalScale = builder
+					.comment("\n\n"
+							+ " This indicates how quickly LODs drop off in quality. \n"
+							+ " " + HorizontalScale.LOW + ": quality drops every " + HorizontalScale.LOW.distanceUnit / 16 + " chunks. \n"
+							+ " " + HorizontalScale.MEDIUM + ": quality drops every " + HorizontalScale.MEDIUM.distanceUnit / 16 + " chunks. \n"
+							+ " " + HorizontalScale.HIGH + ": quality drops every " + HorizontalScale.HIGH.distanceUnit / 16 + " chunks. \n")
+					.defineEnum("horizontal scale", HorizontalScale.MEDIUM);
+			
+			horizontalQuality = builder
+					.comment("\n\n"
+							+ " This indicates the exponential base of the quadratic drop-off \n"
+							+ " " + HorizontalQuality.LINEAR + ": base " + HorizontalQuality.LINEAR.quadraticBase + ". \n"
+							+ " " + HorizontalQuality.LOW + ": base " + HorizontalQuality.LOW.quadraticBase + ". \n"
+							+ " " + HorizontalQuality.MEDIUM + ": base " + HorizontalQuality.MEDIUM.quadraticBase + ". \n"
+							+ " " + HorizontalQuality.HIGH + ": base " + HorizontalQuality.HIGH.quadraticBase + ". \n")
+					.defineEnum("horizontal quality", HorizontalQuality.MEDIUM);
+			generationPriority = builder
+					.comment("\n\n"
+							+ " " + GenerationPriority.FAR_FIRST + " \n"
+							+ " LODs are generated from low to high detail\n"
+							+ " with a small priority for far regions. \n"
+							+ " This fills in the world fastest. \n"
+							
+							+ "\n"
+							+ " " + GenerationPriority.NEAR_FIRST + " \n"
+							+ " LODs are generated around the player \n"
+							+ " in a spiral, similar to vanilla minecraft. \n")
+					.defineEnum("Generation priority", GenerationPriority.NEAR_FIRST);
+			
+			distanceGenerationMode = builder
+					.comment("\n\n"
+							+ " Note: The times listed here are the amount of time it took \n"
+							+ "       one of the developer's PC to generate 1 chunk, \n"
+							+ "       and are included so you can compare the \n"
+							+ "       different generation options. Your mileage may vary. \n"
+							+ "\n"
+							
+							+ " " + DistanceGenerationMode.NONE + " \n"
+							+ " Don't run the distance generator. \n"
+							
+							+ " " + DistanceGenerationMode.BIOME_ONLY + " \n"
+							+ " Only generate the biomes and use the biome's \n"
+							+ " grass color, water color, or snow color. \n"
+							+ " Doesn't generate height, everything is shown at sea level. \n"
+							+ " Multithreaded - Fastest (2-5 ms) \n"
+							
+							+ "\n"
+							+ " " + DistanceGenerationMode.BIOME_ONLY_SIMULATE_HEIGHT + " \n"
+							+ " Same as BIOME_ONLY, except instead \n"
+							+ " of always using sea level as the LOD height \n"
+							+ " different biome types (mountain, ocean, forest, etc.) \n"
+							+ " use predetermined heights to simulate having height data. \n"
+							+ " Multithreaded - Fastest (2-5 ms) \n"
+							
+							+ "\n"
+							+ " " + DistanceGenerationMode.SURFACE + " \n"
+							+ " Generate the world surface, \n"
+							+ " this does NOT include caves, trees, \n"
+							+ " or structures. \n"
+							+ " Multithreaded - Faster (10-20 ms) \n"
+							
+							+ "\n"
+							+ " " + DistanceGenerationMode.FEATURES + " \n"
+							+ " Generate everything except structures. \n"
+							+ " WARNING: This may cause world generation bugs or instability! \n"
+							+ " Multithreaded - Fast (15-20 ms) \n"
+							
+							+ "\n"
+							+ " " + DistanceGenerationMode.SERVER + " \n"
+							+ " Ask the server to generate/load each chunk. \n"
+							+ " This is the most compatible, but causes server/simulation lag. \n"
+							+ " This will show player made structures, which can \n"
+							+ " be useful if you are adding the mod to a pre-existing world. \n"
+							+ " Singlethreaded - Slow (15-50 ms, with spikes up to 200 ms) \n")
+					.defineEnum("distanceGenerationMode", DistanceGenerationMode.SURFACE);
+			
+			allowUnstableFeatureGeneration = builder
+					.comment("\n\n"
+							+ " When using the " + DistanceGenerationMode.FEATURES + " generation mode \n"
+							+ " some features may not be thread safe, which could \n"
+							+ " cause instability and crashes. \n"
+							+ " By default (false) those features are skipped, \n"
+							+ " improving stability, but decreasing how many features are \n"
+							+ " actually generated. \n"
+							+ " (for example: some tree generation is unstable, \n"
+							+ "               so some trees may not be generated.) \n"
+							+ " By setting this to true, all features will be generated, \n"
+							+ " but your game will be more unstable and crashes may occur. \n"
+							+ " \n"
+							+ " I would love to remove this option and always generate everything, \n"
+							+ " but I'm not sure how to do that. \n"
+							+ " If you are a Java wizard, check out the git issue here: \n"
+							+ " https://gitlab.com/jeseibel/minecraft-lod-mod/-/issues/35 \n")
+					.define("allowUnstableFeatureGeneration", false);
+			
+			builder.pop();
+		}
+	}
+	
+	public static class Threading
+	{
+		public ForgeConfigSpec.IntValue numberOfWorldGenerationThreads;
+		public ForgeConfigSpec.IntValue numberOfBufferBuilderThreads;
+		
+		Threading(ForgeConfigSpec.Builder builder)
+		{
+			builder.comment("These settings control how many CPU threads the mod uses for different tasks.").push(this.getClass().getSimpleName());
+			
+			numberOfWorldGenerationThreads = builder
+					.comment("\n\n"
+							+ " This is how many threads are used when generating LODs outside \n"
+							+ " the normal render distance. \n"
+							+ " If you experience stuttering when generating distant LODs, decrease \n"
+							+ " this number. If you want to increase LOD generation speed, \n"
+							+ " increase this number. \n"
+							+ " \n"
+							+ " The maximum value is the number of logical processors on your CPU. \n"
+							+ " Requires a restart to take effect. \n")
+					.defineInRange("numberOfWorldGenerationThreads", Runtime.getRuntime().availableProcessors() / 2, 1, Runtime.getRuntime().availableProcessors());
+			
+			numberOfBufferBuilderThreads = builder
+					.comment("\n\n"
+							+ " This is how many threads are used when building vertex buffers \n"
+							+ " (The things sent to your GPU to draw the LODs). \n"
+							+ " If you experience high CPU useage when NOT generating distant \n"
+							+ " LODs, lower this number. \n"
+							+ " \n"
+							+ " The maximum value is the number of logical processors on your CPU. \n"
+							+ " Requires a restart to take effect. \n")
+					.defineInRange("numberOfBufferBuilderThreads", Runtime.getRuntime().availableProcessors(), 1, Runtime.getRuntime().availableProcessors());
+			
+			builder.pop();
+		}
+	}
+	
+	public static class Debugging
+	{
+		public ForgeConfigSpec.EnumValue<DebugMode> debugMode;
+		public ForgeConfigSpec.BooleanValue enableDebugKeybindings;
+		
+		Debugging(ForgeConfigSpec.Builder builder)
+		{
+			builder.comment("These settings can be used to look for bugs, or see how certain aspects of the mod work.").push(this.getClass().getSimpleName());
+			
+			debugMode = builder
+					.comment("\n\n"
+							+ " " + DebugMode.OFF + ": LODs will draw with their normal colors. \n"
+							+ " " + DebugMode.SHOW_DETAIL + ": LOD colors will be based on their detail level. \n"
+							+ " " + DebugMode.SHOW_DETAIL_WIREFRAME + ": LOD colors will be based on their detail level, drawn as a wireframe. \n")
+					.defineEnum("debugMode", DebugMode.OFF);
+			
+			enableDebugKeybindings = builder
+					.comment("\n\n"
+							+ " If true the F4 key can be used to cycle through the different debug modes. \n"
+							+ " and the F6 key can be used to enable and disable LOD rendering.")
+					.define("enableDebugKeybinding", false);
+			
+			builder.pop();
+		}
+	}
+	
+	public static class Buffers
+	{
+		public ForgeConfigSpec.IntValue bufferRebuildPlayerMoveTimeout;
+		public ForgeConfigSpec.IntValue bufferRebuildChunkChangeTimeout;
+		public ForgeConfigSpec.IntValue bufferRebuildLodChangeTimeout;
+		
+		Buffers(ForgeConfigSpec.Builder builder)
+		{
+			builder.comment("These settings affect when Vertex Buffers are built.").push(this.getClass().getSimpleName());
+			
+			bufferRebuildPlayerMoveTimeout = builder
+					.comment("\n\n"
+							+ " How long in milliseconds should we wait to \n"
+							+ " rebuild the vertex buffers when the player moves \n"
+							+ " a chunk or more? \n")
+					.defineInRange("bufferRebuildPlayerMoveTimeout", 2000, 1, 60000);
+			
+			bufferRebuildChunkChangeTimeout = builder
+					.comment("\n\n"
+							+ " How long in milliseconds should we wait to \n"
+							+ " rebuild the vertex buffers when the vanilla rendered \n"
+							+ " chunks change? \n")
+					.defineInRange("bufferRebuildChunkChangeTimeout", 1000, 1, 60000);
+			
+			bufferRebuildLodChangeTimeout = builder
+					.comment("\n\n"
+							+ " How long in milliseconds should we wait to \n"
+							+ " rebuild the vertex buffers when the LOD regions change? \n")
+					.defineInRange("bufferRebuildLodChangeTimeout", 5000, 1, 60000);
+			
+			builder.pop();
+		}
+	}
+	
+	/**
+	 * {@link Path} to the configuration file of this mod
+	 */
+	private static final Path CONFIG_PATH = Paths.get("config", ModInfo.MODID + ".toml");
+	
+	public static final ForgeConfigSpec CLIENT_SPEC;
+	public static final Client CLIENT;
+	
+	static
+	{
+		final Pair<Client, ForgeConfigSpec> specPair = new ForgeConfigSpec.Builder().configure(Client::new);
+		CLIENT_SPEC = specPair.getRight();
+		CLIENT = specPair.getLeft();
+		CommentedFileConfig clientConfig = CommentedFileConfig.builder(CONFIG_PATH)
+				.writingMode(WritingMode.REPLACE)
+				.build();
+		clientConfig.load();
+		clientConfig.save();
+		CLIENT_SPEC.setConfig(clientConfig);
+	}
+	
+	@SubscribeEvent
+	public static void onLoad(final ModConfig.Loading configEvent)
+	{
+		LogManager.getLogger().debug(ModInfo.MODNAME, "Loaded forge config file {}", configEvent.getConfig().getFileName());
+	}
+	
+	@SubscribeEvent
+	public static void onFileChange(final ModConfig.Reloading configEvent)
+	{
+		LogManager.getLogger().debug(ModInfo.MODNAME, "Forge config just got changed on the file system!");
+	}
+	
+}
@@ -0,0 +1,51 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+/**
+ * off, detail, detail wireframe
+ * 
+ * @author James Seibel
+ * @version 8-28-2021
+ */
+public enum DebugMode
+{
+	/** LODs are rendered normally */
+	OFF,
+	
+	/** LOD colors are based on their detail */
+	SHOW_DETAIL,
+	
+	/** LOD colors are based on their detail, and draws in wireframe. */
+	SHOW_DETAIL_WIREFRAME;
+	
+	/** used when cycling through the different modes */
+	private DebugMode next;
+	static 
+	{
+		OFF.next = SHOW_DETAIL;
+		SHOW_DETAIL.next = SHOW_DETAIL_WIREFRAME;
+		SHOW_DETAIL_WIREFRAME.next = OFF;
+	}
+	
+	/** returns the next debug mode */
+	public DebugMode getNext()
+	{
+		return this.next;
+	}
+}
@@ -0,0 +1,35 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+/**
+ * By_Region_Fast, <br>
+ * By_Region_Fancy, <br>
+ * By_Chunk
+ * 
+ * @author Leonardo Amato
+ * @version 9-25-2021
+ */
+public enum DetailDropOff
+{
+	/** quality is determined per-region, using the lowest quality that would be used in BY_CHUNK */
+	FAST,
+
+	/** quality is determined per-block (best quality option, may cause stuttering when moving) */
+	FANCY,
+}
@@ -0,0 +1,93 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+/**
+ * NONE <br>
+ * BIOME_ONLY <br>
+ * BIOME_ONLY_SIMULATE_HEIGHT <br>
+ * SURFACE <br>
+ * FEATURES <br>
+ * SERVER <br><br>
+ * <p>
+ * In order of fastest to slowest.
+ *
+ * @author James Seibel
+ * @author Leonardo Amato
+ * @version 8-7-2021
+ */
+public enum DistanceGenerationMode
+{
+	/**
+	 * Don't generate anything
+	 */
+	NONE((byte) 0),
+
+	/**
+	 * Only generate the biomes and use biome
+	 * grass/foliage color, water color, or ice color
+	 * to generate the color.
+	 * Doesn't generate height, everything is shown at sea level.
+	 * Multithreaded - Fastest (2-5 ms)
+	 */
+	BIOME_ONLY((byte) 1),
+
+	/**
+	 * Same as BIOME_ONLY, except instead
+	 * of always using sea level as the LOD height
+	 * different biome types (mountain, ocean, forest, etc.)
+	 * use predetermined heights to simulate having height data.
+	 */
+	BIOME_ONLY_SIMULATE_HEIGHT((byte) 2),
+
+	/**
+	 * Generate the world surface,
+	 * this does NOT include caves, trees,
+	 * or structures.
+	 * Multithreaded - Faster (10-20 ms)
+	 */
+	SURFACE((byte) 3),
+
+	/**
+	 * Generate everything except structures.
+	 * NOTE: This may cause world generation bugs or instability,
+	 * since some features cause concurrentModification exceptions.
+	 * Multithreaded - Fast (15-20 ms)
+	 */
+	FEATURES((byte) 4),
+
+	/**
+	 * Ask the server to generate/load each chunk.
+	 * This is the most compatible, but causes server/simulation lag.
+	 * This will also show player made structures if you
+	 * are adding the mod to a pre-existing world.
+	 * Singlethreaded - Slow (15-50 ms, with spikes up to 200 ms)
+	 */
+	SERVER((byte) 5);
+
+
+	/**
+	 * The higher the number the more complete the generation is.
+	 */
+	public final byte complexity;
+
+	DistanceGenerationMode(byte complexity)
+	{
+		this.complexity = complexity;
+	}
+}
@@ -0,0 +1,36 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+/**
+ * NEAR, FAR, or NEAR_AND_FAR.
+ * 
+ * @author James Seibel
+ * @version 02-14-2021
+ */
+public enum FogDistance
+{
+	/** good for fast or fancy fog qualities. */
+	NEAR,
+	
+	/** good for fast or fancy fog qualities. */
+	FAR,
+	
+	/** only looks good if the fog quality is set to Fancy. */
+	NEAR_AND_FAR;
+}
@@ -0,0 +1,43 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+/**
+ * USE_OPTIFINE_FOG_SETTING, <br>
+ * NEVER_DRAW_FOG, <br>
+ * ALWAYS_DRAW_FOG_FAST, <br>
+ * ALWAYS_DRAW_FOG_FANCY <br>
+ * 
+ * @author James Seibel
+ * @version 7-3-2021
+ */
+public enum FogDrawOverride
+{
+	/** Use whatever Fog setting optifine is using.
+	 * If optifine isn't installed this defaults to ALWAYS_DRAW_FOG. */
+	USE_OPTIFINE_FOG_SETTING,
+	
+	/** Never draw fog on the LODs */
+	NEVER_DRAW_FOG,
+	
+	/** Always draw fog on the LODs */
+	ALWAYS_DRAW_FOG_FAST,
+	
+	/** Always draw fog on the LODs */
+	ALWAYS_DRAW_FOG_FANCY;
+}
@@ -0,0 +1,31 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+/**
+ * fast, fancy, or off
+ * 
+ * @author James Seibel
+ * @version 02-14-2021
+ */
+public enum FogQuality
+{
+	FAST,
+	FANCY,
+	OFF;
+}
@@ -0,0 +1,35 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+/**
+ * Near_First <br>
+ * Far_First <br>
+ * <br>
+ * Determines which LODs should have priority when generating
+ * outside the normal view distance.
+ * 
+ * @author Leonardo Amato
+ * @version 9-25-2021
+ */
+public enum GenerationPriority
+{
+	NEAR_FIRST,
+	
+	FAR_FIRST;
+}
@@ -0,0 +1,50 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+/**
+ * Low <br>
+ * Medium <br>
+ * High <br>
+ * <br>
+ * this indicate the base of the quadratic function we use for the quality drop off
+ * 
+ * @author Leonardo Amato
+ * @version 9-29-2021
+ */
+public enum HorizontalQuality
+{
+	/** Lods are 2D with heightMap */
+	LINEAR(1.0f),
+
+	/** Lods are 2D with heightMap */
+	LOW(1.5f),
+
+	/** Lods expand in three dimension */
+	MEDIUM(2.0f),
+
+	/** Lods expand in three dimension */
+	HIGH(2.2f);
+
+	public double quadraticBase;
+
+	HorizontalQuality(double distanceUnit)
+	{
+		this.quadraticBase = distanceUnit;
+	}
+}
@@ -0,0 +1,165 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+import java.util.ArrayList;
+import java.util.Collections;
+
+import com.seibel.lod.util.LodUtil;
+
+/**
+ * chunk <Br>
+ * half_chunk <Br>
+ * four_blocks <br>
+ * two_blocks <Br>
+ * block <br>
+ * 
+ * @author James Seibel
+ * @author Leonardo Amato
+ * @version 9-25-2021
+ */
+public enum HorizontalResolution
+{
+	/** render 1 LOD for each chunk */
+	CHUNK(1, 4),
+	
+	/** render 4 LODs for each chunk */
+	HALF_CHUNK(2, 3),
+	
+	/** render 16 LODs for each chunk */
+	FOUR_BLOCKS(4, 2),
+	
+	/** render 64 LODs for each chunk */
+	TWO_BLOCKS(8, 1),
+	
+	/** render 256 LODs for each chunk */
+	BLOCK(16, 0);
+
+	/** How many DataPoints should 
+	 * be drawn per side per LodChunk */
+	public final int dataPointLengthCount;
+	
+	/** How wide each LOD DataPoint is */
+	public final int dataPointWidth;
+	
+	/** This is the same as detailLevel in LodQuadTreeNode, 
+	 * lowest is 0 highest is 9 */
+	public final byte detailLevel;
+	
+	/* Start/End X/Z give the block positions
+	 * for each individual dataPoint in a LodChunk */
+	public final int[] startX;
+	public final int[] startZ;
+	
+	public final int[] endX;
+	public final int[] endZ;
+
+	
+	/** 
+	 * 1st dimension: LodDetail.detailLevel <br>
+	 * 2nd dimension: An array of all LodDetails that are less than or <br>
+	 *                equal to that detailLevel
+	 */
+	private static HorizontalResolution[][] lowerDetailArrays;
+	
+	
+	
+	
+	private HorizontalResolution(int newLengthCount, int newDetailLevel)
+	{
+		detailLevel = (byte) newDetailLevel;
+		dataPointLengthCount = newLengthCount;
+		dataPointWidth = 16 / dataPointLengthCount;
+		
+		startX = new int[dataPointLengthCount * dataPointLengthCount];
+		endX = new int[dataPointLengthCount * dataPointLengthCount];
+		
+		startZ = new int[dataPointLengthCount * dataPointLengthCount];
+		endZ = new int[dataPointLengthCount * dataPointLengthCount];
+		
+		
+		int index = 0;
+		for(int x = 0; x < newLengthCount; x++)
+		{
+			for(int z = 0; z < newLengthCount; z++)
+			{
+				startX[index] = x * dataPointWidth;
+				startZ[index] = z * dataPointWidth;
+				
+				endX[index] = (x*dataPointWidth) + dataPointWidth;
+				endZ[index] = (z*dataPointWidth) + dataPointWidth;
+				
+				index++;
+			}
+		}
+		
+	}// constructor
+	
+	
+	
+	
+	
+	
+	/** 
+	 * 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)
+	{
+		if (lowerDetailArrays == null)
+		{
+			// run first time setup
+			lowerDetailArrays = new HorizontalResolution[HorizontalResolution.values().length][];
+			
+			// go through each LodDetail
+			for(HorizontalResolution currentDetail : HorizontalResolution.values())
+			{
+				ArrayList<HorizontalResolution> lowerDetails = new ArrayList<>();
+				
+				// find the details lower than currentDetail
+				for(HorizontalResolution compareDetail : HorizontalResolution.values())
+				{
+					if (currentDetail.detailLevel <= compareDetail.detailLevel)
+					{
+						lowerDetails.add(compareDetail);
+					}
+				}
+				
+				// have the highest detail item first in the list
+				Collections.sort(lowerDetails);
+				Collections.reverse(lowerDetails);
+				
+				lowerDetailArrays[currentDetail.detailLevel] = lowerDetails.toArray(new HorizontalResolution[lowerDetails.size()]);
+			}
+		}
+		
+		return lowerDetailArrays[detail.detailLevel];
+	}
+	
+	/** Returns what detail level should be used at a given distance and maxDistance. */
+	public static HorizontalResolution getDetailForDistance(HorizontalResolution maxDetailLevel, int distance, int maxDistance)
+	{
+		HorizontalResolution[] lowerDetails = getSelfAndLowerDetails(maxDetailLevel);
+		int distaneBetweenDetails = maxDistance / lowerDetails.length;
+		int index = LodUtil.clamp(0, distance / distaneBetweenDetails, lowerDetails.length - 1);
+		
+		return lowerDetails[index];
+		
+	}
+	
+}
@@ -0,0 +1,47 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+/**
+ * Low <br>
+ * Medium <br>
+ * High <br>
+ * <br>
+ * this is a quality scale for the detail drop-off
+ * 
+ * @author Leonardo Amato
+ * @version 9-25-2021
+ */
+public enum HorizontalScale
+{
+	/** Lods are 2D with heightMap */
+	LOW(64),
+	
+	/** Lods expand in three dimension */
+	MEDIUM(128),
+	
+	/** Lods expand in three dimension */
+	HIGH(256);
+	
+	public int distanceUnit;
+	
+	HorizontalScale(int distanceUnit)
+	{
+		this.distanceUnit = distanceUnit;
+	}
+}
@@ -0,0 +1,59 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+import com.seibel.lod.builders.lodTemplates.AbstractLodTemplate;
+import com.seibel.lod.builders.lodTemplates.CubicLodTemplate;
+import com.seibel.lod.builders.lodTemplates.DynamicLodTemplate;
+import com.seibel.lod.builders.lodTemplates.TriangularLodTemplate;
+
+/**
+ * Cubic, Triangular, Dynamic
+ * 
+ * @author James Seibel
+ * @version 8-4-2021
+ */
+public enum LodTemplate
+{
+	/** LODs are rendered as
+	 * rectangular prisms. */
+	CUBIC(new CubicLodTemplate()),
+	
+	/** LODs smoothly transition between
+	 * each other. */
+	TRIANGULAR(new TriangularLodTemplate()),
+	
+	/** LODs smoothly transition between
+	 * each other, unless a neighboring LOD
+	 * is at a significantly different height. */
+	DYNAMIC(new DynamicLodTemplate());
+	
+	
+	public final AbstractLodTemplate template;
+	
+	private LodTemplate(AbstractLodTemplate newTemplate)
+	{
+		template = newTemplate;
+	}
+	
+	
+	public int getBufferMemoryForSingleLod(int maxVerticalData)
+	{
+		return template.getBufferMemoryForSingleNode(maxVerticalData);
+	}
+}
@@ -0,0 +1,22 @@
+package com.seibel.lod.enums;
+
+/**
+ * NONE, GAME_SHADING
+ * 
+ * @author James Seibel
+ * @version 7-25-2020
+ */
+public enum ShadingMode
+{
+	/**
+	 * LODs will have the same lighting on every side.
+	 * can make large similarly colored areas hard to differentiate
+	 */
+	NONE,
+	
+	/**
+	 * LODs will have darker sides and bottoms to simulate 
+	 * Minecraft's fast, top down lighting.
+	 */
+	GAME_SHADING;
+}
@@ -0,0 +1,34 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.enums;
+
+/**
+ * heightmap <br>
+ * multi_lod <br>
+ * 
+ * @author Leonardo Amato
+ * @version 9-27-2021
+ */
+public enum VerticalQuality
+{
+	/** Lods only have height and depth data */
+	HEIGHTMAP,
+
+	/** Lods expand in three dimensions */
+	VOXEL;
+}
@@ -0,0 +1,388 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.handlers;
+
+import java.io.BufferedInputStream;
+import java.io.BufferedOutputStream;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.nio.file.Files;
+import java.nio.file.StandardCopyOption;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.enums.VerticalQuality;
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.objects.LodRegion;
+import com.seibel.lod.objects.RegionPos;
+import com.seibel.lod.objects.SingleLevelContainer;
+import com.seibel.lod.objects.VerticalLevelContainer;
+import com.seibel.lod.proxy.ClientProxy;
+import com.seibel.lod.util.LodThreadFactory;
+import com.seibel.lod.util.LodUtil;
+
+/**
+ * This object handles creating LodRegions
+ * from files and saving LodRegion objects
+ * to file.
+ * 
+ * @author James Seibel
+ * @author Cola
+ * @version 9-25-2021
+ */
+public class LodDimensionFileHandler
+{
+	/** This is the dimension that owns this file handler */
+	private LodDimension lodDimension = null;
+	
+	private File dimensionDataSaveFolder;
+	
+	/** lod */
+	private static final String FILE_NAME_PREFIX = "lod";
+	/** .txt */
+	private static final String FILE_EXTENSION = ".dat";
+	/** detail- */
+	private static final String DETAIL_FOLDER_NAME_PREFIX = "detail-";
+	
+	/**
+	 * .tmp <br>
+	 * Added to the end of the file path when saving to prevent
+	 * nulling a currently existing file. <br>
+	 * After the file finishes saving it will end with
+	 * FILE_EXTENSION.
+	 */
+	private static final String TMP_FILE_EXTENSION = ".tmp";
+	
+	/**
+	 * This is the file version currently accepted by this
+	 * file handler, older versions (smaller numbers) will be deleted and overwritten,
+	 * newer versions (larger numbers) will be ignored and won't be read.
+	 */
+	public static final int LOD_SAVE_FILE_VERSION = 6;
+	
+	/**
+	 * Allow saving asynchronously, but never try to save multiple regions
+	 * at a time
+	 */
+	private ExecutorService fileWritingThreadPool = Executors.newSingleThreadExecutor(new LodThreadFactory(this.getClass().getSimpleName()));
+	
+	
+	
+	
+	public LodDimensionFileHandler(File newSaveFolder, LodDimension newLodDimension)
+	{
+		if (newSaveFolder == null)
+			throw new IllegalArgumentException("LodDimensionFileHandler requires a valid File location to read and write to.");
+		
+		dimensionDataSaveFolder = newSaveFolder;
+		lodDimension = newLodDimension;
+	}
+	
+	
+	
+	//================//
+	// read from file //
+	//================//
+	
+	/**
+	 * Returns the LodRegion at the given coordinates.
+	 * Returns an empty region if the file doesn't exist.
+	 */
+	public LodRegion loadRegionFromFile(byte detailLevel, RegionPos regionPos, DistanceGenerationMode generationMode, VerticalQuality verticalQuality)
+	{
+		int regionX = regionPos.x;
+		int regionZ = regionPos.z;
+		LodRegion region = new LodRegion(LodUtil.REGION_DETAIL_LEVEL, regionPos, generationMode, verticalQuality);
+		
+		for (byte tempDetailLevel = LodUtil.REGION_DETAIL_LEVEL; tempDetailLevel >= detailLevel; tempDetailLevel--)
+		{
+			String fileName = getFileNameAndPathForRegion(regionX, regionZ, generationMode, tempDetailLevel, verticalQuality);
+			
+			try
+			{
+				// if the fileName was null that means the folder is inaccessible
+				// for some reason
+				if (fileName == null)
+					throw new IllegalArgumentException("Unable to read region [" + regionX + ", " + regionZ + "] file, no fileName.");
+				
+				
+				File file = new File(fileName);
+				
+				if (!file.exists())
+				{
+					// there wasn't a file, don't
+					// return anything
+					continue;
+				}
+				
+				
+				
+				// don't try parsing empty files
+				long dataSize = file.length();
+				dataSize -= 1;
+				if (dataSize > 0)
+				{
+					try (InputStream inputStream = new BufferedInputStream(new FileInputStream(file)))
+					{
+						int fileVersion = -1;
+						fileVersion = inputStream.read();
+						
+						// check if this file can be read by this file handler
+						if (fileVersion < LOD_SAVE_FILE_VERSION)
+						{
+							// the file we are reading is an older version,
+							// close the reader and delete the file.
+							inputStream.close();
+							file.delete();
+							ClientProxy.LOGGER.info("Outdated LOD region file for region: (" + regionX + "," + regionZ + ")"
+									+ " version found: " + fileVersion
+									+ ", version requested: " + LOD_SAVE_FILE_VERSION
+									+ ". File was been deleted.");
+							
+							break;
+						}
+						else if (fileVersion > LOD_SAVE_FILE_VERSION)
+						{
+							// the file we are reading is a newer version,
+							// close the reader and ignore the file, we don't
+							// want to accidently delete anything the user may want.
+							inputStream.close();
+							ClientProxy.LOGGER.info("Newer LOD region file for region: (" + regionX + "," + regionZ + ")"
+									+ " version found: " + fileVersion
+									+ ", version requested: " + LOD_SAVE_FILE_VERSION
+									+ " this region will not be written to in order to protect the newer file.");
+							
+							break;
+						}
+						
+						
+						// this file is a readable version, 
+						// read the file
+						byte[] data = new byte[(int) dataSize];
+						inputStream.read(data);
+						inputStream.close();
+						
+						
+						// add the data to our region
+						switch (region.getVerticalQuality())
+						{
+						default:
+						case HEIGHTMAP:
+							region.addLevelContainer(new SingleLevelContainer(data));
+							break;
+						case VOXEL:
+							region.addLevelContainer(new VerticalLevelContainer(data));
+							break;
+						}
+					}
+					catch (IOException ioEx)
+					{
+						ClientProxy.LOGGER.error("LOD file read error. Unable to read to [" + fileName + "] error [" + ioEx.getMessage() + "]: ");
+						ioEx.printStackTrace();
+					}
+				}// file datasize > 0
+			}
+			catch (Exception e)
+			{
+				// the buffered reader encountered a
+				// problem reading the file
+				ClientProxy.LOGGER.error("LOD file read error. Unable to read to [" + fileName + "] error [" + e.getMessage() + "]: ");
+				e.printStackTrace();
+			}
+		}// for each detail level
+		
+		if (region.getMinDetailLevel() >= detailLevel)
+			region.growTree(detailLevel);
+		
+		return region;
+	}
+	
+	
+	//==============//
+	// Save to File //
+	//==============//
+	
+	/**
+	 * Save all dirty regions in this LodDimension to file.
+	 */
+	public void saveDirtyRegionsToFileAsync()
+	{
+		fileWritingThreadPool.execute(saveDirtyRegionsThread);
+	}
+	
+	private Thread saveDirtyRegionsThread = new Thread(() ->
+	{
+		try
+		{
+			for (int i = 0; i < lodDimension.getWidth(); i++)
+			{
+				for (int j = 0; j < lodDimension.getWidth(); j++)
+				{
+					// TODO shouldn't this use lodDimension.isRegionDirty?
+					if (lodDimension.doesRegionNeedBufferRegen(i,j) && lodDimension.getRegionByArrayIndex(i,j) != null)
+					{
+						saveRegionToFile(lodDimension.getRegionByArrayIndex(i,j));
+						lodDimension.setRegenRegionBufferByArrayIndex(i, j,false);
+					}
+				}
+			}
+		}
+		catch (Exception e)
+		{
+			e.printStackTrace();
+		}
+	});
+	
+	/**
+	 * Save a specific region to disk.<br>
+	 * Note: <br>
+	 * 1. If a file already exists for a newer version
+	 * the file won't be written.<br>
+	 * 2. This will save to the LodDimension that this
+	 * handler is associated with.
+	 */
+	private void saveRegionToFile(LodRegion region)
+	{
+		for (byte detailLevel = region.getMinDetailLevel(); detailLevel <= LodUtil.REGION_DETAIL_LEVEL; detailLevel++)
+		{
+			String fileName = getFileNameAndPathForRegion(region.regionPosX, region.regionPosZ, region.getGenerationMode(), detailLevel, region.getVerticalQuality());
+			File oldFile = new File(fileName);
+			
+			// if the fileName was null that means the folder is inaccessible
+			// for some reason
+			if (fileName == null)
+			{
+				ClientProxy.LOGGER.warn("Unable to save region [" + region.regionPosX + ", " + region.regionPosZ + "] to file, file is inaccessible.");
+				return;
+			}
+			
+			
+			try
+			{
+				// make sure the file and folder exists
+				if (!oldFile.exists())
+				{
+					// the file doesn't exist,
+					// create it and the folder if need be
+					if (!oldFile.getParentFile().exists())
+						oldFile.getParentFile().mkdirs();
+					oldFile.createNewFile();
+				}
+				else
+				{
+					// the file exists, make sure it
+					// is the correct version.
+					// (to make sure we don't overwrite a newer
+					// version file if it exists)
+					int fileVersion = LOD_SAVE_FILE_VERSION;
+					try (InputStream inputStream = new BufferedInputStream(new FileInputStream(oldFile)))
+					{
+						fileVersion = inputStream.read();
+						inputStream.close();
+					}
+					catch (IOException ex)
+					{
+						ex.printStackTrace();
+					}
+					
+					// check if this file can be written to by the file handler
+					if (fileVersion > LOD_SAVE_FILE_VERSION)
+					{
+						// the file we are reading is a newer version,
+						// don't write anything, we don't want to accidently
+						// delete anything the user may want.
+						return;
+					}  
+					
+					// if we got this far then we are good
+					// to overwrite the old file
+				}
+				
+				// the old file is good, now create a new temporary save file
+				File newFile = new File(fileName + TMP_FILE_EXTENSION);
+				try (OutputStream outputStream = new BufferedOutputStream(new FileOutputStream(newFile)))
+				{
+					// add the version of this file
+					outputStream.write(LOD_SAVE_FILE_VERSION);
+					
+					// add each LodChunk to the file
+					outputStream.write(region.getLevel(detailLevel).toDataString());
+					outputStream.close();
+					
+					// overwrite the old file with the new one
+					Files.move(newFile.toPath(), oldFile.toPath(), StandardCopyOption.ATOMIC_MOVE, StandardCopyOption.REPLACE_EXISTING);
+				}
+				catch (IOException ex)
+				{
+					ex.printStackTrace();
+				}
+			}
+			catch (Exception e)
+			{
+				ClientProxy.LOGGER.error("LOD file write error. Unable to write to [" + fileName + "] error [" + e.getMessage() + "]: ");
+				e.printStackTrace();
+			}
+		}
+	}
+	
+	
+	
+	
+	
+	//================//
+	// helper methods //
+	//================//
+	
+	
+	/**
+	 * Return the name of the file that should contain the
+	 * region at the given x and z. <br>
+	 * Returns null if this object isn't available to read and write. <br><br>
+	 * <p>
+	 * example: "lod.0.0.txt" <br>
+	 * <p>
+	 * Returns null if there is an IO or security Exception.
+	 */
+	private String getFileNameAndPathForRegion(int regionX, int regionZ, DistanceGenerationMode generationMode, byte detailLevel, VerticalQuality verticalQuality)
+	{
+		try
+		{
+			// saveFolder is something like
+			// ".\Super Flat\DIM-1\data\"
+			// or
+			// ".\Super Flat\data\"
+			return dimensionDataSaveFolder.getCanonicalPath() + File.separatorChar +
+					verticalQuality + File.separatorChar +
+					generationMode.toString() + File.separatorChar +
+					DETAIL_FOLDER_NAME_PREFIX + detailLevel + File.separatorChar +
+					FILE_NAME_PREFIX + "." + regionX + "." + regionZ + FILE_EXTENSION;
+		}
+		catch (IOException | SecurityException e)
+		{
+			ClientProxy.LOGGER.warn("Unable to get the filename for the region [" + regionX + ", " + regionZ + "], error: [" + e.getMessage() + "], stacktrace: ");
+			e.printStackTrace();
+			return null;
+		}
+	}
+	
+}
@@ -0,0 +1,120 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.handlers;
+
+import java.lang.reflect.Field;
+import java.lang.reflect.Method;
+
+import com.seibel.lod.enums.FogQuality;
+import com.seibel.lod.proxy.ClientProxy;
+import com.seibel.lod.wrappers.MinecraftWrapper;
+
+/**
+ * This object is used to get variables from methods
+ * where they are private. Specifically the fog setting
+ * in Optifine.
+ *
+ * @author James Seibel
+ * @version 9-25-2021
+ */
+public class ReflectionHandler
+{
+	public static final ReflectionHandler INSTANCE = new ReflectionHandler();
+	private MinecraftWrapper mc = MinecraftWrapper.INSTANCE;
+	
+	public Field ofFogField = null;
+	public Method vertexBufferUploadMethod = null;
+	
+	
+	
+	private ReflectionHandler()
+	{
+		setupFogField();
+	}
+	
+	
+	/**
+	 * finds the Optifine fog type field
+	 */
+	private void setupFogField()
+	{
+		// get every variable from the entity renderer
+		Field[] optionFields = mc.getOptions().getClass().getDeclaredFields();
+		
+		// try and find the ofFogType variable in gameSettings
+		for (Field field : optionFields)
+		{
+			if (field.getName().equals("ofFogType"))
+			{
+				ofFogField = field;
+				return;
+			}
+		}
+		
+		// we didn't find the field,
+		// either optifine isn't installed, or
+		// optifine changed the name of the variable
+		ClientProxy.LOGGER.info(ReflectionHandler.class.getSimpleName() + ": unable to find the Optifine fog field. If Optifine isn't installed this can be ignored.");
+	}
+	
+	
+	
+	
+	/**
+	 * Get what type of fog optifine is currently set to render.
+	 */
+	public FogQuality getFogQuality()
+	{
+		if (ofFogField == null)
+		{
+			// either optifine isn't installed,
+			// the variable name was changed, or
+			// the setup method wasn't called yet.
+			return FogQuality.FANCY;
+		}
+		
+		int returnNum = 0;
+		
+		try
+		{
+			returnNum = (int) ofFogField.get(mc.getOptions());
+		}
+		catch (IllegalArgumentException | IllegalAccessException e)
+		{
+			e.printStackTrace();
+		}
+		
+		switch (returnNum)
+		{
+		default:
+		case 0:
+			// optifine's "default" option,
+			// it should never be called in this case
+			return FogQuality.FAST;
+			
+			
+			// normal options
+		case 1:
+			return FogQuality.FAST;
+		case 2:
+			return FogQuality.FANCY;
+		case 3:
+			return FogQuality.OFF;
+		}
+	}
+}
@@ -0,0 +1,63 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.mixin;
+
+import org.spongepowered.asm.mixin.Mixin;
+import org.spongepowered.asm.mixin.injection.At;
+import org.spongepowered.asm.mixin.injection.Inject;
+import org.spongepowered.asm.mixin.injection.callback.CallbackInfo;
+
+import com.mojang.blaze3d.matrix.MatrixStack;
+import com.seibel.lod.LodMain;
+import com.seibel.lod.config.LodConfig;
+
+import net.minecraft.client.renderer.RenderType;
+import net.minecraft.client.renderer.WorldRenderer;
+
+/**
+ * This class is used to mix in my rendering code
+ * before Minecraft starts rendering blocks.
+ * If this wasn't done and we used Forge's 
+ * render last event, the LODs would render on top
+ * of the normal terrain.
+ * 
+ * @author James Seibel
+ * @version 9-19-2021
+ */
+@Mixin(WorldRenderer.class)
+public class MixinWorldRenderer
+{
+	private static float previousPartialTicks = 0;
+	
+	@Inject(at = @At("RETURN"), method = "renderSky(Lcom/mojang/blaze3d/matrix/MatrixStack;F)V", cancellable = false)
+	private void renderSky(MatrixStack matrixStackIn, float partialTicks, CallbackInfo callback)
+	{
+		// get the partial ticks since renderBlockLayer doesn't
+		// have access to them
+		previousPartialTicks = partialTicks;
+	}
+	
+	@Inject(at = @At("HEAD"), method = "renderChunkLayer(Lnet/minecraft/client/renderer/RenderType;Lcom/mojang/blaze3d/matrix/MatrixStack;DDD)V", cancellable = false)
+	private void renderChunkLayer(RenderType renderType, MatrixStack matrixStackIn, double xIn, double yIn, double zIn, CallbackInfo callback)
+	{
+		// only render if LODs are enabled and
+		// only render before solid blocks
+		if (LodConfig.CLIENT.graphics.drawLods.get() && renderType.equals(RenderType.solid()))
+			LodMain.client_proxy.renderLods(matrixStackIn, previousPartialTicks);
+	}
+}
@@ -0,0 +1,93 @@
+package com.seibel.lod.objects;
+
+public interface LevelContainer
+{
+	public static final char VERTICAL_DATA_DELIMITER = '\t';
+	public static final char DATA_DELIMITER = ' ';
+	
+	/**With this you can add data to the level container
+	 *
+	 * @param data actual data to add in a array of long format.
+	 * @param posX x position in the detail level
+	 * @param posZ z position in the detail level
+	 * @param index z position in the detail level
+	 * @return true if correctly added, false otherwise
+	 */
+	public boolean addData(long data, int posX, int posZ, int index);
+	
+	/**With this you can add data to the level container
+	 *
+	 * @param data actual data to add in a array of long format.
+	 * @param posX x position in the detail level
+	 * @param posZ z position in the detail level
+	 * @return true if correctly added, false otherwise
+	 */
+	public boolean addSingleData(long data, int posX, int posZ);
+	
+	/**With this you can get data from the level container
+	 *
+	 * @param posX x position in the detail level
+	 * @param posZ z position in the detail level
+	 * @return the data in long array format
+	 */
+	public long getData(int posX, int posZ, int index);
+	
+	/**With this you can get data from the level container
+	 *
+	 * @param posX x position in the detail level
+	 * @param posZ z position in the detail level
+	 * @return the data in long array format
+	 */
+	public long getSingleData(int posX, int posZ);
+	
+	/**
+	 * @param posX x position in the detail level
+	 * @param posZ z position in the detail level
+	 * @return true only if the data exist
+	 */
+	public boolean doesItExist(int posX, int posZ);
+	
+	/**
+	 * @return return the deatilLevel of this level container
+	 */
+	public byte getDetailLevel();
+	
+	
+	public int getMaxVerticalData();
+	
+	/** Clears the dataPoint at the given array index */
+	public void clear(int posX, int posZ);
+	
+	/**This return a level container with detail level lower than the current level.
+	 * The new level container may use information of this level.
+	 * @return the new level container
+	 */
+	public LevelContainer expand();
+	
+	/**
+	 *
+	 * @param lowerLevelContainer lower level where we extract the data
+	 * @param posX x position in the detail level to update
+	 * @param posZ z position in the detail level to update
+	 */
+	public void updateData(LevelContainer lowerLevelContainer, int posX, int posZ);
+	
+	/**
+	 * This will give the data to save in the file
+	 * @return data as a String
+	 */
+	public byte[] toDataString();
+	
+	
+	/**
+	 * This will give the data to save in the file
+	 * @return data as a String
+	 */
+	public int getMaxNumberOfLods();
+	
+	/**
+	 * This will give the data to save in the file
+	 * @return data as a String
+	 */
+	public int getMaxMemoryUse();
+}
@@ -0,0 +1,909 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.objects;
+
+import java.io.File;
+import java.io.IOException;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.enums.GenerationPriority;
+import com.seibel.lod.enums.LodTemplate;
+import com.seibel.lod.enums.VerticalQuality;
+import com.seibel.lod.handlers.LodDimensionFileHandler;
+import com.seibel.lod.util.DataPointUtil;
+import com.seibel.lod.util.DetailDistanceUtil;
+import com.seibel.lod.util.LevelPosUtil;
+import com.seibel.lod.util.LodThreadFactory;
+import com.seibel.lod.util.LodUtil;
+import com.seibel.lod.wrappers.MinecraftWrapper;
+
+import net.minecraft.util.math.ChunkPos;
+import net.minecraft.world.DimensionType;
+import net.minecraft.world.server.ServerChunkProvider;
+import net.minecraft.world.server.ServerWorld;
+
+
+/**
+ * This object holds all loaded LOD regions
+ * for a given dimension. <Br><Br>
+ * 
+ * <strong>Coordinate Standard: </strong><br>
+ * Coordinate called posX or posZ are relative LevelPos coordinates <br>
+ * unless stated otherwise. <br>
+ * 
+ * @author Leonardo Amato
+ * @author James Seibel
+ * @version 9-27-2021
+ */
+public class LodDimension
+{
+	public final DimensionType dimension;
+	
+	/** measured in regions */
+	private volatile int width;
+	/** measured in regions */
+	private volatile int halfWidth;
+	
+	// these three variables are private to force use of the getWidth() method
+	// which is a safer way to get the width then directly asking the arrays
+	/** stores all the regions in this dimension */
+	public volatile LodRegion[][] regions;
+	
+	/** stores if the region at the given x and z index needs to be saved to disk */
+	private volatile boolean[][] isRegionDirty;
+	/** stores if the region at the given x and z index needs to be regenerated */
+	private volatile boolean[][] regenRegionBuffer;
+	/** stores if the buffer size at the given x and z index needs to be changed */
+	private volatile boolean[][] recreateRegionBuffer;
+	
+	/**
+	 * if true that means there are regions in this dimension
+	 * that need to have their buffers rebuilt.
+	 */
+	public volatile boolean regenDimensionBuffers = false;
+	
+	private LodDimensionFileHandler fileHandler;
+	
+	private volatile RegionPos center;
+	
+	/** prevents the cutAndExpandThread from expanding at the same location multiple times */
+	private volatile ChunkPos lastExpandedChunk;
+	/** prevents the cutAndExpandThread from cutting at the same location multiple times */
+	private volatile ChunkPos lastCutChunk;
+	private ExecutorService cutAndExpandThread = Executors.newSingleThreadExecutor(new LodThreadFactory(this.getClass().getSimpleName() + " - Cut and Expand"));
+	
+	/**
+	 * Creates the dimension centered at (0,0)
+	 *
+	 * @param newWidth in regions
+	 */
+	public LodDimension(DimensionType newDimension, LodWorld lodWorld, int newWidth)
+	{
+		lastCutChunk = null;
+		lastExpandedChunk = null;
+		dimension = newDimension;
+		width = newWidth;
+		halfWidth = width / 2;
+		MinecraftWrapper mc = MinecraftWrapper.INSTANCE;
+		
+		if (newDimension != null && lodWorld != null)
+		{
+			try
+			{
+				File saveDir;
+				if (mc.hasSingleplayerServer())
+				{
+					// local world
+					
+					ServerWorld serverWorld = LodUtil.getServerWorldFromDimension(newDimension);
+					
+					// provider needs a separate variable to prevent
+					// the compiler from complaining
+					ServerChunkProvider provider = serverWorld.getChunkSource();
+					saveDir = new File(provider.dataStorage.dataFolder.getCanonicalFile().getPath() + File.separatorChar + "lod");
+				}
+				else
+				{
+					// connected to server
+					
+					saveDir = new File(mc.getGameDirectory().getCanonicalFile().getPath() +
+							File.separatorChar + "lod server data" + File.separatorChar + mc.getCurrentDimensionId());
+				}
+				
+				fileHandler = new LodDimensionFileHandler(saveDir, this);
+			}
+			catch (IOException e)
+			{
+				// the file handler wasn't able to be created
+				// we won't be able to read or write any files
+			}
+		}
+		
+		
+		regions = new LodRegion[width][width];
+		isRegionDirty = new boolean[width][width];
+		regenRegionBuffer = new boolean[width][width];
+		recreateRegionBuffer = new boolean[width][width];
+		
+		center = new RegionPos(0, 0);
+	}
+	
+	
+	/**
+	 * Move the center of this LodDimension and move all owned
+	 * regions over by the given x and z offset. <br><br>
+	 * <p>
+	 * Synchronized to prevent multiple moves happening on top of each other.
+	 */
+	public synchronized void move(RegionPos regionOffset)
+	{
+		int xOffset = regionOffset.x;
+		int zOffset = regionOffset.z;
+		
+		// if the x or z offset is equal to or greater than
+		// the total width, just delete the current data
+		// and update the centerX and/or centerZ
+		if (Math.abs(xOffset) >= width || Math.abs(zOffset) >= width)
+		{
+			for (int x = 0; x < width; x++)
+				for (int z = 0; z < width; z++)
+					regions[x][z] = null;
+			
+			// update the new center
+			center.x += xOffset;
+			center.z += zOffset;
+			
+			return;
+		}
+		
+		
+		// X
+		if (xOffset > 0)
+		{
+			// move everything over to the left (as the center moves to the right)
+			for (int x = 0; x < width; x++)
+			{
+				for (int z = 0; z < width; z++)
+				{
+					if (x + xOffset < width)
+						regions[x][z] = regions[x + xOffset][z];
+					else
+						regions[x][z] = null;
+				}
+			}
+		}
+		else
+		{
+			// move everything over to the right (as the center moves to the left)
+			for (int x = width - 1; x >= 0; x--)
+			{
+				for (int z = 0; z < width; z++)
+				{
+					if (x + xOffset >= 0)
+						regions[x][z] = regions[x + xOffset][z];
+					else
+						regions[x][z] = null;
+				}
+			}
+		}
+		
+		
+		// Z
+		if (zOffset > 0)
+		{
+			// move everything up (as the center moves down)
+			for (int x = 0; x < width; x++)
+			{
+				for (int z = 0; z < width; z++)
+				{
+					if (z + zOffset < width)
+						regions[x][z] = regions[x][z + zOffset];
+					else
+						regions[x][z] = null;
+				}
+			}
+		}
+		else
+		{
+			// move everything down (as the center moves up)
+			for (int x = 0; x < width; x++)
+			{
+				for (int z = width - 1; z >= 0; z--)
+				{
+					if (z + zOffset >= 0)
+						regions[x][z] = regions[x][z + zOffset];
+					else
+						regions[x][z] = null;
+				}
+			}
+		}
+		
+		
+		// update the new center
+		center.x += xOffset;
+		center.z += zOffset;
+	}
+	
+	
+	/**
+	 * return the minimum needed memory in bytes
+	 */
+	public int getMinMemoryNeeded()
+	{
+		int count = 0;
+		LodRegion region;
+		
+		for (int x = 0; x < regions.length; x++)
+		{
+			for (int z = 0; z < regions.length; z++)
+			{
+				region = regions[x][z];
+				if (region != null)
+					count += region.getMinMemoryNeeded(LodConfig.CLIENT.graphics.lodTemplate.get());
+			}
+		}
+		return count;
+	}
+	
+	
+	/**
+	 * Gets the region at the given LevelPos
+	 * <br>
+	 * Returns null if the region doesn't exist
+	 * or is outside the loaded area.
+	 */
+	public LodRegion getRegion(byte detailLevel, int levelPosX, int levelPosZ)
+	{
+		int xRegion = LevelPosUtil.getRegion(detailLevel, levelPosX);
+		int zRegion = LevelPosUtil.getRegion(detailLevel, levelPosZ);
+		int xIndex = (xRegion - center.x) + halfWidth;
+		int zIndex = (zRegion - center.z) + halfWidth;
+		
+		if (!regionIsInRange(xRegion, zRegion))
+			return null;
+			// throw new ArrayIndexOutOfBoundsException("Region for level pos " + LevelPosUtil.toString(detailLevel, posX, posZ) + " out of range");
+		else if (regions[xIndex][zIndex] == null)
+			return null;
+		else if (regions[xIndex][zIndex].getMinDetailLevel() > detailLevel)
+			return null;
+		//throw new InvalidParameterException("Region for level pos " + LevelPosUtil.toString(detailLevel, posX, posZ) + " currently only reach level " + regions[xIndex][zIndex].getMinDetailLevel());
+		
+		return regions[xIndex][zIndex];
+	}
+	
+	/**
+	 * Gets the region at the given X and Z
+	 * <br>
+	 * Returns null if the region doesn't exist
+	 * or is outside the loaded area.
+	 */
+	public LodRegion getRegion(int regionPosX, int regionPosZ)
+	{
+		int xIndex = (regionPosX - center.x) + halfWidth;
+		int zIndex = (regionPosZ - center.z) + halfWidth;
+		
+		if (!regionIsInRange(regionPosX, regionPosZ))
+			return null;
+		//throw new ArrayIndexOutOfBoundsException("Region " + regionPosX + " " + regionPosZ + " out of range");
+		
+		return regions[xIndex][zIndex];
+	}
+	
+	/** Useful when iterating over every region. */
+	public LodRegion getRegionByArrayIndex(int xIndex, int zIndex)
+	{
+		return regions[xIndex][zIndex];
+	}
+	
+	/**
+	 * Overwrite the LodRegion at the location of newRegion with newRegion.
+	 *
+	 * @throws ArrayIndexOutOfBoundsException if newRegion is outside what can be stored in this LodDimension.
+	 */
+	public synchronized void addOrOverwriteRegion(LodRegion newRegion) throws ArrayIndexOutOfBoundsException
+	{
+		int xIndex = (newRegion.regionPosX - center.x) + halfWidth;
+		int zIndex = (newRegion.regionPosZ - center.z) + halfWidth;
+		
+		if (!regionIsInRange(newRegion.regionPosX, newRegion.regionPosZ))
+			// out of range
+			throw new ArrayIndexOutOfBoundsException("Region " + newRegion.regionPosX + ", " + newRegion.regionPosZ + " out of range");
+		
+		regions[xIndex][zIndex] = newRegion;
+	}
+	
+	
+	/**
+	 * Deletes nodes that are a higher detail then necessary, freeing
+	 * up memory.
+	 */
+	public void cutRegionNodesAsync(int playerPosX, int playerPosZ)
+	{
+		ChunkPos newPlayerChunk = new ChunkPos(LevelPosUtil.getChunkPos((byte) 0, playerPosX), LevelPosUtil.getChunkPos((byte) 0, playerPosZ));
+		
+		if (lastCutChunk == null)
+			lastCutChunk = new ChunkPos(newPlayerChunk.x + 1, newPlayerChunk.z - 1);
+		
+		// don't run the tree cutter multiple times
+		// for the same location
+		if (newPlayerChunk.x != lastCutChunk.x || newPlayerChunk.z != lastCutChunk.z)
+		{
+			lastCutChunk = newPlayerChunk;
+			
+			Thread thread = new Thread(() ->
+			{
+				int regionX;
+				int regionZ;
+				int minDistance;
+				byte detail;
+				byte minAllowedDetailLevel;
+				
+				// go over every region in the dimension
+				for (int x = 0; x < regions.length; x++)
+				{
+					for (int z = 0; z < regions.length; z++)
+					{
+						regionX = (x + center.x) - halfWidth;
+						regionZ = (z + center.z) - halfWidth;
+						
+						if (regions[x][z] != null)
+						{
+							// check what detail level this region should be
+							// and cut it if it is higher then that
+							minDistance = LevelPosUtil.minDistance(LodUtil.REGION_DETAIL_LEVEL, regionX, regionZ, playerPosX, playerPosZ);
+							detail = DetailDistanceUtil.getTreeCutDetailFromDistance(minDistance);
+							minAllowedDetailLevel = DetailDistanceUtil.getCutLodDetail(detail);
+							
+							if (regions[x][z].getMinDetailLevel() > minAllowedDetailLevel)
+							{
+								regions[x][z].cutTree(minAllowedDetailLevel);
+								recreateRegionBuffer[x][z] = true;
+							}
+						}
+					}// region z
+				}// region z
+			});
+			
+			cutAndExpandThread.execute(thread);
+		}
+	}
+	
+	/** Either expands or loads all regions in the rendered LOD area */
+	public void expandOrLoadRegionsAsync(int playerPosX, int playerPosZ)
+	{
+		DistanceGenerationMode generationMode = LodConfig.CLIENT.worldGenerator.distanceGenerationMode.get();
+		ChunkPos newPlayerChunk = new ChunkPos(LevelPosUtil.getChunkPos((byte) 0, playerPosX), LevelPosUtil.getChunkPos((byte) 0, playerPosZ));
+		VerticalQuality verticalQuality = LodConfig.CLIENT.worldGenerator.lodQualityMode.get();
+		
+		
+		if (lastExpandedChunk == null)
+			lastExpandedChunk = new ChunkPos(newPlayerChunk.x + 1, newPlayerChunk.z - 1);
+		
+		// don't run the expander multiple times
+		// for the same location
+		if (newPlayerChunk.x != lastExpandedChunk.x || newPlayerChunk.z != lastExpandedChunk.z)
+		{
+			lastExpandedChunk = newPlayerChunk;
+			
+			Thread thread = new Thread(() ->
+			{
+				int regionX;
+				int regionZ;
+				LodRegion region;
+				int minDistance;
+				byte detail;
+				byte levelToGen;
+				
+				for (int x = 0; x < regions.length; x++)
+				{
+					for (int z = 0; z < regions.length; z++)
+					{
+						regionX = (x + center.x) - halfWidth;
+						regionZ = (z + center.z) - halfWidth;
+						final RegionPos regionPos = new RegionPos(regionX, regionZ);
+						region = regions[x][z];
+						
+						minDistance = LevelPosUtil.minDistance(LodUtil.REGION_DETAIL_LEVEL, regionX, regionZ, playerPosX, playerPosZ);
+						detail = DetailDistanceUtil.getTreeGenDetailFromDistance(minDistance);
+						levelToGen = DetailDistanceUtil.getLodGenDetail(detail).detailLevel;
+						
+						// check that the region isn't null and at least this detail level
+						if (region == null || region.getGenerationMode() != generationMode)
+						{
+							// First case, region has to be created
+							
+							// try to get the region from file
+							regions[x][z] = getRegionFromFile(regionPos, levelToGen, generationMode, verticalQuality);
+							
+							// if there is no region file create a empty region
+							if (regions[x][z] == null)
+								regions[x][z] = new LodRegion(levelToGen, regionPos, generationMode, verticalQuality);
+							
+							regenRegionBuffer[x][z] = true;
+							regenDimensionBuffers = true;
+							recreateRegionBuffer[x][z] = true;
+						}
+						else if (region.getMinDetailLevel() > levelToGen)
+						{
+							// Second case, the region exists at a higher detail level.
+							
+							// Expand the region by introducing the missing layer
+							region.growTree(levelToGen);
+							recreateRegionBuffer[x][z] = true;
+						}
+					}
+				}
+			});
+			
+			cutAndExpandThread.execute(thread);
+		}
+	}
+	
+	/**
+	 * Add the given LOD to this dimension at the coordinate
+	 * stored in the LOD. If an LOD already exists at the given
+	 * coordinate it will be overwritten.
+	 */
+	public Boolean addData(byte detailLevel, int posX, int posZ, int verticalIndex, long data, boolean dontSave)
+	{
+		int regionPosX = LevelPosUtil.getRegion(detailLevel, posX);
+		int regionPosZ = LevelPosUtil.getRegion(detailLevel, posZ);
+		
+		// don't continue if the region can't be saved
+		LodRegion region = getRegion(regionPosX, regionPosZ);
+		if (region == null)
+			return false;
+		
+		boolean nodeAdded = region.addData(detailLevel, posX, posZ, verticalIndex, data);
+		
+		// only save valid LODs to disk
+		if (!dontSave && fileHandler != null)
+		{
+			try
+			{
+				// mark the region as dirty so it will be saved to disk
+				int xIndex = (regionPosX - center.x) + halfWidth;
+				int zIndex = (regionPosZ - center.z) + halfWidth;
+				
+				isRegionDirty[xIndex][zIndex] = true;
+				regenRegionBuffer[xIndex][zIndex] = true;
+				regenDimensionBuffers = true;
+			}
+			catch (ArrayIndexOutOfBoundsException e)
+			{
+				e.printStackTrace();
+				// If this happens, the method was probably 
+				// called when the dimension was changing size.
+				// Hopefully this shouldn't be an issue.
+			}
+		}
+		
+		return nodeAdded;
+	}
+	
+	/** marks the region at the given region position to have its buffer rebuilt */
+	public void markRegionBufferToRegen(int xRegion, int zRegion)
+	{
+		int xIndex = (xRegion - center.x) + halfWidth;
+		int zIndex = (zRegion - center.z) + halfWidth;
+		regenRegionBuffer[xIndex][zIndex] = true;
+	}
+	
+	/**
+	 * Returns every position that need to be generated based on the position of the player
+	 */
+	public PosToGenerateContainer getDataToGenerate(int maxDataToGenerate, int playerBlockPosX, int playerBlockPosZ)
+	{
+		PosToGenerateContainer posToGenerate;
+		LodRegion region;
+		// TODO what are dx, dz, and t?
+		int x, z, dx, dz, t;
+		x = 0;
+		z = 0;
+		dx = 0;
+		dz = -1;
+		
+		// TODO please comment what this code is doing
+		switch (LodConfig.CLIENT.worldGenerator.generationPriority.get())
+		{
+		default:
+		case NEAR_FIRST:
+			posToGenerate = new PosToGenerateContainer((byte) 10, maxDataToGenerate, playerBlockPosX, playerBlockPosZ);
+			
+			int playerChunkX = LevelPosUtil.getChunkPos(LodUtil.BLOCK_DETAIL_LEVEL, playerBlockPosX);
+			int playerChunkZ = LevelPosUtil.getChunkPos(LodUtil.BLOCK_DETAIL_LEVEL, playerBlockPosZ);
+			
+			int xChunkToCheck;
+			int zChunkToCheck;
+			byte detailLevel;
+			int posX;
+			int posZ;
+			long data;
+			int numbChunksWide = (width) * 32;
+			int circleLimit = Integer.MAX_VALUE;
+			
+			for (int i = 0; i < numbChunksWide * numbChunksWide; i++)
+			{
+				// use this for circular generation
+				if (maxDataToGenerate < 0)
+				{
+					if (circleLimit < Math.abs(x) && circleLimit < Math.abs(z))
+						break;
+				}
+				else if (maxDataToGenerate == 0)
+				{
+					maxDataToGenerate--;
+					circleLimit = (int) (Math.abs(x) * 1.41f);
+				}
+				
+				xChunkToCheck = x + playerChunkX;
+				zChunkToCheck = z + playerChunkZ;
+				
+				region = getRegion(LodUtil.CHUNK_DETAIL_LEVEL, xChunkToCheck, zChunkToCheck);
+				if (region == null)
+					continue;
+				
+				detailLevel = region.getMinDetailLevel();
+				
+				posX = LevelPosUtil.convert(LodUtil.CHUNK_DETAIL_LEVEL, xChunkToCheck, detailLevel);
+				posZ = LevelPosUtil.convert(LodUtil.CHUNK_DETAIL_LEVEL, zChunkToCheck, detailLevel);
+				data = getSingleData(detailLevel, posX, posZ);
+				
+				if (DataPointUtil.getGenerationMode(data) < LodConfig.CLIENT.worldGenerator.distanceGenerationMode.get().complexity)
+				{
+					posToGenerate.addPosToGenerate(detailLevel, posX, posZ);
+					if (maxDataToGenerate >= 0)
+						maxDataToGenerate--;
+				}
+				
+				if ((x == z) || ((x < 0) && (x == -z)) || ((x > 0) && (x == 1 - z)))
+				{
+					t = dx;
+					dx = -dz;
+					dz = t;
+				}
+				x += dx;
+				z += dz;
+			}
+			break;
+			
+			
+		case FAR_FIRST:
+			posToGenerate = new PosToGenerateContainer((byte) 8, maxDataToGenerate, playerBlockPosX, playerBlockPosZ);
+			
+			int xRegion;
+			int zRegion;
+			
+			for (int i = 0; i < width * width; i++)
+			{
+				xRegion = x + center.x;
+				zRegion = z + center.z;
+				
+				region = getRegion(xRegion, zRegion);
+				if (region != null)
+					region.getDataToGenerate(posToGenerate, playerBlockPosX, playerBlockPosZ);
+				
+				
+				if ((x == z) || ((x < 0) && (x == -z)) || ((x > 0) && (x == 1 - z)))
+				{
+					t = dx;
+					dx = -dz;
+					dz = t;
+				}
+				x += dx;
+				z += dz;
+			}
+			break;
+		}
+		return posToGenerate;
+	}
+	
+	/**
+	 * Returns every node that should be rendered based on the position of the player.
+	 * 
+	 * TODO why isn't posToRender returned? it would make it a bit more clear what is happening
+	 */
+	public void getDataToRender(PosToRenderContainer posToRender, RegionPos regionPos, int playerPosX,
+			int playerPosZ)
+	{
+		LodRegion region = getRegion(regionPos.x, regionPos.z);
+		if (region != null)
+			region.getDataToRender(posToRender, playerPosX, playerPosZ, LodConfig.CLIENT.worldGenerator.generationPriority.get() == GenerationPriority.NEAR_FIRST);
+	}
+	
+	/**
+	 * Determines how many vertical LODs could be used 
+	 * for the given region at the given detail level
+	 */
+	public int getMaxVerticalData(byte detailLevel, int posX, int posZ)
+	{
+		if (detailLevel > LodUtil.REGION_DETAIL_LEVEL)
+			throw new IllegalArgumentException("getMaxVerticalData given a level of [" + detailLevel + "] when [" + LodUtil.REGION_DETAIL_LEVEL + "] is the max.");
+		
+		LodRegion region = getRegion(detailLevel, posX, posZ);
+		if (region == null)
+			return 0;
+		
+		return region.getMaxVerticalData(detailLevel);
+	}
+	
+	/**
+	 * Get the data point at the given X and Z coordinates
+	 * in this dimension.
+	 * <br>
+	 * Returns null if the LodChunk doesn't exist or
+	 * is outside the loaded area.
+	 */
+	public long getData(byte detailLevel, int posX, int posZ, int verticalIndex)
+	{
+		if (detailLevel > LodUtil.REGION_DETAIL_LEVEL)
+			throw new IllegalArgumentException("getLodFromCoordinates given a level of \"" + detailLevel + "\" when \"" + LodUtil.REGION_DETAIL_LEVEL + "\" is the max.");
+		
+		LodRegion region = getRegion(detailLevel, posX, posZ);
+		if (region == null)
+			return DataPointUtil.EMPTY_DATA;
+		
+		return region.getData(detailLevel, posX, posZ, verticalIndex);
+	}
+	
+	
+	/**
+	 * Get the data point at the given X and Z coordinates
+	 * in this dimension.
+	 * <br>
+	 * Returns null if the LodChunk doesn't exist or
+	 * is outside the loaded area.
+	 */
+	public long getSingleData(byte detailLevel, int posX, int posZ)
+	{
+		if (detailLevel > LodUtil.REGION_DETAIL_LEVEL)
+			throw new IllegalArgumentException("getLodFromCoordinates given a level of \"" + detailLevel + "\" when \"" + LodUtil.REGION_DETAIL_LEVEL + "\" is the max.");
+		
+		LodRegion region = getRegion(detailLevel, posX, posZ);
+		if (region == null)
+			return DataPointUtil.EMPTY_DATA;
+		
+		return region.getSingleData(detailLevel, posX, posZ);
+	}
+	
+	/** Clears the given region */
+	public void clear(byte detailLevel, int posX, int posZ)
+	{
+		if (detailLevel > LodUtil.REGION_DETAIL_LEVEL)
+			throw new IllegalArgumentException("getLodFromCoordinates given a level of \"" + detailLevel + "\" when \"" + LodUtil.REGION_DETAIL_LEVEL + "\" is the max.");
+		
+		LodRegion region = getRegion(detailLevel, posX, posZ);
+		if (region == null)
+			return;
+		
+		region.clear(detailLevel, posX, posZ);
+	}
+	
+	/**
+	 * Returns if the buffer at the given array index needs
+	 * to have its buffer regenerated.
+	 */
+	public boolean doesRegionNeedBufferRegen(int xIndex, int zIndex)
+	{
+		return regenRegionBuffer[xIndex][zIndex];
+	}
+	
+	/**
+	 * TODO we aren't currently using this, is there a reason for that?
+	 * is this significantly different than regenRegionBuffer?
+	 * 
+	 * Returns if the buffer at the given array index needs
+	 * to have its buffer resized.
+	 */
+	public boolean doesRegionNeedBufferResized(int xIndex, int zIndex)
+	{
+		return recreateRegionBuffer[xIndex][zIndex];
+	}
+	
+	/**
+	 * Sets if the buffer at the given array index needs
+	 * to have its buffer regenerated.
+	 */
+	public void setRegenRegionBufferByArrayIndex(int xIndex, int zIndex, boolean newRegen)
+	{
+		regenRegionBuffer[xIndex][zIndex] = newRegen;
+	}
+	
+	/**
+	 * Get the data point at the given LevelPos
+	 * in this dimension.
+	 * <br>
+	 * Returns null if the LodChunk doesn't exist or
+	 * is outside the loaded area.
+	 */
+	public void updateData(byte detailLevel, int posX, int posZ)
+	{
+		if (detailLevel > LodUtil.REGION_DETAIL_LEVEL)
+			throw new IllegalArgumentException("getLodFromCoordinates given a level of \"" + detailLevel + "\" when \"" + LodUtil.REGION_DETAIL_LEVEL + "\" is the max.");
+		
+		LodRegion region = getRegion(detailLevel, posX, posZ);
+		if (region == null)
+			return;
+		
+		region.updateArea(detailLevel, posX, posZ);
+	}
+	
+	/**
+	 * Returns true if a region exists at the given LevelPos
+	 */
+	public boolean doesDataExist(byte detailLevel, int posX, int posZ)
+	{
+		LodRegion region = getRegion(detailLevel, posX, posZ);
+		if (region == null)
+			return false;
+		
+		return region.doesDataExist(detailLevel, posX, posZ);
+	}
+	
+	/**
+	 * Loads the region at the given RegionPos from file,
+	 * if a file exists for that region.
+	 */
+	public LodRegion getRegionFromFile(RegionPos regionPos, byte detailLevel, 
+			DistanceGenerationMode generationMode, VerticalQuality verticalQuality)
+	{
+		if (fileHandler != null)
+			return fileHandler.loadRegionFromFile(detailLevel, regionPos, generationMode, verticalQuality);
+		else
+			return null;
+	}
+	
+	/**
+	 * Save all dirty regions in this LodDimension to file.
+	 */
+	public void saveDirtyRegionsToFileAsync()
+	{
+		fileHandler.saveDirtyRegionsToFileAsync();
+	}
+	
+	
+	/**
+	 * Returns whether the region at the given RegionPos
+	 * is within the loaded range.
+	 */
+	public boolean regionIsInRange(int regionX, int regionZ)
+	{
+		int xIndex = (regionX - center.x) + halfWidth;
+		int zIndex = (regionZ - center.z) + halfWidth;
+		
+		return xIndex >= 0 && xIndex < width && zIndex >= 0 && zIndex < width;
+	}
+	
+	/** Returns the dimension's center region position X value */
+	public int getCenterRegionPosX()
+	{
+		return center.x;
+	}
+	
+	/** Returns the dimension's center region position Z value */
+	public int getCenterRegionPosZ()
+	{
+		return center.z;
+	}
+	
+	/**
+	 * returns the width of the dimension in regions
+	 */
+	public int getWidth()
+	{
+		if (regions != null)
+		{
+			// we want to get the length directly from the
+			// source to make sure it is in sync with region
+			// and isRegionDirty
+			return regions.length;
+		}
+		else
+		{
+			return width;
+		}
+	}
+	
+	/** Update the width of this dimension, in regions */
+	public void setRegionWidth(int newWidth)
+	{
+		width = newWidth;
+		halfWidth = Math.floorDiv(width, 2);
+		
+		regions = new LodRegion[width][width];
+		isRegionDirty = new boolean[width][width];
+		regenRegionBuffer = new boolean[width][width];
+		recreateRegionBuffer = new boolean[width][width];
+		
+		// populate isRegionDirty
+		for (int i = 0; i < width; i++)
+			for (int j = 0; j < width; j++)
+				isRegionDirty[i][j] = false;
+	}
+	
+	
+	@Override
+	public String toString()
+	{
+		LodRegion region;
+		
+		StringBuilder stringBuilder = new StringBuilder();
+		stringBuilder.append("Dimension : \n");
+		for (int x = 0; x < regions.length; x++)
+		{
+			for (int z = 0; z < regions.length; z++)
+			{
+				region = regions[x][z];
+				if (region == null)
+				{
+					stringBuilder.append("n");
+					stringBuilder.append("\t");
+					
+				}
+				else
+				{
+					stringBuilder.append(region.getMinDetailLevel());
+					stringBuilder.append("\t");
+				}
+			}
+			stringBuilder.append("\n");
+		}
+		return stringBuilder.toString();
+	}
+	
+	/** Returns the minimum memory required by the dimension in Bytes */
+	public int getMemoryRequired(int x, int z, LodTemplate template)
+	{
+		/*return regions[x][z].getMinMemoryNeeded(template);*/
+		
+		/*TODO add memory use calculated with the following cases
+		switch (LodConfig.CLIENT.graphics.detailDropOff.get())
+		{
+			default:
+			case BY_BLOCK:
+				break;
+			case BY_REGION_FANCY:
+				break;
+			case BY_REGION_FAST:
+		}*/
+		/*return regions[x][z].getMinMemoryNeeded(template);*/
+
+		/*TODO add memory use calculated with the following cases
+		switch (LodConfig.CLIENT.graphics.detailDropOff.get())
+		{
+			default:
+			case BY_BLOCK:
+				break;
+			case BY_REGION_FANCY:
+				break;
+			case BY_REGION_FAST:
+		}*/
+		int minDistance = LevelPosUtil.minDistance(LodUtil.REGION_DETAIL_LEVEL, x, z, halfWidth, halfWidth);
+		int detail = DetailDistanceUtil.getTreeCutDetailFromDistance(minDistance);
+		int levelToGen = DetailDistanceUtil.getLodDrawDetail(detail);
+		int size = 1 << (LodUtil.REGION_DETAIL_LEVEL - levelToGen);
+		int maxVerticalData = DetailDistanceUtil.getMaxVerticalData(detail);
+		int memoryUse = LodUtil.regionRenderingMemoryUse(x,z,template);
+		System.out.println(detail + " " + memoryUse + " " + template.getBufferMemoryForSingleLod(maxVerticalData));
+		return memoryUse;
+		//return memoryUse;
+	}
+}
@@ -0,0 +1,574 @@
+package com.seibel.lod.objects;
+
+
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.enums.LodTemplate;
+import com.seibel.lod.enums.VerticalQuality;
+import com.seibel.lod.util.DataPointUtil;
+import com.seibel.lod.util.DetailDistanceUtil;
+import com.seibel.lod.util.LevelPosUtil;
+import com.seibel.lod.util.LodUtil;
+
+/**
+ * This object holds all loaded LevelContainers
+ * for a given region. <Br><Br>
+ *
+ * <strong>Coordinate Standard: </strong><br>
+ * Coordinate called posX or posZ are relative LevelPos coordinates <br>
+ * unless stated otherwise. <br>
+ *
+ * @author Leonardo Amato
+ * @version 9-27-2021
+ */
+public class LodRegion
+{
+	/**
+	 * TODO what does this represent, and should it be defined here?
+	 */
+	private static final byte POSSIBLE_LOD = 10;
+
+
+	/**
+	 * Holds the lowest (least detailed) detail level in this region
+	 * TODO is that correct?
+	 */
+	private byte minDetailLevel;
+
+	/**
+	 * This holds all data for this region
+	 */
+	private LevelContainer[] dataContainer;
+
+	/**
+	 * the generation mode for this region
+	 * TODO will this ever change through a region's life?
+	 */
+	private DistanceGenerationMode generationMode;
+	/**
+	 * the vertical quality of this region
+	 */
+	private VerticalQuality verticalQuality;
+
+	/**
+	 * this region's x RegionPos
+	 */
+	public final int regionPosX;
+	/**
+	 * this region's z RegionPos
+	 */
+	public final int regionPosZ;
+
+
+	public LodRegion(RegionPos regionPos)
+	{
+		this.minDetailLevel = LodUtil.REGION_DETAIL_LEVEL;
+		this.regionPosX = regionPos.x;
+		this.regionPosZ = regionPos.z;
+		dataContainer = new LevelContainer[POSSIBLE_LOD];
+	}
+
+	public LodRegion(byte minDetailLevel, RegionPos regionPos, DistanceGenerationMode generationMode, VerticalQuality verticalQuality)
+	{
+		this.minDetailLevel = minDetailLevel;
+		this.regionPosX = regionPos.x;
+		this.regionPosZ = regionPos.z;
+		this.verticalQuality = verticalQuality;
+		this.generationMode = generationMode;
+		dataContainer = new LevelContainer[POSSIBLE_LOD];
+
+
+		// Initialize all the different matrices
+		for (byte lod = minDetailLevel; lod <= LodUtil.REGION_DETAIL_LEVEL; lod++)
+		{
+			switch (verticalQuality)
+			{
+				default:
+				case HEIGHTMAP:
+					dataContainer[lod] = new SingleLevelContainer(lod);
+					break;
+				case VOXEL:
+					dataContainer[lod] = new VerticalLevelContainer(lod);
+					break;
+			}
+		}
+	}
+
+
+	/**
+	 * Inserts the data point into the region.
+	 * <p>
+	 * TODO this will always return true unless it has
+	 *
+	 * @return true if the data was added successfully
+	 */
+	public boolean addData(byte detailLevel, int posX, int posZ, int verticalIndex, long data)
+	{
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+
+		// The dataContainer could have null entries if the
+		// detailLevel changes.
+		if (this.dataContainer[detailLevel] == null)
+		{
+			if (verticalQuality == VerticalQuality.HEIGHTMAP)
+				this.dataContainer[detailLevel] = new SingleLevelContainer(detailLevel);
+			else
+				this.dataContainer[detailLevel] = new VerticalLevelContainer(detailLevel);
+		}
+
+		this.dataContainer[detailLevel].addData(data, posX, posZ, verticalIndex);
+
+		return true;
+	}
+
+	/**
+	 * Get the dataPoint at the given relative position.
+	 *
+	 * @return the data at the relative pos and detail level,
+	 * 0 if the data doesn't exist.
+	 */
+	public long getData(byte detailLevel, int posX, int posZ, int verticalIndex)
+	{
+		return dataContainer[detailLevel].getData(posX, posZ, verticalIndex);
+	}
+
+	/**
+	 * Get the dataPoint at the given relative position.
+	 *
+	 * @return the data at the relative pos and detail level,
+	 * 0 if the data doesn't exist.
+	 */
+	public long getSingleData(byte detailLevel, int posX, int posZ)
+	{
+		return dataContainer[detailLevel].getSingleData(posX, posZ);
+	}
+
+	/**
+	 * Clears the datapoint at the given relative position
+	 */
+	public void clear(byte detailLevel, int posX, int posZ)
+	{
+		dataContainer[detailLevel].clear(posX, posZ);
+	}
+
+	/**
+	 * This method will fill the posToGenerate array with all levelPos that
+	 * are render-able.
+	 * <p>
+	 * TODO why don't we return the posToGenerate, it would make this easier to understand
+	 */
+	public void getDataToGenerate(PosToGenerateContainer posToGenerate,
+	                              int playerBlockPosX, int playerBlockPosZ)
+	{
+		getDataToGenerate(posToGenerate, LodUtil.REGION_DETAIL_LEVEL, 0, 0, playerBlockPosX, playerBlockPosZ);
+
+	}
+
+	/**
+	 * A recursive method that fills the posToGenerate array with all levelPos that
+	 * need to be generated.
+	 * <p>
+	 * TODO why don't we return the posToGenerate, it would make this easier to understand
+	 */
+	private void getDataToGenerate(PosToGenerateContainer posToGenerate, byte detailLevel,
+	                               int childOffsetPosX, int childOffsetPosZ, int playerPosX, int playerPosZ)
+	{
+		// equivalent to 2^(...)
+		int size = 1 << (LodUtil.REGION_DETAIL_LEVEL - detailLevel);
+
+		// calculate what LevelPos are in range to generate
+		int maxDistance = LevelPosUtil.maxDistance(detailLevel, childOffsetPosX, childOffsetPosZ, playerPosX, playerPosZ, regionPosX, regionPosZ);
+
+		// determine this child's levelPos
+		byte childDetailLevel = (byte) (detailLevel - 1);
+		int childPosX = childOffsetPosX * 2;
+		int childPosZ = childOffsetPosZ * 2;
+
+		int childSize = 1 << (LodUtil.REGION_DETAIL_LEVEL - childDetailLevel);
+
+		byte targetDetailLevel = DetailDistanceUtil.getLodGenDetail(DetailDistanceUtil.getGenerationDetailFromDistance(maxDistance)).detailLevel;
+		if (targetDetailLevel > detailLevel)
+		{
+			// we have gone beyond the target Detail level
+			// we can stop generating
+			return;
+		} else if (targetDetailLevel == detailLevel)
+		{
+			if (!doesDataExist(detailLevel, childOffsetPosX, childOffsetPosZ))
+				posToGenerate.addPosToGenerate(detailLevel, childOffsetPosX + regionPosX * size, childOffsetPosZ + regionPosZ * size);
+		} else
+		{
+			// we want at max one request per chunk (since the world generator creates chunks).
+			// So for lod smaller than a chunk, only recurse down
+			// the top right child
+
+			if (detailLevel > LodUtil.CHUNK_DETAIL_LEVEL)
+			{
+				int ungeneratedChildren = 0;
+
+				// make sure all children are generated to this detailLevel
+				for (int x = 0; x <= 1; x++)
+				{
+					for (int z = 0; z <= 1; z++)
+					{
+						if (!doesDataExist(childDetailLevel, childPosX + x, childPosZ + z))
+						{
+							ungeneratedChildren++;
+							posToGenerate.addPosToGenerate(childDetailLevel, childPosX + x + regionPosX * childSize, childPosZ + z + regionPosZ * childSize);
+						}
+					}
+				}
+
+				// only if all the children are correctly generated 
+				// should we go deeper
+				if (ungeneratedChildren == 0)
+					for (int x = 0; x <= 1; x++)
+						for (int z = 0; z <= 1; z++)
+							getDataToGenerate(posToGenerate, childDetailLevel, childPosX + x, childPosZ + z, playerPosX, playerPosZ);
+			} else
+			{
+				// The detail Level is smaller than a chunk.
+				// Only recurse down the top right child.
+
+				if (DetailDistanceUtil.getLodGenDetail(childDetailLevel).detailLevel <= (childDetailLevel))
+				{
+					if (!doesDataExist(childDetailLevel, childPosX, childPosZ))
+						posToGenerate.addPosToGenerate(childDetailLevel, childPosX + regionPosX * childSize, childPosZ + regionPosZ * childSize);
+					else
+						getDataToGenerate(posToGenerate, childDetailLevel, childPosX, childPosZ, playerPosX, playerPosZ);
+				}
+			}
+		}
+	}
+
+
+	/**
+	 * This method will fill the posToRender array with all levelPos that
+	 * are render-able.
+	 * <p>
+	 * TODO why don't we return the posToRender, it would make this easier to understand
+	 */
+	public void getDataToRender(PosToRenderContainer posToRender,
+	                            int playerPosX, int playerPosZ, boolean requireCorrectDetailLevel)
+	{
+		getDataToRender(posToRender, LodUtil.REGION_DETAIL_LEVEL, 0, 0, playerPosX, playerPosZ, requireCorrectDetailLevel);
+	}
+
+	/**
+	 * This method will fill the posToRender array with all levelPos that
+	 * are render-able.
+	 * <p>
+	 * TODO why don't we return the posToRender, it would make this easier to understand
+	 * TODO this needs some more comments, James was only able to figure out part of it
+	 */
+	private void getDataToRender(PosToRenderContainer posToRender,
+	                             byte detailLevel, int posX, int posZ,
+	                             int playerPosX, int playerPosZ, boolean requireCorrectDetailLevel)
+	{
+		// equivalent to 2^(...)
+		int size = 1 << (LodUtil.REGION_DETAIL_LEVEL - detailLevel);
+
+		byte desiredLevel;
+		int maxDistance;
+		boolean stopNow = false;
+		int minDistance;
+		int childLevel;
+
+
+		// calculate the LevelPos that are in range
+		switch (LodConfig.CLIENT.graphics.detailDropOff.get())
+		{
+
+			case FAST:
+				int playerRegionX = LevelPosUtil.getRegion(LodUtil.BLOCK_DETAIL_LEVEL, playerPosX);
+				int playerRegionZ = LevelPosUtil.getRegion(LodUtil.BLOCK_DETAIL_LEVEL, playerPosZ);
+				if (playerRegionX == regionPosX && playerRegionZ == regionPosZ)
+				{
+					maxDistance = LevelPosUtil.maxDistance(detailLevel, posX, posZ, playerPosX, playerPosZ, regionPosX, regionPosZ);
+					desiredLevel = DetailDistanceUtil.getLodDrawDetail(DetailDistanceUtil.getDrawDetailFromDistance(maxDistance));
+					minDistance = LevelPosUtil.minDistance(detailLevel, posX, posZ, playerPosX, playerPosZ, regionPosX, regionPosZ);
+					childLevel = DetailDistanceUtil.getLodDrawDetail(DetailDistanceUtil.getDrawDetailFromDistance(minDistance));
+					stopNow = detailLevel == childLevel - 1;
+					break;
+				}
+			default:
+			case FANCY:
+				maxDistance = LevelPosUtil.maxDistance(detailLevel, posX, posZ, playerPosX, playerPosZ, regionPosX, regionPosZ);
+				desiredLevel = DetailDistanceUtil.getLodDrawDetail(DetailDistanceUtil.getDrawDetailFromDistance(maxDistance));
+				minDistance = LevelPosUtil.minDistance(detailLevel, posX, posZ, playerPosX, playerPosZ, regionPosX, regionPosZ);
+				childLevel = DetailDistanceUtil.getLodDrawDetail(DetailDistanceUtil.getDrawDetailFromDistance(minDistance));
+				stopNow = detailLevel == childLevel - 1;
+				break;
+		}
+
+		if (stopNow)
+		{
+			posToRender.addPosToRender(detailLevel,
+					posX + regionPosX * size,
+					posZ + regionPosZ * size);
+		} else if (desiredLevel > detailLevel)
+		{
+			// we have gone beyond the target Detail level
+			// we can stop generating
+			return;
+		} else if (desiredLevel == detailLevel)
+		{
+			posToRender.addPosToRender(detailLevel,
+					posX + regionPosX * size,
+					posZ + regionPosZ * size);
+		} else //case where (detailLevel > desiredLevel)
+		{
+			int childPosX = posX * 2;
+			int childPosZ = posZ * 2;
+			byte childDetailLevel = (byte) (detailLevel - 1);
+			int childrenCount = 0;
+
+			for (int x = 0; x <= 1; x++)
+			{
+				for (int z = 0; z <= 1; z++)
+				{
+					if (doesDataExist(childDetailLevel, childPosX + x, childPosZ + z))
+					{
+						if (!requireCorrectDetailLevel)
+							childrenCount++;
+						else
+							getDataToRender(posToRender, childDetailLevel, childPosX + x, childPosZ + z, playerPosX, playerPosZ, requireCorrectDetailLevel);
+					}
+				}
+			}
+
+
+			if (!requireCorrectDetailLevel)
+			{
+				// If all the four children exist go deeper
+				if (childrenCount == 4)
+				{
+					for (int x = 0; x <= 1; x++)
+						for (int z = 0; z <= 1; z++)
+							getDataToRender(posToRender, childDetailLevel, childPosX + x, childPosZ + z, playerPosX, playerPosZ, requireCorrectDetailLevel);
+				} else
+				{
+					posToRender.addPosToRender(detailLevel,
+							posX + regionPosX * size,
+							posZ + regionPosZ * size);
+				}
+			}
+		}
+	}
+
+
+	/**
+	 * Updates all children.
+	 * <p>
+	 * TODO could this be renamed mergeArea?
+	 */
+	public void updateArea(byte detailLevel, int posX, int posZ)
+	{
+		int width;
+		int startX;
+		int startZ;
+
+		// TODO what are each of these loops updating?
+		for (byte down = (byte) (minDetailLevel + 1); down <= detailLevel; down++)
+		{
+			startX = LevelPosUtil.convert(detailLevel, posX, down);
+			startZ = LevelPosUtil.convert(detailLevel, posZ, down);
+			width = 1 << (detailLevel - down);
+
+			for (int x = 0; x < width; x++)
+				for (int z = 0; z < width; z++)
+					update(down, startX + x, startZ + z);
+		}
+
+
+		for (byte up = (byte) (detailLevel + 1); up <= LodUtil.REGION_DETAIL_LEVEL; up++)
+		{
+			update(up,
+					LevelPosUtil.convert(detailLevel, posX, up),
+					LevelPosUtil.convert(detailLevel, posZ, up));
+		}
+	}
+
+	/**
+	 * Update the child at the given relative Pos
+	 * <p>
+	 * TODO could this be renamed mergeChildData?
+	 */
+	private void update(byte detailLevel, int posX, int posZ)
+	{
+		dataContainer[detailLevel].updateData(dataContainer[detailLevel - 1], posX, posZ);
+	}
+
+
+	/**
+	 * Returns if data exists at the given relative Pos.
+	 */
+	public boolean doesDataExist(byte detailLevel, int posX, int posZ)
+	{
+		if (detailLevel < minDetailLevel)
+			return false;
+
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+
+		if (dataContainer == null || dataContainer[detailLevel] == null)
+			return false;
+
+		return dataContainer[detailLevel].doesItExist(posX, posZ);
+	}
+
+	/**
+	 * Gets the generation mode for the data point at the given relative pos.
+	 */
+	public byte getGenerationMode(byte detailLevel, int posX, int posZ)
+	{
+		if (dataContainer[detailLevel].doesItExist(posX, posZ))
+			// We take the bottom information always
+			// TODO what does that mean? bottom of what?
+			return DataPointUtil.getGenerationMode(dataContainer[detailLevel].getSingleData(posX, posZ));
+		else
+			return DistanceGenerationMode.NONE.complexity;
+	}
+
+	/**
+	 * Returns the lowest detail level in this region
+	 * TODO is that right?
+	 */
+	public byte getMinDetailLevel()
+	{
+		return minDetailLevel;
+	}
+
+	/**
+	 * Returns the LevelContainer for the detailLevel
+	 *
+	 * @throws IllegalArgumentException if the detailLevel is less than minDetailLevel
+	 */
+	public LevelContainer getLevel(byte detailLevel)
+	{
+		if (detailLevel < minDetailLevel)
+			throw new IllegalArgumentException("getLevel asked for a detail level that does not exist: minimum: [" + minDetailLevel + "] level requested: [" + detailLevel + "]");
+
+		return dataContainer[detailLevel];
+	}
+
+	/**
+	 * Add the levelContainer to this Region, updating the minDetailLevel
+	 * if necessary.
+	 *
+	 * @throws IllegalArgumentException if the LevelContainer's detailLevel
+	 *                                  is 2 or more detail levels lower than the
+	 *                                  minDetailLevel of this region.
+	 */
+	public void addLevelContainer(LevelContainer levelContainer)
+	{
+		if (levelContainer.getDetailLevel() < minDetailLevel - 1)
+		{
+			throw new IllegalArgumentException(
+					"the LevelContainer's detailLevel was "
+							+ "[" + levelContainer.getDetailLevel() + "] but this region "
+							+ "only allows adding LevelContainers with a "
+							+ "detail level of [" + (minDetailLevel - 1) + "]");
+		}
+
+		if (levelContainer.getDetailLevel() == minDetailLevel - 1)
+			minDetailLevel = levelContainer.getDetailLevel();
+
+		dataContainer[levelContainer.getDetailLevel()] = levelContainer;
+	}
+
+	// TODO James thinks cutTree and growTree (which he renamed to match cutTree)
+	// should have more descriptive names, to make sure the "Tree" portion isn't
+	// confused with Minecraft trees (the plant).
+
+	/**
+	 * Removes any dataContainers that are higher than
+	 * the given detailLevel
+	 */
+	public void cutTree(byte detailLevel)
+	{
+		if (detailLevel > minDetailLevel)
+		{
+			for (byte detailLevelIndex = 0; detailLevelIndex < detailLevel; detailLevelIndex++)
+				dataContainer[detailLevelIndex] = null;
+
+			minDetailLevel = detailLevel;
+		}
+	}
+
+	/**
+	 * Make this region more detailed to the detailLevel given.
+	 * TODO is that correct?
+	 */
+	public void growTree(byte detailLevel)
+	{
+		if (detailLevel < minDetailLevel)
+		{
+			for (byte detailLevelIndex = (byte) (minDetailLevel - 1); detailLevelIndex >= detailLevel; detailLevelIndex--)
+			{
+				if (dataContainer[detailLevelIndex + 1] == null)
+					dataContainer[detailLevelIndex + 1] = new SingleLevelContainer((byte) (detailLevelIndex + 1));
+
+				dataContainer[detailLevelIndex] = dataContainer[detailLevelIndex + 1].expand();
+			}
+			minDetailLevel = detailLevel;
+		}
+	}
+
+	/**
+	 * return RegionPos of this lod region
+	 */
+	public RegionPos getRegionPos()
+	{
+		return new RegionPos(regionPosX, regionPosZ);
+	}
+
+	/**
+	 * Returns the minimum memory needed in bytes
+	 */
+	public int getMinMemoryNeeded(LodTemplate template)
+	{
+		int memory = 0;
+		for (byte detailLevelIndex = LodUtil.REGION_DETAIL_LEVEL; detailLevelIndex > minDetailLevel; detailLevelIndex--)
+		{
+			// TODO why are we multiplying the dataContainer's memory by the template's memory?
+			memory += dataContainer[detailLevelIndex].getMaxMemoryUse() * template.getBufferMemoryForSingleLod(dataContainer[detailLevelIndex].getMaxVerticalData());
+		}
+		return memory;
+	}
+
+	/**
+	 * Returns how many LODs are in this region
+	 */
+	public int getNumberOfLods()
+	{
+		int count = 0;
+		for (LevelContainer container : dataContainer)
+			count += container.getMaxNumberOfLods();
+
+		return count;
+	}
+
+	public VerticalQuality getVerticalQuality()
+	{
+		return verticalQuality;
+	}
+
+	public DistanceGenerationMode getGenerationMode()
+	{
+		return generationMode;
+	}
+
+	public int getMaxVerticalData(byte detailLevel)
+	{
+		return dataContainer[detailLevel].getMaxVerticalData();
+	}
+
+
+	@Override
+	public String toString()
+	{
+		return getLevel(LodUtil.REGION_DETAIL_LEVEL).toString();
+	}
+}
@@ -0,0 +1,171 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.objects;
+
+import java.util.Hashtable;
+import java.util.Map;
+
+import com.seibel.lod.proxy.ClientProxy;
+
+import net.minecraft.world.DimensionType;
+
+/**
+ * This stores all LODs for a given world.
+ *
+ * @author James Seibel
+ * @author Leonardo Amato
+ * @version 9-27-2021
+ */
+public class LodWorld
+{
+	/** name of this world */
+	private String worldName;
+	
+	/** dimensions in this world */
+	private Map<DimensionType, LodDimension> lodDimensions;
+	
+	/** If true then the LOD world is setup and ready to use */
+	private boolean isWorldLoaded = false;
+	
+	/** the name given to the world if it isn't loaded */
+	public static final String NO_WORLD_LOADED = "No world loaded";
+	
+	
+	
+	public LodWorld()
+	{
+		worldName = NO_WORLD_LOADED;
+	}
+	
+	
+	
+	/**
+	 * Set up the LodWorld with the given newWorldName. <br>
+	 * This should be done whenever loading a new world. <br><br>
+	 * 
+	 * Note a System.gc() call may be in order after calling this <Br>
+	 * since a lot of LOD data is now homeless. <br>
+	 * 
+	 * @param newWorldName name of the world
+	 */
+	public void selectWorld(String newWorldName)
+	{
+		if (newWorldName.isEmpty())
+		{
+			deselectWorld();
+			return;
+		}
+		
+		if (worldName.equals(newWorldName))
+			// don't recreate everything if we
+			// didn't actually change worlds
+			return;
+		
+		worldName = newWorldName;
+		lodDimensions = new Hashtable<DimensionType, LodDimension>();
+		isWorldLoaded = true;
+	}
+	
+	/**
+	 * Set the worldName to "No world loaded"
+	 * and clear the lodDimensions Map. <br>
+	 * This should be done whenever unloaded a world. <br><br>
+	 * 
+	 * Note a System.gc() call may be in order after calling this <Br>
+	 * since a lot of LOD data is now homeless. <br>
+	 */
+	public void deselectWorld()
+	{
+		worldName = NO_WORLD_LOADED;
+		lodDimensions = null;
+		isWorldLoaded = false;
+	}
+	
+	
+	/**
+	 * Adds newDimension to this world, if a LodDimension
+	 * already exists for the given dimension it is replaced.
+	 */
+	public void addLodDimension(LodDimension newDimension)
+	{
+		if (lodDimensions == null)
+			return;
+		
+		lodDimensions.put(newDimension.dimension, newDimension);
+	}
+	
+	/**
+	 * Returns null if no LodDimension exists for the given dimension
+	 */
+	public LodDimension getLodDimension(DimensionType dimension)
+	{
+		if (lodDimensions == null)
+			return null;
+		
+		return lodDimensions.get(dimension);
+	}
+	
+	/**
+	 * Resizes the max width in regions that each LodDimension
+	 * should use.
+	 */
+	public void resizeDimensionRegionWidth(int newRegionWidth)
+	{
+		if (lodDimensions == null)
+			return;
+		
+		saveAllDimensions();
+		
+		for (DimensionType key : lodDimensions.keySet())
+			lodDimensions.get(key).setRegionWidth(newRegionWidth);
+	}
+	
+	/**
+	 * Requests all dimensions save any dirty regions they may have.
+	 */
+	public void saveAllDimensions()
+	{
+		if (lodDimensions == null)
+			return;
+		
+		// TODO we should only print this if lods were actually saved to file
+		// but that requires a LodDimension.hasDirtyRegions() method or something similar
+		ClientProxy.LOGGER.info("Saving LODs");
+		
+		for (DimensionType key : lodDimensions.keySet())
+			lodDimensions.get(key).saveDirtyRegionsToFileAsync();
+	}
+	
+	
+	public boolean getIsWorldLoaded()
+	{
+		return isWorldLoaded;
+	}
+	
+	public String getWorldName()
+	{
+		return worldName;
+	}
+	
+	@Override
+	public String toString()
+	{
+		return "World name: " + worldName;
+	}
+}
+
@@ -0,0 +1,63 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.objects;
+
+import com.seibel.lod.enums.FogDistance;
+import com.seibel.lod.enums.FogQuality;
+
+/**
+ * This object is just a replacement for an array
+ * to make things easier to understand in the LodRenderer.
+ * 
+ * @author James Seibel
+ * @version 7-03-2021
+ */
+public class NearFarFogSettings
+{
+	public NearOrFarSetting near = new NearOrFarSetting(FogDistance.NEAR);
+	public NearOrFarSetting far = new NearOrFarSetting(FogDistance.FAR);
+	
+	/** If true that means Minecraft is
+	 * rendering fog along side us */
+	public boolean vanillaIsRenderingFog = true;
+	
+	public NearFarFogSettings()
+	{
+		
+	}
+	
+	
+	
+	/**
+	 * This holds all relevant data to rendering fog at either
+	 * near or far distances.
+	 */
+	public class NearOrFarSetting
+	{
+		public FogQuality quality = FogQuality.FANCY;
+		public FogDistance distance = FogDistance.FAR;
+		
+		/** If true this section should render with fog */
+		public boolean enabled = true;
+		
+		public NearOrFarSetting(FogDistance newFogDistance)
+		{
+			distance = newFogDistance;
+		}
+	}
+}
@@ -0,0 +1,200 @@
+package com.seibel.lod.objects;
+
+import com.seibel.lod.util.LevelPosUtil;
+
+import javax.swing.*;
+
+/**
+ * Holds the levelPos that need to be generated.
+ * TODO is that correct?
+ * 
+ * @author Leonardo Amato
+ * @version 9-27-2021
+ */
+public class PosToGenerateContainer
+{
+	private int playerPosX;
+	private int playerPosZ;
+	private byte farMinDetail;
+	private int nearSize;
+	private int farSize;
+	
+	// TODO what is the format of these two arrays? [detailLevel][4-children]?
+	private int[][] nearPosToGenerate;
+	private int[][] farPosToGenerate;
+	
+	
+	
+	
+	public PosToGenerateContainer(byte farMinDetail, int maxDataToGenerate, int playerPosX, int playerPosZ)
+	{
+		this.playerPosX = playerPosX;
+		this.playerPosZ = playerPosZ;
+		this.farMinDetail = farMinDetail;
+		nearSize = 0;
+		farSize = 0;
+		nearPosToGenerate = new int[maxDataToGenerate][4];
+		farPosToGenerate = new int[maxDataToGenerate][4];
+	}
+	
+	
+	
+	// TODO what is going on in this method?
+	public void addPosToGenerate(byte detailLevel, int posX, int posZ)
+	{
+		int distance = LevelPosUtil.minDistance(detailLevel, posX, posZ, playerPosX, playerPosZ);
+		int index;
+		
+		if (detailLevel >= farMinDetail)
+		{
+			// We are introducing a position in the far array
+			
+			if(farSize < farPosToGenerate.length)
+				farSize++;
+
+			index = farSize - 1;
+			while (index > 0 && LevelPosUtil.compareDistance(distance, farPosToGenerate[index - 1][3]) <= 0)
+			{
+				farPosToGenerate[index][0] = farPosToGenerate[index - 1][0];
+				farPosToGenerate[index][1] = farPosToGenerate[index - 1][1];
+				farPosToGenerate[index][2] = farPosToGenerate[index - 1][2];
+				farPosToGenerate[index][3] = farPosToGenerate[index - 1][3];
+				index--;
+			}
+			
+			
+			if (index != farSize-1 || farSize != farPosToGenerate.length)
+			{
+				farPosToGenerate[index][0] = detailLevel + 1;
+				farPosToGenerate[index][1] = posX;
+				farPosToGenerate[index][2] = posZ;
+				farPosToGenerate[index][3] = distance;
+			}
+		}
+		else
+		{
+			//We are introducing a position in the near array
+			
+			if(nearSize < nearPosToGenerate.length)
+				nearSize++;
+			
+			index = nearSize-1;
+			while (index > 0 && LevelPosUtil.compareDistance(distance, nearPosToGenerate[index - 1][3]) <= 0)
+			{
+				nearPosToGenerate[index][0] = nearPosToGenerate[index - 1][0];
+				nearPosToGenerate[index][1] = nearPosToGenerate[index - 1][1];
+				nearPosToGenerate[index][2] = nearPosToGenerate[index - 1][2];
+				nearPosToGenerate[index][3] = nearPosToGenerate[index - 1][3];
+				index--;
+			}
+			
+			
+			if (index != nearSize-1 || nearSize != nearPosToGenerate.length)
+			{
+				nearPosToGenerate[index][0] = detailLevel + 1;
+				nearPosToGenerate[index][1] = posX;
+				nearPosToGenerate[index][2] = posZ;
+				nearPosToGenerate[index][3] = distance;
+			}
+		}
+	}
+	
+	
+	
+	public int getNumberOfPos()
+	{
+		return nearSize+farSize;
+	}
+	
+	public int getNumberOfNearPos()
+	{
+		return nearSize;
+	}
+	
+	public int getNumberOfFarPos()
+	{
+		return farSize;
+	}
+	
+	// TODO what does getNth mean? could the name be more descriptive or is it just a index?
+	public int getNthDetail(int n, boolean near)
+	{
+		if (near)
+			return nearPosToGenerate[n][0];
+		else
+			return farPosToGenerate[n][0];
+	}
+	public int getNthPosX(int n, boolean near)
+	{
+		if (near)
+			return nearPosToGenerate[n][1];
+		else
+			return farPosToGenerate[n][1];
+	}
+	public int getNthPosZ(int n, boolean near)
+	{
+		if (near)
+			return nearPosToGenerate[n][2];
+		else
+			return farPosToGenerate[n][2];
+	}
+	public int getNthGeneration(int n, boolean near)
+	{
+		if (near)
+			return nearPosToGenerate[n][3];
+		else
+			return farPosToGenerate[n][3];
+	}
+	
+	@Override
+	public String toString()
+	{
+		// TOOD is this commented code still useful?
+		// if so why have it commented out?
+		
+		/*
+		StringBuilder builder = new StringBuilder();
+		builder.append("Number of pos to generate ");
+		builder.append(farSize + nearSize);
+		builder.append('\n');
+		builder.append("Number of near pos to generate ");
+		builder.append(nearSize);
+		builder.append('\n');
+		builder.append("Number of far pos to generate ");
+		builder.append(farSize);
+		builder.append('\n');
+		builder.append('\n');
+		builder.append("near pos to generate");
+		builder.append('\n');
+		for (int i = 0; i < nearSize; i++)
+		{
+			builder.append(posToGenerate[i][0]-1);
+			builder.append(" ");
+			builder.append(posToGenerate[i][1]);
+			builder.append(" ");
+			builder.append(posToGenerate[i][2]);
+			builder.append(" ");
+			builder.append(posToGenerate[i][3]);
+			builder.append('\n');
+		}
+		builder.append('\n');
+		builder.append("far pos to generate");
+		builder.append('\n');
+		for (int i = maxSize - 1; i >= maxSize - farSize; i--)
+		{
+			builder.append(posToGenerate[i][0]-1);
+			builder.append(" ");
+			builder.append(posToGenerate[i][1]);
+			builder.append(" ");
+			builder.append(posToGenerate[i][2]);
+			builder.append(" ");
+			builder.append(posToGenerate[i][3]);
+			builder.append('\n');
+		}
+		builder.append('\n');
+		return builder.toString();
+		*/
+		
+		return " ";
+	}
+}
@@ -0,0 +1,126 @@
+package com.seibel.lod.objects;
+
+import com.seibel.lod.proxy.ClientProxy;
+import com.seibel.lod.util.LevelPosUtil;
+import com.seibel.lod.util.LodUtil;
+
+import java.util.Arrays;
+
+/**
+ * 
+ * @author Leonardo Amato
+ * @version 9-18-2021
+ */
+public class PosToRenderContainer
+{
+	public byte minDetail;
+	private int size;
+	private int regionPosX;
+	private int regionPosZ;
+	private int numberOfPosToRender;
+	private int[] posToRender;
+	/*TODO this population matrix could be converted to boolean to improve memory use*/
+	private byte[][] population;
+
+	public PosToRenderContainer(byte minDetail, int regionPosX, int regionPosZ)
+	{
+		this.minDetail = minDetail;
+		this.numberOfPosToRender = 0;
+		this.regionPosX = regionPosX;
+		this.regionPosZ = regionPosZ;
+		this.size = 1 << (LodUtil.REGION_DETAIL_LEVEL - minDetail);
+		posToRender = new int[size*size*3];
+		population = new byte[size][size];
+	}
+
+	public void addPosToRender(byte detailLevel, int posX, int posZ)
+	{
+		// When rapidly changing dimensions the bufferBuidler can cause this,
+		// James isn't sure why, but this will prevent an exception at
+		// the very least (while stilling logging the problem). 
+		if (numberOfPosToRender >= posToRender.length)
+		{
+			// This is might be due to dimensions having a different width
+			// when first loading in
+			ClientProxy.LOGGER.error("Unable to addPosToRender. numberOfPosToRender [" + numberOfPosToRender +"] detailLevel [" + detailLevel + "] Pos [" + posX + "," + posZ + "]");
+			numberOfPosToRender++; // incrementing so we can see how many pos over the limit we would go
+			return;
+		}
+		
+		//if(numberOfPosToRender >= posToRender.length)
+		//	posToRender = Arrays.copyOf(posToRender, posToRender.length*2);
+		posToRender[numberOfPosToRender*3 + 0] = detailLevel;
+		posToRender[numberOfPosToRender*3 + 1] = posX;
+		posToRender[numberOfPosToRender*3 + 2] = posZ;
+		numberOfPosToRender++;
+		population[LevelPosUtil.getRegionModule(minDetail, LevelPosUtil.convert(detailLevel,posX,minDetail))]
+				[LevelPosUtil.getRegionModule(minDetail, LevelPosUtil.convert(detailLevel,posZ,minDetail))] = (byte) (detailLevel + 1);
+	}
+
+	public boolean contains(byte detailLevel, int posX, int posZ)
+	{
+		if(LevelPosUtil.getRegion(detailLevel, posX) == regionPosX && LevelPosUtil.getRegion(detailLevel, posZ) == regionPosZ)
+		{
+			return (population[LevelPosUtil.getRegionModule(minDetail, LevelPosUtil.convert(detailLevel,posX,minDetail))]
+					        [LevelPosUtil.getRegionModule(minDetail, LevelPosUtil.convert(detailLevel,posZ,minDetail))] == (detailLevel + 1));
+		}else
+		{
+			return false;
+		}
+	}
+	public void clear(byte minDetail, int regionPosX, int regionPosZ){
+		this.numberOfPosToRender = 0;
+		this.regionPosX = regionPosX;
+		this.regionPosZ = regionPosZ;
+		if(this.minDetail == minDetail)
+		{
+			Arrays.fill(posToRender, 0);
+			for(int i = 0; i< population.length; i++)
+				Arrays.fill(population[i], (byte) 0);
+		}else{
+			this.minDetail = minDetail;
+			int size = 1 << (LodUtil.REGION_DETAIL_LEVEL - minDetail);
+			posToRender = new int[size*size*3];
+			population = new byte[size][size];
+		}
+	}
+
+	public int getNumberOfPos()
+	{
+		return numberOfPosToRender;
+	}
+
+	public byte getNthDetailLevel(int n)
+	{
+		return (byte) posToRender[n*3 + 0];
+	}
+	public int getNthPosX(int n)
+	{
+		return posToRender[n*3 + 1];
+	}
+	public int getNthPosZ(int n)
+	{
+		return posToRender[n*3 + 2];
+	}
+
+	@Override
+	public String toString()
+	{
+
+		StringBuilder builder = new StringBuilder();
+		builder.append("To render ");
+		builder.append(numberOfPosToRender);
+		builder.append('\n');
+		for(int i = 0; i < numberOfPosToRender; i++)
+		{
+			builder.append(posToRender[i*3 + 0]);
+			builder.append(" ");
+			builder.append(posToRender[i*3 + 1]);
+			builder.append(" ");
+			builder.append(posToRender[i*3 + 2]);
+			builder.append('\n');
+		}
+		builder.append('\n');
+		return builder.toString();
+	}
+}
@@ -0,0 +1,89 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.objects;
+
+import com.seibel.lod.util.LodUtil;
+
+import net.minecraft.util.math.BlockPos;
+import net.minecraft.util.math.ChunkPos;
+
+/**
+ * This object is similar to ChunkPos or BlockPos.
+ *
+ * @author James Seibel
+ * @version 8-21-2021
+ */
+public class RegionPos
+{
+	public int x;
+	public int z;
+	
+	
+	/**
+	 * Default Constructor <br><br>
+	 * 
+	 * Sets x and z to 0
+	 */
+	public RegionPos()
+	{
+		x = 0;
+		z = 0;
+	}
+	
+	/** simple constructor that sets x and z to new x and z. */
+	public RegionPos(int newX, int newZ)
+	{
+		x = newX;
+		z = newZ;
+	}
+	
+	/** Converts from a BlockPos to a RegionPos */
+	public RegionPos(BlockPos pos)
+	{
+		this(new ChunkPos(pos));
+	}
+	
+	/** Converts from a ChunkPos to a RegionPos */
+	public RegionPos(ChunkPos pos)
+	{
+		x = Math.floorDiv(pos.x, LodUtil.REGION_WIDTH_IN_CHUNKS);
+		z = Math.floorDiv(pos.z, LodUtil.REGION_WIDTH_IN_CHUNKS);
+	}
+	
+	/** Returns the ChunkPos at the center of this region */
+	public ChunkPos chunkPos()
+	{
+		return new ChunkPos(
+				(x * LodUtil.REGION_WIDTH_IN_CHUNKS) + LodUtil.REGION_WIDTH_IN_CHUNKS / 2, 
+				(z * LodUtil.REGION_WIDTH_IN_CHUNKS) + LodUtil.REGION_WIDTH_IN_CHUNKS / 2);
+	}
+	
+	/** Returns the BlockPos at the center of this region */
+	public BlockPos blockPos()
+	{
+		return chunkPos().getWorldPosition()
+				.offset(LodUtil.CHUNK_WIDTH / 2, 0, LodUtil.CHUNK_WIDTH / 2);
+	}
+	
+	
+	@Override
+	public String toString()
+	{
+		return "(" + x + "," + z + ")";
+	}
+}
@@ -0,0 +1,233 @@
+package com.seibel.lod.objects;
+
+import java.util.Arrays;
+
+import com.seibel.lod.util.DataPointUtil;
+import com.seibel.lod.util.LevelPosUtil;
+import com.seibel.lod.util.LodUtil;
+import com.seibel.lod.util.ThreadMapUtil;
+
+/**
+ * This object holds the LOD data for a single dataPoint.
+ * 
+ * @author Leonardo Amato
+ * @version 9-28-2021
+ */
+public class SingleLevelContainer implements LevelContainer
+{
+	/** The detailLevel of this LevelContainer */
+	public final byte detailLevel;
+	/** How many dataPoints wide is this LevelContainer? */
+	public final int dataWidthCount;
+	
+	/** This holds all the dataPoints for this LevelContainer */
+	public final long[][] dataContainer;
+	
+	
+	
+	/** Constructor */
+	public SingleLevelContainer(byte newDetailLevel)
+	{
+		this.detailLevel = newDetailLevel;
+		
+		// equivalent to 2^(...)
+		dataWidthCount = 1 << (LodUtil.REGION_DETAIL_LEVEL - newDetailLevel);
+		dataContainer = new long[dataWidthCount][dataWidthCount];
+	}
+	
+	/**  */
+	public SingleLevelContainer(byte[] inputData)
+	{
+		int tempIndex;
+		int index = 0;
+		long newData;
+		detailLevel = inputData[index];
+		index++;
+		dataWidthCount = (int) Math.pow(2, LodUtil.REGION_DETAIL_LEVEL - detailLevel);
+		this.dataContainer = new long[dataWidthCount][dataWidthCount];
+		
+		for (int x = 0; x < dataWidthCount; x++)
+		{
+			for (int z = 0; z < dataWidthCount; z++)
+			{
+				newData = 0;
+				if (inputData[index] == 0)
+				{
+					index++;
+				}
+				else if (inputData[index] == 3)
+				{
+					newData = 3;
+					index++;
+				}
+				else if (index + 7 >= inputData.length)
+				{
+					break;
+				}
+				else
+				{
+					for (tempIndex = 0; tempIndex < 8; tempIndex++)
+						newData += (((long) inputData[index + tempIndex]) & 0xff) << (8 * tempIndex);
+					index = index + 8;
+				}
+				
+				dataContainer[x][z] = newData;
+			}
+		}
+	}
+	
+	
+	
+	
+	
+	@Override
+	public void clear(int posX, int posZ)
+	{
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		dataContainer[posX][posZ] = DataPointUtil.EMPTY_DATA;
+	}
+	
+	@Override
+	public boolean addData(long data, int posX, int posZ, int index)
+	{
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		dataContainer[posX][posZ] = data;
+		return true;
+	}
+	
+	@Override
+	public boolean addSingleData(long newData, int posX, int posZ)
+	{
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		dataContainer[posX][posZ] = newData;
+		return true;
+	}
+	
+	@Override
+	public long getData(int posX, int posZ, int index)
+	{
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		// TODO Improve this using a thread map to long[]
+		return dataContainer[posX][posZ];
+	}
+	
+	@Override
+	public long getSingleData(int posX, int posZ)
+	{
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		// TODO Improve this using a thread map to long[]
+		return dataContainer[posX][posZ];
+	}
+	
+	@Override
+	public byte getDetailLevel()
+	{
+		return detailLevel;
+	}
+	
+	@Override
+	public LevelContainer expand()
+	{
+		return new SingleLevelContainer((byte) (getDetailLevel() - 1));
+	}
+	
+	
+	
+	/** TODO could this be renamed mergeData? */
+	@Override
+	public void updateData(LevelContainer lowerLevelContainer, int posX, int posZ)
+	{
+		//We reset the array
+		long[] dataToMerge = ThreadMapUtil.getSingleUpdateArray();
+		
+		int childPosX;
+		int childPosZ;
+		long data;
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		for (int x = 0; x <= 1; x++)
+		{
+			for (int z = 0; z <= 1; z++)
+			{
+				childPosX = 2 * posX + x;
+				childPosZ = 2 * posZ + z;
+				dataToMerge[2 * x + z] = lowerLevelContainer.getSingleData(childPosX, childPosZ);
+			}
+		}
+		data = DataPointUtil.mergeSingleData(dataToMerge);
+		addSingleData(data, posX, posZ);
+	}
+	
+	@Override
+	public int getMaxVerticalData()
+	{
+		return 1;
+	}
+	
+	@Override
+	public boolean doesItExist(int posX, int posZ)
+	{
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		//Improve this using a thread map to long[]
+		return DataPointUtil.doesItExist(getSingleData(posX, posZ));
+	}
+	
+	@Override
+	public byte[] toDataString()
+	{
+		int index = 0;
+		int tempIndex;
+		byte[] tempData = ThreadMapUtil.getFreshSaveContainer(1 + (dataWidthCount * dataWidthCount * 8));
+		
+		tempData[index] = detailLevel;
+		index++;
+		for (int x = 0; x < dataWidthCount; x++)
+		{
+			for (int z = 0; z < dataWidthCount; z++)
+			{
+				if (dataContainer[x][z] == 0)
+				{
+					tempData[index] = 0;
+					index++;
+				} else if (dataContainer[x][z] == 3)
+				{
+					tempData[index] = 3;
+					index++;
+				} else
+				{
+					for (tempIndex = 0; tempIndex < 8; tempIndex++)
+						tempData[index + tempIndex] = (byte) (dataContainer[x][z] >>> (8 * tempIndex));
+					index += 8;
+				}
+			}
+		}
+		return Arrays.copyOfRange(tempData, 0, index);
+	}
+	
+	@Override
+	public String toString()
+	{
+		StringBuilder stringBuilder = new StringBuilder();
+		stringBuilder.append(detailLevel);
+		return stringBuilder.toString();
+	}
+	
+	
+	@Override
+	public int getMaxNumberOfLods()
+	{
+		return dataWidthCount * dataWidthCount * getMaxVerticalData();
+	}
+	
+	@Override
+	public int getMaxMemoryUse()
+	{
+		return getMaxNumberOfLods() * 2; //2 byte
+	}
+}
@@ -0,0 +1,261 @@
+package com.seibel.lod.objects;
+
+import java.util.Arrays;
+
+import com.seibel.lod.util.DataPointUtil;
+import com.seibel.lod.util.DetailDistanceUtil;
+import com.seibel.lod.util.LevelPosUtil;
+import com.seibel.lod.util.LodUtil;
+import com.seibel.lod.util.ThreadMapUtil;
+
+public class VerticalLevelContainer implements LevelContainer
+{
+
+	public final byte detailLevel;
+	public final int size;
+	public final int maxVerticalData;
+
+	public final long[] dataContainer;
+
+	public VerticalLevelContainer(byte detailLevel)
+	{
+		this.detailLevel = detailLevel;
+		size = 1 << (LodUtil.REGION_DETAIL_LEVEL - detailLevel);
+		maxVerticalData = DetailDistanceUtil.getMaxVerticalData(detailLevel);
+		dataContainer = new long[size * size * DetailDistanceUtil.getMaxVerticalData(detailLevel)];
+	}
+
+	@Override
+	public byte getDetailLevel()
+	{
+		return detailLevel;
+	}
+
+	@Override
+	public void clear(int posX, int posZ){
+
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		for(int verticalIndex = 0; verticalIndex < maxVerticalData; verticalIndex++){
+			dataContainer[posX*size*maxVerticalData + posZ*maxVerticalData + verticalIndex] = DataPointUtil.EMPTY_DATA;
+		}
+	}
+
+	@Override
+	public boolean addData(long data, int posX, int posZ, int verticalIndex){
+
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		dataContainer[posX*size*maxVerticalData + posZ*maxVerticalData + verticalIndex] = data;
+		return true;
+	}
+
+	@Override
+	public boolean addSingleData(long data, int posX, int posZ){
+		return addData(data, posX, posZ, 0);
+	}
+
+	@Override
+	public long getData(int posX, int posZ, int verticalIndex){
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		return dataContainer[posX*size*maxVerticalData + posZ*maxVerticalData + verticalIndex];
+	}
+
+	@Override
+	public long getSingleData(int posX, int posZ){
+		return getData(posX,posZ,0);
+	}
+
+	@Override
+	public int getMaxVerticalData(){
+		return maxVerticalData;
+	}
+
+	public int getSize(){
+		return size;
+	}
+
+	@Override
+	public boolean doesItExist(int posX, int posZ){
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		return DataPointUtil.doesItExist(getSingleData(posX,posZ));
+	}
+
+	public VerticalLevelContainer(byte[] inputData)
+	{
+		int tempIndex;
+		int index = 0;
+		int counter = -1;
+		long newData;
+		byte last = 0;
+		detailLevel = inputData[index];
+		index++;
+		maxVerticalData = inputData[index];
+		index++;
+		size = (int) Math.pow(2, LodUtil.REGION_DETAIL_LEVEL - detailLevel);
+		int x = size * size * maxVerticalData;
+		this.dataContainer = new long[x];
+		for ( int i = 0; i < x; i++)
+		{
+			newData = 0;
+			if (counter > -1)
+			{
+				dataContainer[i] = last;
+				if (last == 3)
+				{ //skip rest of void chunk
+					for (tempIndex = 1; tempIndex < maxVerticalData; tempIndex++) {
+						dataContainer[i + tempIndex] = 0;
+					}
+					i += maxVerticalData - 1;
+				}
+				counter--;
+			} else if ((inputData[index] & 0x3) == 0 || (inputData[index] & 0x3) == 3)
+			{
+				last = (byte)(inputData[index] & 0x3);
+				//recover counter
+				counter = (inputData[index] & 0x7c) >>> 2;
+				tempIndex = 0;
+				while ((inputData[index] & 0x80) == 0x80)
+				{ //overflow bit is on
+					index++;
+					counter += (inputData[index] & 0x7f) << (5 + 7 * tempIndex);
+					tempIndex++;
+				}
+				index++;
+				//since loop expects from us to put some data in, we just make it rerun it with new counter;
+				i--;
+			} else if (index + 7 >= inputData.length)
+				break;
+			else {
+				for (tempIndex = 0; tempIndex < 8; tempIndex++)
+					newData += (((long) inputData[index + tempIndex]) & 0xff) << (8 * tempIndex);
+				index = index + 8;
+				dataContainer[i] = newData;
+			}
+		}
+	}
+
+	@Override
+	public LevelContainer expand(){
+		return new VerticalLevelContainer((byte) (getDetailLevel() - 1));
+	}
+
+	@Override
+	public void updateData(LevelContainer lowerLevelContainer, int posX, int posZ)
+	{
+		//We reset the array
+		long[] dataToMerge = ThreadMapUtil.getFreshVerticalUpdateArray(4 * lowerLevelContainer.getMaxVerticalData(), detailLevel);
+
+		int lowerMaxVertical = dataToMerge.length/4;
+		int childPosX;
+		int childPosZ;
+		long[] data;
+		posX = LevelPosUtil.getRegionModule(detailLevel, posX);
+		posZ = LevelPosUtil.getRegionModule(detailLevel, posZ);
+		for (int x = 0; x <= 1; x++)
+		{
+			for (int z = 0; z <= 1; z++)
+			{
+				childPosX = 2 * posX + x;
+				childPosZ = 2 * posZ + z;
+				for(int verticalIndex = 0; verticalIndex < lowerMaxVertical; verticalIndex++)
+					dataToMerge[(z*2+x)*lowerMaxVertical + verticalIndex] = lowerLevelContainer.getData(childPosX, childPosZ, verticalIndex);
+			}
+		}
+		data = DataPointUtil.mergeMultiData(dataToMerge, lowerMaxVertical, getMaxVerticalData());
+		
+		for(int verticalIndex = 0; (verticalIndex < data.length) && (verticalIndex < maxVerticalData); verticalIndex++)
+		{
+			addData(data[verticalIndex],
+					posX,
+					posZ,
+					verticalIndex);
+		}
+	}
+
+	@Override
+	public byte[] toDataString()
+	{
+		int index = 0;
+		int counter = -1;
+		byte last = -1;
+		int x = size * size * maxVerticalData;
+		int tempIndex;
+		long current;
+		
+		byte[] tempData = ThreadMapUtil.getFreshSaveContainer(2 + (x * 8));
+
+		tempData[index] = detailLevel;
+		index++;
+		tempData[index] = (byte) maxVerticalData;
+		index++;
+
+		for (int i = 0; i < x; i++)
+		{
+			current = dataContainer[i];
+			if ((current & 0b11) == 0 || (current & 0b11) == 3)
+			{
+				current &= 0b11; //clean any garbage data after those two bits
+				last = (byte) current;
+				if (current == 3) //skip rest of void chunk
+					i += maxVerticalData - 1;
+				counter++;
+			} else {
+				for (tempIndex = 0; tempIndex < 8; tempIndex++)
+					tempData[index + tempIndex] = (byte) (current >>> (8 * tempIndex));
+				index += 8;
+			}
+			if (last != -1 && ( i == x - 1 || last != ((dataContainer[i + 1]) & 0b11)))
+			{ //save compressed data if next is different or if we reached onf of the data
+				tempData[index] = (byte)(0x7f & ((counter << 2) + last)); //save 5 bits of counter and compressed block
+
+				tempIndex = 0;
+				while ((counter >>> (5 + 7 * tempIndex)) != 0) //there is more of that counter
+				{
+					tempData[index] = (byte)(tempData[index] | 0x80); //set overflow bit to true
+					index++; // after setting overflow bit w can actually index++
+					tempData[index] = (byte)(0x7f & (counter >>> (5 + 7 * tempIndex))); // save 7 bits of counter
+					tempIndex++;
+				}
+				index++;
+				last = -1;
+				counter = -1;
+			}
+		}
+		return Arrays.copyOfRange(tempData, 0, index);
+	}
+
+	@Override
+	public String toString()
+	{
+		/*
+		StringBuilder stringBuilder = new StringBuilder();
+		int size = (int) Math.pow(2, LodUtil.REGION_DETAIL_LEVEL - detailLevel);
+		stringBuilder.append(detailLevel);
+		stringBuilder.append(DATA_DELIMITER);
+		for (int x = 0; x < size; x++)
+		{
+			for (int z = 0; z < size; z++)
+			{
+				//Converting the dataToHex
+				stringBuilder.append(Long.toHexString(dataContainer[x][z][0]));
+				stringBuilder.append(DATA_DELIMITER);
+			}
+		}
+		return stringBuilder.toString();
+		 */
+		return " ";
+	}
+
+	@Override
+	public int getMaxNumberOfLods(){
+		return size*size*getMaxVerticalData();
+	}
+
+	@Override
+	public int getMaxMemoryUse(){
+		return getMaxNumberOfLods() * 2; //2 byte
+	}
+}
@@ -0,0 +1,387 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.proxy;
+
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.lwjgl.glfw.GLFW;
+
+import com.mojang.blaze3d.matrix.MatrixStack;
+import com.seibel.lod.builders.LodBufferBuilder;
+import com.seibel.lod.builders.LodBuilder;
+import com.seibel.lod.builders.worldGeneration.LodNodeGenWorker;
+import com.seibel.lod.builders.worldGeneration.LodWorldGenerator;
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.objects.LodWorld;
+import com.seibel.lod.objects.RegionPos;
+import com.seibel.lod.render.LodRenderer;
+import com.seibel.lod.util.DataPointUtil;
+import com.seibel.lod.util.DetailDistanceUtil;
+import com.seibel.lod.util.LodUtil;
+import com.seibel.lod.util.ThreadMapUtil;
+import com.seibel.lod.wrappers.MinecraftWrapper;
+
+import net.minecraft.profiler.IProfiler;
+import net.minecraft.util.text.StringTextComponent;
+import net.minecraftforge.client.event.InputEvent;
+import net.minecraftforge.event.TickEvent;
+import net.minecraftforge.event.world.BlockEvent;
+import net.minecraftforge.event.world.ChunkEvent;
+import net.minecraftforge.event.world.WorldEvent;
+import net.minecraftforge.eventbus.api.SubscribeEvent;
+
+/**
+ * This handles all events sent to the client,
+ * and is the starting point for most of the mod.
+ *
+ * @author James_Seibel
+ * @version 9-26-2021
+ */
+public class ClientProxy
+{
+	public static final Logger LOGGER = LogManager.getLogger("LOD");
+	
+	/** 
+	 * there is some setup that should only happen once,
+	 * once this is true that setup has completed
+	 */
+	private boolean firstTimeSetupComplete = false;
+	
+	private static LodWorld lodWorld = new LodWorld();
+	private static LodBuilder lodBuilder = new LodBuilder();
+	private static LodBufferBuilder lodBufferBuilder = new LodBufferBuilder();
+	private static LodRenderer renderer = new LodRenderer(lodBufferBuilder);
+	private static LodWorldGenerator lodWorldGenerator = LodWorldGenerator.INSTANCE;
+	
+	private boolean configOverrideReminderPrinted = false;
+	
+	private MinecraftWrapper mc = MinecraftWrapper.INSTANCE;
+	
+	
+	/** This is used to determine if the LODs should be regenerated */
+	public static int previousChunkRenderDistance = 0;
+	/** This is used to determine if the LODs should be regenerated */
+	public static int previousLodRenderDistance = 0;
+	
+	/**
+	 * can be set if we want to recalculate variables related
+	 * to the LOD view distance
+	 */
+	private boolean recalculateWidths = false;
+	
+	public ClientProxy()
+	{
+		
+	}
+	
+	
+	//==============//
+	// render event //
+	//==============//
+	
+	/**
+	 * Do any setup that is required to draw LODs
+	 * and then tell the LodRenderer to draw.
+	 * 
+	 * @param mcMatrixStack 
+	 */
+	public void renderLods(MatrixStack mcMatrixStack, float partialTicks)
+	{
+		// comment out when creating a release
+		applyConfigOverrides();
+		
+		// clear any out of date objects
+		mc.clearFrameObjectCache();
+		
+		try
+		{
+			// only run the first time setup once
+			if (!firstTimeSetupComplete)
+				firstFrameSetup();
+			
+			
+			if (mc == null || mc.getPlayer() == null || !lodWorld.getIsWorldLoaded())
+				return;
+			
+			LodDimension lodDim = lodWorld.getLodDimension(mc.getCurrentDimension());
+			if (lodDim == null)
+				return;
+			
+			DetailDistanceUtil.updateSettings();
+			viewDistanceChangedEvent();
+			playerMoveEvent(lodDim);
+			
+			lodDim.cutRegionNodesAsync((int) mc.getPlayer().getX(), (int) mc.getPlayer().getZ());
+			lodDim.expandOrLoadRegionsAsync((int) mc.getPlayer().getX(), (int) mc.getPlayer().getZ());
+			
+			
+			// Note to self:
+			// if "unspecified" shows up in the pie chart, it is
+			// possibly because the amount of time between sections
+			// is too small for the profiler to measure
+			IProfiler profiler = mc.getProfiler();
+			profiler.pop(); // get out of "terrain"
+			profiler.push("LOD");
+			
+			renderer.drawLODs(lodDim, mcMatrixStack, partialTicks, mc.getProfiler());		
+			
+			profiler.pop(); // end LOD
+			profiler.push("terrain"); // go back into "terrain"
+			
+			
+			// these can't be set until after the buffers are built (in renderer.drawLODs)
+			// otherwise the buffers may be set to the wrong size, or not changed at all
+			previousChunkRenderDistance = mc.getRenderDistance();
+			previousLodRenderDistance = LodConfig.CLIENT.graphics.lodChunkRenderDistance.get();
+		}
+		catch (Exception e)
+		{
+			LOGGER.error("client proxy: " + e.getMessage());
+			e.printStackTrace();
+		}
+	}
+	
+	
+	private void applyConfigOverrides()
+	{
+		// remind the developer(s) that the config override is active
+		if (!configOverrideReminderPrinted)
+		{
+			//mc.getPlayer().sendMessage(new StringTextComponent("Debug settings enabled!"), mc.getPlayer().getUUID());
+			
+			mc.getPlayer().sendMessage(new StringTextComponent("LOD experimental build 1.5.1"), mc.getPlayer().getUUID());
+			mc.getPlayer().sendMessage(new StringTextComponent("Here be dragons!"), mc.getPlayer().getUUID());
+			configOverrideReminderPrinted = true;
+		}
+		
+//		LodConfig.CLIENT.graphics.drawResolution.set(HorizontalResolution.BLOCK);
+//		LodConfig.CLIENT.worldGenerator.generationResolution.set(HorizontalResolution.BLOCK);
+		// requires a world restart?
+//		LodConfig.CLIENT.worldGenerator.lodQualityMode.set(VerticalQuality.MULTI_LOD);
+		
+//		LodConfig.CLIENT.graphics.fogDistance.set(FogDistance.FAR);
+//		LodConfig.CLIENT.graphics.fogDrawOverride.set(FogDrawOverride.ALWAYS_DRAW_FOG_FANCY);
+//		LodConfig.CLIENT.graphics.shadingMode.set(ShadingMode.DARKEN_SIDES);
+//		LodConfig.CLIENT.graphics.brightnessMultiplier.set(1.0);
+//		LodConfig.CLIENT.graphics.saturationMultiplier.set(1.0);
+		
+//		LodConfig.CLIENT.worldGenerator.distanceGenerationMode.set(DistanceGenerationMode.SURFACE);
+//		LodConfig.CLIENT.graphics.lodChunkRenderDistance.set(64);
+//		LodConfig.CLIENT.worldGenerator.lodDistanceCalculatorType.set(DistanceCalculatorType.LINEAR);
+//		LodConfig.CLIENT.worldGenerator.allowUnstableFeatureGeneration.set(false);
+		
+//		LodConfig.CLIENT.buffers.bufferRebuildPlayerMoveTimeout.set(2000); // 2000
+//		LodConfig.CLIENT.buffers.bufferRebuildChunkChangeTimeout.set(1000); // 1000
+//		LodConfig.CLIENT.buffers.bufferRebuildLodChangeTimeout.set(5000); // 5000
+		
+		LodConfig.CLIENT.debugging.enableDebugKeybindings.set(true);
+//		LodConfig.CLIENT.debugging.debugMode.set(DebugMode.SHOW_DETAIL);
+	}
+	
+	
+	//==============//
+	// forge events //
+	//==============//
+	
+	@SubscribeEvent
+	public void serverTickEvent(TickEvent.ServerTickEvent event)
+	{
+		if (mc == null || mc.getPlayer() == null || !lodWorld.getIsWorldLoaded())
+			return;
+		
+		LodDimension lodDim = lodWorld.getLodDimension(mc.getPlayer().level.dimensionType());
+		if (lodDim == null)
+			return;
+		
+		lodWorldGenerator.queueGenerationRequests(lodDim, renderer, lodBuilder);
+	}
+	
+	@SubscribeEvent
+	public void chunkLoadEvent(ChunkEvent.Load event)
+	{
+		lodBuilder.generateLodNodeAsync(event.getChunk(), lodWorld, event.getWorld(), DistanceGenerationMode.SERVER);
+	}
+	
+	@SubscribeEvent
+	public void worldSaveEvent(WorldEvent.Save event)
+	{
+		if (lodWorld != null)
+			lodWorld.saveAllDimensions();
+	}
+	
+	/** This is also called when a new dimension loads */
+	@SubscribeEvent
+	public void worldLoadEvent(WorldEvent.Load event)
+	{
+		DataPointUtil.worldHeight = event.getWorld().getHeight();
+		
+		// the player just loaded a new world/dimension
+		lodWorld.selectWorld(LodUtil.getWorldID(event.getWorld()));
+		
+		// make sure the correct LODs are being rendered
+		// (if this isn't done the previous world's LODs may be drawn)
+		renderer.regenerateLODsNextFrame();
+	}
+	
+	@SubscribeEvent
+	public void worldUnloadEvent(WorldEvent.Unload event)
+	{
+		// the player just unloaded a world/dimension
+		ThreadMapUtil.clearMaps();
+		
+		
+		if (mc.getConnection().getLevel() == null)
+		{
+			// the player just left the server
+			
+			// if this isn't done unfinished tasks may be left in the queue
+			// preventing new LodChunks form being generated
+			LodNodeGenWorker.restartExecuterService();
+			
+			LodWorldGenerator.INSTANCE.numberOfChunksWaitingToGenerate.set(0);
+			// the player has disconnected from a server
+			lodWorld.deselectWorld();
+			
+			
+			// hopefully this should reduce issues related to the buffer builder
+			// breaking when changing worlds.
+			renderer.destroyBuffers();
+			recalculateWidths = true;
+			renderer = new LodRenderer(lodBufferBuilder);
+			
+			
+			// make sure the nulled objects are freed.
+			// (this prevents an out of memory error when
+			// changing worlds)
+			System.gc();
+		}
+	}
+	
+	@SubscribeEvent
+	public void blockChangeEvent(BlockEvent event)
+	{
+		if (event.getClass() == BlockEvent.BreakEvent.class ||
+				event.getClass() == BlockEvent.EntityPlaceEvent.class ||
+				event.getClass() == BlockEvent.EntityMultiPlaceEvent.class ||
+				event.getClass() == BlockEvent.FluidPlaceBlockEvent.class ||
+				event.getClass() == BlockEvent.PortalSpawnEvent.class)
+		{
+			// recreate the LOD where the blocks were changed
+			lodBuilder.generateLodNodeAsync(event.getWorld().getChunk(event.getPos()), lodWorld, event.getWorld());
+		}
+	}
+	
+	@SubscribeEvent
+	public void onKeyInput(InputEvent.KeyInputEvent event) 
+	{
+		if(LodConfig.CLIENT.debugging.enableDebugKeybindings.get()
+				&& event.getKey() == GLFW.GLFW_KEY_F4 && event.getAction() == GLFW.GLFW_PRESS)
+		{
+			LodConfig.CLIENT.debugging.debugMode.set(LodConfig.CLIENT.debugging.debugMode.get().getNext());
+		}
+		
+		if(LodConfig.CLIENT.debugging.enableDebugKeybindings.get()
+				&& event.getKey() == GLFW.GLFW_KEY_F6 && event.getAction() == GLFW.GLFW_PRESS)
+		{
+			LodConfig.CLIENT.graphics.drawLods.set(!LodConfig.CLIENT.graphics.drawLods.get());
+		}
+	}
+	
+	//============//
+	// LOD events //
+	//============//
+	
+	/**
+	 * Re-centers the given LodDimension if it needs to be.
+	 */
+	private void playerMoveEvent(LodDimension lodDim)
+	{
+		// make sure the dimension is centered
+		RegionPos playerRegionPos = new RegionPos(mc.getPlayer().blockPosition());
+		RegionPos worldRegionOffset = new RegionPos(playerRegionPos.x - lodDim.getCenterRegionPosX(), playerRegionPos.z - lodDim.getCenterRegionPosZ());
+		if (worldRegionOffset.x != 0 || worldRegionOffset.z != 0)
+		{
+			lodWorld.saveAllDimensions();
+			lodDim.move(worldRegionOffset);
+			//LOGGER.info("offset: " + worldRegionOffset.x + "," + worldRegionOffset.z + "\t center: " + lodDim.getCenterX() + "," + lodDim.getCenterZ());
+		}
+	}
+	
+	
+	/**
+	 * Re-sizes all LodDimensions if they needs to be.
+	 */
+	private void viewDistanceChangedEvent()
+	{
+		// calculate how wide the dimension(s) should be in regions
+		int chunksWide = LodConfig.CLIENT.graphics.lodChunkRenderDistance.get() * 2 + 1;
+		int newWidth = (int) Math.ceil(chunksWide / (float) LodUtil.REGION_WIDTH_IN_CHUNKS);
+		newWidth = (newWidth % 2 == 0) ? (newWidth += 1) : (newWidth += 2); // make sure we have a odd number of regions
+		
+		// do the dimensions need to change in size?
+		if (lodBuilder.defaultDimensionWidthInRegions != newWidth || recalculateWidths)
+		{
+			lodWorld.saveAllDimensions();
+			
+			// update the dimensions to fit the new width
+			lodWorld.resizeDimensionRegionWidth(newWidth);
+			lodBuilder.defaultDimensionWidthInRegions = newWidth;
+			renderer.setupBuffers(lodWorld.getLodDimension(mc.getClientWorld().dimensionType()));
+			
+			recalculateWidths = false;
+			//LOGGER.info("new dimension width in regions: " + newWidth + "\t potential: " + newWidth );
+		}
+		DetailDistanceUtil.updateSettings();
+	}
+	
+	
+	/**
+	 * This event is called once during the first frame Minecraft renders in the world.
+	 */
+	public void firstFrameSetup()
+	{
+		// make sure the GlProxy is created before the LodBufferBuilder
+		GlProxy.getInstance();
+		
+		// TODO shouldn't these already be empty?
+		ThreadMapUtil.clearMaps();
+		
+		firstTimeSetupComplete = true;
+	}
+	
+	//================//
+	// public getters //
+	//================//
+	
+	public static LodWorld getLodWorld()
+	{
+		return lodWorld;
+	}
+	
+	public static LodBuilder getLodBuilder()
+	{
+		return lodBuilder;
+	}
+	
+	public static LodRenderer getRenderer()
+	{
+		return renderer;
+	}
+}
@@ -0,0 +1,188 @@
+package com.seibel.lod.proxy;
+
+import org.lwjgl.opengl.GL;
+import org.lwjgl.opengl.GLCapabilities;
+import org.lwjgl.opengl.WGL;
+
+import com.mojang.blaze3d.systems.RenderSystem;
+
+/**
+ * A singleton that holds references to different openGL contexts
+ * and GPU capabilities.
+ * 
+ * <p>
+ * Helpful OpenGL resources: <br><br>
+ * 
+ * https://www.seas.upenn.edu/~pcozzi/OpenGLInsights/OpenGLInsights-AsynchronousBufferTransfers.pdf <br>
+ * https://learnopengl.com/Advanced-OpenGL/Advanced-Data <br>
+ * https://gamedev.stackexchange.com/questions/91995/edit-vbo-data-or-create-a-new-one <br><br>
+ * 
+ * 
+ * @author James Seibel
+ * @version 9-15-2021
+ */
+public class GlProxy
+{
+	private static GlProxy instance = null;
+	
+	public final long deviceContext;
+	
+	public long minecraftGlContext;
+	public GLCapabilities minecraftGlCapabilities;
+	
+	public long lodBuilderGlContext;
+	public GLCapabilities lodBuilderGlCapabilities;
+	/** This is just used for debugging, hopefuly it can be removed once 
+	 * the context switching is more stable. */
+	public Thread lodBuilderOwnerThread = null;
+	
+	/**
+	 * Does this computer's GPU support fancy fog?
+	 */
+	public final boolean fancyFogAvailable;
+	
+	
+	
+	private GlProxy()
+	{
+		// getting Minecraft's context has to be done on the render thread,
+		// where the GL context is
+		if (!RenderSystem.isOnRenderThread())
+			throw new IllegalStateException(GlProxy.class.getSimpleName() + " was created outside the render thread!");
+		
+		
+		
+		
+		//============================//
+		// create the builder context //
+		//============================//
+		
+		minecraftGlContext = WGL.wglGetCurrentContext();
+		minecraftGlCapabilities = GL.getCapabilities();
+		deviceContext = WGL.wglGetCurrentDC();
+		
+		lodBuilderGlContext = WGL.wglCreateContext(deviceContext);
+		if (!WGL.wglShareLists(minecraftGlContext, lodBuilderGlContext))
+			throw new IllegalStateException("Unable to share lists between Minecraft and builder contexts.");
+		if (!WGL.wglMakeCurrent(deviceContext, lodBuilderGlContext))
+			throw new IllegalStateException("Unable to change OpenGL contexts! tried to change to [" + GlProxyContext.LOD_BUILDER.toString() + "] from [" + GlProxyContext.MINECRAFT.toString() + "]");
+		lodBuilderGlCapabilities = GL.createCapabilities();
+		WGL.wglMakeCurrent(deviceContext, 0L);
+		
+		
+		// Since this is called on the render thread, make sure the Minecraft context is used in the end
+		WGL.wglMakeCurrent(deviceContext, minecraftGlContext);
+		
+		
+		
+		
+		//==================================//
+		// get any GPU related capabilities //
+		//==================================//
+		
+		// see if this GPU can run fancy fog
+		fancyFogAvailable = GL.getCapabilities().GL_NV_fog_distance;
+
+		if (!fancyFogAvailable)
+		{
+			ClientProxy.LOGGER.info("This GPU does not support GL_NV_fog_distance. This means that the fancy fog option will not be available.");
+		}
+	}
+	
+	
+	/**
+	 * A simple wrapper function to make switching contexts easier
+	 * 
+	 * @throws IllegalStateException if unable to change to newContext. <br>
+	 * 								 This expection should never be thrown if 
+	 * 								 switching to GlProxyContext.NONE
+	 */
+	public void setGlContext(GlProxyContext newContext)
+	{
+		GlProxyContext currentContext = getGlContext();
+		
+		// we don't have to change the context, we're already there.
+		if (currentContext == newContext)
+			return;
+		
+		
+		long contextPointer = 0L;
+		GLCapabilities newGlCapabilities = null;
+		switch(newContext)
+		{
+		case LOD_BUILDER:
+			contextPointer = lodBuilderGlContext;
+			newGlCapabilities = lodBuilderGlCapabilities;
+			break;
+		case MINECRAFT:
+			contextPointer = minecraftGlContext;
+			newGlCapabilities = minecraftGlCapabilities;
+			break;
+		case NONE:
+			contextPointer = 0L; // equivalent to null
+			newGlCapabilities = null;
+			break;
+			
+		default:
+			// should never happen, here to make the compiler happy
+		}
+		
+		if (!WGL.wglMakeCurrent(deviceContext, contextPointer))
+			throw new IllegalStateException("Unable to change OpenGL contexts! tried to change to [" + newContext.toString() + "] from [" + currentContext.toString() + "] on thread: [" + Thread.currentThread().getName() + "] lod builder owner thread: " + (lodBuilderOwnerThread != null ? lodBuilderOwnerThread.getName() : "null"));
+		
+		if (newContext == GlProxyContext.LOD_BUILDER)
+		{
+			lodBuilderOwnerThread = Thread.currentThread();
+		}
+		else if (newContext == GlProxyContext.NONE && currentContext == GlProxyContext.LOD_BUILDER)
+		{
+			lodBuilderOwnerThread = null;
+		}
+		
+		GL.setCapabilities(newGlCapabilities);
+	}
+	
+	/**
+	 * Returns this thread's OpenGL context.
+	 */
+	public GlProxyContext getGlContext()
+	{
+		long currentContext = WGL.wglGetCurrentContext();
+		if(currentContext == lodBuilderGlContext)
+		{
+			return GlProxyContext.LOD_BUILDER;
+		}
+		else if(currentContext == minecraftGlContext)
+		{
+			return GlProxyContext.MINECRAFT;
+		}
+		else 
+		{
+			return GlProxyContext.NONE;
+		}
+	}
+	
+	/** Minecraft, Alpha, Beta, None */
+	public enum GlProxyContext
+	{
+		MINECRAFT,
+		LOD_BUILDER,
+		
+		/** used to un-bind threads */
+		NONE,
+	}
+	
+	public static GlProxy getInstance()
+	{
+		try
+		{
+			if (instance == null)
+				instance = new GlProxy();
+		}catch (Exception e)
+		{
+			e.printStackTrace();
+		}
+		
+		return instance;
+	}
+}
@@ -0,0 +1,887 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.render;
+
+import java.util.HashSet;
+
+import org.lwjgl.opengl.GL11;
+import org.lwjgl.opengl.GL15;
+import org.lwjgl.opengl.GL15C;
+import org.lwjgl.opengl.NVFogDistance;
+
+import com.mojang.blaze3d.matrix.MatrixStack;
+import com.mojang.blaze3d.platform.GlStateManager;
+import com.mojang.blaze3d.systems.RenderSystem;
+import com.seibel.lod.builders.LodBufferBuilder;
+import com.seibel.lod.builders.LodBufferBuilder.VertexBuffersAndOffset;
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DebugMode;
+import com.seibel.lod.enums.DetailDropOff;
+import com.seibel.lod.enums.FogDistance;
+import com.seibel.lod.enums.FogDrawOverride;
+import com.seibel.lod.enums.FogQuality;
+import com.seibel.lod.handlers.ReflectionHandler;
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.objects.NearFarFogSettings;
+import com.seibel.lod.objects.RegionPos;
+import com.seibel.lod.proxy.ClientProxy;
+import com.seibel.lod.proxy.GlProxy;
+import com.seibel.lod.util.DetailDistanceUtil;
+import com.seibel.lod.util.LevelPosUtil;
+import com.seibel.lod.util.LodUtil;
+import com.seibel.lod.wrappers.MinecraftWrapper;
+
+import net.minecraft.client.renderer.ActiveRenderInfo;
+import net.minecraft.client.renderer.FogRenderer;
+import net.minecraft.client.renderer.GameRenderer;
+import net.minecraft.client.renderer.texture.NativeImage;
+import net.minecraft.client.renderer.vertex.DefaultVertexFormats;
+import net.minecraft.client.renderer.vertex.VertexBuffer;
+import net.minecraft.client.renderer.vertex.VertexFormat;
+import net.minecraft.profiler.IProfiler;
+import net.minecraft.util.math.BlockPos;
+import net.minecraft.util.math.ChunkPos;
+import net.minecraft.util.math.vector.Matrix4f;
+import net.minecraft.util.math.vector.Vector3d;
+
+
+/**
+ * This is where all the magic happens. <br>
+ * This is where LODs are draw to the world.
+ *
+ * @author James Seibel
+ * @version 9-28-2021
+ */
+public class LodRenderer
+{
+	/**
+	 * this is the light used when rendering the LODs,
+	 * it should be something different than what is used by Minecraft
+	 */
+	private static final int LOD_GL_LIGHT_NUMBER = GL11.GL_LIGHT2;
+	
+	/**
+	 * If true the LODs colors will be replaced with
+	 * a checkerboard, this can be used for debugging.
+	 */
+	public DebugMode previousDebugMode = DebugMode.OFF;
+
+	private MinecraftWrapper mc;
+	private GameRenderer gameRender;
+	private IProfiler profiler;
+	private int farPlaneBlockDistance;
+
+
+	/**
+	 * This is used to generate the buildable buffers
+	 */
+	private LodBufferBuilder lodBufferBuilder;
+
+	/**
+	 * Each VertexBuffer represents 1 region
+	 */
+	private VertexBuffer[][] vbos;
+	public static final VertexFormat LOD_VERTEX_FORMAT = DefaultVertexFormats.POSITION_COLOR;
+	private ChunkPos vbosCenter = new ChunkPos(0,0);
+
+	/**
+	 * This is used to determine if the LODs should be regenerated
+	 */
+	private int[] previousPos = new int[]{0,0,0};
+	
+	public NativeImage lightMap = null;
+	
+	// these variables are used to determine if the buffers should be rebuilt
+	private long prevDayTime = 0;
+	private double prevBrightness = 0;
+	private int prevRenderDistance = 0;
+	private long prevPlayerPosTime = 0;
+	private long prevVanillaChunkTime = 0;
+	private long prevChunkTime = 0;
+
+
+	/**
+	 * This is used to determine if the LODs should be regenerated
+	 */
+	private FogDistance prevFogDistance = FogDistance.NEAR_AND_FAR;
+
+	/**
+	 * if this is true the LOD buffers should be regenerated,
+	 * provided they aren't already being regenerated.
+	 */
+	private volatile boolean partialRegen = false;
+	private volatile boolean fullRegen = true;
+
+	/**
+	 * This HashSet contains every chunk that Vanilla Minecraft
+	 * is going to render
+	 */
+	public boolean[][] vanillaRenderedChunks;
+	public boolean vanillaRenderedChunksChanged;
+
+
+	public LodRenderer(LodBufferBuilder newLodNodeBufferBuilder)
+	{
+		mc = MinecraftWrapper.INSTANCE;
+		gameRender = mc.getGameRenderer();
+
+		lodBufferBuilder = newLodNodeBufferBuilder;
+	}
+
+
+	/**
+	 * Besides drawing the LODs this method also starts
+	 * the async process of generating the Buffers that hold those LODs.
+	 *
+	 * @param lodDim       The dimension to draw, if null doesn't replace the current dimension.
+	 * @param mcMatrixStack This matrix stack should come straight from MC's renderChunkLayer (or future equivalent) method
+	 * @param partialTicks how far into the current tick this method was called.
+	 */
+	public void drawLODs(LodDimension lodDim, MatrixStack mcMatrixStack, float partialTicks, IProfiler newProfiler)
+	{
+		if (lodDim == null)
+		{
+			// if there aren't any loaded LodChunks
+			// don't try drawing anything
+			return;
+		}
+
+
+		//===============//
+		// initial setup //
+		//===============//
+
+		profiler = newProfiler;
+		profiler.push("LOD setup");
+		
+		
+		// TODO move the buffer regeneration logic into its own class (probably called in the client proxy instead)
+		// starting here...
+		determineIfLodsShouldRegenerate(lodDim);
+
+		//=================//
+		// create the LODs //
+		//=================//
+
+		// only regenerate the LODs if:
+		// 1. we want to regenerate LODs
+		// 2. we aren't already regenerating the LODs
+		// 3. we aren't waiting for the build and draw buffers to swap
+		//		(this is to prevent thread conflicts)
+		if ((partialRegen || fullRegen) && !lodBufferBuilder.generatingBuffers && !lodBufferBuilder.newBuffersAvaliable())
+		{
+			// generate the LODs on a separate thread to prevent stuttering or freezing
+			lodBufferBuilder.generateLodBuffersAsync(this, lodDim, mc.getPlayer().blockPosition(), true);
+
+			// the regen process has been started,
+			// it will be done when lodBufferBuilder.newBuffersAvaliable()
+			// is true
+			fullRegen = false;
+			partialRegen = false;
+		}
+
+		// TODO move the buffer regeneration logic into its own class (probably called in the client proxy instead)
+		// ...ending here
+		
+		if (lodBufferBuilder.newBuffersAvaliable())
+		{
+			swapBuffers();
+		}
+		
+
+
+		//===========================//
+		// GL settings for rendering //
+		//===========================//
+
+		// set the required open GL settings
+		
+		if (LodConfig.CLIENT.debugging.debugMode.get() == DebugMode.SHOW_DETAIL_WIREFRAME)
+			GL11.glPolygonMode(GL11.GL_FRONT_AND_BACK, GL11.GL_LINE);
+		else
+			GL11.glPolygonMode(GL11.GL_FRONT_AND_BACK, GL11.GL_FILL);
+
+		GL11.glDisable(GL11.GL_TEXTURE_2D);
+		GL11.glEnable(GL11.GL_CULL_FACE);
+		GL11.glEnable(GL11.GL_COLOR_MATERIAL);
+		GL11.glEnable(GL11.GL_DEPTH_TEST);
+
+		// disable the lights Minecraft uses
+		GL11.glDisable(GL11.GL_LIGHT0);
+		GL11.glDisable(GL11.GL_LIGHT1);
+
+		// get the default projection matrix so we can
+		// reset it after drawing the LODs
+		float[] mcProjMatrixRaw = new float[16];
+		GL11.glGetFloatv(GL11.GL_PROJECTION_MATRIX, mcProjMatrixRaw);
+		Matrix4f mcProjectionMatrix = new Matrix4f(mcProjMatrixRaw);
+		// OpenGl outputs their matricies in col,row form instead of row,col
+		// (or maybe vice versa I have no idea :P)
+		mcProjectionMatrix.transpose();
+		
+		Matrix4f modelViewMatrix = offsetTheModelViewMatrix(mcMatrixStack, partialTicks);
+
+		// required for setupFog and setupProjectionMatrix
+		farPlaneBlockDistance = LodConfig.CLIENT.graphics.lodChunkRenderDistance.get() * LodUtil.CHUNK_WIDTH;
+
+		setupProjectionMatrix(mcProjectionMatrix, partialTicks);
+		// commented out until we can add shaders to handle lighting
+		//setupLighting(lodDim, partialTicks);
+
+		NearFarFogSettings fogSettings = determineFogSettings();
+
+		// determine the current fog settings so they can be
+		// reset after drawing the LODs
+		float defaultFogStartDist = GL11.glGetFloat(GL11.GL_FOG_START);
+		float defaultFogEndDist = GL11.glGetFloat(GL11.GL_FOG_END);
+		int defaultFogMode = GL11.glGetInteger(GL11.GL_FOG_MODE);
+		int defaultFogDistance = GL11.glGetInteger(NVFogDistance.GL_FOG_DISTANCE_MODE_NV);
+
+
+		//===========//
+		// rendering //
+		//===========//
+		
+		profiler.popPush("LOD draw");
+		
+		if (vbos != null)
+		{
+			ActiveRenderInfo renderInfo = mc.getGameRenderer().getMainCamera();
+			Vector3d cameraDir = new Vector3d(renderInfo.getLookVector());
+			
+			boolean cullingDisabled = LodConfig.CLIENT.graphics.disableDirectionalCulling.get();
+			
+			// used to determine what type of fog to render
+			int halfWidth = vbos.length / 2;
+			int quarterWidth = vbos.length / 4;
+
+			for (int i = 0; i < vbos.length; i++)
+			{
+				for (int j = 0; j < vbos.length; j++)
+				{
+					RegionPos vboPos = new RegionPos(i + lodDim.getCenterRegionPosX() - lodDim.getWidth() / 2, j + lodDim.getCenterRegionPosZ() - lodDim.getWidth() / 2);
+					if (cullingDisabled || RenderUtil.isRegionInViewFrustum(renderInfo.getBlockPosition(), cameraDir, vboPos.blockPos()))
+					{
+						if ((i > halfWidth - quarterWidth && i < halfWidth + quarterWidth) && (j > halfWidth - quarterWidth && j < halfWidth + quarterWidth))
+							setupFog(fogSettings.near.distance, fogSettings.near.quality);
+						else
+							setupFog(fogSettings.far.distance, fogSettings.far.quality);
+
+
+						sendLodsToGpuAndDraw(vbos[i][j], modelViewMatrix);
+					}
+				}
+			}
+		}
+		
+
+		//=========//
+		// cleanup //
+		//=========//
+
+		profiler.popPush("LOD cleanup");
+
+		GL11.glPolygonMode(GL11.GL_FRONT_AND_BACK, GL11.GL_FILL);
+		GL11.glEnable(GL11.GL_TEXTURE_2D);
+		GL11.glDisable(LOD_GL_LIGHT_NUMBER);
+		// re-enable the lights Minecraft uses
+		GL11.glEnable(GL11.GL_LIGHT0);
+		GL11.glEnable(GL11.GL_LIGHT1);
+		RenderSystem.disableLighting();
+
+		// reset the fog settings so the normal chunks
+		// will be drawn correctly
+		cleanupFog(fogSettings, defaultFogStartDist, defaultFogEndDist, defaultFogMode, defaultFogDistance);
+
+		// reset the projection matrix so anything drawn after
+		// the LODs will use the correct projection matrix
+		gameRender.resetProjectionMatrix(mcProjectionMatrix);
+		
+		// clear the depth buffer so anything drawn is drawn
+		// over the LODs
+		GL11.glClear(GL11.GL_DEPTH_BUFFER_BIT);
+		
+
+		// end of internal LOD profiling
+		profiler.pop();
+	}
+
+
+	/**
+	 * This is where the actual drawing happens.
+	 */
+	private void sendLodsToGpuAndDraw(VertexBuffer vbo, Matrix4f modelViewMatrix)
+	{
+		if (vbo == null)
+			return;
+		
+		GL15C.glBindBuffer(GL15.GL_ARRAY_BUFFER, vbo.id);
+		// 0L is the starting pointer
+		LOD_VERTEX_FORMAT.setupBufferState(0L);
+		
+		vbo.draw(modelViewMatrix, GL11.GL_QUADS);
+		
+		GL15C.glBindBuffer(GL15.GL_ARRAY_BUFFER, 0);
+		LOD_VERTEX_FORMAT.clearBufferState();
+	}
+
+
+	//=================//
+	// Setup Functions //
+	//=================//
+
+	@SuppressWarnings("deprecation")
+	private void setupFog(FogDistance fogDistance, FogQuality fogQuality)
+	{
+		if (fogQuality == FogQuality.OFF)
+		{
+			FogRenderer.setupNoFog();
+			RenderSystem.disableFog();
+			return;
+		}
+
+		if (fogDistance == FogDistance.NEAR_AND_FAR)
+		{
+			throw new IllegalArgumentException("setupFog doesn't accept the NEAR_AND_FAR fog distance.");
+		}
+
+		// determine the fog distance mode to use
+		int glFogDistanceMode;
+		if (fogQuality == FogQuality.FANCY)
+		{
+			// fancy fog (fragment distance based fog)
+			glFogDistanceMode = NVFogDistance.GL_EYE_RADIAL_NV;
+		}
+		else
+		{
+			// fast fog (frustum distance based fog)
+			glFogDistanceMode = NVFogDistance.GL_EYE_PLANE_ABSOLUTE_NV;
+		}
+
+		// the multipliers are percentages
+		// of the regular view distance.
+		if (fogDistance == FogDistance.FAR)
+		{
+			// the reason that I wrote fogEnd then fogStart backwards
+			// is because we are using fog backwards to how
+			// it is normally used, with it hiding near objects
+			// instead of far objects.
+
+			if (fogQuality == FogQuality.FANCY)
+			{
+				// for more realistic fog when using FAR
+				if(LodConfig.CLIENT.graphics.fogDistance.get() == FogDistance.NEAR_AND_FAR)
+				{
+					RenderSystem.fogStart(farPlaneBlockDistance * 0.9f);
+					RenderSystem.fogEnd(farPlaneBlockDistance * 1.0f);
+				}else{
+					RenderSystem.fogStart(farPlaneBlockDistance * 0.1f);
+					RenderSystem.fogEnd(farPlaneBlockDistance * 1.0f);
+				}
+			}
+			else if (fogQuality == FogQuality.FAST)
+			{
+				// for the far fog of the normal chunks
+				// to start right where the LODs' end use:
+				// end = 0.8f, start = 1.5f
+				RenderSystem.fogStart(farPlaneBlockDistance * 1.5f);
+				RenderSystem.fogEnd(farPlaneBlockDistance * 2.0f);
+			}
+		}
+		else if (fogDistance == FogDistance.NEAR)
+		{
+			if (fogQuality == FogQuality.FANCY)
+			{
+				RenderSystem.fogEnd(mc.getRenderDistance() * 16 * 1.41f);
+				RenderSystem.fogStart(mc.getRenderDistance() * 16 * 1.6f);
+			}
+			else if (fogQuality == FogQuality.FAST)
+			{
+				RenderSystem.fogEnd(mc.getRenderDistance() * 16 * 1.0f);
+				RenderSystem.fogStart(mc.getRenderDistance() * 16 * 1.5f);
+			}
+		}
+
+		GL11.glEnable(GL11.GL_FOG);
+		RenderSystem.enableFog();
+		RenderSystem.setupNvFogDistance();
+		RenderSystem.fogMode(GlStateManager.FogMode.LINEAR);
+		GL11.glFogi(NVFogDistance.GL_FOG_DISTANCE_MODE_NV, glFogDistanceMode);
+	}
+
+	/**
+	 * Revert any changes that were made to the fog.
+	 */
+	private void cleanupFog(NearFarFogSettings fogSettings,
+	                        float defaultFogStartDist, float defaultFogEndDist,
+	                        int defaultFogMode, int defaultFogDistance)
+	{
+		RenderSystem.fogStart(defaultFogStartDist);
+		RenderSystem.fogEnd(defaultFogEndDist);
+		RenderSystem.fogMode(defaultFogMode);
+		GL11.glFogi(NVFogDistance.GL_FOG_DISTANCE_MODE_NV, defaultFogDistance);
+
+		// disable fog if Minecraft wasn't rendering fog
+		// but we were
+		if (!fogSettings.vanillaIsRenderingFog &&
+				    (fogSettings.near.quality != FogQuality.OFF ||
+						     fogSettings.far.quality != FogQuality.OFF))
+		{
+			GL11.glDisable(GL11.GL_FOG);
+		}
+	}
+
+
+	/**
+	 * Translate the camera relative to the LodDimension's center,
+	 * this is done since all LOD buffers are created in world space
+	 * instead of object space.
+	 * (since AxisAlignedBoundingBoxes (LODs) use doubles and thus have a higher
+	 * accuracy vs the model view matrix, which only uses floats)
+	 */
+	private Matrix4f offsetTheModelViewMatrix(MatrixStack mcMatrixStack, float partialTicks)
+	{
+		// duplicate the last matrix
+		mcMatrixStack.pushPose();
+		
+		
+		// get all relevant camera info
+		ActiveRenderInfo renderInfo = mc.getGameRenderer().getMainCamera();
+		Vector3d projectedView = renderInfo.getPosition();
+		
+		// translate the camera relative to the regions' center
+		// (AxisAlignedBoundingBoxes (LODs) use doubles and thus have a higher
+		// accuracy vs the model view matrix, which only uses floats)
+		BlockPos bufferPos = vbosCenter.getWorldPosition();
+		Vector3d eyePos = mc.getPlayer().getEyePosition(partialTicks);
+		double xDiff = eyePos.x - bufferPos.getX();
+		double zDiff = eyePos.z - bufferPos.getZ();
+		mcMatrixStack.translate(-xDiff, -projectedView.y, -zDiff);
+		
+		
+		// get the modified model view matrix
+		Matrix4f lodModelViewMatrix = mcMatrixStack.last().pose(); 
+		// remove the lod ModelViewMatrix
+		mcMatrixStack.popPose();
+		
+		return lodModelViewMatrix;
+	}
+
+
+	/** James added this to test if Vivecraft is not using
+	 * the MC FOV setting or if the problem is deeper */
+	public enum FovTest
+	{
+		LOD_USE_FOV(true, false),
+		MC_USE_FOV(false, true),
+		NEITHER(false, false),
+		BOTH(true, true);
+		
+		boolean lodProjUseFov;
+		boolean defaultMcProjUseFov;
+		
+		private FovTest(boolean newLodProjUseFov, boolean newDefaultMcProjUseFov)
+		{
+			lodProjUseFov = newLodProjUseFov;
+			defaultMcProjUseFov = newDefaultMcProjUseFov;
+		}
+	}
+	
+	/**
+	 * create a new projection matrix and send it over to the GPU
+	 * 
+	 * @param currentProjectionMatrix this is Minecraft's current projection matrix
+	 * @param partialTicks how many ticks into the frame we are
+	 */
+	private void setupProjectionMatrix(Matrix4f currentProjectionMatrix, float partialTicks)
+	{
+		// create the new projection matrix
+		Matrix4f lodPoj =
+			Matrix4f.perspective(
+					getFov(partialTicks, LodConfig.CLIENT.graphics.useFovSetting.get().lodProjUseFov),
+					(float) this.mc.getWindow().getScreenWidth() / (float) this.mc.getWindow().getScreenHeight(),
+					mc.getRenderDistance()/2,
+					farPlaneBlockDistance * LodUtil.CHUNK_WIDTH * 2 / 4);
+		
+		// get Minecraft's un-edited projection matrix
+		// (this is before it is zoomed, distorted, etc.)
+		Matrix4f defaultMcProj = mc.getGameRenderer().getProjectionMatrix(mc.getGameRenderer().getMainCamera(), partialTicks, LodConfig.CLIENT.graphics.useFovSetting.get().defaultMcProjUseFov);
+		// true here means use "use fov setting" (probably)
+		
+		
+		// this logic strips away the defaultMcProj matrix so we 
+		// can get the distortionMatrix, which represents all
+		// transformations, zooming, distortions, etc. done
+		// to Minecraft's Projection matrix
+		Matrix4f defaultMcProjInv = defaultMcProj.copy();
+		defaultMcProjInv.invert();
+		
+		Matrix4f distortionMatrix = defaultMcProjInv.copy();
+		distortionMatrix.multiply(currentProjectionMatrix);
+		
+		
+		// edit the lod projection to match Minecraft's
+		// (so the LODs line up with the real world)
+		lodPoj.multiply(distortionMatrix);
+		
+		// send the projection over to the GPU
+		gameRender.resetProjectionMatrix(lodPoj);
+	}
+
+
+	/**
+	 * setup the lighting to be used for the LODs
+	 */
+	/*private void setupLighting(LodDimension lodDimension, float partialTicks)
+	{
+		// Determine if the player has night vision
+		boolean playerHasNightVision = false;
+		if (this.mc.getPlayer() != null)
+		{
+			Iterator<EffectInstance> iterator = this.mc.getPlayer().getActiveEffects().iterator();
+			while (iterator.hasNext())
+			{
+				EffectInstance instance = iterator.next();
+				if (instance.getEffect() == Effects.NIGHT_VISION)
+				{
+					playerHasNightVision = true;
+					break;
+				}
+			}
+		}
+
+		float sunBrightness = lodDimension.dimension.hasSkyLight() ? mc.getSkyDarken(partialTicks) : 0.2f;
+		sunBrightness = playerHasNightVision ? 1.0f : sunBrightness;
+		float gamma = (float) mc.getOptions().gamma - 0.0f;
+		float dayEffect = (sunBrightness - 0.2f) * 1.25f;
+		float lightStrength = (gamma * 0.34f - 0.01f) * (1.0f - dayEffect) + dayEffect - 0.20f; //gamma * 0.2980392157f + 0.1647058824f
+		float blueLightStrength = (gamma * 0.44f + 0.12f) * (1.0f - dayEffect) + dayEffect - 0.20f; //gamma * 0.4235294118f + 0.2784313725f
+
+		float[] lightAmbient = {lightStrength, lightStrength, blueLightStrength, 1.0f};
+
+
+		// can be used for debugging
+		//		if (partialTicks < 0.005)
+		//			ClientProxy.LOGGER.debug(lightStrength);
+
+		ByteBuffer temp = ByteBuffer.allocateDirect(16);
+		temp.order(ByteOrder.nativeOrder());
+		GL11.glLightfv(LOD_GL_LIGHT_NUMBER, GL11.GL_AMBIENT, (FloatBuffer) temp.asFloatBuffer().put(lightAmbient).flip());
+		GL11.glEnable(LOD_GL_LIGHT_NUMBER); // Enable the above lighting
+
+		RenderSystem.enableLighting();
+	}*/
+
+	/**
+	 * Create all buffers that will be used.
+	 */
+	public void setupBuffers(LodDimension lodDim)
+	{
+		lodBufferBuilder.setupBuffers(lodDim);
+	}
+
+
+	//======================//
+	// Other Misc Functions //
+	//======================//
+
+	/**
+	 * If this is called then the next time "drawLODs" is called
+	 * the LODs will be regenerated; the same as if the player moved.
+	 */
+	public void regenerateLODsNextFrame()
+	{
+		fullRegen = true;
+	}
+
+
+	/**
+	 * Replace the current Vertex Buffers with the newly
+	 * created buffers from the lodBufferBuilder. <br><br>
+	 *
+	 * For some reason this has to be called after the frame has been rendered,
+	 * otherwise visual stuttering/rubber banding may happen. I'm not sure why...
+	 */
+	private void swapBuffers()
+	{
+		// replace the drawable buffers with
+		// the newly created buffers from the lodBufferBuilder
+		VertexBuffersAndOffset result = lodBufferBuilder.getVertexBuffers();
+		vbos = result.vbos;
+		vbosCenter = result.drawableCenterChunkPos;
+	}
+
+	/**
+	 * Calls the BufferBuilder's destroyBuffers method.
+	 */
+	public void destroyBuffers()
+	{
+		lodBufferBuilder.destroyBuffers();
+	}
+
+
+	private double getFov(float partialTicks, boolean useFovSetting)
+	{
+		return mc.getGameRenderer().getFov(mc.getGameRenderer().getMainCamera(), partialTicks, useFovSetting);
+	}
+
+
+	/**
+	 * Return what fog settings should be used when rendering.
+	 */
+	private NearFarFogSettings determineFogSettings()
+	{
+		NearFarFogSettings fogSettings = new NearFarFogSettings();
+
+
+		FogQuality quality = ReflectionHandler.INSTANCE.getFogQuality();
+		FogDrawOverride override = LodConfig.CLIENT.graphics.fogDrawOverride.get();
+
+
+		fogSettings.vanillaIsRenderingFog = quality != FogQuality.OFF;
+
+
+		// use any fog overrides the user may have set
+		switch (override)
+		{
+			case ALWAYS_DRAW_FOG_FANCY:
+				quality = FogQuality.FANCY;
+				break;
+
+			case NEVER_DRAW_FOG:
+				quality = FogQuality.OFF;
+				break;
+
+			case ALWAYS_DRAW_FOG_FAST:
+				quality = FogQuality.FAST;
+				break;
+
+			case USE_OPTIFINE_FOG_SETTING:
+				// don't override anything
+				break;
+		}
+
+
+		// only use fancy fog if the user's GPU can deliver
+		if (!GlProxy.getInstance().fancyFogAvailable && quality == FogQuality.FANCY)
+		{
+			quality = FogQuality.FAST;
+		}
+
+
+		// how different distances are drawn depends on the quality set
+		switch (quality)
+		{
+			case FANCY:
+				fogSettings.near.quality = FogQuality.FANCY;
+				fogSettings.far.quality = FogQuality.FANCY;
+
+				switch (LodConfig.CLIENT.graphics.fogDistance.get())
+				{
+					case NEAR_AND_FAR:
+						fogSettings.near.distance = FogDistance.NEAR;
+						fogSettings.far.distance = FogDistance.FAR;
+						break;
+
+					case NEAR:
+						fogSettings.near.distance = FogDistance.NEAR;
+						fogSettings.far.distance = FogDistance.NEAR;
+						break;
+
+					case FAR:
+						fogSettings.near.distance = FogDistance.FAR;
+						fogSettings.far.distance = FogDistance.FAR;
+						break;
+				}
+				break;
+
+			case FAST:
+				fogSettings.near.quality = FogQuality.FAST;
+				fogSettings.far.quality = FogQuality.FAST;
+
+				// fast fog setting should only have one type of
+				// fog, since the LODs are separated into a near
+				// and far portion; and fast fog is rendered from the
+				// frustrum's perspective instead of the camera
+				switch (LodConfig.CLIENT.graphics.fogDistance.get())
+				{
+					case NEAR_AND_FAR:
+						fogSettings.near.distance = FogDistance.NEAR;
+						fogSettings.far.distance = FogDistance.NEAR;
+						break;
+
+					case NEAR:
+						fogSettings.near.distance = FogDistance.NEAR;
+						fogSettings.far.distance = FogDistance.NEAR;
+						break;
+
+					case FAR:
+						fogSettings.near.distance = FogDistance.FAR;
+						fogSettings.far.distance = FogDistance.FAR;
+						break;
+				}
+				break;
+
+			case OFF:
+
+				fogSettings.near.quality = FogQuality.OFF;
+				fogSettings.far.quality = FogQuality.OFF;
+				break;
+
+		}
+
+
+		return fogSettings;
+	}
+
+
+	/**
+	 * Determines if the LODs should have a fullRegen or partialRegen
+	 */
+	private void determineIfLodsShouldRegenerate(LodDimension lodDim)
+	{
+		short chunkRenderDistance = (short) mc.getRenderDistance();
+		
+		int vanillaRenderedChunksWidth = chunkRenderDistance*2+2;
+		vanillaRenderedChunks = new boolean[vanillaRenderedChunksWidth][vanillaRenderedChunksWidth];
+		
+		
+		
+		//=============//
+		// full regens //
+		//=============//
+		
+		// check if the view distance changed
+		if (ClientProxy.previousLodRenderDistance != LodConfig.CLIENT.graphics.lodChunkRenderDistance.get()
+				    ||  mc.getRenderDistance()  != prevRenderDistance
+				    || prevFogDistance != LodConfig.CLIENT.graphics.fogDistance.get())
+		{
+			DetailDistanceUtil.updateSettings();
+			fullRegen = true;
+			previousPos = LevelPosUtil.createLevelPos((byte) 4, mc.getPlayer().xChunk, mc.getPlayer().zChunk);
+			prevFogDistance = LodConfig.CLIENT.graphics.fogDistance.get();
+			prevRenderDistance = mc.getRenderDistance();
+		}
+
+		// did the user change the debug setting?
+		if (LodConfig.CLIENT.debugging.debugMode.get() != previousDebugMode)
+		{
+			previousDebugMode = LodConfig.CLIENT.debugging.debugMode.get();
+			fullRegen = true;
+		}
+
+
+		long newTime = System.currentTimeMillis();
+
+		if(LodConfig.CLIENT.graphics.detailDropOff.get() == DetailDropOff.FANCY)
+		{
+			// check if the player has moved
+			if (newTime - prevPlayerPosTime > LodConfig.CLIENT.buffers.bufferRebuildPlayerMoveTimeout.get())
+			{
+				if (LevelPosUtil.getDetailLevel(previousPos) == 0
+						    || mc.getPlayer().xChunk != LevelPosUtil.getPosX(previousPos)
+						    || mc.getPlayer().zChunk != LevelPosUtil.getPosZ(previousPos))
+				{
+					fullRegen = true;
+					previousPos = LevelPosUtil.createLevelPos((byte) 4, mc.getPlayer().xChunk, mc.getPlayer().zChunk);
+				}
+				prevPlayerPosTime = newTime;
+			}
+		}
+
+
+
+		//================//
+		// partial regens //
+		//================//
+
+
+		// check if the vanilla rendered chunks changed
+		if (newTime - prevVanillaChunkTime > LodConfig.CLIENT.buffers.bufferRebuildChunkChangeTimeout.get())
+		{
+			if (vanillaRenderedChunksChanged)
+			{
+				partialRegen = true;
+				vanillaRenderedChunksChanged = false;
+
+			}
+			prevVanillaChunkTime = newTime;
+		}
+
+
+		// check if there is any newly generated terrain to show
+		if (newTime - prevChunkTime > LodConfig.CLIENT.buffers.bufferRebuildLodChangeTimeout.get())
+		{
+			if (lodDim.regenDimensionBuffers)
+			{
+				partialRegen = true;
+				lodDim.regenDimensionBuffers = false;
+			}
+			prevChunkTime = newTime;
+		}
+
+		// check if the lighting has changed
+		if (mc.getClientWorld().getDayTime() - prevDayTime > 1000 || mc.getOptions().gamma != prevBrightness || lightMap == null)
+		{
+			fullRegen = true;
+			lightMap = mc.getCurrentLightMap();
+			prevBrightness = mc.getOptions().gamma;
+			prevDayTime = mc.getClientWorld().getDayTime();
+		}
+
+
+
+
+		//==============//
+		// LOD skipping //
+		//==============//
+
+		// determine which LODs should not be rendered close to the player
+		HashSet<ChunkPos> chunkPosToSkip = LodUtil.getNearbyLodChunkPosToSkip(lodDim, mc.getPlayer().blockPosition());
+		int xIndex;
+		int zIndex;
+		for (ChunkPos pos : chunkPosToSkip)
+		{
+			xIndex = (pos.x - mc.getPlayer().xChunk) + (chunkRenderDistance + 1);
+			zIndex = (pos.z - mc.getPlayer().zChunk) + (chunkRenderDistance + 1);
+			
+			// sometimes we are given chunks that are outside the render distance,
+			// This prevents index out of bounds exceptions
+			if (xIndex >= 0 && zIndex >= 0
+				&& xIndex < vanillaRenderedChunks.length 
+				&& zIndex < vanillaRenderedChunks.length)
+			{
+				if (!vanillaRenderedChunks[xIndex][zIndex])
+				{
+					vanillaRenderedChunks[xIndex][zIndex] = true;
+					vanillaRenderedChunksChanged = true;
+					lodDim.markRegionBufferToRegen(pos.getRegionX(), pos.getRegionZ());
+				}
+			}
+		}
+		
+		
+		// if the player is high enough, draw all LODs
+		if(chunkPosToSkip.isEmpty() && mc.getPlayer().position().y > 256)
+		{
+			vanillaRenderedChunks = new boolean[vanillaRenderedChunksWidth][vanillaRenderedChunksWidth];
+			vanillaRenderedChunksChanged = true;
+		}
+	}
+
+}
@@ -0,0 +1,152 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.render;
+
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.LodTemplate;
+import com.seibel.lod.objects.LodRegion;
+import com.seibel.lod.util.DetailDistanceUtil;
+import com.seibel.lod.util.LodUtil;
+import com.seibel.lod.wrappers.MinecraftWrapper;
+
+import net.minecraft.util.math.BlockPos;
+import net.minecraft.util.math.ChunkPos;
+import net.minecraft.util.math.vector.Vector3d;
+
+/**
+ * This holds miscellaneous helper code
+ * to be used in the rendering process.
+ * 
+ * @author James Seibel
+ * @version 8-21-2021
+ */
+public class RenderUtil
+{
+	private static final MinecraftWrapper mc = MinecraftWrapper.INSTANCE;
+	
+	
+	/**
+	 * Returns if the given ChunkPos is in the loaded area of the world.
+	 * @param centerCoordinate the center of the loaded world (probably the player's ChunkPos)
+	 */
+	public static boolean isChunkPosInLoadedArea(ChunkPos pos, ChunkPos center)
+	{
+		return (pos.x >= center.x - mc.getRenderDistance() 
+				&& pos.x <= center.x + mc.getRenderDistance()) 
+				&& 
+				(pos.z >= center.z - mc.getRenderDistance() 
+				&& pos.z <= center.z + mc.getRenderDistance());
+	}
+	
+	/**
+	 * Returns if the given coordinate is in the loaded area of the world.
+	 * @param centerCoordinate the center of the loaded world
+	 */
+	public static boolean isCoordinateInLoadedArea(int x, int z, int centerCoordinate)
+	{
+		return (x >= centerCoordinate - mc.getRenderDistance() 
+				&& x <= centerCoordinate + mc.getRenderDistance()) 
+				&& 
+				(z >= centerCoordinate - mc.getRenderDistance() 
+				&& z <= centerCoordinate + mc.getRenderDistance());
+	}
+	
+	
+	/**
+	 * Find the coordinates that are in the center half of the given
+	 * 2D matrix, starting at (0,0) and going to (2 * lodRadius, 2 * lodRadius).
+	 */
+	public static boolean isCoordinateInNearFogArea(int i, int j, int lodRadius)
+	{
+		int halfRadius = lodRadius / 2;
+		
+		return (i >= lodRadius - halfRadius 
+				&& i <= lodRadius + halfRadius) 
+				&& 
+				(j >= lodRadius - halfRadius
+				&& j <= lodRadius + halfRadius);
+	}
+	
+	
+	/**
+	 * Get how much buffer memory would be required for the given radius multiplier
+	 * 
+	 * issue #62
+	 * TODO check if this is actually returning the correct memory needed
+	 * it is possible (albeit unlikely) to have a buffer indexOutOfBounds exception
+	 * which is caused by the buffer not being big enough.
+	 */
+	public static int getBufferMemoryForRegion(LodRegion region)
+	{
+		// calculate the max amount of buffer memory needed (in bytes)
+		return region.getMinMemoryNeeded(LodConfig.CLIENT.graphics.lodTemplate.get());
+	}
+	
+	/**
+	 * Returns the maxViewDistanceMultiplier for the given LodTemplate
+	 * at the given LodDetail level.
+	 */
+	/*public static int getMaxRadiusMultiplierWithAvaliableMemory(LodTemplate lodTemplate, int detailLevel)
+	{
+		int maxNumberOfLods = LodRenderer.MAX_ALOCATEABLE_DIRECT_MEMORY / lodTemplate.getBufferMemoryForSingleLod();
+		int numbLodsWide = (int) Math.sqrt(maxNumberOfLods);
+		
+		return numbLodsWide / (2 * mc.getRenderDistance());
+	}*/
+	
+	
+	/**
+	 * Returns true if one of the region's 4 corners is in front
+	 * of the camera.
+	 */
+	public static boolean isRegionInViewFrustum(BlockPos playerBlockPos, Vector3d cameraDir, BlockPos vboCenterPos)
+	{
+    	// convert the vbo position into a direction vector
+    	// starting from the player's position
+		Vector3d vboVec = new Vector3d(vboCenterPos.getX(), 0, vboCenterPos.getZ());
+		Vector3d playerVec = new Vector3d(playerBlockPos.getX(), playerBlockPos.getY(), playerBlockPos.getZ());
+		Vector3d vboCenterVec = vboVec.subtract(playerVec);
+		
+		
+    	int halfRegionWidth = LodUtil.REGION_WIDTH / 2;
+    	
+    	// calculate the 4 corners
+    	Vector3d vboSeVec = new Vector3d(vboCenterVec.x + halfRegionWidth, vboCenterVec.y, vboCenterVec.z + halfRegionWidth);//.normalize();
+    	Vector3d vboSwVec = new Vector3d(vboCenterVec.x - halfRegionWidth, vboCenterVec.y, vboCenterVec.z + halfRegionWidth);//.normalize();
+    	Vector3d vboNwVec = new Vector3d(vboCenterVec.x - halfRegionWidth, vboCenterVec.y, vboCenterVec.z - halfRegionWidth);//.normalize();
+    	Vector3d vboNeVec = new Vector3d(vboCenterVec.x + halfRegionWidth, vboCenterVec.y, vboCenterVec.z - halfRegionWidth);//.normalize();
+    	
+    	// if any corner is visible, this region should be rendered
+    	return isNormalizedVectorInViewFrustum(vboSeVec, cameraDir) ||
+    			isNormalizedVectorInViewFrustum(vboSwVec, cameraDir) ||
+    			isNormalizedVectorInViewFrustum(vboNwVec, cameraDir) ||
+    			isNormalizedVectorInViewFrustum(vboNeVec, cameraDir);
+	}
+    
+	/**
+	 * Currently takes the dot product of the two vectors,
+	 * but in the future could do more complicated frustum culling tests.
+	 */
+    private static boolean isNormalizedVectorInViewFrustum(Vector3d objectVector, Vector3d cameraDir)
+	{
+    	// the -0.1 is to offer a slight buffer so we are
+    	// more likely to render LODs and thus, hopefully prevent
+    	// flickering or odd disappearences
+    	return objectVector.dot(cameraDir) > -0.1;
+	}
+}
@@ -0,0 +1,114 @@
+package com.seibel.lod.util;
+
+import java.awt.*;
+
+public class ColorUtil
+{
+	public static int rgbToInt(int red, int green, int blue)
+	{
+		return (0xFF << 24) | (red << 16) | (green << 8) | blue;
+	}
+
+	public static int rgbToInt(int alpha, int red, int green, int blue)
+	{
+		return (alpha << 24) | (red << 16) | (green << 8) | blue;
+	}
+
+	public static int getAlpha(int color)
+	{
+		return (color >> 24) & 0xFF;
+	}
+
+	public static int getRed(int color)
+	{
+		return (color >> 16) & 0xFF;
+	}
+
+	public static int getGreen(int color)
+	{
+		return (color >> 8) & 0xFF;
+	}
+
+	public static int getBlue(int color)
+	{
+		return color & 0xFF;
+	}
+
+	public static int applyShade(int color, int shade)
+	{
+		if (shade < 0)
+		{
+			return (getAlpha(color) << 24) | (Math.max(getRed(color) + shade, 0) << 16) | (Math.max(getGreen(color) + shade, 0) << 8) | Math.max(getBlue(color) + shade, 0);
+		} else
+		{
+			return (getAlpha(color) << 24) | (Math.min(getRed(color) + shade, 255) << 16) | (Math.min(getGreen(color) + shade, 255) << 8) | Math.min(getBlue(color) + shade, 255);
+		}
+	}
+
+	public static int applyShade(int color, float shade)
+	{
+		if (shade < 1)
+		{
+			return (getAlpha(color) << 24) | ((int) Math.max(getRed(color) * shade, 0) << 16) | ((int) Math.max(getGreen(color) * shade, 0) << 8) | (int) Math.max(getBlue(color) * shade, 0);
+		} else
+		{
+			return (getAlpha(color) << 24) | ((int) Math.min(getRed(color) * shade, 255) << 16) | ((int) Math.min(getGreen(color) * shade, 255) << 8) | (int) Math.min(getBlue(color) * shade, 255);
+		}
+	}
+
+	/**
+	 * Edit the given color as a HSV (Hue Saturation Value) color.
+	 */
+	public static int applySaturationAndBrightnessMultipliers(int color, float saturationMultiplier, float brightnessMultiplier)
+	{
+		float[] hsv = Color.RGBtoHSB(getRed(color), getGreen(color), getBlue(color), null);
+		return Color.getHSBColor(
+				hsv[0], // hue
+				LodUtil.clamp(0.0f, hsv[1] * saturationMultiplier, 1.0f),
+				LodUtil.clamp(0.0f, hsv[2] * brightnessMultiplier, 1.0f)).getRGB();
+	}
+
+	/**
+	 * Edit the given color as a HSV (Hue Saturation Value) color.
+	 */
+	public static int changeBrightness(int color, float brightness)
+	{
+		float[] hsv = Color.RGBtoHSB(getRed(color), getGreen(color), getBlue(color), null);
+		return Color.getHSBColor(
+				hsv[0], // hue
+				hsv[1],
+				brightness).getRGB();
+	}
+
+	/**
+	 * Edit the given color as a HSV (Hue Saturation Value) color.
+	 */
+	public static int changeBrightnessValue(int color, int brightnessColor)
+	{
+		float[] hsv = Color.RGBtoHSB(getRed(color), getGreen(color), getBlue(color), null);
+		float brightness = Color.RGBtoHSB(getRed(brightnessColor), getGreen(brightnessColor), getBlue(brightnessColor), null)[2];
+		return Color.getHSBColor(
+				hsv[0], // hue
+				hsv[1],
+				brightness).getRGB();
+	}
+	public static int multiplyRGBcolors(int color1, int color2)
+	{
+		/**TODO FIX the alpha*/
+		return 0xFF000000 | (((getRed(color1) * getRed(color2)) << 8) & 0xFF0000) | ((getGreen(color1) * getGreen(color2)) & 0xFF00) | (((getBlue(color1) * getBlue(color2)) >> 8) & 0xFF);
+	}
+
+
+	public static String toString(int color)
+	{
+		StringBuilder s = new StringBuilder();
+		s.append(Integer.toHexString(getAlpha(color)));
+		s.append(" ");
+		s.append(Integer.toHexString(getRed(color)));
+		s.append(" ");
+		s.append(Integer.toHexString(getGreen(color)));
+		s.append(" ");
+		s.append(Integer.toHexString(getBlue(color)));
+		return s.toString();
+	}
+}
@@ -0,0 +1,432 @@
+package com.seibel.lod.util;
+
+import com.seibel.lod.enums.DistanceGenerationMode;
+
+import net.minecraft.client.renderer.texture.NativeImage;
+
+public class DataPointUtil
+{
+	/*
+	|a  |a  |a  |a  |r  |r  |r  |r   |
+
+	|r  |r  |r  |r  |g  |g  |g  |g  |
+
+	|g  |g  |g  |g  |b  |b  |b  |b  |
+
+	|b  |b  |b  |b  |h  |h  |h  |h  |
+
+	|h  |h  |h  |h  |h  |h  |d  |d  |
+
+	|d  |d  |d  |d  |d  |d  |d  |d  |
+
+	|bl |bl |bl |bl |sl |sl |sl |sl |
+
+	|l  |l  |f  |g  |g  |g  |v  |e  |
+	
+	
+	 */
+	
+	// Reminder: bytes have range of [-128, 127].
+	// When converting to or from a int a 128 should be added or removed.
+	// If there is a bug with color then it's probably caused by this.
+	
+	//To be used in the future for negative value
+	//public final static int MIN_DEPTH = -64;
+	//public final static int MIN_HEIGHT = -64;
+	public final static int EMPTY_DATA = 0;
+	public static int worldHeight = 256;
+	
+	public final static int ALPHA_DOWNSIZE_SHIFT = 4;
+	
+	//public final static int BLUE_COLOR_SHIFT = 0;
+	//public final static int GREEN_COLOR_SHIFT = 8;
+	//public final static int RED_COLOR_SHIFT = 16;
+	//public final static int ALPHA_COLOR_SHIFT = 24;
+	
+	public final static int BLUE_SHIFT = 36;
+	public final static int GREEN_SHIFT = BLUE_SHIFT + 8;
+	public final static int RED_SHIFT = BLUE_SHIFT + 16;
+	public final static int ALPHA_SHIFT = BLUE_SHIFT + 24;
+	
+	public final static int COLOR_SHIFT = 36;
+	
+	public final static int HEIGHT_SHIFT = 26;
+	public final static int DEPTH_SHIFT = 16;
+	public final static int BLOCK_LIGHT_SHIFT = 12;
+	public final static int SKY_LIGHT_SHIFT = 8;
+	//public final static int LIGHTS_SHIFT = SKY_LIGHT_SHIFT;
+	//public final static int VERTICAL_INDEX_SHIFT = 6;
+	//public final static int FLAG_SHIFT = 5;
+	public final static int GEN_TYPE_SHIFT = 2;
+	public final static int VOID_SHIFT = 1;
+	public final static int EXISTENCE_SHIFT = 0;
+	
+	public final static long ALPHA_MASK = 0b1111;
+	public final static long RED_MASK = 0b1111_1111;
+	public final static long GREEN_MASK = 0b1111_1111;
+	public final static long BLUE_MASK = 0b1111_1111;
+	//public final static long COLOR_MASK = 0b11111111_11111111_11111111;
+	public final static long HEIGHT_MASK = 0b11_1111_1111;
+	public final static long DEPTH_MASK = 0b11_1111_1111;
+	//public final static long LIGHTS_MASK = 0b1111_1111;
+	public final static long BLOCK_LIGHT_MASK = 0b1111;
+	public final static long SKY_LIGHT_MASK = 0b1111;
+	//public final static long VERTICAL_INDEX_MASK = 0b11;
+	//public final static long FLAG_MASK = 0b1;
+	public final static long GEN_TYPE_MASK = 0b111;
+	public final static long VOID_MASK = 1;
+	public final static long EXISTENCE_MASK = 1;
+	
+	
+	public static long createVoidDataPoint(int generationMode)
+	{
+		long dataPoint = 0;
+		dataPoint += (generationMode & GEN_TYPE_MASK) << GEN_TYPE_SHIFT;
+		dataPoint += VOID_MASK << VOID_SHIFT;
+		dataPoint += EXISTENCE_MASK << EXISTENCE_SHIFT;
+		return dataPoint;
+	}
+	
+	public static long createDataPoint(int height, int depth, int color, int lightSky, int lightBlock, int generationMode)
+	{
+		return createDataPoint(
+				ColorUtil.getAlpha(color),
+				ColorUtil.getRed(color),
+				ColorUtil.getGreen(color),
+				ColorUtil.getBlue(color),
+				height, depth, lightSky, lightBlock, generationMode);
+	}
+	
+	public static long createDataPoint(int alpha, int red, int green, int blue, int height, int depth, int lightSky, int lightBlock, int generationMode)
+	{
+		long dataPoint = 0;
+		dataPoint += ((alpha >>> ALPHA_DOWNSIZE_SHIFT) & ALPHA_MASK) << ALPHA_SHIFT;
+		dataPoint += (red & RED_MASK) << RED_SHIFT;
+		dataPoint += (green & GREEN_MASK) << GREEN_SHIFT;
+		dataPoint += (blue & BLUE_MASK) << BLUE_SHIFT;
+		dataPoint += (height & HEIGHT_MASK) << HEIGHT_SHIFT;
+		dataPoint += (depth & DEPTH_MASK) << DEPTH_SHIFT;
+		dataPoint += (lightBlock & BLOCK_LIGHT_MASK) << BLOCK_LIGHT_SHIFT;
+		dataPoint += (lightSky & SKY_LIGHT_MASK) << SKY_LIGHT_SHIFT;
+		dataPoint += (generationMode & GEN_TYPE_MASK) << GEN_TYPE_SHIFT;
+		dataPoint += EXISTENCE_MASK << EXISTENCE_SHIFT;
+		return dataPoint;
+	}
+	
+	public static short getHeight(long dataPoint)
+	{
+		return (short) ((dataPoint >>> HEIGHT_SHIFT) & HEIGHT_MASK);
+	}
+	
+	public static short getDepth(long dataPoint)
+	{
+		
+		return (short) ((dataPoint >>> DEPTH_SHIFT) & DEPTH_MASK);
+	}
+	
+	public static short getAlpha(long dataPoint)
+	{
+		return (short) (((dataPoint >>> ALPHA_SHIFT) & ALPHA_MASK) << ALPHA_DOWNSIZE_SHIFT);
+	}
+	
+	public static short getRed(long dataPoint)
+	{
+		return (short) ((dataPoint >>> RED_SHIFT) & RED_MASK);
+	}
+	
+	public static short getGreen(long dataPoint)
+	{
+		return (short) ((dataPoint >>> GREEN_SHIFT) & GREEN_MASK);
+	}
+	
+	public static short getBlue(long dataPoint)
+	{
+		return (short) ((dataPoint >>> BLUE_SHIFT) & BLUE_MASK);
+	}
+	
+	public static int getLightSky(long dataPoint)
+	{
+		return (int) ((dataPoint >>> SKY_LIGHT_SHIFT) & SKY_LIGHT_MASK);
+	}
+	
+	public static int getLightBlock(long dataPoint)
+	{
+		return (int) ((dataPoint >>> BLOCK_LIGHT_SHIFT) & BLOCK_LIGHT_MASK);
+	}
+	
+	public static byte getGenerationMode(long dataPoint)
+	{
+		return (byte) ((dataPoint >>> GEN_TYPE_SHIFT) & GEN_TYPE_MASK);
+	}
+	
+	
+	public static boolean isVoid(long dataPoint)
+	{
+		return (((dataPoint >>> VOID_SHIFT) & VOID_MASK) == 1);
+	}
+	
+	public static boolean doesItExist(long dataPoint)
+	{
+		return (((dataPoint >>> EXISTENCE_SHIFT) & EXISTENCE_MASK) == 1);
+	}
+	
+	public static int getColor(long dataPoint)
+	{
+		//int color = getBlue(dataPoint) << BLUE_COLOR_SHIFT;
+		//color += getRed(dataPoint) << BLUE_COLOR_SHIFT;
+		return (int) (dataPoint >>> COLOR_SHIFT);
+	}
+	
+	public static int getLightColor(long dataPoint, NativeImage lightMap)
+	{
+		int lightBlock = getLightBlock(dataPoint);
+		int lightSky = getLightSky(dataPoint);
+		int color = lightMap.getPixelRGBA(lightBlock, lightSky);
+		int red = ColorUtil.getBlue(color);
+		int green = ColorUtil.getGreen(color);
+		int blue = ColorUtil.getRed(color);
+		
+		return ColorUtil.multiplyRGBcolors(getColor(dataPoint), ColorUtil.rgbToInt(red, green, blue));
+	}
+	
+	public static String toString(long dataPoint)
+	{
+		StringBuilder s = new StringBuilder();
+		s.append(getHeight(dataPoint));
+		s.append(" ");
+		s.append(getDepth(dataPoint));
+		s.append(" ");
+		s.append(getAlpha(dataPoint));
+		s.append(" ");
+		s.append(getRed(dataPoint));
+		s.append(" ");
+		s.append(getBlue(dataPoint));
+		s.append(" ");
+		s.append(getGreen(dataPoint));
+		s.append(" ");
+		s.append(getLightBlock(dataPoint));
+		s.append(" ");
+		s.append(getLightSky(dataPoint));
+		s.append(" ");
+		s.append(getGenerationMode(dataPoint));
+		s.append(" ");
+		s.append(isVoid(dataPoint));
+		s.append(" ");
+		s.append(doesItExist(dataPoint));
+		s.append('\n');
+		return s.toString();
+	}
+	
+	public static long mergeSingleData(long[] dataToMerge)
+	{
+		int numberOfChildren = 0;
+		
+		int tempAlpha = 0;
+		int tempRed = 0;
+		int tempGreen = 0;
+		int tempBlue = 0;
+		int tempHeight = Integer.MIN_VALUE;
+		int tempDepth = Integer.MAX_VALUE;
+		int tempLightBlock = 0;
+		int tempLightSky = 0;
+		byte tempGenMode = DistanceGenerationMode.SERVER.complexity;
+		boolean allEmpty = true;
+		boolean allVoid = true;
+		for (long data : dataToMerge)
+		{
+			if (DataPointUtil.doesItExist(data))
+			{
+				allEmpty = false;
+				if (!(DataPointUtil.isVoid(data)))
+				{
+					numberOfChildren++;
+					allVoid = false;
+					tempAlpha += DataPointUtil.getAlpha(data);
+					tempRed += DataPointUtil.getRed(data);
+					tempGreen += DataPointUtil.getGreen(data);
+					tempBlue += DataPointUtil.getBlue(data);
+					tempHeight = Math.max(tempHeight, DataPointUtil.getHeight(data));
+					tempDepth = Math.min(tempDepth, DataPointUtil.getDepth(data));
+					tempLightBlock += DataPointUtil.getLightBlock(data);
+					tempLightSky += DataPointUtil.getLightSky(data);
+				}
+				tempGenMode = (byte) Math.min(tempGenMode, DataPointUtil.getGenerationMode(data));
+			} else
+			{
+				tempGenMode = (byte) Math.min(tempGenMode, DistanceGenerationMode.NONE.complexity);
+			}
+		}
+		
+		if (allEmpty)
+		{
+			//no child has been initialized
+			return DataPointUtil.EMPTY_DATA;
+		} else if (allVoid)
+		{
+			//all the children are void
+			return DataPointUtil.createVoidDataPoint(tempGenMode);
+		} else
+		{
+			//we have at least 1 child
+			tempAlpha = tempAlpha / numberOfChildren;
+			tempRed = tempRed / numberOfChildren;
+			tempGreen = tempGreen / numberOfChildren;
+			tempBlue = tempBlue / numberOfChildren;
+			tempLightBlock = tempLightBlock / numberOfChildren;
+			tempLightSky = tempLightSky / numberOfChildren;
+			return DataPointUtil.createDataPoint(tempAlpha, tempRed, tempGreen, tempBlue, tempHeight, tempDepth, tempLightSky, tempLightBlock, tempGenMode);
+		}
+	}
+	
+	public static long[] mergeMultiData(long[] dataToMerge, int inputVerticalData, int maxVerticalData)
+	{
+		int size = dataToMerge.length / inputVerticalData;
+		
+		// We initialize the arrays that are going to be used
+		short[] projection = ThreadMapUtil.getFreshProjectionArray((worldHeight) / 16 + 1);
+		short[] heightAndDepth = ThreadMapUtil.getFreshHeightAndDepth((worldHeight + 1) * 2);
+		long[] singleDataToMerge = ThreadMapUtil.getFreshSingleAddDataToMerge(size);
+		long[] dataPoint = ThreadMapUtil.getFreshVerticalDataArray(worldHeight + 1);
+		
+		
+		int genMode = DistanceGenerationMode.SERVER.complexity;
+		boolean allEmpty = true;
+		boolean allVoid = true;
+		long singleData;
+		
+		
+		short depth;
+		short height;
+		
+		//We collect the indexes of the data, ordered by the depth
+		for (int index = 0; index < size; index++)
+		{
+			for (int dataIndex = 0; dataIndex < inputVerticalData; dataIndex++)
+			{
+				singleData = dataToMerge[index * inputVerticalData + dataIndex];
+				if (doesItExist(singleData))
+				{
+					genMode = Math.min(genMode, getGenerationMode(singleData));
+					allEmpty = false;
+					if (!isVoid(singleData))
+					{
+						allVoid = false;
+						depth = getDepth(singleData);
+						height = getHeight(singleData);
+						for (int y = depth; y <= height; y++)
+							projection[y / 16] |= 1 << (y & 0xf);
+					}
+				}
+			}
+		}
+		//We check if there is any data that's not empty or void
+		if (allEmpty)
+		{
+			return dataPoint;
+		}
+		if (allVoid)
+		{
+			dataPoint[0] = createVoidDataPoint(genMode);
+			return dataPoint;
+		}
+		//We extract the merged data
+		int count = 0;
+		int i = 0;
+		int ii = 0;
+		while (i < projection.length)
+		{
+			while (i < projection.length && projection[i] == 0) i++;
+			if (i == projection.length)
+				break; //we reached end of WORLD_HEIGHT and it's nothing more here
+			while (ii < 15 && ((projection[i] >>> ii) & 1) == 0) ii++;
+			if (ii >= 15 && ((projection[i] >>> ii) & 1) == 0) //there is nothing more in this chunk
+			{
+				ii = 0;
+				i++;
+				continue;
+			}
+			depth = (short) (i * 16 + ii);
+			
+			while (ii < 15 && ((projection[i] >>> ii) & 1) == 1) ii++;
+			if (ii >= 15 && ((projection[i] >>> ii) & 1) == 1) //if end is not in this chunk
+			{
+				ii = 0;
+				i++;
+				while (i < projection.length && ~(projection[i]) == 0) i++; //check for big solid blocks
+				if (i == projection.length) //solid to WORLD_HEIGHT
+				{
+					heightAndDepth[count * 2] = depth;
+					heightAndDepth[count * 2 + 1] = (short) (worldHeight - 1);
+					break;
+				}
+				while ((((projection[i] >>> ii) & 1) == 1)) ii++;
+			}
+			height = (short) (i * 16 + ii - 1);
+			heightAndDepth[count * 2] = depth;
+			heightAndDepth[count * 2 + 1] = height;
+			count++;
+		}
+		
+		//we limit the vertical portion to maxVerticalData
+		int j = 0;
+		while (count > maxVerticalData)
+		{
+			ii = worldHeight;
+			for (i = 0; i < count - 1; i++)
+			{
+				if (heightAndDepth[(i + 1) * 2] - heightAndDepth[i * 2 + 1] < ii)
+				{
+					ii = heightAndDepth[(i + 1) * 2] - heightAndDepth[i * 2 + 1];
+					j = i;
+				}
+			}
+			heightAndDepth[j * 2 + 1] = heightAndDepth[(j + 1) * 2 + 1];
+			for (i = j + 1; i < count - 1; i++)
+			{
+				heightAndDepth[i * 2] = heightAndDepth[(i + 1) * 2];
+				heightAndDepth[i * 2 + 1] = heightAndDepth[(i + 1) * 2 + 1];
+			}
+			//System.arraycopy(heightAndDepth,j + 1, heightAndDepth, j,count - j - 1);
+			count--;
+		}
+		//As standard the vertical lods are ordered from top to bottom
+		for (j = 0; j < count; j++)
+		{
+			depth = heightAndDepth[j * 2];
+			height = heightAndDepth[j * 2 + 1];
+			if ((depth == 0 && height == 0) || j >= heightAndDepth.length / 2)
+				break;
+			for (int k = 0; k < size; k++)
+			{
+				singleDataToMerge[k] = 0;
+			}
+			for (int index = 0; index < size; index++)
+			{
+				for (int dataIndex = 0; dataIndex < inputVerticalData; dataIndex++)
+				{
+					singleData = dataToMerge[index * inputVerticalData + dataIndex];
+					if (doesItExist(singleData) && !isVoid(singleData))
+					{
+						if ((depth <= getDepth(singleData) && getDepth(singleData) <= height)
+								|| (depth <= getHeight(singleData) && getHeight(singleData) <= height))
+						{
+							if (getHeight(singleData) > getHeight(singleDataToMerge[index]))
+							{
+								singleDataToMerge[index] = singleData;
+							}
+						}
+					}
+				}
+			}
+			long data = mergeSingleData(singleDataToMerge);
+			
+			dataPoint[count - j - 1] = createDataPoint(height, depth, getColor(data), getLightSky(data), getLightBlock(data), getGenerationMode(data));
+		}
+		return dataPoint;
+	}
+	
+	public static long[] compress(long[] data, byte detailLevel)
+	{
+		return null;
+	}
+}
@@ -0,0 +1,173 @@
+package com.seibel.lod.util;
+
+import com.seibel.lod.config.LodConfig;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.enums.HorizontalResolution;
+import com.seibel.lod.enums.VerticalQuality;
+
+public class DetailDistanceUtil
+{
+	private static double genMultiplier = 1.0;
+	private static double treeGenMultiplier = 1.0;
+	private static double treeCutMultiplier = 1.0;
+	private static int minGenDetail = LodConfig.CLIENT.worldGenerator.generationResolution.get().detailLevel;
+	private static int minDrawDetail = Math.max(LodConfig.CLIENT.graphics.drawResolution.get().detailLevel,LodConfig.CLIENT.worldGenerator.generationResolution.get().detailLevel);
+	private static int maxDetail = LodUtil.REGION_DETAIL_LEVEL + 1;
+	private static int minDistance = 0;
+	private static int maxDistance = LodConfig.CLIENT.graphics.lodChunkRenderDistance.get() * 16 * 2;
+
+	private static int[] maxVerticalData = {
+			4,
+			4,
+			4,
+			2,
+			2,
+			1,
+			1,
+			1,
+			1,
+			1,
+			1};
+
+
+	private static HorizontalResolution[] lodGenDetails = {
+			HorizontalResolution.BLOCK,
+			HorizontalResolution.TWO_BLOCKS,
+			HorizontalResolution.FOUR_BLOCKS,
+			HorizontalResolution.HALF_CHUNK,
+			HorizontalResolution.CHUNK,
+			HorizontalResolution.CHUNK,
+			HorizontalResolution.CHUNK,
+			HorizontalResolution.CHUNK,
+			HorizontalResolution.CHUNK,
+			HorizontalResolution.CHUNK,
+			HorizontalResolution.CHUNK};
+
+
+
+	public static void updateSettings(){
+		minGenDetail = LodConfig.CLIENT.worldGenerator.generationResolution.get().detailLevel;
+		minDrawDetail = Math.max(LodConfig.CLIENT.graphics.drawResolution.get().detailLevel,LodConfig.CLIENT.worldGenerator.generationResolution.get().detailLevel);
+		maxDistance = LodConfig.CLIENT.graphics.lodChunkRenderDistance.get() * 16 * 8;
+	}
+
+	public static int baseDistanceFunction(int detail)
+	{
+		if (detail <= minGenDetail)
+			return minDistance;
+		if (detail >= maxDetail)
+			return maxDistance;
+
+		int distanceUnit = LodConfig.CLIENT.worldGenerator.horizontalScale.get().distanceUnit;
+		switch (LodConfig.CLIENT.worldGenerator.horizontalQuality.get()){
+
+			case LINEAR:;
+				return (detail * distanceUnit);
+			default:
+				double base = LodConfig.CLIENT.worldGenerator.horizontalQuality.get().quadraticBase;
+				return (int) (Math.pow(base, detail) * distanceUnit);
+		}
+	}
+
+	public static int getDrawDistanceFromDetail(int detail)
+	{
+		return baseDistanceFunction(detail);
+	}
+
+	public static byte baseInverseFunction(int distance, int minDetail)
+	{
+
+		int detail = 0;
+		if (distance == 0)
+			return (byte) minDetail;
+		int distanceUnit = LodConfig.CLIENT.worldGenerator.horizontalScale.get().distanceUnit;
+		switch (LodConfig.CLIENT.worldGenerator.horizontalQuality.get()){
+			case LINEAR:
+				detail = (byte) Math.floorDiv(distance, distanceUnit);
+				break;
+			default:
+				double base = LodConfig.CLIENT.worldGenerator.horizontalQuality.get().quadraticBase;
+				double logBase = Math.log(base);
+				detail = (byte) (Math.log(Math.floorDiv(distance, distanceUnit))/logBase);
+				break;
+		}
+		return (byte) LodUtil.clamp(minDetail, detail, maxDetail-1);
+	}
+
+	public static byte getDrawDetailFromDistance(int distance)
+	{
+		return baseInverseFunction(distance, minDrawDetail);
+	}
+
+	public static byte getGenerationDetailFromDistance(int distance)
+	{
+		return baseInverseFunction((int) (distance * genMultiplier), minGenDetail);
+	}
+
+	public static byte getTreeCutDetailFromDistance(int distance)
+	{
+		return baseInverseFunction((int) (distance * treeCutMultiplier), minGenDetail);
+	}
+
+
+	public static byte getTreeGenDetailFromDistance(int distance)
+	{
+		return baseInverseFunction((int) (distance * treeGenMultiplier), minGenDetail);
+	}
+
+	public static DistanceGenerationMode getDistanceGenerationMode(int detail)
+	{
+		return LodConfig.CLIENT.worldGenerator.distanceGenerationMode.get();
+	}
+
+	public static byte getLodDrawDetail(int detail)
+	{
+		if (detail < minDrawDetail)
+		{
+			if(LodConfig.CLIENT.graphics.alwaysDrawAtMaxQuality.get())
+				return getLodGenDetail(minDrawDetail).detailLevel;
+			else
+				return (byte) minDrawDetail;
+		} else
+		{
+			if(LodConfig.CLIENT.graphics.alwaysDrawAtMaxQuality.get())
+				return getLodGenDetail(detail).detailLevel;
+			else
+				return (byte) detail;
+		}
+	}
+
+	public static HorizontalResolution getLodGenDetail(int detail)
+	{
+		if (detail < minGenDetail)
+		{
+			return lodGenDetails[minGenDetail];
+		} else
+		{
+			return lodGenDetails[detail];
+		}
+	}
+
+
+	public static byte getCutLodDetail(int detail)
+	{
+		if (detail < minGenDetail)
+		{
+			return lodGenDetails[minGenDetail].detailLevel;
+		} else if (detail == maxDetail)
+		{
+			return LodUtil.REGION_DETAIL_LEVEL;
+		} else
+		{
+			return lodGenDetails[detail].detailLevel;
+		}
+	}
+
+	public static int getMaxVerticalData(int detail)
+	{
+		if(LodConfig.CLIENT.worldGenerator.lodQualityMode.get() == VerticalQuality.HEIGHTMAP)
+			return 1;
+		return maxVerticalData[LodUtil.clamp(minGenDetail, detail, LodUtil.REGION_DETAIL_LEVEL)];
+	}
+
+}
@@ -0,0 +1,229 @@
+package com.seibel.lod.util;
+
+import com.seibel.lod.config.LodConfig;
+
+public class LevelPosUtil
+{
+	public static int[] convert(int[] levelPos, byte newDetailLevel)
+	{
+		return convert(getDetailLevel(levelPos), getPosX(levelPos), getPosZ(levelPos), newDetailLevel);
+	}
+
+	public static int[] convert(byte detailLevel, int posX, int posZ, byte newDetailLevel)
+	{
+		int width;
+		if (newDetailLevel >= detailLevel)
+		{
+			width = 1 << (newDetailLevel - detailLevel);
+			return createLevelPos(
+					newDetailLevel,
+					Math.floorDiv(posX, width),
+					Math.floorDiv(posZ, width));
+		} else
+		{
+			width = 1 << (detailLevel - newDetailLevel);
+			return createLevelPos(
+					newDetailLevel,
+					posX * width,
+					posZ * width);
+		}
+	}
+
+	public static int[] createLevelPos(byte detailLevel, int posX, int posZ)
+	{
+		return new int[]{detailLevel, posX, posZ};
+	}
+
+	public static int convert(byte detailLevel, int pos, byte newDetailLevel)
+	{
+		int width;
+		if (newDetailLevel >= detailLevel)
+		{
+			width = 1 << (newDetailLevel - detailLevel);
+			return Math.floorDiv(pos, width);
+		} else
+		{
+			width = 1 << (detailLevel - newDetailLevel);
+			return pos * width;
+		}
+	}
+
+	public static int getRegion(byte detailLevel, int pos)
+	{
+		return Math.floorDiv(pos, 1 << (LodUtil.REGION_DETAIL_LEVEL - detailLevel));
+	}
+
+	public static int getRegionModule(byte detailLevel, int pos)
+	{
+		return Math.floorMod(pos, 1 << (LodUtil.REGION_DETAIL_LEVEL - detailLevel));
+	}
+
+	public static byte getDetailLevel(int[] levelPos)
+	{
+		return (byte) levelPos[0];
+	}
+
+	public static int getPosX(int[] levelPos)
+	{
+		return levelPos[1];
+	}
+
+	public static int getPosZ(int[] levelPos)
+	{
+		return levelPos[2];
+	}
+
+	public static int getDistance(int[] levelPos)
+	{
+		return levelPos[3];
+	}
+
+	public static int[] getRegionModule(int[] levelPos)
+	{
+		return getRegionModule(getDetailLevel(levelPos), getPosX(levelPos), getPosZ(levelPos));
+	}
+
+	public static int[] getRegionModule(byte detailLevel, int posX, int posZ)
+	{
+		int width = 1 << (LodUtil.REGION_DETAIL_LEVEL - detailLevel);
+		return createLevelPos(
+				detailLevel,
+				Math.floorMod(posX, width),
+				Math.floorMod(posZ, width));
+	}
+
+	public static int[] applyOffset(int[] levelPos, int xOffset, int zOffset)
+	{
+		return createLevelPos(
+				getDetailLevel(levelPos),
+				getPosX(levelPos) + xOffset,
+				getPosZ(levelPos) + zOffset);
+	}
+
+	public static int[] applyLevelOffset(int[] levelPos, byte detailOffset, int xOffset, int zOffset)
+	{
+		return createLevelPos(
+				getDetailLevel(levelPos),
+				getPosX(levelPos) + xOffset * (1 << detailOffset),
+				getPosZ(levelPos) + zOffset * (1 << detailOffset));
+	}
+
+	public static int getRegionPosX(int[] levelPos)
+	{
+		int width = 1 << (LodUtil.REGION_DETAIL_LEVEL - getDetailLevel(levelPos));
+		return Math.floorDiv(getPosX(levelPos), width);
+	}
+
+	public static int getRegionPosZ(int[] levelPos)
+	{
+		int width = 1 << (LodUtil.REGION_DETAIL_LEVEL - getDetailLevel(levelPos));
+		return Math.floorDiv(getPosZ(levelPos), width);
+	}
+
+	public static int getChunkPos(byte detailLevel, int pos)
+	{
+		return convert(detailLevel,pos, LodUtil.CHUNK_DETAIL_LEVEL);
+	}
+
+
+	public static int maxDistance(byte detailLevel, int posX, int posZ, int playerPosX, int playerPosZ)
+	{
+		int width = 1 << detailLevel;
+
+		int startPosX = posX * width;
+		int startPosZ = posZ * width;
+		int endPosX = startPosX + width;
+		int endPosZ = startPosZ + width;
+
+		int maxDistance = (int) Math.sqrt(Math.pow(playerPosX - startPosX, 2) + Math.pow(playerPosZ - startPosZ, 2));
+		maxDistance = Math.max(maxDistance, (int) Math.sqrt(Math.pow(playerPosX - startPosX, 2) + Math.pow(playerPosZ - endPosZ, 2)));
+		maxDistance = Math.max(maxDistance, (int) Math.sqrt(Math.pow(playerPosX - endPosX, 2) + Math.pow(playerPosZ - startPosZ, 2)));
+		maxDistance = Math.max(maxDistance, (int) Math.sqrt(Math.pow(playerPosX - endPosX, 2) + Math.pow(playerPosZ - endPosZ, 2)));
+
+		return maxDistance;
+	}
+
+	public static int maxDistance(byte detailLevel, int posX, int posZ, int playerPosX, int playerPosZ, int xRegion, int zRegion)
+	{
+		int width = 1 << (LodUtil.REGION_DETAIL_LEVEL - detailLevel);
+		int newPosX = xRegion * width + posX;
+		int newPosZ = zRegion * width + posZ;
+		return maxDistance(detailLevel, newPosX, newPosZ, playerPosX, playerPosZ);
+	}
+
+
+	public static int minDistance(byte detailLevel, int posX, int posZ, int playerPosX, int playerPosZ)
+	{
+		int width = 1 << detailLevel;
+
+		int startPosX = posX * width;
+		int startPosZ = posZ * width;
+		int endPosX = startPosX + width;
+		int endPosZ = startPosZ + width;
+
+		boolean inXArea = playerPosX >= startPosX && playerPosX <= endPosX;
+		boolean inZArea = playerPosZ >= startPosZ && playerPosZ <= endPosZ;
+		if (inXArea && inZArea)
+		{
+			return 0;
+		} else if (inXArea)
+		{
+			return Math.min(
+					Math.abs(playerPosZ - startPosZ),
+					Math.abs(playerPosZ - endPosZ)
+			);
+		} else if (inZArea)
+		{
+			return Math.min(
+					Math.abs(playerPosX - startPosX),
+					Math.abs(playerPosX - endPosX)
+			);
+		} else
+		{
+			int minDistance = (int) Math.sqrt(Math.pow(playerPosX - startPosX, 2) + Math.pow(playerPosZ - startPosZ, 2));
+			minDistance = Math.min(minDistance, (int) Math.sqrt(Math.pow(playerPosX - startPosX, 2) + Math.pow(playerPosZ - endPosZ, 2)));
+			minDistance = Math.min(minDistance, (int) Math.sqrt(Math.pow(playerPosX - endPosX, 2) + Math.pow(playerPosZ - startPosZ, 2)));
+			minDistance = Math.min(minDistance, (int) Math.sqrt(Math.pow(playerPosX - endPosX, 2) + Math.pow(playerPosZ - endPosZ, 2)));
+			return minDistance;
+		}
+	}
+
+	public static int minDistance(byte detailLevel, int posX, int posZ, int playerPosX, int playerPosZ, int xRegion, int zRegion)
+	{
+		int width = 1 << (LodUtil.REGION_DETAIL_LEVEL - detailLevel);
+		int newPosX = xRegion * width + posX;
+		int newPosZ = zRegion * width + posZ;
+		return minDistance(detailLevel, newPosX, newPosZ, playerPosX, playerPosZ);
+	}
+
+	public static int compareDistance(int firstDistance, int secondDistance)
+	{
+		return Integer.compare(
+				firstDistance,
+				secondDistance);
+	}
+
+
+	public static int compareLevelAndDistance(byte firstDetail, int firstDistance, byte secondDetail, int secondDistance)
+	{
+		int compareResult = Integer.compare(
+				secondDetail,
+				firstDetail);
+		if (compareResult == 0)
+		{
+			compareResult = Integer.compare(
+					firstDistance,
+					secondDistance);
+		}
+		return compareResult;
+	}
+
+	public static String toString(int[] levelPos)
+	{
+		return (getDetailLevel(levelPos) + " " + getPosX(levelPos) + " " + getPosZ(levelPos));
+	}
+	public static String toString(byte detailLevel, int posX, int posZ)
+	{
+		return (detailLevel + " " + posX + " " + posZ);
+	}
+}
@@ -0,0 +1,28 @@
+package com.seibel.lod.util;
+
+import java.util.concurrent.ThreadFactory;
+
+/**
+ * Just a simple ThreadFactory to name ExecutorService
+ * threads, which can be helpful when debugging.
+ * 
+ * @author James Seibel
+ * @version 8-15-2021
+ */
+public class LodThreadFactory implements ThreadFactory
+{
+	public String threadName;
+	
+	
+	public LodThreadFactory(String newThreadName)
+	{
+		threadName = newThreadName + " Thread";
+	}
+	
+	@Override
+	public Thread newThread(Runnable r)
+	{
+            return new Thread(r, threadName);
+	}
+	
+}
@@ -0,0 +1,476 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.util;
+
+import java.awt.Color;
+import java.io.File;
+import java.util.HashSet;
+
+import com.seibel.lod.enums.LodTemplate;
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.objects.RegionPos;
+import com.seibel.lod.wrappers.MinecraftWrapper;
+
+import net.minecraft.client.multiplayer.ServerData;
+import net.minecraft.client.renderer.WorldRenderer;
+import net.minecraft.client.renderer.chunk.ChunkRenderDispatcher.CompiledChunk;
+import net.minecraft.server.integrated.IntegratedServer;
+import net.minecraft.util.math.BlockPos;
+import net.minecraft.util.math.ChunkPos;
+import net.minecraft.world.DimensionType;
+import net.minecraft.world.IWorld;
+import net.minecraft.world.chunk.ChunkSection;
+import net.minecraft.world.chunk.IChunk;
+import net.minecraft.world.gen.Heightmap;
+import net.minecraft.world.server.ServerChunkProvider;
+import net.minecraft.world.server.ServerWorld;
+
+/**
+ * This class holds methods and constants that may be used in multiple places.
+ * 
+ * @author James Seibel
+ * @version 9-7-2021
+ */
+public class LodUtil
+{
+	private static MinecraftWrapper mc = MinecraftWrapper.INSTANCE;
+	
+	
+	/** alpha used when drawing chunks in debug mode */
+	public static final int DEBUG_ALPHA = 255; // 0 - 255
+	public static final Color COLOR_DEBUG_BLACK = new Color(0, 0, 0, DEBUG_ALPHA);
+	public static final Color COLOR_DEBUG_WHITE = new Color(255, 255, 255, DEBUG_ALPHA);
+	public static final Color COLOR_INVISIBLE = new Color(0,0,0,0);
+	
+	/** a gray-purple color */
+	public static final int MYCELIUM_COLOR_INT = LodUtil.colorToInt(Color.decode("#6E6166"));
+	/** TODO, add a better way to override material colors
+	 * and/or add a method to generate colors based on texture
+	 * issue #64 */
+	public static final int STONE_COLOR_INT = LodUtil.colorToInt(new Color(150, 150, 150));
+	public static final int NETHERRACK_COLOR_INT = LodUtil.colorToInt(new Color(95, 38, 38));
+	public static final int WARPED_NYLIUM_COLOR_INT = LodUtil.colorToInt(new Color(34, 94, 85));
+	public static final int CRIMSON_NYLIUM_COLOR_INT = LodUtil.colorToInt(new Color(126, 27, 27));
+
+	/**
+	 * In order of nearest to farthest: <br>
+	 * Red, Orange, Yellow, Green, Cyan, Blue, Magenta, white, gray, black
+	 */
+	public static final Color DEBUG_DETAIL_LEVEL_COLORS[] = new Color[] { Color.RED, Color.ORANGE, Color.YELLOW, Color.GREEN, Color.CYAN, Color.BLUE, Color.MAGENTA, Color.WHITE, Color.GRAY, Color.BLACK };
+	
+	
+	/** 512 blocks wide */
+	public static final byte REGION_DETAIL_LEVEL = 9;
+	/** 16 blocks wide */
+	public static final byte CHUNK_DETAIL_LEVEL = 4;
+	/** 1 block wide */
+	public static final byte BLOCK_DETAIL_LEVEL = 0;
+
+
+	public static final byte DETAIL_OPTIONS = 10;
+
+	public static final short MAX_VERTICAL_DATA = 4;
+
+	/** measured in Blocks <br>
+	 * detail level 9 */
+	public static final short REGION_WIDTH = 512;
+	/** measured in Blocks <br>
+	 * detail level 4 */
+	public static final short CHUNK_WIDTH = 16;
+	/** measured in Blocks <br> 
+	 * detail level 0 */
+	public static final short BLOCK_WIDTH = 1;
+	
+	
+	/** number of chunks wide */
+	public static final int REGION_WIDTH_IN_CHUNKS = 32;
+	
+	
+	/** If we ever need to use a heightmap for any reason, use this one. */
+	public static final Heightmap.Type DEFAULT_HEIGHTMAP = Heightmap.Type.WORLD_SURFACE_WG;
+	
+	/** This regex finds any characters that are invalid for use in a windows 
+	 * (and by extension mac and linux) file path */
+	public static final String INVALID_FILE_CHARACTERS_REGEX = "[\\\\\\/:*?\\\"<>|]";
+	
+	/**
+	 * 64 MB by default is the maximum amount of memory that
+	 * can be directly allocated. <br><br>
+	 * <p>
+	 * I know there are commands to change that amount
+	 * (specifically "-XX:MaxDirectMemorySize"), but
+	 * I have no idea how to access that amount. <br>
+	 * So I guess this will be the hard limit for now. <br><br>
+	 * <p>
+	 * https://stackoverflow.com/questions/50499238/bytebuffer-allocatedirect-and-xmx
+	 */
+	public static final int MAX_ALOCATEABLE_DIRECT_MEMORY = 64 * 1024 * 1024;
+	
+	
+	
+	
+	
+	
+	/**
+	 * Gets the first valid ServerWorld.
+	 * 
+	 * @return null if there are no ServerWorlds
+	 */
+	public static ServerWorld getFirstValidServerWorld()
+	{
+		if (mc.hasSingleplayerServer())
+			return null;
+		
+		Iterable<ServerWorld> worlds = mc.getSingleplayerServer().getAllLevels();
+		
+		for (ServerWorld world : worlds)
+			return world;
+		
+		return null;
+	}
+	
+	/**
+	 * Gets the ServerWorld for the relevant dimension.
+	 * 
+	 * @return null if there is no ServerWorld for the given dimension
+	 */
+	public static ServerWorld getServerWorldFromDimension(DimensionType dimension)
+	{
+		IntegratedServer server = mc.getSingleplayerServer();
+		if (server == null)
+			return null;
+		
+		Iterable<ServerWorld> worlds = server.getAllLevels();
+		ServerWorld returnWorld = null;
+		
+		for (ServerWorld world : worlds)
+		{
+			if(world.dimensionType() == dimension)
+			{
+				returnWorld = world;
+				break;
+			}
+		}
+		
+		return returnWorld;
+	}
+	
+	/**
+	 * Convert a 2D absolute position into a quad tree relative position. 
+	 */
+	public static RegionPos convertGenericPosToRegionPos(int x, int z, int detailLevel)
+	{
+		int relativePosX = Math.floorDiv(x, (int) Math.pow(2, LodUtil.REGION_DETAIL_LEVEL - detailLevel));
+		int relativePosZ = Math.floorDiv(z, (int) Math.pow(2, LodUtil.REGION_DETAIL_LEVEL - detailLevel));
+		
+		return new RegionPos(relativePosX, relativePosZ);
+	}
+	
+	/**
+	 * Convert a 2D absolute position into a quad tree relative position.
+	 */
+	public static int convertLevelPos(int pos, int currectDetailLevel, int targetDetailLevel)
+	{
+		int newPos = Math.floorDiv(pos, (int) Math.pow(2, targetDetailLevel - currectDetailLevel));
+		
+		return newPos;
+	}
+	/**
+	 * Return whether the given chunk
+	 * has any data in it.
+	 */
+	public static boolean chunkHasBlockData(IChunk chunk)
+	{
+		ChunkSection[] blockStorage = chunk.getSections();
+		
+		for(ChunkSection section : blockStorage)
+		{
+			if(section != null && !section.isEmpty())
+			{
+				return true;
+			}
+		}
+		
+		return false;
+	}
+	
+	
+	
+	/**
+	 * If on single player this will return the name of the user's
+	 * world, if in multiplayer it will return the server name, IP,
+	 * and game version.
+	 */
+	public static String getWorldID(IWorld world)
+	{
+		if(mc.hasSingleplayerServer())
+		{
+			// chop off the dimension ID as it is not needed/wanted
+			String dimId = getDimensionIDFromWorld(world);
+			
+			// get the world name
+			int saveIndex = dimId.indexOf("saves") + 1 + "saves".length();
+			int slashIndex = dimId.indexOf(File.separatorChar, saveIndex);
+			dimId = dimId.substring(saveIndex, slashIndex);
+			return dimId;
+		}
+		else
+		{
+			return getServerId();
+		}
+	}
+	
+	
+	
+	/**
+	 * If on single player this will return the name of the user's
+	 * world and the dimensional save folder, if in multiplayer 
+	 * it will return the server name, ip, game version, and dimension.<br>
+	 * <br>
+	 * This can be used to determine where to save files for a given
+	 * dimension.
+	 */
+	public static String getDimensionIDFromWorld(IWorld world)
+	{
+		if(mc.hasSingleplayerServer())
+		{
+			// this will return the world save location
+			// and the dimension folder
+			
+			ServerWorld serverWorld = LodUtil.getServerWorldFromDimension(world.dimensionType());
+			if(serverWorld == null)
+				throw new NullPointerException("getDimensionIDFromWorld wasn't able to get the ServerWorld for the dimension " + world.dimensionType().effectsLocation().getPath());
+			
+			ServerChunkProvider provider = serverWorld.getChunkSource();
+			if(provider == null)
+				throw new NullPointerException("getDimensionIDFromWorld wasn't able to get the ServerChunkProvider for the dimension " + world.dimensionType().effectsLocation().getPath());
+			
+			return provider.dataStorage.dataFolder.toString();
+		}
+		else
+		{
+			return getServerId() + File.separatorChar + "dim_" + world.dimensionType().effectsLocation().getPath() + File.separatorChar;
+		}
+	}
+	
+	/**
+	 * returns the server name, IP and game version.
+	 */
+	public static String getServerId()
+	{
+		ServerData server = mc.getCurrentServer();
+		
+		String serverName = server.name.replaceAll(INVALID_FILE_CHARACTERS_REGEX, "");
+		String serverIp = server.ip.replaceAll(INVALID_FILE_CHARACTERS_REGEX, "");
+		String serverMcVersion = server.version.getString().replaceAll(INVALID_FILE_CHARACTERS_REGEX, "");
+		
+		String serverId =  serverName + ", IP " + serverIp + ", GameVersion " + serverMcVersion;
+		
+		return serverId; 
+	}
+	
+	
+	/**
+	 * Convert a BlockColors int into a Color object.
+	 */
+	public static Color intToColor(int num)
+	{
+		int filter = 0b11111111;
+		
+		int red = (num >> 16 ) & filter;
+		int green = (num >> 8 ) & filter;
+		int blue = num & filter;
+		
+		return new Color(red, green, blue);
+	}
+	
+	/**
+	 * Convert a Color into a BlockColors object.
+	 */
+	public static int colorToInt(Color color)
+	{
+		return color.getRGB();
+	}
+	
+	
+	/**
+	 * Clamps the given value between the min and max values.
+	 * May behave strangely if min > max.
+	 */
+	public static int clamp(int min, int value, int max)
+	{
+		return Math.min(max, Math.max(value, min));
+	}
+	
+	/**
+	 * Clamps the given value between the min and max values.
+	 * May behave strangely if min > max.
+	 */
+	public static float clamp(float min, float value, float max)
+	{
+		return Math.min(max, Math.max(value, min));
+	}
+	
+	/**
+	 * Clamps the given value between the min and max values.
+	 * May behave strangely if min > max.
+	 */
+	public static double clamp(double min, double value, double max)
+	{
+		return Math.min(max, Math.max(value, min));
+	}
+
+	/**
+	 * This methods return the number of lods that are going to be rendered in a region in the worst case
+	 * @param regionPosX x region position to check
+ 	 * @param regionPosZ z region position to check
+	 * @return number of lods in the region
+	 */
+	public static int regionRenderingMemoryUse(int regionPosX, int regionPosZ, LodTemplate template)
+	{
+		int xRegionSign = (int) Math.signum(regionPosX);
+		int zRegionSign = (int) Math.signum(regionPosZ);
+
+		//we first find the center of the circle which is one of the following X position in the center region
+		/*
+		X - X - X
+		|       |
+		X   X   X
+		|       |
+		X - X - X
+		 */
+		int circleCenterX = 256 + 256*xRegionSign;
+		int circleCenterZ = 256 + 256*zRegionSign;
+
+
+		int innerRadius;
+		int outerRadius;
+		int size;
+		int count;
+		int minDistance;
+		int maxDistance;
+		int memoryUse = 0;
+		int number = 0;
+		for(byte detailLevel = BLOCK_DETAIL_LEVEL; detailLevel <= REGION_DETAIL_LEVEL; detailLevel++)
+		{
+			//We find now the inner and outer detail of this area
+			innerRadius = DetailDistanceUtil.getDrawDistanceFromDetail(detailLevel);
+			outerRadius = DetailDistanceUtil.getDrawDistanceFromDetail(detailLevel + 1);
+
+			//we skip if the region does not intersect the two circles.
+			minDistance = LevelPosUtil.minDistance(REGION_DETAIL_LEVEL, regionPosX, regionPosZ, circleCenterX, circleCenterZ);
+			maxDistance = LevelPosUtil.maxDistance(REGION_DETAIL_LEVEL, regionPosX, regionPosZ, circleCenterX, circleCenterZ);
+			if (innerRadius > maxDistance || minDistance > outerRadius)
+				continue;
+
+			//we proceed to count all the position in the region that fall between these two circle
+			size = 1 << (REGION_DETAIL_LEVEL - detailLevel);
+			count = 0;
+			for (int x = 0; x < size; x++)
+			{
+				for (int z = 0; z < size; z++)
+				{
+					minDistance = LevelPosUtil.minDistance(detailLevel, x, z, circleCenterX, circleCenterZ, regionPosX, regionPosZ);
+					if (innerRadius < minDistance && minDistance < outerRadius)
+						count++;
+				}
+			}
+
+			//we multiply the data with the max vertical data of this detail level
+			int maxVerticalData = DetailDistanceUtil.getMaxVerticalData(detailLevel);
+
+			number += count;
+			count *= maxVerticalData;
+			memoryUse += template.getBufferMemoryForSingleLod(maxVerticalData) * count;
+		}
+		System.out.println(number);
+		return memoryUse;
+	}
+	
+	
+	 /**
+     * Get a HashSet of all ChunkPos within the normal render distance
+     * that should not be rendered.
+     */
+	 public static HashSet<ChunkPos> getNearbyLodChunkPosToSkip(LodDimension lodDim, BlockPos playerPos)
+	 {
+		 int chunkRenderDist = mc.getRenderDistance();
+		 ChunkPos centerChunk = new ChunkPos(playerPos);
+
+		 // skip chunks that are already going to be rendered by Minecraft
+		 HashSet<ChunkPos> posToSkip = getRenderedChunks();
+
+		 // go through each chunk within the normal view distance
+		 for (int x = centerChunk.x - chunkRenderDist; x < centerChunk.x + chunkRenderDist; x++)
+		 {
+			 for (int z = centerChunk.z - chunkRenderDist; z < centerChunk.z + chunkRenderDist; z++)
+			 {
+				 if (!lodDim.doesDataExist(LodUtil.CHUNK_DETAIL_LEVEL, x, z))
+					 continue;
+
+				 long data = lodDim.getSingleData(LodUtil.CHUNK_DETAIL_LEVEL, x, z);
+
+				 short lodAverageHeight = DataPointUtil.getHeight(data);
+
+				 if (playerPos.getY() <= lodAverageHeight)
+				 {
+					 // don't draw Lod's that are taller than the player
+					 // to prevent LODs being drawn on top of the player
+					 posToSkip.add(new ChunkPos(x, z));
+				 }
+			 }
+		 }
+
+		 return posToSkip;
+	 }
+
+
+	/**
+     * This method returns the ChunkPos of all chunks that Minecraft
+     * is going to render this frame. <br><br>
+     * <p>
+     * Note: This isn't perfect. It will return some chunks that are outside
+     * the clipping plane. (For example, if you are high above the ground some chunks
+     * will be incorrectly added, even though they are outside render range).
+     */
+	public static HashSet<ChunkPos> getRenderedChunks()
+	{
+		HashSet<ChunkPos> loadedPos = new HashSet<>();
+		
+		// Wow those are some long names!
+		
+		// go through every RenderInfo to get the compiled chunks
+		WorldRenderer renderer = mc.getLevelRenderer();
+		for (WorldRenderer.LocalRenderInformationContainer worldrenderer$localrenderinformationcontainer : renderer.renderChunks)
+		{
+			CompiledChunk compiledChunk = worldrenderer$localrenderinformationcontainer.chunk.getCompiledChunk();
+			if (!compiledChunk.hasNoRenderableLayers())
+			{
+				// add the ChunkPos for every rendered chunk
+				BlockPos bpos = worldrenderer$localrenderinformationcontainer.chunk.getOrigin();
+				
+				loadedPos.add(new ChunkPos(bpos));
+			}
+		}
+		
+		
+		return loadedPos;
+	}
+	
+	
+}
@@ -0,0 +1,43 @@
+/*
+ *    This file is part of the LOD Mod, licensed under the GNU GPL v3 License.
+ *
+ *    Copyright (C) 2020  James Seibel
+ *
+ *    This program is free software: you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation, version 3.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.seibel.lod.util;
+
+/**
+ * This holds meta information about the mod.
+ * 
+ * @author James Seibel
+ * @version 04-16-2020
+ */
+public class Reference
+{
+	/** the mod's identifier  */
+	public static final String MOD_ID = "lod";
+	/** the mod's name */
+	public static final String NAME = "LOD Mod";
+	/** the mod's version */
+	public static final String VERSION = "1.0";
+	/** the version of minecraft this mod is built for */
+	public static final String ACCEPTED_VERSIONS = "[1.16.4]";
+	
+	/** where the client proxy class is */
+	public static final String CLIENT_PROXY_CLASS = "com.backsun.lod.proxy.ClientProxy";
+	/** where the  common proxy class is*/
+	public static final String COMMON_PROXY_CLASS = "com.backsun.lod.proxy.CommonProxy";
+	
+	
+}
@@ -0,0 +1,251 @@
+package com.seibel.lod.util;
+
+import java.util.Arrays;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.ConcurrentMap;
+
+/**
+ * Holds data used by specific threads so 
+ * the data doesn't have to be recreated every
+ * time it is needed.
+ * 
+ * @author Leonardo Amato
+ * @version 9-25-2021
+ */
+public class ThreadMapUtil
+{
+	public static final ConcurrentMap<String, long[]> threadSingleUpdateMap = new ConcurrentHashMap<>();
+	public static final ConcurrentMap<String, long[][]> threadBuilderArrayMap = new ConcurrentHashMap<>();
+	public static final ConcurrentMap<String, long[][]> threadBuilderVerticalArrayMap = new ConcurrentHashMap<>();
+	public static final ConcurrentMap<String, long[]> threadVerticalAddDataMap = new ConcurrentHashMap<>();
+	public static final ConcurrentMap<String, byte[]> saveContainer = new ConcurrentHashMap<>();
+	public static final ConcurrentMap<String, short[]> projectionArrayMap = new ConcurrentHashMap<>();
+	public static final ConcurrentMap<String, short[]> heightAndDepthMap = new ConcurrentHashMap<>();
+	public static final ConcurrentMap<String, long[]> singleDataToMergeMap = new ConcurrentHashMap<>();
+	public static final ConcurrentMap<String, long[][]> verticalUpdate = new ConcurrentHashMap<>();
+	
+	
+	
+	/** returns the array filled with 0's */
+	public static long[] getFreshSingleUpdateArray(int arrayLength)
+	{
+		long[] array = getSingleUpdateArray();
+		array = clearOrCreateArray(array, arrayLength);
+		return array;
+	}
+	public static long[] getSingleUpdateArray()
+	{
+		if (!threadSingleUpdateMap.containsKey(Thread.currentThread().getName()) || (threadSingleUpdateMap.get(Thread.currentThread().getName()) == null))
+		{
+			threadSingleUpdateMap.put(Thread.currentThread().getName(), new long[4]);
+		}
+		return threadSingleUpdateMap.get(Thread.currentThread().getName());
+	}
+	
+	
+	/** returns the array filled with 0's */
+	public static long[] getFreshBuilderArray(int arrayLength, int detailLevel)
+	{
+		long[] array = getBuilderArray(detailLevel);
+		array = clearOrCreateArray(array, arrayLength);
+		return array;
+	}
+	public static long[] getBuilderArray(int detailLevel)
+	{
+		if (!threadBuilderArrayMap.containsKey(Thread.currentThread().getName()) || (threadBuilderArrayMap.get(Thread.currentThread().getName()) == null))
+		{
+			long[][] array = new long[5][];
+			threadBuilderArrayMap.put(Thread.currentThread().getName(), array);
+		}
+		return threadBuilderArrayMap.get(Thread.currentThread().getName())[detailLevel];
+	}
+	
+	
+	/** returns the array filled with 0's */
+	public static long[] getFreshBuilderVerticalArray(int arrayLength, int detailLevel)
+	{
+		long[] array = getBuilderVerticalArray(detailLevel);
+		array = clearOrCreateArray(array, arrayLength);
+		return array;
+	}
+	public static long[] getBuilderVerticalArray(int detailLevel)
+	{
+		if (!threadBuilderVerticalArrayMap.containsKey(Thread.currentThread().getName()) || (threadBuilderVerticalArrayMap.get(Thread.currentThread().getName()) == null))
+		{
+			long[][] array = new long[5][];
+			threadBuilderVerticalArrayMap.put(Thread.currentThread().getName(), array);
+		}
+		return threadBuilderVerticalArrayMap.get(Thread.currentThread().getName())[detailLevel];
+	}
+	
+	
+	/** returns the array filled with 0's */
+	public static long[] getFreshVerticalDataArray(int arrayLength)
+	{
+		long[] array = getVerticalDataArray();
+		array = clearOrCreateArray(array, arrayLength);
+		return array;
+	}
+	public static long[] getVerticalDataArray()
+	{
+		if (!threadVerticalAddDataMap.containsKey(Thread.currentThread().getName()) || (threadVerticalAddDataMap.get(Thread.currentThread().getName()) == null))
+		{
+			threadVerticalAddDataMap.put(Thread.currentThread().getName(), new long[0]);
+		}
+		return threadVerticalAddDataMap.get(Thread.currentThread().getName());
+	}
+	
+	
+	
+	/** returns the array filled with 0's */
+	public static short[] getFreshProjectionArray(int arrayLength)
+	{
+		short[] array = getProjectionArray();
+		array = clearOrCreateArray(array, arrayLength);
+		return array;
+	}
+	public static short[] getProjectionArray()
+	{
+		if (!projectionArrayMap.containsKey(Thread.currentThread().getName()) || (projectionArrayMap.get(Thread.currentThread().getName()) == null))
+		{
+			projectionArrayMap.put(Thread.currentThread().getName(), new short[0]);
+		}
+		return projectionArrayMap.get(Thread.currentThread().getName());
+	}
+	
+	
+	/** returns the array filled with 0's */
+	public static short[] getFreshHeightAndDepth(int arrayLength)
+	{
+		short[] array = getHeightAndDepth();
+		array = clearOrCreateArray(array, arrayLength);
+		return array;
+	}
+	public static short[] getHeightAndDepth()
+	{
+		if (!heightAndDepthMap.containsKey(Thread.currentThread().getName()) || (heightAndDepthMap.get(Thread.currentThread().getName()) == null))
+		{
+			heightAndDepthMap.put(Thread.currentThread().getName(), new short[0]);
+		}
+		return heightAndDepthMap.get(Thread.currentThread().getName());
+	}
+	
+	
+	/** returns the array filled with 0's */
+	public static byte[] getFreshSaveContainer(int arrayLength)
+	{
+		byte[] array = getSaveContainer();
+		array = clearOrCreateArray(array, arrayLength);
+		return array;
+	}
+	public static byte[] getSaveContainer()
+	{
+		if (!saveContainer.containsKey(Thread.currentThread().getName()) || (saveContainer.get(Thread.currentThread().getName()) == null))
+		{
+			saveContainer.put(Thread.currentThread().getName(), new byte[0]);
+		}
+		return saveContainer.get(Thread.currentThread().getName());
+	}
+	
+	/** returns the array filled with 0's */
+	public static long[] getFreshVerticalUpdateArray(int arrayLength, int detailLevel)
+	{
+		long[] array = ThreadMapUtil.getVerticalUpdateArray(detailLevel);
+		array = clearOrCreateArray(array, arrayLength);
+		return array;
+	}
+	public static long[] getVerticalUpdateArray(int detailLevel)
+	{
+		if (!verticalUpdate.containsKey(Thread.currentThread().getName()) || (verticalUpdate.get(Thread.currentThread().getName()) == null))
+		{
+			long[][] array = new long[10][];
+			verticalUpdate.put(Thread.currentThread().getName(), array);
+		}
+		return verticalUpdate.get(Thread.currentThread().getName())[detailLevel];
+	}
+	
+	
+	/** returns the array filled with 0's */
+	public static long[] getFreshSingleAddDataToMerge(int arrayLength)
+	{
+		long[] array = getSingleAddDataToMerge();
+		array = clearOrCreateArray(array, arrayLength);
+		return array;
+	}
+	public static long[] getSingleAddDataToMerge()
+	{
+		if (!singleDataToMergeMap.containsKey(Thread.currentThread().getName()) || (singleDataToMergeMap.get(Thread.currentThread().getName()) == null))
+		{
+			singleDataToMergeMap.put(Thread.currentThread().getName(), new long[0]);
+		}
+		return singleDataToMergeMap.get(Thread.currentThread().getName());
+	}
+	
+	
+	
+	
+	/** clears all arrays so they will have to be rebuilt */
+	public static void clearMaps()
+	{
+		threadSingleUpdateMap.clear();
+		threadBuilderArrayMap.clear();
+		threadBuilderVerticalArrayMap.clear();
+		threadVerticalAddDataMap.clear();
+		saveContainer.clear();
+		projectionArrayMap.clear();
+		heightAndDepthMap.clear();
+		singleDataToMergeMap.clear();
+		verticalUpdate.clear();
+	}
+	
+	
+	
+	
+	/** returns an array filled with 0's */
+	private static long[] clearOrCreateArray(long[] array, int arrayLength)
+	{
+		if (array == null || array.length != arrayLength)
+		{
+			array = new long[arrayLength];
+		}
+		else
+			Arrays.fill(array, 0);
+		
+		return array;
+	}
+	
+	/** returns an array filled with 0's */
+	@SuppressWarnings("unused")
+	private static int[] clearOrCreateArray(int[] array, int arrayLength)
+	{
+		if (array == null || array.length != arrayLength)
+			array = new int[arrayLength];
+		else
+			Arrays.fill(array, 0);
+		
+		return array;
+	}
+	
+	/** returns an array filled with 0's */
+	private static short[] clearOrCreateArray(short[] array, int arrayLength)
+	{
+		if (array == null || array.length != arrayLength)
+			array = new short[arrayLength];
+		else
+			Arrays.fill(array, (short) 0);
+		
+		return array;
+	}
+
+	/** returns an array filled with 0's */
+	private static byte[] clearOrCreateArray(byte[] array, int arrayLength)
+	{
+		if (array == null || array.length != arrayLength)
+			array = new byte[arrayLength];
+		else
+			Arrays.fill(array, (byte) 0);
+		
+		return array;
+	}
+	
+}
@@ -0,0 +1,236 @@
+package com.seibel.lod.wrappers;
+
+import java.awt.Color;
+import java.io.File;
+
+import com.seibel.lod.util.LodUtil;
+
+import net.minecraft.client.GameSettings;
+import net.minecraft.client.MainWindow;
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.entity.player.ClientPlayerEntity;
+import net.minecraft.client.multiplayer.ServerData;
+import net.minecraft.client.network.play.ClientPlayNetHandler;
+import net.minecraft.client.renderer.GameRenderer;
+import net.minecraft.client.renderer.LightTexture;
+import net.minecraft.client.renderer.WorldRenderer;
+import net.minecraft.client.renderer.model.ModelManager;
+import net.minecraft.client.renderer.texture.NativeImage;
+import net.minecraft.client.world.ClientWorld;
+import net.minecraft.entity.Entity;
+import net.minecraft.profiler.IProfiler;
+import net.minecraft.server.integrated.IntegratedServer;
+import net.minecraft.util.Direction;
+import net.minecraft.world.DimensionType;
+
+/**
+ * A singleton that wraps the Minecraft class
+ * to allow for easier movement between Minecraft versions.
+ * 
+ * @author James Seibel
+ * @version 9-16-2021
+ */
+public class MinecraftWrapper
+{
+	public static MinecraftWrapper INSTANCE = new MinecraftWrapper();
+	
+	private Minecraft mc = Minecraft.getInstance();
+	
+	/** The lightmap for the current:
+	 * Time, dimension, brightness setting, etc. */
+	private NativeImage lightMap = null;
+	
+	private MinecraftWrapper()
+	{
+		
+	}
+	
+	
+	
+	//================//
+	// helper methods //
+	//================//
+	
+	/**
+	 * This should be called at the beginning of every frame to
+	 * clear any Minecraft data that becomes out of date after a frame. <br> <br>
+	 * 
+	 * Lightmaps and other time sensitive objects fall in this category. <br> <br>
+	 * 
+	 * This doesn't effect OpenGL objects in any way.
+	 */
+	public void clearFrameObjectCache()
+	{
+		lightMap = null;
+	}
+	
+	
+	
+	//=================//
+	// method wrappers //
+	//=================//
+	
+	public float getShading(Direction direction)
+	{
+		return mc.level.getShade(Direction.UP, true);
+	}
+	
+	public boolean hasSingleplayerServer()
+	{
+		return mc.hasSingleplayerServer();
+	}
+	
+	public DimensionType getCurrentDimension()
+	{
+		return mc.player.level.dimensionType();
+	}
+	
+	public String getCurrentDimensionId()
+	{
+		return LodUtil.getDimensionIDFromWorld(mc.level);
+	}
+	
+	/** 
+	 * This texture changes every frame
+	 */
+	public NativeImage getCurrentLightMap()
+	{
+		// get the current lightMap if the cache is empty
+		if (lightMap == null)
+		{
+			LightTexture tex = mc.gameRenderer.lightTexture();
+			NativeImage lightPixels = tex.lightPixels;
+			lightMap = lightPixels;
+		}
+		
+//		// hotswap this to true, then back to false to write a file
+//		// (and not write a file every frame)
+//		if (false)
+//		{
+//			try
+//			{
+//				// obviously change the filepath to somewhere on your PC
+//				lightPixels.writeToFile(new File("C:\\Users\\James Seibel\\Desktop\\image.png"));
+//			}
+//			catch(Exception e)
+//			{
+//				e.printStackTrace();
+//			}
+//		}
+		
+		return lightMap;
+	}
+	
+	/**
+	 * Returns the color int at the given pixel coordinates
+	 * from the current lightmap.
+	 * 
+	 * @param u x location in texture space
+	 * @param v z location in texture space
+	 */
+	public int getColorIntFromLightMap(int u, int v)
+	{
+		if (lightMap == null)
+		{
+			// make sure the lightMap is up to date
+			getCurrentLightMap();
+		}
+		
+		return lightMap.getPixelRGBA(u, v);
+	}
+	
+	/**
+	 * Returns the Color at the given pixel coordinates
+	 * from the current lightmap.
+	 * 
+	 * @param u x location in texture space
+	 * @param v z location in texture space
+	 */
+	public Color getColorFromLightMap(int u, int v)
+	{
+		return LodUtil.intToColor(lightMap.getPixelRGBA(u, v));
+	}
+	
+	
+	
+	
+	//=============//
+	// Simple gets //
+	//=============//
+	
+	public ClientPlayerEntity getPlayer()
+	{
+		return mc.player;
+	}
+	
+	public GameSettings getOptions()
+	{
+		return mc.options;
+	}
+
+	public ModelManager getModelManager()
+	{
+		return mc.getModelManager();
+	}
+	
+	public ClientWorld getClientWorld()
+	{
+		return  mc.level;
+	}
+
+	/** Measured in chunks */
+	public int getRenderDistance()
+	{
+		return mc.options.renderDistance;
+	}
+	
+	public File getGameDirectory()
+	{
+		return mc.gameDirectory;
+	}
+	
+	public IProfiler getProfiler()
+	{
+		return mc.getProfiler();
+	}
+	
+	public ClientPlayNetHandler getConnection()
+	{
+		return mc.getConnection();
+	}
+	
+	public GameRenderer getGameRenderer()
+	{
+		return mc.gameRenderer;
+	}
+	
+	public Entity getCameraEntity()
+	{
+		return mc.cameraEntity;
+	}
+	
+	public MainWindow getWindow()
+	{
+		return mc.getWindow();
+	}
+	
+	public float getSkyDarken(float partialTicks)
+	{
+		return mc.level.getSkyDarken(partialTicks);
+	}
+	
+	public IntegratedServer getSingleplayerServer()
+	{
+		return mc.getSingleplayerServer();
+	}
+	
+	public ServerData getCurrentServer()
+	{
+		return mc.getCurrentServer();
+	}
+	
+	public WorldRenderer getLevelRenderer()
+	{
+		return mc.levelRenderer;
+	}
+}
@@ -16,6 +16,41 @@ public net.minecraft.world.storage.DimensionSavedDataManager field_215759_d # fo
 # used when generating LodChunks
 public net.minecraft.block.AbstractBlock$AbstractBlockState field_235704_h_ # materialColor

+# used when determining which chunks Vanilla Minecraft is going to render
+public net.minecraft.client.renderer.WorldRenderer$LocalRenderInformationContainer
+public net.minecraft.client.renderer.WorldRenderer field_72755_R # renderInfos
+public net.minecraft.client.renderer.WorldRenderer$LocalRenderInformationContainer field_178036_a # renderChunk
+
+# used in world generation
+public net.minecraft.world.server.ServerWorld field_241106_P_ # structuremanager
+public net.minecraft.world.gen.Heightmap func_202267_b(II)I # getDataArrayIndex
+public net.minecraft.world.gen.Heightmap func_202272_a(III)V # set
+public net.minecraft.world.chunk.Chunk field_76634_f # heightMap
+public net.minecraft.world.chunk.Chunk field_76652_q # sections
+public net.minecraft.world.chunk.ChunkPrimer field_201661_i # sections
+public net.minecraft.world.server.ChunkManager field_219269_w # templateManager
+public net.minecraft.world.server.ChunkManager field_219256_j # lightManager
+public net.minecraft.world.gen.feature.template.TemplateManager field_186240_a # templates
+public net.minecraft.world.biome.Biome field_242424_k # biomeGenerationSettings
+public net.minecraft.world.gen.blockstateprovider.WeightedBlockStateProvider field_227406_b_ # weightedStates
+public net.minecraft.world.gen.placement.ConfiguredPlacement field_215096_a # decorator
+public net.minecraft.world.gen.placement.ConfiguredPlacement field_215097_b # config
+public net.minecraft.util.WeightedList field_220658_a # weightedEntries
+public net.minecraft.world.gen.feature.FeatureSpread field_242250_b # base
+public net.minecraft.world.gen.feature.FeatureSpread field_242251_c # spread
+public net.minecraft.world.gen.feature.ConfiguredFeature func_242765_a(Lnet/minecraft/world/ISeedReader;Lnet/minecraft/world/gen/ChunkGenerator;Ljava/util/Random;Lnet/minecraft/util/math/BlockPos;)Z # place
+public net.minecraft.world.server.ServerChunkProvider field_217244_j # dataStorage
+public net.minecraft.world.lighting.WorldLightManager field_215576_a # blockEngine
+public net.minecraft.world.lighting.WorldLightManager field_215577_b # skyEngine
+public net.minecraft.world.gen.feature.Feature field_236290_a_ # configuredCodec
+
+# used for uploading vertex buffers off the render thread
+public net.minecraft.client.renderer.vertex.VertexBuffer field_177365_a # id
+public net.minecraft.client.renderer.vertex.VertexBuffer field_177363_b # format
+public net.minecraft.client.renderer.vertex.VertexBuffer field_177364_c # vertexCount
+
+# used for accessing the lightmap
+public net.minecraft.client.renderer.LightTexture field_205111_b # lightPixels


 #=====================#
@@ -7,14 +7,14 @@
 modLoader="javafml" #mandatory

 #// A version range to match for said mod loader - for regular FML @Mod it will be the forge version
-loaderVersion="[35,)" #mandatory This is typically bumped every Minecraft version by Forge. See our download page for lists of versions.
+loaderVersion="[36,)" #mandatory This is typically bumped every Minecraft version by Forge. See our download page for lists of versions.

 #// The license for you mod. This is mandatory metadata and allows for easier comprehension of your redistributive properties.
 #// Review your options at https://choosealicense.com/. All rights reserved is the default copyright stance, and is thus the default here.
-license="All rights reserved"
+license="GNU GPLv3"

 #// A URL to refer people to when problems occur with this mod
-#//issueTrackerURL="https://change.me.to.your.issue.tracker.example.invalid/" #optional
+issueTrackerURL="https://gitlab.com/jeseibel/minecraft-lod-mod/-/issues" #optional
 #// A list of mods - how many allowed here is determined by the individual mod loader
 [[mods]] #mandatory

@@ -24,27 +24,25 @@ modId="lod" #mandatory
 #// The version number of the mod - there's a few well known ${} variables useable here or just hardcode it
 #//${file.jarVersion} will substitute the value of the Implementation-Version as read from the mod's JAR file metadata
 #// see the associated build.gradle script for how to populate this completely automatically during a build
-version="a1" #mandatory
+version="a1.5.1-pre" #mandatory

 #// A display name for the mod
-displayName="Levels of Detail" #mandatory
+displayName="LOD" #mandatory

 #// A URL to query for updates for this mod. See the JSON update specification https://mcforge.readthedocs.io/en/latest/gettingstarted/autoupdate/
 #//updateJSONURL="https://change.me.example.invalid/updates.json" #optional

 #// A URL for the "homepage" for this mod, displayed in the mod UI
-#//displayURL="https://change.me.to.your.mods.homepage.example.invalid/" #optional
+displayURL="https://www.curseforge.com/minecraft/mc-mods/lod-level-of-detail" #optional

 #// A file name (in the root of the mod JAR) containing a logo for display
-#//logoFile="examplemod.png" #optional
+logoFile="logo.png" #optional

 #// A text field displayed in the mod UI
 credits="TechnoVision, Vike, and Darkhax for their modding tutorials." #optional

 #// A text field displayed in the mod UI
-authors="James Seibel" #optional
+authors="James Seibel, Leonardo Amato, and Cola" #optional

 #// The description text for the mod (multi line!) (#mandatory)
-description='''
-This mod generates and renders simplified chunks beyond the normal view distance, at a low performance cost.
-'''
+description='''This mod generates and renders simplified terrain beyond the normal view distance, at a low performance cost.'''
@@ -1,6 +1,6 @@
 {
 	"required": true,
-	"package": "com.backsun.lod.mixin",
+	"package": "com.seibel.lod.mixin",
 	"compatibilityLevel": "JAVA_8",
 	"refmap": "lod.refmap.json",
 	"mixins": [
--- a/Show More
+++ b/Show More