本篇教程由作者设定使用 CC BY-NC 协议。

在ccpacrcompact-common.toml文件中编辑传送门。

1.配置传送门的参数

    在"Dimension Configs" = [[...],[...],[...],...]中编辑传送门的信息。

    "Dimension Configs"中每一个传送门的信息应当是一个列表[...],该列表中应当包含三个列表:[传送门配置],[激活传送门配置],[传送门颜色]。后两个列表可以为空,即 '[]',但是必须存在。这些列表中所有参数必须为String,即必须用英文双引号括起来,如"minecraft:end","8.0","243"。

    a.传送门配置

    [传送门配置]=[modid:DimAID, modid:DimBID, modid:FrameBlockID, diffPara]共四个参数,包含了传送门联通的两个维度的ID(modid:DimAID, modid:DimBID),传送门框架所用的方块ID(modid:FrameBlockID),以及维度之间传送的坐标差别(diffPara)。

    其中diffPara参数是可选的且必须能转换为数字(Double),否则默认为1.0。DimA(X, Z) * diffPara =  DimB(X, Z)。若diffPara<0.00001,则DimA->DimB时为DimA(X, Z) =DimB(X, Z),DimB->DimA时为DimA(X, Z) = (0, ~, 0).

    所选的传送门框架的方块(modid:FrameBlockID)必须存在,否则无法配置。

    b.传送门激活方式配置

    [激活传送门配置] = [LightType, modid:ItemOrOtherID]。

    LightType必须为以下四个"Fire","Item","Water","Fluid", "Custom",分别对应使用点火激活(类似地狱门),物品在传送门框架方块上右键使用激活,放水激活(类似天境的传送门),放某液体激活,放置某方块激活。如果为空或者不是以上任意一种则默认为"Fire"。

    当LightType为"Item","Fluid"或"Custom"时modid:ItemOrOtherID必须填写且必须存在,否则默认为"Fire"。

    c.传送门颜色配置

    [传送门颜色] = [R, G, B]通过三个参数定义传送门的RGB颜色,任意一个参数为空则默认为127。

2.其他的配置参数

    "Vanilla CPA teleport",默认为false。不需要用双引号括起来。如果设置为true,则使用Custom Portal API 自带的传送方法。使用这个方法会使得diffPara这个参数无效。它将根据世界类型在彼此之间传送。比如:在从末地传送回主世界的时候之间传送到世界出生点,而不是对应坐标的传送门。

    "Vanilla CPA Portal",默认为false。如果设置为true,则使用Custom Portal API 自带的寻找传送门并创建链接的方法。Custom Portal API会创建一个HashMap存储两个传送门之间的链接,每次进入存档都会读取这个HashMap。Custom Portal API会从这个HashMap中寻找另一边维度的传送门。但是,这个链接一旦建立,就无法消除,即使这两个传送门都被破坏了(也即是说,只有你建立的传送门足够多,这个HashMap就长长长长长长长长长)。如果设置为false,那么游戏会在另一个维度的对应坐标周围动态地寻找合适地传送门。如果"Vanilla CPA teleport"被设置为true,则该项设置无效。