Create Bugfix: Schematic Patch

This mod has been discontinued and will no longer receive updates or support. Please visit https://modrinth.com/mod/createschematicchecker to find a similar mod.

Overview

This mod fixes a critical schematic item exploit in the Create mod for Minecraft 1.21+. Please note: when using the mod for the first time on your server (mod_version ≥1.1), execute the command /schematic-config reload to initialize the mod configuration.

Original Issue

Create's schematics could store blocks/items with illegal components, allowing players to obtain unobtainable survival items.

Fix Features

• Anomaly Detection: Scans uploaded schematics in real-time
• Data Sanitization: Automatically removes illegal components/blacklisted blocks
• Alert Logging: Outputs server warning when player uploaded anomaly schematic
• Auto-Archiving: Backups anomalous schematics at:/schematics/anomaly/playername/schematic.nbt

For mod_version<1.1.3

• Configurable: Blacklist management via schematicsfix-common.toml
• Advanced Configuration Feature: You can define the schematic NBT detection logic using JSON in schematicsfix.jsonl. However, please note that this feature is still experimental. Unless you know what you are doing, do not modify the default advanced configuration.

For mod_version≥1.1.3

• Configurable:Define NBT filter rules freely through schematicsfix.yaml

Admin Benefits

1. Real-time exploit blocking
2. Automatic evidence preservation
3. Customizable filter rules
4. Zero manual review for legitimate uploads

Configuration File Format (mod_version≥1.1.3)

Configuration File Location: config/schematicsfix.yaml

Basic Structure:

version: "1.0"
rules:
  - name: "rule_name"
    target_path: "target_path"
    conditions:
      - condition_list
    cleanup_actions:
      - cleanup_action_list

Rule Fields:

• name: Unique identifier for the rule, used for logging and command display
• target_path: Target path to search for in NBT data, supports wildcards
• conditions: List of conditions that must all be satisfied to trigger cleanup
• cleanup_actions: List of cleanup actions to execute when conditions are met

Path Syntax:

• Normal path: Use dots to separate, e.g., "blocks.nbt.id"
• Wildcard: Use [* ] to match all array elements
  Example: "blocks[* ].nbt" matches nbt fields in all blocks arrays
  Example: "messages[* ]" matches all elements in messages array
• Specific index: Use [number] to match specific array index
  Example: "messages[0]" matches the first element in messages array

Condition Types:

   field_equals - Field value equals
   type: "field_equals"
   path: "field_path"
   value: expected_value

   field_not_equals - Field value not equals
   type: "field_not_equals" 
   path: "field_path"
   value: expected_value

   field_exists - Field exists
   type: "field_exists"
   path: "field_path"

   string_contains - String contains
   type: "string_contains"
   path: "field_path"
   value: "string_to_find"

Cleanup Action Types:

   conditional_remove - Conditional removal
   type: "conditional_remove"
   target_path: "target_field_path"
   condition: removal_condition (optional)
   remove_strategy: "field_only" (only removes field value)

   path_remove - Path removal  
   type: "path_remove"
   target_path: "target_path"
   remove_strategy: "entire_object" (removes entire object)

   nested_string_remove - Nested string cleanup
   type: "nested_string_remove"
   target_path: "target_path"
   condition: trigger_condition (optional)
   remove_pattern: "regex_pattern"
   remove_strategy: "regex_replace"

Complete Examples:

Example 1: Clean specific fields of valve handles
Rule name: valve_handle_capacity_cleanup
Target path: blocks[* ].nbt
Condition: id field equals "create:valve_handle"
Action1: If Network.Capacity not equals 256.0, remove this field
Action2: If Speed not equals 32.0, remove this field

Example 2: Clean container data from clipboards
Rule name: clipboard_container_cleanup
Target path: blocks[* ].nbt
Condition: id field equals "create:clipboard"
Action: Remove Item.components.minecraft:container path

Example 3: Clean click events from signs
Rule name: sign_clickevent_cleanup
Target path: blocks[* ].nbt
Condition: id field equals "minecraft:sign"
Action: Search for strings containing "clickEvent" in front_text.messages[*],
use regex to remove clickEvent objects

Configuration Example Code:

version: "1.0"
rules:
  - name: "valve_handle_capacity_cleanup"
    target_path: "blocks[*].nbt"
    conditions:
      - type: "field_equals"
        path: "id"
        value: "create:valve_handle"
    cleanup_actions:
      - type: "conditional_remove"
        target_path: "Network.Capacity"
        condition:
          type: "field_not_equals"
          path: "Network.Capacity"
          value: 256.0
        remove_strategy: "field_only"
      - type: "conditional_remove"
        target_path: "Speed"
        condition:
          type: "field_not_equals"
          path: "Speed"
          value: 32.0
        remove_strategy: "field_only"

  - name: "clipboard_container_cleanup"
    target_path: "blocks[*].nbt"
    conditions:
      - type: "field_equals"
        path: "id"
        value: "create:clipboard"
    cleanup_actions:
      - type: "path_remove"
        target_path: "Item.components.minecraft:container"
        remove_strategy: "entire_object"

  - name: "sign_clickevent_cleanup"
    target_path: "blocks[*].nbt"
    conditions:
      - type: "field_equals"
        path: "id"
        value: "minecraft:sign"
    cleanup_actions:
      - type: "nested_string_remove"
        target_path: "front_text.messages[*]"
        condition:
          type: "string_contains"
          value: "clickEvent"
        remove_pattern: "\"clickEvent\":\\s*\\{[^}]*\\}"
        remove_strategy: "regex_replace"

Important Notes:

1. Use /schematic-config reload to reload configuration after changes
2. Use /schematic-config rules to view loaded rules
3. Use /schematic-config status to check mod status
4. All operations are removal operations only, no replacement functionality
5. Regular expressions use Java standard syntax
6. Make sure YAML file uses proper indentation (spaces, not tabs)