PowerfulJS

模组

· 作者 Amygdaloideae

Forge 能力系统的 KubeJS 集成,包括 Curios、Botania、FE 和流体处理。

0 本站下载 0 关注 更新于 1 年前

最新 PowerfulJS-2.4.0.jar · 1.21.1 · NeoForge

一键开服(送7天)

PowerfulJS

基于 1.20.1 重写,PowerfulJS 现在确实更强大!

PowerfulJS 1.21 现在对 capabilities(能力)的处理更好,完全支持 ProbeJS,并且性能大幅提升!

如需查看旧版 PowerfulJS 文档,请访问 GitHub 仓库

能力系统简介

NeoForge 的 capability(能力)机制统一了物品、方块、实体等的实现方式,以处理共同的行为。因此,任何实现了 item handler(物品处理器)能力的方块都能接收或向漏斗提供物品;任何实现了 fluid handler(流体处理器)能力的物品都能被 Mekanism 流体罐填充。

PowerfulJS 使得整合包制作者能够向这些对象添加能力。通过附加能力,你可以让熔炉拥有 FE 或流体存储功能,或者让电池外壳在填充后成为电池……可能性是无限的。

快速使用

本节介绍如何使用 PowerfulJS 实现一些简单的功能。代码在安装了 PowerfulJS 的情况下即可运行,但建议安装 ProbeJS,以便在 VSCode 中获得 IDE 支持。

1. 添加能力

能力可以附加到三种类型的对象上:item(物品)、block(方块)和 entity(实体)。还有一种第四类型是 block entity(方块实体),但它包含在 block 能力中。

能力注册在游戏启动时触发,一个简单的添加能力的示例如下:

PowerfulEvents.registerCapabilities(event => {
    // 添加一个具有恒定 FE 供应的能力
    //
    // 这样红石块现在可以持续产生 100FE/t,
    // 但是你需要一个提取器(例如带有提取模式的 MEK 线缆)
    // 才能获取能量,因为方块本身不会向周围分发能量
event.registerBlock('powerfuljs:constant_energy', {
    maxExtract: 100,
    maxReceive: 0,
}, "redstone_block")


// 添加一个具有固定容量并定义最大 I/O 的罐体
event.registerBlockEntity('powerfuljs:fixed_storage_fluid', {
    capacity: 2000,
    maxExtract: 250,
    maxReceive: 250,
}, 'minecraft:furnace')


// 同样适用于 FE 能量存储
event.registerBlockEntity('powerfuljs:fixed_storage_fe', {
    maxExtract: 1000,
    maxReceive: 1000,
    capacity: 10000,
}, 'minecraft:furnace')


// 添加一个具有恒定流体供应的流体能力
//
// 只需连接管道并提取无限的岩浆!
// 过于强大了!!!!!
event.registerBlock('powerfuljs:constant_fluid', {
    content: Fluid.of('lava', 1000),
    maxReceive: 0
}, 'minecraft:lava')
    // ...所以你可以通过使其仅在特定条件下可用来限制它,
    // 比如这里我们检查它是否是源方块且处于“nether”生物群系中,即 nether_waste。
    //
    // 然而,如果方块在工作时会改变状态,你不应该依赖这个验证器,比如熔炉
    // 出于性能原因,该能力将为许多机器重用,并且由于能力已提供,
    // `validate` 将不会被调用
    .validate((blockContext, info) => {
        return blockContext.state().fluidState.source &&
            blockContext.level().getBiome(blockContext.pos())
                .registeredName
                .includes("nether")
    })


// 还使 `netherrack`(下界岩)和 `soul sand`(灵魂沙)能够被岩浆填充
//
// 填充后,它们会变成 `magma block`(岩浆块)
//
// 不同的能力构建器之间存在一些差异,
// 你可以使用 ProbeJS 找出每个构建器支持哪些内容
event.registerItem('powerfuljs:fixed_storage_fluid', {
    capacity: 1000,
    maxReceive: 20,
    maxExtract: 20,
    validator: "minecraft:lava",
    changeItemWhen: {
        full: [
            { fluid: "minecraft:lava", item: "minecraft:magma_block" }
        ]
    }
}, 'netherrack', 'soul_sand')

})

2. 拦截 Tick

为了让附加在方块上的能力更有用,PowerfulJS 还实现了一种方法来拦截方块的原始 Tick 逻辑,以及强制不 Tick 的方块进行 Tick。

一个名为 RuleSet(规则集)的系统用于定义平衡性能与灵活性的实际逻辑。理论上讲,使用此系统实现的任何逻辑都具有与原生 Java 相当的性能,尽管这在很大程度上取决于你的实现方式。

Tick 拦截是在服务器脚本加载时注册的,因此你也可以重新加载服务器脚本来刷新行为。然而,对于任何已经注入了逻辑的方块,你需要破坏并替换它们以刷新 Tick 器。

示例如下所示:

PowerfulEvents.interceptTicking(event => {
    let burningFurnaceOfAnyDirection = [
        "minecraft:furnace[lit=true, facing=west]",
        "minecraft:furnace[lit=true, facing=east]",
        "minecraft:furnace[lit=true, facing=north]",
        "minecraft:furnace[lit=true, facing=south]"
    ]

event.intercept('minecraft:furnace', () => [ // 我们检测熔炉是否正在运行 Rules.matchBlock(burningFurnaceOfAnyDirection) // 如果熔炉未运行,则启用它 // 以便它能正常检测配方 .negate() // 如果熔炉正在运行 .or( // 如果熔炉中有 1000mB 的岩浆,则保持其运行状态 Rules.hasFluid(Fluid.lava(1000), null) // 同时消耗 1 mB 的岩浆并产生 5 FE .effect(Effects.drainFluid(Fluid.lava(1), null)) .effect(Effects.fillEnergy(5, null)) ) // 因此,如果熔炉未运行,或者熔炉在流体支持下正在运行, // 我们启用熔炉逻辑( // 前面的规则评估为 true),否则禁用它(评估为 false) .effect(Effects.toggleEnable()) ]) // 上述逻辑将使熔炉至少需要 1000mB 的岩浆才能运行, // 并以每秒消耗 1mB 岩浆为代价,每秒产生 5FE

// 箱子本身不会进行刻更新,我们通过空逻辑强制箱子开始刻更新,
// 这样我们稍后可以通过拦截添加自己的逻辑
event.forceTicker('chest', true)
event.intercept('chest', () => [
    // 每 20 刻执行一次
    Rules.every(20).effect(
        // 奖励一个曲奇!
        Effects.insertItem('cookie', null)
    )
])

})

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源