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.

Blueprint Executor