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
an hour ago
2.0
13
Logistic network Circuit network Storage Blueprints

Changelog

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