Table of Contents

创建一个自定义传送门用于访问你的新维度

至此,你已经创建了一个新的维度,并为这个维度添加了群系、动物和一些看起来很棒的功能。

那生存玩家怎么访问这个新的维度呢?没错,创建一个传送门!

准备工作

Kyrptonaught 是一个非常有用的库,mod 开发者可以轻松的使用它来创建自定义传送门,作为连接新维度和主世界或其他的维度的桥梁。想了解这个库的更多信息,查看 Kyrptonaught 的 github 主页

首先,在项目的 build.gradle 文件中添加 Kyrptonaught 的仓库。

maven { 
    url = "https://maven.kyrptonaught.dev"
}

之后在 dependencies 依赖项中添加下面代码。

modImplementation 'net.kyrptonaught:customportalapi:<version>'
include 'net.kyrptonaught:customportalapi:<version>'

注意: Kyrptonaught 库可以正常运行的版本有1.16、1.18和1.19。你需要为你的mod选择合适的库版本。 (译者注:截止2023年12月12日,Kyrptonaught 库已经有1.20.2版本发布。)

注册传送门

注意: 这里的代码使用的是该文档创建编写时的语法,与较新版本可能有些许差别,但基本的函数功能是一致的。请在Kyrptonaught 库的github页面查看最新的代码示例。

我们使用 Kyrptonaught 库来创建一个可以用打火石激活的使用金块搭建的传送门。这个传送门的大小和普通传送门一样,可以达到23×23的最大规模。我们使用上面库提供的 CustomPortalApi 来创建该传送门,将下面代码添加到 ModInitializer1) 中。

;
 
CustomPortalBuilder.beginPortal()  
        .frameBlock(Blocks.GOLD_BLOCK)  
      //.lightWithItem(Items.ENDER_EYE)  //译者查阅相关github代码发现,此处传送门使用末影眼进行激活。将改行代码注释后使用打火石正常激活
      //.lightWithFluid(Fluids.WATER)
        .destDimID(new Identifier("my_mod_id", "my_dimension_id"))  
        .tintColor(234, 183, 8)  
        .registerPortal();

我们已经创建了如下传送门(该传送门可以在任何指定的维度工作!)

现在的传送门只能使用打火石进行激活。如果我们想创建一个使用末影之眼激活的传送门该怎么办?非常容易!只需要修改 lightWithItem 方法即可(译者注:通过查阅git文档,原英文档有明显笔误,正确描述为创建一个下界合金块框架的传送门,对着传送门使用末影之眼即可以激活前往末地)。

CustomPortalBuilder.beginPortal()  
        .frameBlock(Blocks.NETHERITE_BLOCK)  
        .lightWithItem(Items.ENDER_EYE)  
        .destDimID(new Identifier("the_end"))  
        .tintColor(45,65,101)  
        .registerPortal();

运行代码,我们现在拥有了一个看起来很棒的下界合金传送门。它使用下界合金块搭建,并使用末影之眼激活。

附加功能

该传送门 API 支持自定义传送门方块(译者注:该传送门方块应该为框架内部的粒子效果部分,而不是传送门框架),mod开发者可以创建自己的传送门纹理。目前它不支持创建水平方向的传送门框架,在将来可以会得到支持。

API 还支持通过触发事件调用代码激活传送门,而不是玩家激活。更多信息请点击这里

1)
不是服务端也不是客户端