Subscribe to download
Projection Status

This mod helps you with building and maintaining your grids by highlighting blocks directly in the game world, which deviate from the projected blueprint.

* The following statuses are tracked and highlighting for each can be independently enabled:

• missing blocks (only available if "Show only buildable" = Off)
  
• buildable blocks
  
• wrong type blocks (when the gridspace is occupied by a different kind of block)
  
• wrong orientated blocks (correct block type, but rotated or offset in a different way)
  
• damaged blocks (includes deformed | compares against desired HP, so build states are possible)
  
• wrong painted blocks (wrong color or different skin)

* The number of total highlighted blocks can be limited while showing at least a certain minimum number for each category. Additional blocks (up to the maximum) are shown in the order of the categories mentioned above.
* All of these settings can be individually configured per projector / console block. The highlighting only works, if the projector is actively projecting the grid (i.e. has power, is enabled...).
* Toolbar actions to toggle or enable/disable the highlighting for each category are also available, for example to set up a button panel for quick On and Off toggling.
* The custom info text is dynamically updated and can be used to get the status in real time (see "How to setup: LCD Status Report").
* Options to copy the grid directly into the projector, without creating a blueprint first. The first copies the grid as it is, the second copies it in a fully built state without deformations.
* Dedicated Server + Local Multiplayer support: Highlighting and block status checks are running client side only, so there is no impact on server performance. The highlighting is only visible for the player or the player's faction owning the projector block.

All colors and other visualization aspects can be freely configured directly via an ingame UI:
• Open the chat with Enter and press F1 to open the Rich HUD Master Terminal.

=> The configuration can be saved in the local mod folder and will be automatically loaded and applied in all savegames with this mod installed.

---

1. Load a blueprint of the same grid into the projector, either by using one of the copy buttons or by creating a blueprint (Ctrl + B) of the grid first.
   
2. Enable "Keep Projection".
   
3. Align the projection correctly.
   
4. Enable at least one of the "Show..." status categories.

=> If any real block deviates from the projected blueprint, it will be highlighted in the world.

1. Load any blueprint into the projector.
   
2. Offset and rotate the projection as desired.
   
3. Enable at least one of the "Show..." status categories.

=> If any real block deviates from the projected blueprint, it will be highlighted directly in the world. For manual building I would recommend turning off "show missing" and "show buildable" until you approach the final steps to finish the build.

1. Load a blueprint of the same grid into the Console Block, either by using one of the copy buttons or by creating a blueprint (Ctrl + B) of the grid first.
   
2. Enable at least one of the "Show..." status categories.

=> If any real block deviates from the projected blueprint, in will be highlighted in the hologram.
Note: The Console Block cannot differentiate between "buildable" and "missing" blocks. All buildable blocks are treated as missing.

1. Setup your projector, see "How to setup: Projector".
   
2. Add a programmable block running Automatic LCDs 2 script by MMaster to the grid.
   
3. Put the "[LCD]" keyword in the name of your LCD
   
4. Put the following in the custom data of the LCD:
   Details {<name of projector or console block>} {Projection Status}
   See the Automatic LCDs 2 guide for more information.

=> The LCD automatically tracks the status information with a slight delay, caused by the script.

---

I focused a lot on performance and optimization during development. Hence a lot of the data is cached and updated only when really necessary.

When enabling the projector or switching the blueprint, the necessary (relatively) heavy calculations are only done once. After that, only the status of each block is checked every second (60 ticks). The position of the highlights are only updated, if the grid is moving. The custom info text of the projector (control panel) is updated only when necessary.

The draw calls for the highlighting boxes provided by the game are quite GPU demanding, so set appropriate limits for the maximum number of simultaneously highlighted blocks (though up to 1000 should not be a problem).

This mod can be used alongside Projector Preview mod by Digi. But please note, that the "preview" mode of this mod uses a custom projection and you have to use the "build mode" for the highlighting of this mod to work. Also thanks to Digi for a few general code blocks.

---

• Configurable Parameters: https://sp.zhabite.com/sharedfiles/filedetails/?id=2422592854