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 1.1.0

Overview

1.1.0 is the first major usability update for Blueprint Executor. This release upgrades the mod from a basic blueprint placement prototype into a safer and more practical building tool.

The main focus of this version is planning, analysis, and rollback. Blueprints can now be inspected before placement, simulated without modifying the world, and reverted after execution.

Added

Blueprint analysis (蓝图分析)

• Added /blueprint info <file>

• Displays core blueprint metadata:

  • blueprint name
  • file name
  • version
  • placement count

Dry-run mode (空跑模式)

• Added /blueprint dryrun <file>

• Added /blueprint dryrun <file> <x> <y> <z> [rotation]

• Allows players to simulate a placement without changing the world

• Reports:

  • total planned block count
  • placement origin
  • rotation
  • bounding box (包围盒)
  • whether the blueprint contains air blocks

Undo support (撤销支持)

• Added /blueprint undo
• Reverts the most recent placement session
• Every placement now records the affected blocks before writing them into the world

Changed

Placement pipeline refactor (放置流程重构)

• Refactored blueprint placement from a direct-write model into a plan + apply model

• Placements are now processed in two stages:

  1. generate a PlacementPlan (放置规划)
  2. apply that plan to the world

This change is the foundation for:

• dry-run
• undo
• future preview support
• future overwrite analysis
• future UI integration

Command workflow improvements (命令工作流改进)

• /blueprint place now uses the planned placement pipeline internally
• Placement feedback is now more informative
• Placement sessions are tracked for rollback

Internal

New internal structures (新增内部结构)

Added new internal data models to support analysis and rollback:

• PlacementPlan
• PlannedBlock
• BlueprintAnalysis
• PlacementSession
• ChangedBlock
• UndoManager

Codebase improvements (代码结构改进)

• Separation between blueprint planning and world mutation is now much cleaner
• Improved reuse of placement logic for future command expansion
• Established a safer base for preview and session-based features

Notes

• Undo currently supports the most recent placement session
• Placement history is intentionally lightweight in this release
• This version focuses on command-side safety and tooling rather than GUI features

Commands added in 1.1.0

/blueprint info <file>
/blueprint dryrun <file>
/blueprint dryrun <file> <x> <y> <z> [rotation]
/blueprint undo

Recommended upgrade summary

If you were using earlier prototype builds, 1.1.0 is the recommended upgrade because it adds:

• safer placement workflow
• pre-placement inspection
• rollback capability
• cleaner internal architecture for future expansion

Нет описания изменений