地图生成

MapGen - Hytale 真实世界地图生成器

一款强大的 Hytale 插件，利用 真实地形数据 通过 Hytale 的 WorldMapManager API 生成精美、高分辨率的地图。

功能特性

• 真实地形数据：使用 Hytale 的 WorldMapManager API 获取真实的地图数据
• 多种地图尺寸：从快速的 5x5 区块到庞大的 100x100 区块地图
• 以玩家为中心：地图围绕你当前所在位置生成
• 进度跟踪：生成过程中实时更新进度
• 自动保存：保存至 maps/ 文件夹，包含世界名称和时间戳

可用命令

统一命令系统

所有地图生成现在通过统一的 /mapgen 命令处理：

• /mapgen - 显示帮助和所有可用选项
• /mapgen small - 快速生成 5x5 区块地图
• /mapgen 256 - 中等尺寸 16x16 区块地图
• /mapgen large - 精细 25x25 区块地图
• /mapgen 4k - 高分辨率 30x30 区块地图
• /mapgen 8k - 超高分辨率 60x60 区块地图
• /mapgen world - 巨大 100x100 区块地图（耗时可能较长）
• /mapgen all - 一次性生成所有尺寸（耗时可能较长）
• /mapgen help - 显示详细帮助及示例

示例：

• /mapgen 4k - 生成 4K 地图
• /mapgen help - 显示详细帮助

地图尺寸与详情

命令	尺寸	区块数	分辨率	生成时间	适用场景
small	5x5	25	160x160	~5 秒	快速概览
256	16x16	256	1024x1024	~15 秒	中等细节
large	25x25	625	800x800	~30 秒	高细节
4k	30x30	900	3840x3840	~45 秒	4K 画质
8k	60x60	3600	7680x7680	~3 分钟	8K 画质
world	100x100	10000	6400x6400	~8 分钟	世界级地图

文件输出

地图会自动保存至 maps/ 文件夹，文件名包含描述信息：

格式：世界名_terrain_尺寸_时间戳.png

示例：

• testing_terrain_30x30chunks_20260201_035605.png
• myworld_terrain_60x60chunks_20260201_120000.png

技术细节

工作原理

1. WorldMapManager API：使用 Hytale 官方地图生成系统
2. 区块处理：逐个处理每个区块以确保准确性
3. 真实数据：无人工效果——纯游戏内的地形数据
4. 几何着色：利用 Hytale 内置的基于高度的着色功能
5. 玩家位置：地图以你当前所在位置为中心

性能表现

• 异步处理：非阻塞式生成，不会冻结服务器
• 进度更新：生成过程中实时反馈
• 内存高效：逐个处理区块以最小化内存使用
• 错误处理：对未加载的区块有优雅的降级处理

安装方法

1. 下载最新的 MapGen-[版本号].jar
2. 放入 Hytale 的 UserData/Mods/ 文件夹
3. 重启 Hytale 服务器
4. 使用 /mapgen 或 /map 查看所有可用命令

系统要求

• Hytale 服务器（最新版本）
• Java 25 或更高版本
• 足够的磁盘空间用于存储地图图像

支持

需要帮助或有疑问？

Discord 社区：https://discord.gg/YUxuTa4ZzX - 获取帮助、报告错误和讨论功能

致谢

作者：Patrick Jr.

CurseForge：https://www.curseforge.com/members/patrickjr/projects

许可证

版权所有。本模组按原样提供，仅用于 Hytale 服务器。