IgnitePaste - Animated Schematic Builds v1.4.0

IgnitePaste - Changelog
▌ Version 1.4.0 - Construction Animation
Watch your builds rise block-by-block with a worker crew, exact-duration pacing, a progress boss bar and CustomModelData everywhere​

🏗 Construction Animation

• Schematics can now build themselves block-by-block over a configurable duration instead of pasting instantly.
• Enable globally with construction.default-duration-seconds, or per schematic with the construction-duration sidecar field. A sidecar value of 0 forces instant paste even when a global default is set.
• Blocks place bottom-up with three layer-fill orders: CENTER (spiral outward), EDGE (outer ring inward) and RANDOM.
• Scaffold particles spark at each placed block, an impact particle fires from the block being struck, and a hammer sound loops at the build centre.

Worker NPCs

• A configurable crew spawns at the build site and physically places every block - claim nearest block, walk to it, swing, place, repeat. No invisible timer.
• No resource pack and no Citizens dependency.
• Workers default to a ZOMBIE dressed in tinted leather (yellow hard hat, orange hi-vis vest) holding a pickaxe, so they read as construction workers rather than mobs.
• Never burn in daylight, can't be pushed, hurt or pick up items, and despawn when the build finishes or is cancelled.
• Entity type, worker count, armour pieces + colours, held item, walk speed and swing cadence are all configurable. Avoid VILLAGER - its model can't swing a tool or hold one in-hand.

⏱ Exact-Duration Pacing

• A closed-loop controller re-tunes the crew twice a second from live progress vs. elapsed time, so the build lands on exactly the configured duration.
• Small schematics build at a relaxed pace; huge ones speed the crew up and place small clusters per swing to stay on schedule.

Build Progress Boss Bar

• Optional boss bar showing schematic name, percentage and estimated time remaining (<name>, <progress>, <remaining>).
• Colour, overlay style and update interval configurable under construction.boss-bar.

Speed-Up & Rollback

• /ignitepaste speedup lets a player pay currency to shorten the remaining build time; the controller paces the crew faster to match. Cost + multiplier configurable globally or per schematic via speed-up-cost.
• Rollback on cancel - leaving paste mode mid-build restores every placed block and refunds the cost. Toggle with construction.rollback-on-cancel.

CustomModelData Everywhere

• Hotbar tools, GUI navigation buttons, the schematic entry icon, folder + locked-entry icons, the voucher item, and the worker's tool + each armour slot all accept a custom-model-data value.
• A schematic sidecar can override its GUI icon model per-schematic with its own custom-model-data field.

Fixes

• Directional blocks (doors, stairs, levers, signs, ...) now rotate correctly in the animated and async paste paths - previously only positions rotated while facing/axis stayed put.
• Vouchers can now be redeemed by right-clicking in the air, not only against a block.

IgnitePaste - Changelog
▌ Version 1.3.0 - Schematic Shop Engine
Vault, vouchers, material cost, MySQL, PlotSquared/Towny, refund window and a stats command​

Vault Economy Integration

• Per-schematic cost field in the sidecar .yml is now charged on a successful paste.
• New economy.confirm-purchases toggle shows a Confirm / Cancel GUI before every paid paste - no more accidental coin spend.
• Staff with ignitepaste.economy.free always paste for free regardless of cost.
• Economy hooks are fully opt-in and silently disabled when Vault is missing.

Refund Window

• New economy.refund-window-seconds field. If the player undoes the paste within the window, the money is refunded automatically.
• Eliminates the most common support ticket: "I clicked the wrong schematic, give me my coins back."
• Defaults to 30 seconds. Set to 0 to disable.

Material Cost (Items)

• New sidecar cost-items field - players pay with real items instead of money. Two modes:
  • Explicit list - list specific materials and amounts (e.g. STONE:64, IRON_INGOT:8).
  • FULL_SCHEMATIC - automatically requires every block the schematic will place. The plugin walks the clipboard and tallies the materials for you.
• The paste flow refuses if the player is short on any material and tells them exactly which item and how many they need.
• On a successful paste the items are consumed from the player's inventory.

🎟 Schematic Voucher Items

• New command /paste voucher give <player> <schematic> [amount] - issues a tagged paper item bound to a schematic.
• Right-clicking the voucher starts one-time paste mode preselected for that schematic. One voucher is consumed per use.
• Vouchers waive the money cost and the material cost (the voucher itself is the payment).
• Fully sellable via CMI / ChestShop / EconomyShopGUI, giftable between players, droppable into crates and kits.
• Display name, lore and material are configurable in the new vouchers section of config.yml.

🗄 MySQL & SQLite Storage

• New storage.backend key in config.yml - YAML (default), SQLITE or MYSQL.
• Cooldowns, per-player use counts and aggregate stats live in the chosen backend.
• SQLite spins up automatically inside the plugin folder; MySQL uses HikariCP connection pooling.
• JDBC drivers are pulled at runtime via Paper's library loader - no manual jar drops.
• Cross-server progress for networks running BungeeCord or Velocity.

🏘 PlotSquared + Towny Integration

