OSDN Git Service

indentation
[automap/automap.git] / Automap / Subsystems / AutomapSystem.cs
index faea6b5..5b95308 100644 (file)
@@ -16,628 +16,617 @@ using Hjg.Pngcs.Chunks;
 using Vintagestory.API.Client;
 using Vintagestory.API.Common;
 using Vintagestory.API.Common.Entities;
-using Vintagestory.API.Config;
 using Vintagestory.API.MathTools;
 using Vintagestory.Common;
 
 namespace Automap
 {
-       public class AutomapSystem
-       {
-               private Thread cartographer_thread;
-               private ICoreClientAPI ClientAPI { get; set; }
-               private ILogger Logger { get; set; }
-               private IChunkRenderer ChunkRenderer { get; set; }
-
-               private const string _mapPath = @"Maps";
-               private const string _chunkPath = @"Chunks";
-               private const string _domain = @"automap";
-               private const string chunkFile_filter = @"*_*.png";
-               private static Regex chunkShardRegex = new Regex(@"(?<X>[\d]+)_(?<Z>[\d]+).png", RegexOptions.Singleline);
-
-               private ConcurrentDictionary<Vec2i, uint> columnCounter = new ConcurrentDictionary<Vec2i, uint>(3, 150 );
-               private ColumnsMetadata chunkTopMetadata;
-               private PointsOfInterest POIs;
-               private EntitiesOfInterest EOIs;
-
-               internal Dictionary<int, BlockDesignator> BlockID_Designators { get; private set;}
-               internal Dictionary<AssetLocation, EntityDesignator> Entity_Designators { get; private set; }
-               internal Dictionary<int, string> RockIdCodes { get; private set; }
-
-               internal bool Enabled { get; set; }
-               //Run status, Chunks processed, stats, center of map....
-               internal uint nullChunkCount, updatedChunksTotal;
-               internal Vec2i startChunkColumn;
-
-               private readonly int chunkSize;
-               private string path;
-               private IAsset stylesFile;
-
-
-               public AutomapSystem(ICoreClientAPI clientAPI, ILogger logger)
-               {
-               this.ClientAPI = clientAPI;
-               this.Logger = logger;
-               chunkSize = ClientAPI.World.BlockAccessor.ChunkSize;
-               ClientAPI.Event.LevelFinalize += EngageAutomap;
-
-               //TODO:Choose which one from GUI 
-               this.ChunkRenderer = new StandardRenderer(clientAPI, logger);
-               }
-
-
-               #region Internals
-               private void EngageAutomap( )
-               {
-               path = ClientAPI.GetOrCreateDataPath(_mapPath);
-               path = ClientAPI.GetOrCreateDataPath(Path.Combine(path, "World_" + ClientAPI.World.Seed));//Add name of World too...'ServerApi.WorldManager.CurrentWorldName'
-
-               stylesFile = ClientAPI.World.AssetManager.Get(new AssetLocation(_domain, "config/automap_format.css"));
-               Logger.VerboseDebug("CSS loaded: {0} size: {1}",stylesFile.IsLoaded() ,stylesFile.ToText( ).Length);
-
-               Prefill_POI_Designators( );
-               startChunkColumn = new Vec2i((ClientAPI.World.Player.Entity.LocalPos.AsBlockPos.X / chunkSize), (ClientAPI.World.Player.Entity.LocalPos.AsBlockPos.Z / chunkSize));
-               chunkTopMetadata = new ColumnsMetadata(startChunkColumn);
-
-               Logger.Notification("AUTOMAP Start {0}", startChunkColumn);
-               Reload_Metadata( );
-
-               ClientAPI.Event.ChunkDirty += ChunkAChanging;
-
-               cartographer_thread = new Thread(Cartographer);
-               cartographer_thread.Name = "Cartographer";
-               cartographer_thread.Priority = ThreadPriority.Lowest;
-               cartographer_thread.IsBackground = true;
-
-               ClientAPI.Event.RegisterGameTickListener(AwakenCartographer, 6000);
-               }
-
-               private void ChunkAChanging(Vec3i chunkCoord, IWorldChunk chunk, EnumChunkDirtyReason reason)
-               {                       
-               Vec2i topPosition = new Vec2i(chunkCoord.X, chunkCoord.Z);
-
-                       columnCounter.AddOrUpdate(topPosition, 1, (key, colAct) => colAct + 1);
-               }
-
-               private void AwakenCartographer(float delayed)
-               {
-
-               if (Enabled && (ClientAPI.IsGamePaused != false || ClientAPI.IsShuttingDown != true)) {
-               #if DEBUG
-               Logger.VerboseDebug("Cartographer re-trigger from [{0}]", cartographer_thread.ThreadState);
-               #endif
-
-               if (cartographer_thread.ThreadState.HasFlag(ThreadState.Unstarted)) {
-               cartographer_thread.Start( );
-               }
-               else if (cartographer_thread.ThreadState.HasFlag(ThreadState.WaitSleepJoin)) {
-               //Time to (re)write chunk shards
-               cartographer_thread.Interrupt( );
-               }
-               #if DEBUG
-               ClientAPI.TriggerChatMessage($"Automap {updatedChunksTotal} Updates - MAX (N:{chunkTopMetadata.North_mostChunk},S:{chunkTopMetadata.South_mostChunk},E:{chunkTopMetadata.East_mostChunk}, W:{chunkTopMetadata.West_mostChunk} - TOTAL: {chunkTopMetadata.Count})");
-               #endif
-               }
-
-               }
-
-
-               private void Cartographer( )
-               {
-       wake:
-               Logger.VerboseDebug("Cartographer thread awoken");
-
-               try {
-               uint ejectedItem = 0;
-               uint updatedChunks = 0;
-
-               //-- Should dodge enumerator changing underfoot....at a cost.
-               if (!columnCounter.IsEmpty) {
-               var tempSet = columnCounter.ToArray( ).OrderByDescending(kvp => kvp.Value);
-               foreach (var mostActiveCol in tempSet) {
-
-               var mapChunk = ClientAPI.World.BlockAccessor.GetMapChunk(mostActiveCol.Key);
-
-               if (mapChunk == null) {
-               Logger.Warning("SKIP CHUNK: ({0}) - Map Chunk NULL!", mostActiveCol.Key);
-               nullChunkCount++;
-               columnCounter.TryRemove(mostActiveCol.Key, out ejectedItem );
-               continue;
-               }
-               
-               ColumnMeta chunkMeta = CreateColumnMetadata(mostActiveCol,mapChunk);
-               PngWriter pngWriter = SetupPngImage(mostActiveCol.Key, chunkMeta);
-               UpdateEntityMetadata( );
-               ProcessChunkBlocks(mostActiveCol.Key, mapChunk, chunkMeta);
-
-               uint updatedPixels = 0;
-
-               ChunkRenderer.GenerateChunkPngShard(mostActiveCol.Key, mapChunk, chunkMeta, pngWriter , out updatedPixels);
-               
-               if (updatedPixels > 0) {                
-               
-               #if DEBUG
-               Logger.VerboseDebug("Wrote chunk shard: ({0}) - Edits#:{1}, Pixels#:{2}", mostActiveCol.Key, mostActiveCol.Value, updatedPixels);
-               #endif
-               updatedChunks++;
-               chunkTopMetadata.Update(chunkMeta);
-               columnCounter.TryRemove(mostActiveCol.Key, out ejectedItem);
-               }
-               else {
-               columnCounter.TryRemove(mostActiveCol.Key, out ejectedItem);
-               Logger.VerboseDebug("Un-painted chunk: ({0}) ", mostActiveCol.Key);
-               }
-
-               }
-               }
-
-               if (updatedChunks > 0) {
-               //What about chunk updates themselves; a update bitmap isn't kept...
-               updatedChunksTotal += updatedChunks;
-               GenerateMapHTML( );
-               updatedChunks = 0;
-               }
-
-               //Then sleep until interupted again, and repeat
-
-               Logger.VerboseDebug("Thread '{0}' about to sleep indefinitely.", Thread.CurrentThread.Name);
-
-               Thread.Sleep(Timeout.Infinite);
-
-               } catch (ThreadInterruptedException) {
-
-               Logger.VerboseDebug("Thread '{0}' interupted [awoken]", Thread.CurrentThread.Name);
-               goto wake;
-
-               } catch (ThreadAbortException) {
-               Logger.VerboseDebug("Thread '{0}' aborted.", Thread.CurrentThread.Name);
-
-               } finally {
-               Logger.VerboseDebug("Thread '{0}' executing finally block.", Thread.CurrentThread.Name);
-               }
-               }
-
-               private void Prefill_POI_Designators( )
-               {
-               this.POIs = new PointsOfInterest( );
-               this.EOIs = new EntitiesOfInterest( );
-               this.BlockID_Designators = new Dictionary<int, BlockDesignator>( );
-               this.Entity_Designators = new Dictionary<AssetLocation, EntityDesignator>( );
-               this.RockIdCodes = Helpers.ArbitrarytBlockIdHunter(ClientAPI, new AssetLocation(GlobalConstants.DefaultDomain, "rock"), EnumBlockMaterial.Stone);
-
-               //Add special marker types for BlockID's of "Interest", overwrite colour, and method
-
-               Install_POI_Designators(DefaultDesignators.DefaultBlockDesignators(), DefaultDesignators.DefaultEntityDesignators());
-               }
-
-               private void Install_POI_Designators(ICollection<BlockDesignator> blockDesig, List<EntityDesignator> entDesig)
-               {
-               Logger.VerboseDebug("Connecting {0} standard Block-Designators", blockDesig.Count);
-               foreach (var designator in blockDesig) {                                
-                       var blockIDs = Helpers.ArbitrarytBlockIdHunter(ClientAPI, designator.Pattern, designator.Material);
-                               if (blockIDs.Count > 0) { Logger.VerboseDebug("Designator {0} has {1} associated blockIDs", designator.ToString( ), blockIDs.Count); }
-                       foreach (var entry in blockIDs) {
-                       BlockID_Designators.Add(entry.Key, designator);
-                       }
-               }
-               this.ChunkRenderer.BlockID_Designators = BlockID_Designators;
-               
-               
-               Logger.VerboseDebug("Connecting {0} standard Entity-Designators", entDesig.Count);
-               foreach (var designator in entDesig) {
-               //Get Variants first, from EntityTypes...better be populated!
-               var matched = ClientAPI.World.EntityTypes.FindAll(entp => entp.Code.BeginsWith(designator.Pattern.Domain, designator.Pattern.Path));
-
-               foreach (var match in matched) {
-               Logger.VerboseDebug("Linked Entity: {0} Designator: {1}", match.Code, designator);
-               this.Entity_Designators.Add(match.Code, designator);
-               }
-               
-               
-
-               //EntityProperties props = ClientAPI.World.GetEntityType(designator.Pattern);
-               }
-
-
-               }
-
-               //TODO: Convert to RAZOR model
-               private void GenerateMapHTML( )
-               {
-               string mapFilename = Path.Combine(path, "Automap.html");
-
-               int TopNorth = chunkTopMetadata.North_mostChunk;
-               int TopSouth = chunkTopMetadata.South_mostChunk;
-               int TopEast = chunkTopMetadata.East_mostChunk;
-               int TopWest = chunkTopMetadata.West_mostChunk;
-
-               using (StreamWriter outputText = new StreamWriter(File.Open(mapFilename, FileMode.Create, FileAccess.Write, FileShare.ReadWrite))) {
-               using (HtmlTextWriter tableWriter = new HtmlTextWriter(outputText)) {
-               tableWriter.BeginRender( );
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Html);
-
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Head);
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Title);
-               tableWriter.WriteEncodedText("Generated Automap");
-               tableWriter.RenderEndTag( );
-               //CSS  style  here
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Style);
-               tableWriter.Write(stylesFile.ToText( ));
-               tableWriter.RenderEndTag( );//</style>
-
-               //## JSON map-state data ######################
-               tableWriter.AddAttribute(HtmlTextWriterAttribute.Type, "text/javascript");
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Script);
-
-               tableWriter.Write("var available_images = [");
-
-               foreach (var shard in this.chunkTopMetadata) {
-               tableWriter.Write("{{X:{0},Y:{1} }}, ", shard.Location.X, shard.Location.Y);
-               }
-
-               tableWriter.Write(" ];\n");
-
-               tableWriter.RenderEndTag( );
-
-               tableWriter.RenderEndTag( );
-
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Body);
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.P);
-               tableWriter.WriteEncodedText($"Created {DateTimeOffset.UtcNow.ToString("u")}");
-               tableWriter.RenderEndTag( );
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.P);
-               tableWriter.WriteEncodedText($"W:{TopWest}, E: {TopEast}, N:{TopNorth}, S:{TopSouth} ");
-               tableWriter.RenderEndTag( );
-               tableWriter.WriteLine( );
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Table);
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Caption);
-               tableWriter.WriteEncodedText($"Start: {startChunkColumn}, Seed: {ClientAPI.World.Seed}\n");             
-               tableWriter.RenderEndTag( );
-
-               //################ X-Axis <thead> #######################
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Thead);
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Tr);
-
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Th);
-               tableWriter.Write("N, W");
-               tableWriter.RenderEndTag( );
-
-               for (int xAxisT = TopWest; xAxisT <= TopEast; xAxisT++) {
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Th);
-               tableWriter.Write(xAxisT);
-               tableWriter.RenderEndTag( );
-               }
-
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Th);
-               tableWriter.Write("N, E");
-               tableWriter.RenderEndTag( );
-               
-               tableWriter.RenderEndTag( );
-               tableWriter.RenderEndTag( );
-               //###### </thead> ################################
-
-               //###### <tbody> - Chunk rows & Y-axis cols
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Tbody);
-
-               //######## <tr> for every vertical row
-               for (int yAxis = TopNorth; yAxis <= TopSouth; yAxis++) {
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Tr);
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Td);
-               tableWriter.Write(yAxis);//legend: Y-axis
-               tableWriter.RenderEndTag( );
-
-               for (int xAxis = TopWest; xAxis <= TopEast; xAxis++) {
-               //###### <td>  #### for chunk shard 
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Td);
-               var colLoc = new Vec2i(xAxis, yAxis);
-               if (chunkTopMetadata.Contains( colLoc)){
-               ColumnMeta meta = chunkTopMetadata[colLoc];
-               //Tooltip first                                 
-               tableWriter.AddAttribute(HtmlTextWriterAttribute.Class, "tooltip");
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Div);
-
-               tableWriter.AddAttribute(HtmlTextWriterAttribute.Src, $"{xAxis}_{yAxis}.png");          
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Img);
-               tableWriter.RenderEndTag( );
-               // <span class="tooltiptext">Tooltip text
-               tableWriter.AddAttribute(HtmlTextWriterAttribute.Class, "tooltiptext");
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Span);
-
-               StringBuilder tooltipText = new StringBuilder( );
-               tooltipText.Append($"{meta.Location.PrettyCoords(ClientAPI)} ");
-               tooltipText.Append($" Max-Height: {meta.YMax}, Temp: {meta.Temperature.ToString("F1")} " );
-               tooltipText.Append($" Rainfall: {meta.Rainfall.ToString("F1")}, ");
-               tooltipText.Append($" Shrubs: {meta.ShrubDensity.ToString("F1")}, ");
-               tooltipText.Append($" Forest: {meta.ForestDensity.ToString("F1")}, ");
-               tooltipText.Append($" Fertility: {meta.Fertility.ToString("F1")}, ");
-
-               if (meta.RockRatio != null) {
-               foreach (KeyValuePair<int, uint> blockID in meta.RockRatio) {
-               var block = ClientAPI.World.GetBlock(blockID.Key);
-               tooltipText.AppendFormat(" {0} × {1},\t", block.Code.GetName( ), meta.RockRatio[blockID.Key]);
-               }
-               }
-
-               tableWriter.WriteEncodedText(tooltipText.ToString() );
-               
-               tableWriter.RenderEndTag( );//</span>
-                                                                               
-
-               tableWriter.RenderEndTag( );//</div> --tooltip enclosure
-               }
-               else {
-               tableWriter.Write("?");
-               }       
-
-               tableWriter.RenderEndTag( );
-               }//############ </td> ###########
-
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Td);
-               tableWriter.Write(yAxis);//legend: Y-axis
-               tableWriter.RenderEndTag( );
-
-               tableWriter.RenderEndTag( );
-               
-               }
-               tableWriter.RenderEndTag( );
-
-               //################ X-Axis <tfoot> #######################
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Tfoot);
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Tr);
-
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Td);
-               tableWriter.Write("S, W");
-               tableWriter.RenderEndTag( );
-
-               for (int xAxisB = TopWest; xAxisB <= TopEast; xAxisB++) {
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Td);
-               tableWriter.Write(xAxisB);
-               tableWriter.RenderEndTag( );
-               }
-
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Td);
-               tableWriter.Write("S, E");
-               tableWriter.RenderEndTag( );
-
-               tableWriter.RenderEndTag( );
-               tableWriter.RenderEndTag( );
-               //###### </tfoot> ################################
-
-
-               tableWriter.RenderEndTag( );//</table>
-
-               //############## POI list #####################
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.P);
-               tableWriter.WriteLine("Points of Interest");
-               tableWriter.RenderEndTag( );
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Ul);
-               foreach (var poi in this.POIs) {
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Li);
-               tableWriter.WriteEncodedText(poi.Location.PrettyCoords(this.ClientAPI)+"\t");
-               tableWriter.WriteEncodedText(poi.Notes+ "\t");
-               tableWriter.WriteEncodedText(poi.Timestamp.ToString("u"));
-               tableWriter.RenderEndTag( );
-               }
-
-               foreach (var eoi in this.EOIs.PointsList) {
-               tableWriter.RenderBeginTag(HtmlTextWriterTag.Li);
-               tableWriter.WriteEncodedText(eoi.Location.PrettyCoords(this.ClientAPI)+ "\t");
-               tableWriter.WriteEncodedText(eoi.Notes+ "\t");
-               tableWriter.WriteEncodedText(eoi.Timestamp.ToString("u") );
-               tableWriter.RenderEndTag( );
-               }
-
-               tableWriter.RenderEndTag( );
-
-               
-
-
-               tableWriter.RenderEndTag( );//### </BODY> ###
-                                                       
-               tableWriter.EndRender( );
-               tableWriter.Flush( );
-               }
-               outputText.Flush( );            
-               }
-
-               Logger.VerboseDebug("Generated HTML map");
-               }
-
-
-
-               private ColumnMeta CreateColumnMetadata(KeyValuePair<Vec2i, uint> mostActiveCol, IMapChunk mapChunk)
-               {
-               ColumnMeta data = new ColumnMeta(mostActiveCol.Key.Copy(), chunkSize);
-               BlockPos equivBP = new BlockPos(mostActiveCol.Key.X * chunkSize,
-                                                                               mapChunk.YMax,
-                                                                               mostActiveCol.Key.Y * chunkSize);
-
-               var climate = ClientAPI.World.BlockAccessor.GetClimateAt(equivBP);
-               data.UpdateFieldsFrom(climate, mapChunk,TimeSpan.FromHours(ClientAPI.World.Calendar.TotalHours));               
-
-               return data;
-               }
-
-               /// <summary>
-               /// Reload chunk bounds from chunk shards
-               /// </summary>
-               /// <returns>The metadata.</returns>
-               private void Reload_Metadata( )
-               {       
-               var worldmapDir = new DirectoryInfo(path);
-
-               if (worldmapDir.Exists) {
-
-               var files = worldmapDir.GetFiles(chunkFile_filter);
-
-               if (files.Length > 0) {
-               #if DEBUG
-               Logger.VerboseDebug("{0} Existing world chunk shards", files.Length);
-               #endif
-
-               
-
-               foreach (var shardFile in files) {
-
-               if (shardFile.Length < 512) continue;
-               var result = chunkShardRegex.Match(shardFile.Name);
-               if (result.Success) {
-               int X_chunk_pos = int.Parse(result.Groups["X"].Value );
-               int Z_chunk_pos = int.Parse(result.Groups["Z"].Value );
-               
-               //Parse PNG chunks for METADATA in shard
-               using (var fileStream = shardFile.OpenRead( ))
-               {
-               PngReader pngRead = new PngReader(fileStream );
-               pngRead.ReadSkippingAllRows( );
-               pngRead.End( );
-
-               PngMetadataChunk metadataFromPng = pngRead.GetChunksList( ).GetById1(PngMetadataChunk.ID) as PngMetadataChunk;
-
-               chunkTopMetadata.Add(metadataFromPng.ChunkMetadata);
-               }
-               
-               }
-               }
-
-               }
-               }
-               else {
-               #if DEBUG
-               Logger.VerboseDebug("Could not open world map directory");
-               #endif
-               }
-
-
-
-               }
-
-               private PngWriter SetupPngImage(Vec2i coord, ColumnMeta metadata)
-               {
-               ImageInfo imageInf = new ImageInfo(chunkSize, chunkSize, 8, false);
-               
-               string filename = $"{coord.X}_{coord.Y}.png";
-               filename = Path.Combine(path, filename);
-
-               PngWriter pngWriter = FileHelper.CreatePngWriter(filename, imageInf, true);
-               PngMetadata meta = pngWriter.GetMetadata( );
-               meta.SetTimeNow( );
-               meta.SetText("Chunk_X", coord.X.ToString("D"));
-               meta.SetText("Chunk_Y", coord.Y.ToString("D"));
-               //Setup specialized meta-data PNG chunks here...
-               PngMetadataChunk pngChunkMeta = new PngMetadataChunk(pngWriter.ImgInfo);
-               pngChunkMeta.ChunkMetadata = metadata;          
-               pngWriter.GetChunksList( ).Queue(pngChunkMeta);
-
-               return pngWriter;
-               }
-
-               /// <summary>
-               /// Does the heavy lifting of Scanning columns of chunks - creates Heightmap and Processes POIs, Entities, and stats...
-               /// </summary>
-               /// <param name="key">Chunk Coordinate</param>
-               /// <param name="mapChunk">Map chunk.</param>
-               /// <param name="chunkMeta">Chunk metadata</param>
-               private void ProcessChunkBlocks(Vec2i key, IMapChunk mapChunk, ColumnMeta chunkMeta)
-               {
-
-               int targetChunkY = mapChunk.YMax / chunkSize;//Surface ... 
-               for (; targetChunkY > 0; targetChunkY--) {
-               WorldChunk chunkData = ClientAPI.World.BlockAccessor.GetChunk(key.X, targetChunkY, key.Y) as WorldChunk;
-
-               if (chunkData == null || chunkData.BlockEntities == null) {
-               #if DEBUG
-               Logger.VerboseDebug("Chunk null or empty X{0} Y{1} Z{2}", key.X,targetChunkY,key.Y);
-               #endif
-               continue;
-               }
-
-               /*************** Chunk Entities Scanning *********************/
-               if (chunkData.BlockEntities != null && chunkData.BlockEntities.Length > 0) {
-               #if DEBUG
-               Logger.VerboseDebug("Surface@ {0} = BlockEntities: {1}", key, chunkData.BlockEntities.Length);
-               #endif
-
-               foreach (var blockEnt in chunkData.BlockEntities) {
-               
-                       if (blockEnt != null && blockEnt.Block != null && BlockID_Designators.ContainsKey(blockEnt.Block.BlockId)) 
-                       {
-                       var designator = BlockID_Designators[blockEnt.Block.BlockId];
-                       designator.SpecialAction(ClientAPI, POIs, blockEnt.Pos.Copy( ), blockEnt.Block);
-                       }
-               }
-               
-               }
-               /********************* Chunk/Column BLOCKs scanning ****************/
-               //Heightmap, Stats, block tally
-               chunkData.Unpack( );
-
-               int X_index, Y_index, Z_index;
-               X_index = Y_index = Z_index = 0;
-
-               do {
-               do {
-               do {
-               /* Encode packed indicie
-               (y * chunksize + z) * chunksize + x
-               */
-               var indicie = Helpers.ChunkBlockIndicie16(X_index, Y_index, Z_index);
-               int aBlockId = chunkData.Blocks[indicie];
-                                                                       
-               if (aBlockId == 0) {//Air
-               chunkMeta.AirBlocks++;
-               continue;
-               }
-
-               if (RockIdCodes.ContainsKey(aBlockId)) {
-               if (chunkMeta.RockRatio.ContainsKey(aBlockId)) { chunkMeta.RockRatio[aBlockId]++; } else { chunkMeta.RockRatio.Add(aBlockId, 1); }              
-               }
-               
-               chunkMeta.NonAirBlocks++;               
-
-               //Heightmap 
-               if (chunkMeta.HeightMap[X_index, Z_index] == 0) 
-               { chunkMeta.HeightMap[X_index, Z_index] = ( ushort )(Y_index + (targetChunkY * chunkSize)); }
-
-               }
-               while (X_index++ < (chunkSize - 1));
-               X_index = 0;
-               }
-               while (Z_index++ < (chunkSize - 1));
-               Z_index = 0;
-               }
-               while (Y_index++ < (chunkSize - 1));
-
-               }
-               }
-
-               private void UpdateEntityMetadata( )
-               {
-               Logger.Debug("Presently {0} Entities", ClientAPI.World.LoadedEntities.Count);
-               //Mabey scan only for 'new' entities by tracking ID in set?
-               foreach (var loadedEntity in ClientAPI.World.LoadedEntities.ToList()) {
-               
-               #if DEBUG
-               //Logger.VerboseDebug($"ENTITY: ({loadedEntity.Value.Code}) = #{loadedEntity.Value.EntityId} {loadedEntity.Value.State} {loadedEntity.Value.LocalPos}    <<<<<<<<<<<<");
-               #endif
-
-               var dMatch = Entity_Designators.SingleOrDefault(se => se.Key.Equals(loadedEntity.Value.Code));
-               if (dMatch.Value != null) {                     
-                       dMatch.Value.SpecialAction(ClientAPI, this.EOIs, loadedEntity.Value.LocalPos.AsBlockPos.Copy( ), loadedEntity.Value);                                           
-               }
-
-               }
-
-
-               }
-
-
-
-
-
-               #endregion
-
-
-       }
+    public class AutomapSystem
+    {
+        private Thread cartographer_thread;
+        private ICoreClientAPI ClientAPI { get; set; }
+        private ILogger Logger { get; set; }
+        private IChunkRenderer ChunkRenderer { get; set; }
+
+        private const string _mapPath = @"Maps";
+        private const string _chunkPath = @"Chunks";
+        private const string _domain = @"automap";
+        private const string chunkFile_filter = @"*_*.png";
+        private static Regex chunkShardRegex = new Regex(@"(?<X>[\d]+)_(?<Z>[\d]+).png", RegexOptions.Singleline);
+
+        private ConcurrentDictionary<Vec2i, uint> columnCounter = new ConcurrentDictionary<Vec2i, uint>(3, 150);
+        private ColumnsMetadata chunkTopMetadata;
+        private PointsOfInterest POIs;
+        private EntitiesOfInterest EOIs;
+
+        internal Dictionary<int, BlockDesignator> BlockID_Designators { get; private set; }
+        internal Dictionary<AssetLocation, EntityDesignator> Entity_Designators { get; private set; }
+
+        internal bool Enabled { get; set; }
+        //Run status, Chunks processed, stats, center of map....
+        internal uint nullChunkCount, updatedChunksTotal;
+        internal Vec2i startChunkColumn;
+
+        private readonly int chunkSize;
+        private string path;
+        private IAsset stylesFile;
+
+
+        public AutomapSystem(ICoreClientAPI clientAPI, ILogger logger)
+        {
+            this.ClientAPI = clientAPI;
+            this.Logger = logger;
+            chunkSize = ClientAPI.World.BlockAccessor.ChunkSize;
+            ClientAPI.Event.LevelFinalize += EngageAutomap;
+
+            //TODO:Choose which one from GUI 
+            this.ChunkRenderer = new StandardRenderer(clientAPI, logger);
+        }
+
+
+        #region Internals
+        private void EngageAutomap()
+        {
+            path = ClientAPI.GetOrCreateDataPath(_mapPath);
+            path = ClientAPI.GetOrCreateDataPath(Path.Combine(path, "World_" + ClientAPI.World.Seed));//Add name of World too...'ServerApi.WorldManager.CurrentWorldName'
+
+            stylesFile = ClientAPI.World.AssetManager.Get(new AssetLocation(_domain, "config/automap_format.css"));
+            Logger.VerboseDebug("CSS loaded: {0} size: {1}", stylesFile.IsLoaded(), stylesFile.ToText().Length);
+
+            Prefill_POI_Designators();
+            startChunkColumn = new Vec2i((ClientAPI.World.Player.Entity.LocalPos.AsBlockPos.X / chunkSize), (ClientAPI.World.Player.Entity.LocalPos.AsBlockPos.Z / chunkSize));
+            chunkTopMetadata = new ColumnsMetadata(startChunkColumn);
+
+            Logger.Notification("AUTOMAP Start {0}", startChunkColumn);
+            Reload_Metadata();
+
+            ClientAPI.Event.ChunkDirty += ChunkAChanging;
+
+            cartographer_thread = new Thread(Cartographer)
+            {
+                Name = "Cartographer",
+                Priority = ThreadPriority.Lowest,
+                IsBackground = true
+            };
+
+            ClientAPI.Event.RegisterGameTickListener(AwakenCartographer, 6000);
+        }
+
+        private void ChunkAChanging(Vec3i chunkCoord, IWorldChunk chunk, EnumChunkDirtyReason reason)
+        {
+            Vec2i topPosition = new Vec2i(chunkCoord.X, chunkCoord.Z);
+
+            columnCounter.AddOrUpdate(topPosition, 1, (key, colAct) => colAct + 1);
+        }
+
+        private void AwakenCartographer(float delayed)
+        {
+
+            if (Enabled && (ClientAPI.IsGamePaused != false || ClientAPI.IsShuttingDown != true))
+            {
+#if DEBUG
+                Logger.VerboseDebug("Cartographer re-trigger from [{0}]", cartographer_thread.ThreadState);
+#endif
+
+                if (cartographer_thread.ThreadState.HasFlag(ThreadState.Unstarted))
+                {
+                    cartographer_thread.Start();
+                }
+                else if (cartographer_thread.ThreadState.HasFlag(ThreadState.WaitSleepJoin))
+                {
+                    //Time to (re)write chunk shards
+                    cartographer_thread.Interrupt();
+                }
+#if DEBUG
+                ClientAPI.TriggerChatMessage($"Automap {updatedChunksTotal} Updates - MAX (N:{chunkTopMetadata.North_mostChunk},S:{chunkTopMetadata.South_mostChunk},E:{chunkTopMetadata.East_mostChunk}, W:{chunkTopMetadata.West_mostChunk} - TOTAL: {chunkTopMetadata.Count})");
+#endif
+            }
+
+        }
+
+
+        private void Cartographer()
+        {
+        wake:
+            Logger.VerboseDebug("Cartographer thread awoken");
+
+            try
+            {
+                uint ejectedItem = 0;
+                uint updatedChunks = 0;
+
+                //-- Should dodge enumerator changing underfoot....at a cost.
+                if (!columnCounter.IsEmpty)
+                {
+                    var tempSet = columnCounter.ToArray().OrderByDescending(kvp => kvp.Value);
+                    foreach (var mostActiveCol in tempSet)
+                    {
+
+                        var mapChunk = ClientAPI.World.BlockAccessor.GetMapChunk(mostActiveCol.Key);
+
+                        if (mapChunk == null)
+                        {
+                            Logger.Warning("SKIP CHUNK: ({0}) - Map Chunk NULL!", mostActiveCol.Key);
+                            nullChunkCount++;
+                            columnCounter.TryRemove(mostActiveCol.Key, out ejectedItem);
+                            continue;
+                        }
+
+                        ColumnMeta chunkMeta = CreateColumnMetadata(mostActiveCol, mapChunk);
+                        PngWriter pngWriter = SetupPngImage(mostActiveCol.Key, chunkMeta);
+                        UpdateEntityMetadata();
+                        ProcessChunkBlocks(mostActiveCol.Key, mapChunk, chunkMeta);
+
+
+                        ChunkRenderer.GenerateChunkPngShard(mostActiveCol.Key, mapChunk, chunkMeta, pngWriter, out uint updatedPixels);
+
+                        if (updatedPixels > 0)
+                        {
+
+#if DEBUG
+                            Logger.VerboseDebug("Wrote chunk shard: ({0}) - Edits#:{1}, Pixels#:{2}", mostActiveCol.Key, mostActiveCol.Value, updatedPixels);
+#endif
+                            updatedChunks++;
+                            chunkTopMetadata.Update(chunkMeta);
+                            columnCounter.TryRemove(mostActiveCol.Key, out ejectedItem);
+                        }
+                        else
+                        {
+                            columnCounter.TryRemove(mostActiveCol.Key, out ejectedItem);
+                            Logger.VerboseDebug("Un-painted chunk: ({0}) ", mostActiveCol.Key);
+                        }
+
+                    }
+                }
+
+                if (updatedChunks > 0)
+                {
+                    //What about chunk updates themselves; a update bitmap isn't kept...
+                    updatedChunksTotal += updatedChunks;
+                    GenerateMapHTML();
+                    updatedChunks = 0;
+                }
+
+                //Then sleep until interupted again, and repeat
+
+                Logger.VerboseDebug("Thread '{0}' about to sleep indefinitely.", Thread.CurrentThread.Name);
+
+                Thread.Sleep(Timeout.Infinite);
+
+            }
+            catch (ThreadInterruptedException)
+            {
+
+                Logger.VerboseDebug("Thread '{0}' interupted [awoken]", Thread.CurrentThread.Name);
+                goto wake;
+
+            }
+            catch (ThreadAbortException)
+            {
+                Logger.VerboseDebug("Thread '{0}' aborted.", Thread.CurrentThread.Name);
+
+            }
+            finally
+            {
+                Logger.VerboseDebug("Thread '{0}' executing finally block.", Thread.CurrentThread.Name);
+            }
+        }
+
+        private void Prefill_POI_Designators()
+        {
+            this.POIs = new PointsOfInterest();
+            this.EOIs = new EntitiesOfInterest();
+            this.BlockID_Designators = new Dictionary<int, BlockDesignator>();
+            this.Entity_Designators = new Dictionary<AssetLocation, EntityDesignator>();
+
+            //Add special marker types for BlockID's of "Interest", overwrite colour, and method
+
+            Install_POI_Designators(DefaultDesignators.DefaultBlockDesignators(), DefaultDesignators.DefaultEntityDesignators());
+        }
+
+        private void Install_POI_Designators(ICollection<BlockDesignator> blockDesig, List<EntityDesignator> entDesig)
+        {
+            Logger.VerboseDebug("Connecting {0} standard Block-Designators", blockDesig.Count);
+            foreach (var designator in blockDesig)
+            {
+                var blockIDs = Helpers.ArbitrarytBlockIdHunter(ClientAPI, designator.Pattern, designator.Material);
+                if (blockIDs.Count > 0) { Logger.VerboseDebug("Designator {0} has {1} associated blockIDs", designator.ToString(), blockIDs.Count); }
+                foreach (var entry in blockIDs)
+                {
+                    BlockID_Designators.Add(entry.Key, designator);
+                }
+            }
+            this.ChunkRenderer.BlockID_Designators = BlockID_Designators;
+
+
+            Logger.VerboseDebug("Connecting {0} standard Entity-Designators", entDesig.Count);
+            foreach (var designator in entDesig)
+            {
+                //Get Variants first, from EntityTypes...better be populated!
+                var matched = ClientAPI.World.EntityTypes.FindAll(entp => entp.Code.BeginsWith(designator.Pattern.Domain, designator.Pattern.Path));
+
+                foreach (var match in matched)
+                {
+                    Logger.VerboseDebug("Linked Entity: {0} Designator: {1}", match.Code, designator);
+                    this.Entity_Designators.Add(match.Code, designator);
+                }
+
+
+
+                //EntityProperties props = ClientAPI.World.GetEntityType(designator.Pattern);
+            }
+
+
+        }
+
+        //TODO: Convert to RAZOR model
+        private void GenerateMapHTML()
+        {
+            string mapFilename = Path.Combine(path, "Automap.html");
+
+            int TopNorth = chunkTopMetadata.North_mostChunk;
+            int TopSouth = chunkTopMetadata.South_mostChunk;
+            int TopEast = chunkTopMetadata.East_mostChunk;
+            int TopWest = chunkTopMetadata.West_mostChunk;
+
+            using (StreamWriter outputText = new StreamWriter(File.Open(mapFilename, FileMode.Create, FileAccess.Write, FileShare.ReadWrite)))
+            {
+                using (HtmlTextWriter tableWriter = new HtmlTextWriter(outputText))
+                {
+                    tableWriter.BeginRender();
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.Html);
+
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.Head);
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.Title);
+                    tableWriter.WriteEncodedText("Generated Automap");
+                    tableWriter.RenderEndTag();
+                    //CSS  style  here
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.Style);
+                    tableWriter.Write(stylesFile.ToText());
+                    tableWriter.RenderEndTag();//</style>
+
+                    //## JSON map-state data ######################
+                    tableWriter.AddAttribute(HtmlTextWriterAttribute.Type, "text/javascript");
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.Script);
+
+                    tableWriter.Write("var available_images = [");
+
+                    foreach (var shard in this.chunkTopMetadata)
+                    {
+                        tableWriter.Write("{{X:{0},Y:{1} }}, ", shard.Location.X, shard.Location.Y);
+                    }
+
+                    tableWriter.Write(" ];\n");
+
+                    tableWriter.RenderEndTag();
+
+                    tableWriter.RenderEndTag();
+
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.Body);
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.P);
+                    tableWriter.WriteEncodedText($"Created {DateTimeOffset.UtcNow.ToString("u")}");
+                    tableWriter.RenderEndTag();
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.P);
+                    tableWriter.WriteEncodedText($"W:{TopWest}, E: {TopEast}, N:{TopNorth}, S:{TopSouth} ");
+                    tableWriter.RenderEndTag();
+                    tableWriter.WriteLine();
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.Table);
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.Caption);
+                    tableWriter.WriteEncodedText($"Start: {startChunkColumn}, Seed: {ClientAPI.World.Seed}\n");
+                    tableWriter.RenderEndTag();
+
+                    //################ X-Axis <thead> #######################
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.Thead);
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.Tr);
+
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.Th);
+                    tableWriter.Write("N, W");
+                    tableWriter.RenderEndTag();
+
+                    for (int xAxisT = TopWest; xAxisT <= TopEast; xAxisT++)
+                    {
+                        tableWriter.RenderBeginTag(HtmlTextWriterTag.Th);
+                        tableWriter.Write(xAxisT);
+                        tableWriter.RenderEndTag();
+                    }
+
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.Th);
+                    tableWriter.Write("N, E");
+                    tableWriter.RenderEndTag();
+
+                    tableWriter.RenderEndTag();
+                    tableWriter.RenderEndTag();
+                    //###### </thead> ################################
+
+                    //###### <tbody> - Chunk rows & Y-axis cols
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.Tbody);
+
+                    //######## <tr> for every vertical row
+                    for (int yAxis = TopNorth; yAxis <= TopSouth; yAxis++)
+                    {
+                        tableWriter.RenderBeginTag(HtmlTextWriterTag.Tr);
+                        tableWriter.RenderBeginTag(HtmlTextWriterTag.Td);
+                        tableWriter.Write(yAxis);//legend: Y-axis
+                        tableWriter.RenderEndTag();
+
+                        for (int xAxis = TopWest; xAxis <= TopEast; xAxis++)
+                        {
+                            //###### <td>  #### for chunk shard 
+                            tableWriter.RenderBeginTag(HtmlTextWriterTag.Td);
+                            var colLoc = new Vec2i(xAxis, yAxis);
+                            if (chunkTopMetadata.Contains(colLoc))
+                            {
+                                ColumnMeta meta = chunkTopMetadata[colLoc];
+                                //Tooltip first                                        
+                                tableWriter.AddAttribute(HtmlTextWriterAttribute.Class, "tooltip");
+                                tableWriter.RenderBeginTag(HtmlTextWriterTag.Div);
+
+                                tableWriter.AddAttribute(HtmlTextWriterAttribute.Src, $"{xAxis}_{yAxis}.png");
+                                tableWriter.RenderBeginTag(HtmlTextWriterTag.Img);
+                                tableWriter.RenderEndTag();
+                                // <span class="tooltiptext">Tooltip text
+                                tableWriter.AddAttribute(HtmlTextWriterAttribute.Class, "tooltiptext");
+                                tableWriter.RenderBeginTag(HtmlTextWriterTag.Span);
+
+                                StringBuilder tooltipText = new StringBuilder();
+                                tooltipText.Append($"{meta.Location.PrettyCoords(ClientAPI)} ");
+                                tooltipText.Append($" Max-Height: {meta.YMax}, Temp: {meta.Temperature.ToString("F1")} ");
+                                tooltipText.Append($" Rainfall: {meta.Rainfall.ToString("F1")}, ");
+                                tooltipText.Append($" Shrubs: {meta.ShrubDensity.ToString("F1")}, ");
+                                tooltipText.Append($" Forest: {meta.ForestDensity.ToString("F1")}, ");
+                                tooltipText.Append($" Fertility: {meta.Fertility.ToString("F1")}, ");
+
+                                if (meta.RockRatio != null)
+                                {
+                                    foreach (KeyValuePair<int, uint> blockID in meta.RockRatio)
+                                    {
+                                        var block = ClientAPI.World.GetBlock(blockID.Key);
+                                        tooltipText.AppendFormat(" {0} × {1},\t", block.Code.GetName(), meta.RockRatio[blockID.Key]);
+                                    }
+                                }
+
+                                tableWriter.WriteEncodedText(tooltipText.ToString());
+
+                                tableWriter.RenderEndTag();//</span>
+
+
+                                tableWriter.RenderEndTag();//</div> --tooltip enclosure
+                            }
+                            else
+                            {
+                                tableWriter.Write("?");
+                            }
+
+                            tableWriter.RenderEndTag();
+                        }//############ </td> ###########
+
+                        tableWriter.RenderBeginTag(HtmlTextWriterTag.Td);
+                        tableWriter.Write(yAxis);//legend: Y-axis
+                        tableWriter.RenderEndTag();
+
+                        tableWriter.RenderEndTag();
+
+                    }
+                    tableWriter.RenderEndTag();
+
+                    //################ X-Axis <tfoot> #######################
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.Tfoot);
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.Tr);
+
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.Td);
+                    tableWriter.Write("S, W");
+                    tableWriter.RenderEndTag();
+
+                    for (int xAxisB = TopWest; xAxisB <= TopEast; xAxisB++)
+                    {
+                        tableWriter.RenderBeginTag(HtmlTextWriterTag.Td);
+                        tableWriter.Write(xAxisB);
+                        tableWriter.RenderEndTag();
+                    }
+
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.Td);
+                    tableWriter.Write("S, E");
+                    tableWriter.RenderEndTag();
+
+                    tableWriter.RenderEndTag();
+                    tableWriter.RenderEndTag();
+                    //###### </tfoot> ################################
+
+
+                    tableWriter.RenderEndTag();//</table>
+
+                    //############## POI list #####################
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.P);
+                    tableWriter.WriteLine("Points of Interest");
+                    tableWriter.RenderEndTag();
+                    tableWriter.RenderBeginTag(HtmlTextWriterTag.Ul);
+                    foreach (var poi in this.POIs)
+                    {
+                        tableWriter.RenderBeginTag(HtmlTextWriterTag.Li);
+                        tableWriter.WriteEncodedText(poi.Location.PrettyCoords(this.ClientAPI) + "\t");
+                        tableWriter.WriteEncodedText(poi.Notes + "\t");
+                        tableWriter.WriteEncodedText(poi.Timestamp.ToString("u"));
+                        tableWriter.RenderEndTag();
+                    }
+
+                    foreach (var eoi in this.EOIs.PointsList)
+                    {
+                        tableWriter.RenderBeginTag(HtmlTextWriterTag.Li);
+                        tableWriter.WriteEncodedText(eoi.Location.PrettyCoords(this.ClientAPI) + "\t");
+                        tableWriter.WriteEncodedText(eoi.Notes + "\t");
+                        tableWriter.WriteEncodedText(eoi.Timestamp.ToString("u"));
+                        tableWriter.RenderEndTag();
+                    }
+
+                    tableWriter.RenderEndTag();
+
+
+
+
+                    tableWriter.RenderEndTag();//### </BODY> ###
+
+                    tableWriter.EndRender();
+                    tableWriter.Flush();
+                }
+                outputText.Flush();
+            }
+
+            Logger.VerboseDebug("Generated HTML map");
+        }
+
+
+
+        private ColumnMeta CreateColumnMetadata(KeyValuePair<Vec2i, uint> mostActiveCol, IMapChunk mapChunk)
+        {
+            ColumnMeta data = new ColumnMeta(mostActiveCol.Key.Copy(), chunkSize);
+            BlockPos equivBP = new BlockPos(mostActiveCol.Key.X * chunkSize,
+                                            mapChunk.YMax,
+                                            mostActiveCol.Key.Y * chunkSize);
+
+            var climate = ClientAPI.World.BlockAccessor.GetClimateAt(equivBP);
+            data.UpdateFieldsFrom(climate, mapChunk, TimeSpan.FromHours(ClientAPI.World.Calendar.TotalHours));
+
+            return data;
+        }
+
+        /// <summary>
+        /// Reload chunk bounds from chunk shards
+        /// </summary>
+        /// <returns>The metadata.</returns>
+        private void Reload_Metadata()
+        {
+            var worldmapDir = new DirectoryInfo(path);
+
+            if (worldmapDir.Exists)
+            {
+
+                var files = worldmapDir.GetFiles(chunkFile_filter);
+
+                if (files.Length > 0)
+                {
+#if DEBUG
+                    Logger.VerboseDebug("{0} Existing world chunk shards", files.Length);
+#endif
+                    foreach (var shardFile in files)
+                    {
+
+                        if (shardFile.Length < 1000) continue;
+                        var result = chunkShardRegex.Match(shardFile.Name);
+                        if (result.Success)
+                        {
+                            int X_chunk_pos = int.Parse(result.Groups["X"].Value);
+                            int Z_chunk_pos = int.Parse(result.Groups["Z"].Value);
+
+                            //Parse PNG chunks for METADATA in shard
+                            using var fileStream = shardFile.OpenRead();
+                            PngReader pngRead = new PngReader(fileStream);
+                            pngRead.ReadSkippingAllRows();
+                            pngRead.End();
+
+                            PngMetadataChunk metadataFromPng = pngRead.GetChunksList().GetById1(PngMetadataChunk.ID) as PngMetadataChunk;
+
+                            chunkTopMetadata.Add(metadataFromPng.ChunkMetadata);
+
+                        }
+                    }
+
+                }
+            }
+            else
+            {
+#if DEBUG
+                Logger.VerboseDebug("Could not open world map directory");
+#endif
+            }
+
+
+
+        }
+
+        private PngWriter SetupPngImage(Vec2i coord, ColumnMeta metadata)
+        {
+            ImageInfo imageInf = new ImageInfo(chunkSize, chunkSize, 8, false);
+
+            string filename = $"{coord.X}_{coord.Y}.png";
+            filename = Path.Combine(path, filename);
+
+            PngWriter pngWriter = FileHelper.CreatePngWriter(filename, imageInf, true);
+            PngMetadata meta = pngWriter.GetMetadata();
+            meta.SetTimeNow();
+            meta.SetText("Chunk_X", coord.X.ToString("D"));
+            meta.SetText("Chunk_Y", coord.Y.ToString("D"));
+            //Setup specialized meta-data PNG chunks here...
+            PngMetadataChunk pngChunkMeta = new PngMetadataChunk(pngWriter.ImgInfo)
+            {
+                ChunkMetadata = metadata
+            };
+            pngWriter.GetChunksList().Queue(pngChunkMeta);
+
+            return pngWriter;
+        }
+
+        /// <summary>
+        /// Does the heavy lifting of Scanning columns of chunks - creates Heightmap and Processes POIs, Entities, and stats...
+        /// </summary>
+        /// <param name="key">Chunk Coordinate</param>
+        /// <param name="mapChunk">Map chunk.</param>
+        /// <param name="chunkMeta">Chunk metadata</param>
+        private void ProcessChunkBlocks(Vec2i key, IMapChunk mapChunk, ColumnMeta chunkMeta)
+        {
+            //TODO: build stack of chunk(s) - surface down to bedrock
+            int topChunkY = mapChunk.YMax / chunkSize;
+            WorldChunk chunkData = (Vintagestory.Common.WorldChunk)ClientAPI.World.BlockAccessor.GetChunk(key.X, topChunkY, key.Y);
+
+            if (chunkData.BlockEntities != null && chunkData.BlockEntities.Length > 0)
+            {
+#if DEBUG
+                Logger.VerboseDebug("Surface@ {0} = BlockEntities: {1}", key, chunkData.BlockEntities.Length);
+
+                foreach (var blockEnt in chunkData.BlockEntities)
+                {
+                    if (BlockID_Designators.ContainsKey(blockEnt.Block.BlockId))
+                    {
+                        var designator = BlockID_Designators[blockEnt.Block.BlockId];
+                        designator.SpecialAction(ClientAPI, POIs, blockEnt.Pos.Copy(), blockEnt.Block);
+                    }
+                }
+#endif
+            }
+
+        }
+
+        private void UpdateEntityMetadata()
+        {
+            Logger.Debug("Presently {0} Entities", ClientAPI.World.LoadedEntities.Count);
+            //Mabey scan only for 'new' entities by tracking ID in set?
+            foreach (var loadedEntity in ClientAPI.World.LoadedEntities.ToList())
+            {
+
+#if DEBUG
+                //Logger.VerboseDebug($"ENTITY: ({loadedEntity.Value.Code}) = #{loadedEntity.Value.EntityId} {loadedEntity.Value.State} {loadedEntity.Value.LocalPos}    <<<<<<<<<<<<");
+#endif
+
+                var dMatch = Entity_Designators.SingleOrDefault(se => se.Key.Equals(loadedEntity.Value.Code));
+                if (dMatch.Value != null)
+                {
+                    if (dMatch.Value.Enabled)
+                    {
+                        dMatch.Value.SpecialAction(ClientAPI, this.EOIs, loadedEntity.Value.LocalPos.AsBlockPos.Copy(), loadedEntity.Value);
+                    }
+                }
+
+            }
+
+
+        }
+
+
+
+
+
+        #endregion
+
+
+    }
 
 }
\ No newline at end of file