MapCatalog

模组

· 作者 R-Matrix

服务器端地图元数据目录与同步协议。

0 本站下载 0 关注 更新于 2 个月前

最新 1.0.0-SNAPSHOT · 1.21.4 · Fabric

一键开服(送7天)

MapCatalog —— Not-a-Good-Mod-for-Survival 的服务端组件

MapCatalog 是一个仅安装在服务器上的轻量级 Fabric 模组,专门为 Not-a-Good-Mod-for-Survival 的 「地图目录 (Map Catalog)」功能提供服务器端的支撑。

安装后,服务器可以将存档中所有地图的信息告知客户端,玩家即可在自己的地图上查看这些地图。

地图画制作者的快速参考表

制作地图画(像素画)最耗时的部分,是将地图编号与对应的实际坐标进行匹配。 有了地图目录之后:

  • 直接查看每张地图的编号、中心坐标与覆盖范围,无需逐张拿在手中打开确认。
  • 世界地图上会绘制每张地图的覆盖边框,一眼就能看出这片区域属于哪张地图,以及是否与画框墙对齐。

安装后玩家能看到什么

搭配 Not-a-Good-Mod-for-Survival(并配合 Xaero's World Map)使用时:

  • 完整的地图列表:无需再逐一打开每张地图,服务器存档中存在的所有地图都会直接列出清单, 包含所在维度、中心位置、缩放等级与覆盖范围。
  • 世界地图上的覆盖边界:每张地图覆盖的方块范围会以边框形式绘制在地图上,不同缩放等级对应不同颜色, 并可显示地图编号,一眼看出“这一片区域被哪张地图记录”。
  • 地图上的旗帜标记:其他玩家在地图上插下的旗帜会显示颜色、名称和坐标,便于定位基地和据点。
  • 跨维度可见:下界、末地及自定义维度中的地图同样可被发现,无需亲自前往。
  • 列表自动更新:新制作的地图或修改过的旗帜会自动出现在目录中,无需重新连接。

我需要安装它吗

  • 单人游戏 / 自己的存档:不需要。Not-a-Good-Mod-for-Survival 在单人游戏中开箱即用。
  • 联机服务器:需要,且必须由服务器管理员安装在服务端。你在客户端无法进行任何设置。 如果你希望在服务器上启用地图目录功能,请将本页链接发送给服主。
  • 模组作者:你可以基于此同步协议开发你自己的客户端地图模组。

服务器管理员:为什么要给服务器安装

  • 不改变任何玩法。不添加新机制、不修改原版行为、不改动存档内容, 它仅向客户端报告“存在哪些地图”。
  • 几乎零开销。服务器不会向玩家发送地图图像数据,仅传输极小的目录信息, 即使存档中包含数百张地图也不会占用带宽。
  • 对未安装配套模组的玩家完全无感。原版客户端或仅安装了小地图插件的客户端均不会收到任何额外内容。
  • 可管理。是否启用、谁能使用、是否仅同步当前维度,均由服务端配置掌控在你手中。

安装与兼容性

  • 仅在服务端安装,客户端无需安装本模组。
  • 依赖项:Fabric、Fabric API、Java 21+。
  • 同一作者开发的 Carpet JFT Addition 已内置本模组, 安装该模组后便无需单独安装,二者二选一即可。
  • 开源许可:MIT。

MapCatalog — the server-side companion to Not-a-Good-Mod-for-Survival

MapCatalog is a lightweight, server-side only Fabric mod that powers the Map Catalog feature of Not-a-Good-Mod-for-Survival. It lets a server tell clients about every map stored in the world, so those maps show up right on your own map.

A lookup table for map-art makers

The slowest part of making map art is matching a map number to the coordinates it actually covers. With the map catalogue available:

  • See each map's number, centre position and coverage directly, instead of holding one up and opening it over and over.
  • Coverage outlines are drawn on the world map, so you can check at a glance which map owns a patch of land and whether it lines up with your painting wall.

What players actually see

Used together with Not-a-Good-Mod-for-Survival (displayed inside Xaero's World Map):

  • A complete map list. No more opening maps one by one — every map saved on the server is listed with its dimension, centre position, zoom level and coverage.
  • Coverage borders on your world map. Each map's covered area is drawn as an outline, coloured per zoom level, optionally with map numbers, so you can see at a glance which map covers which land.
  • Banner markers from other players' maps. Flags appear with colour, name and coordinates — great for finding bases and outposts.
  • Every dimension. Nether, End and custom-dimension maps are discoverable without travelling there.
  • It stays fresh. Maps crafted later and banners edited later show up on their own.

Do you need it?

  • Singleplayer / your own worlds: no. Not-a-Good-Mod-for-Survival already works out of the box.
  • Multiplayer servers: yes — and it is installed by the server admin on the server side. There is nothing you can switch on from the client, so send this page to your server owner.
  • Mod authors: you can build your own client-side map mod on top of this sync protocol.

For server admins: why add it

  • No gameplay changes. No new mechanics, no vanilla behaviour altered, no world edits — it only reports which maps exist.
  • Negligible overhead. Map image data is never sent to players; only tiny catalogue information, even on worlds holding hundreds of maps.
  • Invisible to players without the companion mod. Vanilla clients receive nothing extra.
  • Admin-controlled. Whether it is on, who may use it, and whether to limit it to the player's current dimension all stay in your hands.

Installation & compatibility

  • Install on the server; players do not install this mod on their client.
  • Requires: Fabric Loader, Fabric API, Java 21+.
  • Carpet JFT Addition by the same author already bundles MapCatalog — use it or install this standalone file, not both.
  • License: MIT.

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源