Map Face - Server

MapFace Server is the optional Paper plugin for MapFace Client, a Fabric mod that lets players wear filled maps on their head and render the actual map texture directly on their face.

This plugin improves multiplayer syncing for players using the MapFace client mod.

Client-side mod: MapFace Client

What it does

MapFace Server helps MapFace clients receive the map data they need to render worn maps correctly in multiplayer.

By default, the client-side mod can only render a worn map if the client already has that map's data. This works well for your own maps, but it can be unreliable when viewing other players.

For example, if another player wears a filled_map that your client has never seen before, your client may not have the map texture needed to render it.

MapFace Server helps solve that by syncing map data from the server to players using the client mod.

Why use the server plugin?

The client mod works without this plugin, but multiplayer works much better when the plugin is installed.

MapFace Server improves multiplayer by:

• syncing map data for worn maps
• helping clients render other players' map faces more reliably
• keeping worn maps updated while players are viewing them
• reducing cases where a map face cannot render because the client is missing map data

Important

This plugin does not render anything by itself.

Players need the MapFace Client Fabric mod installed to see the visual effect:

Download MapFace Client

Without the client mod, players will simply see normal Minecraft behavior.

Unmodded clients are ignored safely and can still join the server normally.

Requirements

Server

• Paper server
• MapFace Server plugin

Players who want to see the effect

• Fabric Loader
• Fabric API
• MapFace Client

Usage

1. Install MapFace Server on your Paper server
2. Have players install MapFace Client
3. Players equip a filled_map in their head slot
4. MapFace clients will sync map data more reliably and render worn maps on players' faces

Compatibility

• Designed for Paper servers
• Safe for unmodded clients
• Only players using MapFace Client will see the custom rendering
• The plugin is optional, but recommended for multiplayer servers

Notes

• This is the server-side companion plugin for MapFace
• The client mod is required to see the visual feature
• The plugin only improves synchronization for players using the client mod
• Best results happen when both MapFace Client and MapFace Server are installed