RTStrucures Framework

模组

· 作者 Awyvrix

一个专注于即时战略(RTS)结构机制的库

0 本站下载 0 关注 更新于 5 个月前

最新 0.1.5 · 1.21.1 · NeoForge

一键开服(送7天)

此模组为即时战略(RTS)风格的多方块结构提供了功能支持。它也可用作结构的复制/粘贴工具。

游戏内功能

  • 保存结构
  • 粘贴结构

要保存结构,你需要使用结构工具——通过 /give 命令或操作符标签页获取;

右键点击 - 设置位置 1;

左键点击 - 设置位置 2;

Shift + 右键点击 - 设置锚点位置

CTRL + 鼠标点击 - 扩展区域(可在按键绑定中更改)

Shift + 左键点击 - 放置锚点


/rtstrucutres save <name> - 保存结构

/rtstrucutres load <name> <anchor> - 预加载结构并显示粘贴框

/rtstrucutres execute <build_type> - 将预加载的结构粘贴到世界中

/rtstrucutres execload <name> <anchor> <build_type> - 将结构粘贴到世界中

/rtstrucutres toggle_boxes <true/false> - 始终显示工具选择区域


模组开发者功能

安装指南

repositories {
    maven {
        url = "https://api.modrinth.com/maven"
    }
}

dependencies {
    implementation "maven.modrinth:rtstrucures-framework:0.1.4"
}

模组指南

以下是 /execload 命令的示例

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; // 放置位置
PlacementAnchor anchorMode = PlacementAnchor.CUSTOM; // 建议使用自定义锚点
StructureInstance instance = new StructureInstance(level, template, anchorPos, anchorMode);

StructureManager.add(instance);
instance.build(BuildType.FAST, 2.0f); // 在世界中执行;分层构建

StructureInstance 类提供了更多用于管理结构的方法;


基本用法

保存结构

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

StructureSerializer.save(template, path);

加载结构

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

StructureTemplate template = StructureDeserializer.load(path);

注册结构

StructureManager.add(instance);

开始建造

instance.build(BuildType.FAST,10);
  • BuildType = 建造逻辑
  • speed = 每刻建造的方块数

验证系统

检查损坏

boolean damaged = instance.isDamaged();

完成百分比

float percent = instance.getCompletionPercent();

损坏百分比

float percent = instance.getDamagePercent();

完整验证结果

ValidationResult result = instance.validate();

建造模式

警告!如果结构无法完成建造,它将无限期地持续 ticking(运行)。请注意这一点(最大步骤数量将在下一个版本中添加)

FAST

即时分层建造

  • 快速
  • 无限制
  • 替换方块

最佳用途:

  • 调试
  • 电影式建造
  • RTS 即时建造

FAST_SAFE

不替换现有方块的分层建造

  • 保留世界状态
  • 更安全的放置
  • 完成速度较慢

最佳用途:

  • 生存模式游戏
  • 受保护的世界

CONNECT

仅建造相连的方块

  • 真实的传播效果
  • 依赖支撑结构
  • 若断开连接可能会停滞

最佳用途:

  • RTS 模拟
  • 有机建造系统

SEPARATED

从锚点开始的生长式建造

  • 扩散式建造效果
  • 方向性扩展
  • 有机外观

最佳用途:

  • 外星结构
  • 植物状建造
  • 视觉效果

SEPARATED_DIAGONAL

与 SEPARATED 类似,但角落方块也用作锚点

DEMOLISH

自顶向下拆除结构


高级用法 (0.1.4+)

注册结构

模组提供了 DefferedRegistered 结构注册方式

public final class StructuresInit {
    private StructuresInit() {}

    public static final DeferredRegister<StructureType> STRUCTURES =
            DeferredRegister.create(RTSRegistries.STRUCTURES, RTStructureFramework.MOD_ID);


