Minimap Shapes Core

Shared minimap shapes, selection screens, and separate saved preferences for map add-ons.
The same view with the rounded square shape selected in JourneyMap.

The same view with the rounded square shape selected in JourneyMap.

Description

Build minimap shape add-ons with shared contour geometry, a selection screen, and a separate saved preference for each map.

Minimap Shapes Core is the library used by the JourneyMap and Xaero shape add-ons. Install it when an add-on requires it. Each add-on connects Core to its map's renderer and registers the shapes that renderer supports.

Core alone does not change a minimap. With the JourneyMap add-on installed, the minimap can use these outlines:

JourneyMap minimap with the rounded square shape JourneyMap minimap with the hexagon shape JourneyMap minimap with the octagon shape

Geometry

The shared shapes are a rounded square, hexagon, octagon, horizontal rectangle, and vertical rectangle. A Default selection delegates rendering to the map's native shape. Geometry is expressed in a centered unit square, so an integration can apply the same contour to a terrain mask, frame, and marker boundary.

A minimal radius query uses the public Java API:

import com.kuronami.minimapshapes.Shape;
import com.kuronami.minimapshapes.ShapeGeometry;

double angle = Math.PI / 4;
double radius = ShapeGeometry.radius(Shape.HEXAGON, angle);

The rectangle overload accepts an aspect ratio and crops the short axis while keeping the map texture's scale. Integrations provide their own coordinate transformations and offscreen projection.

Selection and saved preferences

Register a stable map ID, a list of supported shapes, and an apply callback through ClientShapes.register. The add-on registers its key binding and calls ClientShapes.tick from its client tick handler. Core opens the selector, saves the chosen enum value, and requests application when it changes.

Preferences are separate for each registered map. The JourneyMap and Xaero integrations can therefore share one Core installation while retaining independent selections. A new integration supplies its screen-title translation and connects the contour to its host's rendering, rotation, and marker rules.

API scope

Core provides these shared building blocks. Map-specific rendering hooks, host dependencies, texture ownership, and version compatibility remain the integration's responsibility. The source includes API documentation and a small geometry consumer example.

Support my mods on Patreon Follow KURONAMI on X Watch KURONAMI on YouTube

Need a custom mod?

Paid commissions for videos, streams and servers. Send me your idea: kuronami.mods@gmail.com

MIT licensed. Free to use, modify, and distribute under the terms of the MIT license.

Bugs and questions: comment on the CurseForge page, or DM @kuronami333 on X.

Source: Minimap Shapes.

Minimap Shapes Core Team

profile avatar
  • 16
    Followers
  • 83
    Projects
  • 924.2K
    Downloads

More from KURONAMlView all

  • Diorama Extras project image

    Diorama Extras

    Zoom Diorama's map out much further and add filters, waypoint export and a searchable settings screen.

    • 78
    • November 19, 2026
  • Kapok project image

    Kapok

    Cuts the waits that stall a large modpack: fewer class reads at startup and a server thread that no longer parks on chunk work.

    • 35
    • November 17, 2026
  • Isekai API project image

    Isekai API

    Shape terrain, place biomes and move existing ores, structures and mobs from datapack JSON, in the overworld, the nether or a new dimension.

    • 4.7K
    • November 15, 2026
  • Ars Warp to Map: Xaero's Minimap & Ars Nouveau Addon project image

    Ars Warp to Map: Xaero's Minimap & Ars Nouveau Addon

    Show the destinations of the Ars Nouveau warp scrolls you carry as Xaero's Minimap waypoints, and remove them when you put the scrolls away.

    • 717
    • November 14, 2026
  • Diorama Extras project image

    Diorama Extras

    Zoom Diorama's map out much further and add filters, waypoint export and a searchable settings screen.

    • 78
    • November 19, 2026
  • Kapok project image

    Kapok

    Cuts the waits that stall a large modpack: fewer class reads at startup and a server thread that no longer parks on chunk work.

    • 35
    • November 17, 2026
  • Isekai API project image

    Isekai API

    Shape terrain, place biomes and move existing ores, structures and mobs from datapack JSON, in the overworld, the nether or a new dimension.

    • 4.7K
    • November 15, 2026
  • Ars Warp to Map: Xaero's Minimap & Ars Nouveau Addon project image

    Ars Warp to Map: Xaero's Minimap & Ars Nouveau Addon

    Show the destinations of the Ars Nouveau warp scrolls you carry as Xaero's Minimap waypoints, and remove them when you put the scrolls away.

    • 717
    • November 14, 2026