About HeadMap

This plugin allows players to create maps with pictures of their heads. Just place a player head and map in a craft box. This works great with the TrophyHeads plugin.


Craft face maps like this:

Craft body maps like this:


  • Players can craft a head map with just a head and a map. (Shapeless)
  • Players can craft a body map with just a head and 4 pieces of paper. (Shaped)
  • Players can create a head map with the /hmcreate command. (Requires permissions).
  • Players can create an image map with /hmcreate command. (Requires permissions).
  • This plugin does not edit chunks or blocks. It utilizes the CrafftBukkit API to place images on maps.
  • Connects to Mojang Skin API server to download player skins and cache them.

How to install

Just drop the jar file in your plugins directory and restart your server. Update config.yml as needed. Update permissions.


headmap.create - Allows players to use the /hmcreate command. (Default: op)

headmap.face - Allows players to craft head maps. (Default: true)

headmap.body - Allows players to craft body maps. (Default: true)


See config.yml


Spawn a head map.
/hmcreate ([player | image])

Spawn a body map.
/hmcreate ([player]) body

Spawn an image map. The image must exist in the HeadMap/images/ folder. (png, jpg or gif)
/hmcreate sample.png

Spawn a bunch of images from a folder. (Place folder in HeadMap/images/ folder)
/hmcreate <folder name> folder

If you have a folder named plugins/HeadMap/images/bannerfolder then do this:
/hmcreate bannerfolder folder


See github.

Dev Builds

See Jenkins.

Known Issues

  • The colors are not 100% accurate. This is a Minecraft limitation.
  • Images larger than 128x128 may cause lag. The plugin will resize images down to 128x128. It is recommended that you resize them manually before using them with this plugin.



Change Log

  • v1.0-12 - May 5, 2015
    • Null pointer fix.
  • v0.0.11 - March 29, 2014
    • Fix recipes
  • v0.0.9 - January 12, 2014
    • Add folder option
    • Properly add map to inventory instead of replacing item in hand.
    • Remove mob option. (Use MHF_ names instead)
    • Include helmet in face render
  • v0.0.6 - August 20, 2013
    • Add mob skulls
    • Fix NPE (sometimes when player quits)
  • v0.0.5 - February 20, 2013
    • Fix class casting exception (onPlayerQuit)
    • Fix NPE (when loading invalid maps) and remove them from maps.txt
  • v0.0.4 - February 17, 2013
    • Added permission nodes
  • v0.0.3 - February 16, 2013
    • Added body maps. (Use one head and four pieces of paper)
    • Added the ability to map any image. (/hmcreate image.png)
  • v0.0.2 - February 11, 2013
    • Cleanup maps.txt when users burn them or they despawn.
    • Add default skin for when unable to download from Mojang site.
    • Don't error when maps.txt is missing. (First run)
  • v0.0.1 - February 10, 2013
    • Initial version




You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of leasoncre leasoncre Mar 10, 2016 at 07:31 UTC - 0 likes

    awesome plugin.

    -Video is 'private', can't view it.
    -Link to the 'colormap' is broken (exact colors a map in minecraft can display)
    please fix, thanks :)

    Last edited Mar 10, 2016 by leasoncre

    Admin on Legends and Kings.
    Teamspeak: legendsandkings.typefrag.com

  • Avatar of fr233 fr233 May 03, 2015 at 00:43 UTC - 0 likes

    i like it :D

  • Avatar of cnaude cnaude May 03, 2015 at 00:29 UTC - 0 likes

    @CloudeLecaw: Go

    Fixed in 1.0-12.

    Jenkins | GitHub BFAK:cnaude,99361,b703b55cc7c33b67a0dde6d0e3e3b46833573e8f906baec978d45c87a0139279

  • Avatar of Duffa13 Duffa13 Jul 31, 2014 at 11:48 UTC - 0 likes

    @lorderikson: Go

    Make sure you are not in creative game mode when you place the map into the item frame.

  • Avatar of lorderikson lorderikson Jul 11, 2014 at 09:43 UTC - 0 likes

    other players don't load maps i put onto item frame, only when i place it, they see their items, i see their items, other players see their items onto item frame, it don't works only for me, only when i place it. we are in offline mode

  • Avatar of cnaude cnaude Jul 11, 2014 at 02:09 UTC - 0 likes

    @lorderikson: Go

    Can I see a screenshot of the issue? I;m unable to reproduce it in 1.7.2 build 3023 or 1.7.9. Are you playing in online or offline mode?

  • Avatar of lorderikson lorderikson Jul 10, 2014 at 16:21 UTC - 0 likes

    now craft works fine but i still have the same problem, Other players cannnot see the map when I place it onto an itemframe . They can only see it when I give them the actual map in their inventory.also the permission are fine

  • Avatar of lorderikson lorderikson Jul 10, 2014 at 14:53 UTC - 0 likes

    i tried 0.0.6, 0.0.9 and 0.0.11, now in 11 but don't work

  • Avatar of cnaude cnaude Jul 10, 2014 at 14:15 UTC - 0 likes

    @lorderikson: Go

    What version of HeadMap are you using?

  • Avatar of lorderikson lorderikson Jul 08, 2014 at 12:58 UTC - 0 likes

    1.7.2-R0.3-2-g85f5776-b3023jnks exactly


Date created
Feb 10, 2013
Last update
May 03, 2015
Development stage
GNU General Public License version 3 (GPLv3)
Curse link
Recent files
  • R: v1.0-12 for 1.8.1 May 03, 2015
  • R: v0.0.11 for 1.7.4 Mar 29, 2014
  • R: v0.0.9 for 1.7.2 Jan 12, 2014
  • R: v0.0.6 for 1.7.2 Aug 21, 2013
  • R: v0.0.5 for 1.6.2 Feb 20, 2013