Close #30 and 31 (LODs rendering on top of the player and distance based rendering)

I can't currently test if this fixed the problem since I don't have a Linux install to test on.

.gitignore

@@ -22,4 +22,5 @@ eclipse
 run
 
 # Files from Forge MDK
+logs
 forge*changelog.txt

CREDITS.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.
-

LICENSE.txt

@@ -1,520 +0,0 @@
-Unless noted below, Minecraft Forge, Forge Mod Loader, and all 
-parts herein are licensed under the terms of the LGPL 2.1 found
-here http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt and 
-copied below.
-
-Homepage: http://minecraftforge.net/
-          https://github.com/MinecraftForge/MinecraftForge
-          
-
-A note on authorship:
-All source artifacts are property of their original author, with
-the exclusion of the contents of the patches directory and others
-copied from it from time to time. Authorship of the contents of
-the patches directory is retained by the Minecraft Forge project.
-This is because the patches are partially machine generated
-artifacts, and are changed heavily due to the way forge works.
-Individual attribution within them is impossible.
-
-Consent:
-All contributions to Forge must consent to the release of any
-patch content to the Forge project.
-
-A note on infectivity:
-The LGPL is chosen specifically so that projects may depend on Forge
-features without being infected with its license. That is the 
-purpose of the LGPL. Mods and others using this code via ordinary
-Java mechanics for referencing libraries are specifically not bound
-by Forge's license for the Mod code.
-
-
-=== MCP Data ===
-This software includes data from the Minecraft Coder Pack (MCP), with kind permission
-from them. The license to MCP data is not transitive - distribution of this data by
-third parties requires independent licensing from the MCP team. This data is not
-redistributable without permission from the MCP team.
-
-=== Sharing ===
-I grant permission for some parts of FML to be redistributed outside the terms of the LGPL, for the benefit of
-the minecraft modding community. All contributions to these parts should be licensed under the same additional grant.
-
--- Runtime patcher --
-License is granted to redistribute the runtime patcher code (src/main/java/net/minecraftforge/fml/common/patcher
-and subdirectories) under any alternative open source license as classified by the OSI (http://opensource.org/licenses)
-
--- ASM transformers --
-License is granted to redistribute the ASM transformer code (src/main/java/net/minecraftforge/common/asm/ and subdirectories)
-under any alternative open source license as classified by the OSI (http://opensource.org/licenses)
-
-=========================================================================
-This software includes portions from the Apache Maven project at
-http://maven.apache.org/ specifically the ComparableVersion.java code. It is
-included based on guidelines at
-http://www.softwarefreedom.org/resources/2007/gpl-non-gpl-collaboration.html
-with notices intact. The only change is a non-functional change of package name.
-
-This software contains a partial repackaging of javaxdelta, a BSD licensed program for generating
-binary differences and applying them, sourced from the subversion at http://sourceforge.net/projects/javaxdelta/
-authored by genman, heikok, pivot.
-The only changes are to replace some Trove collection types with standard Java collections, and repackaged.
-=========================================================================
-
-
-                  GNU LESSER GENERAL PUBLIC LICENSE
-                       Version 2.1, February 1999
-
- Copyright (C) 1991, 1999 Free Software Foundation, Inc.
- 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
-[This is the first released version of the Lesser GPL.  It also counts
- as the successor of the GNU Library Public License, version 2, hence
- the version number 2.1.]
-
-                            Preamble
-
-  The licenses for most software are designed to take away your
-freedom to share and change it.  By contrast, the GNU General Public
-Licenses are intended to guarantee your freedom to share and change
-free software--to make sure the software is free for all its users.
-
-  This license, the Lesser General Public License, applies to some
-specially designated software packages--typically libraries--of the
-Free Software Foundation and other authors who decide to use it.  You
-can use it too, but we suggest you first think carefully about whether
-this license or the ordinary General Public License is the better
-strategy to use in any particular case, based on the explanations below.
-
-  When we speak of free software, we are referring to freedom of use,
-not price.  Our General Public Licenses are designed to make sure that
-you have the freedom to distribute copies of free software (and charge
-for this service if you wish); that you receive source code or can get
-it if you want it; that you can change the software and use pieces of
-it in new free programs; and that you are informed that you can do
-these things.
-
-  To protect your rights, we need to make restrictions that forbid
-distributors to deny you these rights or to ask you to surrender these
-rights.  These restrictions translate to certain responsibilities for
-you if you distribute copies of the library or if you modify it.
-
-  For example, if you distribute copies of the library, whether gratis
-or for a fee, you must give the recipients all the rights that we gave
-you.  You must make sure that they, too, receive or can get the source
-code.  If you link other code with the library, you must provide
-complete object files to the recipients, so that they can relink them
-with the library after making changes to the library and recompiling
-it.  And you must show them these terms so they know their rights.
-
-  We protect your rights with a two-step method: (1) we copyright the
-library, and (2) we offer you this license, which gives you legal
-permission to copy, distribute and/or modify the library.
-
-  To protect each distributor, we want to make it very clear that
-there is no warranty for the free library.  Also, if the library is
-modified by someone else and passed on, the recipients should know
-that what they have is not the original version, so that the original
-author's reputation will not be affected by problems that might be
-introduced by others.
-
-  Finally, software patents pose a constant threat to the existence of
-any free program.  We wish to make sure that a company cannot
-effectively restrict the users of a free program by obtaining a
-restrictive license from a patent holder.  Therefore, we insist that
-any patent license obtained for a version of the library must be
-consistent with the full freedom of use specified in this license.
-
-  Most GNU software, including some libraries, is covered by the
-ordinary GNU General Public License.  This license, the GNU Lesser
-General Public License, applies to certain designated libraries, and
-is quite different from the ordinary General Public License.  We use
-this license for certain libraries in order to permit linking those
-libraries into non-free programs.
-
-  When a program is linked with a library, whether statically or using
-a shared library, the combination of the two is legally speaking a
-combined work, a derivative of the original library.  The ordinary
-General Public License therefore permits such linking only if the
-entire combination fits its criteria of freedom.  The Lesser General
-Public License permits more lax criteria for linking other code with
-the library.
-
-  We call this license the "Lesser" General Public License because it
-does Less to protect the user's freedom than the ordinary General
-Public License.  It also provides other free software developers Less
-of an advantage over competing non-free programs.  These disadvantages
-are the reason we use the ordinary General Public License for many
-libraries.  However, the Lesser license provides advantages in certain
-special circumstances.
-
-  For example, on rare occasions, there may be a special need to
-encourage the widest possible use of a certain library, so that it becomes
-a de-facto standard.  To achieve this, non-free programs must be
-allowed to use the library.  A more frequent case is that a free
-library does the same job as widely used non-free libraries.  In this
-case, there is little to gain by limiting the free library to free
-software only, so we use the Lesser General Public License.
-
-  In other cases, permission to use a particular library in non-free
-programs enables a greater number of people to use a large body of
-free software.  For example, permission to use the GNU C Library in
-non-free programs enables many more people to use the whole GNU
-operating system, as well as its variant, the GNU/Linux operating
-system.
-
-  Although the Lesser General Public License is Less protective of the
-users' freedom, it does ensure that the user of a program that is
-linked with the Library has the freedom and the wherewithal to run
-that program using a modified version of the Library.
-
-  The precise terms and conditions for copying, distribution and
-modification follow.  Pay close attention to the difference between a
-"work based on the library" and a "work that uses the library".  The
-former contains code derived from the library, whereas the latter must
-be combined with the library in order to run.
-
-                  GNU LESSER GENERAL PUBLIC LICENSE
-   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
-
-  0. This License Agreement applies to any software library or other
-program which contains a notice placed by the copyright holder or
-other authorized party saying it may be distributed under the terms of
-this Lesser General Public License (also called "this License").
-Each licensee is addressed as "you".
-
-  A "library" means a collection of software functions and/or data
-prepared so as to be conveniently linked with application programs
-(which use some of those functions and data) to form executables.
-
-  The "Library", below, refers to any such software library or work
-which has been distributed under these terms.  A "work based on the
-Library" means either the Library or any derivative work under
-copyright law: that is to say, a work containing the Library or a
-portion of it, either verbatim or with modifications and/or translated
-straightforwardly into another language.  (Hereinafter, translation is
-included without limitation in the term "modification".)
-
-  "Source code" for a work means the preferred form of the work for
-making modifications to it.  For a library, complete source code means
-all the source code for all modules it contains, plus any associated
-interface definition files, plus the scripts used to control compilation
-and installation of the library.
-
-  Activities other than copying, distribution and modification are not
-covered by this License; they are outside its scope.  The act of
-running a program using the Library is not restricted, and output from
-such a program is covered only if its contents constitute a work based
-on the Library (independent of the use of the Library in a tool for
-writing it).  Whether that is true depends on what the Library does
-and what the program that uses the Library does.
-
-  1. You may copy and distribute verbatim copies of the Library's
-complete source code as you receive it, in any medium, provided that
-you conspicuously and appropriately publish on each copy an
-appropriate copyright notice and disclaimer of warranty; keep intact
-all the notices that refer to this License and to the absence of any
-warranty; and distribute a copy of this License along with the
-Library.
-
-  You may charge a fee for the physical act of transferring a copy,
-and you may at your option offer warranty protection in exchange for a
-fee.
-
-  2. You may modify your copy or copies of the Library or any portion
-of it, thus forming a work based on the Library, and copy and
-distribute such modifications or work under the terms of Section 1
-above, provided that you also meet all of these conditions:
-
-    a) The modified work must itself be a software library.
-
-    b) You must cause the files modified to carry prominent notices
-    stating that you changed the files and the date of any change.
-
-    c) You must cause the whole of the work to be licensed at no
-    charge to all third parties under the terms of this License.
-
-    d) If a facility in the modified Library refers to a function or a
-    table of data to be supplied by an application program that uses
-    the facility, other than as an argument passed when the facility
-    is invoked, then you must make a good faith effort to ensure that,
-    in the event an application does not supply such function or
-    table, the facility still operates, and performs whatever part of
-    its purpose remains meaningful.
-
-    (For example, a function in a library to compute square roots has
-    a purpose that is entirely well-defined independent of the
-    application.  Therefore, Subsection 2d requires that any
-    application-supplied function or table used by this function must
-    be optional: if the application does not supply it, the square
-    root function must still compute square roots.)
-
-These requirements apply to the modified work as a whole.  If
-identifiable sections of that work are not derived from the Library,
-and can be reasonably considered independent and separate works in
-themselves, then this License, and its terms, do not apply to those
-sections when you distribute them as separate works.  But when you
-distribute the same sections as part of a whole which is a work based
-on the Library, the distribution of the whole must be on the terms of
-this License, whose permissions for other licensees extend to the
-entire whole, and thus to each and every part regardless of who wrote
-it.
-
-Thus, it is not the intent of this section to claim rights or contest
-your rights to work written entirely by you; rather, the intent is to
-exercise the right to control the distribution of derivative or
-collective works based on the Library.
-
-In addition, mere aggregation of another work not based on the Library
-with the Library (or with a work based on the Library) on a volume of
-a storage or distribution medium does not bring the other work under
-the scope of this License.
-
-  3. You may opt to apply the terms of the ordinary GNU General Public
-License instead of this License to a given copy of the Library.  To do
-this, you must alter all the notices that refer to this License, so
-that they refer to the ordinary GNU General Public License, version 2,
-instead of to this License.  (If a newer version than version 2 of the
-ordinary GNU General Public License has appeared, then you can specify
-that version instead if you wish.)  Do not make any other change in
-these notices.
-
-  Once this change is made in a given copy, it is irreversible for
-that copy, so the ordinary GNU General Public License applies to all
-subsequent copies and derivative works made from that copy.
-
-  This option is useful when you wish to copy part of the code of
-the Library into a program that is not a library.
-
-  4. You may copy and distribute the Library (or a portion or
-derivative of it, under Section 2) in object code or executable form
-under the terms of Sections 1 and 2 above provided that you accompany
-it with the complete corresponding machine-readable source code, which
-must be distributed under the terms of Sections 1 and 2 above on a
-medium customarily used for software interchange.
-
-  If distribution of object code is made by offering access to copy
-from a designated place, then offering equivalent access to copy the
-source code from the same place satisfies the requirement to
-distribute the source code, even though third parties are not
-compelled to copy the source along with the object code.
-
-  5. A program that contains no derivative of any portion of the
-Library, but is designed to work with the Library by being compiled or
-linked with it, is called a "work that uses the Library".  Such a
-work, in isolation, is not a derivative work of the Library, and
-therefore falls outside the scope of this License.
-
-  However, linking a "work that uses the Library" with the Library
-creates an executable that is a derivative of the Library (because it
-contains portions of the Library), rather than a "work that uses the
-library".  The executable is therefore covered by this License.
-Section 6 states terms for distribution of such executables.
-
-  When a "work that uses the Library" uses material from a header file
-that is part of the Library, the object code for the work may be a
-derivative work of the Library even though the source code is not.
-Whether this is true is especially significant if the work can be
-linked without the Library, or if the work is itself a library.  The
-threshold for this to be true is not precisely defined by law.
-
-  If such an object file uses only numerical parameters, data
-structure layouts and accessors, and small macros and small inline
-functions (ten lines or less in length), then the use of the object
-file is unrestricted, regardless of whether it is legally a derivative
-work.  (Executables containing this object code plus portions of the
-Library will still fall under Section 6.)
-
-  Otherwise, if the work is a derivative of the Library, you may
-distribute the object code for the work under the terms of Section 6.
-Any executables containing that work also fall under Section 6,
-whether or not they are linked directly with the Library itself.
-
-  6. As an exception to the Sections above, you may also combine or
-link a "work that uses the Library" with the Library to produce a
-work containing portions of the Library, and distribute that work
-under terms of your choice, provided that the terms permit
-modification of the work for the customer's own use and reverse
-engineering for debugging such modifications.
-
-  You must give prominent notice with each copy of the work that the
-Library is used in it and that the Library and its use are covered by
-this License.  You must supply a copy of this License.  If the work
-during execution displays copyright notices, you must include the
-copyright notice for the Library among them, as well as a reference
-directing the user to the copy of this License.  Also, you must do one
-of these things:
-
-    a) Accompany the work with the complete corresponding
-    machine-readable source code for the Library including whatever
-    changes were used in the work (which must be distributed under
-    Sections 1 and 2 above); and, if the work is an executable linked
-    with the Library, with the complete machine-readable "work that
-    uses the Library", as object code and/or source code, so that the
-    user can modify the Library and then relink to produce a modified
-    executable containing the modified Library.  (It is understood
-    that the user who changes the contents of definitions files in the
-    Library will not necessarily be able to recompile the application
-    to use the modified definitions.)
-
-    b) Use a suitable shared library mechanism for linking with the
-    Library.  A suitable mechanism is one that (1) uses at run time a
-    copy of the library already present on the user's computer system,
-    rather than copying library functions into the executable, and (2)
-    will operate properly with a modified version of the library, if
-    the user installs one, as long as the modified version is
-    interface-compatible with the version that the work was made with.
-
-    c) Accompany the work with a written offer, valid for at
-    least three years, to give the same user the materials
-    specified in Subsection 6a, above, for a charge no more
-    than the cost of performing this distribution.
-
-    d) If distribution of the work is made by offering access to copy
-    from a designated place, offer equivalent access to copy the above
-    specified materials from the same place.
-
-    e) Verify that the user has already received a copy of these
-    materials or that you have already sent this user a copy.
-
-  For an executable, the required form of the "work that uses the
-Library" must include any data and utility programs needed for
-reproducing the executable from it.  However, as a special exception,
-the materials to be distributed need not include anything that is
-normally distributed (in either source or binary form) with the major
-components (compiler, kernel, and so on) of the operating system on
-which the executable runs, unless that component itself accompanies
-the executable.
-
-  It may happen that this requirement contradicts the license
-restrictions of other proprietary libraries that do not normally
-accompany the operating system.  Such a contradiction means you cannot
-use both them and the Library together in an executable that you
-distribute.
-
-  7. You may place library facilities that are a work based on the
-Library side-by-side in a single library together with other library
-facilities not covered by this License, and distribute such a combined
-library, provided that the separate distribution of the work based on
-the Library and of the other library facilities is otherwise
-permitted, and provided that you do these two things:
-
-    a) Accompany the combined library with a copy of the same work
-    based on the Library, uncombined with any other library
-    facilities.  This must be distributed under the terms of the
-    Sections above.
-
-    b) Give prominent notice with the combined library of the fact
-    that part of it is a work based on the Library, and explaining
-    where to find the accompanying uncombined form of the same work.
-
-  8. You may not copy, modify, sublicense, link with, or distribute
-the Library except as expressly provided under this License.  Any
-attempt otherwise to copy, modify, sublicense, link with, or
-distribute the Library is void, and will automatically terminate your
-rights under this License.  However, parties who have received copies,
-or rights, from you under this License will not have their licenses
-terminated so long as such parties remain in full compliance.
-
-  9. You are not required to accept this License, since you have not
-signed it.  However, nothing else grants you permission to modify or
-distribute the Library or its derivative works.  These actions are
-prohibited by law if you do not accept this License.  Therefore, by
-modifying or distributing the Library (or any work based on the
-Library), you indicate your acceptance of this License to do so, and
-all its terms and conditions for copying, distributing or modifying
-the Library or works based on it.
-
-  10. Each time you redistribute the Library (or any work based on the
-Library), the recipient automatically receives a license from the
-original licensor to copy, distribute, link with or modify the Library
-subject to these terms and conditions.  You may not impose any further
-restrictions on the recipients' exercise of the rights granted herein.
-You are not responsible for enforcing compliance by third parties with
-this License.
-
-  11. If, as a consequence of a court judgment or allegation of patent
-infringement or for any other reason (not limited to patent issues),
-conditions are imposed on you (whether by court order, agreement or
-otherwise) that contradict the conditions of this License, they do not
-excuse you from the conditions of this License.  If you cannot
-distribute so as to satisfy simultaneously your obligations under this
-License and any other pertinent obligations, then as a consequence you
-may not distribute the Library at all.  For example, if a patent
-license would not permit royalty-free redistribution of the Library by
-all those who receive copies directly or indirectly through you, then
-the only way you could satisfy both it and this License would be to
-refrain entirely from distribution of the Library.
-
-If any portion of this section is held invalid or unenforceable under any
-particular circumstance, the balance of the section is intended to apply,
-and the section as a whole is intended to apply in other circumstances.
-
-It is not the purpose of this section to induce you to infringe any
-patents or other property right claims or to contest validity of any
-such claims; this section has the sole purpose of protecting the
-integrity of the free software distribution system which is
-implemented by public license practices.  Many people have made
-generous contributions to the wide range of software distributed
-through that system in reliance on consistent application of that
-system; it is up to the author/donor to decide if he or she is willing
-to distribute software through any other system and a licensee cannot
-impose that choice.
-
-This section is intended to make thoroughly clear what is believed to
-be a consequence of the rest of this License.
-
-  12. If the distribution and/or use of the Library is restricted in
-certain countries either by patents or by copyrighted interfaces, the
-original copyright holder who places the Library under this License may add
-an explicit geographical distribution limitation excluding those countries,
-so that distribution is permitted only in or among countries not thus
-excluded.  In such case, this License incorporates the limitation as if
-written in the body of this License.
-
-  13. The Free Software Foundation may publish revised and/or new
-versions of the Lesser General Public License from time to time.
-Such new versions will be similar in spirit to the present version,
-but may differ in detail to address new problems or concerns.
-
-Each version is given a distinguishing version number.  If the Library
-specifies a version number of this License which applies to it and
-"any later version", you have the option of following the terms and
-conditions either of that version or of any later version published by
-the Free Software Foundation.  If the Library does not specify a
-license version number, you may choose any version ever published by
-the Free Software Foundation.
-
-  14. If you wish to incorporate parts of the Library into other free
-programs whose distribution conditions are incompatible with these,
-write to the author to ask for permission.  For software which is
-copyrighted by the Free Software Foundation, write to the Free
-Software Foundation; we sometimes make exceptions for this.  Our
-decision will be guided by the two goals of preserving the free status
-of all derivatives of our free software and of promoting the sharing
-and reuse of software generally.
-
-                            NO WARRANTY
-
-  15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
-WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
-EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
-OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
-KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
-LIBRARY IS WITH YOU.  SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
-THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
-
-  16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
-WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
-AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
-FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
-CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
-LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
-RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
-FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
-SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
-DAMAGES.
-
-                     END OF TERMS AND CONDITIONS

