v3.1.1

Release Notes

v3.0.0 (2026-02-07)

Major Architecture

• Added version.py as single source of truth for version/build/channel.
• Added app_settings.py and update_checker.py to centralize config and updates.
• Introduced modular mapping registry (mappings/) with validation:
  • duplicate targets
  • circular swaps
  • category registration and merge checks
• Refactored conversion engine to support multi-category conversion in a single pass.
• Preserved legacy armor constants and default behavior for CLI backward compatibility.

Mapping Expansion

• Added built-in categories:
  • armor (existing 70 pairs)
  • thrusters
  • weapons
  • functional
• Added profile loading system (mapping_profiles.py) and profiles/ auto-discovery.
• Shipped built-in mod profiles:
  • WeaponCore
  • Assertive Armaments
  • Build Vision

Analytics Dashboard

• Added block cost database: data/block_costs.json.
• Implemented analytics engine (blueprint_analytics.py):
  • component totals
  • ingot and ore back-calculation
  • PCU and mass totals
  • category distribution
  • conversion delta comparison
  • CSV/TXT report export
• Added blueprint health audit:
  • missing control/power checks
  • thruster balance warnings
  • unknown block subtype detection
  • fix actions for missing control/power blocks

UI Overhaul

• Fully migrated runtime UI to modular CustomTkinter app (ui/app.py).
• Replaced legacy monolithic gui_standalone.py with compatibility launcher.
• Added:
  • category toggles
  • animated progress ring
  • before/after diff preview
  • analytics visualization tab
  • profile editor dialog (create/edit/duplicate/import/export/share/test)
  • keyboard shortcuts (Ctrl+O, Ctrl+R, Ctrl+Z)
  • recent directories/blueprints
  • native Windows drag-and-drop blueprint loading
  • appearance mode selector (Light/Dark/System)
  • in-app changelog window
  • update notification checks

Distribution and Community

• Added CI workflow (.github/workflows/ci.yml) with lint, mypy, tests.
• Added release workflow (.github/workflows/release.yml) for tagged builds.
• Updated packaging scripts/spec to embed data/profiles and versioned executable names.
• Added icon/logo generation tooling (generate_icon.py, convert_icon.py) and app icon assets.
• Updated documentation: README.md, INSTALL.md, DEVELOPMENT_PLAN.md.
• Added community files:
  • CONTRIBUTING.md
  • CODE_OF_CONDUCT.md
  • issue templates for bug, feature, mapping request

Test Coverage

• Kept existing 19 compatibility tests passing.
• Added new tests for:
  • mapping registry
  • profile management
  • analytics engine/report export
  • update checker cache behavior

v2.0.0

• Expanded armor mappings to 70 pairs.
• Added dry-run preview and batch conversion.
• Added custom directory browsing and improved branding.