Sixfold Horizons

Sixfold Horizons / 方界星球

An experimental spherical Overworld for Minecraft Java Edition.

Sixfold Horizons connects six square maps into one spherical world. Terrain bends around the planet, and nearby terrain from another face can be seen before you cross into it. The six faces divide the stored world: blocks and entities keep one authoritative state as you explore and build.

Version 1.0.0-alpha.1 is an alpha. It provides the foundation for exploring and building on a sphere; complete vanilla survival, fully seamless travel, and broad mod compatibility are still in development.

Current features

• A Six-face Sphere World world type that makes the Overworld spherical.
• Terrain generated through the mod's spherical adaptation of Minecraft's Overworld noise generation, with curved terrain rendering and shared nearby chunk loading across faces.
• Movement, viewing, mining, and block placement across face boundaries, including entity targeting and nearby interaction sounds and particles.
• Some cross-face block connections, water and lava behavior, and animal and dropped-item movement. These systems have partial support; not every block, fluid situation, or animal behavior is covered.
• A customizable shared edge length of 256–1,048,576 blocks per face, in multiples of 16. The chosen size is saved with the new world. Terrain loads around players as needed; choosing a large size does not generate the entire planet at once.
• The vanilla Nether and End dimensions remain present. Their presence does not mean that all portal travel or survival progression is complete.

Requirements

• Minecraft Java Edition 1.21
• NeoForge 21.0.167
• Java 21
• Install the same mod version on the client and server when playing multiplayer.

Mod ID: toroidalworld.

Development and runtime checks have been performed on Windows. Other operating systems, third-party mods, shaders, and performance mods have not been comprehensively verified. Real network multiplayer is still experimental.

Installation and creating a sphere world

1. Install Minecraft Java 1.21 with NeoForge 21.0.167 and run that profile with Java 21.
2. Put sixfold-horizons-1.0.0-alpha.1.jar into the profile's mods folder. For the default Windows game directory, this is %APPDATA%\.minecraft\mods. A launcher with separate instances uses that instance's game directory instead.
3. Start the NeoForge profile.
4. Open Singleplayer → Create New World → World. Set World Type to Six-face Sphere World.
5. Select Customize, enter the edge length for each face or choose a preset value, and select Apply. Then create the world.

Create a new world for this alpha. Existing flat or toroidal saves are not converted into spherical worlds, and changing the new-world size does not resize an existing save. Keep backups of worlds you want to preserve.

For a server, place the same alpha JAR in the server's mods folder and use a newly created sphere world. Both sides need the matching Minecraft, NeoForge, and mod versions. Server and multiplayer support remain experimental.

Known limitations

• A complete vanilla survival playthrough has not been verified. Do not rely on this alpha for a long-term survival world.
• Nether travel that returns to a new location in the spherical Overworld does not yet have a complete exit-placement policy. Full portal behavior and game completion are unfinished.
• Full cross-face placement and orientation of generated features and structures are unfinished.
• Collision at boundaries is bridged between faces; it is not yet fully identical to the curved visible block geometry.
• Cross-face lighting, vehicles and passengers, and the complete set of vanilla block and entity behaviors are unfinished.
• First-time terrain generation, large view distances, and boundary transitions can still cause pauses or visual issues. This release does not promise stutter-free travel.
• Real network multiplayer and compatibility with other mods, shaders, and renderers have not been fully verified.

If you report a problem, include the mod version, world seed, face size, coordinates, what you were doing, and the relevant latest.log or crash report. Screenshots or a short recording are helpful for visual problems.

中文介绍

方界星球（Sixfold Horizons）是一个让 Minecraft 主世界变成球面的实验性模组。

六张方形地图连接成一颗星球。地形会沿球面弯曲，走到边缘之前就能看到相邻地图上的地形。六张地图只是内部存储的划分；方块和实体保留各自唯一的真实状态。

当前版本为 1.0.0-alpha.1，属于早期测试版。 已具备球面探索和建造的基础，完整原版生存、完全平滑的跨界体验和广泛的模组兼容仍在开发。

目前可以做什么

• 新建世界时选择“六面球形世界”，直接使用球面主世界。
• 使用适配球面的原版主世界噪声生成地形，显示弯曲的地形，并从六张地图中共同加载玩家附近需要的区块。
• 跨地图观察、移动、挖掘和放置方块，选中并攻击附近实体，接收邻面交互的声音和粒子。
• 部分方块连接、水和岩浆行为、动物与掉落物移动可以跨面进行。这些支持尚不覆盖所有方块、流体情况和生物行为。
• 每面的共同边长可设为 256～1048576 格，须为 16 的倍数。大小保存在新世界中；大世界仍按玩家附近的需要加载，不会一次生成整颗星球。
• 保留原版下界和末地。保留这些维度不等于门户行为与生存通关已经完成。

运行要求与安装

需要 Minecraft Java 1.21、NeoForge 21.0.167 和 Java 21。联机时，客户端与服务端都要安装相同版本的本模组。目前主要在 Windows 环境开发和运行；其他系统、第三方模组、光影和优化模组尚未全面验证，真实网络联机仍处于实验阶段。

1. 安装对应版本的 NeoForge，并确认使用 Java 21 启动。
2. 将下载的模组 .jar 放入该游戏实例的 mods 文件夹。Windows 默认路径是 %APPDATA%\.minecraft\mods；启动器开启版本隔离时，应使用那个实例自己的游戏目录。
3. 启动游戏，进入“单人游戏 → 创建新的世界 → 世界”。
4. 将“世界类型”切换为“六面球形世界”，点击“自定义”。
5. 输入每面的边长或选择快捷值，点击“应用”，然后创建世界。

请为这个测试版新建存档。 旧平面或环面存档不会转换成球面，修改新建世界的尺寸也不会改变旧存档的大小。请备份需要保留的世界。服务端同样将此 JAR 放入 mods 文件夹，并使用新建的球面世界；两端的游戏、NeoForge 与模组版本要一致。

目前尚未完成

• 完整原版生存与通关尚未验证，不建议将此测试版作为长期生存存档。
• 从下界走到新位置再返回球面主世界时，出口位置的处理尚未完成；完整门户玩法仍有缺口。
• 特征和结构跨面的完整生成、朝向与写入尚未完成。
• 接缝碰撞已有连接处理，但还没有完全匹配画面中弯曲的方块形状。
• 跨面光照、载具和乘客，以及原版全部方块与实体行为尚未补齐。
• 首次生成、高视距和跨界时仍可能短暂停顿或出现画面问题，当前不保证完全无卡顿。
• 真实网络联机，以及与其他模组、光影和渲染器的兼容尚未全面验证。

反馈问题时，请附上模组版本、种子、每面大小、坐标、触发操作，以及相关 latest.log 或崩溃报告。画面问题可以附截图或短视频。