Beyond Dimensions
Beyond Dimensions 是一款专注于存储与实用性的模组。它引入了一个“维度网络”——一种多功能的存储系统,支持物品、流体、FE 能量、经验值、Mekanism 的化学物质、Ars Nouveau 的源质、Botania 的魔力以及 Industrial Foregoing:Souls。它将卓越的存储容量和性能与用户友好的界面相结合,能够轻松满足大多数场景下的存储需求。
入门指南
你需要击败凋灵,或通过其他方式获得下界之星。将其合成为不稳定时空碎片。将该碎片保留在背包中一小时,它会转化为稳定时空碎片。使用它来合成维度网络发电机并激活它以创建你的维度网络。然后,只需按下热键(默认为'O')即可打开存储界面。
存储系统
- 容量: 默认存储容量为最大值。它可以存储 21 亿种不同的物品或资源类型,每种类型可容纳 $2^{63}-1$ 个单位(Java
long 的最大值)。最大存储类型数、每种类型的容量以及扩展存储的方法均可通过 KubeJS 进行自定义。
- 性能: 存储系统经过了大量优化。性能测试显示,无论是连接 AE2 还是仅使用本模组,结果都表现出色。具体测试结果请参阅 性能测试 部分。
- 多人游戏: 存储系统使用玩家权限绑定网络。单个网络可以与多个玩家共享。或者,也可以通过物品形式的终端来实现共享。
UI 界面
直观的存储界面: 本模组提供了一个界面,其交互逻辑与 AE2 和 RS 等流行存储模组保持一致。
- 内置合成网格。
- 多种搜索模式:直接文本输入搜索名称、工具提示 或 模组 ID。前缀加上
# 以严格匹配工具提示。前缀加上 @ 以严格匹配模组 ID。
- 可自定义显示的物品行数。
- 多种排序选项:按存储时间、按数量、按名称、按模组 ID 排序。
通用槽位系统: 该模组 GUI 中的任何槽位都可以存储所有支持的资源类型,并支持快速交互机制。
快捷容器操作: 手持相应的容器时右键点击槽位,可以快速将容器中的资源存入/取出。例如:手持潜影盒、Sophisticated Backpack 或任何容器右键点击槽位,会将物品快速存入容器;右键点击空槽位,会将容器中的物品快速取出并放入槽位。此操作支持流体、Mekanism 的化学物质甚至 FE 能量。
自动化支持与实用功能
本模组提供了用于自动化和实用功能的方块。这些方块需要绑定到网络,并且大多支持红石控制,从而通过存储与其他模组交互。
- 维度网络路径块: 暴露维度网络的全部存储内容。允许通过管道、漏斗、AE2/RS 存储总线以及 Sophisticated Backpack 卸载升级进行输入/输出。
- 维度网络能量路径块: 功能几乎与网络路径块相同,但专用于 FE 能量传输。其界面显示当前 FE 能量通量。支持“排出模式”,以每秒 21 亿 FE 的速度向相邻方块输出 FE。
- 网络接口: 类似于 ME 接口。具有“配方槽”和“存储槽”。尝试将存储的资源插入到网络中,并从配方槽中标记的网络中提取资源。支持排出模式。
- 净泵 (Net Pump): 主动从相邻容器中抽取资源并将其插入维度网络。具有支持黑名单/白名单模式的过滤槽。
- 净漏斗 (Net Hopper): 吸收附近的物品实体甚至流动中的流体,并将它们直接存入网络。其操作范围可调(从 2 个方块到一个整个区块)。范围越大,操作间隔越长。具有支持黑名单/白名单的过滤槽。
- 净熔炉 (Net Furnace): 允许标记配方(输入和燃料)。自动从网络中抽取标记好的资源进行冶炼。支持使用 FE 或岩浆作为燃料。成品可以排入相邻容器或存回网络。
- 净喂食器 (Net Feeder): 当玩家的饥饿度低于配置阈值时,它会从网络中喂食标记好的食物。不会消耗像 Neverending Bacon 或 Eternal Steak 这样的“无限”食物。可装备在 Curios Charm 槽位中。
- 净磁铁 (Net Magnet): 类似于净漏斗,但是便携式的。以比漏斗更高的频率吸收物品实体。具有热键切换功能。可装备在 Curios Charm 槽位中。
- 主手物品快捷传输: 鼠标中键点击方块,可瞬间从网络中提取一组所持物品类型的物品。蹲下 + 鼠标中键点击,可将所持物品存回网络。此按键绑定可配置。
模组集成与支持
- 支持在 JEI/EMI 中拖放幽灵成分标记和快速配方转移。
- JEI/EMI 的幽灵成分标记可以识别存储在 AE2 通用堆栈(Generic Stack)中的物品。
- 添加了 AE2 维度 ME 存储单元,用于读取已绑定的网络内容。其性能比使用存储总线高出 10 倍以上。
- 支持存储 Mekanism 的化学品。
- 合成网格支持 Polymorph 模组。
- 便携式网络终端 可以装备在 Curios Charm 槽位中。安装带有 Curios 支持的 Beyond Dimensions 会增加一个额外的 Charm 槽位。
- KubeJS 支持:暴露了允许自定义网络创建逻辑、初始容量、扩展方法以及直接操作存储的类。
- 由于该模组的 GUI 进行了大量修改导致不兼容,禁用了 Inventory Profiles Next (IPN) 模组在其 GUI 中的功能。请使用 Mouse Tweaks 进行快速转移。
附加组件开发与 KubeJS 自定义帮助
附加组件开发
在代码中添加新的可存储资源类型非常简单。实现以下接口并将资源类型及相应处理器注册到模组中:
IStackType - 使模组能够识别并存储此资源类型。
IStackHandlerWrapper - 使模组能够通过编程方式与持有此资源的容器/模组方块交互。
CapabilityHelper.BlockCapabilityMap - 允许其他模组的管道/存储总线从方块访问此资源类型。
CapabilityHelper.ItemCapabilityMap - 启用对持有此资源的物品的快速容器槽位交互(鼠标中键)。
UnifiedStorage.typedHandlerMap - 允许维度网络核心存储操作此资源。
StackTypedHandler.typedHandlerMap - 允许外围方块(如网络接口)在其内部槽位中操作此资源。
即使跳过 AE2 的特殊兼容性,也不妨碍使用存储总线进行读取:
7. AEHelper.ISTACK_TO_AEKEY_MAP - 将 Beyond Dimensions 资源对象映射到 AE2 键(用于读取维度 ME 存储单元)。
8. AEHelper.AEKEY_TO_STACK_TYPE_MAP - 将 AE2 键映射回 Beyond Dimensions 资源类型(用于维度 ME 存储单元操作)。
请参阅模组的主注册文件 (BeyondDimensions.java) 以获取实现示例。注意:注册细节可能会在未来版本中发生变化。
KubeJS 自定义帮助
要自定义网络容量:
- 禁用默认的维度网络生成器配方。
- 使用提供的 KubeJS 暴露的类/方法来实现您自己的网络创建和扩展逻辑。
| 类名 |
方法签名 |
返回类型 |
静态 |
目的 |
DimensionsNet |
createNewNetForPlayer(Player player, long defaultSlotCapability, int defaultSlotMaxSize) |
DimensionsNet |
Yes |
为指定玩家创建维度网络。defaultSlotCapability: 每种资源类型的最大单位数。defaultSlotMaxSize: 最大资源类型数量。 |
|
getNetFromId(int id, MinecraftServer dataProvider) |
DimensionsNet |
Yes |
通过其数值 ID 检索 DimensionsNet 对象。 |
|
getNetFromPlayer(Player player) |
DimensionsNet |
Yes |
检索绑定到指定玩家的 DimensionsNet。 |
|
getUnifiedStorage() |
UnifiedStorage |
No |
获取代表此网络存储内容的 UnifiedStorage 对象。 |
UnifiedStorage |
setSlotCapacity(long capacity) |
void |
No |
设置此网络中每种资源类型的最大存储容量(单位数)。 |
|
setSlotMaxSize(int maxSize) |
void |
No |
设置此网络可存储的不同资源类型的最大数量。 |
此外,模组还向 KubeJS 暴露了一些其他类。详细信息请参见 此处。
UnifiedStorage 类还包含大量其他方法,允许您直接修改玩家的存储内容。
模组的 API 附带完整的中文注释。请查看 此处。
其他信息
性能测试
测试在同一台机器、相同的后台条件下覆盖三种场景,并使用 Spark 模组进行分析。所有测试均使用 1319 个随机生成的唯一物品。
- 独立 Beyond Dimensions: 物品通过 Beyond Dimensions 进行存储/修改。输入/输出通过 Mekanism 管道进行。
- 通过 AE2 存储单元连接的 Beyond Dimensions: 网络通过维度 ME 存储单元连接到 AE2。输入/输出通过 Mekanism 管道进行。
- 原生 AE2 存储: 物品存储在标准 AE2 驱动器中(21 x 64k 存储单元)。输入/输出通过 Mekanism 管道进行。
注意:场景 1 使用 Beyond Dimensions 方块(Dimensional Network Pathway、Network Interface),反映了该模组的核心性能。场景 2 和 3 使用相同的 AE2 设置(出口总线、ME 接口、无限通道),仅在存储来源上有所不同,从而实现直接比较。
结果:
| 测试环境 |
TPS |
MSPT (中位数) |
MSPT (95%) |
已加载区块 |
实体数量 |
| 独立 Beyond Dimensions |
20 |
3.67 |
4.86 |
2601 |
13 |
| AE2 + 维度 ME 单元 |
20 |
2.97 |
3.37 |
2601 |
13 |
| AE2 原生存储 |
20 |
2.70 |
3.08 |
2601 |
13 |
详细的 Spark 分析文件和测试设置信息可在 此处 获取。
路线图(即将推出的功能)
- 将原版物品/流体存储的最大容量更改为 64 位整数(已完成)。
- 经验值(XP)存储及实用工具。
- Ars Nouveau Source 存储及实用工具。
- Refined Storage (RS) 专用存储组件。
- 添加进度机制(最初提供有限的存储空间,需要扩展才能解锁更多)。
- 更多的自动化实用工具和工具。
- 额外的实用物品和设备。
支持版本
| MC 版本 |
加载器 |
模组版本 |
状态 |
| 1.21.1 |
Neoforge |
0.3.0+ |
积极更新中 |
| 1.20.1 |
Forge / Neoforge |
0.3.0+ |
积极更新中 |
| 1.12.2 |
Forge |
0.1.7.4 |
仅维护(仅限关键错误修复) |
在当前支持版本的路线图 substantially complete 之前,暂无计划支持其他 Minecraft 版本。
Beyond Dimensions
Beyond Dimensions is a mod focused on storage and utility. It introduces a "Dimensional Network" – a versatile storage system supporting items, fluids, FE energy, XP, Mekanism's chemicals, Ars Nouveau's sources, Botania's mana and Industrial Foregoing:Souls. It combines exceptional storage capacity and performance with a user-friendly interface, easily handling storage needs for most scenarios.
Getting Started
You need to defeat the Wither, or acquire a Nether Star by any other means. Craft it into an Unstable Space-Time Fragment. Keep this fragment in your inventory for one hour, transforming it into a Stable Space-Time Fragment. Use this to craft a Dimensional Network Generator and activate it to create your Dimensional Network. Then, simply press the hotkey (default: 'O') to open the storage interface.
Storage System
- Capacity: The default storage capacity is the maximum. It can store 2.1 billion different item or resource types, with each type capable of holding 2^63^-1 units (the maximum value of a Java
long). The maximum number of stored types, the capacity per type, and the methods for expanding storage can all be customized using KubeJS.
- Performance: The storage system has undergone extensive optimization. Performance tests show excellent results whether connecting to AE2 or using just this mod alone. See the Performance Testing section for specific test results.
- Multiplayer: The storage system binds networks using player permissions. A single network can be shared with multiple players. Alternatively, sharing can be achieved through item-form Terminals.
UI Interface
Intuitive Storage Interface: The mod provides an interface following interaction logic consistent with popular storage mods like AE2 and RS.
- Built-in crafting grid.
- Multiple search modes: Direct text input searches names, tooltips, or mod IDs. Prefix with
# to match tooltips strictly. Prefix with @ to match mod IDs strictly.
- Customizable number of displayed item rows.
- Multiple sorting options: By storage time, by quantity, by name, by mod ID.
Universal Slot System: Any slot in any of the mod's GUIs can store all supported resource types and supports quick interaction mechanics.
Quick Container Operation: Right-click a slot while holding the corresponding container to quickly deposit/withdraw resources from the container. For example: Right-clicking a slot with a Shulker Box, Sophisticated Backpack, or any container will quickly store items into the container; right-clicking an empty slot will quickly withdraw items from the container and place them into the slot. This operation supports fluids, Mekanism's chemicals, and even FE energy.
Automation Support & Utilities
The mod provides blocks for automation and utility items. These blocks need to be bound to a network and mostly support redstone control, enabling interaction with other mods via the storage.
- Dimensional Network Pathway: Exposes the entire storage contents of the Dimensional Network. Allows input/output via pipes, hoppers, AE2/RS Storage Buses, and Sophisticated Backpack unload upgrades.
- Dimensional Network Energy Pathway: Functions almost identically to the Network Pathway but is dedicated to FE energy transfer. Its UI shows current FE energy flux. Supports an "Eject Mode" outputting FE to adjacent blocks at 2.1 billion FE/tick.
- Network Interface: Similar to an ME Interface. Features "Pattern Slots" and "Storage Slots". Attempts to insert stored resources into the network and extract resources from the network marked in the pattern slots. Supports Eject Mode.
- Net Pump: Actively pulls resources from adjacent containers and inserts them into the Dimensional Network. Has filter slots supporting blacklist/whitelist modes.
- Net Hopper: Absorbs nearby item entities and even flowing fluids, depositing them directly into the network. Its operational range is adjustable (from 2 blocks up to a whole chunk). Larger ranges have longer operation intervals. Has filter slots supporting blacklist/whitelist.
- Net Furnace: Allows marking recipes (input and fuel). Automatically pulls marked resources from the network for smelting. Supports FE or Lava as fuel. Finished products can be ejected into adjacent containers or stored back in the network.
- Net Feeder: When a player's hunger drops below its configured threshold, it will feed the player food marked from the network. Won't consume "infinite" foods like Neverending Bacon or Eternal Steak. Equippable in a Curios Charm slot.
- Net Magnet: Similar to the Net Hopper but portable. Absorbs item entities with a higher frequency than the Hopper. Has a hotkey toggle. Equippable in a Curios Charm slot.
- Main Hand Item Quick Transfer: Middle-click a block to instantly extract a stack of the held item type from the network. Crouch + Middle-click to deposit the held item(s) back into the network. This keybind is configurable.
Mod Integration & Support
- Supports drag-and-drop ghost ingredient marking and quick recipe transfer in JEI/EMI.
- JEI/EMI ghost ingredient marking can recognize items stored within AE2 Generic Stack.
- Adds an AE2 Dimensional ME Storage Cell for reading bound network contents. Offers over 10x higher performance than using Storage Buses.
- Supports storage of Mekanism's chemicals.
- Crafting grid supports the Polymorph mod.
- The Portable Network Terminal can be equipped in a Curios Charm slot. Installing Beyond Dimensions with Curios adds an extra Charm slot.
- KubeJS Support: Exposes classes allowing customization of network creation logic, initial capacity, expansion methods, and direct storage manipulation.
- Disables the Inventory Profiles Next (IPN) mod within the mod's GUIs due to significant UI modifications making them incompatible. Please use Mouse Tweaks for quick transfers instead.
Add-on Development & KubeJS Customization Help
Add-on Development
Adding new storable resource types is straightforward in code. Implement the following interfaces and register the resource type along with corresponding handlers:
IStackType - Enables the mod to recognize and store this resource type.
IStackHandlerWrapper - Enables the mod to interact programmatically with containers/mod blocks holding this resource.
CapabilityHelper.BlockCapabilityMap - Allows the resource type to be accessed by other mods' pipes/Storage Buses from blocks.
CapabilityHelper.ItemCapabilityMap - Enables the quick container slot interaction (middle-click) for items holding this resource.
UnifiedStorage.typedHandlerMap - Allows the Dimensional Network core storage to manipulate this resource.
StackTypedHandler.typedHandlerMap - Allows peripheral blocks (like Network Interfaces) to manipulate this resource in their internal slots.
Special compatibility of AE2, even if skipped, does not prevent the use of storage buses for reading.:
7. AEHelper.ISTACK_TO_AEKEY_MAP - Maps Beyond Dimensions resource objects to AE2 keys (for read Dimensional ME Storage Cell).
8. AEHelper.AEKEY_TO_STACK_TYPE_MAP - Maps AE2 keys back to Beyond Dimensions resource types (for Dimensional ME Storage Cell operations).
Refer to the mod's main registration file (BeyondDimensions.java) for implementation examples. Note: Registration specifics may change in future versions.
KubeJS Customization Help
To customize network capacity:
- Disable the default Dimensional Network Generator recipe.
- Use the provided KubeJS-exposed classes/methods to implement your own network creation and expansion logic.
| Class Name |
Method Signature |
Return Type |
Static |
Purpose |
DimensionsNet |
createNewNetForPlayer(Player player, long defaultSlotCapability, int defaultSlotMaxSize) |
DimensionsNet |
Yes |
Create a Dimensional Network for the specified player. defaultSlotCapability: Max units per resource type. defaultSlotMaxSize: Max number of resource types. |
|
getNetFromId(int id, MinecraftServer dataProvider) |
DimensionsNet |
Yes |
Retrieve a DimensionsNet object by its numerical ID. |
|
getNetFromPlayer(Player player) |
DimensionsNet |
Yes |
Retrieve the DimensionsNet bound to the specified player. |
|
getUnifiedStorage() |
UnifiedStorage |
No |
Get the UnifiedStorage object representing the storage content of this network. |
UnifiedStorage |
setSlotCapacity(long capacity) |
void |
No |
Set the maximum storage capacity (units) for each resource type in this network. |
|
setSlotMaxSize(int maxSize) |
void |
No |
Set the maximum number of different resource types this network can store. |
In addition, the mod exposes some other classes to KubeJS. For details, see here.
The UnifiedStorage class also contains a considerable number of other methods that allow you to directly modify a player's storage contents.
The mod's API comes with complete Chinese annotations. Check them out here.
Other Information
Performance Testing
Tests covered three scenarios on the same machine under identical background conditions, utilizing the Spark mod. All tests used 1319 randomly generated unique items.
- Standalone Beyond Dimensions: Items stored/modified via Beyond Dimensions. Input/Output via Mekanism pipes.
- Beyond Dimensions via AE2 Storage Cell: Network connected to AE2 via Dimensional ME Storage Cell. Input/Output via Mekanism pipes.
- Native AE2 Storage: Items stored in standard AE2 drives (21 x 64k Storage Cells). Input/Output via Mekanism pipes.
Note: Scenario 1 uses Beyond Dimensions blocks (Dimensional Network Pathway, Network Interface) and reflects the mod's core performance. Scenarios 2 & 3 use identical AE2 setups (Export Bus, ME Interface, infinite channels), differing only in the storage source, enabling direct comparison.
Results:
| Test Environment |
TPS |
MSPT (Median) |
MSPT (95th %) |
Loaded Chunks |
Entity Count |
| Standalone Beyond Dimensions |
20 |
3.67 |
4.86 |
2601 |
13 |
| AE2 + Dimensional ME Cell |
20 |
2.97 |
3.37 |
2601 |
13 |
| AE2 Native Storage |
20 |
2.70 |
3.08 |
2601 |
13 |
Detailed Spark profiles and test setup information are available here.
Roadmap (Upcoming Features)
- Change vanilla item/fluid storage max capacity to 64-bit integers (Completed).
- Experience (XP) storage and utility tools.
- Ars Nouveau Source storage and utility tools.
- Refined Storage (RS) dedicated storage component.
- Add progression mechanics (initially granting limited storage that requires expansion).
- More automation utilities and tools.
- Additional utility items and equipment.
Supported Versions
| MC Version |
Loader |
Mod Version |
Status |
| 1.21.1 |
Neoforge |
0.3.0+ |
Actively Updated |
| 1.20.1 |
Forge / Neoforge |
0.3.0+ |
Actively Updated |
| 1.12.2 |
Forge |
0.1.7.4 |
Maintanence Only (Critical bugs only) |
Support for other Minecraft versions is not planned until the current roadmap for supported versions is substantially complete.
评论 0
登录后参与评分
还没有评论,来抢沙发吧