@jgengine/core 0.14.0 → 0.15.0

package/skills/jgengine-gameplay/capabilities.md

@@ -4,6 +4,10 @@
 
 Reach for these before hand-rolling. Each row is *the thing you need* → *the primitive that already does it*.
 
+## achievements — track achievement/trophy unlocks over counter goals and boolean flags, with score, completion, an onUnlock seam, and serializable snapshot/restore
+
+- `createAchievementTracker` (function) · `import { createAchievementTracker } from "@jgengine/core/gameplay"`
+
 ## advance-ledger — settle due scheduled transactions through a policy pipeline
 
 - `advanceLedger` (function) · `import { advanceLedger } from "@jgengine/core/gameplay"`
@@ -41,6 +45,10 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 - `classifyClip` (function) · `import { classifyClip } from "@jgengine/core/game/clipRoles"`
 - `defaultAnimationForClips` (function) · `import { defaultAnimationForClips } from "@jgengine/core/game/clipRoles"`
 
+## codex — codex/bestiary/lorebook of defined entries with discovery tracking, categories, secret masking, completion, an onDiscover seam, and serializable state
+
+- `createCodex` (function) · `import { createCodex } from "@jgengine/core/gameplay"`
+
 ## compose-game-loop — fold composable systems into the game loop without a manual tick fan-out
 
 - `composeGameLoop` (function) · `import { composeGameLoop } from "@jgengine/core/gameplay"`
@@ -84,6 +92,14 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `createGameDialogue` (function) · `import { createGameDialogue } from "@jgengine/core/gameplay"`
 
+## dialogue-graph-view — select a conversation node's render-ready view (speaker, line, branching choices) from a serializable dialogue graph
+
+- `selectDialogueView` (function) · `import { selectDialogueView } from "@jgengine/core/gameplay"`
+
+## dialogue-run — walk a serializable branching dialogue graph — current node view, choose-to-advance traversal, visited history, snapshot/restore
+
+- `createDialogueRun` (function) · `import { createDialogueRun } from "@jgengine/core/gameplay"`
+
 ## durability — track item wear, breakage, and repair
 
 - `applyWear` (function) · `import { applyWear } from "@jgengine/core/gameplay"`
@@ -104,6 +120,10 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `createGameFeed` (function) · `import { createGameFeed } from "@jgengine/core/gameplay"`
 
+## event-ticker — rolling capped, timed-fade event/kill-feed ticker of free-string entries over the feed helpers — push/recent-with-fade, snapshot/restore
+
+- `createEventTicker` (function) · `import { createEventTicker } from "@jgengine/core/gameplay"`
+
 ## game-save — save/load game state with a pluggable backend, autosave, slots, and migration
 
 - `createSaveStore` (function) · `import { createSaveStore } from "@jgengine/core/gameplay"`
@@ -112,6 +132,10 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `SystemDefinition` (interface) · `import { SystemDefinition } from "@jgengine/core/gameplay"`
 
+## group-credits — turn a flat list of credited things into ordered credit sections
+
+- `groupCredits` (function) · `import { groupCredits } from "@jgengine/core/game/credits"`
+
 ## imprint-bonus — apply imprint stat and handler bonuses at an imprint fraction
 
 - `applyImprintBonus` (function) · `import { applyImprintBonus } from "@jgengine/core/game/breeding"`
@@ -161,6 +185,10 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `createUseBehaviorRegistry` (function) · `import { createUseBehaviorRegistry } from "@jgengine/core/gameplay"`
 
+## key-rebinding — conflict-aware key-remap session over the action-binding model — capture/reassign, conflict detection, reset-to-defaults, persist overrides, snapshot/restore
+
+- `createRebindSession` (function) · `import { createRebindSession } from "@jgengine/core/gameplay"`
+
 ## lap-splits — per-lap durations from a cumulative split book
 
 - `lapDurations` (function) · `import { lapDurations } from "@jgengine/core/gameplay"`
@@ -217,6 +245,10 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `maturationStage` (function) · `import { maturationStage } from "@jgengine/core/game/breeding"`
 
+## merge-credits — fold generated and hand-authored credit documents into one, deduped by entry
+
+- `mergeCredits` (function) · `import { mergeCredits } from "@jgengine/core/game/credits"`
+
 ## modular-item — attach parts into item mount slots to compute combined stats
 
 - `slotAccepts` (function) · `import { slotAccepts } from "@jgengine/core/gameplay"`
@@ -234,6 +266,10 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 - `appendFeed` (function) · `import { appendFeed } from "@jgengine/core/gameplay"`
 - `pruneFeed` (function) · `import { pruneFeed } from "@jgengine/core/gameplay"`
 
