InfiniMap is a map library capable of expressing sparsely stored chunk based maps.
Examples live in InfiniMap.Text but the basic gist of the library is:
// Create a new 3D Map (there is also Map2D) var map = new Map3D<float>(); // Put something at (0,0,0) map[0, 0, 0] = 1.0f; // Chunk: (0,0,0) // Put something at (16,16,16) map[16, 16, 16] = 2.0f; // Chunk: (1,1,1) // Put something at (32,32,32) map[32, 32, 32] = 4.0f; // Chunk: (2,2,2)
When infinimap generates a new chunk, it invokes a user registerable callback provided via
RegisterWriter(...) which provides the chunk itself as a sequence and the chunk coordinates, there is also a
RegisterReader(...) which provides chunk coordinates and expects a sequence in return.
For managing entities; non-tile data; inside a chunk, the methods
RemoveEntity(...) are provided for managing entities at a chunk level, the only requirement for an entity to be managed with this system is that it implement
IEntityLocationData for coordinate tracking.
There are three coordinate systems in use, Chunk, Item, and World.
A coordinate of a chunk among other chunks, the center of the world is chunk (0,0,0) the chunk sitting on top of that to it would be (0,0,1)
A coordinate of an item among other items, the center of world is (0,0,0) and an item directly ontop of it would be (0,0,1). An item 63 s away on the Y plane would be (0,63,1)
A coordinate of an item inside a block, translated from d-space. The item at (worldspace) (0,0,1) exists in the chunk space of (0,0,0) and the block space of (0,0,1). An item at (63,0,0) in the world exists in chunkspace at (3,0,0) and itemspace of (15,0,0)