SchemFlow 0.5.12 - Major Feature Update

🚀 Major New Features

Local Schematics Support

• Offline Mode: Work with schematics even when S3/MinIO is unavailable
• New Commands:
  • /schemflow paste local:name - Use locally fetched schematics
  • /schemflow local - List all local schematics
  • /schemflow local delete <name> --confirm - Delete local files safely
• Seamless Integration: Local schematics appear in tab completion with local: prefix

Dedicated Update Command

• Safer Overwrites: New /schemflow update <schematic> --confirm command
• Explicit Confirmation: Mandatory --confirm flag prevents accidental overwrites
• Replaces: Old /schemflow upload -update --confirm pattern for better UX

Lightning-Fast Tab Completion

• Performance Boost: Eliminated live S3 calls during tab completion
• Instant Response: Now uses cached data for immediate completion
• Network Savings: Reduced S3 API calls by 90%+ during command usage

✨ User Experience Improvements

Simplified Command Structure

• Removed: Complex -local flag system
• Added: Intuitive local:name prefix for local schematics
• Cleaner: More logical command organization and help text

Consistent Group Display

• Fixed: List command now shows group names exactly as configured
• No More Confusion: "Default:" vs "default:" inconsistency resolved
• Accurate: Display matches actual storage structure

Complete Tab Completion

• Server Schematics: Proper group:name format for non-default groups
• Local Schematics: Clear local:name format for offline files
• Default Group: No prefix for default group schematics (as intended)
• All Options: Default group now appears in -group argument completion

🔧 Technical Improvements

Cache System Overhaul

• Unified Logic: All 3 cache population methods now consistent
• No Duplicates: Fixed duplicate entries in tab completion
• Proper Grouping: Default vs non-default groups handled correctly
• Extension Handling: Consistent .schem/.schematic processing

Performance Optimizations

• Smart Caching: Tab completion uses cached data instead of live API calls
• Reduced Latency: Especially beneficial for high-latency S3 connections
• Memory Efficient: Optimized cache data structures
• Background Refresh: Automatic cache updates preserve performance

📖 Updated Commands

New Commands

...

⚙️ Configuration

Fully Functional Settings

• cacheRefreshSeconds: Automatic cache refresh interval (default: 60s)
• storage.defaultGroup: Respected throughout the plugin (default: "default")
• downloadDir: Local schematic storage location (default: "plugins/SchemFlow/schematics")

Backwards Compatibility

• All existing commands continue to work
• Configuration format unchanged
• Existing schematics accessible with old and new syntax

---

Full Changelog: https://github.com/c4g7-dev/SchemFlow/blob/main/CHANGELOG.md
Documentation: https://github.com/c4g7-dev/SchemFlow/wiki
Download: https://github.com/c4g7-dev/SchemFlow/releases/tag/v0.5.12

0.5.11 (and hotfixes 0.5.11-1 / 0.5.11-2)

Added

• Group lifecycle commands:
  • group delete <name> [--confirm] (preview schematic count before destructive action)
  • group rename <old> <new>
  • Safer create with duplicate name detection
• Trash & restore workflow:
  • delete [group:]name now soft-deletes to S3 .trash
  • restore <name> [-group <dest>] to bring items back (optionally to a different group)
  • trash lists trashed schematics
  • trash clear --confirm permanently purges (guarded by confirmation)
• Undo / Redo support for SchemFlow delete operations (/SchemFlow undo / redo) with fallback to WorldEdit history for pastes
• Group-prefixed tab completion (group:name) and inclusion of group-prefixed names in cache
• Confirmation previews for destructive operations (group delete, trash clear) showing item counts
• Ephemeral paste cache directory (plugins/SchemFlow/work/cache/) auto-purged on enable/reload/disable

Improved

• Listing (/SchemFlow list) now groups schematics by group with total counts
• Clearer feedback & error messages across command suite
• Consistent MiniMessage styling for all command outputs
• Cache refresh logic aggregates both plain and group-prefixed forms for faster tab completion

Fixed

• Duplicate group creation now returns a friendly warning instead of silently reusing
• Ensured biomes flag handling defaults to included unless disabled
• Hotfix 0.5.11-2: removed dependency on a missing method for ephemeral cache path in some environments (build compatibility)

Internal

• Safer async wrapping for storage operations
• Reduced transient file retention (auto-clean ephemeral paste artifacts)
• Updated documentation (README + wiki) to match new command set & workflows

Notes

• Only /SchemFlow fetch writes persistent schematic files; paste uses ephemeral cache
• Use --confirm for irreversible operations (group delete, trash clear)
• WorldEdit OR FAWE required (not both)

Upgrade Guidance No config changes required. Existing schematics remain valid. You may safely update the jar and use new group management + trash features immediately.

SchemFlow v0.5.10-5 — Hotfix

• Fixed: plugin.yml YAML indentation under commands causing “Invalid plugin.yml” on load
• No functional changes beyond the fix

Compatibility:

• Minecraft 1.21+, Java 21+, Paper/Purpur

SchemFlow v0.5.10 — Flat Trash, Restore, and Trash Management

A small but handy quality-of-life update focused on safer deletes and easier recovery.

What’s New

• Changed: Flat trash directory at <rootDir>/.trash (no per‑group subfolders)
• Added: /SchemFlow trash lists trashed schematics
• Added: /SchemFlow trash clear --confirm permanently purges all trashed items
• Changed: restore now restores from the flat trash; -group <dest> optionally targets destination group

Commands

• /SchemFlow restore <name> [-group <dest>] — restore from trash (defaults to storage.defaultGroup)
• /SchemFlow trash — list trashed schematics
• /SchemFlow trash clear --confirm — permanently clear trash (confirmation required)

Permissions

• schemflow.restore — restore schematic from trash (default: op)
• schemflow.trash.clear — permanently clear trash (default: op)

Compatibility

• Minecraft: 1.21+
• Java: 21+
• Server: Paper/Purpur
• Dependency: WorldEdit 7.2.18+ OR FAWE (install one)
• Optional: Skript 2.7+

Notes

• Delete now moves to trash for safer recovery.
• Path-based fetch and group:name syntax introduced in recent versions remain supported.

v0.5.9 — Undo/Redo, path fetch, and Skript upgrades

Highlights

• Undo/Redo support:
  • undo and redo for last paste/delete
  • Deletes are now reversible (moved to S3 trash)
• Path-based fetch:
  • /SchemFlow fetch /path/to/name(.schm) under storage.rootDir
  • Tab-complete folders and .schm files under root
• Skript upgrades:
  • paste/fetch accept group:name
  • schemflow groups expression
  • create schemflow group "<name>"
  • trash schemflow schematic "<name>" [in group "<group>"]
  • restore schemflow schematic "<name>" [in group "<group>"]

Changes

• Name rules: : and / are prohibited in schematic and group names
• fetch no longer uses -group; use group:name or /:path/...
• README and wiki updated (commands, Groups section, Skript API)

Compatibility

• Existing setups remain compatible; new features are additive
• Storage path for trash: <rootDir>/.trash/SF_<group>/<name>.schm

Upgrade Notes

• Use group:name syntax or absolute root path with fetch
• Consider using undo after delete or paste to revert quickly