4everCraft Mod/com.evermod.lorekeeper/LorekeeperReputationProfileService

LorekeeperReputationProfileService

object LorekeeperReputationProfileService(source)

Coordinates reputation-memory recording, profile generation, and archived profile lookup.

Types

data class MemoryEventRequest(val playerId: UUID, val playerName: String, val source: LorekeeperReputationService.ReputationMemorySource, val delta: Int, val reason: String, val evidence: String, val relatedNames: List<String> = emptyList())

Input payload for recording a single reputation memory event.

MutationRefreshRequest

data class MutationRefreshRequest(val playerId: UUID, val playerName: String, val oldScore: Int, val newScore: Int, val oldTier: LorekeeperReputationService.ReputationTier, val newTier: LorekeeperReputationService.ReputationTier, val triggerReason: String, val deliverToPlayer: Boolean)

Input payload for scheduling a post-mutation biography refresh.

ProfileGenerationResult

data class ProfileGenerationResult(val profile: LoreStorage.ReputationProfile, val deliveredToPlayer: Boolean)

Result returned when a profile is generated and archived.

ReputationAlignment

enum ReputationAlignment : Enum<LorekeeperReputationProfileService.ReputationAlignment>

Tone used for player biography generation.

ReputationBookContext

data class ReputationBookContext(val playerId: UUID, val playerName: String, val score: Int, val tier: LorekeeperReputationService.ReputationTier, val reputationMutationEvidence: List<String>, val interviewEvidence: List<String>, val talkEvidence: List<String>, val submittedBookEvidence: List<String>)

Structured context passed into player biography generation.

Properties

PLAYER_BIOGRAPHY_PRICE_EMERALDS

const val PLAYER_BIOGRAPHY_PRICE_EMERALDS: Int = 5

Emerald cost to purchase a single player biography book.

Functions

buildNarrativeContextLines

fun buildNarrativeContextLines(server: MinecraftServer, relevantPlayerNames: Set<String>, maxLines: Int = 8): List<String>

Builds reputation context lines for weekly/history prompts.

getLatestProfile

fun getLatestProfile(server: MinecraftServer, playerId: UUID): LoreStorage.ReputationProfile?

Returns the latest canonical archived profile for a player.

getRecentEvents

fun getRecentEvents(server: MinecraftServer, playerId: UUID, limit: Int): List<LoreStorage.ReputationMemoryEvent>

Returns recent reputation memory events for a player, newest first.

listAvailableBiographyTargets

fun listAvailableBiographyTargets(server: MinecraftServer, limit: Int = 200): List<String>

Lists known player names with reputation context, newest first.

logRefreshModeStatus

fun logRefreshModeStatus()

Emits startup diagnostics for the async reputation refresh pipeline.

parseAlignment

fun parseAlignment(raw: String): LorekeeperReputationProfileService.ReputationAlignment?

Resolves a stored or user-facing alignment value to a known reputation tone.

queueRefreshProfileAfterMutation

fun queueRefreshProfileAfterMutation(server: MinecraftServer, request: LorekeeperReputationProfileService.MutationRefreshRequest): Boolean

Queues a profile refresh after a scored reputation mutation on a background worker.

queueRefreshProfileFromSignal

fun queueRefreshProfileFromSignal(server: MinecraftServer, playerId: UUID, playerName: String, triggerReason: String): Boolean

Queues a profile refresh from non-scoring evidence signals on a background worker.

recordMemoryEvent

fun recordMemoryEvent(server: MinecraftServer, request: LorekeeperReputationProfileService.MemoryEventRequest)

Records a reputation memory event in persistent lore storage.

requestBiographyBook

fun requestBiographyBook(requester: ServerPlayer, requestedPlayerName: String): Boolean

Delivers a player biography book for the requested player name to the requester.

resolveAlignmentForTier

fun resolveAlignmentForTier(tier: LorekeeperReputationService.ReputationTier): LorekeeperReputationProfileService.ReputationAlignment

Resolves a reputation tier to the corresponding reputation-book narrative tone.