Frames Map 3D

v1.0.8 — Truly client-optional: no more kicks near framed maps

Fix

• Clients without the mod were disconnected when a framed map was nearby. The per-frame settings (3D on/off, Start Y and placement nonce) were stored in the item frame's synchronized entity data. Vanilla broadcasts entity data to every client that tracks the frame, so a client without the mod only knew the vanilla item-frame slots and crashed with ArrayIndexOutOfBoundsException as soon as it tracked a frame holding a map (for example, a map at spawn) — the server then dropped the connection.
• Settings now live on the map itself. They are stored in the framed map's minecraft:custom_data component instead of synchronized entity data. This reuses the item synchronization vanilla already performs and which clients without the mod handle fine by ignoring the unknown keys, so nothing extra is ever sent to them.

Notes

• Clients without the mod can now join a server that has it and simply see the flat vanilla map, anywhere in the world, with no disconnection.
• Because the settings are stored on the map, two item frames holding copies of the same map share the same display settings. Existing framed maps are re-initialized with default settings (3D on, Start Y 48) the next time they load.

JAR: frames_map_3d-1.21.1-neoforge-21.1.249-1.0.8.jar

Tag: 1.21.1-neoforge-1.0.8