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
Spoiler: Configuration Example
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
Spoiler: Installation & Setup
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
Spoiler: API Example
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+