+## notification-center — persistent, read-tracked notification log (newest-first, capped, serializable) behind an unread badge — the durable counterpart to transient toasts
+
+- `createNotificationCenter` (function) · `import { createNotificationCenter } from "@jgengine/core/gameplay"`
+
 ## objectives — check progress of a threshold objective against a live metric
 
 - `evaluateObjective` (function) · `import { evaluateObjective } from "@jgengine/core/gameplay"`
@@ -308,6 +344,10 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `createQuestJournal` (function) · `import { createQuestJournal } from "@jgengine/core/gameplay"`
 
+## quest-tracker-view — join a QuestDef + live QuestInstance into a flat labelled view for a quest/objective HUD tracker
+
+- `describeTrackedQuest` (function) · `import { describeTrackedQuest } from "@jgengine/core/gameplay"`
+
 ## race-placements — look up one racer's place + win/lose within a finish order
 
 - `placementOf` (function) · `import { placementOf } from "@jgengine/core/gameplay"`
@@ -325,6 +365,10 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `tierAt` (function) · `import { tierAt } from "@jgengine/core/gameplay"`
 
+## resolve-rng — resolve an optional injected RNG, warning once per site when it falls back to `Math.random`
+
+- `resolveRng` (function) · `import { resolveRng } from "@jgengine/core/random/resolveRng"`
+
 ## resource-ledger — schedule recurring resource transactions with policy transforms
 
 - `createResourceLedger` (function) · `import { createResourceLedger } from "@jgengine/core/gameplay"`
@@ -351,6 +395,14 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `createRunDraft` (function) · `import { createRunDraft } from "@jgengine/core/gameplay"`
 
+## save-slots — serializable save-slot / profile metadata index — write/clear/rename/mostRecent over free-string per-slot meta, powering New/Continue/Load/Delete menus, with snapshot/restore
+
+- `createSaveSlots` (function) · `import { createSaveSlots } from "@jgengine/core/gameplay"`
+
+## scoreboard — pure tie-aware ranking selector over the leaderboard model — standard/dense ranks, local-entry highlight, top-N, medal tokens for a reskinnable table
+
+- `rankLeaderboard` (function) · `import { rankLeaderboard } from "@jgengine/core/gameplay"`
+
 ## seeded-random — injected deterministic randomness for game logic — never `Math.random` in a simulation
 
 - `seededRng` (function) · `import { seededRng } from "@jgengine/core/gameplay"`
@@ -359,6 +411,10 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `setValue` (function) · `import { setValue } from "@jgengine/core/gameplay"`
 
+## shop-grid — serializable vendor/shop stock with buy/sell over a caller-owned wallet — finite/unlimited qty, sell-back, restock/setPrice, snapshot/restore
+
+- `createShopStock` (function) · `import { createShopStock } from "@jgengine/core/gameplay"`
+
 ## social-emotes — emotes and social interactions between nearby players
 
 - `createSocial` (function) · `import { createSocial } from "@jgengine/core/gameplay"`
@@ -379,6 +435,14 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `compileSystemSchedule` (function) · `import { compileSystemSchedule } from "@jgengine/core/gameplay"`
 
+## talent-tree-view — flatten a talent tree into a placed, per-node render view — branch/tier layout, learned/available/locked/maxed state, prerequisite edges
+
+- `talentTreeView` (function) · `import { talentTreeView } from "@jgengine/core/gameplay"`
+
+## talent-tree-view-from — build a placed talent/upgrade-tree render view from any per-node unlock rule (points, currency, level, flag) — branch/tier layout, learned/available/locked/maxed state, prerequisite edges
+
+- `talentTreeViewFrom` (function) · `import { talentTreeViewFrom } from "@jgengine/core/gameplay"`
+
 ## tick-work — advance jobs over time, completing work and emitting typed lifecycle events
 
 - `tick` (function) · `import { tick } from "@jgengine/core/gameplay"`
@@ -388,8 +452,9 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 - `appendToast` (function) · `import { appendToast } from "@jgengine/core/gameplay"`
 - `createToastQueue` (function) · `import { createToastQueue } from "@jgengine/core/gameplay"`
 
-## touch-controls — default on-screen button silhouette for a touch action
+## touch-controls — switch the on-screen touch control set when gameplay context changes (enter/exit vehicle, mount, build mode)
 
+- `setTouchControlsMode` (function) · `import { setTouchControlsMode } from "@jgengine/core/gameplay"`
 - `touchButtonShape` (function) · `import { touchButtonShape } from "@jgengine/core/gameplay"`
 
 ## tribe-group — shared-ownership group (tribe/guild/clan) with ranked permissions, group vs personal assets, alliances, and a bounded event log