Map Face - Client

MapFace lets you wear a filled map on your head and renders the actual map texture directly on the front of your face.

This is the client-side Fabric mod. For improved multiplayer syncing, server owners can also install the optional Paper plugin:

Optional server plugin: MapFace Server

What it does

When a player equips a filled_map in their head slot, MapFace replaces the normal head-item rendering and draws the map itself as a flat face mask.

That means:

• Your own worn map renders on your face
• Other players wearing maps can also render correctly
• The map stays attached to the face and follows head rotation

Client-only mode

MapFace works by default as a client-side Fabric mod.

In client-only mode, you can always see your own worn maps. You can also see other players' worn maps, but only if your client already has that map's data.

Usually, that means you must have:

• held that map before
• viewed it in an item frame
• received the map data from the server in another way

If your client has never received the map's data, there is nothing for MapFace to render yet.

Optional server-side syncing

For better multiplayer support, server owners can install the optional MapFace Server Paper plugin:

Download MapFace Server

When installed on a Paper server, the plugin helps MapFace clients sync map data automatically. This makes worn maps render much more reliably between players.

The server plugin improves multiplayer by:

• sending needed map data before the client notices it is missing
• keeping worn maps updated while they are being viewed
• making MapFace clients see each other's worn maps more consistently

Unmodded clients are ignored safely, and this client mod still works without the plugin.

Requirements

Client

• Fabric Loader
• Fabric API
• MapFace client mod

Optional server support

• Paper server
• MapFace Server plugin

Usage

1. Obtain a filled_map
2. Equip it in your head slot
3. Look in third person, or have another MapFace user look at you

Notes

• This mod is primarily visual
• The server plugin is not required for basic functionality
• The Paper plugin only improves synchronization for players using the client mod
• Best multiplayer results happen when both the client mod and optional server plugin are installed

Compatibility

• Designed for the Minecraft/Fabric version listed on this page
• Client-side safe by default
• Works when joining Vanilla, Paper, and Fabric servers
• Optional enhanced syncing is available on Paper servers with MapFace Server