Blueprint Reader Combinator


Reads ALL blueprints from chest and outputs item signals with quality. Updates on combinator enable/disable. Zero UPS cost when idle!

Content
12 days ago
2.0
68
Logistic network Circuit network Storage Blueprints

Changelog

Version: 2.7.2
Date: 28. 02. 2025
  Bugfixes:
    - Fixed crash when reading blueprints containing machines with modules (entity.items format handling for Factorio 2.0)
Version: 2.7.1
Date: 28. 02. 2025
  Bugfixes:
    - Fixed entity sprite scale — now matches vanilla constant-combinator size (scale 0.28)
    - Fixed sprite direction mapping — default placement (north) now correctly shows front view
    - Fixed shadow opacity — shadows were nearly invisible (alpha 44/255), now properly visible
    - Fixed shadow shape and direction — generated programmatically from entity silhouettes, extends to the right matching vanilla shadow style
    - Added custom circuit_wire_connection_points for all 4 directions — wire attach points now match visual connector positions on each rotation
Version: 2.7.0
Date: 28. 02. 2025
  Features:
    - Custom original graphics — unique entity sprites, item icon, technology icon and thumbnail
    - Module counting — pre-inserted modules inside blueprint machines are now included in output signals
  Optimizations:
    - Settings values (count-tiles) are now cached and updated via on_runtime_mod_setting_changed instead of read every tick
    - Quality list is cached after first access (reset on configuration change)
    - on_nth_tick cleanup now targets only own handler instead of clearing all nth_tick registrations
    - Safe table iteration — invalid entries collected first, removed after loop completes
    - Simplified process_blueprint_reader — single set_combinator_signals call instead of duplicate branches
  Bugfixes:
    - Removed unused elevated-rails optional dependency
    - Renamed internal variable from tinted_icons to item_icons (no longer uses tinting)
  Changes:
    - Replaced all base game constant-combinator graphics with custom artwork
    - Entity sprites use proper spritesheet (512x128) with separate shadow layer
    - Technology icon shows device alongside its crafting recipe components
    - Updated FAQ and README to reflect custom graphics and module counting
Version: 2.6.0
Date: 15. 02. 2025
  Features:
    - Tile counting: blueprints now include concrete, refined concrete, stone brick, landfill and other tiles in output signals
    - Nested blueprint book support: recursively reads active blueprints from books-within-books
    - Auto-update setting: optionally re-read blueprints on a configurable timer (0 = disabled by default)
    - New mod setting: toggle tile counting on/off
    - Linked containers now supported as blueprint source
  Optimizations:
    - Added C++ entity event filters — build/destroy handlers only fire for our combinator, not every entity in the game
    - All functions converted from global to local scope for faster Lua lookups
    - Entity-to-item name resolution is now cached (major speedup for large blueprints)
    - Combinator section management optimized: reuses existing section instead of destroy+recreate cycle
    - Leftover signal slots are properly cleared on update
  Bugfixes:
    - Quality settings button no longer appears on regular constant combinators (only on Blueprint Reader)
    - Fixed missing migration: existing combinators are now re-registered on mod update/configuration change
    - Invalid entity references are cleaned up automatically
    - Removed unused storage.player_data
  Changes:
    - Removed redundant icon/icon_size fields where icons array was already defined
    - Simplified sprite tinting code
    - Settings changes (auto-update interval) apply immediately without game restart
Version: 2.5.0
Date: 13. 02. 2025
  Features:
    - Quality Settings button now only appears when Space Age DLC is active
    - Cleaner interface for vanilla Factorio 2.0 users
  Changes:
    - Added optional dependency on quality mod (Space Age)
    - Mod works fully in vanilla without quality features
  Info:
    - Without Space Age: Simple blueprint reader with basic functionality
    - With Space Age: Full quality override support
Version: 2.4.4
Date: 13. 02. 2025
  Bugfixes:
    - Fixed crash when using quality override without Space Age DLC
    - Quality dropdown now only shows qualities available in current game
    - Fallback to normal quality if selected quality is not available
  Info:
    - Works correctly in vanilla Factorio 2.0 without DLC
    - Higher quality tiers require Space Age DLC