Readme.txt

@@ -12,9 +12,6 @@ Forge version: 1.16.4-35.1.4
 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.
 
 
 ========================

build.gradle

@@ -3,7 +3,9 @@ buildscript {
         maven { url = 'https://files.minecraftforge.net/maven' }
         jcenter()
         mavenCentral()
-		maven { url='https://dist.creeper.host/Sponge/maven' }
+		maven { url = 'https://repo.spongepowered.org/maven/' }
+		// potential replacement in case of problems:
+		// https://dist.creeper.host/Sponge/maven 
     }
     dependencies {
         classpath group: 'net.minecraftforge.gradle', name: 'ForgeGradle', version: '3.+', changing: true
@@ -16,7 +18,7 @@ apply plugin: 'org.spongepowered.mixin'
 apply plugin: 'eclipse'
 apply plugin: 'maven-publish'
 
-version = 'a1'
+version = 'a1.2'
 group = 'com.backsun.lod'
 archivesBaseName = 'lod_1.16.4'
 

src/main/java/com/backsun/lod/builders/LodBufferBuilder.java

@@ -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);
-	}
-	
-}

src/main/java/com/backsun/lod/builders/LodBuilder.java

@@ -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;
-	}
-}

src/main/java/com/backsun/lod/handlers/LodDimensionFileHandler.java

@@ -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;
-		}
-	}
-	
-	
-}

src/main/java/com/backsun/lod/mixin/MixinWorldRenderer.java

@@ -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);
-	}
-}

src/main/java/com/backsun/lod/objects/LodChunk.java

@@ -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;
-	}
-}

src/main/java/com/backsun/lod/objects/LodWorld.java

@@ -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;
-	}
-}

src/main/java/com/backsun/lod/proxy/ClientProxy.java

@@ -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());
-	}
-	
-	
-}

src/main/java/com/backsun/lod/renderer/RenderGlobalHook.java

@@ -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);
-	}
-}

src/main/java/com/backsun/lod/renderer/RenderUtil.java

@@ -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);
-	}
-	
-}

src/main/java/com/backsun/lod/util/LodConfig.java

@@ -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!");
-    }
-    
-    
-    
-    
-}

src/main/java/com/backsun/lod/util/LodUtils.java

@@ -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;
-	}
-}

src/main/java/com/backsun/lod/util/ReflectionHandler.java

@@ -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;
-		}
-	}
-	
-}

src/main/java/com/backsun/lod/util/enums/DrawMode.java

@@ -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;
-	}
-}

src/main/java/com/backsun/lod/util/enums/LodLocation.java

@@ -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;
-	}
-}

src/main/java/com/seibel/lod/LodMain.java

@@ -1,7 +1,7 @@
-package com.backsun.lod;
+package com.seibel.lod;
 
-import com.backsun.lod.proxy.ClientProxy;
-import com.backsun.lod.util.LodConfig;
+import com.seibel.lod.handlers.LodConfig;
+import com.seibel.lod.proxy.ClientProxy;
 
 import net.minecraft.client.Minecraft;
 import net.minecraftforge.common.MinecraftForge;

src/main/java/com/seibel/lod/ModInfo.java

