more comments

src/net/torvald/UnsafePtr.kt

@@ -4,6 +4,9 @@ import net.torvald.terrarum.printStackTrace
 import sun.misc.Unsafe
 
 /**
+ * Further read:
+ * - http://www.docjar.com/docs/api/sun/misc/Unsafe.html
+ *
  * Created by minjaesong on 2019-06-21.
  */
 

src/net/torvald/gdx/graphics/Cvec.kt

@@ -19,6 +19,13 @@ package net.torvald.gdx.graphics
 import com.badlogic.gdx.graphics.Color
 import com.badlogic.gdx.utils.NumberUtils
 
+/**
+ * A Cvec is kind of a Vector4f made compatible with LibGdx's Color class, with the intention of actually utilising
+ * the JEP 338 VectorInstrinsics later, when the damned thing finally releases.
+ *
+ * Before then, the code will be identical to LibGdx's.
+ */
+
 /** A color class, holding the r, g, b and alpha component as floats in the range [0,1]. All methods perform clamping on the
  * internal values after execution.
  *

src/net/torvald/gdx/graphics/UnsafeCvecArray.kt

@@ -2,6 +2,11 @@ package net.torvald.gdx.graphics
 
 import net.torvald.UnsafeHelper
 
+/**
+ * Basically just a FloatArray. You may need to re-write the entire code to actually store the Vectors,
+ * maybe in the form of array of objects.
+ */
+
 /**
  * Created by minjaesong on 2019-06-21.
  */

src/net/torvald/terrarum/worlddrawer/LightmapRendererNew.kt

@@ -102,7 +102,7 @@ object LightmapRenderer {
     //private var lightmap: Array<Cvec> = Array(LIGHTMAP_WIDTH * LIGHTMAP_HEIGHT) { Cvec(0) } // Can't use framebuffer/pixmap -- this is a fvec4 array, whereas they are ivec4.
     private val lanternMap = HashMap<BlockAddress, Cvec>((Terrarum.ingame?.ACTORCONTAINER_INITIAL_SIZE ?: 2) * 4)
 
-    private val lightsourceMap = ArrayList<Pair<BlockAddress, Cvec>>(256)
+    //private val lightsourceMap = ArrayList<Pair<BlockAddress, Cvec>>(256)
 
     init {
         LightmapHDRMap.invoke()
@@ -235,7 +235,7 @@ object LightmapRenderer {
             // when disabled, light will "decay out" instead of "instantly out", which can have a cool effect
             // but the performance boost is measly 0.1 ms on 6700K
             lightmap.zerofill()
-            lightsourceMap.clear()
+            //lightsourceMap.clear()
 
 
             // pre-seed the lightmap with known value