This mod provides functional for RTS multiblock structures. It also can be used as a structure copy/paste

In-game functions

• Save structures
• Paste structures

To save structure you need structure tool - use /give or operator tab;

Right click - position 1;

Left click - position 2;

Shift + right click - anchor position

CTRL + mouse click - expand area (can be changed in keybinds)

Shift + left click - placement anchor

---

/rtstrucutres save <name> - saves structure

/rtstrucutres load <name> <anchor> - loads structure

/rtstrucutres execute - pastes structure in world

/rtstrucutres always_display_boxes - alway display tool selection area

/rtstrucutres debug - example of library use (requires saved structure named "house")

---

Mod-Developer functions

Installation Guide

Currently mod does not have maven so you should add mod file directly to your workspace gradle directory

dependencies {
    implementation fg.deobf("net.awyvrix:structure-framework:0.1.0")
}

Mod Guide

Here is the example of /debug command

ServerLevel level = ctx.getSource().getLevel();
String filename = "house";

Path worldDir = level.getServer().getWorldPath(LevelResource.ROOT);
StructureTemplate template = StructureCache.get(worldDir, filename);

BlockPos anchorPos = StructureToolState.placeAnchor; // Place position
PlacementAnchor anchorMode = PlacementAnchor.CUSTOM; // Recommended to use custom anchor
StructureInstance instance = new StructureInstance(level, template, anchorPos, anchorMode);

StructureManager.add(instance);
instance.build(BuildType.FAST, 2.0f); // Execute in the world; Layer-by layer building

StructureInstance class provides more methods for structure management;

---

Basic Usage

Saving Structure

StructureTemplate template = StructureCapture.capture(level, pos1, pos2, customAnchor);
Path path = worldDir.resolve("generated/rtstructures/house.rtstructure");

StructureSerializer.save(template, path);

Loading Structure

Path path = worldDir.resolve("generated/rtstructures/house.rtstructure");

StructureTemplate template = StructureDeserializer.load(path);

Instant Placement

StructurePlacer.place(
        level,
        targetPos,
        template,
        PlacementAnchor.CENTER
);

Register Structure

StructureManager.add(instance);

Start Building

instance.build(BuildType.FAST,10);

• BuildType = construction logic
• speed = blocks per tick

---

Validation System

Check Damage

boolean damaged = instance.isDamaged();

Completion Percent

float percent = instance.getCompletionPercent();

Damage Percent

float percent = instance.getDamagePercent();

Full Validation Result

ValidationResult result = instance.validate();

---

Build Modes

FAST

Instant layered building

• fast
• unrestricted
• replaces blocks

Best for:

• debugging
• cinematic building
• RTS instant construction

FAST_SAFE

Layered building without replacing existing blocks

• preserves world
• safer placement
• slower completion

Best for:

• survival gameplay
• protected worlds

CONNECT

Builds only connected blocks

• realistic propagation
• support-dependent
• may stall if disconnected

Best for:

• RTS simulation
• organic building systems

SEPARATED

Growth-style construction from anchor

• spreading build effect
• directional expansion
• organic appearance

Best for:

• alien structures
• plant-like construction
• visual effects

---

More can be found on github wiki