@@ -1,15 +1,15 @@
-package com.backsun.lod;
+package com.seibel.lod;
 
 /**
  * This file is similar to mcmod.info
  * 
  * @author James Seibel
- * @version 02-17-2021
+ * @version 05-31-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";
+	public static final String VERSION = "a1.2";
 }

src/main/java/com/seibel/lod/builders/LodBufferBuilder.java

@@ -0,0 +1,355 @@
+package com.seibel.lod.builders;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+
+import org.lwjgl.opengl.GL11;
+
+import com.seibel.lod.builders.worldGeneration.LodChunkGenWorker;
+import com.seibel.lod.handlers.LodConfig;
+import com.seibel.lod.objects.LodChunk;
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.objects.NearFarBuffer;
+import com.seibel.lod.render.LodRenderer;
+import com.seibel.lod.util.LodUtil;
+
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.renderer.BufferBuilder;
+import net.minecraft.util.math.ChunkPos;
+import net.minecraft.world.biome.BiomeContainer;
+import net.minecraft.world.chunk.ChunkStatus;
+import net.minecraft.world.server.ServerWorld;
+import net.minecraftforge.common.WorldWorkerManager;
+
+/**
+ * This object is used to create NearFarBuffer objects.
+ * 
+ * @author James Seibel
+ * @version 06-19-2021
+ */
+public class LodBufferBuilder
+{
+	private Minecraft mc;
+	
+	/** This holds the thread used to generate new LODs off the main thread. */
+	private ExecutorService genThread = Executors.newSingleThreadExecutor();
+	
+	private LodBuilder lodBuilder;
+	
+	/** The buffers that are used to create LODs using near fog */
+	public volatile BufferBuilder buildableNearBuffer;
+	/** The buffers that are used to create LODs using far fog */
+	public volatile BufferBuilder buildableFarBuffer;
+	
+	/** if this is true the LOD buffers are currently being
+	 * regenerated. */
+	public volatile boolean generatingBuffers = 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;
+	
+	/** If this is greater than 0 no new chunk generation requests will be made
+	 * this is to prevent chunks from being generated for a long time in an area
+	 * the player is no longer in. */
+	public volatile int numberOfChunksWaitingToGenerate = 0;
+	
+	/** 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) */
+	public int maxChunkGenRequests = Runtime.getRuntime().availableProcessors();
+	
+	
+	public LodBufferBuilder(LodBuilder newLodBuilder)
+	{
+		mc = Minecraft.getInstance();
+		lodBuilder = newLodBuilder;
+	}
+	
+	
+	private BiomeContainer biomeContainer = null;
+	private LodDimension previousDimension = null;
+	
+
+	/**
+	 * Create a thread to asynchronously generate LOD buffers
+	 * centered around the given camera X and Z.
+	 * <br>
+	 * This method will write to the drawableNearBuffers and drawableFarBuffers.
+	 * <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,
+			double playerX, double playerZ, int numbChunksWide)
+	{
+		// only allow one generation process to happen at a time
+		if (generatingBuffers)
+			return;
+		
+		if (buildableNearBuffer == null || buildableFarBuffer == null)
+			throw new IllegalStateException("generateLodBuffersAsync was called before the buildableNearBuffer and buildableFarBuffer were created.");
+		
+		if (previousDimension != lodDim)
+		{
+			biomeContainer = LodUtil.getServerWorldFromDimension(lodDim.dimension).getChunk(0, 0, ChunkStatus.EMPTY).getBiomes();
+			previousDimension = lodDim;
+		}
+		
+		
+		
+		generatingBuffers = true;
+		
+		
+		
+		// this seemingly useless math is required,
+		// just using (int) playerX/Z 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(()->
+		{
+			// index of the chunk currently being added to the
+			// generation list
+			int chunkGenIndex = 0;
+			
+			ChunkPos[] chunksToGen = new ChunkPos[maxChunkGenRequests];
+			// if we don't have a full number of chunks to generate in chunksToGen
+			// we can top it off from the reserve
+			ChunkPos[] chunksToGenReserve = new ChunkPos[maxChunkGenRequests];
+			int minChunkDist = Integer.MAX_VALUE;
+			ChunkPos playerChunkPos = new ChunkPos((int)playerX / LodChunk.WIDTH, (int)playerZ / LodChunk.WIDTH);
+			
+			
+			// generate our new buildable buffers
+			buildableNearBuffer.begin(GL11.GL_QUADS, LodRenderer.LOD_VERTEX_FORMAT);
+			buildableFarBuffer.begin(GL11.GL_QUADS, LodRenderer.LOD_VERTEX_FORMAT);
+			
+			// x axis
+			for (int i = 0; i < numbChunksWide; i++)
+			{
+				// z axis
+				for (int j = 0; j < numbChunksWide; j++)
+				{
+					int chunkX = i + (startX / LodChunk.WIDTH);
+					int chunkZ = j + (startZ / LodChunk.WIDTH);
+					
+					// skip any chunks that Minecraft is going to render
+					if(isCoordInCenterArea(i, j, (numbChunksWide / 2)) 
+						&& renderer.vanillaRenderedChunks.contains(new ChunkPos(chunkX, chunkZ)))
+					{
+						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;
+					
+					LodChunk lod = lodDim.getLodFromCoordinates(chunkX, chunkZ);
+					
+					if (lod == null || lod.isLodEmpty())
+					{
+						// generate a new chunk if no chunk currently exists
+						// and we aren't waiting on any other chunks to generate
+						if (lod == null && numberOfChunksWaitingToGenerate < maxChunkGenRequests)
+						{
+							ChunkPos pos = new ChunkPos(chunkX, chunkZ);
+							
+							// determine if this position is closer to the player
+							// than the previous
+							int newDistance = playerChunkPos.getChessboardDistance(pos);
+							
+							if (newDistance < minChunkDist)
+							{
+								// this chunk is closer, clear any previous
+								// positions and update the new minimum distance
+								minChunkDist = newDistance;
+								chunksToGenReserve = chunksToGen;
+								
+								chunkGenIndex = 0;
+								chunksToGen = new ChunkPos[maxChunkGenRequests];
+								chunksToGen[chunkGenIndex] = pos;
+								chunkGenIndex++;
+							}
+							else if (newDistance <= minChunkDist)
+							{
+								// this chunk position is as close or closers than the
+								// minimum distance
+								if(chunkGenIndex < maxChunkGenRequests)
+								{
+									// we are still under the number of chunks to generate
+									// add this position to the list
+									chunksToGen[chunkGenIndex] = pos;
+									chunkGenIndex++;
+								}
+							}
+							
+						}
+						// don't render this null chunk
+						continue;
+					}
+					
+					
+					BufferBuilder currentBuffer = null;
+					if (isCoordinateInNearFogArea(i, j, numbChunksWide / 2))
+						currentBuffer = buildableNearBuffer;
+					else
+						currentBuffer = buildableFarBuffer;
+					
+					// get the desired LodTemplate and
+					// add this LOD to the buffer
+					LodConfig.CLIENT.lodTemplate.get().
+						template.addLodToBuffer(currentBuffer, lodDim, lod, 
+							xOffset, yOffset, zOffset, renderer.debugging);
+				}
+			}
+			
+			// TODO add a way for a server side mod to generate chunks requested here
+			if(mc.isIntegratedServerRunning())
+			{
+		        ServerWorld serverWorld = LodUtil.getServerWorldFromDimension(lodDim.dimension);
+				
+		        // make sure we have as many chunks to generate as we are allowed
+		        if (chunkGenIndex < maxChunkGenRequests)
+		        {
+		        	for(int i = chunkGenIndex, j = 0; i < maxChunkGenRequests; i++, j++)
+		        	{
+		        		chunksToGen[i] = chunksToGenReserve[j];
+		        	}
+		        }
+		        
+				// start chunk generation
+				for(ChunkPos chunkPos : chunksToGen)
+				{
+					if(chunkPos == null)
+						break;
+					
+					numberOfChunksWaitingToGenerate++;
+					
+					LodChunkGenWorker genWorker = new LodChunkGenWorker(chunkPos, renderer, lodBuilder, this, lodDim, serverWorld, biomeContainer);
+					WorldWorkerManager.addWorker(genWorker);
+				}
+			}
+			
+			// finish the buffer building
+			buildableNearBuffer.finishDrawing();
+			buildableFarBuffer.finishDrawing();
+			
+			// mark that the buildable buffers as ready to swap
+			generatingBuffers = false;
+			switchBuffers = true;
+		});
+		
+		genThread.execute(t);
+		
+		return;
+	}
+	
+	
+	
+	
+	
+	
+	
+	
+	
+	
+	//====================//
+	// generation helpers //
+	//====================//
+	
+	/**
+	 * 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);
+	}
+	
+	
+	/**
+	 * 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);
+	}
+	
+	
+	
+	
+	
+	//===============================//
+	// BufferBuilder related methods //
+	//===============================//
+	
+	
+	/**
+	 * Called from the LodRenderer to create the
+	 * BufferBuilders at the right size.
+	 * 
+	 * @param bufferMaxCapacity
+	 */
+	public void setupBuffers(int bufferMaxCapacity)
+	{
+		buildableNearBuffer = new BufferBuilder(bufferMaxCapacity);
+		buildableFarBuffer = new BufferBuilder(bufferMaxCapacity);
+	}
+	
+	/**
+	 * Swap the drawable and buildable buffers and return
+	 * the old drawable buffers.
+	 * @param drawableNearBuffer
+	 * @param drawableFarBuffer
+	 */
+	public NearFarBuffer swapBuffers(BufferBuilder drawableNearBuffer, BufferBuilder drawableFarBuffer)
+	{
+		// swap the BufferBuilders
+		BufferBuilder tmp = buildableNearBuffer;
+		buildableNearBuffer = drawableNearBuffer;
+		drawableNearBuffer = tmp;
+		
+		tmp = buildableFarBuffer;
+		buildableFarBuffer = drawableFarBuffer;
+		drawableFarBuffer = tmp;
+		
+		
+		// the buffers have been swapped
+		switchBuffers = false;
+		
+		return new NearFarBuffer(drawableNearBuffer, drawableFarBuffer);
+	}
+	
+	/**
+	 * 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 switchBuffers;
+	}
+	
+	
+	
+	
+}

src/main/java/com/seibel/lod/builders/LodBuilder.java

@@ -0,0 +1,493 @@
+package com.seibel.lod.builders;
+
+import java.awt.Color;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+
+import com.seibel.lod.enums.LodDetail;
+import com.seibel.lod.handlers.LodConfig;
+import com.seibel.lod.objects.LodChunk;
+import com.seibel.lod.objects.LodDataPoint;
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.objects.LodWorld;
+import com.seibel.lod.util.LodUtil;
+
+import net.minecraft.block.BlockState;
+import net.minecraft.block.Blocks;
+import net.minecraft.block.FlowingFluidBlock;
+import net.minecraft.block.GrassBlock;
+import net.minecraft.block.LeavesBlock;
+import net.minecraft.world.DimensionType;
+import net.minecraft.world.IWorld;
+import net.minecraft.world.biome.Biome;
+import net.minecraft.world.chunk.ChunkSection;
+import net.minecraft.world.chunk.IChunk;
+import net.minecraft.world.gen.Heightmap;
+
+/**
+ * This object is in charge of creating Lod
+ * related objects. 
+ * (specifically: Lod World, Dimension, Region, and Chunk objects)
+ * 
+ * @author James Seibel
+ * @version 6-27-2021
+ */
+public class LodBuilder
+{
+	private ExecutorService lodGenThreadPool = Executors.newSingleThreadExecutor();
+	
+	/** Default size of any LOD regions we use */
+	public int regionWidth = 5;
+	
+	
+	public static final int CHUNK_DATA_WIDTH = LodChunk.WIDTH;
+	public static final int CHUNK_SECTION_HEIGHT = LodChunk.WIDTH;
+	
+	
+	
+	public LodBuilder()
+	{
+		
+	}
+	
+	
+	public void generateLodChunkAsync(IChunk chunk, LodWorld lodWorld, IWorld world)
+	{
+		generateLodChunkAsync(chunk, new LodBuilderConfig(), lodWorld, world);
+	}
+	
+	public void generateLodChunkAsync(IChunk chunk, LodBuilderConfig config, LodWorld lodWorld, IWorld world)
+	{
+		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
+			{
+				DimensionType dim = world.getDimensionType();
+				
+				LodChunk lod = generateLodFromChunk(chunk, config);
+				
+				LodDimension lodDim;
+				
+				if (lodWorld.getLodDimension(dim) == null)
+				{
+					lodDim = new LodDimension(dim, lodWorld, 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;
+	}
+	
+	
+	
+	
+	
+	/**
+	 * Creates a LodChunk for a chunk in the given world.
+	 * 
+	 * @throws IllegalArgumentException 
+	 * thrown if either the chunk or world is null.
+	 */
+	public LodChunk generateLodFromChunk(IChunk chunk) throws IllegalArgumentException
+	{
+		return generateLodFromChunk(chunk, new LodBuilderConfig());
+	}
+	
+	/**
+	 * Creates a LodChunk for a chunk in the given world.
+	 * 
+	 * @throws IllegalArgumentException 
+	 * thrown if either the chunk or world is null.
+	 */
+	public LodChunk generateLodFromChunk(IChunk chunk, LodBuilderConfig config) throws IllegalArgumentException
+	{
+		if(chunk == null)
+			throw new IllegalArgumentException("generateLodFromChunk given a null chunk");
+		
+		
+		LodDetail detail = LodConfig.CLIENT.lodDetail.get();
+		LodDataPoint[][] dataPoints = new LodDataPoint[detail.dataPointLengthCount][detail.dataPointLengthCount];
+		
+		for(int i = 0; i < detail.dataPointLengthCount * detail.dataPointLengthCount; i++)
+		{
+			int startX = detail.startX[i];
+			int startZ = detail.startZ[i];
+			int endX = detail.endX[i];
+			int endZ = detail.endZ[i];
+			
+			Color color;
+			
+			color = generateLodColorForArea(chunk, config, startX, startZ, endX, endZ);
+
+			
+			short height;
+			short depth;
+			
+			if (!config.useHeightmap)
+			{
+				height = determineHeightPointForArea(chunk.getSections(), startX, startZ, endX, endZ);
+				depth = determineBottomPointForArea(chunk.getSections(), startX, startZ, endX, endZ);
+			}
+			else
+			{
+				height = determineHeightPoint(chunk.getHeightmap(LodChunk.DEFAULT_HEIGHTMAP), startX, startZ, endX, endZ);
+				depth = 0;
+			}
+			
+			int x = i / detail.dataPointLengthCount;
+			int z = i % detail.dataPointLengthCount;
+			
+			dataPoints[x][z] = new LodDataPoint(height, depth, color);
+		}
+		
+		return new LodChunk(chunk.getPos(), dataPoints, detail);
+	}
+	
+	
+	
+	
+	
+	
+	//=====================//
+	// constructor helpers //
+	//=====================//
+	
+	
+	/**
+	 * Find the lowest valid point from the bottom.
+	 * @param chunkSections
+	 * @param startX
+	 * @param startZ
+	 * @param endX
+	 * @param endZ
+	 */
+	private short determineBottomPointForArea(ChunkSection[] chunkSections, 
+			int startX, int startZ, int endX, int endZ)
+	{
+		int numberOfBlocksRequired = ((endX-startX) * (endZ-startZ) / 2);
+		
+		// search from the bottom up
+		for(int section = 0; section < CHUNK_DATA_WIDTH; section++)
+		{
+			for(int y = 0; y < CHUNK_SECTION_HEIGHT; y++)
+			{
+				int numberOfBlocksFound = 0;
+				
+				for(int x = startX; x < endX; x++)
+				{
+					for(int z = startZ; z < endZ; z++)
+					{
+						if(isLayerValidLodPoint(chunkSections, section, y, x, z))
+						{
+							numberOfBlocksFound++;
+							
+							if (numberOfBlocksFound >= numberOfBlocksRequired)
+							{
+								// we found
+								// enough blocks in this
+								// layer to count as an
+								// LOD point
+								return (short) (y + (section * CHUNK_SECTION_HEIGHT));
+							}
+						}
+					}
+				}
+			}
+		}
+		
+		// we never found a valid LOD point
+		return -1;
+	}
+	
+	/**
+	 * Find the lowest valid point from the bottom.
+	 */
+	@SuppressWarnings("unused")
+	private short determineBottomPoint(Heightmap heightmap)
+	{
+		// the heightmap only shows how high the blocks go, it
+		// doesn't have any info about how low they go
+		return 0;
+	}
+	
+	
+	
+	/**
+	 * Find the highest valid point from the Top
+	 * @param chunkSections
+	 * @param startX
+	 * @param startZ
+	 * @param endX
+	 * @param endZ
+	 */
+	private short determineHeightPointForArea(ChunkSection[] chunkSections, 
+			int startX, int startZ, int endX, int endZ)
+	{
+		int numberOfBlocksRequired = ((endX-startX) * (endZ-startZ) / 2);
+		
+		// search from the top down
+		for(int section = chunkSections.length - 1; section >= 0; section--)
+		{
+			for(int y = CHUNK_DATA_WIDTH - 1; y >= 0; y--)
+			{
+				int numberOfBlocksFound = 0;
+				
+				for(int x = startX; x < endX; x++)
+				{
+					for(int z = startZ; z < endZ; z++)
+					{
+						if(isLayerValidLodPoint(chunkSections, section, y, x, z))
+						{
+							numberOfBlocksFound++;
+							
+							if (numberOfBlocksFound >= numberOfBlocksRequired)
+							{
+								// we found
+								// enough blocks in this
+								// layer to count as an
+								// LOD point
+								return (short) (y + (section * CHUNK_SECTION_HEIGHT));
+							}
+						}
+					}
+				}
+			}
+		}
+		
+		// we never found a valid LOD point
+		return -1;
+	}
+	
+	/**
+	 * Find the highest point from the Top
+	 */
+	private short determineHeightPoint(Heightmap heightmap,
+			int startX, int startZ, int endX, int endZ)
+	{
+		short highest = 0;
+		for(int x = startX; x < endX; x++)
+		{
+			for(int z = startZ; z < endZ; z++)
+			{
+				short newHeight = (short) heightmap.getHeight(x, z);
+				if (newHeight > highest)
+					highest = newHeight;
+			}
+		}
+		
+		return highest;
+	}
+	
+	/**
+	 * Generate the color for the given chunk using biome
+	 * water color, foliage color, and grass color.
+	 * 
+	 * @param config_useSolidBlocksInColorGen <br>
+	 * 			If true we look down from the top of the <br>
+	 * 			chunk until we find a non-invisible block, and then use <br>
+	 * 			its color. If false we generate the color immediately for <br>
+	 * 			each x and z.
+	 * @param config_useBiomeColors <br>
+	 * 			If true use biome foliage, water, and grass colors, <br>
+	 * 			otherwise use the  
+	 */
+	private Color  generateLodColorForArea(IChunk chunk, LodBuilderConfig config, int startX, int startZ, int endX, int endZ)
+	{
+		ChunkSection[] chunkSections = chunk.getSections();
+		
+		int numbOfBlocks = 0;
+		int red = 0;
+		int green = 0;
+		int blue = 0;
+		
+		
+		for(int x = startX; x < endX; x++)
+		{
+			for(int z = startZ; z < endZ; z++)
+			{
+				boolean foundBlock = false;
+				
+				// go top down
+				for(int i = chunkSections.length - 1; !foundBlock && i >= 0; i--)
+				{
+					if( !foundBlock && (chunkSections[i] != null || !config.useSolidBlocksInColorGen))
+					{
+						for(int y = CHUNK_SECTION_HEIGHT - 1; !foundBlock && y >= 0; y--)
+						{
+							int colorInt = 0;
+							BlockState blockState = null;
+							
+							if (chunkSections[i] != null)
+							{
+								blockState = chunkSections[i].getBlockState(x, y, z);
+								colorInt = blockState.materialColor.colorValue;
+							}
+							
+							if(colorInt == 0 && config.useSolidBlocksInColorGen)
+							{
+								// skip air or invisible blocks
+								continue;
+							}
+							
+							if (config.useBiomeColors)
+							{
+								Biome biome = chunk.getBiomes().getNoiseBiome(x, y + i * chunkSections.length, z);
+								
+								if (biome.getCategory() == Biome.Category.OCEAN ||
+										biome.getCategory() == Biome.Category.RIVER)
+								{
+									colorInt = biome.getWaterColor();
+								}
+								else if (biome.getCategory() == Biome.Category.EXTREME_HILLS)
+								{
+									colorInt = Blocks.STONE.getMaterialColor().colorValue;
+								}
+								else if (biome.getCategory() == Biome.Category.ICY)
+								{
+									colorInt = LodUtil.colorToInt(Color.WHITE);
+								}
+								else if (biome.getCategory() == Biome.Category.THEEND)
+								{
+									colorInt = Blocks.END_STONE.getDefaultState().materialColor.colorValue;
+								}
+								else if (config.useSolidBlocksInColorGen)
+								{
+									colorInt = getColorForBlock(x, z, blockState, biome);
+								}
+								else
+								{
+									colorInt = biome.getGrassColor(x, z);
+								}
+							}
+							else
+							{
+								Biome biome = chunk.getBiomes().getNoiseBiome(x, y + i * chunkSections.length, z);
+								colorInt = getColorForBlock(x,z, blockState, biome);
+							}
+							
+							
+							Color c = LodUtil.intToColor(colorInt);
+							
+							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);
+	}
+
+
+
+	/**
+	 * Returns a color int for a given block.
+	 */
+	private int getColorForBlock(int x, int z, BlockState blockState, Biome biome)
+	{
+		int colorInt = 0;
+		
+		if (blockState == Blocks.AIR.getDefaultState())
+		{
+			colorInt = biome.getGrassColor(x, z);
+		}
+		
+		else if (blockState.getBlock() instanceof LeavesBlock)
+		{
+			Color leafColor = LodUtil.intToColor(biome.getFoliageColor()).darker();
+			colorInt = LodUtil.colorToInt(leafColor);
+		}
+		else if (blockState.getBlock() instanceof GrassBlock)
+		{
+			colorInt = biome.getGrassColor(x, z);
+		}
+		else if (blockState.getBlock() instanceof FlowingFluidBlock)
+		{
+			colorInt = biome.getWaterColor();
+		}
+		else
+		{
+			colorInt = blockState.materialColor.colorValue;
+		}
+		
+		return colorInt;
+	}
+	
+	
+	
+	/**
+	 * Is the layer between the given X, Z, and dataIndex
+	 * values a valid LOD point?
+	 */
+	private boolean isLayerValidLodPoint(
+			ChunkSection[] chunkSections,
+			int sectionIndex, int y, 
+			int x, int 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)
+			{
+				return true;
+			}
+		}
+		
+		return false;
+	}
+	
+	
+
+
+	
+	
+	
+	
+	
+}

src/main/java/com/seibel/lod/builders/LodBuilderConfig.java

@@ -0,0 +1,41 @@
+package com.seibel.lod.builders;
+
+/**
+ * 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 6-27-2021
+ */
+public class LodBuilderConfig
+{
+	public boolean useHeightmap;
+	public boolean useBiomeColors;
+	public boolean useSolidBlocksInColorGen;
+	
+	/** default settings for a normal chunk 
+	 * useHeightmap = false
+	 * useBiomeColors = false
+	 * useSolidBlocksInColorGen = true
+	 */
+	public LodBuilderConfig()
+	{
+		useHeightmap = false;
+		useBiomeColors = false;
+		useSolidBlocksInColorGen = true;
+	}
+	
+	/**
+	 * @param newUseHeightmap
+	 * @param newUseBiomeColors
+	 * @param newUseSolidBlocksInBiomeColor
+	 */
+	public LodBuilderConfig(boolean newUseHeightmap, boolean newUseBiomeColors, boolean newUseSolidBlocksInBiomeColor)
+	{
+		useHeightmap = newUseHeightmap;
+		useBiomeColors = newUseBiomeColors;
+		useSolidBlocksInColorGen = newUseSolidBlocksInBiomeColor;
+	}
+}

src/main/java/com/seibel/lod/builders/lodTemplates/AbstractLodTemplate.java

@@ -0,0 +1,37 @@
+package com.seibel.lod.builders.lodTemplates;
+
+import com.seibel.lod.enums.LodDetail;
+import com.seibel.lod.objects.LodChunk;
+import com.seibel.lod.objects.LodDimension;
+
+import net.minecraft.client.renderer.BufferBuilder;
+
+/**
+ * This is the abstract class used to create different
+ * BufferBuilders.
+ * 
+ * @author James Seibel
+ * @version 06-16-2021
+ */
+public abstract class AbstractLodTemplate
+{
+	public abstract void addLodToBuffer(BufferBuilder buffer, 
+			LodDimension lodDim, LodChunk lod, 
+			double xOffset, double yOffset, double zOffset, 
+			boolean debugging);
+	
+	/** add the given position and color to the buffer */
+	protected 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();
+	}
+	
+	/** Returns in bytes how much buffer memory is required
+	 * for one LOD object */
+	public abstract int getBufferMemoryForSingleLod(LodDetail detail);
+	
+	
+	
+}

src/main/java/com/seibel/lod/builders/lodTemplates/CubicLodTemplate.java

@@ -0,0 +1,174 @@
+package com.seibel.lod.builders.lodTemplates;
+
+import java.awt.Color;
+
+import com.seibel.lod.enums.ColorDirection;
+import com.seibel.lod.enums.LodDetail;
+import com.seibel.lod.handlers.LodConfig;
+import com.seibel.lod.objects.LodChunk;
+import com.seibel.lod.objects.LodDimension;
+
+import net.minecraft.client.renderer.BufferBuilder;
+import net.minecraft.util.math.AxisAlignedBB;
+
+/**
+ * Builds LODs as rectangular prisms.
+ * 
+ * @author James Seibel
+ * @version 06-16-2021
+ */
+public class CubicLodTemplate extends AbstractLodTemplate
+{
+	
+	public CubicLodTemplate()
+	{
+		
+	}
+	
+	
+	@Override
+	public void addLodToBuffer(BufferBuilder buffer,
+			LodDimension lodDim, LodChunk centerLod, 
+			double xOffset, double yOffset, double zOffset, 
+			boolean debugging)
+	{
+		AxisAlignedBB bbox;
+		
+		// Add this LOD to the BufferBuilder
+		// using the quality setting set by the config
+		LodDetail detail = LodConfig.CLIENT.lodDetail.get();
+		
+		int halfWidth = detail.dataPointWidth / 2;
+		
+		for(int i = 0; i < detail.dataPointLengthCount * detail.dataPointLengthCount; i++)
+		{
+			int startX = detail.startX[i];
+			int startZ = detail.startZ[i];
+			int endX = detail.endX[i];
+			int endZ = detail.endZ[i];
+			
+			// returns null if the lod is empty at the given location
+			bbox = generateBoundingBox(
+					centerLod.getAverageHeightOverArea(startX, startZ, endX, endZ), 
+					centerLod.getAverageDepthOverArea(startX, startZ, endX, endZ), 
+					detail.dataPointWidth, 
+					xOffset - (halfWidth / 2) + detail.startX[i],
+					yOffset, 
+					zOffset - (halfWidth / 2) + detail.startZ[i]);
+			
+			if (bbox != null)
+			{
+				addBoundingBoxToBuffer(buffer, bbox, centerLod.getAverageColorOverArea(startX, startZ, endX, endZ, debugging));
+			}
+		}
+	}
+	
+	
+	
+	
+	
+	private AxisAlignedBB generateBoundingBox(int height, int depth, int width, double xOffset, double yOffset, double zOffset)
+	{
+		// don't add an LOD if it is empty
+		if (height == -1 && depth == -1)
+			return null;
+		
+		if (depth == height)
+		{
+			// if the top and bottom points are at the same height
+			// render this LOD as 1 block thick
+			height++;
+		}
+		
+		return new AxisAlignedBB(0, depth, 0, width, height, width).offset(xOffset, yOffset, zOffset);
+	}
+	
+	
+	
+	private void addBoundingBoxToBuffer(BufferBuilder buffer, AxisAlignedBB bb, Color c)
+	{
+		// top (facing up)
+		addPosAndColor(buffer, bb.minX, bb.maxY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		addPosAndColor(buffer, bb.minX, bb.maxY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		// bottom (facing down)
+		addPosAndColor(buffer, bb.maxX, bb.minY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		addPosAndColor(buffer, bb.maxX, bb.minY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		addPosAndColor(buffer, bb.minX, bb.minY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		addPosAndColor(buffer, bb.minX, bb.minY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+
+		// south (facing -Z) 
+		addPosAndColor(buffer, bb.maxX, bb.minY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		addPosAndColor(buffer, bb.minX, bb.maxY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		addPosAndColor(buffer, bb.minX, bb.minY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		// north (facing +Z)
+		addPosAndColor(buffer, bb.minX, bb.minY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		addPosAndColor(buffer, bb.minX, bb.maxY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		addPosAndColor(buffer, bb.maxX, bb.minY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+
+		// west (facing -X)
+		addPosAndColor(buffer, bb.minX, bb.minY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		addPosAndColor(buffer, bb.minX, bb.minY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		addPosAndColor(buffer, bb.minX, bb.maxY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		addPosAndColor(buffer, bb.minX, bb.maxY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		// east (facing +X)
+		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		addPosAndColor(buffer, bb.maxX, bb.minY, bb.maxZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+		addPosAndColor(buffer, bb.maxX, bb.minY, bb.minZ, c.getRed(), c.getGreen(), c.getBlue(), c.getAlpha());
+	}
+	
+	
+	
+	@SuppressWarnings("unused")
+	private void addBoundingBoxToBuffer(BufferBuilder buffer, AxisAlignedBB bb, Color[] c)
+	{
+		// top (facing up)
+		addPosAndColor(buffer, bb.minX, bb.maxY, bb.minZ, c[ColorDirection.TOP.value].getRed(), c[ColorDirection.TOP.value].getGreen(), c[ColorDirection.TOP.value].getBlue(), c[ColorDirection.TOP.value].getAlpha());
+		addPosAndColor(buffer, bb.minX, bb.maxY, bb.maxZ, c[ColorDirection.TOP.value].getRed(), c[ColorDirection.TOP.value].getGreen(), c[ColorDirection.TOP.value].getBlue(), c[ColorDirection.TOP.value].getAlpha());
+		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.maxZ, c[ColorDirection.TOP.value].getRed(), c[ColorDirection.TOP.value].getGreen(), c[ColorDirection.TOP.value].getBlue(), c[ColorDirection.TOP.value].getAlpha());
+		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.minZ, c[ColorDirection.TOP.value].getRed(), c[ColorDirection.TOP.value].getGreen(), c[ColorDirection.TOP.value].getBlue(), c[ColorDirection.TOP.value].getAlpha());
+		// bottom (facing down)
+		addPosAndColor(buffer, bb.maxX, bb.minY, bb.minZ, c[ColorDirection.BOTTOM.value].getRed(), c[ColorDirection.BOTTOM.value].getGreen(), c[ColorDirection.BOTTOM.value].getBlue(), c[ColorDirection.BOTTOM.value].getAlpha());
+		addPosAndColor(buffer, bb.maxX, bb.minY, bb.maxZ, c[ColorDirection.BOTTOM.value].getRed(), c[ColorDirection.BOTTOM.value].getGreen(), c[ColorDirection.BOTTOM.value].getBlue(), c[ColorDirection.BOTTOM.value].getAlpha());
+		addPosAndColor(buffer, bb.minX, bb.minY, bb.maxZ, c[ColorDirection.BOTTOM.value].getRed(), c[ColorDirection.BOTTOM.value].getGreen(), c[ColorDirection.BOTTOM.value].getBlue(), c[ColorDirection.BOTTOM.value].getAlpha());
+		addPosAndColor(buffer, bb.minX, bb.minY, bb.minZ, c[ColorDirection.BOTTOM.value].getRed(), c[ColorDirection.BOTTOM.value].getGreen(), c[ColorDirection.BOTTOM.value].getBlue(), c[ColorDirection.BOTTOM.value].getAlpha());
+
+		// south (facing -Z) 
+		addPosAndColor(buffer, bb.maxX, bb.minY, bb.maxZ, c[ColorDirection.SOUTH.value].getRed(), c[ColorDirection.SOUTH.value].getGreen(), c[ColorDirection.SOUTH.value].getBlue(), c[ColorDirection.SOUTH.value].getAlpha());
+		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.maxZ, c[ColorDirection.SOUTH.value].getRed(), c[ColorDirection.SOUTH.value].getGreen(), c[ColorDirection.SOUTH.value].getBlue(), c[ColorDirection.SOUTH.value].getAlpha());
+		addPosAndColor(buffer, bb.minX, bb.maxY, bb.maxZ, c[ColorDirection.SOUTH.value].getRed(), c[ColorDirection.SOUTH.value].getGreen(), c[ColorDirection.SOUTH.value].getBlue(), c[ColorDirection.SOUTH.value].getAlpha());
+		addPosAndColor(buffer, bb.minX, bb.minY, bb.maxZ, c[ColorDirection.SOUTH.value].getRed(), c[ColorDirection.SOUTH.value].getGreen(), c[ColorDirection.SOUTH.value].getBlue(), c[ColorDirection.SOUTH.value].getAlpha());
+		// north (facing +Z)
+		addPosAndColor(buffer, bb.minX, bb.minY, bb.minZ, c[ColorDirection.NORTH.value].getRed(), c[ColorDirection.NORTH.value].getGreen(), c[ColorDirection.NORTH.value].getBlue(), c[ColorDirection.NORTH.value].getAlpha());
+		addPosAndColor(buffer, bb.minX, bb.maxY, bb.minZ, c[ColorDirection.NORTH.value].getRed(), c[ColorDirection.NORTH.value].getGreen(), c[ColorDirection.NORTH.value].getBlue(), c[ColorDirection.NORTH.value].getAlpha());
+		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.minZ, c[ColorDirection.NORTH.value].getRed(), c[ColorDirection.NORTH.value].getGreen(), c[ColorDirection.NORTH.value].getBlue(), c[ColorDirection.NORTH.value].getAlpha());
+		addPosAndColor(buffer, bb.maxX, bb.minY, bb.minZ, c[ColorDirection.NORTH.value].getRed(), c[ColorDirection.NORTH.value].getGreen(), c[ColorDirection.NORTH.value].getBlue(), c[ColorDirection.NORTH.value].getAlpha());
+
+		// west (facing -X)
+		addPosAndColor(buffer, bb.minX, bb.minY, bb.minZ, c[ColorDirection.WEST.value].getRed(), c[ColorDirection.WEST.value].getGreen(), c[ColorDirection.WEST.value].getBlue(), c[ColorDirection.WEST.value].getAlpha());
+		addPosAndColor(buffer, bb.minX, bb.minY, bb.maxZ, c[ColorDirection.WEST.value].getRed(), c[ColorDirection.WEST.value].getGreen(), c[ColorDirection.WEST.value].getBlue(), c[ColorDirection.WEST.value].getAlpha());
+		addPosAndColor(buffer, bb.minX, bb.maxY, bb.maxZ, c[ColorDirection.WEST.value].getRed(), c[ColorDirection.WEST.value].getGreen(), c[ColorDirection.WEST.value].getBlue(), c[ColorDirection.WEST.value].getAlpha());
+		addPosAndColor(buffer, bb.minX, bb.maxY, bb.minZ, c[ColorDirection.WEST.value].getRed(), c[ColorDirection.WEST.value].getGreen(), c[ColorDirection.WEST.value].getBlue(), c[ColorDirection.WEST.value].getAlpha());
+		// east (facing +X)
+		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.minZ, c[ColorDirection.EAST.value].getRed(), c[ColorDirection.EAST.value].getGreen(), c[ColorDirection.EAST.value].getBlue(), c[ColorDirection.EAST.value].getAlpha());
+		addPosAndColor(buffer, bb.maxX, bb.maxY, bb.maxZ, c[ColorDirection.EAST.value].getRed(), c[ColorDirection.EAST.value].getGreen(), c[ColorDirection.EAST.value].getBlue(), c[ColorDirection.EAST.value].getAlpha());
+		addPosAndColor(buffer, bb.maxX, bb.minY, bb.maxZ, c[ColorDirection.EAST.value].getRed(), c[ColorDirection.EAST.value].getGreen(), c[ColorDirection.EAST.value].getBlue(), c[ColorDirection.EAST.value].getAlpha());
+		addPosAndColor(buffer, bb.maxX, bb.minY, bb.minZ, c[ColorDirection.EAST.value].getRed(), c[ColorDirection.EAST.value].getGreen(), c[ColorDirection.EAST.value].getBlue(), c[ColorDirection.EAST.value].getAlpha());
+	}
+
+
+	@Override
+	public int getBufferMemoryForSingleLod(LodDetail detail)
+	{
+		// (sidesOnACube * pointsInASquare * (positionPoints + colorPoints))) * howManyPointsPerLodChunk
+		return (6 * 4 * (3 + 4)) * detail.dataPointLengthCount * detail.dataPointLengthCount;
+	}
+	
+	
+	
+	
+}

src/main/java/com/seibel/lod/builders/lodTemplates/DynamicLodTemplate.java

@@ -0,0 +1,34 @@
+package com.seibel.lod.builders.lodTemplates;
+
+import com.seibel.lod.enums.LodDetail;
+import com.seibel.lod.objects.LodChunk;
+import com.seibel.lod.objects.LodDimension;
+
+import net.minecraft.client.renderer.BufferBuilder;
+
+/**
+ * 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,
+			LodDimension lodDim, LodChunk lod, 
+			double xOffset, double yOffset, double zOffset, 
+			boolean debugging)
+	{
+		System.err.println("DynamicLodTemplate not implemented!");
+	}
+
+	@Override
+	public int getBufferMemoryForSingleLod(LodDetail detail) {
+		// TODO Auto-generated method stub
+		return 0;
+	}
+}

src/main/java/com/seibel/lod/builders/lodTemplates/TriangularLodTemplate.java

@@ -0,0 +1,32 @@
+package com.seibel.lod.builders.lodTemplates;
+
+import com.seibel.lod.enums.LodDetail;
+import com.seibel.lod.objects.LodChunk;
+import com.seibel.lod.objects.LodDimension;
+
+import net.minecraft.client.renderer.BufferBuilder;
+
+/**
+ * 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,
+			LodDimension lodDim, LodChunk lod, 
+			double xOffset, double yOffset, double zOffset, 
+			boolean debugging)
+	{
+		System.err.println("DynamicLodTemplate not implemented!");
+	}
+
+	@Override
+	public int getBufferMemoryForSingleLod(LodDetail detail) {
+		// TODO Auto-generated method stub
+		return 0;
+	}
+}

src/main/java/com/seibel/lod/builders/worldGeneration/LodChunkGenWorker.java

@@ -0,0 +1,556 @@
+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.ExecutorService;
+import java.util.concurrent.Executors;
+import java.util.function.Supplier;
+
+import com.seibel.lod.builders.LodBufferBuilder;
+import com.seibel.lod.builders.LodBuilder;
+import com.seibel.lod.builders.LodBuilderConfig;
+import com.seibel.lod.enums.DistanceGenerationMode;
+import com.seibel.lod.handlers.LodConfig;
+import com.seibel.lod.objects.LodChunk;
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.objects.LodRegion;
+import com.seibel.lod.proxy.ClientProxy;
+import com.seibel.lod.render.LodRenderer;
+
+import net.minecraft.block.Block;
+import net.minecraft.block.BlockState;
+import net.minecraft.util.WeightedList.Entry;
+import net.minecraft.util.math.ChunkPos;
+import net.minecraft.util.palette.UpgradeData;
+import net.minecraft.world.biome.Biome;
+import net.minecraft.world.biome.BiomeContainer;
+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.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 6-27-2021
+ */
+public class LodChunkGenWorker implements IWorker
+{
+    public static final ExecutorService genThreads = Executors.newFixedThreadPool(Runtime.getRuntime().availableProcessors());
+    
+    private boolean threadStarted = false;
+    private LodChunkGenThread thread;
+    
+    
+    public LodChunkGenWorker(ChunkPos newPos, LodRenderer newLodRenderer, 
+    		LodBuilder newLodBuilder, LodBufferBuilder newLodBufferBuilder, 
+    		LodDimension newLodDimension, ServerWorld newServerWorld,
+    		BiomeContainer newBiomeContainer)
+    {
+        if (newServerWorld == null)
+        	throw new IllegalArgumentException("LodChunkGenWorker must have a non-null ServerWorld"); 
+        	
+        thread = new LodChunkGenThread(newPos, newLodRenderer, 
+        		newLodBuilder, newLodBufferBuilder, 
+        		newLodDimension, newServerWorld);
+    }
+    
+    @Override
+    public boolean doWork()
+    {
+        if (!threadStarted)
+        {
+        	// make sure we don't generate this chunk again
+        	thread.lodDim.addLod(new LodChunk(thread.pos));
+        	
+        	thread.lodBufferBuilder.numberOfChunksWaitingToGenerate--;
+        	
+        	if (LodConfig.CLIENT.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
+        		genThreads.execute(thread);
+        	}
+        	
+        	threadStarted = true;
+        	
+    		// useful for debugging
+//        	ClientProxy.LOGGER.info(thread.lodDim.getNumberOfLods());
+        }
+        
+        return false;
+    }
+    
+    @Override
+    public boolean hasWork()
+    {
+        return !threadStarted;
+    }
+    
+    
+    
+    
+    private class LodChunkGenThread implements Runnable
+    {
+    	public final ServerWorld serverWorld;
+        public final LodDimension lodDim;
+        public final LodBuilder lodBuilder;
+        public final LodRenderer lodRenderer;
+        private LodBufferBuilder lodBufferBuilder;
+    	
+    	private ChunkPos pos;
+    	
+    	public LodChunkGenThread(ChunkPos newPos, LodRenderer newLodRenderer, 
+        		LodBuilder newLodBuilder, LodBufferBuilder newLodBufferBuilder, 
+        		LodDimension newLodDimension, ServerWorld newServerWorld)
+    	{
+    		pos = newPos;
+    		lodRenderer = newLodRenderer;
+    		lodBuilder = newLodBuilder;
+    		lodBufferBuilder = newLodBufferBuilder;
+    		lodDim = newLodDimension;
+    		serverWorld = newServerWorld;
+    	}
+    	
+		@Override
+		public void run()
+		{
+			// only generate LodChunks if they can
+            // be added to the current LodDimension
+			if (lodDim.regionIsInRange(pos.x / LodRegion.SIZE, pos.z / LodRegion.SIZE))
+			{
+//				long startTime = System.currentTimeMillis();
+				
+				switch(LodConfig.CLIENT.distanceGenerationMode.get())
+				{
+				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();
+				
+				
+//				if (lodDim.getLodFromCoordinates(pos.x, pos.z) != null)
+//					ClientProxy.LOGGER.info(pos.x + " " + pos.z + " Success!");
+//				else
+//					ClientProxy.LOGGER.info(pos.x + " " + pos.z);
+				
+//				long endTime = System.currentTimeMillis();
+//				System.out.println(endTime - startTime);
+				
+			}// if in range
+			
+		}// run
+		
+		
+		
+		/**
+		 * takes about 2-5 ms
+		 */
+		private void generateUsingBiomesOnly()
+		{
+			List<IChunk> chunkList = new LinkedList<>();
+			ChunkPrimer chunk = new ChunkPrimer(pos, UpgradeData.EMPTY);
+			chunkList.add(chunk);
+			
+			ChunkGenerator chunkGen = serverWorld.getWorld().getChunkProvider().getChunkGenerator();
+			
+			// generate the terrain (this is thread safe)
+			ChunkStatus.EMPTY.doGenerationWork(serverWorld, chunkGen, serverWorld.getStructureTemplateManager(), (ServerWorldLightManager) serverWorld.getLightManager(), null, chunkList);
+			// override the chunk status so we can run the next generator stage
+			chunk.setStatus(ChunkStatus.STRUCTURE_REFERENCES);
+			ChunkStatus.BIOMES.doGenerationWork(serverWorld, chunkGen, serverWorld.getStructureTemplateManager(), (ServerWorldLightManager) serverWorld.getLightManager(), null, chunkList);
+			chunk.setStatus(ChunkStatus.STRUCTURE_REFERENCES);
+			
+			
+			// generate fake height data for this LOD
+			int seaLevel = serverWorld.getSeaLevel();
+			
+			boolean simulateHeight = LodConfig.CLIENT.distanceGenerationMode.get() == 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, LodChunk.DEFAULT_HEIGHTMAP);
+			for(int x = 0; x < LodChunk.WIDTH && !inTheEnd; x++)
+			{
+				for(int z = 0; z < LodChunk.WIDTH && !inTheEnd; z++)
+				{
+					if (simulateHeight)
+					{
+						// TODO use the biomes around each block to smooth out the transition
+						
+						// 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, seaLevel, z).getCategory())
+						{
+						case NETHER:
+							heightmap.set(x, z, serverWorld.getHeight() / 2);
+							break;
+							
+						case EXTREME_HILLS:
+							heightmap.set(x, z, seaLevel + 30);
+							break;
+						case MESA:
+							heightmap.set(x, z, seaLevel + 20);
+							break;
+						case JUNGLE:
+							heightmap.set(x, z, seaLevel + 20);
+							break;
+						case BEACH:
+							heightmap.set(x, z, seaLevel + 5);
+							break;
+						case NONE:
+							heightmap.set(x, z, 0);
+							break;
+							
+						case OCEAN:
+						case RIVER:
+							heightmap.set(x, z, seaLevel);
+							break;
+							
+						case THEEND:
+							inTheEnd = true;
+							break;
+							
+						// DESERT
+						// FOREST
+						// ICY
+						// MUSHROOM
+						// SAVANNA 
+						// SWAMP
+						// TAIGA
+						// PLAINS
+						default:
+							heightmap.set(x, z, seaLevel + 10);
+							break;
+						}// heightmap switch
+					}
+					else
+					{
+						// we aren't simulating height
+						// always use sea level
+						heightmap.set(x, z, seaLevel);
+					}
+				}// z
+			}// x
+			
+			chunk.setHeightmap(LodChunk.DEFAULT_HEIGHTMAP, heightmap.getDataArray());
+			
+			
+			LodChunk lod;
+			if (!inTheEnd)
+			{
+				lod = lodBuilder.generateLodFromChunk(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.
+				lod = new LodChunk(chunk.getPos().x, chunk.getPos().z);
+			}
+			lodDim.addLod(lod);
+		}
+		
+		
+		/**
+		 * 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(chunk);
+			
+			ChunkGenerator chunkGen = serverWorld.getWorld().getChunkProvider().getChunkGenerator();
+			
+			// generate the terrain (this is thread safe)
+			ChunkStatus.EMPTY.doGenerationWork(serverWorld, chunkGen, serverWorld.getStructureTemplateManager(), (ServerWorldLightManager) serverWorld.getLightManager(), null, chunkList);
+			// override the chunk status so we can run the next generator stage
+			chunk.setStatus(ChunkStatus.STRUCTURE_REFERENCES);
+			ChunkStatus.BIOMES.doGenerationWork(serverWorld, chunkGen, serverWorld.getStructureTemplateManager(), (ServerWorldLightManager) serverWorld.getLightManager(), null, chunkList);
+			ChunkStatus.NOISE.doGenerationWork(serverWorld, chunkGen, serverWorld.getStructureTemplateManager(), (ServerWorldLightManager) serverWorld.getLightManager(), null, chunkList);
+			ChunkStatus.SURFACE.doGenerationWork(serverWorld, chunkGen, serverWorld.getStructureTemplateManager(), (ServerWorldLightManager) serverWorld.getLightManager(), null, chunkList);
+			
+			// this feature has proved to be thread safe
+			// so we will add it
+			IceAndSnowFeature snowFeature = new IceAndSnowFeature(NoFeatureConfig.field_236558_a_);
+			snowFeature.generate(lodServerWorld, chunkGen, serverWorld.rand, chunk.getPos().asBlockPos(), null);
+			
+			
+			LodChunk lod = lodBuilder.generateLodFromChunk(chunk, new LodBuilderConfig(false, true, true));
+			lodDim.addLod(lod);
+		}
+		
+		
+		/**
+		 * 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(chunk);
+			
+			ChunkGenerator chunkGen = serverWorld.getWorld().getChunkProvider().getChunkGenerator();
+			
+			
+			// generate the terrain (this is thread safe)
+			ChunkStatus.EMPTY.doGenerationWork(serverWorld, chunkGen, serverWorld.getStructureTemplateManager(), (ServerWorldLightManager) serverWorld.getLightManager(), null, chunkList);
+			// override the chunk status so we can run the next generator stage
+			chunk.setStatus(ChunkStatus.STRUCTURE_REFERENCES);
+			ChunkStatus.BIOMES.doGenerationWork(serverWorld, chunkGen, serverWorld.getStructureTemplateManager(), (ServerWorldLightManager) serverWorld.getLightManager(), null, chunkList);
+			ChunkStatus.NOISE.doGenerationWork(serverWorld, chunkGen, serverWorld.getStructureTemplateManager(), (ServerWorldLightManager) serverWorld.getLightManager(), null, chunkList);
+			ChunkStatus.SURFACE.doGenerationWork(serverWorld, chunkGen, serverWorld.getStructureTemplateManager(), (ServerWorldLightManager) serverWorld.getLightManager(), null, chunkList);
+			
+			
+			// get all the biomes in the chunk
+			HashSet<Biome> biomes = new HashSet<>();
+			for (int x = 0; x < LodChunk.WIDTH; x++)
+			{
+				for (int z = 0; z < LodChunk.WIDTH; z++)
+				{
+					// should probably use the heightmap here instead of seaLevel,
+					// but this seems to get the job done well enough
+					biomes.add(chunk.getBiomes().getNoiseBiome(x, serverWorld.getSeaLevel(), z));
+				}
+			}
+			
+			
+			// 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.biomeGenerationSettings.getFeatures();
+				
+				for(int featureStateToGenerate = 0; featureStateToGenerate < featuresForState.size(); featureStateToGenerate++)
+				{
+					for(Supplier<ConfiguredFeature<?, ?>> featureSupplier : featuresForState.get(featureStateToGenerate))
+					{
+						ConfiguredFeature<?, ?> configuredfeature = featureSupplier.get();
+						
+						/*
+						// clone any items that aren't thread safe to prevent
+						// them from causing issues
+						if(configuredfeature.config.getClass() == BlockClusterFeatureConfig.class)
+						{
+							config = cloneBlockClusterFeatureConfig((BlockClusterFeatureConfig) configuredfeature.config);
+						}
+						else if (configuredfeature.config.getClass() == DecoratedFeatureConfig.class)
+						{
+							config = cloneDecoratedFeatureConfig((DecoratedFeatureConfig) configuredfeature.config);
+						}
+						*/
+						
+						try
+						{
+							configuredfeature.generate(lodServerWorld, chunkGen, serverWorld.rand, chunk.getPos().asBlockPos());
+						}
+						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
+							
+							// 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 )
+						}
+						catch(UnsupportedOperationException e)
+						{
+							// This will happen when the LodServerWorld
+							// isn't able to return something that a feature
+							// generator needs
+						}
+						catch(Exception e)
+						{
+							// I'm not sure what happened, print to the log
+							
+							System.out.println();
+							System.out.println();
+							e.printStackTrace();
+							System.out.println();
+							//ClientProxy.LOGGER.error("error class: \"" + configuredfeature.config.getClass() + "\"");
+							System.out.println();
+						}
+					}
+				}
+			}
+			
+			// generate a Lod like normal
+			LodChunk lod = lodBuilder.generateLodFromChunk(chunk);
+			lodDim.addLod(lod);
+		}
+		
+		
+		/**
+		 * 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.generateLodChunkAsync(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.func_242877_b().getClass();
+			
+			if (oldConfigClass == FeatureSpreadConfig.class)
+			{
+				FeatureSpreadConfig oldPlacementConfig = (FeatureSpreadConfig) config.decorator.func_242877_b();
+				FeatureSpread oldSpread = oldPlacementConfig.func_242799_a();
+				
+				placementConfig = new FeatureSpreadConfig(oldSpread);
+			}
+			else if(oldConfigClass == DecoratedPlacementConfig.class)
+			{
+				DecoratedPlacementConfig oldPlacementConfig = (DecoratedPlacementConfig) config.decorator.func_242877_b();
+				placementConfig = new DecoratedPlacementConfig(oldPlacementConfig.getInner(), oldPlacementConfig.getOuter());
+			}
+			else if(oldConfigClass == NoiseDependant.class)
+			{
+				NoiseDependant oldPlacementConfig = (NoiseDependant) config.decorator.func_242877_b();
+				placementConfig = new NoiseDependant(oldPlacementConfig.noiseLevel, oldPlacementConfig.belowNoise, oldPlacementConfig.aboveNoise);
+			}
+			else
+			{
+//				ClientProxy.LOGGER.debug("unkown decorated placement config: \"" + config.decorator.func_242877_b().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();
+			for(Entry<BlockState> state : ((WeightedBlockStateProvider) config.stateProvider).weightedStates.field_220658_a)
+				provider.weightedStates.field_220658_a.add(state);
+			
+			HashSet<Block> whitelist = new HashSet<>();
+			for(Block block : config.whitelist)
+				whitelist.add(block);
+			
+			HashSet<BlockState> blacklist = new HashSet<>();
+			for(BlockState state : config.blacklist)
+				blacklist.add(state); 
+			
+			
+			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.isReplaceable) { builder.replaceable(); }
+			if(config.requiresWater) { builder.requiresWater(); }
+			if(config.field_227298_k_) { builder.func_227317_b_(); }
+			builder.tries(config.tryCount);
+			
+			
+			return builder.build();
+		}
+		
+    }
+    
+    
+    /*
+     * 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)
+     */
+}

src/main/java/com/seibel/lod/builders/worldGeneration/LodServerWorld.java

@@ -0,0 +1,281 @@
+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.objects.LodChunk;
+
+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.LightType;
+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 6-27-2021
+ */
+public class LodServerWorld implements ISeedReader {
+	
+	public HashMap<Heightmap.Type, Heightmap> heightmaps = new HashMap<>();
+	
+	public IChunk chunk;
+	
+	public LodServerWorld(IChunk newChunk)
+	{
+		chunk = newChunk;
+	}
+	
+	
+	
+	@Override
+	public int getHeight(Type heightmapType, int x, int z)
+	{
+		// make sure the block position is set relative to the chunk
+		x = x % LodChunk.WIDTH;
+		x = (x < 0) ? x + 16 : x;
+		
+		z = z % LodChunk.WIDTH;
+		z = (z < 0) ? z + 16 : z;
+		
+		return chunk.getHeightmap(LodChunk.DEFAULT_HEIGHTMAP).getHeight(x, z);
+	}
+	
+	@Override
+	public Biome getBiome(BlockPos pos)
+	{
+		return chunk.getBiomes().getNoiseBiome(pos.getX(), pos.getY(), pos.getZ());
+	}
+	
+	@Override
+	public boolean setBlockState(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 int getLightFor(LightType type, BlockPos pos)
+	{
+		// this needs to be low for snow generation to work
+		return 0;
+	}
+	
+	@Override
+	public boolean hasBlockState(BlockPos pos, Predicate<BlockState> state)
+	{
+		return state.test(chunk.getBlockState(pos));
+	}
+	
+	@Override
+	public ITickList<Block> getPendingBlockTicks()
+	{
+		return EmptyTickList.get();
+	}
+	
+	@Override
+	public IChunk getChunk(int x, int z, ChunkStatus requiredStatus, boolean nonnull) {
+		return chunk;
+	}
+	
+	
+	
+	
+	/**
+	 * 
+	 * All methods below shouldn't be needed
+	 * and thus have been left unimplemented. 
+	 * 
+	 */
+	
+	
+	
+	@Override
+	public ServerWorld getWorld() {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@Override
+	public ITickList<Fluid> getPendingFluidTicks() {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@Override
+	public IWorldInfo getWorldInfo() {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@Override
+	public DifficultyInstance getDifficultyForLocation(BlockPos pos) {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@Override
+	public AbstractChunkProvider getChunkProvider() {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@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 void playEvent(PlayerEntity player, int type, BlockPos pos, int data) {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@Override
+	public DynamicRegistries func_241828_r() {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@Override
+	public List<Entity> getEntitiesInAABBexcluding(Entity entityIn, AxisAlignedBB boundingBox,
+			Predicate<? super Entity> predicate) {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@Override
+	public <T extends Entity> List<T> getEntitiesWithinAABB(Class<? extends T> clazz, AxisAlignedBB aabb,
+			Predicate<? super T> filter) {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@Override
+	public List<? extends PlayerEntity> getPlayers() {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@Override
+	public int getSkylightSubtracted() {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@Override
+	public BiomeManager getBiomeManager() {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@Override
+	public Biome getNoiseBiomeRaw(int x, int y, int z) {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@Override
+	public boolean isRemote() {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@Override
+	public int getSeaLevel() {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@Override
+	public DimensionType getDimensionType() {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@Override
+	public float func_230487_a_(Direction p_230487_1_, boolean p_230487_2_) {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@Override
+	public WorldLightManager getLightManager() {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@Override
+	public TileEntity getTileEntity(BlockPos pos) {
+		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 long getSeed() {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+	@Override
+	public Stream<? extends StructureStart<?>> func_241827_a(SectionPos p_241827_1_, Structure<?> p_241827_2_) {
+		throw new UnsupportedOperationException("Not Implemented");
+	}
+	
+}

src/main/java/com/seibel/lod/enums/ColorDirection.java

@@ -1,7 +1,7 @@
-package com.backsun.lod.util.enums;
+package com.seibel.lod.enums;
 
 /**
- * TOP, N, S, E, W, BOTTOM
+ * TOP, NORTH, SOUTH, EAST, WEST, BOTTOM
  * 
  * @author James Seibel
  * @version 10-17-2020
@@ -13,14 +13,14 @@ public enum ColorDirection
 	TOP(0),
 	
 	/** -Z */
-	N(1),
+	NORTH(1),
 	/** +Z */
-	S(2),
+	SOUTH(2),
 	
 	/** +X */
-	E(3),
+	EAST(3),
 	/** -X */
-	W(4),
+	WEST(4),
 	
 	/** -Y */
 	BOTTOM(5);

src/main/java/com/seibel/lod/enums/DistanceGenerationMode.java

@@ -0,0 +1,51 @@
+package com.seibel.lod.enums;
+
+/**
+ * BIOME_ONLY <br>
+ * BIOME_ONLY_SIMULATE_HEIGHT <br>
+ * SURFACE <br>
+ * FEATURES <br>
+ * SERVER <br><br>
+ * 
+ * In order of fastest to slowest.
+ * 
+ * @author James Seibel
+ * @version 6-27-2021
+ */
+public enum DistanceGenerationMode
+{
+	/** 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,
+	
+	/**
+	 * 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,
+	
+	/** Generate the world surface, 
+	 * this does NOT include caves, trees,
+	 * or structures. 
+	 * Multithreaded - Faster (10-20 ms) */
+	SURFACE,
+	
+	/** 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,
+	
+	/** 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;
+	
+}

src/main/java/com/seibel/lod/enums/FogDistance.java

@@ -1,4 +1,4 @@
-package com.backsun.lod.util.enums;
+package com.seibel.lod.enums;
 
 /**
  * Near, far, or NEAR_AND_FAR.

src/main/java/com/seibel/lod/enums/FogQuality.java

@@ -1,4 +1,4 @@
-package com.backsun.lod.util.enums;
+package com.seibel.lod.enums;
 
 /**
  * fast, fancy, or off

src/main/java/com/seibel/lod/enums/LodCorner.java

@@ -1,4 +1,4 @@
-package com.backsun.lod.util.enums;
+package com.seibel.lod.enums;
 
 /**
  * NE, SE, SW, NW
@@ -8,8 +8,6 @@ package com.backsun.lod.util.enums;
  */
 public enum LodCorner
 {
-	// used for position
-	
 	/** -Z, +X */
 	NE(0),
 	/** +Z, +X */

src/main/java/com/seibel/lod/enums/LodDetail.java

@@ -0,0 +1,97 @@
+package com.seibel.lod.enums;
+
+import com.seibel.lod.objects.LodChunk;
+import com.seibel.lod.objects.LodDataPoint;
+
+/**
+ * single, double, quad, half, full
+ * 
+ * @author James Seibel
+ * @version 06-13-2021
+ */
+public enum LodDetail
+{
+	/** render 1 LOD for each chunk */
+	SINGLE(1),
+	
+	/** render 4 LODs for each chunk */
+	DOUBLE(2),
+	
+	/** render 16 LODs for each chunk */
+	QUAD(4),
+	
+	/** render 64 LODs for each chunk */
+	HALF(8),
+	
+	/** render 256 LODs for each chunk */
+	FULL(16);
+	
+	
+	/** How many DataPoints should 
+	 * be drawn per side per LodChunk */
+	public final int dataPointLengthCount;
+	/** How wide each LOD DataPoint is */
+	public final int dataPointWidth;
+	
+	/* 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;
+	
+	/** This is how many pieces of data should be expected
+	 * when creating a LodChunk with this detail level */
+	public final int lodChunkStringDelimiterCount;
+	
+	
+	
+	
+	private LodDetail(int newLengthCount)
+	{
+		dataPointLengthCount = newLengthCount;
+		dataPointWidth = 16 / dataPointLengthCount;
+		
+		if(newLengthCount == LodChunk.WIDTH)
+		{
+			// this is to prevent overflow
+			newLengthCount = LodChunk.WIDTH - 1;
+		}
+		
+		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;
+				
+				// special case for FULL
+				if(dataPointWidth != 1)
+				{
+					endX[index] = (x*dataPointWidth) + dataPointWidth - 1; 
+					endZ[index] = (z*dataPointWidth) + dataPointWidth - 1; 
+				}
+				else
+				{
+					endX[index] = (x*dataPointWidth) + dataPointWidth;
+					endZ[index] = (z*dataPointWidth) + dataPointWidth;
+				}
+				
+				index++;
+			}
+		}
+		
+		
+		lodChunkStringDelimiterCount = 2 + (dataPointLengthCount * dataPointLengthCount * LodDataPoint.NUMBER_OF_DELIMITERS);
+		
+	}// constructor
+}

src/main/java/com/seibel/lod/enums/LodTemplate.java

@@ -0,0 +1,44 @@
+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 06-16-2021
+ */
+public enum LodTemplate
+{
+	// used for position
+
+	/** Chunks are rendered as
+	 * rectangular prisms. */
+	CUBIC(new CubicLodTemplate()),
+	
+	/** Chunks smoothly transition between
+	 * each other. */
+	TRIANGULAR(new TriangularLodTemplate()),
+	
+	/** Chunks smoothly transition between
+	 * each other, unless a neighboring chunk
+	 * is at a significantly different height. */
+	DYNAMIC(new DynamicLodTemplate());
+	
+	
+	public final AbstractLodTemplate template;
+	
+	private LodTemplate(AbstractLodTemplate newTemplate)
+	{
+		template = newTemplate;
+	}
+	
+	
+	public int getBufferMemoryForSingleLod(LodDetail detail)
+	{
+		return template.getBufferMemoryForSingleLod(detail);
+	}
+}

src/main/java/com/seibel/lod/enums/RelativeChunkPos.java

@@ -0,0 +1,69 @@
+package com.seibel.lod.enums;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.EnumSet;
+
+/** 
+ * NE, SE, SW, NW <br>
+ * NORTH, SOUTH, EAST, WEST, <br>
+ * CENTER
+ * 
+ * @author James Seibel
+ * @version 05-30-2021
+ */
+public enum RelativeChunkPos
+{
+	/** +X, -Z */
+	NE(0, 1,-1),
+	/** +X, +Z */
+	SE(1, 1,1),
+	/** -X, +Z */
+	SW(2, -1,1),
+	/** -X, -Z */
+	NW(3, -1,-1),
+	
+	/** -Z */
+	NORTH(4, 0,-1),
+	/** +Z */
+	SOUTH(5, 0,1),
+	
+	/** +X */
+	EAST(6, 1,0),
+	/** -X */
+	WEST(7, -1,0),
+	
+	CENTER(8, 0,0);
+	
+	/** index used when referencing objects in an array */
+	public final int index;
+	
+	/** position relative to X CENTER */
+	public final int x;
+	/** position relative to Z CENTER */
+	public final int z;
+	
+	/** NORTH, SOUTH, EAST, WEST */
+	public static EnumSet<RelativeChunkPos> ADJACENT = EnumSet.of(NORTH, SOUTH, EAST, WEST);
+	/** NE, NW, SE, SW */
+	public static EnumSet<RelativeChunkPos> DIAGONAL = EnumSet.of(NE, NW, SE, SW);
+	
+	
+	public static EnumSet<RelativeChunkPos> NW_CORNER = EnumSet.of(WEST, NW, NORTH);
+	public static EnumSet<RelativeChunkPos> NE_CORNER = EnumSet.of(EAST, NE, NORTH);
+	public static EnumSet<RelativeChunkPos> SW_CORNER = EnumSet.of(WEST, SW, SOUTH);
+	public static EnumSet<RelativeChunkPos> SE_CORNER = EnumSet.of(EAST, SE, SOUTH);
+	
+	/** NW_CORNER, NE_CORNER, SW_CORNER, SE_CORNER <br>
+	 * Contains the 3 points surrounding a corner. */
+	public static ArrayList<EnumSet<RelativeChunkPos>> CORNERS = new ArrayList<EnumSet<RelativeChunkPos>>( Arrays.asList(NW_CORNER, NE_CORNER, SW_CORNER, SE_CORNER) );
+	
+	private RelativeChunkPos(int newIndex, int newX, int newZ)
+	{
+		index = newIndex;
+		x = newX;
+		z = newZ;
+	}
+}
+
+

src/main/java/com/seibel/lod/handlers/LodConfig.java

@@ -0,0 +1,187 @@
+package com.seibel.lod.handlers;
+
+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.DistanceGenerationMode;
+import com.seibel.lod.enums.FogDistance;
+import com.seibel.lod.enums.LodDetail;
+import com.seibel.lod.enums.LodTemplate;
+
+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 6-27-2021
+ */
+@Mod.EventBusSubscriber
+public class LodConfig
+{
+	public static class Client
+	{
+		public ForgeConfigSpec.BooleanValue drawLODs;
+		
+		public ForgeConfigSpec.EnumValue<FogDistance> fogDistance;
+		
+		public ForgeConfigSpec.BooleanValue debugMode;
+		
+		public ForgeConfigSpec.EnumValue<LodTemplate> lodTemplate;
+		
+		public ForgeConfigSpec.EnumValue<LodDetail> lodDetail;
+		
+		public ForgeConfigSpec.EnumValue<DistanceGenerationMode> distanceGenerationMode;
+		
+		/** this is multiplied by the default view distance
+		 * to determine how far out to generate/render LODs */
+		public ForgeConfigSpec.IntValue lodChunkRadiusMultiplier;
+		
+		Client(ForgeConfigSpec.Builder builder)
+		{
+	        builder.comment(ModInfo.MODNAME + " configuration settings").push("client");
+	        
+	        drawLODs = builder
+	        		.comment("\n\n"
+	        				+ " 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\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\" \n"
+	                		+ " fog option set this to " + FogDistance.NEAR.toString() + " or " + FogDistance.FAR.toString() + ".")
+	                .defineEnum("fogDistance", FogDistance.NEAR_AND_FAR);
+	        
+	        debugMode = builder
+	                .comment("\n\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);
+	        
+	        lodTemplate = builder
+	                .comment("\n\n"
+	                		+ " How should the LODs be drawn? \n"
+	                		+ " " + LodTemplate.CUBIC.toString() + ": LOD Chunks are drawn as rectangular prisms (boxes). \n"
+	                		+ " " + LodTemplate.TRIANGULAR.toString() + ": LOD Chunks smoothly transition between other. \n"
+	                		+ " " + LodTemplate.DYNAMIC.toString() + ": LOD Chunks smoothly transition between other, \n"
+	                		+ " " + "         unless a neighboring chunk is at a significantly different height. ")
+	                .defineEnum("lodTemplate", LodTemplate.CUBIC);
+	        
+	        lodDetail = builder
+	                .comment("\n\n"
+	                		+ " How detailed should the LODs be? \n"
+	                		+ " " + LodDetail.SINGLE.toString() + ": render 1 LOD for each Chunk. \n"
+            				+ " " + LodDetail.DOUBLE.toString() + ": render 4 LODs for each Chunk.")
+	                .defineEnum("lodGeometryQuality", LodDetail.QUAD);
+	        
+	        lodChunkRadiusMultiplier = builder
+	                .comment("\n\n"
+	                		+ " This is multiplied by the default view distance \n"
+	                		+ " to determine how far out to generate/render LODs. \n"
+	                		+ " A value of 2 means that there is 1 render distance worth \n"
+	                		+ " of LODs in each cardinal direction. ")
+	                .defineInRange("lodChunkRadiusMultiplier", 6, 2, 32);
+	        
+	        distanceGenerationMode = builder
+	                .comment("\n\n"
+	                		+ " Note: The times listed here are based on the developer's \n"
+	                		+ "       PC, and are included to show the speed difference \n"
+	                		+ "       between options. Your mileage may vary. \n"
+	                		+ "\n"
+	                		
+	                		+ " " + DistanceGenerationMode.BIOME_ONLY.toString() + " \n"
+	                		+ " Only generate the biomes and use biome \n"
+	                		+ " grass/foliage color, water color, or ice color \n"
+	                		+ " to generate the 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.toString() + " \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.toString() + " \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.toString() + " \n"
+							+ " Generate everything except structures. \n"
+							+ " WARNING: This may cause world generation bugs or instability, \n"
+							+ "	since some features cause concurrentModification exceptions. \n"
+							+ " Multithreaded - Fast (15-20 ms) \n"
+							
+							+ "\n"
+							+ " " + DistanceGenerationMode.SERVER.toString() + " \n"
+							+ " Ask the server to generate/load each chunk. \n"
+							+ " This is the most compatible, but causes server/simulation lag. \n"
+							+ " This will also show player made structures if you \n"
+							+ " are adding the mod to a pre-existing world. \n"
+							+ " Singlethreaded - Slow (15-50 ms, with spikes up to 200 ms) \n")
+	                .defineEnum("distanceBiomeOnlyGeneration", DistanceGenerationMode.FEATURES);
+	        
+	        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!");
+    }
+    
+    
+    
+    
+}

src/main/java/com/seibel/lod/handlers/LodDimensionFileHandler.java

@@ -0,0 +1,344 @@
+package com.seibel.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.seibel.lod.enums.LodDetail;
+import com.seibel.lod.objects.LodChunk;
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.objects.LodRegion;
+import com.seibel.lod.proxy.ClientProxy;
+
+/**
+ * This object handles creating LodRegions
+ * from files and saving LodRegion objects
+ * to file.
+ * 
+ * @author James Seibel
+ * @version 6-27-2021
+ */
+public class LodDimensionFileHandler
+{
+	/** This is what separates each piece of data */
+	public static final char DATA_DELIMITER = ',';
+	
+	
+	private LodDimension loadedDimension = null;
+	public long regionLastWriteTime[][];
+	
+	private File dimensionDataSaveFolder;
+	
+	/** lod */
+	private final String FILE_NAME_PREFIX = "lod";
+	/** .txt */
+	private final String FILE_EXTENSION = ".txt";
+	
+	/** 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 = 2;
+	
+	/** This is the string written before the file version */
+	private static final String LOD_FILE_VERSION_PREFIX = "lod_save_file_version";
+	
+	/** Allow saving asynchronously, but never try to save multiple regions
+	 * at a time */
+	private ExecutorService fileWritingThreadPool = Executors.newSingleThreadExecutor();
+	
+	
+	public LodDimensionFileHandler(File newSaveFolder, LodDimension newLoadedDimension)
+	{
+		if (newSaveFolder == null)
+			throw new IllegalArgumentException("LodDimensionFileHandler requires a valid File location to read and write to.");
+		
+		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)
+	{
+		
+		String fileName = getFileNameAndPathForRegion(regionX, regionZ, LodConfig.CLIENT.lodDetail.get());
+		
+		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();
+			int fileVersion = -1;
+						
+			if(s != null && !s.isEmpty())
+			{
+				// try to get the file version
+				try
+				{
+					fileVersion = Integer.parseInt(s.substring(s.indexOf(' ')).trim());
+				}
+				catch(NumberFormatException | StringIndexOutOfBoundsException e)
+				{
+					// this file doesn't have a version
+					// keep the version as -1
+					fileVersion = -1;
+				}
+				
+				// 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.
+					br.close();
+					f.delete();
+					ClientProxy.LOGGER.info("Outdated LOD region file for region: (" + regionX + "," + regionZ + ") version: " + fileVersion +
+							", version requested: " + LOD_SAVE_FILE_VERSION +
+							" File was been deleted.");
+					
+					return null;
+				}
+				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.
+					br.close();
+					ClientProxy.LOGGER.info("Newer LOD region file for region: (" + regionX + "," + regionZ + ") version: " + fileVersion + 
+							", version requested: " + LOD_SAVE_FILE_VERSION +
+							" this region will not be written to in order to protect the newer file.");
+					
+					return null;
+				}
+			}
+			else
+			{
+				// there is no data in this file
+				br.close();
+				return null;
+			}
+			
+			
+			// this file is a readable version, begin reading the file
+			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, LodConfig.CLIENT.lodDetail.get());
+					
+					region.addLod(lod);
+				}
+				catch(IllegalArgumentException e)
+				{
+					// we were unable to create this chunk
+					// for whatever reason.
+					// skip to the next chunk
+					ClientProxy.LOGGER.warn(e.getMessage());
+				}
+				
+				s = br.readLine();
+			}
+			
+			br.close();
+		}
+		catch (IOException e)
+		{
+			// 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 void saveDirtyRegionsToFileAsync()
+	{
+		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] && loadedDimension.regions[i][j] != null)
+				{
+					saveRegionToDisk(loadedDimension.regions[i][j]);
+					loadedDimension.isRegionDirty[i][j] = false;
+				}
+			}
+		}
+	});
+ 	
+	/**
+	 * 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 saveRegionToDisk(LodRegion region)
+	{
+		// convert chunk coordinates to region
+		// coordinates
+		int x = region.x;
+		int z = region.z;
+		
+		File f = new File(getFileNameAndPathForRegion(x, z, LodConfig.CLIENT.lodDetail.get()));
+		
+		try
+		{
+			// make sure the file and folder exists
+			if (!f.exists())
+			{
+				// the file doesn't exist,
+				// create it and the folder if need be
+				if(!f.getParentFile().exists())
+					f.getParentFile().mkdirs();
+				f.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)
+				
+				BufferedReader br = new BufferedReader(new FileReader(f));
+				String s = br.readLine();
+				int fileVersion = LOD_SAVE_FILE_VERSION;
+							
+				if(s != null && !s.isEmpty())
+				{
+					// try to get the file version
+					try
+					{
+						fileVersion = Integer.parseInt(s.substring(s.indexOf(' ')).trim());
+					}
+					catch(NumberFormatException | StringIndexOutOfBoundsException e)
+					{
+						// this file doesn't have a correctly formated version
+						// just overwrite the file
+					}
+				}
+				br.close();
+				
+				// check if this file can be written to by the file handler
+				if(fileVersion <= LOD_SAVE_FILE_VERSION)
+				{
+					// we are good to continue and overwrite the old file
+				}
+				else //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;
+				}
+			}
+			
+			FileWriter fw = new FileWriter(f);
+			
+			// add the version of this file
+			fw.write(LOD_FILE_VERSION_PREFIX + " " + LOD_SAVE_FILE_VERSION + "\n");
+			
+			// add each LodChunk to the file
+			for(LodChunk[] chunkArray : region.getAllLods())
+				for(LodChunk chunk : chunkArray)
+					if(chunk != null && !chunk.isPlaceholder())
+						fw.write(chunk.toData() + "\n");
+			
+			fw.close();
+		}
+		catch(Exception e)
+		{
+			ClientProxy.LOGGER.error("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. <br><br>
+	 * 
+	 * example: "lod.FULL.0.0.txt"
+	 */
+	private String getFileNameAndPathForRegion(int regionX, int regionZ, LodDetail detail)
+	{
+		try
+		{
+			// saveFolder is something like
+			// ".\Super Flat\DIM-1\data"
+			// or
+			// ".\Super Flat\data"
+			return dimensionDataSaveFolder.getCanonicalPath() + File.separatorChar + 
+					FILE_NAME_PREFIX + "." + detail.toString() + "." + regionX + "." + regionZ + FILE_EXTENSION;
+		}
+		catch(IOException e)
+		{
+			return null;
+		}
+	}
+	
+}

src/main/java/com/seibel/lod/handlers/ReflectionHandler.java

@@ -1,8 +1,8 @@
-package com.backsun.lod.handlers;
+package com.seibel.lod.handlers;
 
 import java.lang.reflect.Field;
 
-import com.backsun.lod.util.enums.FogQuality;
+import com.seibel.lod.enums.FogQuality;
 
 import net.minecraft.client.Minecraft;
 

src/main/java/com/seibel/lod/mixin/MixinWorldRenderer.java

@@ -0,0 +1,45 @@
+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.handlers.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 the LODs would render on top
+ * of the normal terrain.
+ * 
+ * @author James Seibel
+ * @version 05-29-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 = "renderBlockLayer(Lnet/minecraft/client/renderer/RenderType;Lcom/mojang/blaze3d/matrix/MatrixStack;DDD)V", cancellable = false)
+	private void renderBlockLayer(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.drawLODs.get() && renderType.equals(RenderType.getSolid()))
+			LodMain.client_proxy.renderLods(previousPartialTicks);
+	}
+}

src/main/java/com/seibel/lod/objects/LodChunk.java

@@ -0,0 +1,481 @@
+package com.seibel.lod.objects;
+
+import java.awt.Color;
+
+import com.seibel.lod.enums.LodDetail;
+import com.seibel.lod.handlers.LodDimensionFileHandler;
+
+import net.minecraft.util.math.ChunkPos;
+import net.minecraft.world.gen.Heightmap;
+
+/**
+ * This object contains position
+ * and color data for an LOD object.
+ * 
+ * @author James Seibel
+ * @version 6-27-2021
+ */
+public class LodChunk
+{
+	/** This is what separates each piece of data in the toData method */
+	private static final char DATA_DELIMITER = LodDimensionFileHandler.DATA_DELIMITER;
+	
+	/** Width of a Minecraft Chunk */
+	public static final int WIDTH = 16;
+	
+	/** alpha used when drawing chunks in debug mode */
+	private static final int DEBUG_ALPHA = 255; // 0 - 255
+	private static final Color DEBUG_BLACK = new Color(0, 0, 0, DEBUG_ALPHA);
+	private static final Color DEBUG_WHITE = new Color(255, 255, 255, DEBUG_ALPHA);
+	private static final Color INVISIBLE = new Color(0,0,0,0);
+	
+	/** If we ever have to use a heightmap for any reason, use this one. */
+	public static final Heightmap.Type DEFAULT_HEIGHTMAP = Heightmap.Type.WORLD_SURFACE_WG;
+	
+	
+	public LodDetail detail = LodDetail.SINGLE;
+	
+	/** If this is set to true then toData will return
+	 * the empty string */
+	public boolean dontSave = false;
+	
+	// TODO store the DistanceGenerationMethod used for this chunk (so we can upgrade old chunks if we want to)
+	
+	
+	/** The x coordinate of the chunk. */
+	public int x = 0;
+	/** The z coordinate of the chunk. */
+	public int z = 0;
+	
+	
+	/** This stores the height and color for each data point in the LodChunk */
+	public LodDataPoint dataPoints[][];
+	
+	/** If true then this LodChunk contains no data */
+	private boolean empty = false;
+	
+	
+	/**
+	 * Create an empty, invisible, non-saving LodChunk at (0,0)
+	 */
+	public LodChunk()
+	{
+		dontSave = true;
+		empty = true;
+		
+		x = 0;
+		z = 0;
+		
+		detail = LodDetail.SINGLE;
+		
+		dataPoints = new LodDataPoint[detail.dataPointLengthCount][detail.dataPointLengthCount];
+	}
+	
+	/**
+	 * Create an empty, invisible, non-saving LodChunk at the given ChunkPos
+	 */
+	public LodChunk(ChunkPos pos)
+	{
+		this();
+		
+		x = pos.x;
+		z = pos.z;
+	}
+	
+	/**
+	 * Create an empty, invisible, non-saving LodChunk at the given ChunkPos
+	 */
+	public LodChunk(int newX, int newZ)
+	{
+		this();
+		
+		x = newX;
+		z = newZ;
+	}
+	
+	
+	/**
+	 * 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 any piece of data can't be converted at any point
+	 */
+	public LodChunk(String data, LodDetail newDetail) throws IllegalArgumentException, NumberFormatException
+	{
+		/*
+		 * data format: 
+		 * x, z, dataPoint[0][0], dataPoint[0][1], ... 
+		 * x, z,  height, depth, rgb color data,  height, depth, rgb....
+		 * 
+		 * example:
+		 * 5,8,  4, 0, 255,255,255,  4, 0, 255, 255, 255, ...
+		 */
+		
+		dontSave = false;
+		
+		// make sure there are the correct number of entries
+		// in the data string
+		int count = 0;
+		detail = newDetail;
+		
+		for(int i = 0; i < data.length(); i++)
+			if(data.charAt(i) == DATA_DELIMITER)
+				count++;
+		
+		if(count != detail.lodChunkStringDelimiterCount)
+			throw new IllegalArgumentException("LodChunk constructor givin an invalid string. The data given had " + count + " delimiters when it should have had " + detail.lodChunkStringDelimiterCount + ".");
+		
+		
+		dataPoints = new LodDataPoint[detail.dataPointLengthCount][detail.dataPointLengthCount];
+		
+		// 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);
+		this.x = Integer.parseInt(data.substring(0,index));
+		
+		lastIndex = index;
+		index = data.indexOf(DATA_DELIMITER, lastIndex+1);
+		this.z = Integer.parseInt(data.substring(lastIndex+1,index));
+		
+		
+		// LodDataPoints
+		for(int blockX = 0; blockX < detail.dataPointLengthCount; blockX++)
+		{
+			for(int blockZ = 0; blockZ < detail.dataPointLengthCount; blockZ++)
+			{
+				// height
+				lastIndex = index;
+				index = data.indexOf(DATA_DELIMITER, lastIndex+1);
+				int height = Short.parseShort(data.substring(lastIndex+1,index));
+				
+				// depth
+				lastIndex = index;
+				index = data.indexOf(DATA_DELIMITER, lastIndex+1);
+				int depth = Short.parseShort(data.substring(lastIndex+1,index));
+				
+				
+				// color
+				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;
+					}
+				}
+				
+				dataPoints[blockX][blockZ] = new LodDataPoint((short)height, (short)depth, new Color(red, green, blue));
+			}
+		}
+		
+		
+		empty = determineIfEmtpy();
+	}
+	
+	/**
+	 * Create a LodChunk from the given values.
+	 */
+	public LodChunk(ChunkPos pos, LodDataPoint[][] newDataPoints, LodDetail newDetail)
+	{
+		x = pos.x;
+		z = pos.z;
+		
+		dataPoints = newDataPoints;
+		
+		dontSave = false;
+		detail = newDetail;
+		
+		empty = determineIfEmtpy();
+	}
+	
+	
+	
+	
+	
+	
+	//================//
+	// misc functions //
+	//================//
+	
+	/**
+	 * Returns true if this LodChunk is an emptyPlaceholder
+	 */
+	public boolean isPlaceholder()
+	{
+		return empty;
+	}
+	
+	public boolean isLodEmpty()
+	{
+		return empty;
+	}
+	
+	/**
+	 * Returns true if this LOD is either invisible
+	 * from every direction or doesn't have a valid height.
+	 */
+	private boolean determineIfEmtpy()
+	{
+		for(LodDataPoint[] dataPointArray : dataPoints)
+		{
+			for(LodDataPoint dataPoint : dataPointArray)
+			{
+				if (dataPoint == null)
+					continue;
+				
+				// we don't check the depth since the
+				// height should always be greater than or equal
+				// to the depth
+				if(dataPoint.height >= 0)
+				{
+					// the height is valid,
+					
+					if (dataPoint.color == INVISIBLE)
+						continue;
+					
+					// the color and height are valid
+					// this LodChunk isn't empty
+					return false;
+				}
+			}
+		}
+		
+		// we checked everywhere, this LodChunk is empty
+		return true;
+	}
+	
+	
+	
+	
+	//========//
+	// output //
+	//========//
+	
+	/**
+	 * Returns the data point for the given relative block position.
+	 */
+	public LodDataPoint getDataPointForBlockPos(int blockX, int blockZ)
+	{
+		return dataPoints[blockX / detail.dataPointWidth][blockZ / detail.dataPointWidth];
+	}
+	
+	public Color getColorForBlockPos(int blockX, int blockZ)
+	{
+		return getDataPointForBlockPos(blockX, blockZ).color;
+	}
+	
+	public short getHeightForBlockPos(int blockX, int blockZ)
+	{
+		return getDataPointForBlockPos(blockX, blockZ).height;
+	}
+	
+	public short getDepthForBlockPos(int blockX, int blockZ)
+	{
+		return getDataPointForBlockPos(blockX, blockZ).depth;
+	}
+	
+	
+	public Color getColor(int xIndex, int zIndex)
+	{
+		return dataPoints[xIndex][zIndex].color;
+	}
+	
+	public short getHeight(int xIndex, int zIndex)
+	{
+		return dataPoints[xIndex][zIndex].height;
+	}
+	
+	public short getDepth(int xIndex, int zIndex)
+	{
+		return dataPoints[xIndex][zIndex].depth;
+	}
+	
+	public short calculateHighestPoint()
+	{
+		short highest = 0;
+		
+		for(int x = 0; x < detail.dataPointLengthCount; x++)
+		{
+			for(int z = 0; z < detail.dataPointLengthCount; z++)
+			{
+				if (getHeight(x,z) > highest)
+					highest = getHeight(x,z);
+			}
+		}
+		
+		return highest;
+	}
+	
+	
+	
+	/**
+	 * @param startX
+	 * @param startZ
+	 * @param endX
+	 * @param endZ
+	 * @return
+	 */
+	public short getAverageHeightOverArea(int startX, int startZ, int endX, int endZ)
+	{
+		if (startX == endX || startZ == endZ)
+			// we were given an area with 0 blocks in it
+			return getHeightForBlockPos(startX,startZ);
+		
+		int average = 0;
+		
+		for(int x = startX; x < endX; x++)
+			for(int z = startZ; z < endZ; z++)
+				average += getHeightForBlockPos(x,z);
+		
+		return (short) (average / ((endX - startX) * (endZ - startZ)));
+	}
+	
+	/**
+	 * @param startX
+	 * @param startZ
+	 * @param endX
+	 * @param endZ
+	 * @return
+	 */
+	public short getAverageDepthOverArea(int startX, int startZ, int endX, int endZ)
+	{
+		if (startX == endX || startZ == endZ)
+			// we were given an area with 0 blocks in it
+			return getDepthForBlockPos(startX,startZ);
+		
+		int average = 0;
+		
+		for(int x = startX; x < endX; x++)
+			for(int z = startZ; z < endZ; z++)
+				average += getDepthForBlockPos(x,z);
+		
+		return (short) (average / ((endX - startX) * (endZ - startZ)));
+	}
+	
+	
+	/**
+	 * Determine the color of this LOD.
+	 */
+	public Color getAverageColorOverArea(int startX, int startZ, int endX, int endZ, boolean debugging)
+	{
+		if (startX == endX || startZ == endZ)
+			// we were given an area with 0 blocks in it
+			return getColorForBlockPos(startX,startZ);
+		
+		
+		
+		int[] colorComponents = new int[3];
+		
+		
+		if (debugging)
+		{
+			// draw the squares as a black and white,
+			// like a checker board
+			
+			// only return 1 color to prevent
+			// getting back gray
+			if ((startX + startZ) % 2 == 0)
+				return DEBUG_WHITE;
+			else
+				return DEBUG_BLACK;
+		}
+		
+		
+		for(int x = startX; x < endX; x++)
+		{
+			for(int z = startZ; z < endZ; z++)
+			{
+				colorComponents = addColorToColorAverages(colorComponents, getColorForBlockPos(x,z));
+			}
+		}
+		
+		int numbPoints = ((endX - startX) * (endZ - startZ));
+		
+		return new Color(colorComponents[0]/numbPoints, colorComponents[1]/numbPoints, colorComponents[2]/numbPoints);
+	}
+	
+	
+	private int[] addColorToColorAverages(int[] colorAverages, Color colorToAdd) 
+	{
+		// convert the colorToAdd to an int array
+		float[] colorCompoments = new float[4];
+		colorCompoments = colorToAdd.getColorComponents(colorCompoments);
+		
+		// add each color component to the array
+		for(int rgbIndex = 0; rgbIndex < 3; rgbIndex++)
+		{
+			// * 255 + 0.5 taken from the Color java class
+			colorAverages[rgbIndex] += (int) (colorCompoments[rgbIndex] * 255 + 0.5);
+		}
+		
+		return colorAverages;
+	}
+	
+	
+	
+	
+	
+	/**
+	 * Outputs all data in a csv format
+	 * with the given delimiter, if
+	 * dontSave is false. <br><br>
+	 * 
+	 * data format: <br>
+	 * x, z, dataPoint[0][0], dataPoint[0][1], ... <br>
+	 * x, z, height, depth, rgb color data,   height, depth, rgb.... <br><br>
+	 * 
+	 * example: <br>
+	 * 5,8,  4, 0, 255,255,255,  4, 0, 255, 255, 255, ...
+	 */
+	public String toData()
+	{
+		if (dontSave)
+			return "";
+		
+		String s = "";
+		s += Integer.toString(x) + DATA_DELIMITER +  Integer.toString(z) + DATA_DELIMITER;
+		
+		for (int i = 0; i < dataPoints.length; i++)
+			for (int j = 0; j < dataPoints[i].length; j++)
+				s += dataPoints[i][j].toData();
+		
+		return s;
+	}
+	
+	
+	@Override
+	public String toString()
+	{
+		String s = "";
+		
+		s += "x: " + x + " z: " + z + "\t";
+		
+		return s;
+	}
+	
+}

src/main/java/com/seibel/lod/objects/LodDataPoint.java

@@ -0,0 +1,95 @@
+package com.seibel.lod.objects;
+
+import java.awt.Color;
+
+import com.seibel.lod.handlers.LodDimensionFileHandler;
+
+/**
+ * This stores the height and color
+ * for a specific area in a LodChunk.
+ * 
+ * @author James Seibel
+ * @version 6-19-2021
+ */
+public class LodDataPoint
+{
+	/** This is what separates each piece of data in the toData method */
+	private static final char DATA_DELIMITER = LodDimensionFileHandler.DATA_DELIMITER;
+	
+	/** this is how many pieces of data are exported when toData is called */
+	public static final int NUMBER_OF_DELIMITERS = 5;
+	
+	private static final Color INVISIBLE = new Color(0,0,0,0);
+	
+	/** highest point */
+	public short height;
+	
+	/** lowest point */
+	public short depth;
+	
+	/** The average color for the 6 cardinal directions */
+	public Color color;
+	
+	
+	/**
+	 * Creates and empty LodDataPoint
+	 */
+	public LodDataPoint()
+	{
+		height = -1;
+		depth = -1;
+		color = INVISIBLE;
+	}
+	
+	
+	public LodDataPoint(short newHeight, short newDepth, Color newColor)
+	{
+		height = newHeight;
+		depth = newDepth;
+		color = newColor;
+	}
+	
+	public LodDataPoint(int newHeight, int newDepth, Color newColor)
+	{
+		height = (short) newHeight;
+		depth = (short) newDepth;
+		color = newColor;
+	}
+	
+	
+	/**
+	 * Outputs all data in a csv format
+	 * with the given delimiter.
+	 * <br>
+	 * Exports data in the form:
+	 * <br>
+	 * height, depth, rgb color data
+	 * 
+	 * <br>
+	 * example output:
+	 * <br>
+	 * 4, 0, 255,255,255, 
+	 */
+	public String toData()
+	{
+		String s = Short.toString(height) + DATA_DELIMITER;
+		
+		s += Short.toString(depth) + DATA_DELIMITER;
+		
+		s += Integer.toString(color.getRed()) + DATA_DELIMITER + Integer.toString(color.getGreen()) + DATA_DELIMITER + Integer.toString(color.getBlue()) + DATA_DELIMITER;
+		
+		return s;
+	}
+	
+	@Override
+	public String toString()
+	{
+		String s = Short.toString(height) + DATA_DELIMITER;
+		
+		s += Short.toString(depth) + DATA_DELIMITER;
+		
+		s += Integer.toString(color.getRed()) + DATA_DELIMITER + Integer.toString(color.getGreen()) + DATA_DELIMITER + Integer.toString(color.getBlue()) + DATA_DELIMITER;
+		
+		return s;
+	}
+}

src/main/java/com/seibel/lod/objects/LodDimension.java

@@ -1,17 +1,23 @@
-package com.backsun.lod.objects;
+package com.seibel.lod.objects;
 
-import com.backsun.lod.handlers.LodDimensionFileHandler;
-import com.backsun.lod.util.LodUtils;
+import java.io.File;
+import java.io.IOException;
 
+import com.seibel.lod.handlers.LodDimensionFileHandler;
+import com.seibel.lod.util.LodUtil;
+
+import net.minecraft.client.Minecraft;
+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.
  * 
  * @author James Seibel
- * @version 02-23-2021
+ * @version 06-27-2021
  */
 public class LodDimension
 {
@@ -20,8 +26,8 @@ public class LodDimension
 	private volatile int width;
 	private volatile int halfWidth;
 	
-	public LodRegion regions[][];
-	public boolean isRegionDirty[][];
+	public volatile LodRegion regions[][];
+	public volatile boolean isRegionDirty[][];
 	
 	private int centerX;
 	private int centerZ;
@@ -29,13 +35,42 @@ public class LodDimension
 	private LodDimensionFileHandler fileHandler;
 	
 	
-	public LodDimension(DimensionType newDimension, int newMaxWidth)
+	public LodDimension(DimensionType newDimension, LodWorld lodWorld, int newMaxWidth)
 	{
 		dimension = newDimension;
 		width = newMaxWidth;
 		
-		ServerChunkProvider provider = LodUtils.getServerWorldFromDimension(newDimension).getChunkProvider();
-		fileHandler = new LodDimensionFileHandler(provider.getSavedData().folder, this);
+		try
+		{
+			Minecraft mc = Minecraft.getInstance();
+			
+			File saveDir;
+			if(mc.isIntegratedServerRunning())
+			{
+				// local world
+				
+				ServerWorld serverWorld = LodUtil.getServerWorldFromDimension(newDimension);
+				// provider needs a separate variable to prevent
+				// the compiler from complaining
+				ServerChunkProvider provider = serverWorld.getChunkProvider();
+				saveDir = new File(provider.getSavedData().folder.getCanonicalFile().getPath() + File.separatorChar + "lod");
+			}
+			else
+			{
+				// connected to server
+				
+				saveDir = new File(mc.gameDir.getCanonicalFile().getPath() +
+						File.separatorChar + "lod server data" + File.separatorChar + LodUtil.getDimensionIDFromWorld(mc.world));
+			}
+			
+			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];
@@ -207,39 +242,34 @@ public class LodDimension
 	 */
 	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; 
-		}
+		RegionPos pos = LodUtil.convertChunkPosToRegionPos(new ChunkPos(lod.x, lod.z));
 		
 		// don't continue if the region can't be saved
-		if (!regionIsInRange(regionX, regionZ))
+		if (!regionIsInRange(pos.x, pos.z))
+		{
 			return;
-		
-		LodRegion region = getRegion(regionX, regionZ);
+		}
+			
+		LodRegion region = getRegion(pos.x, pos.z);
 		
 		if (region == null)
 		{
 			// if no region exists, create it
-			region = new LodRegion(regionX, regionZ);
+			region = new LodRegion(pos.x, pos.z);
 			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();
+		// don't save empty place holders to disk
+		if (!lod.isPlaceholder() && fileHandler != null)
+		{
+			// mark the region as dirty so it will be saved to disk
+			int xIndex = (pos.x - centerX) + halfWidth;
+			int zIndex = (pos.z - centerZ) + halfWidth;
+			isRegionDirty[xIndex][zIndex] = true;
+			fileHandler.saveDirtyRegionsToFileAsync();
+		}
 	}
 	
 	/**
@@ -251,20 +281,9 @@ public class LodDimension
 	 */
 	public LodChunk getLodFromCoordinates(int chunkX, int chunkZ)
 	{
-		int regionX = chunkX / LodRegion.SIZE;
-		int regionZ = chunkZ / LodRegion.SIZE;
+		RegionPos pos = LodUtil.convertChunkPosToRegionPos(new ChunkPos(chunkX, chunkZ));
 		
-		// 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);
+		LodRegion region = getRegion(pos.x, pos.z);
 		
 		if(region == null)
 			return null;
@@ -279,7 +298,10 @@ public class LodDimension
 	 */
 	public LodRegion getRegionFromFile(int regionX, int regionZ)
 	{
-		return fileHandler.loadRegionFromFile(regionX, regionZ);
+		if (fileHandler != null)
+			return fileHandler.loadRegionFromFile(regionX, regionZ);
+		else
+			return null;
 	}
 	
 	
@@ -287,7 +309,7 @@ public class LodDimension
 	 * Returns whether the region at the given X and Z coordinates
 	 * is within the loaded range.
 	 */
-	private boolean regionIsInRange(int regionX, int regionZ)
+	public boolean regionIsInRange(int regionX, int regionZ)
 	{
 		int xIndex = (regionX - centerX) + halfWidth;
 		int zIndex = (regionZ - centerZ) + halfWidth;
@@ -312,6 +334,40 @@ public class LodDimension
 	}
 	
 	
+	/**
+	 * Returns how many non-null LodChunks
+	 * are stored in this LodDimension.
+	 */
+	public int getNumberOfLods()
+	{
+		int numbLods = 0;
+        for (LodRegion[] regions : regions)
+        {
+        	if(regions == null)
+    			continue;
+        	
+        	for (LodRegion region : regions)
+            {
+        		if(region == null)
+        			continue;
+        			
+            	for(LodChunk[] lods : region.getAllLods())
+            	{
+            		if(lods == null)
+            			continue;
+            		
+            		for(LodChunk lod : lods)
+                	{
+                		if (lod != null)
+                			numbLods++;
+                	}
+            	}
+            }
+        }
+        
+        return numbLods;
+	}
+	
 	
 	public int getWidth()
 	{

src/main/java/com/seibel/lod/objects/LodRegion.java

@@ -1,4 +1,4 @@
-package com.backsun.lod.objects;
+package com.seibel.lod.objects;
 
 /**
  * A LodRegion is the a 32x32
@@ -7,7 +7,7 @@ package com.backsun.lod.objects;
  * one file in the file system.
  * 
  * @author James Seibel
- * @version 1-22-2021
+ * @version 6-12-2021
  */
 public class LodRegion
 {
@@ -61,9 +61,6 @@ public class LodRegion
 		int arrayX = Math.abs(chunkX % SIZE);
 		int arrayZ = Math.abs(chunkZ % SIZE);
 		
-		if(arrayX >= SIZE || arrayZ >= SIZE)
-			return null;
-		
 		return chunks[arrayX][arrayZ];
 	}
 	

src/main/java/com/seibel/lod/objects/LodWorld.java

@@ -0,0 +1,110 @@
+package com.seibel.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 04-01-2021
+ */
+public class LodWorld
+{
+	private String worldName;
+	
+	private Map<DimensionType, LodDimension> lodDimensions;
+	/** If true then the LOD world is setup and ready to use */
+	private boolean isWorldLoaded = false;
+	
+	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.
+	 * @param newWorldName
+	 */
+	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. 
+	 */
+	public void deselectWorld()
+	{
+		worldName = NO_WORLD_LOADED;
+		lodDimensions = null;
+		isWorldLoaded = false;
+	}
+	
+	
+	public void addLodDimension(LodDimension newStorage)
+	{
+		if (lodDimensions == null)
+			throw new IllegalStateException("LodWorld hasn't been given a world yet.");
+		
+		lodDimensions.put(newStorage.dimension, newStorage);
+	}
+	
+	public LodDimension getLodDimension(DimensionType dimension)
+	{
+		if (lodDimensions == null)
+			throw new IllegalStateException("LodWorld hasn't been given a world yet.");
+		
+		return lodDimensions.get(dimension);
+	}
+	
+	/**
+	 * Resizes the max width in regions that each LodDimension
+	 * should use. 
+	 */
+	public void resizeDimensionRegionWidth(int newWidth)
+	{
+		if (lodDimensions == null)
+			throw new IllegalStateException("LodWorld hasn't been given a world yet.");
+		
+		for(DimensionType key : lodDimensions.keySet())
+			lodDimensions.get(key).setRegionWidth(newWidth);
+	}
+	
+	
+	public boolean getIsWorldLoaded()
+	{
+		return isWorldLoaded;
+	}
+	
+	public String getWorldName()
+	{
+		return worldName;
+	}
+	
+	@Override
+	public String toString()
+	{
+		return "World name: " + worldName;
+	}
+}

src/main/java/com/seibel/lod/objects/NearFarBuffer.java

@@ -1,4 +1,4 @@
-package com.backsun.lod.objects;
+package com.seibel.lod.objects;
 
 import net.minecraft.client.renderer.BufferBuilder;
 
@@ -8,7 +8,7 @@ import net.minecraft.client.renderer.BufferBuilder;
  * and BuildBufferThread.
  * 
  * @author James Seibel
- * @version 02-21-2021
+ * @version 03-25-2021
  */
 public class NearFarBuffer
 {
@@ -16,7 +16,10 @@ public class NearFarBuffer
 	
 	public BufferBuilder farBuffer;
 	
-	
+	/**
+	 * @param newNearBuffer
+	 * @param newFarBuffer
+	 */
 	public NearFarBuffer(BufferBuilder newNearBuffer, BufferBuilder newFarBuffer)
 	{
 		nearBuffer = newNearBuffer;

src/main/java/com/seibel/lod/objects/NearFarFogSetting.java

@@ -1,6 +1,6 @@
-package com.backsun.lod.objects;
+package com.seibel.lod.objects;
 
-import com.backsun.lod.util.enums.FogDistance;
+import com.seibel.lod.enums.FogDistance;
 
 /**
  * This object is just a replacement for an array

src/main/java/com/seibel/lod/objects/RegionPos.java

@@ -0,0 +1,31 @@
+package com.seibel.lod.objects;
+
+/**
+ * This object is similar to ChunkPos or BlockPos.
+ * 
+ * @author James Seibel
+ * @version 03-19-2021
+ */
+public class RegionPos
+{
+	public int x;
+	public int z;
+	
+	
+	/**
+	 * Default Constructor <br>
+	 * 
+	 * Sets x and z to 0
+	 */
+	public RegionPos()
+	{
+		x = 0;
+		z = 0;
+	}
+	
+	public RegionPos(int newX, int newZ)
+	{
+		x = newX;
+		z = newZ;
+	}
+}

src/main/java/com/seibel/lod/proxy/ClientProxy.java

@@ -0,0 +1,190 @@
+package com.seibel.lod.proxy;
+
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+
+import com.seibel.lod.builders.LodBufferBuilder;
+import com.seibel.lod.builders.LodBuilder;
+import com.seibel.lod.handlers.LodConfig;
+import com.seibel.lod.objects.LodChunk;
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.objects.LodRegion;
+import com.seibel.lod.objects.LodWorld;
+import com.seibel.lod.render.LodRenderer;
+import com.seibel.lod.util.LodUtil;
+
+import net.minecraft.client.Minecraft;
+import net.minecraft.profiler.IProfiler;
+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 this program.
+ * 
+ * @author James_Seibel
+ * @version 06-27-2021
+ */
+public class ClientProxy
+{
+	public static final Logger LOGGER = LogManager.getLogger("LOD");
+	
+	private static LodWorld lodWorld = new LodWorld();
+	private static LodBuilder lodBuilder = new LodBuilder();
+	private static LodBufferBuilder lodBufferBuilder = new LodBufferBuilder(lodBuilder);
+	private static LodRenderer renderer = new LodRenderer(lodBufferBuilder);
+	
+	Minecraft mc = Minecraft.getInstance();
+	
+	
+	public ClientProxy()
+	{
+		
+	}
+	
+	
+	
+	
+	//==============//
+	// render event //
+	//==============//
+	
+	/**
+	 * Do any setup that is required to draw LODs
+	 * and then tell the LodRenderer to draw.
+	 */
+	public void renderLods(float partialTicks)
+	{
+		if (mc == null || mc.player == null || !lodWorld.getIsWorldLoaded())
+			return;
+		
+		// update each regions' width to match the new render distance
+		int newWidth = Math.max(4, 
+				// TODO is this logic good?
+				(mc.gameSettings.renderDistanceChunks * LodChunk.WIDTH * 2 * LodConfig.CLIENT.lodChunkRadiusMultiplier.get()) / LodRegion.SIZE
+				);
+		if (lodBuilder.regionWidth != newWidth)
+		{
+			lodWorld.resizeDimensionRegionWidth(newWidth);
+			lodBuilder.regionWidth = newWidth;
+			
+			// skip this frame, hopefully the lodWorld
+			// should have everything set up by then
+			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);
+		}
+		
+		
+		// TODO for testing
+//		LodConfig.CLIENT.debugMode.set(false);
+//		LodConfig.CLIENT.lodDetail.set(LodDetail.DOUBLE);
+//		LodConfig.CLIENT.lodColorStyle.set(LodColorStyle.INDIVIDUAL_SIDES);
+//		LodConfig.CLIENT.lodChunkRadiusMultiplier.set(12);
+//		LodConfig.CLIENT.distanceGenerationMode.set(DistanceGenerationMode.FEATURES);
+		
+		// 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 profile to measure
+		IProfiler profiler = mc.getProfiler();
+		profiler.endSection(); // get out of "terrain"
+		profiler.startSection("LOD");
+		
+		renderer.drawLODs(lodDim, partialTicks, mc.getProfiler());
+		
+		profiler.endSection(); // end LOD
+		profiler.startSection("terrain"); // restart terrain
+	}	
+	
+	
+	
+	
+	//==============//
+	// forge events //
+	//==============//
+	
+	@SubscribeEvent
+	public void chunkLoadEvent(ChunkEvent.Load event)
+	{
+		lodBuilder.generateLodChunkAsync(event.getChunk(), lodWorld, event.getWorld());
+	}
+	
+	
+	@SubscribeEvent
+	public void worldLoadEvent(WorldEvent.Load event)
+	{
+		// 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
+		
+		if(mc.getConnection().getWorld() == null)
+		{
+			lodBufferBuilder.numberOfChunksWaitingToGenerate = 0;
+			// the player has disconnected from a server
+			lodWorld.deselectWorld();
+		}
+	}
+	
+	
+	@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.generateLodChunkAsync(event.getWorld().getChunk(event.getPos()), lodWorld, event.getWorld());
+		}
+	}
+	
+	
+	
+	
+	//================//
+	// public getters //
+	//================//
+	
+	public static LodWorld getLodWorld()
+	{
+		return lodWorld;
+	}
+	
+	public static LodBuilder getLodBuilder()
+	{
+		return lodBuilder;
+	}
+	
+	public static LodRenderer getRenderer()
+	{
+		return renderer;
+	}
+}

src/main/java/com/seibel/lod/render/LodRenderer.java

@@ -1,28 +1,25 @@
-package com.backsun.lod.renderer;
+package com.seibel.lod.render;
 
-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 java.util.HashSet;
 
 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 com.seibel.lod.builders.LodBufferBuilder;
+import com.seibel.lod.enums.FogDistance;
+import com.seibel.lod.enums.FogQuality;
+import com.seibel.lod.handlers.LodConfig;
+import com.seibel.lod.handlers.ReflectionHandler;
+import com.seibel.lod.objects.LodChunk;
+import com.seibel.lod.objects.LodDimension;
+import com.seibel.lod.objects.NearFarBuffer;
+import com.seibel.lod.objects.NearFarFogSetting;
+import com.seibel.lod.proxy.ClientProxy;
 
 import net.minecraft.client.Minecraft;
 import net.minecraft.client.entity.player.ClientPlayerEntity;
@@ -30,12 +27,14 @@ 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.WorldRenderer;
 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.BlockPos;
+import net.minecraft.util.math.ChunkPos;
 import net.minecraft.util.math.MathHelper;
 import net.minecraft.util.math.vector.Matrix4f;
 import net.minecraft.util.math.vector.Vector3d;
@@ -43,18 +42,32 @@ import net.minecraft.util.math.vector.Vector3f;
 
 
 /**
- * This is where all the magic happens.
+ * This is where all the magic happens. <br>
  * This is where LODs are draw to the world. 
  * 
  * @author James Seibel
- * @version 2-27-2021
+ * @version 06-19-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;
-
+	
+	/** 
+	 * 64 MB by default is the maximum amount of memory that
+	 * can be directly allocated. <br><br>
+	 * 
+	 * 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>
+	 * 
+	 * https://stackoverflow.com/questions/50499238/bytebuffer-allocatedirect-and-xmx
+	 */
+	public static final int MAX_ALOCATEABLE_DIRECT_MEMORY = 64 * 1024 * 1024;
+	
+	
 	/** If true the LODs colors will be replaced with
 	 * a checkerboard, this can be used for debugging. */
 	public boolean debugging = false;
@@ -63,36 +76,23 @@ public class LodRenderer
 	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;
+	private LodBufferBuilder lodBufferBuilder;
 	
 	/** The buffers that are used to draw LODs using near fog */
-	private volatile BufferBuilder drawableNearBuffer = null;
+	private volatile BufferBuilder drawableNearBuffer;
 	/** 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;
+	private volatile BufferBuilder drawableFarBuffer;
 	
 	/** This is the VertexBuffer used to draw any LODs that use near fog */
-	private volatile VertexBuffer nearVbo = null;
+	private volatile VertexBuffer nearVbo;
 	/** This is the VertexBuffer used to draw any LODs that use far fog */
-	private volatile VertexBuffer farVbo = null;
+	private volatile VertexBuffer farVbo;
 	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 */
@@ -104,25 +104,21 @@ public class LodRenderer
 	
 	/** 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;
+	private volatile boolean regen = false;
+	
+	/** This HashSet contains every chunk that Vanilla Minecraft
+	 *  is going to render */
+	public HashSet<ChunkPos> vanillaRenderedChunks = new HashSet<>();
 	
 	
 	
-	
-	
-	
-	public LodRenderer()
+	public LodRenderer(LodBufferBuilder newLodBufferBuilder)
 	{
 		mc = Minecraft.getInstance();
 		gameRender = mc.gameRenderer;
 		
 		reflectionHandler = new ReflectionHandler();
+		lodBufferBuilder = newLodBufferBuilder;
 	}
 	
 	
@@ -133,9 +129,9 @@ public class LodRenderer
 	 * @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)
+	public void drawLODs(LodDimension lodDim, float partialTicks, IProfiler newProfiler)
 	{		
-		if (lodDimension == null && newDimension == null)
+		if (lodDim == null)
 		{
 			// if there aren't any loaded LodChunks
 			// don't try drawing anything
@@ -151,11 +147,7 @@ public class LodRenderer
 		// 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;
@@ -164,8 +156,7 @@ public class LodRenderer
 		if ((int)player.getPosX() / LodChunk.WIDTH != prevChunkX ||
 			(int)player.getPosZ() / LodChunk.WIDTH != prevChunkZ ||
 			previousChunkRenderDistance != mc.gameSettings.renderDistanceChunks ||
-			prevFogDistance != LodConfig.CLIENT.fogDistance.get() ||
-			lodDimension != newDimension)
+			prevFogDistance != LodConfig.CLIENT.fogDistance.get())
 		{
 			// yes
 			regen = true;
@@ -181,40 +172,35 @@ public class LodRenderer
 			// the dimension is the same
 		}
 		
-		lodDimension = newDimension;
-		if (lodDimension == null)
+		// did the user change the debug setting?
+		if (LodConfig.CLIENT.debugMode.get() != debugging)
 		{
-			// if there aren't any loaded LodChunks
-			// don't try drawing anything
-			return;
+			debugging = LodConfig.CLIENT.debugMode.get();
+			regen = true;
 		}
 		
-		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 totalLength = (int) farPlaneDistance * LodConfig.CLIENT.lodChunkRadiusMultiplier.get() * 2;
 		int numbChunksWide = (totalLength / LodChunk.WIDTH);
 		
+		// determine which LODs should not be rendered close to the player
+		HashSet<ChunkPos> chunkPosToSkip = getNearbyLodChunkPosToSkip(lodDim, player.getPosition());
+		
+		// see if the chunks Minecraft is going to render are the
+		// same as last time
+		if (!vanillaRenderedChunks.containsAll(chunkPosToSkip))
+		{
+			regen = true;
+			vanillaRenderedChunks = chunkPosToSkip;
+		}
 		
 		
-		
+				
 		
 		
 		//=================//
@@ -226,32 +212,28 @@ public class LodRenderer
 		// 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)
+		if (regen && !lodBufferBuilder.generatingBuffers && !lodBufferBuilder.newBuffersAvaliable())
 		{
-			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);
+			lodBufferBuilder.generateLodBuffersAsync(this, lodDim, player.getPosX(), player.getPosZ(), numbChunksWide);
 			
-			// the regen process has been started
+			// the regen process has been started,
+			// it will be done when lodBufferBuilder.newBuffersAvaliable
+			// is true
 			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)
+		if (lodBufferBuilder.newBuffersAvaliable())
 		{
 			swapBuffers();
-			switchBuffers = false;
 		}
 		
 		
@@ -270,13 +252,27 @@ public class LodRenderer
 		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[] defaultProjMatrix = new float[16];
+        GL11.glGetFloatv(GL11.GL_PROJECTION_MATRIX, defaultProjMatrix);
+		
 		Matrix4f modelViewMatrix = generateModelViewMatrix(partialTicks);
 		
 		setupProjectionMatrix(partialTicks);
-		setupLighting(partialTicks);
+		setupLighting(lodDim, partialTicks);
 		
 		NearFarFogSetting fogSetting = 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);
 
 		
 		
@@ -287,6 +283,7 @@ public class LodRenderer
 		//===========//
 		// rendering //
 		//===========//
+		profiler.endStartSection("LOD draw");
 		
 		setupFog(fogSetting.nearFogSetting, reflectionHandler.getFogQuality());
 		sendLodsToGpuAndDraw(nearVbo, modelViewMatrix);
@@ -296,53 +293,48 @@ public class LodRenderer
 		
 		
 		
+		
+		
 		//=========//
 		// 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);
+		// re-enable the lights Minecraft uses
+		GL11.glEnable(GL11.GL_LIGHT0);
+		GL11.glEnable(GL11.GL_LIGHT1);
+		RenderSystem.disableLighting();
 		
 		// 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;
 		
+		// reset the fog settings so the normal chunks
+		// will be drawn correctly
+		RenderSystem.fogStart(defaultFogStartDist);
+		RenderSystem.fogEnd(defaultFogEndDist);
+		RenderSystem.fogMode(defaultFogMode);
 		
-		// end of profiler tracking
+		// reset the projection matrix so anything drawn after
+		// the LODs will use the correct projection matrix
+		Matrix4f mvm = new Matrix4f(defaultProjMatrix);
+		mvm.transpose();
+		gameRender.resetProjectionMatrix(mvm);
+		
+		// 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.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.
@@ -354,15 +346,12 @@ public class LodRenderer
 		if (vbo == null)
 			return;
 		
-		profiler.endStartSection("LOD draw setup");
         vbo.bindBuffer();
-        // 0L is the starting pointer, and the value doesn't appear to matter
+        // 0L is the starting pointer
         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();
 	}
@@ -404,8 +393,8 @@ public class LodRenderer
 			
 			if (fogQuality == FogQuality.FANCY)
 			{
-				RenderSystem.fogEnd(farPlaneDistance * 0.3f * LOD_CHUNK_DISTANCE_RADIUS);
-				RenderSystem.fogStart(farPlaneDistance * 0.35f * LOD_CHUNK_DISTANCE_RADIUS);
+				RenderSystem.fogEnd(farPlaneDistance * 1.75f);
+				RenderSystem.fogStart(farPlaneDistance * 1.95f);
 			}
 			else if(fogQuality == FogQuality.FAST)
 			{
@@ -421,13 +410,13 @@ public class LodRenderer
 		{
 			if (fogQuality == FogQuality.FANCY)
 			{
-				RenderSystem.fogStart(farPlaneDistance * 0.78f * LOD_CHUNK_DISTANCE_RADIUS);
-				RenderSystem.fogEnd(farPlaneDistance * 1.0f * LOD_CHUNK_DISTANCE_RADIUS);
+				RenderSystem.fogStart(farPlaneDistance * 0.85f * LodConfig.CLIENT.lodChunkRadiusMultiplier.get());
+				RenderSystem.fogEnd(farPlaneDistance * 1.0f * LodConfig.CLIENT.lodChunkRadiusMultiplier.get());
 			}
 			else if(fogQuality == FogQuality.FAST)
 			{
-				RenderSystem.fogStart(farPlaneDistance * 0.5f * LOD_CHUNK_DISTANCE_RADIUS);
-				RenderSystem.fogEnd(farPlaneDistance * 0.75f * LOD_CHUNK_DISTANCE_RADIUS);
+				RenderSystem.fogStart(farPlaneDistance * 0.5f * LodConfig.CLIENT.lodChunkRadiusMultiplier.get());
+				RenderSystem.fogEnd(farPlaneDistance * 0.75f * LodConfig.CLIENT.lodChunkRadiusMultiplier.get());
 			}
 		}
 		
@@ -436,6 +425,29 @@ public class LodRenderer
 	}
 	
 
+	/**
+	 * 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();
+	}
+	
+	
 	/**
 	 * create a new projection matrix and send it over to the GPU
 	 * <br><br>
@@ -484,7 +496,7 @@ public class LodRenderer
 				getFov(partialTicks, true), 
 				(float)this.mc.getMainWindow().getFramebufferWidth() / (float)this.mc.getMainWindow().getFramebufferHeight(), 
 				0.5F, 
-				this.farPlaneDistance * LOD_CHUNK_DISTANCE_RADIUS * 2);
+				this.farPlaneDistance * LodConfig.CLIENT.lodChunkRadiusMultiplier.get() * 2);
 		
 		// add the screen space distortions
 		projectionMatrix.mul(matrixStack.getLast().getMatrix());
@@ -496,14 +508,18 @@ public class LodRenderer
 	/**
 	 * setup the lighting to be used for the LODs
 	 */
-	private void setupLighting(float partialTicks)
+	private void setupLighting(LodDimension lodDimension, 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 lightStrength = ((sunBrightness / 2f) - 0.2f) + (gammaMultiplyer * 0.2f);
 		
 		float lightAmbient[] = {lightStrength, lightStrength, lightStrength, 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());
@@ -517,208 +533,62 @@ public class LodRenderer
 	 */
 	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)))
+		// calculate the max amount of memory needed (in bytes)
+		int bufferMemory = RenderUtil.getBufferMemoryForRadiusMultiplier(LodConfig.CLIENT.lodChunkRadiusMultiplier.get());
 		
-		// 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);
+		// if the required memory is greater than the 
+		// MAX_ALOCATEABLE_DIRECT_MEMORY lower the lodChunkRadiusMultiplier
+		// to fit.
+		if (bufferMemory > MAX_ALOCATEABLE_DIRECT_MEMORY)
+		{
+			int maxRadiusMultiplier = RenderUtil.getMaxRadiusMultiplierWithAvaliableMemory(LodConfig.CLIENT.lodTemplate.get(), LodConfig.CLIENT.lodDetail.get());
+			
+			ClientProxy.LOGGER.warn("The lodChunkRadiusMultiplier was set too high "
+					+ "and had to be lowered to fit memory constraints "
+					+ "from " + LodConfig.CLIENT.lodChunkRadiusMultiplier.get() + " " 
+					+ "to " + maxRadiusMultiplier);
+			
+			LodConfig.CLIENT.lodChunkRadiusMultiplier.set(
+					maxRadiusMultiplier);
+			
+			bufferMemory = RenderUtil.getBufferMemoryForRadiusMultiplier(maxRadiusMultiplier);
+		}
 		
-		buildableNearBuffer = new BufferBuilder(bufferMaxCapacity);
-		buildableFarBuffer = new BufferBuilder(bufferMaxCapacity);
+		drawableNearBuffer = new BufferBuilder(bufferMemory);
+		drawableFarBuffer = new BufferBuilder(bufferMemory);
+		
+		lodBufferBuilder.setupBuffers(bufferMemory);
 	}
 	
 	
 	
 	
 	
-	
-	
 	//======================//
 	// Other Misc Functions // 
 	//======================//
 	
-	
 	/**
-	 * @Returns -1 if there are no valid points
+	 * If this is called then the next time "drawLODs" is called
+	 * the LODs will be regenerated; the same as if the player moved.
 	 */
-	private int getValidHeightPoint(short[] heightPoints)
+	public void regenerateLODsNextFrame()
 	{
-		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];
+		regen = true;
 	}
 	
 	
 	/**
-	 * 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.
+	 * Replace the current drawable buffers with the newly
+	 * created buffers from the lodBufferBuilder.
 	 */
 	private void swapBuffers()
 	{
-		// swap the BufferBuilders
-		BufferBuilder tmp = buildableNearBuffer;
-		buildableNearBuffer = drawableNearBuffer;
-		drawableNearBuffer = tmp;
-		
-		tmp = buildableFarBuffer;
-		buildableFarBuffer = drawableFarBuffer;
-		drawableFarBuffer = tmp;
+		// replace the drawable buffers with
+		// the newly created buffers from the lodBufferBuilder
+		NearFarBuffer newBuffers = lodBufferBuilder.swapBuffers(drawableNearBuffer, drawableFarBuffer);
+		drawableNearBuffer = newBuffers.nearBuffer;
+		drawableFarBuffer = newBuffers.farBuffer;
 		
 		
 		// bind the buffers with their respective VBOs
@@ -737,21 +607,7 @@ public class LodRenderer
 	}
 	
 	
-	/**
-	 * 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)
+	private double getFov(float partialTicks, boolean useFovSetting)
 	{
 		return mc.gameRenderer.getFOVModifier(mc.gameRenderer.getActiveRenderInfo(), partialTicks, useFovSetting);
 	}
@@ -766,7 +622,6 @@ public class LodRenderer
 	{
 		NearFarFogSetting fogSetting = new NearFarFogSetting();
 		
-		LodConfig.CLIENT.fogDistance.get();
 		switch(reflectionHandler.getFogQuality())
 		{
 		case FANCY:
@@ -825,4 +680,79 @@ public class LodRenderer
 	
 	
 	
+	/**
+	 * Get a HashSet of all ChunkPos within the normal render distance
+	 * that should not be rendered.
+	 */
+	private HashSet<ChunkPos> getNearbyLodChunkPosToSkip(LodDimension lodDim, BlockPos playerPos) 
+	{
+		int chunkRenderDist = mc.gameSettings.renderDistanceChunks;
+		int blockRenderDist = chunkRenderDist * 16;
+		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++)
+			{
+				LodChunk lod = lodDim.getLodFromCoordinates(x, z);
+				if (lod != null)
+				{
+					short lodHighestPoint = lod.calculateHighestPoint();
+					
+					if (playerPos.getY() < lodHighestPoint)
+					{
+						// 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));
+					}
+					else if (blockRenderDist < Math.abs(playerPos.getY() - lodHighestPoint))
+					{
+						// draw Lod's that are lower than the player's view range
+						posToSkip.remove(new ChunkPos(x, z));
+					}
+				}
+			}
+		}
+		
+		return posToSkip;
+	}
+	
+	/**
+	 * This method returns the ChunkPos of all chunks that Minecraft
+	 * is going to render this frame. <br><br>
+	 * 
+	 * 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<>();
+		
+		Minecraft mc = Minecraft.getInstance();
+		
+		// Wow those are some long names!
+		
+		// go through every RenderInfo to get the compiled chunks
+		for(WorldRenderer.LocalRenderInformationContainer 
+				worldrenderer$localrenderinformationcontainer : mc.worldRenderer.renderInfos)
+		{
+			if (!worldrenderer$localrenderinformationcontainer.renderChunk.getCompiledChunk().isEmpty())
+			{
+				// add the ChunkPos for every empty compiled chunk
+				BlockPos bpos = worldrenderer$localrenderinformationcontainer.renderChunk.getPosition();
+				
+				loadedPos.add(new ChunkPos(bpos.getX() / 16, bpos.getZ() / 16));
+			}
+		}
+		
+		return loadedPos;
+	}
+	
+	
 }

src/main/java/com/seibel/lod/render/RenderUtil.java

@@ -0,0 +1,94 @@
+package com.seibel.lod.render;
+
+import com.seibel.lod.enums.LodDetail;
+import com.seibel.lod.enums.LodTemplate;
+import com.seibel.lod.handlers.LodConfig;
+
+import net.minecraft.client.Minecraft;
+import net.minecraft.util.math.ChunkPos;
+
+/**
+ * This holds miscellaneous helper code
+ * to be used in the rendering process.
+ * 
+ * @author James Seibel
+ * @version 6-17-2021
+ */
+public class RenderUtil
+{
+	private static final Minecraft mc = Minecraft.getInstance();
+	
+	
+	/**
+	 * 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)
+	{
+		Minecraft mc = Minecraft.getInstance();
+		
+		return (pos.x >= center.x - mc.gameSettings.renderDistanceChunks 
+				&& pos.x <= center.x + mc.gameSettings.renderDistanceChunks) 
+				&& 
+				(pos.z >= center.z - mc.gameSettings.renderDistanceChunks 
+				&& pos.z <= center.z + mc.gameSettings.renderDistanceChunks);
+	}
+	
+	/**
+	 * 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);
+	}
+	
+	
+	/**
+	 * Get how much buffer memory would be required for the given radius multiplier
+	 */
+	public static int getBufferMemoryForRadiusMultiplier(int radiusMultiplier)
+	{ 
+		int numbChunksWide = mc.gameSettings.renderDistanceChunks * 
+							radiusMultiplier * 2;
+		
+		// calculate the max amount of buffer memory needed (in bytes)
+		return numbChunksWide * numbChunksWide *
+				LodConfig.CLIENT.lodTemplate.get().
+				getBufferMemoryForSingleLod(LodConfig.CLIENT.lodDetail.get());
+	}
+	
+	/**
+	 * Returns the maxViewDistanceMultiplier for the given LodTemplate
+	 * at the given LodDetail level.
+	 */
+	public static int getMaxRadiusMultiplierWithAvaliableMemory(LodTemplate lodTemplate, LodDetail lodDetail)
+	{
+		int maxNumberOfLods = LodRenderer.MAX_ALOCATEABLE_DIRECT_MEMORY / lodTemplate.getBufferMemoryForSingleLod(lodDetail); 
+		int numbLodsWide = (int) Math.sqrt(maxNumberOfLods);
+		
+		return numbLodsWide / (2 * mc.gameSettings.renderDistanceChunks);
+	}
+}

src/main/java/com/seibel/lod/util/LodUtil.java

@@ -0,0 +1,240 @@
+package com.seibel.lod.util;
+
+import java.awt.Color;
+import java.io.File;
+
+import com.seibel.lod.objects.LodRegion;
+import com.seibel.lod.objects.RegionPos;
+
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.multiplayer.ServerData;
+import net.minecraft.server.integrated.IntegratedServer;
+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.server.ServerChunkProvider;
+import net.minecraft.world.server.ServerWorld;
+
+/**
+ * This class holds methods that may be used in multiple places.
+ * 
+ * @author James Seibel
+ * @version 06-27-2021
+ */
+public class LodUtil
+{
+	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;
+	}
+	
+	/**
+	 * Convert the given ChunkPos into a RegionPos.
+	 */
+	public static RegionPos convertChunkPosToRegionPos(ChunkPos pos)
+	{
+		RegionPos rPos = new RegionPos();
+		rPos.x = pos.x / LodRegion.SIZE;
+		rPos.z = pos.z / LodRegion.SIZE;
+		
+		// prevent issues if X/Z is negative and less than 16
+		if (pos.x < 0)
+		{
+			rPos.x = (Math.abs(rPos.x) * -1) - 1; 
+		}
+		if (pos.z < 0)
+		{
+			rPos.z = (Math.abs(rPos.z) * -1) - 1; 
+		}
+		
+		return rPos;
+	}
+	
+	/**
+	 * 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;
+	}
+	
+	
+	
+	public static String getCurrentDimensionID()
+	{
+
+		Minecraft mc = Minecraft.getInstance();
+		
+		if(mc.isIntegratedServerRunning())
+		{
+			// this will return the world save location
+			// and the dimension folder
+			
+			if(mc.world == null)
+				return "";
+			
+			ServerWorld serverWorld = LodUtil.getServerWorldFromDimension(mc.world.getDimensionType());
+			if(serverWorld == null)
+				return "";
+			
+			ServerChunkProvider provider = serverWorld.getChunkProvider();
+			if(provider == null)
+				return "";
+			
+			return provider.getSavedData().folder.toString();
+		}
+		else
+		{
+			ServerData server = mc.getCurrentServerData();
+			return server.serverName + ", IP " + 
+					server.serverIP + ", GameVersion " + 
+					server.gameVersion.getString() + File.separatorChar
+					+ "dim_" + mc.world.getDimensionType().getEffects().getPath() + File.separatorChar;
+		}
+	}
+
+	
+	/**
+	 * 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, 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)
+	{
+		Minecraft mc = Minecraft.getInstance();
+		
+		if(mc.isIntegratedServerRunning())
+		{
+			// this will return the world save location
+			// and the dimension folder
+			
+			ServerWorld serverWorld = LodUtil.getServerWorldFromDimension(world.getDimensionType());
+			if(serverWorld == null)
+				throw new NullPointerException("getDimensionIDFromWorld wasn't able to get the ServerWorld for the dimension " + world.getDimensionType().getEffects().getPath());
+			
+			ServerChunkProvider provider = serverWorld.getChunkProvider();
+			if(provider == null)
+				throw new NullPointerException("getDimensionIDFromWorld wasn't able to get the ServerChunkProvider for the dimension " + world.getDimensionType().getEffects().getPath());
+			
+			return provider.getSavedData().folder.toString();
+		}
+		else
+		{
+			ServerData server = mc.getCurrentServerData();
+			return server.serverName + ", IP " + 
+					server.serverIP + ", GameVersion " + 
+					server.gameVersion.getString() + File.separatorChar
+					+ "dim_" + world.getDimensionType().getEffects().getPath() + File.separatorChar;
+		}
+	}
+	
+	/**
+	 * 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 getWorldID(IWorld world)
+	{
+		if(mc.isIntegratedServerRunning())
+		{
+			// 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
+		{
+			ServerData server = mc.getCurrentServerData();
+			return server.serverName + ", IP " + 
+					server.serverIP + ", GameVersion " + 
+					server.gameVersion.getString();
+		}
+	}
+	
+	
+	
+	/**
+	 * 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();
+	}
+}

src/main/java/com/seibel/lod/util/Reference.java

@@ -1,4 +1,4 @@
-package com.backsun.lod.util;
+package com.seibel.lod.util;
 
 /**
  * This holds meta information about the mod.

src/main/resources/META-INF/accesstransformer.cfg

@@ -16,6 +16,29 @@ 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
+
 
 
 #=====================#

src/main/resources/META-INF/mods.toml

@@ -24,7 +24,7 @@ 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.2" #mandatory
 
 #// A display name for the mod
 displayName="Levels of Detail" #mandatory

src/main/resources/lod.mixins.json

@@ -1,6 +1,6 @@
 {
 	"required": true,
-	"package": "com.backsun.lod.mixin",
+	"package": "com.seibel.lod.mixin",
 	"compatibilityLevel": "JAVA_8",
 	"refmap": "lod.refmap.json",
 	"mixins": [

src/main/resources/mcmod.info

@@ -3,7 +3,7 @@
   "modid": "lod",
   "name": "Level Of Details",
   "description": "Generates and renders simplified chunks beyond the normal view distance, at a low performance cost.",
-  "version": "a1",
+  "version": "a1.2",
   "mcversion": "1.16.4",
   "url": "",
   "updateUrl": "",