4everCraft Mod/com.evermod.markers/BlueMapMarkerService

BlueMapMarkerService

Reads BlueMap markers via the BlueMap API and provides searchable location data for the mod.

When BlueMap is installed, this service registers lifecycle hooks through BlueMapBridge to automatically load POI markers when BlueMap becomes available. Markers are refreshed periodically to pick up changes from other mods that add markers after BlueMap's initial load.

If BlueMap is not installed, the service gracefully disables itself with no runtime impact.

Properties

DEFAULT_EXCLUDED_CATEGORIES

val DEFAULT_EXCLUDED_CATEGORIES: Set<String>

Categories excluded from LLM context by default (low-value for teleportation).

JEEVES_INCLUDED_CATEGORIES

val JEEVES_INCLUDED_CATEGORIES: Set<String>

Categories included in Jeeves location searches. Only high-value navigation categories are included to avoid cluttering LLM context with signs, banners, and chests.

Functions

allMarkers

fun allMarkers(): List<MapMarker>

Returns all currently cached markers.

findBestMatch

fun findBestMatch(query: String): MapMarker?

Returns the single best match for a query, or null if no match is found.

initialize

fun initialize(refreshIntervalSeconds: Int = DEFAULT_REFRESH_INTERVAL_SECONDS.toInt())

Initializes the service by checking for BlueMap and registering lifecycle hooks if present.

locationsForContext

fun locationsForContext(excludedCategories: Set<String> = DEFAULT_EXCLUDED_CATEGORIES): List<String>

Returns deduplicated marker names with categories, suitable for LLM context.

fun search(query: String): List<MapMarker>

Searches markers by name using case-insensitive substring matching.

searchForContext

fun searchForContext(query: String, includedCategories: Set<String> = JEEVES_INCLUDED_CATEGORIES): List<String>

Searches markers by name or category, filtered to a set of included categories.

BlueMapMarkerService

See also

Properties

Functions