[HR][/HR]

What is ProgressStructure?

ProgressStructure is a plugin designed for survival, box, skyblock, event, and progression-based servers where players must complete requirements before a structure is automatically built, upgraded, or transformed.

The system lets you define regions, stages, material requirements, animations, triggers, actions, and visual effects so each structure can progress in a clean, controlled, and fully configurable way.

Players donate materials, the structure tracks progress, and once requirements are completed, the next stage can be animated automatically.

-------------------------------

Main Update Highlights

• Region Front Direction
  Regions can now have a configured front direction. This allows the plugin to understand which way a region is facing.
  
• Automatic Structure Rotation
  If your template structure was built facing a different direction, ProgressStructure can automatically rotate it so the template region and target region align properly.
  
• No More Manual WorldEdit Rotation
  You no longer need to manually rotate builds with WorldEdit just because the structure was created facing another axis.
  
• Per-Stage Destruction Toggle
  Each stage can now decide whether it should destroy existing blocks before building or skip destruction entirely.
  
• Build Only New Blocks
  When destruction is disabled, the animation only places blocks into empty spaces. This prevents weird display behavior when trying to place animated blocks into already occupied positions.
  
• New Sink and Rise Animation ⬇️⬆️
  The old structure can sink into the ground, then the new structure can rise from below. This creates much cleaner upgrade transitions.
  
• Configurable Delay Between Sink and Rise ⏱
  You can configure how long the plugin waits after the old structure sinks before the new one starts rising.
  
• Requirement Completion Delay ⌛
  You can configure a delay between completing all requirements and running the next action or animation flow.
  
• Requirement Completion Actions
  Run commands, titles, sounds, broadcasts, NPC actions, or other triggers when a stage has received all required materials.
  
• Configurable NPC Guide System
  The plugin can execute NPC-related actions when requirements are completed, animations start, stages change, or construction finishes.
  
• Add Requirements From Hand ✋
  A new command allows admins to add requirements directly from the item they are holding.
  
• Donation Block Holograms ✨
  You can now display live requirement progress above the donation block using Minecraft Display Entities / TextDisplay.
  
• Region Perimeter Preview Command
  Admins can now display the 3D outline of any configured region using particles.

-------------------------------

Region Fronts and Auto Rotation

You can now define which direction a region is facing:

Example:

This is useful when your target region and template region were built facing different directions.

If both regions have a front configured, the plugin can automatically rotate the template so it matches the target region.

Why this matters:
You can build more freely without worrying too much about the exact orientation. ProgressStructure handles the alignment during the build process.

-------------------------------

Stage Destruction Control

Each stage can now decide whether it should remove existing blocks before building.

Command:

Examples:

When set to false, the stage does not destroy existing blocks. It only builds into empty positions.

This is very useful for:

• Upgrades that only add new decorations
• Machines that expand over time
• Generators that gain extra parts
• Structures where the base should stay untouched
• Avoiding display entities clipping into existing blocks

-------------------------------

New Animation Flow

A new animation style was added where the current structure sinks down into the ground, then the next structure rises from below.

This makes transitions feel much more polished and cinematic.

Great for:

• Upgradeable altars
• Community builds
• Generators
• Machines
• Event structures
• Unlockable buildings
• Progressive dungeon rooms

You can also configure delays between animation phases, giving you more control over pacing and presentation.

-------------------------------

✅ Requirement Completion Flow

When all requirements for a stage are completed, you can now configure what happens before the build starts.

This can include:

• Broadcast messages
• Titles
• Sounds
• Console commands
• Player commands
• NPC actions
• Delayed actions
• Custom triggers

This makes it easier to create dramatic moments when players finish donating materials.

Example use cases:

• Announce that a community project is ready
• Play a sound before construction starts
• Move or update an NPC
• Start a countdown
• Trigger a custom server event

-------------------------------

NPC Guide System

The NPC guide system is not locked to one specific NPC plugin.

You can configure actions from config.yml and connect it with plugins such as:

• FancyNPCs
• Citizens
• Shopkeepers
• Hologram plugins
• Any plugin that can be controlled with commands

Available NPC-related events:

• Code (Text):

  requirements-complete
• Code (Text):

  animation-start
• Code (Text):

  stage-change
• Code (Text):

  animation-finish

This lets you create guide NPCs that react to the structure's progress.

-------------------------------

✋ Add Requirements From Hand

A new command was added to create requirements directly from the item in your hand.

Example:

This makes setup much faster, especially when working with custom items or items that already have metadata.

-------------------------------

Donation Block Holograms

You can now enable holograms above the donation block using Display Entities / TextDisplay.

The hologram shows each requirement from the current stage using this format:

Example:

Default line format:

These holograms update automatically when players donate materials.

-------------------------------

⚙️ Hologram Configuration

Donation holograms can be enabled globally from config.yml:

You can also override hologram settings per structure:

-------------------------------

Smart Hologram Facing

Holograms can automatically face the configured front of the target region.

If the target region has a front direction, the TextDisplay will face that direction.

You can also force a specific direction per structure:

This is useful when you want the donation progress display to always face the entrance, road, spawn area, or main player path.

-------------------------------

New Region Perimeter Command

A new command was added to display the 3D outline of a region using particles.

Example:

This is useful for:

• Checking if a region was selected correctly
• Debugging target/template region size
• Seeing the real build area in-game
• Helping staff configure structures faster
• Avoiding mistakes before adding stages

-------------------------------

✨ Region Perimeter Configuration

The command uses safe particle rendering and automatically adjusts spacing for large regions to avoid excessive particles.

-------------------------------

New Placeholders

New structure placeholders:

New requirement placeholders:

Short aliases are also available for actions:

These are especially useful for:

• Donation holograms
• Action bars
• Titles
• Broadcasts
• NPC dialogue
• Custom commands
• Stage completion actions

-------------------------------

New and Updated Commands

Set region front:

Show region perimeter:

Toggle stage destruction:

Add requirement from item in hand:

-------------------------------

New Permission

A new permission was added for the region perimeter preview command:

-------------------------------

Extra Improvements

• Donation holograms update automatically after donations.
• Donation holograms are cleaned up on plugin reload and shutdown.
• Per-structure hologram settings are preserved when structures.yml is saved.
• Tab-complete support was added for the new perimeter command.
• Messages were updated in English and Spanish.
• Region visualization is now easier for admins.
• Stage behavior is safer when building into existing structures.
• Animations are more configurable and cleaner for progressive upgrades.

-------------------------------

Summary

This update makes ProgressStructure much more flexible and visual.

You can now configure region front directions, automatically rotate templates, control destruction per stage, build only new blocks, use cinematic sink/rise animations, trigger actions when requirements are completed, connect NPC guide behavior, add requirements from your hand, show donation progress with Display Entity holograms, and preview region perimeters directly in-game.

This is a major step toward making progressive structures easier to configure, safer to animate, and much more immersive for players.