Blueprint Executor 1.2.0

Overview

1.2.0 is a safety-focused release for Blueprint Executor.

This version expands the mod’s pre-placement analysis from simple overwrite counts into a more meaningful risk classification system, and introduces configurable placement blocking for dangerous operations.

The overall goal of this release is to make blueprint placement safer by default:

• detect what kind of blocks may be overwritten
• classify placement risk into multiple tiers
• warn users more clearly
• optionally block dangerous placements before they happen

---

Added

Risk tier analysis (风险等级分析)

• Added multi-tier placement risk analysis

• Replaced the old “replace count only” model with risk classification based on the type of block being overwritten

• New risk tiers:

  • LOW
  • MEDIUM
  • HIGH
  • CRITICAL

Risk score summary (风险评分汇总)

• Added a weighted placement risk score

• Different block categories now contribute different amounts to the final score

• Dry-run and preview now report:

  • low-risk replacements
  • medium-risk replacements
  • high-risk replacements
  • critical-risk replacements
  • total risk score
  • highest detected risk tier

Configurable safety policy (可配置安全策略)

• Added safety.json configuration support
• Safety policy is stored in:

config/blueprintexecutor/safety.json

• Default options include:

  • blockHighRiskPlacement
  • blockCriticalRiskPlacement
  • warnHighRiskPlacement
  • warnCriticalRiskPlacement

Safety commands (安全策略命令)

Added:

/blueprint safety
/blueprint safety reload

These commands allow users to inspect and reload the active safety configuration without restarting the game.

---

Changed

Dry-run risk output improvements (空跑风险输出改进)

• /blueprint dryrun now reports detailed risk summaries in addition to placement impact data

• Dry-run can now distinguish between replacing:

  • ordinary building blocks
  • functional blocks
  • storage blocks
  • special or highly sensitive blocks

Preview risk output improvements (预览风险输出改进)

• /blueprint preview now includes the same risk summary as dry-run
• Preview is now more useful as a true “decision point” before placement

Placement warnings (放置警告改进)

• /blueprint place now issues explicit warnings when a placement includes HIGH or CRITICAL risk targets
• Warnings are configurable through the safety policy

Placement blocking (放置阻止机制)

• Placement can now be blocked by safety policy before execution

• By default:

  • HIGH risk placements are warned
  • CRITICAL risk placements are blocked

This means placements that would overwrite especially sensitive targets can now be stopped before any world changes are made.

---

Internal

New risk analysis structures (新增风险分析结构)

Added new internal components for safety evaluation:

• RiskTier
• PlacementRiskSummary
• PlacementRiskAnalyzer

These structures allow the mod to reason about placement danger in a more realistic way than simple overwrite counts.

New safety configuration system (新增安全配置系统)

Added:

• SafetyConfig
• SafetyConfigManager

This creates a stable foundation for future safety features such as:

• force placement
• confirmation workflows
• custom server-side placement policies

---

Default safety behavior

The default safety.json generated by this release behaves like this:

{
  "blockHighRiskPlacement": false,
  "blockCriticalRiskPlacement": true,
  "warnHighRiskPlacement": true,
  "warnCriticalRiskPlacement": true
}

This means:

• HIGH risk placements are allowed, but warned
• CRITICAL risk placements are warned and blocked

---

Risk model notes

The current risk model evaluates only blocks that would actually be replaced:

• air targets are ignored
• same-state targets are ignored
• only real replacements are classified

The first implementation uses a practical category-based model:

• normal building blocks are usually LOW
• interactive or directional blocks are often MEDIUM
• storage, automation, and redstone-related blocks are often HIGH
• especially sensitive or special-purpose blocks are CRITICAL

---

Commands added in 1.2.0

/blueprint safety
/blueprint safety reload

---

Commands improved in 1.2.0

/blueprint dryrun <file>
/blueprint dryrun <file> <x> <y> <z> [rotation]
/blueprint preview <file>
/blueprint preview <file> <x> <y> <z> [rotation]
/blueprint place <file>
/blueprint place <file> <x> <y> <z> [rotation]

---

Recommended upgrade summary

1.3.0 is recommended because it turns Blueprint Executor into a significantly safer building tool.

This release adds:

• risk-aware dry-run analysis
• risk-aware preview output
• configurable safety policy
• automatic blocking for dangerous placement cases

The result is a workflow that is much less likely to accidentally overwrite valuable or sensitive blocks.