• Auto-detected soft integrations. When the corresponding plugin is missing the check is a no-op.
• PlotSquared - the paste bounding box is sampled and every corner / centre must land inside a plot the player belongs to.
• Towny - every sample must land in unclaimed land, on a town block owned by the player, or inside their own town.
• New bypass permissions: ignitepaste.plot.bypass, ignitepaste.towny.bypass.

Stats Command

• New command /paste stats <schematic> - admin-only.
• Returns total pastes, total revenue (formatted via Vault), the player with the most pastes for that schematic, and the timestamp of the last paste.
• Stats are persisted in the same backend as cooldowns and survive restarts and backend switches.

Purchase Confirmation GUI

• Brand new confirmation dialog. Before any paid paste the player sees a small chest GUI with:
  • The schematic name and folder
  • The money cost (formatted via Vault)
  • Every material the paste will consume (one line per material)
  • A green Confirm button and a red Cancel button
• Cancelling, closing the inventory or timing out simply forgets the pending paste - nothing is charged.
• Toggle via economy.confirm-purchases (defaults to true). Vouchers always skip the prompt.

Cooldown Enforcement

• The cooldown-seconds sidecar field is now actively enforced (was previously read but not applied on every paste path).
• Players who retry early see the exact remaining seconds.
• Cooldowns persist across restarts in the configured storage backend (YAML, SQLite or MySQL).

Max Uses Per Player

• New max-uses-per-player sidecar field caps the lifetime number of pastes per player per schematic.
• Default 0 = unlimited.
• Perfect for one-per-account plot houses, starter islands and progression rewards.

🖥 GUI Cost & Cooldown Display

• The schematic selector now injects economy and cooldown data into each entry's lore.
• Four new placeholders in gui.entry.lore: <cost>, <cooldown>, <remaining>, <uses_left>.
• Players always see what a schematic costs and how long they must wait before clicking.

Admin Paste Log

• Opt-in paste-log.enabled writes a timestamped line to logs/paste.log for every successful paste.
• Records player name, UUID, schematic name and paste location (world + coordinates).
• Log file path is configurable via paste-log.file.

PlaceholderAPI Support

• %ignitepaste_in_mode% - true / false
• %ignitepaste_selected% - selected schematic name, or none
• %ignitepaste_cooldown_<name>% - remaining cooldown in seconds, or 0
• %ignitepaste_uses_<name>% - total times this player pasted the schematic
• Silently disabled when PlaceholderAPI is not installed.

New Permissions

• ignitepaste.economy.free - paste any schematic for free regardless of cost.
• ignitepaste.cooldown.bypass - skip cooldowns and per-player use limits.
• ignitepaste.plot.bypass - skip the PlotSquared ownership check.
• ignitepaste.towny.bypass - skip the Towny residency check.

⚙ New Config Sections

• economy - enabled flag, refund-on-fail, free-permission, confirm-purchases, refund-window-seconds.
• cooldown - enabled flag, bypass-permission.
• storage - backend (YAML / SQLITE / MYSQL), sqlite-file, MySQL connection settings, pool size.
• vouchers - enabled flag, voucher material, MiniMessage display name, lore.
• integrations - PlotSquared and Towny enabled flags + bypass permissions.
• paste-log - enabled flag, log file path.
• placeholders - enabled flag for PAPI expansion registration.

Full Config: https://hst.sh/uxacuconed.yaml

New Commands

• /paste voucher give <player> <schematic> [amount] - issue voucher items.
• /paste stats <schematic> - print aggregate stats for a schematic.

IgnitePaste 1.2.0
Less lag, better organisation, more control
​

Main Changes

• Async Chunked Paste - huge schematics are pasted over multiple ticks to prevent server freezing and keep TPS stable (Fix for WE, Fawe was fine).
• Folder Tree Selector - the GUI now supports subfolders instead of one massive flat schematic list.
• Sidecar Metadata - add a <name>.yml next to a schematic to customise display name, lore, permissions and allowed worlds.
• Permission-Gated Schematics - every schematic now has its own permission node with optional locked/hidden behaviour.
• WorldGuard Region Guard - optional WorldGuard support prevents pasting inside protected regions.

Other Improvements

• Undo is disabled during async pastes to avoid broken restores
• Cleaner error messages for denied pastes
• MiniMessage support for schematic display names
• New <folder> placeholder in GUI titles

Update now and try the new async paste system.
​

IgnitePaste 1.1.0
One time paste mode​

Added a new console-only one-time paste mode using:

/ignitepaste onetime <player> <schematic>

This mode loads a preselected schematic directly onto the target player's hotbar, with only the required tools available:

• Transform tools
• Preview toggle
• Anchor lock
• Paste tool
• Close tool

The schematic selector and undo tools are hidden to keep the workflow simple, focused, and safe.

After a successful paste, the mode automatically closes and restores the player's inventory. A dedicated close item is also available, allowing the player to exit without placing the schematic.

Good Use Cases

• Crate / island / arena placement - give staff a ready schematic to position and paste without browsing menus.
• Reward structures - automatically start a placement flow after a player unlocks or buys a building.
• Event setup - quickly place prepared event objects, decorations, portals, arenas, or temporary builds.
• Store / command integration - a purchase or command can launch placement for exactly one schematic.