自定义尺寸 - 新手盒子

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

🌌 自定义维度：多元宇宙引擎

自定义维度 是一款完全服务端运行的 Fabric 模组，允许服务器管理员创建自定义维度、定义物理传送门框架，并通过持久的双向传送门连接各个世界。

玩家可以使用未修改的原版客户端加入——只有服务器需要安装该模组和 Fabric API。

🎮 支持的 Minecraft 版本

Minecraft 1.21 至 1.21.11
Minecraft 26.1 至 26.1.2
Minecraft 26.2

请使用与你的 Minecraft 版本匹配的 JAR 文件。所有版本均使用 Fabric Loader。

✨ 功能特性

🌍 创建自定义维度

直接从服务器创建虚空、主世界风格、下界风格或末地风格的维度。模组会写入数据包定义并立即创建维度文件夹。

创建后需要完全重启服务器，Minecraft 才能将新维度加载到实时世界注册表中。

🔄 持久的双向传送门

当玩家第一次进入已激活的传送门时，模组会：

查找或创建一个安全的传送目的地。
在必要时创建安全平台。
为两个物理传送门分配唯一的 UUID。
在出发地和目的地之间存储一个互惠链接。
使用这对精确的传送门进行返回旅行。

到达后，完全走出目的地传送门，等待配置的冷却时间结束，然后再次进入即可返回。冷却时间可以防止玩家在仍站在传送门内时在两个维度之间瞬间来回传送。

传送门对按世界保存，并在服务器重启后仍然有效。

🧱 灵活的物理框架

使用配置的框架方块构建一个空的垂直矩形框架。
默认允许的内部空间为 2×3 至 21×21 方块。
顶部、底部、左侧和右侧必须完整。
四个角块为可选。
在任意框架方块上使用配置的点火器。
框架可以面向 X 或 Z 方向。

一个传送门定义可以激活多个物理框架。每个激活的框架都会获得自己的 UUID 和对应的目的地传送门。

📐 坐标缩放

每个传送门定义支持从 0.001 到 1000.0 的坐标倍率。

1.0 保持坐标不变。
0.125 将主世界坐标转换为下界风格的 1:8 坐标。
8.0 执行反向转换。

生成的返回传送门会自动使用反比例缩放。

🌈 服务端粒子效果

激活的传送门内部充满彩色的原版粒子效果。粒子颜色来自 /portal link 命令提供的 RGB 值。

粒子密度、间隔和扩散范围均可配置。由于粒子由服务器发送，玩家无需安装客户端模组。

⌨️ 实时命令补全

TAB 补全包括：

已注册的方块 ID
已注册的物品 ID
服务器当前加载的每个维度
由原版、数据包、其他模组和自定义维度提供的维度

🛠️ 增强你的服务器配置！ 在 Fabric Server Essentials 查看我的其他服务端模组

🛠️ 命令

命令	描述
`/dimension create <名称> <void\|overworld\|nether\|end>`	创建维度定义及其文件夹
`/portal link <id> <框架方块> <点火物品> <目标维度> <RRGGBB> <光照等级> [缩放]`	创建或更新传送门定义
`/portal activate <id> <x> <y> <z>`	从控制台或命令行激活已完成的框架
`/portal list`	列出已保存的传送门定义
`/portal instances`	列出已激活的物理传送门及其关联的 UUID
`/portal delete <id>`	删除定义并停用其物理传送门

`/dimension create`

/dimension create <名称> <void|overworld|nether|end>

示例：

/dimension create pvp_arena void

这将创建 customdimensions:pvp_arena。在将其用作传送门目标之前，请重启服务器。

`/portal link`

/portal link <id> <框架方块> <点火物品> <目标维度> <RRGGBB> <光照等级> [缩放]

参数	含义	示例
`id`	唯一的定义名称	`arena_gate`
`框架方块`	带命名空间的框架方块 ID	`minecraft:obsidian`
`点火物品`	用于点火的带命名空间物品 ID	`minecraft:flint_and_steel`
`目标维度`	已加载的目的地维度	`customdimensions:pvp_arena`
`RRGGBB`	六位粒子颜色	`FF0000`
`光照等级`	保存的传送门光照值，0–15	`15`
`缩放`	可选坐标倍率；默认 `1.0`	`0.125`

示例：

/portal link arena_gate minecraft:obsidian minecraft:flint_and_steel customdimensions:pvp_arena FF0000 15 1.0

然后构建匹配的框架，并在任意框架方块上使用打火石。

如果多个定义使用相同的框架方块和点火物品，物理点火将选择字母顺序排在最前面的定义。当需要选择特定定义时，请使用 /portal activate。

⚙️ 服务器配置

模组生成：

config/custom_dimensions.json

默认配置：

{
  "schemaVersion": 1,
  "commandPermissionLevel": 4,
  "portalIgnitionPermissionLevel": 0,
  "particlesPerSample": 8,
  "particleIntervalTicks": 5,
  "particleSpread": 0.32,
  "frameDetectionRange": 21,
  "frameValidationIntervalTicks": 40,
  "portalCooldownTicks": 80,
  "destinationSearchRadius": 16
}

配置选项

设置	范围	用途
`schemaVersion`	`1`	配置格式版本；请勿更改
`commandPermissionLevel`	`0–4`	`/dimension` 和 `/portal` 命令所需的管理员等级
`portalIgnitionPermissionLevel`	`0–4`	物理点火框架所需的管理员等级
`particlesPerSample`	`1–32`	每个采样传送门格子发出的服务器粒子数量
`particleIntervalTicks`	`1–20`	粒子爆发之间的延迟；数值越小更新越频繁
`particleSpread`	`0.0–1.0`	每个采样位置周围的随机粒子扩散范围
`frameDetectionRange`	`3–32`	最大检测到的传送门内部宽度和高度
`frameValidationIntervalTicks`	`20–1200`	检查已激活框架是否有方块被破坏的频率
`portalCooldownTicks`	`0–600`	同一玩家再次传送前的延迟；20 刻 = 1 秒
`destinationSearchRadius`	`0–128`	用于查找或放置可复用目的地传送门的半径

权限等级 0 允许所有人。权限等级 4 要求服务器所有者或管理员等级 4。

编辑此文件后请重启服务器。无效的配置文件会被备份并替换为安全默认值。

💾 数据文件

文件	用途
`config/custom_dimensions.json`	服务器权限、粒子、框架检测、冷却时间和放置设置
`config/portal_links.json`	使用 `/portal link` 创建的传送门定义
`world/data/custom_dimensions_portals.json`	已激活的物理传送门 UUID 和互惠的出发地/目的地链接

请使用命令管理传送门定义。不建议在服务器运行时手动编辑 portal_links.json 或按世界保存的传送门实例文件。

🧪 示例

🔴 PvP 竞技场

/dimension create pvp_arena void

重启服务器，然后运行：

/portal link arena_gate minecraft:obsidian minecraft:flint_and_steel customdimensions:pvp_arena FF0000 15 1.0

🟢 使用下界风格缩放的世界

/dimension create resource_world overworld