Version: 2.4.3
Date: 13. 02. 2025
  Changes:
    - Quality settings window no longer captures focus
    - Combinator GUI stays open while quality window is displayed
    - Close quality window with Apply or Cancel buttons
Version: 2.4.2
Date: 13. 02. 2025
  Bugfixes:
    - Fixed quality settings button closing combinator GUI
    - Quality settings window now properly opens when button is clicked
    - Combinator GUI reopens after applying or canceling quality settings
Version: 2.4.1
Date: 13. 02. 2025
  Changes:
    - Quality settings button now appears in the combinator's standard GUI
    - Click "Quality Settings" button in right panel to open quality override menu
  Info:
    - Open combinator → Click "Quality Settings" button → Select quality → Apply
Version: 2.4.0
Date: 13. 02. 2025
  Features:
    - Added custom GUI for quality override selection
    - Quality setting now per-combinator instead of global
    - Click on combinator to open quality selection GUI
  Changes:
    - Removed mod settings for quality - now uses custom GUI
    - Quality override saved separately for each combinator
  Info:
    - Click combinator to open GUI with quality dropdown
    - Select quality and click Apply to update signals
    - Setting saved per-combinator, not per-player
Version: 2.3.1
Date: 13. 02. 2025
  Bugfixes:
    - Added debug logging for quality override setting
    - Fixed setting order for better visibility
Version: 2.3.0
Date: 13. 02. 2025
  Features:
    - Added Quality Override setting - force all blueprint items to a specific quality
    - New mod setting: choose from Keep Original, Normal, Uncommon, Rare, Epic, or Legendary
    - Per-player setting - each player can have their own quality preference
  Info:
    - Access via Settings → Mod Settings → Per Player → Quality Override
    - "Keep Original" preserves blueprint quality (default behavior)
    - Other options override ALL items to the selected quality level
    - Perfect for upgrading existing blueprints to higher quality tiers
Version: 2.2.1
Date: 13. 02. 2025
  Info:
    - Version bump for mod portal compatibility
Version: 2.2.0
Date: 12. 02. 2025
  Features:
    - Reads ALL blueprints from chest and sums their items together
    - Manual update mode - updates only when you close combinator GUI
    - Full support for all 5 quality levels (Normal, Uncommon, Rare, Epic, Legendary)
    - Zero UPS cost when idle - no background processing
  Changes:
    - Removed automatic checking every 60 ticks
    - Updates only on user action (closing combinator GUI)
    - Simplified code - removed hash checking and continuous polling
  Info:
    - Open combinator GUI and close it to update signals
    - Combinator checks enabled state when GUI closes
    - If disabled, signals are cleared
Version: 2.1.0
Date: 12. 02. 2025
  Features:
    - Added full quality support for all blueprint entities
    - Separate signals for each quality tier
  Changes:
    - Items with different qualities are now counted separately
    - Updated signal output to include quality information
Version: 2.0.1
Date: 12. 02. 2025
  Bugfixes:
    - Fixed incorrect signal format causing "non-trivial item filter condition" error
    - Corrected set_slot() parameters for constant combinator compatibility
Version: 2.0.0
Date: 12. 02. 2025
  Major Features:
    - Complete rewrite - now outputs circuit signals instead of setting logistic requests
    - Works like standard constant combinator
    - Signals visible in combinator GUI
  Changes:
    - Changed from direct logistic manipulation to signal output
    - Simplified architecture and improved reliability
    - Now compatible with any circuit-network-enabled entity
  Info:
    - Breaking change - requires setup change for existing users
    - Configure requester chests to "Use signals from circuit network"
Version: 1.0.9
Date: 12. 02. 2025
  Bugfixes:
    - Fixed attempt to create new logistic sections
    - Now uses existing first section of logistic chest
Version: 1.0.0
Date: 12. 02. 2025
  Major Features:
    - Initial release
    - Reads blueprints from chest
    - Outputs item counts to circuit network
    - Blueprint book support
    - Quality support