StructureLib icon

StructureLib -----

Library to save and generate own Structures



StructureLib

Overview

Smart Structure Capture - Save any WorldEdit selection as optimized JSON
Natural World Generation - Structures spawn intelligently during world generation
Advanced Terrain Adaptation - Automatic ground leveling and tree removal
Comprehensive Configuration - Visual GUI for biome, height, and spawn settings
Perfect Rotation Support - 0°, 90°, 180°, 270°, or random rotation
Container Preservation - Maintains chest contents, furnace states, spawner data

Natural Spawning System
  • Metadata-Driven Generation - Configure biome restrictions, height ranges, and spawn conditions
  • Intelligent Terrain Analysis - Evaluates ground suitability before placement
  • Advanced Adaptation - Removes trees and levels terrain for seamless integration
  • Distance Controls - Prevents clustering with configurable minimum spacing
  • Environmental Awareness - Avoids water, lava, and unsuitable terrain

Code (Text):

# Save your structure
//pos1
//pos2
/struct save medieval_village

# Configure natural spawning
/struct edit medieval_village
# Use GUI to set biomes, height range, spawn chance

# Enable natural generation
/struct enable-spawning medieval_village

# Structures now spawn naturally in new chunks!
 

⚡ Performance & Optimization

Feature Benefit
Intelligent Compression File size reduction
Multi-Phase Placement Zero lag for 1M+ block structures
Connection Processing Perfect glass panes, fences, iron bars
Optimized Storage Fill regions, hollow detection, patterns


Commands & Features

Core Commands:
  • /struct save <id> - Save WorldEdit selection with auto-metadata
  • /struct place <id> [rotation] - Place structure with optional rotation
  • /struct info <id> - Display structure information and metadata
  • /struct edit <id> - Open interactive metadata configuration GUI
  • /struct list [tag] [dimension] - Browse structures with filters
  • /struct enable-spawning <id> - Quick enable natural spawning

Advanced Features:
  • Comprehensive Metadata GUI - Visual biome, height, and condition editor
  • Tag & Category System - Organize structures with custom labels
  • Loot Table Integration - Native Minecraft loot system support
  • Developer API - Full programmatic access for custom plugins

Requirements

  • Minecraft: 1.21.8+
  • Server: Spigot/Paper
  • Java: 21+
  • Dependencies: WorldEdit

Quick Start

1. Installation
  • Download StructureLib from the resources page
  • Place in your server's plugins/ folder
  • Ensure WorldEdit is installed
  • Restart your server

2. Basic Usage
Code (Text):

# Select area with WorldEdit
//pos1
//pos2

# Save structure
/struct save my_house

# Place structure
/struct place my_house
/struct place my_house 90     # with rotation
/struct place my_house random # random rotation
 
3. Natural Spawning Setup
Code (Text):

# Configure spawning via GUI
/struct edit my_house

# Enable natural generation
/struct enable-spawning my_house
 

Development Status

Stable Features:
  • Core structure save/load system
  • Rotation and placement engine
  • Block entity preservation
  • Connecting block support

Alpha Features (Functional but Requires Testing):
  • Natural spawning system
  • Terrain adaptation algorithms
  • Metadata configuration GUI
  • Advanced biome filtering

Note: Core features are production-ready. Natural generation features should be tested in development environments before production use.

Links & Support


Developer API

Code (Text):

// Access the API
StructureAPI api = ((StructureLib) Bukkit.getPluginManager()
    .getPlugin("StructureLib")).getStructureAPI();

// Load and place structure
Structure structure = api.loadStructure(new File("structures/house.json"));
api.placeStructure(structure, location);

// Configure natural spawning
StructureMetadata metadata = structure.getMetadata();
metadata.setNaturalSpawning(true);
metadata.setSpawnChance(0.05f);
metadata.getAllowedBiomes().add("FOREST");

// Register for natural generation
MetadataBasedSpawner spawner = plugin.getNaturalSpawner();
spawner.registerStructure(structureId, metadata);
 


Compatible with Minecraft 1.21.8+ • Requires WorldEdit • Java 21+
Resource Information
Author:
----------
Total Downloads: 27
First Release: Aug 3, 2025
Last Update: Aug 3, 2025
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings