StructureAPI: Easy Schematic Placement on Minecraft Servers

Mastering Structure Placement with StructureAPI If you have ever managed a Minecraft server, you know how tedious it can be to manually build large structures or share custom builds with players. StructureAPI, part of the SettlerCraft suite, changes that entirely. It gives server admins a powerfu...

Download SettlerCraft StructureAPI for Minecraft 1.8

Original name: SettlerCraft StructureAPI

Minecraft: 1.8

FileVersionLoaderSize
SettlerCraft-StructureAPI-2.0.0.zip1.8—287 КБDownload
SettlerCraft-StructureAPI-2.1.0.zip1.8—306 КБDownload
StructureAPI-Bukkit-2.2.0.jar1.8—417 КБDownload
structureapi-bukkit-2.3.0.jar1.8—418 КБDownload

Mastering Structure Placement with StructureAPI

If you have ever managed a Minecraft server, you know how tedious it can be to manually build large structures or share custom builds with players. StructureAPI, part of the SettlerCraft suite, changes that entirely. It gives server admins a powerful yet simple system to load schematics, present them in an intuitive menu, and let players place entire buildings, monuments, or complex redstone contraptions with just a few clicks. Whether you run a survival, creative, or minigame server, this plugin streamlines construction and adds a whole new layer of gameplay.

What Exactly Is StructureAPI?

At its core, StructureAPI is a Bukkit/Spigot plugin that provides a convenient way to load and place schematics. Players can pick these schematics—also referred to as plans—from a menu and place them in the world. The plugin handles everything from rotation and overlapping prevention to cost integration and construction rollback. It is built on top of SettlerCraft-Core and works hand in hand with WorldEdit to process the actual block placement. Instead of typing long commands, your community gets a visual, menu-driven experience.

Key Features That Make Building Effortless

StructureAPI packs a rich set of tools that cater to both admins and players. Here are the standout capabilities:

  • Schematic to Plan Generation: Convert any .schematic file into a plan that the plugin can understand. Just drop the schematic into the generate folder, run a command, and it becomes ready for the menu.
  • Fancy Menu System: All plans appear in a user-friendly menu. Players can browse, preview, and select structures without memorizing commands.
  • Vault Economy Integration: Set prices for plans, allowing players to buy structures using in-game currency. This works seamlessly with any Vault-compatible economy plugin.
  • Build, Continue, and Demolish: Players can start a new construction, resume an unfinished one, or completely demolish a structure. Since version 2.2.0, rollback functionality lets you undo a placement if something goes wrong.
  • Collision Prevention: Structures will never overlap accidentally. The plugin checks boundaries before placement, and you can even configure whether substructures (structures inside other structures) are allowed.
  • Rotation Commands: Schematics must be aligned east with the front facing west. Use /stt rotate [structureid] [degrees] to permanently rotate a schematic to the desired orientation.

Managing these features becomes even smoother when you use a modern launcher. For server owners who want to bundle plugins and client mods effortlessly, the foxygame.net launcher offers a streamlined way to install and update everything right from its menu, saving you from manual file juggling.

Quick Start: Getting Your First Structure into the Game

Setting up StructureAPI is straightforward, but following the steps carefully avoids common pitfalls. Here is a quick guide:

  1. Download schematics from any schematic sharing website (files with the .schematic extension).
  2. Place the downloaded schematics inside the plugins/SettlerCraft-StructureAPI/generate folder on your server.
  3. Start the server or execute stt generate plans in the console. This creates the necessary XML configuration files.
  4. Move the generated XML and the schematic files together into plugins/SettlerCraft-StructureAPI/plans.
  5. Restart or reload the server. The plans now appear in the menu, accessible via /stt menu or /stt shop.

Always ensure your schematics are in a neutral position—aligned east, front facing west—unless orientation does not matter for your design. The rotation command can help you fix any misalignment permanently.

Commands and Permissions at a Glance

StructureAPI 2.2.x introduces a clean command set. The primary commands include /stt menu to open the plan selection, /stt shop for the purchase interface, /stt rotate to adjust schematic orientation, and administrative commands for plan management. For a full list, refer to the GitHub commands page (plain text reference: github.com/chingo247/StructureAPI). Permissions follow a similar structure, allowing you to control who can generate plans, place structures, or bypass costs. Always check the permissions documentation to fine-tune your server’s experience.

Dependencies and Optional Hooks

To function correctly, StructureAPI requires several core dependencies:

  • SettlerCraft-Core: Provides the underlying database (Neo4j) and core functionality.
  • SettlerCraft-MenuAPI: The menu library that powers the visual interface.
  • WorldEdit 6.1: Handles block manipulation.
  • AsyncWorldEdit and AsyncWorldEditInjector: Required for version 2.2.x to avoid lag during large placements.

Optional hooks expand the plugin’s capabilities significantly. StructureAPI-WorldGuard adds region protection, StructureAPI-HolographicDisplays shows floating holograms for structures, and StructureAPI-Towny integrates with the Towny plugin so mayors can place structures in the wilderness while preventing builds across unowned plots. Vault 1.5.x is needed if you want economy-based plan purchases. LiteLoader client plugins like WorldEditCUI can also enhance the visual feedback for players.

Upgrading from Older Versions: A Critical Warning

If you are upgrading from StructureAPI 2.0.0 or 2.1.0, pay close attention. The update modifies the database in a way that makes downgrading impossible. Before you proceed, create full backups of your SettlerCraft-Core directory. There is no way back once the upgrade completes. The plugin’s author emphasizes this repeatedly—losing data because of a skipped backup is a preventable disaster. After backing up, follow the standard installation steps and restart the server. The new features, including rollback and substructure configuration, are well worth the careful preparation.

Why StructureAPI Belongs on Your Server

StructureAPI turns the often clunky process of schematic placement into a polished, player-friendly feature. It reduces admin workload, encourages community building projects, and can even become a core part of your economy if you charge for plans. The menu-driven approach makes it accessible to players who might be intimidated by WorldEdit commands. With ongoing development and a clear roadmap—manual construction, WorldGuard default flags, and more—the plugin is set to become even more versatile.

Whether you are creating a spawn hub, a quest-driven adventure map, or a towny survival world, StructureAPI gives you the tools to place structures effortlessly. The combination of robust collision checks, rollback safety, and optional hooks makes it a reliable choice for servers of any scale. Dive into the quick start, experiment with a few schematics, and watch your world transform one placed plan at a time.