    public static final Supplier<StructureType> SIMPLE_HOUSE = STRUCTURES.register("simple_house", SimpleHouseStructure::new);
    public static final Supplier<StructureType> AIRFIELD = STRUCTURES.register("airfield", AirfieldStructure::new);
    public static final Supplier<StructureType> CRYSTAL = STRUCTURES.register("crystal", CrystalStructure::new);
    public static final Supplier<StructureType> PROTECTED_STRUCTURE = STRUCTURES.register("protected_structure", ProtectedStructure::new);


    public static void register(IEventBus bus) {
        STRUCTURES.register(bus);
    }
}

结构类

public class SimpleHouseStructure extends StructureType {

    public SimpleHouseStructure() {
        super("simple_house", StructureProperties.create()
                // 结构文件
                .modPath("basic/simple_house", RTStructureFramework.MOD_ID) // 在你的 resources/data/mod_id/... 下

                // 默认放置方式
                .defaultAnchor(PlacementAnchor.CENTER)

                // 默认建造行为
                .defaultBuildType(BuildType.FAST)
                .defaultBuildSpeed(2f)

                // 验证阈值
                .damagedThreshold(0.15f)
                .destroyedThreshold(0.5f)
        );
    }
}

库提供了一些管理方法

    public void onCompleted(StructureInstance instance) {}

    public void onDamaged(StructureInstance instance) {}

    public void onDestroyed(StructureInstance instance) {}

    public void onDemolished(StructureInstance instance) {}

使用示例:

public class AirfieldStructure extends StructureType {
    private int productionTick;

```java
public AirfieldStructure() {
        super("airfield", StructureProperties.create()
                .modPath("basic/airfield", RTStructureFramework.MOD_ID)
                .defaultAnchor(PlacementAnchor.CENTER)
                .defaultBuildType(BuildType.FAST)

                .defaultBuildSpeed(3f)
                .damagedThreshold(0.2f)
                .destroyedThreshold(0.6f)
        );
    }

    @Override
    public void onCompleted(StructureInstance instance) {
        System.out.println("[RTS] Airfield completed");
    }

    @Override
    public void onTick(StructureInstance instance) {
        if (!instance.isCompleted()) return;

        productionTick++;
        if (productionTick >= 100) {
            productionTick = 0;

            System.out.println("[RTS] Kirov reporting...");
            // Do your stuff. E.g spawn unit
        }
    }

    @Override
    public void onDestroyed(StructureInstance instance) {
        System.out.println("[RTS] Airfield destroyed!");
    }
}

生成结构

    StructureInstance instance = StructuresInit.AIRFIELD.get().create(level, anchorPos);
    StructureManager.add(instance);
    
    instance.build();

警告!

StructureManager.add(instance); 实际上会创建你的结构;

instance.build(); 仅构建你的结构;

如果需要移除你的结构,请使用 instance.destroy();(警告! 如果滥用可能会调用栈溢出。切勿将其放入 tick 方法中)

使用示例:

public class CrystalStructure extends StructureType {

    public CrystalStructure() {
        super("crystal", StructureProperties.create()
                .modPath("crystal", RTStructureFramework.MOD_ID)
                .defaultBuildType(BuildType.FAST)
                .defaultBuildSpeed(1f)
                .defaultAnchor(PlacementAnchor.CUSTOM)

                .damagedThreshold(0.05f)
                .destroyedThreshold(0.8f)
        );
    }

    @Override
    public void onTick(StructureInstance instance) {
        if (instance.isDamaged()) {
            if (!instance.isBuilding()) {
                instance.build(BuildType.FAST, 0.5f);
            }
        }
    }

    @Override
    public void onDestroyed(StructureInstance instance) {
        if (instance.getDamagePercent() >= 0.95f) {
            instance.destroy();
        }
    }

    @Override
    public void onCompleted(StructureInstance instance) {
        System.out.println(instance.debugInfo());
    }
}

此描述将被整理为标准的模组说明文档。如需查阅文档,请访问 github wiki。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源