File		Statements		Branches		Functions		Lines
ChoicePanel.tsx	+ +	73.21%	41/56	77.35%	41/53	59.09%	13/22	72.54%	37/51
LoadingSpinner.tsx	+ +	87.5%	7/8	50%	3/6	100%	1/1	85.71%	6/7
MovementControls.tsx	+ +	86.95%	20/23	52.94%	9/17	100%	4/4	86.36%	19/22

File		Statements		Branches		Functions		Lines
index.ts	+ +	100%	12/12	100%	0/0	83.33%	5/6	100%	6/6
useKeyboardShortcuts.ts	+ +	40%	10/25	0%	0/22	37.5%	3/8	33.33%	7/21
useLocation.ts	+ +	100%	5/5	100%	2/2	100%	1/1	100%	4/4
usePlayer.ts	+ +	100%	5/5	100%	2/2	100%	1/1	100%	4/4
usePresentCharacters.ts	+ +	100%	5/5	100%	2/2	100%	1/1	100%	4/4
useSnapshot.ts	+ +	100%	6/6	100%	2/2	100%	2/2	100%	4/4
useTimeInfo.ts	+ +	100%	5/5	100%	2/2	100%	1/1	100%	4/4
useToast.ts	+ +	15.78%	3/19	0%	0/3	7.69%	1/13	13.33%	2/15

File		Statements		Branches		Functions		Lines
components	+ +	78.16%	68/87	69.73%	53/76	66.66%	18/27	77.5%	62/80
hooks	+ +	62.19%	51/82	28.57%	10/35	45.45%	15/33	56.45%	35/62
services	+ +	12%	3/25	0%	0/10	0%	0/11	12%	3/25
stores	+ +	5.88%	10/170	0%	0/75	3.12%	1/32	5.96%	9/151
tests	+ +	100%	22/22	100%	6/6	100%	6/6	100%	16/16
utils	+ +	90.78%	69/76	85.71%	12/14	73.91%	17/23	86.53%	45/52

File		Statements		Branches		Functions		Lines
gameApi.ts	+ +	12%	3/25	0%	0/10	0%	0/11	12%	3/25

File		Statements		Branches		Functions		Lines
gameStore.ts	+ +	5.88%	10/170	0%	0/75	3.12%	1/32	5.96%	9/151

File		Statements		Branches		Functions		Lines
testUtils.tsx	+ +	100%	22/22	100%	6/6	100%	6/6	100%	16/16

File		Statements		Branches		Functions		Lines
index.ts	+ +	100%	13/13	100%	0/0	50%	5/10	100%	3/3
meterUtils.tsx	+ +	76.92%	10/13	50%	2/4	75%	3/4	70%	7/10
storage.ts	+ +	88.57%	31/35	100%	6/6	100%	4/4	86.66%	26/30
textFormatting.ts	+ +	100%	15/15	100%	4/4	100%	5/5	100%	9/9

; - }; - - const getMeterBarColor = (meter: string) => { - const colors: Record = { - attraction: 'bg-pink-500', - trust: 'bg-blue-500', - arousal: 'bg-red-500', - corruption: 'bg-purple-500', - energy: 'bg-yellow-500', - }; - return colors[meter.toLowerCase()] || 'bg-gray-500'; - }; +export const CharacterPanel = () => { + const characters = usePresentCharacters(); return (

Characters Present

- {characters.map((charId) => { - const charMeters = meters[charId] || {}; - const details = characterDetails[charId]; - const modifierDescription = getCharacterDescription(charId, details, modifiers); + {characters.map((character) => { + const modifierDescription = getCharacterDescription(character); + const formattedAttire = formatAttire(character.attire); - return ( -

{charId}

+ return ( +

+ {character.name ?? character.id} +

- {/* Modifier Description */} - {modifierDescription && ( -

{modifierDescription}

- )} + {/* Modifier Description */} + {modifierDescription && ( +

{modifierDescription}

+ )} - {/* Clothing Description */} - {details?.wearing && ( -

- - {details.wearing} -

- )} + {/* Clothing Description */} + {formattedAttire && ( +

+ + {formattedAttire} +

+ )} - {/* Meters */} -

- {Object.entries(charMeters).map(([meterId, meterData]) => ( -

- {getMeterIcon(meterData.icon)} - {meterId.replace('_', ' ')} -

- - {meterData.value} - -

+ {/* Meters */} +

+ {Object.entries(character.meters).map(([meterId, meterData]) => ( +

+ {renderMeterIcon(meterData.icon)} + {formatMeterId(meterId)}

+ + {meterData.value} +

- ))} -

+ ))}

- ); +

+ ); })} {characters.length === 0 && ( @@ -123,4 +102,4 @@ export const CharacterPanel = ({ characters, characterDetails, meters, modifiers )}

); -}; \ No newline at end of file +}; diff --git a/frontend/src/components/ChoicePanel.tsx b/frontend/src/components/ChoicePanel.tsx index a435760..17afd1d 100644 --- a/frontend/src/components/ChoicePanel.tsx +++ b/frontend/src/components/ChoicePanel.tsx @@ -1,13 +1,16 @@ -// frontend/src/components/ChoicePanel.tsx -import { useState } from 'react'; +import { useState, useRef } from 'react'; import { useGameStore } from '../stores/gameStore'; -import { MessageSquare, Hand, Send, MapPin, Users, ChevronDown } from 'lucide-react'; +import { usePresentCharacters } from '../hooks'; +import { useKeyboardShortcuts } from '../hooks/useKeyboardShortcuts'; +import { LoadingSpinner } from './LoadingSpinner'; +import { MessageSquare, Hand, Send, Users, ChevronDown, MapPin } from 'lucide-react'; interface Choice { id: string; text: string; type: string; disabled?: boolean; + skip_ai?: boolean; } interface Props { @@ -15,18 +18,50 @@ interface Props { } export const ChoicePanel = ({ choices }: Props) => { - const { sendAction, loading, gameState } = useGameStore(); + const { sendAction, performMovement, loading, deterministicActionsEnabled } = useGameStore(); + const characters = usePresentCharacters(); const [inputMode, setInputMode] = useState<'say' | 'do'>('say'); const [inputText, setInputText] = useState(''); const [targetChar, setTargetChar] = useState(null); const [showTargetMenu, setShowTargetMenu] = useState(false); + const inputRef = useRef(null); - const presentCharacters = gameState?.present_characters || []; + // Get present character IDs + const presentCharacters = characters.map(char => char.id); // Group choices by type const movementChoices = choices.filter(c => c.type === 'movement' && !c.disabled); const nodeChoices = choices.filter(c => c.type === 'node_choice' && !c.disabled); + // Keyboard shortcuts + useKeyboardShortcuts([ + { + key: 'Escape', + handler: () => { + setInputText(''); + setShowTargetMenu(false); + }, + description: 'Clear input or close menus', + }, + { + key: 'k', + ctrl: true, + handler: () => { + inputRef.current?.focus(); + }, + description: 'Focus input field', + }, + ...nodeChoices.slice(0, 9).map((choice, index) => ({ + key: String(index + 1), + handler: () => { + if (!loading) { + handleQuickAction(choice); + } + }, + description: `Activate choice ${index + 1}: ${choice.text}`, + })), + ]); + const handleSubmit = (e: React.FormEvent) => { e.preventDefault(); if (inputText.trim()) { @@ -36,7 +71,12 @@ export const ChoicePanel = ({ choices }: Props) => { }; const handleQuickAction = (choice: Choice) => { - sendAction('choice', choice.text, null, choice.id); + if (deterministicActionsEnabled && choice.type === 'movement') { + void performMovement(choice.id); + } else { + const shouldSkip = deterministicActionsEnabled && (choice.skip_ai ?? false); + sendAction('choice', choice.text, null, choice.id, undefined, { skipAi: shouldSkip }); + } }; const getTargetDisplay = () => { @@ -126,6 +166,7 @@ export const ChoicePanel = ({ choices }: Props) => { {/* Input Field */} setInputText(e.target.value)} @@ -143,10 +184,11 @@ export const ChoicePanel = ({ choices }: Props) => {

@@ -164,15 +206,17 @@ export const ChoicePanel = ({ choices }: Props) => { Actions

- {nodeChoices.map((choice) => ( + {nodeChoices.map((choice, index) => ( ))} @@ -214,4 +258,4 @@ export const ChoicePanel = ({ choices }: Props) => { )}

); -}; \ No newline at end of file +}; diff --git a/frontend/src/components/DeterministicControls.tsx b/frontend/src/components/DeterministicControls.tsx new file mode 100644 index 0000000..5466784 --- /dev/null +++ b/frontend/src/components/DeterministicControls.tsx @@ -0,0 +1,219 @@ +import { useState, useMemo } from 'react'; +import { useGameStore } from '../stores/gameStore'; +import { usePresentCharacters } from '../hooks'; +import { Store, PackagePlus, PackageMinus, ShoppingCart, ArrowRightLeft, ToggleRight, ToggleLeft } from 'lucide-react'; + +export const DeterministicControls = () => { + const { + takeItem, + dropItem, + purchaseItem, + sellItem, + giveItem, + loading, + deterministicActionsEnabled, + setDeterministicActionsEnabled, + } = useGameStore(); + + const characters = usePresentCharacters(); + + const [takeItemId, setTakeItemId] = useState(''); + const [dropItemId, setDropItemId] = useState(''); + const [giveItemId, setGiveItemId] = useState(''); + const [giveTarget, setGiveTarget] = useState(''); + const [buyItemId, setBuyItemId] = useState(''); + const [buyPrice, setBuyPrice] = useState(''); + const [sellItemId, setSellItemId] = useState(''); + const [sellPrice, setSellPrice] = useState(''); + + const presentCharacters = useMemo(() => { + return characters.map(char => ({ + id: char.id, + name: char.name ?? char.id + })); + }, [characters]); + + if (characters.length === 0 && !presentCharacters.length) { + // Still show panel for take/drop/buy/sell even if no characters present + } + + return ( +

+ + Quick Utilities +

+ +

+ Skip AI narration + Apply deterministic endpoints when available. +

+ +

+ + + + +

{ + e.preventDefault(); + if (giveItemId.trim() && giveTarget.trim()) { + void giveItem(giveItemId.trim(), giveTarget.trim()); + setGiveItemId(''); + } + }} + className="flex gap-2" + > + setGiveItemId(e.target.value)} + placeholder="Item ID to give" + className="flex-1 px-3 py-2 bg-gray-900 border border-gray-700 rounded" + /> + + +

+ +

{ + e.preventDefault(); + if (buyItemId.trim()) { + const price = buyPrice ? Number(buyPrice) : undefined; + void purchaseItem(buyItemId.trim(), 1, price); + setBuyItemId(''); + setBuyPrice(''); + } + }} + className="flex gap-2" + > + setBuyItemId(e.target.value)} + placeholder="Item ID to buy" + className="flex-1 px-3 py-2 bg-gray-900 border border-gray-700 rounded" + /> + setBuyPrice(e.target.value)} + placeholder="Price" + className="w-24 px-3 py-2 bg-gray-900 border border-gray-700 rounded" + /> + +

+ +

{ + e.preventDefault(); + if (sellItemId.trim()) { + const price = sellPrice ? Number(sellPrice) : undefined; + void sellItem(sellItemId.trim(), 1, price); + setSellItemId(''); + setSellPrice(''); + } + }} + className="flex gap-2" + > + setSellItemId(e.target.value)} + placeholder="Item ID to sell" + className="flex-1 px-3 py-2 bg-gray-900 border border-gray-700 rounded" + /> + setSellPrice(e.target.value)} + placeholder="Price" + className="w-24 px-3 py-2 bg-gray-900 border border-gray-700 rounded" + /> + +

+ ); +}; diff --git a/frontend/src/components/EconomyPanel.tsx b/frontend/src/components/EconomyPanel.tsx new file mode 100644 index 0000000..4f35738 --- /dev/null +++ b/frontend/src/components/EconomyPanel.tsx @@ -0,0 +1,50 @@ +import { useGameStore } from '../stores/gameStore'; +import { usePlayer } from '../hooks'; +import { Coins } from 'lucide-react'; + +const formatCurrency = (symbol: string | null | undefined, amount: number | null | undefined) => { + if (amount === null || amount === undefined) return '—'; + const prefix = symbol ?? ''; + return `${prefix}${amount}`; +}; + +export const EconomyPanel = () => { + const { gameState } = useGameStore(); + const player = usePlayer(); + + if (!player) return null; + + const economy = gameState?.economy; + const playerMoneyMeter = player.meters.money; + + if (!economy) { + return null; + } + + return ( +

+ + Economy +

+ Currency + {economy.currency ?? 'Credits'} +

+ Balance + + {formatCurrency(economy?.symbol, playerMoneyMeter?.value)} + +

+ {economy?.max_money !== null && economy?.max_money !== undefined && ( +

+ Max + {formatCurrency(economy?.symbol, economy?.max_money)} +

+ )} +

+ ); +}; diff --git a/frontend/src/components/ErrorBoundary.tsx b/frontend/src/components/ErrorBoundary.tsx new file mode 100644 index 0000000..2592235 --- /dev/null +++ b/frontend/src/components/ErrorBoundary.tsx @@ -0,0 +1,108 @@ +import { Component, ErrorInfo, ReactNode } from 'react'; +import { AlertTriangle, RefreshCw } from 'lucide-react'; + +interface Props { + children: ReactNode; + fallbackTitle?: string; + onReset?: () => void; +} + +interface State { + hasError: boolean; + error: Error | null; + errorInfo: ErrorInfo | null; +} + +/** + * Error Boundary component that catches React errors and displays a fallback UI. + * Prevents the entire app from crashing when a component error occurs. + */ +export class ErrorBoundary extends Component { + constructor(props: Props) { + super(props); + this.state = { + hasError: false, + error: null, + errorInfo: null, + }; + } + + static getDerivedStateFromError(error: Error): Partial { + // Update state so the next render will show the fallback UI + return { hasError: true, error }; + } + + componentDidCatch(error: Error, errorInfo: ErrorInfo): void { + // Log error details for debugging + console.error('Error Boundary caught an error:', error, errorInfo); + this.setState({ + error, + errorInfo, + }); + } + + handleReset = (): void => { + this.setState({ + hasError: false, + error: null, + errorInfo: null, + }); + + // Call optional onReset callback + if (this.props.onReset) { + this.props.onReset(); + } + }; + + render(): ReactNode { + if (this.state.hasError) { + const { fallbackTitle = 'Something went wrong' } = this.props; + + return ( +

+ +

+ {fallbackTitle} +

+ An error occurred while rendering this section. + The rest of the app should continue to work normally. +

+ + {/* Show error details (useful for debugging) */} + {this.state.error && ( +

+ Technical Details +

+ {this.state.error.toString()} +

+ {this.state.errorInfo && ( +

+ {this.state.errorInfo.componentStack} +

+ )} +

+ )} + + +

+ ); + } + + return this.props.children; + } +} diff --git a/frontend/src/components/GameInterface.tsx b/frontend/src/components/GameInterface.tsx index 690797d..a39d30f 100644 --- a/frontend/src/components/GameInterface.tsx +++ b/frontend/src/components/GameInterface.tsx @@ -1,27 +1,45 @@ -// frontend/src/components/GameInterface.tsx import { useGameStore } from '../stores/gameStore'; +import { useSnapshot, useLocation, useTimeInfo } from '../hooks'; +import { formatLocationName } from '../utils'; +import { ErrorBoundary } from './ErrorBoundary'; import { NarrativePanel } from './NarrativePanel'; -import { PlayerPanel } from './PlayerPanel'; // Import the new component +import { PlayerPanel } from './PlayerPanel'; import { CharacterPanel } from './CharacterPanel'; import { FlagsPanel } from './FlagsPanel'; import { ChoicePanel } from './ChoicePanel'; -import {InventoryPanel} from "./InventoryPanel"; +import { InventoryPanel } from './InventoryPanel'; +import { MovementControls } from './MovementControls'; +import { DeterministicControls } from './DeterministicControls'; +import { EconomyPanel } from './EconomyPanel'; import { DebugPanel } from './DebugPanel'; -import { MapPin, Clock, Calendar, Package } from 'lucide-react'; +import { MapPin, Clock, Calendar, Layers, Shield, Coins } from 'lucide-react'; export const GameInterface = () => { const { currentGame, - narrative, - choices, gameState, + turnLog, + choices, resetGame } = useGameStore(); - if (!gameState) return null; + const snapshot = useSnapshot(); + const location = useLocation(); + const timeInfo = useTimeInfo(); + + // Early return if no snapshot available + if (!snapshot || !location || !timeInfo) return null; + + const locationName = location.name; + const timeClock = timeInfo.time_hhmm; + const dayNumber = timeInfo.day; + const zoneName = location.zone ?? 'unknown zone'; + const privacy = location.privacy; - // Filter out the 'player' from the list of present characters for the CharacterPanel - const presentNPCs = gameState.present_characters.filter(charId => charId !== 'player'); + // Economy data + const economy = gameState?.economy; + const playerMoney = economy?.player_money; + const currencySymbol = economy?.symbol ?? '$'; return (

@@ -30,22 +48,45 @@ export const GameInterface = () => {

{currentGame?.title}

+ {/* Zone */} +

+ + {formatLocationName(zoneName)} +

+ + {/* Location */}

- {gameState.location.replace('_', ' ')} + {formatLocationName(locationName)}

+ + {/* Privacy */}

- - Day {gameState.day} + + {privacy ? formatLocationName(privacy) : '—'}

+ + {/* Day */}

- - {gameState.time} - {/* Conditionally render HH:MM time */} - {gameState.time_hhmm && ( - ({gameState.time_hhmm}) - )} + + Day {dayNumber}

+ + {/* Time (only show in clock/hybrid mode) */} + {timeClock && ( +

+ + {timeClock} +

+ )} + + {/* Money */} + {playerMoney !== null && playerMoney !== undefined && ( +

+ + {currencySymbol}{playerMoney} +

+ )}

); -}; \ No newline at end of file +}; diff --git a/frontend/src/components/GameSelector.tsx b/frontend/src/components/GameSelector.tsx index 4cc4259..69ef58d 100644 --- a/frontend/src/components/GameSelector.tsx +++ b/frontend/src/components/GameSelector.tsx @@ -1,14 +1,33 @@ -import { useEffect } from 'react'; +import { useEffect, useState } from 'react'; import { useGameStore } from '../stores/gameStore'; -import { Heart, Swords, Book } from 'lucide-react'; +import { loadSession } from '../utils/storage'; +import { Heart, Swords, Book, RefreshCw, X } from 'lucide-react'; export const GameSelector = () => { - const { games, loadGames, startGame, loading } = useGameStore(); + const { games, loadGames, startGame, loading, restoreSession } = useGameStore(); + const [showRestorePrompt, setShowRestorePrompt] = useState(false); + const [storedSession, setStoredSession] = useState>(null); useEffect(() => { loadGames(); + + // Check for stored session + const session = loadSession(); + if (session) { + setStoredSession(session); + setShowRestorePrompt(true); + } }, [loadGames]); + const handleRestore = async () => { + setShowRestorePrompt(false); + await restoreSession(); + }; + + const handleDismissRestore = () => { + setShowRestorePrompt(false); + }; + const getIcon = (contentRating: string) => { switch (contentRating) { case 'explicit': @@ -23,6 +42,38 @@ export const GameSelector = () => { return (

+ {/* Session Restore Prompt */} + {showRestorePrompt && storedSession && ( +

+ +

Resume Previous Session?

+ You have an unfinished game: {storedSession.gameTitle} +

+ + +

+ )} +

Select Your Adventure

diff --git a/frontend/src/components/InventoryPanel.tsx b/frontend/src/components/InventoryPanel.tsx index d162226..b02fecb 100644 --- a/frontend/src/components/InventoryPanel.tsx +++ b/frontend/src/components/InventoryPanel.tsx @@ -1,16 +1,30 @@ -// frontend/src/components/InventoryPanel.tsx +import { useMemo, useState } from 'react'; import { useGameStore } from '../stores/gameStore'; -import { Package, Hand } from 'lucide-react'; +import { usePlayer, usePresentCharacters } from '../hooks'; +import { Package, Hand, Trash2, ArrowRightLeft } from 'lucide-react'; export const InventoryPanel = () => { - const { gameState, sendAction, loading } = useGameStore(); + const { gameState, sendAction, dropItem, giveItem, loading } = useGameStore(); + const player = usePlayer(); + const characters = usePresentCharacters(); - if ( - !gameState || - !gameState.inventory || - !gameState.inventory_details || - Object.keys(gameState.inventory).length === 0 - ) { + const presentCharacters = useMemo(() => { + return characters.map(char => ({ + id: char.id, + name: char.name ?? char.id + })); + }, [characters]); + + const [openGiveMenu, setOpenGiveMenu] = useState(null); + + if (!player) { + return null; + } + + const playerInventory = player.inventory; + const inventoryDetails = gameState?.inventory_details; + + if (!inventoryDetails || Object.keys(playerInventory).length === 0) { return (

@@ -26,6 +40,10 @@ export const InventoryPanel = () => { sendAction('use', null, null, null, itemId); }; + const handleDropItem = (itemId: string) => { + void dropItem(itemId); + }; + return (

@@ -33,11 +51,16 @@ export const InventoryPanel = () => { Inventory

- {Object.entries(gameState.inventory).map(([itemId, count]) => { - const itemDetails = gameState.inventory_details[itemId]; + {Object.entries(playerInventory).map(([itemId, count]) => { + const itemDetails = inventoryDetails[itemId]; if (!itemDetails || count <= 0) return null; - const isUsable = itemDetails.effects_on_use && itemDetails.effects_on_use.length > 0; + const usableEffects = Array.isArray(itemDetails.effects_on_use) + ? itemDetails.effects_on_use + : Array.isArray(itemDetails.on_use) + ? itemDetails.on_use + : []; + const isUsable = usableEffects.length > 0; return (
@@ -63,6 +86,48 @@ export const InventoryPanel = () => { Use )} + + {presentCharacters.length > 0 && ( +
+ + {openGiveMenu === itemId && ( +
+
+ {presentCharacters.map(char => ( +
+ +
+ ))} +
+
+ )} +
+ )}

); @@ -70,4 +135,4 @@ export const InventoryPanel = () => {

); -}; \ No newline at end of file +}; diff --git a/frontend/src/components/LoadingSpinner.tsx b/frontend/src/components/LoadingSpinner.tsx new file mode 100644 index 0000000..514513d --- /dev/null +++ b/frontend/src/components/LoadingSpinner.tsx @@ -0,0 +1,38 @@ +import { Loader2 } from 'lucide-react'; + +interface Props { + size?: 'sm' | 'md' | 'lg'; + message?: string; + fullScreen?: boolean; +} + +/** + * Centralized loading spinner component. + * Can be used inline or as a full-screen overlay. + */ +export const LoadingSpinner = ({ size = 'md', message, fullScreen = false }: Props) => { + const sizeClasses = { + sm: 'w-4 h-4', + md: 'w-8 h-8', + lg: 'w-12 h-12', + }; + + const spinner = ( +

+ + {message && ( +

{message}

+ )} +

+ ); + + if (fullScreen) { + return ( +

+ {spinner} +

+ ); + } + + return spinner; +}; diff --git a/frontend/src/components/MovementControls.tsx b/frontend/src/components/MovementControls.tsx new file mode 100644 index 0000000..df650c0 --- /dev/null +++ b/frontend/src/components/MovementControls.tsx @@ -0,0 +1,64 @@ +import { Fragment, ReactNode } from 'react'; +import { useGameStore } from '../stores/gameStore'; +import { useLocation } from '../hooks'; +import { toTitleCase } from '../utils'; +import { ArrowUp, ArrowDown, ArrowLeft, ArrowRight, Navigation } from 'lucide-react'; + +const directionIconMap: Record = { + n: , + s: , + e: , + w: , +}; + +export const MovementControls = () => { + const { performMovement } = useGameStore(); + const location = useLocation(); + + if (!location || location.exits.length === 0) { + return null; + } + + const exits = location.exits; + + const handleMove = (exitId: string | null, direction: string | null) => { + if (exitId) { + void performMovement(`move_${exitId}`); + } else if (direction) { + void performMovement(`direction_${direction}`); + } + }; + + return ( +

+ + Movement +

+ +

+ {exits.map((exit, index) => { + const icon = exit.direction ? directionIconMap[exit.direction.toLowerCase()] : null; + const label = + exit.direction && icon + ? `${exit.direction.toUpperCase()} – ${toTitleCase(exit.name)}` + : toTitleCase(exit.name); + + return ( + + ); + })} +

+ ); +}; diff --git a/frontend/src/components/NarrativePanel.tsx b/frontend/src/components/NarrativePanel.tsx index 06b7ac2..4382b1a 100644 --- a/frontend/src/components/NarrativePanel.tsx +++ b/frontend/src/components/NarrativePanel.tsx @@ -1,36 +1,109 @@ -import { useEffect, useRef } from 'react'; +import { useEffect, useRef, useState } from 'react'; +import { TurnLogEntry, useGameStore } from '../stores/gameStore'; +import clsx from 'clsx'; type Props = { - narrative: string[]; + entries: TurnLogEntry[]; }; -export const NarrativePanel = ({ narrative }: Props) => { +export const NarrativePanel = ({ entries }: Props) => { const bottomRef = useRef(null); + const { clearTurnLog } = useGameStore(); + const [copied, setCopied] = useState(false); useEffect(() => { const element = bottomRef.current; if (element) { element.scrollIntoView({ behavior: 'smooth' }); } - }, [narrative]); + }, [entries]); + + const handleCopyLog = async () => { + try { + await navigator.clipboard.writeText(JSON.stringify(entries, null, 2)); + setCopied(true); + setTimeout(() => setCopied(false), 1500); + } catch (err) { + console.error('Failed to copy log:', err); + } + }; + + const disableClear = entries.length <= 1; return (

- {narrative.map((text, index) => ( -

- {text.split('\n').map((paragraph, pIndex) => ( -

- {paragraph} -

- ))} - {index < narrative.length - 1 && ( -

- )} -

- ))} +

Turn Log

+ Each entry shows the quick summary first, followed by AI narrative when available. +

+ + +

+ +

+ {entries.map((entry) => { + const showNarrative = + entry.narrative && + entry.narrative.trim().toLowerCase() !== entry.summary.trim().toLowerCase(); + const isDeterministic = entry.origin === 'deterministic'; + const formattedTime = new Date(entry.timestamp).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' }); + + return ( +

+ {entry.summary} +

+ + {isDeterministic ? 'Deterministic' : 'AI-generated'} + + {formattedTime} +

+ {showNarrative && ( +

+ {entry.narrative.split('\n').map((paragraph, index) => ( +

+ {paragraph} +

+ ))} +

+ )} + {!showNarrative && ( +

+ No additional AI prose for this entry. +

+ )} +

+ ); + })}

); -}; \ No newline at end of file +}; diff --git a/frontend/src/components/PlayerPanel.tsx b/frontend/src/components/PlayerPanel.tsx index b6ee582..86cc868 100644 --- a/frontend/src/components/PlayerPanel.tsx +++ b/frontend/src/components/PlayerPanel.tsx @@ -1,36 +1,15 @@ -// Create a new file: frontend/src/components/PlayerPanel.tsx -import { useGameStore } from '../stores/gameStore'; import { User, Shirt } from 'lucide-react'; +import { usePlayer } from '../hooks'; +import { getMeterColor, renderMeterIcon, formatMeterId, formatAttire } from '../utils'; export const PlayerPanel = () => { - const { gameState } = useGameStore(); + const player = usePlayer(); - if (!gameState || !gameState.meters.player) { + if (!player) { return null; } - const playerMeters = gameState.meters.player; - const playerDetails = gameState.player_details; - - const getMeterIcon = (icon: string | null) => { - if (icon) { - return {icon}; - } - return

; // Placeholder for meters without an icon - }; - - const getMeterBarColor = (meter: string) => { - const colors: Record = { - attraction: 'bg-pink-500', - trust: 'bg-blue-500', - arousal: 'bg-red-500', - corruption: 'bg-purple-500', - energy: 'bg-yellow-500', - confidence: 'bg-orange-500', - money: 'bg-green-500', - }; - return colors[meter.toLowerCase()] || 'bg-gray-500'; - }; + const formattedAttire = formatAttire(player.attire); return (

@@ -40,21 +19,21 @@ export const PlayerPanel = () => { {/* Player Clothing Description */} - {playerDetails?.wearing && ( + {formattedAttire && (

- {playerDetails.wearing} + {formattedAttire}

)} {/* Player Meters */}

- {Object.entries(playerMeters).map(([meterId, meterData]) => ( + {Object.entries(player.meters).map(([meterId, meterData]) => (

- {getMeterIcon(meterData.icon)} - {meterId.replace('_', ' ')} + {renderMeterIcon(meterData.icon)} + {formatMeterId(meterId)}

{meterData.value} @@ -62,7 +41,7 @@ export const PlayerPanel = () => {

@@ -71,4 +50,4 @@ export const PlayerPanel = () => {

); -}; \ No newline at end of file +}; diff --git a/frontend/src/components/SkeletonLoader.tsx b/frontend/src/components/SkeletonLoader.tsx new file mode 100644 index 0000000..ae92d92 --- /dev/null +++ b/frontend/src/components/SkeletonLoader.tsx @@ -0,0 +1,68 @@ +/** + * Skeleton loader components for displaying loading states. + * Provides visual feedback while content is being fetched. + */ + +interface SkeletonProps { + className?: string; +} + +/** + * Basic skeleton element (animated gray box). + */ +export const Skeleton = ({ className = '' }: SkeletonProps) => ( +

+); + +/** + * Skeleton for a text line. + */ +export const SkeletonText = ({ width = 'full' }: { width?: 'full' | '3/4' | '1/2' | '1/4' }) => { + const widthClasses = { + full: 'w-full', + '3/4': 'w-3/4', + '1/2': 'w-1/2', + '1/4': 'w-1/4', + }; + + return ; +}; + +/** + * Skeleton for a panel/card. + */ +export const SkeletonPanel = () => ( +

+ + + + +

+); + +/** + * Skeleton for a meter display. + */ +export const SkeletonMeter = () => ( +

+ + +

+ +

+); + +/** + * Skeleton for character card. + */ +export const SkeletonCharacter = () => ( +

+ + +

+); diff --git a/frontend/src/components/ToastContainer.tsx b/frontend/src/components/ToastContainer.tsx new file mode 100644 index 0000000..7c77d56 --- /dev/null +++ b/frontend/src/components/ToastContainer.tsx @@ -0,0 +1,66 @@ +/** + * Toast notification container component. + */ + +import { useToast } from '../hooks/useToast'; +import { X, CheckCircle, XCircle, Info, AlertTriangle } from 'lucide-react'; + +export const ToastContainer = () => { + const { toasts, removeToast } = useToast(); + + const getToastStyles = (type: string) => { + switch (type) { + case 'success': + return 'bg-green-600 border-green-500'; + case 'error': + return 'bg-red-600 border-red-500'; + case 'warning': + return 'bg-yellow-600 border-yellow-500'; + case 'info': + default: + return 'bg-blue-600 border-blue-500'; + } + }; + + const getToastIcon = (type: string) => { + switch (type) { + case 'success': + return ; + case 'error': + return ; + case 'warning': + return ; + case 'info': + default: + return ; + } + }; + + if (toasts.length === 0) return null; + + return ( +

+ {toasts.map((toast) => ( +

+ {getToastIcon(toast.type)} +

+ {toast.message} +

+ +

+ ))} +

+ ); +}; diff --git a/frontend/src/hooks/index.ts b/frontend/src/hooks/index.ts new file mode 100644 index 0000000..7f0ee7e --- /dev/null +++ b/frontend/src/hooks/index.ts @@ -0,0 +1,10 @@ +/** + * Central export for all custom hooks. + */ + +export { useSnapshot } from './useSnapshot'; +export { usePlayer } from './usePlayer'; +export { usePresentCharacters } from './usePresentCharacters'; +export { useLocation } from './useLocation'; +export { useTimeInfo } from './useTimeInfo'; +export { useToast } from './useToast'; diff --git a/frontend/src/hooks/useKeyboardShortcuts.ts b/frontend/src/hooks/useKeyboardShortcuts.ts new file mode 100644 index 0000000..7c19ccd --- /dev/null +++ b/frontend/src/hooks/useKeyboardShortcuts.ts @@ -0,0 +1,68 @@ +/** + * Custom hook for keyboard shortcuts. + */ + +import { useEffect } from 'react'; + +type KeyHandler = (event: KeyboardEvent) => void; + +interface ShortcutConfig { + key: string; + ctrl?: boolean; + shift?: boolean; + alt?: boolean; + meta?: boolean; + handler: KeyHandler; + description?: string; +} + +export const useKeyboardShortcut = (config: ShortcutConfig) => { + useEffect(() => { + const handleKeyDown = (event: KeyboardEvent) => { + const { key, ctrl = false, shift = false, alt = false, meta = false, handler } = config; + + // Check if all modifier keys match + if ( + event.key === key && + event.ctrlKey === ctrl && + event.shiftKey === shift && + event.altKey === alt && + event.metaKey === meta + ) { + event.preventDefault(); + handler(event); + } + }; + + window.addEventListener('keydown', handleKeyDown); + return () => window.removeEventListener('keydown', handleKeyDown); + }, [config]); +}; + +/** + * Hook for multiple keyboard shortcuts. + */ +export const useKeyboardShortcuts = (configs: ShortcutConfig[]) => { + useEffect(() => { + const handleKeyDown = (event: KeyboardEvent) => { + for (const config of configs) { + const { key, ctrl = false, shift = false, alt = false, meta = false, handler } = config; + + if ( + event.key === key && + event.ctrlKey === ctrl && + event.shiftKey === shift && + event.altKey === alt && + event.metaKey === meta + ) { + event.preventDefault(); + handler(event); + return; + } + } + }; + + window.addEventListener('keydown', handleKeyDown); + return () => window.removeEventListener('keydown', handleKeyDown); + }, [configs]); +}; diff --git a/frontend/src/hooks/useLocation.ts b/frontend/src/hooks/useLocation.ts new file mode 100644 index 0000000..043e09a --- /dev/null +++ b/frontend/src/hooks/useLocation.ts @@ -0,0 +1,15 @@ +/** + * Hook for accessing current location data from snapshot. + */ + +import { useSnapshot } from './useSnapshot'; +import type { SnapshotLocation } from '../services/gameApi'; + +/** + * Returns the current location with exits, privacy, and shop info. + * Returns null if location is unavailable. + */ +export const useLocation = (): SnapshotLocation | null => { + const snapshot = useSnapshot(); + return snapshot?.location ?? null; +}; diff --git a/frontend/src/hooks/usePlayer.ts b/frontend/src/hooks/usePlayer.ts new file mode 100644 index 0000000..45c26f0 --- /dev/null +++ b/frontend/src/hooks/usePlayer.ts @@ -0,0 +1,15 @@ +/** + * Hook for accessing player data from snapshot. + */ + +import { useSnapshot } from './useSnapshot'; +import type { SnapshotCharacter } from '../services/gameApi'; + +/** + * Returns the player character from snapshot. + * Includes meters, inventory, clothing state, and appearance. + */ +export const usePlayer = (): (SnapshotCharacter & { inventory: Record }) | null => { + const snapshot = useSnapshot(); + return snapshot?.player ?? null; +}; diff --git a/frontend/src/hooks/usePresentCharacters.ts b/frontend/src/hooks/usePresentCharacters.ts new file mode 100644 index 0000000..42fc6df --- /dev/null +++ b/frontend/src/hooks/usePresentCharacters.ts @@ -0,0 +1,15 @@ +/** + * Hook for accessing present NPCs from snapshot. + */ + +import { useSnapshot } from './useSnapshot'; +import type { SnapshotCharacter } from '../services/gameApi'; + +/** + * Returns array of present NPCs (excludes player). + * Returns empty array if no characters are present. + */ +export const usePresentCharacters = (): SnapshotCharacter[] => { + const snapshot = useSnapshot(); + return snapshot?.characters ?? []; +}; diff --git a/frontend/src/hooks/useSnapshot.ts b/frontend/src/hooks/useSnapshot.ts new file mode 100644 index 0000000..a5ff21e --- /dev/null +++ b/frontend/src/hooks/useSnapshot.ts @@ -0,0 +1,16 @@ +/** + * Base hook for accessing game state snapshot. + * All other snapshot hooks should use this as the foundation. + */ + +import { useGameStore } from '../stores/gameStore'; +import type { StateSnapshot } from '../services/gameApi'; + +/** + * Returns the current game state snapshot. + * Returns null if no game is active or snapshot is unavailable. + */ +export const useSnapshot = (): StateSnapshot | null => { + const gameState = useGameStore(state => state.gameState); + return gameState?.snapshot ?? null; +}; diff --git a/frontend/src/hooks/useTimeInfo.ts b/frontend/src/hooks/useTimeInfo.ts new file mode 100644 index 0000000..522ed18 --- /dev/null +++ b/frontend/src/hooks/useTimeInfo.ts @@ -0,0 +1,15 @@ +/** + * Hook for accessing time information from snapshot. + */ + +import { useSnapshot } from './useSnapshot'; +import type { SnapshotTime } from '../services/gameApi'; + +/** + * Returns current time information (day, time slot, clock time, weekday). + * Returns null if time info is unavailable. + */ +export const useTimeInfo = (): SnapshotTime | null => { + const snapshot = useSnapshot(); + return snapshot?.time ?? null; +}; diff --git a/frontend/src/hooks/useToast.ts b/frontend/src/hooks/useToast.ts new file mode 100644 index 0000000..87b2464 --- /dev/null +++ b/frontend/src/hooks/useToast.ts @@ -0,0 +1,66 @@ +/** + * Toast notification system for user feedback. + */ + +import { create } from 'zustand'; + +export interface Toast { + id: string; + message: string; + type: 'success' | 'error' | 'info' | 'warning'; + duration?: number; +} + +interface ToastState { + toasts: Toast[]; + addToast: (message: string, type: Toast['type'], duration?: number) => void; + removeToast: (id: string) => void; + success: (message: string, duration?: number) => void; + error: (message: string, duration?: number) => void; + info: (message: string, duration?: number) => void; + warning: (message: string, duration?: number) => void; +} + +export const useToast = create((set) => ({ + toasts: [], + + addToast: (message, type, duration = 3000) => { + const id = `${Date.now()}-${Math.random()}`; + const toast: Toast = { id, message, type, duration }; + + set((state) => ({ + toasts: [...state.toasts, toast], + })); + + // Auto-remove after duration + if (duration > 0) { + setTimeout(() => { + set((state) => ({ + toasts: state.toasts.filter((t) => t.id !== id), + })); + }, duration); + } + }, + + removeToast: (id) => { + set((state) => ({ + toasts: state.toasts.filter((t) => t.id !== id), + })); + }, + + success: (message, duration) => { + useToast.getState().addToast(message, 'success', duration); + }, + + error: (message, duration) => { + useToast.getState().addToast(message, 'error', duration); + }, + + info: (message, duration) => { + useToast.getState().addToast(message, 'info', duration); + }, + + warning: (message, duration) => { + useToast.getState().addToast(message, 'warning', duration); + }, +})); diff --git a/frontend/src/index.css b/frontend/src/index.css index 0908a78..fa3f1c8 100644 --- a/frontend/src/index.css +++ b/frontend/src/index.css @@ -54,6 +54,64 @@ body { animation: fadeIn 0.5s ease-out; } +@keyframes slideInRight { + from { + opacity: 0; + transform: translateX(100%); + } + to { + opacity: 1; + transform: translateX(0); + } +} + +.animate-slide-in-right { + animation: slideInRight 0.3s ease-out; +} + +@keyframes fadeInUp { + from { + opacity: 0; + transform: translateY(20px); + } + to { + opacity: 1; + transform: translateY(0); + } +} + +.animate-fade-in-up { + animation: fadeInUp 0.4s ease-out; +} + +@keyframes pulse { + 0%, 100% { + opacity: 1; + } + 50% { + opacity: 0.7; + } +} + +.animate-pulse-slow { + animation: pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite; +} + +@keyframes shimmer { + 0% { + background-position: -200% 0; + } + 100% { + background-position: 200% 0; + } +} + +.animate-shimmer { + background: linear-gradient(90deg, transparent 0%, rgba(255,255,255,0.1) 50%, transparent 100%); + background-size: 200% 100%; + animation: shimmer 2s linear infinite; +} + /* Custom utilities */ .text-shadow { text-shadow: 0 2px 4px rgba(0,0,0,0.5); diff --git a/frontend/src/services/gameApi.ts b/frontend/src/services/gameApi.ts index f042e88..90ad4c0 100644 --- a/frontend/src/services/gameApi.ts +++ b/frontend/src/services/gameApi.ts @@ -1,26 +1,7 @@ -// frontend/src/services/gameApi.ts import axios from 'axios'; const API_BASE = '/api'; -// Add request interceptor for debugging -axios.interceptors.request.use(request => { - console.log('Making request to:', request.url, 'with data:', request.data); - return request; -}); - -// Add a response interceptor for debugging -axios.interceptors.response.use( - response => { - console.log('Response received:', response); - return response; - }, - error => { - console.error('Request failed:', error.response?.status, error.response?.data); - return Promise.reject(error); - } -); - export interface GameInfo { id: string; title: string; @@ -33,6 +14,8 @@ export interface GameChoice { id: string; text: string; type: string; + disabled?: boolean; + skip_ai?: boolean; } export interface Meter { @@ -50,12 +33,9 @@ export interface Flag { export interface Modifier { id: string; - description: string | null; - appearance?: { - cheeks?: string; - eyes?: string; - posture?: string; - } + description?: string | null; + appearance?: Record; + [key: string]: unknown; } export interface Item { @@ -64,7 +44,10 @@ export interface Item { description: string | null; icon: string | null; stackable: boolean; - effects_on_use: any[] | null; + droppable?: boolean; + consumable?: boolean; + on_use?: unknown[] | null; + effects_on_use?: unknown[] | null; } export interface CharacterDetails { @@ -79,19 +62,77 @@ export interface PlayerDetails { wearing: string | null; } +export interface SnapshotExit { + direction: string | null; + to: string | null; + name: string; + available: boolean; + locked: boolean; + description: string | null; +} + +export interface SnapshotLocation { + id: string | null; + name: string; + zone: string | null; + privacy: string | null; + summary?: string | null; + description?: string | null; + has_shop: boolean; + exits: SnapshotExit[]; +} + +export interface SnapshotTime { + day: number | null; + slot: string | null; + time_hhmm?: string | null; + weekday?: string | null; +} + +export interface SnapshotCharacter { + id: string; + name?: string; + pronouns?: string[] | null; + attire?: string | Record | null; + meters: Record; + modifiers: Modifier[]; + wardrobe_state?: Record | null>; +} + +export interface StateSnapshot { + time: SnapshotTime; + location: SnapshotLocation; + player: SnapshotCharacter & { + inventory: Record; + }; + characters: SnapshotCharacter[]; +} + +export interface EconomyInfo { + currency: string; + symbol: string; + player_money: number | null; + max_money: number | null; +} + export interface GameState { day: number; - time: string; - time_hhmm?: string; + time: string | null; + time_hhmm?: string | null; location: string; + location_id: string | null; + zone: string | null; present_characters: string[]; character_details: Record; player_details: PlayerDetails; meters: Record>; inventory: Record; - inventory_details: Record; // <-- The missing field + inventory_details: Record; flags: Record; modifiers: Record; + turn_count?: number; + snapshot?: StateSnapshot; + economy?: EconomyInfo; } export interface GameResponse { @@ -101,6 +142,33 @@ export interface GameResponse { state_summary: GameState; time_advanced: boolean; location_changed: boolean; + action_summary?: string | null; +} + +export interface DeterministicActionResponse { + session_id: string; + success: boolean; + message: string; + state_summary: GameState; + action_summary?: string | null; + details?: Record; +} + +export interface MovementRequest { + destination_id?: string | null; + zone_id?: string | null; + direction?: string | null; + companions?: string[]; +} + +export interface InventoryTransferRequest { + item_id: string; + count?: number; + owner_id?: string; + target_id?: string; + seller_id?: string; + buyer_id?: string; + price?: number; } export interface LogResponse { @@ -108,6 +176,11 @@ export interface LogResponse { size: number; } +export interface DebugStateResponse { + state: Record; + history: string[]; +} + class GameAPI { async listGames(): Promise { const response = await axios.get(`${API_BASE}/game/list`); @@ -125,19 +198,76 @@ class GameAPI { actionText: string | null, target?: string | null, choiceId?: string | null, - itemId?: string | null + itemId?: string | null, + options?: { skipAi?: boolean } ): Promise { const response = await axios.post(`${API_BASE}/game/action/${sessionId}`, { action_type: actionType, action_text: actionText, - target: target, + target, choice_id: choiceId, item_id: itemId, + skip_ai: options?.skipAi ?? false, + }); + return response.data; + } + + async move(sessionId: string, payload: MovementRequest): Promise { + const response = await axios.post(`${API_BASE}/game/move/${sessionId}`, payload); + return response.data; + } + + async purchase(sessionId: string, itemId: string, count = 1, price?: number, sellerId?: string): Promise { + const response = await axios.post(`${API_BASE}/game/shop/${sessionId}/purchase`, { + buyer_id: 'player', + seller_id: sellerId, + item_id: itemId, + count, + price, + }); + return response.data; + } + + async sell(sessionId: string, itemId: string, count = 1, price?: number, buyerId?: string): Promise { + const response = await axios.post(`${API_BASE}/game/shop/${sessionId}/sell`, { + seller_id: 'player', + buyer_id: buyerId, + item_id: itemId, + count, + price, + }); + return response.data; + } + + async takeItem(sessionId: string, itemId: string, count = 1, ownerId = 'player'): Promise { + const response = await axios.post(`${API_BASE}/game/inventory/${sessionId}/take`, { + owner_id: ownerId, + item_id: itemId, + count, + }); + return response.data; + } + + async dropItem(sessionId: string, itemId: string, count = 1, ownerId = 'player'): Promise { + const response = await axios.post(`${API_BASE}/game/inventory/${sessionId}/drop`, { + owner_id: ownerId, + item_id: itemId, + count, + }); + return response.data; + } + + async giveItem(sessionId: string, itemId: string, targetId: string, count = 1, sourceId = 'player'): Promise { + const response = await axios.post(`${API_BASE}/game/inventory/${sessionId}/give`, { + source_id: sourceId, + target_id: targetId, + item_id: itemId, + count, }); return response.data; } - async getState(sessionId: string): Promise { + async getState(sessionId: string): Promise { const response = await axios.get(`${API_BASE}/game/session/${sessionId}/state`); return response.data; } @@ -148,4 +278,4 @@ class GameAPI { } } -export const gameApi = new GameAPI(); \ No newline at end of file +export const gameApi = new GameAPI(); diff --git a/frontend/src/stores/gameStore.ts b/frontend/src/stores/gameStore.ts index e1018bb..d814bf2 100644 --- a/frontend/src/stores/gameStore.ts +++ b/frontend/src/stores/gameStore.ts @@ -1,76 +1,156 @@ -// frontend/src/stores/gameStore.ts import { create } from 'zustand'; -import { gameApi, GameInfo, GameResponse, GameChoice, GameState } from '../services/gameApi'; +import { + gameApi, + GameChoice, + GameInfo, + GameState, + DeterministicActionResponse, + MovementRequest, +} from '../services/gameApi'; +import { saveSession, clearSession, loadSession, hasStoredSession } from '../utils/storage'; +import { useToast } from '../hooks/useToast'; + +const DEFAULT_SUMMARY = 'Action resolved.'; + +export type TurnOrigin = 'ai' | 'deterministic'; + +export interface TurnLogEntry { + id: number; + summary: string; + narrative: string; + origin: TurnOrigin; + timestamp: string; +} interface GameStore { - // State games: GameInfo[]; currentGame: GameInfo | null; sessionId: string | null; - narrative: string[]; + turnLog: TurnLogEntry[]; choices: GameChoice[]; gameState: GameState | null; loading: boolean; error: string | null; - turnCounter: number; // New state to track turns + turnCounter: number; - // Actions loadGames: () => Promise; startGame: (gameId: string) => Promise; - sendAction: (actionType: string, actionText: string | null, target?: string | null, choiceId?: string | null, itemId?: string | null) => Promise; + sendAction: ( + actionType: string, + actionText: string | null, + target?: string | null, + choiceId?: string | null, + itemId?: string | null, + options?: { skipAi?: boolean } + ) => Promise; + performMovement: (choiceId: string) => Promise; + purchaseItem: (itemId: string, count?: number, price?: number, sellerId?: string) => Promise; + sellItem: (itemId: string, count?: number, price?: number, buyerId?: string) => Promise; + takeItem: (itemId: string, count?: number, ownerId?: string) => Promise; + dropItem: (itemId: string, count?: number, ownerId?: string) => Promise; + giveItem: (itemId: string, targetId: string, count?: number, sourceId?: string) => Promise; + deterministicActionsEnabled: boolean; + setDeterministicActionsEnabled: (value: boolean) => void; + clearTurnLog: () => void; resetGame: () => void; + hasStoredSession: () => boolean; + restoreSession: () => Promise; } +const buildTurnEntry = ( + turnId: number, + origin: TurnOrigin, + summary?: string | null, + narrative?: string | null +): TurnLogEntry => { + const safeSummary = summary && summary.trim().length > 0 ? summary.trim() : DEFAULT_SUMMARY; + const safeNarrative = + narrative && narrative.trim().length > 0 ? narrative : safeSummary; + return { + id: turnId, + summary: safeSummary, + narrative: safeNarrative, + origin, + timestamp: new Date().toISOString(), + }; +}; + +const extractChoicesFromDetails = (details?: Record): GameChoice[] | undefined => { + if (!details) return undefined; + if (Array.isArray(details.choices)) { + return details.choices as GameChoice[]; + } + return undefined; +}; + export const useGameStore = create((set, get) => ({ - // Initial state games: [], currentGame: null, sessionId: null, - narrative: [], + turnLog: [], choices: [], gameState: null, loading: false, error: null, - turnCounter: 0, // Initialize counter + turnCounter: 0, + deterministicActionsEnabled: true, - // Load available games loadGames: async () => { set({ loading: true, error: null }); try { const games = await gameApi.listGames(); set({ games, loading: false }); } catch (error) { - set({ error: 'Failed to load games', loading: false }); + console.error(error); + const errorMsg = 'Failed to load games'; + useToast.getState().error(errorMsg); + set({ error: errorMsg, loading: false }); } }, - // Start a new game startGame: async (gameId: string) => { set({ loading: true, error: null }); try { const response = await gameApi.startGame(gameId); - const game = get().games.find(g => g.id === gameId); + const game = get().games.find(g => g.id === gameId) ?? null; + const firstTurn = buildTurnEntry( + 1, + 'ai', + response.action_summary, + response.narrative + ); + set({ - currentGame: game || null, + currentGame: game, sessionId: response.session_id, - narrative: [response.narrative], + turnLog: [firstTurn], choices: response.choices, gameState: response.state_summary, loading: false, - turnCounter: 1, // Set to 1 on game start + turnCounter: 1, }); + + // Persist session to localStorage + if (game) { + saveSession(response.session_id, gameId, game.title); + } + + useToast.getState().success('Game started successfully!'); } catch (error) { - set({ error: 'Failed to start game', loading: false }); + console.error(error); + const errorMsg = 'Failed to start game'; + useToast.getState().error(errorMsg); + set({ error: errorMsg, loading: false }); } }, - // Send player action sendAction: async ( - actionType: string, - actionText: string | null, - target?: string | null, - choiceId?: string | null, - itemId?: string | null + actionType, + actionText, + target, + choiceId, + itemId, + options ) => { const sessionId = get().sessionId; if (!sessionId) return; @@ -83,29 +163,275 @@ export const useGameStore = create((set, get) => ({ actionText, target, choiceId, - itemId + itemId, + options ); - set((state) => ({ - narrative: [...state.narrative, response.narrative], - choices: response.choices, - gameState: response.state_summary, + + set(state => { + const nextTurn = state.turnCounter + 1; + const origin: TurnOrigin = options?.skipAi ? 'deterministic' : 'ai'; + const turnEntry = buildTurnEntry(nextTurn, origin, response.action_summary, response.narrative); + + return { + turnLog: [...state.turnLog, turnEntry], + choices: response.choices, + gameState: response.state_summary, + loading: false, + turnCounter: nextTurn, + }; + }); + } catch (error) { + console.error(error); + const errorMsg = 'Failed to send action'; + useToast.getState().error(errorMsg); + set({ error: errorMsg, loading: false }); + } + }, + + performMovement: async (choiceId: string) => { + const sessionId = get().sessionId; + if (!sessionId) return; + + const payload: MovementRequest = {}; + if (choiceId.startsWith('move_')) { + payload.destination_id = choiceId.substring(5); + } else if (choiceId.startsWith('travel_')) { + payload.zone_id = choiceId.substring(7); + } else if (choiceId.startsWith('direction_')) { + payload.direction = choiceId.substring(10); + } + + // If we couldn't derive a deterministic payload, fall back to generic action + if (!payload.destination_id && !payload.zone_id && !payload.direction) { + const choice = get().choices.find(c => c.id === choiceId); + const text = choice?.text ?? ''; + await get().sendAction('choice', text, null, choiceId, undefined, { skipAi: get().deterministicActionsEnabled }); + return; + } + + // Optimistic update: Add loading turn entry immediately + const nextTurn = get().turnCounter + 1; + const destination = payload.destination_id || payload.zone_id || payload.direction || 'new location'; + const optimisticEntry = buildTurnEntry(nextTurn, 'deterministic', 'Moving...', `Moving to ${destination}...`); + + set(state => ({ + turnLog: [...state.turnLog, optimisticEntry], + loading: true, + error: null, + })); + + try { + const response = await gameApi.move(sessionId, payload); + + set(state => { + const turnEntry = buildTurnEntry(nextTurn, 'deterministic', response.action_summary, response.message); + const updatedChoices = extractChoicesFromDetails(response.details) ?? state.choices; + + return { + turnLog: [...state.turnLog.slice(0, -1), turnEntry], // Replace optimistic entry + choices: updatedChoices, + gameState: response.state_summary, + loading: false, + turnCounter: nextTurn, + }; + }); + + useToast.getState().success('Movement successful!'); + } catch (error) { + console.error(error); + const errorMsg = 'Failed to move'; + useToast.getState().error(errorMsg); + // Revert optimistic update on error + set(state => ({ + turnLog: state.turnLog.slice(0, -1), + error: errorMsg, loading: false, - turnCounter: state.turnCounter + 1, // Increment on each successful action })); + } + }, + + purchaseItem: async (itemId, count = 1, price, sellerId) => { + const sessionId = get().sessionId; + if (!sessionId) return; + + set({ loading: true, error: null }); + try { + const response = await gameApi.purchase(sessionId, itemId, count, price, sellerId); + set(state => { + const nextTurn = state.turnCounter + 1; + const turnEntry = buildTurnEntry(nextTurn, 'deterministic', response.action_summary, response.message); + + return { + turnLog: [...state.turnLog, turnEntry], + gameState: response.state_summary, + choices: extractChoicesFromDetails(response.details) ?? state.choices, + loading: false, + turnCounter: nextTurn, + }; + }); } catch (error) { - set({ error: 'Failed to send action', loading: false }); + console.error(error); + set({ error: 'Purchase failed', loading: false }); } }, - // Reset game + sellItem: async (itemId, count = 1, price, buyerId) => { + const sessionId = get().sessionId; + if (!sessionId) return; + + set({ loading: true, error: null }); + try { + const response = await gameApi.sell(sessionId, itemId, count, price, buyerId); + set(state => { + const nextTurn = state.turnCounter + 1; + const turnEntry = buildTurnEntry(nextTurn, 'deterministic', response.action_summary, response.message); + + return { + turnLog: [...state.turnLog, turnEntry], + gameState: response.state_summary, + choices: extractChoicesFromDetails(response.details) ?? state.choices, + loading: false, + turnCounter: nextTurn, + }; + }); + } catch (error) { + console.error(error); + set({ error: 'Sale failed', loading: false }); + } + }, + + takeItem: async (itemId, count = 1, ownerId = 'player') => { + const sessionId = get().sessionId; + if (!sessionId) return; + + set({ loading: true, error: null }); + try { + const response = await gameApi.takeItem(sessionId, itemId, count, ownerId); + set((state: GameStore) => createDeterministicUpdate(state, response)); + } catch (error) { + console.error(error); + set({ error: 'Failed to take item', loading: false }); + } + }, + + dropItem: async (itemId, count = 1, ownerId = 'player') => { + const sessionId = get().sessionId; + if (!sessionId) return; + + set({ loading: true, error: null }); + try { + const response = await gameApi.dropItem(sessionId, itemId, count, ownerId); + set((state: GameStore) => createDeterministicUpdate(state, response)); + } catch (error) { + console.error(error); + set({ error: 'Failed to drop item', loading: false }); + } + }, + + giveItem: async (itemId, targetId, count = 1, sourceId = 'player') => { + const sessionId = get().sessionId; + if (!sessionId) return; + + set({ loading: true, error: null }); + try { + const response = await gameApi.giveItem(sessionId, itemId, targetId, count, sourceId); + set((state: GameStore) => createDeterministicUpdate(state, response)); + } catch (error) { + console.error(error); + set({ error: 'Failed to give item', loading: false }); + } + }, + + + setDeterministicActionsEnabled: (value: boolean) => { + set({ deterministicActionsEnabled: value }); + }, + + clearTurnLog: () => { + set(state => ({ turnLog: state.turnLog.slice(-10) })); + }, + resetGame: () => { + // Clear localStorage session + clearSession(); + set({ currentGame: null, sessionId: null, - narrative: [], + turnLog: [], choices: [], gameState: null, - turnCounter: 0, // Reset counter + turnCounter: 0, }); }, -})); \ No newline at end of file + + hasStoredSession: () => { + return hasStoredSession(); + }, + + restoreSession: async () => { + const stored = loadSession(); + if (!stored) { + set({ error: 'No saved session found' }); + return; + } + + set({ loading: true, error: null }); + try { + // Fetch current state from backend + const stateResponse = await gameApi.getState(stored.sessionId); + + // Find the game info + const games = get().games; + if (games.length === 0) { + await get().loadGames(); + } + const game = get().games.find(g => g.id === stored.gameId) ?? { + id: stored.gameId, + title: stored.gameTitle, + author: 'Unknown', + content_rating: 'Unknown', + version: '1.0', + }; + + // Extract last few turns from history to build turn log + const history = stateResponse.history || []; + const turnLog: TurnLogEntry[] = history.map((narrative, index) => ({ + id: index + 1, + summary: `Turn ${index + 1}`, + narrative, + origin: 'ai' as TurnOrigin, + timestamp: new Date().toLocaleTimeString(), + })); + + // For now, we'll need to make a dummy action call to get current choices + // This is a limitation - we can't restore choices without the backend tracking them + set({ + currentGame: game, + sessionId: stored.sessionId, + turnLog: turnLog.length > 0 ? turnLog : [], + choices: [], // Will be populated on next action + gameState: stateResponse.state as GameState, + loading: false, + turnCounter: turnLog.length, + }); + } catch (error) { + console.error('Failed to restore session:', error); + clearSession(); + set({ error: 'Failed to restore session', loading: false }); + } + }, +})); + +const createDeterministicUpdate = (state: GameStore, response: DeterministicActionResponse) => { + const nextTurn = state.turnCounter + 1; + const turnEntry = buildTurnEntry(nextTurn, 'deterministic', response.action_summary, response.message); + + return { + turnLog: [...state.turnLog, turnEntry], + gameState: response.state_summary, + choices: extractChoicesFromDetails(response.details) ?? state.choices, + loading: false, + turnCounter: nextTurn, + }; +}; diff --git a/frontend/src/tests/ChoicePanel.test.tsx b/frontend/src/tests/ChoicePanel.test.tsx new file mode 100644 index 0000000..440ba36 --- /dev/null +++ b/frontend/src/tests/ChoicePanel.test.tsx @@ -0,0 +1,230 @@ +/** + * Tests for ChoicePanel component. + */ + +import { screen, fireEvent, waitFor } from '@testing-library/react'; +import { ChoicePanel } from '../components/ChoicePanel'; +import { useGameStore } from '../stores/gameStore'; +import { renderWithProviders, setupGameStore, resetGameStore, createMockChoices } from './testUtils'; + +describe('ChoicePanel', () => { + beforeEach(() => { + resetGameStore(); + setupGameStore(); + }); + + describe('Action Mode Toggle', () => { + it('renders say and do mode buttons', () => { + const choices = createMockChoices(); + renderWithProviders(); + + expect(screen.getByText('Say')).toBeInTheDocument(); + expect(screen.getByText('Do')).toBeInTheDocument(); + }); + + it('starts in say mode by default', () => { + const choices = createMockChoices(); + renderWithProviders(); + + const input = screen.getByPlaceholderText(/Say to/i); + expect(input).toBeInTheDocument(); + }); + + it('switches to do mode when do button clicked', () => { + const choices = createMockChoices(); + renderWithProviders(); + + const doButton = screen.getByText('Do'); + fireEvent.click(doButton); + + const input = screen.getByPlaceholderText(/What do you want to do/i); + expect(input).toBeInTheDocument(); + }); + }); + + describe('Input Field', () => { + it('allows text input', () => { + const choices = createMockChoices(); + renderWithProviders(); + + const input = screen.getByPlaceholderText(/Say to/i) as HTMLInputElement; + fireEvent.change(input, { target: { value: 'Hello there' } }); + + expect(input.value).toBe('Hello there'); + }); + + it('disables input when loading', () => { + useGameStore.setState({ loading: true }); + const choices = createMockChoices(); + renderWithProviders(); + + const input = screen.getByPlaceholderText(/Say to/i); + expect(input).toBeDisabled(); + }); + }); + + describe('Submit Button', () => { + it('is disabled when input is empty', () => { + const choices = createMockChoices(); + renderWithProviders(); + + const submitButton = screen.getByRole('button', { name: /submit/i }); + expect(submitButton).toBeDisabled(); + }); + + it('is enabled when input has text', () => { + const choices = createMockChoices(); + renderWithProviders(); + + const input = screen.getByPlaceholderText(/Say to/i); + fireEvent.change(input, { target: { value: 'Hello' } }); + + const submitButton = screen.getByRole('button', { name: /submit/i }); + expect(submitButton).not.toBeDisabled(); + }); + + it('is disabled during loading', () => { + useGameStore.setState({ loading: true }); + const choices = createMockChoices(); + renderWithProviders(); + + const input = screen.getByPlaceholderText(/Say to/i); + fireEvent.change(input, { target: { value: 'Hello' } }); + + const submitButton = screen.getByRole('button', { name: /submit/i }); + expect(submitButton).toBeDisabled(); + }); + }); + + describe('Form Submission', () => { + it('calls sendAction with correct parameters in say mode', async () => { + const sendActionMock = jest.fn(); + useGameStore.setState({ sendAction: sendActionMock }); + + const choices = createMockChoices(); + renderWithProviders(); + + const input = screen.getByPlaceholderText(/Say to/i); + fireEvent.change(input, { target: { value: 'Hello there' } }); + + const form = input.closest('form'); + fireEvent.submit(form!); + + await waitFor(() => { + expect(sendActionMock).toHaveBeenCalledWith( + 'choice', + 'Hello there', + null, + 'custom_say' + ); + }); + }); + + it('calls sendAction with correct parameters in do mode', async () => { + const sendActionMock = jest.fn(); + useGameStore.setState({ sendAction: sendActionMock }); + + const choices = createMockChoices(); + renderWithProviders(); + + // Switch to do mode + const doButton = screen.getByText('Do'); + fireEvent.click(doButton); + + const input = screen.getByPlaceholderText(/What do you want to do/i); + fireEvent.change(input, { target: { value: 'Pick up the book' } }); + + const form = input.closest('form'); + fireEvent.submit(form!); + + await waitFor(() => { + expect(sendActionMock).toHaveBeenCalledWith( + 'choice', + 'Pick up the book', + null, + 'custom_do' + ); + }); + }); + + it('clears input after submission', async () => { + const sendActionMock = jest.fn(); + useGameStore.setState({ sendAction: sendActionMock }); + + const choices = createMockChoices(); + renderWithProviders(); + + const input = screen.getByPlaceholderText(/Say to/i) as HTMLInputElement; + fireEvent.change(input, { target: { value: 'Hello' } }); + + const form = input.closest('form'); + fireEvent.submit(form!); + + await waitFor(() => { + expect(input.value).toBe(''); + }); + }); + }); + + describe('Quick Actions', () => { + it('renders node choices when available', () => { + const choices = [ + { id: 'choice1', text: 'Greet Emma', type: 'node_choice' }, + { id: 'choice2', text: 'Leave', type: 'node_choice' }, + ]; + renderWithProviders(); + + expect(screen.getByText('Greet Emma')).toBeInTheDocument(); + expect(screen.getByText('Leave')).toBeInTheDocument(); + }); + + it('does not render disabled choices', () => { + const choices = [ + { id: 'choice1', text: 'Available', type: 'node_choice', disabled: false }, + { id: 'choice2', text: 'Disabled', type: 'node_choice', disabled: true }, + ]; + renderWithProviders(); + + expect(screen.getByText('Available')).toBeInTheDocument(); + expect(screen.queryByText('Disabled')).not.toBeInTheDocument(); + }); + + it('calls appropriate action when quick action clicked', async () => { + const sendActionMock = jest.fn(); + useGameStore.setState({ sendAction: sendActionMock }); + + const choices = [ + { id: 'choice1', text: 'Say hello', type: 'node_choice' }, + ]; + renderWithProviders(); + + const choiceButton = screen.getByText('Say hello'); + fireEvent.click(choiceButton); + + await waitFor(() => { + expect(sendActionMock).toHaveBeenCalled(); + }); + }); + }); + + describe('Present Characters', () => { + it('shows character selector in say mode', () => { + const choices = createMockChoices(); + renderWithProviders(); + + // Should show "Everyone" by default + expect(screen.getByText('Everyone')).toBeInTheDocument(); + }); + + it('does not show character selector in do mode', () => { + const choices = createMockChoices(); + renderWithProviders(); + + const doButton = screen.getByText('Do'); + fireEvent.click(doButton); + + // Character selector should not be visible in do mode + expect(screen.queryByText('Everyone')).not.toBeInTheDocument(); + }); + }); +}); diff --git a/frontend/src/tests/hooks.test.ts b/frontend/src/tests/hooks.test.ts new file mode 100644 index 0000000..297f898 --- /dev/null +++ b/frontend/src/tests/hooks.test.ts @@ -0,0 +1,166 @@ +/** + * Tests for custom hooks. + */ + +import { renderHook } from '@testing-library/react'; +import { useSnapshot, usePlayer, usePresentCharacters, useLocation, useTimeInfo } from '../hooks'; +import { setupGameStore, resetGameStore, createMockGameState } from './testUtils'; + +describe('Custom Hooks', () => { + beforeEach(() => { + resetGameStore(); + }); + + describe('useSnapshot', () => { + it('returns null when no game state exists', () => { + const { result } = renderHook(() => useSnapshot()); + expect(result.current).toBeNull(); + }); + + it('returns snapshot when game state exists', () => { + const mockState = createMockGameState(); + setupGameStore({ gameState: mockState }); + + const { result } = renderHook(() => useSnapshot()); + expect(result.current).toBe(mockState.snapshot); + }); + + it('returns null when snapshot is undefined', () => { + const mockState = createMockGameState({ snapshot: undefined }); + setupGameStore({ gameState: mockState }); + + const { result } = renderHook(() => useSnapshot()); + expect(result.current).toBeNull(); + }); + }); + + describe('usePlayer', () => { + it('returns null when no snapshot exists', () => { + const { result } = renderHook(() => usePlayer()); + expect(result.current).toBeNull(); + }); + + it('returns player data from snapshot', () => { + const mockState = createMockGameState(); + setupGameStore({ gameState: mockState }); + + const { result } = renderHook(() => usePlayer()); + expect(result.current).toBeDefined(); + expect(result.current?.id).toBe('player'); + expect(result.current?.name).toBe('You'); + }); + + it('includes player inventory', () => { + const mockState = createMockGameState(); + setupGameStore({ gameState: mockState }); + + const { result } = renderHook(() => usePlayer()); + expect(result.current?.inventory).toBeDefined(); + expect(result.current?.inventory.item1).toBe(2); + }); + + it('includes player meters', () => { + const mockState = createMockGameState(); + setupGameStore({ gameState: mockState }); + + const { result } = renderHook(() => usePlayer()); + expect(result.current?.meters).toBeDefined(); + expect(result.current?.meters.energy).toBeDefined(); + expect(result.current?.meters.energy.value).toBe(80); + }); + }); + + describe('usePresentCharacters', () => { + it('returns empty array when no snapshot exists', () => { + const { result } = renderHook(() => usePresentCharacters()); + expect(result.current).toEqual([]); + }); + + it('returns present characters from snapshot', () => { + const mockState = createMockGameState(); + setupGameStore({ gameState: mockState }); + + const { result } = renderHook(() => usePresentCharacters()); + expect(result.current).toHaveLength(1); + expect(result.current[0].id).toBe('npc1'); + expect(result.current[0].name).toBe('Test NPC'); + }); + + it('does not include player in the list', () => { + const mockState = createMockGameState(); + setupGameStore({ gameState: mockState }); + + const { result } = renderHook(() => usePresentCharacters()); + const playerInList = result.current.some(char => char.id === 'player'); + expect(playerInList).toBe(false); + }); + }); + + describe('useLocation', () => { + it('returns null when no snapshot exists', () => { + const { result } = renderHook(() => useLocation()); + expect(result.current).toBeNull(); + }); + + it('returns location data from snapshot', () => { + const mockState = createMockGameState(); + setupGameStore({ gameState: mockState }); + + const { result } = renderHook(() => useLocation()); + expect(result.current).toBeDefined(); + expect(result.current?.id).toBe('test_location'); + expect(result.current?.name).toBe('Test Location'); + }); + + it('includes exits information', () => { + const mockState = createMockGameState(); + setupGameStore({ gameState: mockState }); + + const { result } = renderHook(() => useLocation()); + expect(result.current?.exits).toBeDefined(); + expect(result.current?.exits).toHaveLength(1); + expect(result.current?.exits[0].direction).toBe('n'); + }); + + it('includes privacy level', () => { + const mockState = createMockGameState(); + setupGameStore({ gameState: mockState }); + + const { result } = renderHook(() => useLocation()); + expect(result.current?.privacy).toBe('public'); + }); + }); + + describe('useTimeInfo', () => { + it('returns null when no snapshot exists', () => { + const { result } = renderHook(() => useTimeInfo()); + expect(result.current).toBeNull(); + }); + + it('returns time data from snapshot', () => { + const mockState = createMockGameState(); + setupGameStore({ gameState: mockState }); + + const { result } = renderHook(() => useTimeInfo()); + expect(result.current).toBeDefined(); + expect(result.current?.day).toBe(1); + expect(result.current?.slot).toBe('morning'); + }); + + it('includes clock time when available', () => { + const mockState = createMockGameState(); + setupGameStore({ gameState: mockState }); + + const { result } = renderHook(() => useTimeInfo()); + expect(result.current?.time_hhmm).toBe('09:00'); + }); + + it('includes weekday when available', () => { + const mockState = createMockGameState(); + setupGameStore({ gameState: mockState }); + + const { result } = renderHook(() => useTimeInfo()); + expect(result.current?.weekday).toBe('monday'); + }); + }); +}); diff --git a/frontend/src/tests/movementControls.test.tsx b/frontend/src/tests/movementControls.test.tsx new file mode 100644 index 0000000..f9e02de --- /dev/null +++ b/frontend/src/tests/movementControls.test.tsx @@ -0,0 +1,43 @@ +import { render, screen, fireEvent } from '@testing-library/react'; +import { MovementControls } from '../components/MovementControls'; +import { useGameStore } from '../stores/gameStore'; + +jest.mock('../stores/gameStore'); + +const mockedStore = useGameStore as jest.MockedFunction & { + getState?: () => any; +}; + +const mockState = { + gameState: { + snapshot: { + location: { + exits: [ + { direction: 'n', to: 'hall', name: 'Hallway', available: true, locked: false, description: null }, + ], + }, + }, + }, + performMovement: jest.fn(), +}; + +beforeEach(() => { + mockedStore.mockImplementation((selector?: any) => { + if (selector) { + return selector(mockState); + } + return mockState; + }); +}); + +afterEach(() => { + jest.clearAllMocks(); +}); + +test('renders exits and triggers movement', () => { + render(); + + const button = screen.getByRole('button', { name: /n – hallway/i }); + fireEvent.click(button); + expect(mockState.performMovement).toHaveBeenCalledWith('move_hall'); +}); diff --git a/frontend/src/tests/setup.ts b/frontend/src/tests/setup.ts new file mode 100644 index 0000000..7b0828b --- /dev/null +++ b/frontend/src/tests/setup.ts @@ -0,0 +1 @@ +import '@testing-library/jest-dom'; diff --git a/frontend/src/tests/storage.test.ts b/frontend/src/tests/storage.test.ts new file mode 100644 index 0000000..e61c739 --- /dev/null +++ b/frontend/src/tests/storage.test.ts @@ -0,0 +1,181 @@ +/** + * Tests for localStorage utilities. + */ + +import { saveSession, loadSession, clearSession, hasStoredSession } from '../utils/storage'; + +// Mock localStorage +const localStorageMock = (() => { + let store: Record = {}; + + return { + getItem: (key: string) => store[key] || null, + setItem: (key: string, value: string) => { + store[key] = value; + }, + removeItem: (key: string) => { + delete store[key]; + }, + clear: () => { + store = {}; + }, + }; +})(); + +Object.defineProperty(window, 'localStorage', { + value: localStorageMock, +}); + +describe('Storage Utilities', () => { + beforeEach(() => { + localStorageMock.clear(); + }); + + describe('saveSession', () => { + it('saves session to localStorage', () => { + saveSession('session-123', 'game-456', 'Test Game'); + + const stored = localStorageMock.getItem('plotplay_session'); + expect(stored).toBeTruthy(); + + const data = JSON.parse(stored!); + expect(data.sessionId).toBe('session-123'); + expect(data.gameId).toBe('game-456'); + expect(data.gameTitle).toBe('Test Game'); + }); + + it('includes version and timestamp', () => { + saveSession('session-123', 'game-456', 'Test Game'); + + const stored = localStorageMock.getItem('plotplay_session'); + const data = JSON.parse(stored!); + + expect(data.version).toBe(1); + expect(data.timestamp).toBeGreaterThan(0); + }); + + it('overwrites previous session', () => { + saveSession('session-1', 'game-1', 'Game 1'); + saveSession('session-2', 'game-2', 'Game 2'); + + const stored = localStorageMock.getItem('plotplay_session'); + const data = JSON.parse(stored!); + + expect(data.sessionId).toBe('session-2'); + expect(data.gameTitle).toBe('Game 2'); + }); + }); + + describe('loadSession', () => { + it('loads saved session', () => { + saveSession('session-123', 'game-456', 'Test Game'); + + const loaded = loadSession(); + expect(loaded).toBeTruthy(); + expect(loaded?.sessionId).toBe('session-123'); + expect(loaded?.gameId).toBe('game-456'); + expect(loaded?.gameTitle).toBe('Test Game'); + }); + + it('returns null when no session exists', () => { + const loaded = loadSession(); + expect(loaded).toBeNull(); + }); + + it('returns null and clears session if version mismatch', () => { + const invalidData = { + version: 99, + timestamp: Date.now(), + sessionId: 'session-123', + gameId: 'game-456', + gameTitle: 'Test Game', + }; + localStorageMock.setItem('plotplay_session', JSON.stringify(invalidData)); + + const loaded = loadSession(); + expect(loaded).toBeNull(); + + // Should clear the invalid session + const stored = localStorageMock.getItem('plotplay_session'); + expect(stored).toBeNull(); + }); + + it('returns null and clears session if too old', () => { + const oldTimestamp = Date.now() - (8 * 24 * 60 * 60 * 1000); // 8 days ago + const oldData = { + version: 1, + timestamp: oldTimestamp, + sessionId: 'session-123', + gameId: 'game-456', + gameTitle: 'Test Game', + }; + localStorageMock.setItem('plotplay_session', JSON.stringify(oldData)); + + const loaded = loadSession(); + expect(loaded).toBeNull(); + + // Should clear the old session + const stored = localStorageMock.getItem('plotplay_session'); + expect(stored).toBeNull(); + }); + + it('loads session within age limit', () => { + const recentTimestamp = Date.now() - (2 * 24 * 60 * 60 * 1000); // 2 days ago + const recentData = { + version: 1, + timestamp: recentTimestamp, + sessionId: 'session-123', + gameId: 'game-456', + gameTitle: 'Test Game', + }; + localStorageMock.setItem('plotplay_session', JSON.stringify(recentData)); + + const loaded = loadSession(); + expect(loaded).toBeTruthy(); + expect(loaded?.sessionId).toBe('session-123'); + }); + }); + + describe('clearSession', () => { + it('removes session from localStorage', () => { + saveSession('session-123', 'game-456', 'Test Game'); + + let stored = localStorageMock.getItem('plotplay_session'); + expect(stored).toBeTruthy(); + + clearSession(); + + stored = localStorageMock.getItem('plotplay_session'); + expect(stored).toBeNull(); + }); + + it('does not throw error when no session exists', () => { + expect(() => clearSession()).not.toThrow(); + }); + }); + + describe('hasStoredSession', () => { + it('returns true when valid session exists', () => { + saveSession('session-123', 'game-456', 'Test Game'); + + expect(hasStoredSession()).toBe(true); + }); + + it('returns false when no session exists', () => { + expect(hasStoredSession()).toBe(false); + }); + + it('returns false when session is invalid', () => { + const invalidData = { + version: 99, + timestamp: Date.now(), + sessionId: 'session-123', + gameId: 'game-456', + gameTitle: 'Test Game', + }; + localStorageMock.setItem('plotplay_session', JSON.stringify(invalidData)); + + expect(hasStoredSession()).toBe(false); + }); + }); +}); diff --git a/frontend/src/tests/testUtils.tsx b/frontend/src/tests/testUtils.tsx new file mode 100644 index 0000000..382023b --- /dev/null +++ b/frontend/src/tests/testUtils.tsx @@ -0,0 +1,208 @@ +/** + * Test utilities for React Testing Library with Zustand. + */ + +import { ReactElement } from 'react'; +import { render, RenderOptions } from '@testing-library/react'; +import { useGameStore } from '../stores/gameStore'; +import type { GameInfo, GameState, GameChoice } from '../services/gameApi'; + +/** + * Creates a mock game state for testing. + */ +export const createMockGameState = (overrides?: Partial): GameState => { + return { + day: 1, + time: 'morning', + location: 'test_location', + location_id: 'test_location', + zone: 'test_zone', + present_characters: ['npc1'], + character_details: { + npc1: { + name: 'Test NPC', + pronouns: ['they', 'them'], + wearing: 'casual clothes', + }, + }, + player_details: { + name: 'You', + pronouns: ['you'], + wearing: 'jeans and t-shirt', + }, + meters: { + player: { + energy: { value: 80, min: 0, max: 100, icon: '⚡', visible: true }, + money: { value: 50, min: 0, max: 1000, icon: '💰', visible: true }, + }, + npc1: { + trust: { value: 50, min: 0, max: 100, icon: '❤️', visible: true }, + }, + }, + inventory: { + item1: 2, + }, + inventory_details: { + item1: { + id: 'item1', + name: 'Test Item', + description: 'A test item', + icon: '📦', + stackable: true, + droppable: true, + }, + }, + flags: { + test_flag: { + value: true, + label: 'Test Flag', + }, + }, + modifiers: {}, + turn_count: 5, + snapshot: { + time: { + day: 1, + slot: 'morning', + time_hhmm: '09:00', + weekday: 'monday', + }, + location: { + id: 'test_location', + name: 'Test Location', + zone: 'test_zone', + privacy: 'public', + summary: 'A test location', + has_shop: false, + exits: [ + { + direction: 'n', + to: 'north_location', + name: 'North Exit', + available: true, + locked: false, + description: null, + }, + ], + }, + player: { + id: 'player', + name: 'You', + pronouns: ['you'], + attire: 'jeans and t-shirt', + meters: { + energy: { value: 80, min: 0, max: 100, icon: '⚡', visible: true }, + money: { value: 50, min: 0, max: 1000, icon: '💰', visible: true }, + }, + modifiers: [], + inventory: { + item1: 2, + }, + }, + characters: [ + { + id: 'npc1', + name: 'Test NPC', + pronouns: ['they', 'them'], + attire: 'casual clothes', + meters: { + trust: { value: 50, min: 0, max: 100, icon: '❤️', visible: true }, + }, + modifiers: [], + }, + ], + }, + ...overrides, + }; +}; + +/** + * Creates a mock game info for testing. + */ +export const createMockGameInfo = (overrides?: Partial): GameInfo => { + return { + id: 'test_game', + title: 'Test Game', + author: 'Test Author', + content_rating: 'general', + version: '1.0.0', + ...overrides, + }; +}; + +/** + * Creates mock choices for testing. + */ +export const createMockChoices = (): GameChoice[] => { + return [ + { + id: 'choice1', + text: 'Say hello', + type: 'node_choice', + }, + { + id: 'choice2', + text: 'Move north', + type: 'movement', + }, + ]; +}; + +/** + * Resets the game store to initial state. + * Useful for cleaning up between tests. + */ +export const resetGameStore = () => { + useGameStore.setState({ + games: [], + currentGame: null, + sessionId: null, + turnLog: [], + choices: [], + gameState: null, + loading: false, + error: null, + turnCounter: 0, + deterministicActionsEnabled: true, + }); +}; + +/** + * Sets up the game store with test data. + */ +export const setupGameStore = (options?: { + sessionId?: string; + currentGame?: GameInfo; + gameState?: GameState; + choices?: GameChoice[]; +}) => { + const { + sessionId = 'test-session-id', + currentGame = createMockGameInfo(), + gameState = createMockGameState(), + choices = createMockChoices(), + } = options || {}; + + useGameStore.setState({ + currentGame, + sessionId, + gameState, + choices, + loading: false, + error: null, + turnCounter: 1, + }); +}; + +/** + * Custom render function that wraps components with necessary providers. + */ +export const renderWithProviders = ( + ui: ReactElement, + options?: RenderOptions +) => { + return render(ui, { ...options }); +}; + +// Re-export everything from React Testing Library +export * from '@testing-library/react'; diff --git a/frontend/src/tests/utils.test.ts b/frontend/src/tests/utils.test.ts new file mode 100644 index 0000000..4b444db --- /dev/null +++ b/frontend/src/tests/utils.test.ts @@ -0,0 +1,115 @@ +/** + * Tests for utility functions. + */ + +import { getMeterColor, formatMeterId, capitalize, toTitleCase, formatLocationName } from '../utils'; + +describe('Utility Functions', () => { + describe('getMeterColor', () => { + it('returns correct color for known meters', () => { + expect(getMeterColor('attraction')).toBe('bg-pink-500'); + expect(getMeterColor('trust')).toBe('bg-blue-500'); + expect(getMeterColor('arousal')).toBe('bg-red-500'); + expect(getMeterColor('corruption')).toBe('bg-purple-500'); + expect(getMeterColor('energy')).toBe('bg-yellow-500'); + expect(getMeterColor('confidence')).toBe('bg-orange-500'); + expect(getMeterColor('money')).toBe('bg-green-500'); + }); + + it('is case insensitive', () => { + expect(getMeterColor('TRUST')).toBe('bg-blue-500'); + expect(getMeterColor('TrUsT')).toBe('bg-blue-500'); + }); + + it('returns default color for unknown meters', () => { + expect(getMeterColor('unknown_meter')).toBe('bg-gray-500'); + expect(getMeterColor('custom_stat')).toBe('bg-gray-500'); + }); + }); + + describe('formatMeterId', () => { + it('formats meter IDs with underscores', () => { + expect(formatMeterId('trust_level')).toBe('Trust Level'); + expect(formatMeterId('max_energy')).toBe('Max Energy'); + }); + + it('capitalizes single words', () => { + expect(formatMeterId('energy')).toBe('Energy'); + expect(formatMeterId('trust')).toBe('Trust'); + }); + + it('handles multiple underscores', () => { + expect(formatMeterId('max_trust_level')).toBe('Max Trust Level'); + }); + + it('handles empty string', () => { + expect(formatMeterId('')).toBe(''); + }); + }); + + describe('capitalize', () => { + it('capitalizes first letter', () => { + expect(capitalize('hello')).toBe('Hello'); + expect(capitalize('world')).toBe('World'); + }); + + it('does not change already capitalized text', () => { + expect(capitalize('Hello')).toBe('Hello'); + }); + + it('handles single character', () => { + expect(capitalize('a')).toBe('A'); + }); + + it('handles empty string', () => { + expect(capitalize('')).toBe(''); + }); + + it('only capitalizes first letter', () => { + expect(capitalize('hello world')).toBe('Hello world'); + }); + }); + + describe('toTitleCase', () => { + it('converts underscored text to title case', () => { + expect(toTitleCase('coffee_shop')).toBe('Coffee Shop'); + expect(toTitleCase('main_street')).toBe('Main Street'); + }); + + it('handles single words', () => { + expect(toTitleCase('library')).toBe('Library'); + }); + + it('handles multiple underscores', () => { + expect(toTitleCase('north_main_street')).toBe('North Main Street'); + }); + + it('handles null and undefined', () => { + expect(toTitleCase(null)).toBe(''); + expect(toTitleCase(undefined)).toBe(''); + }); + + it('handles empty string', () => { + expect(toTitleCase('')).toBe(''); + }); + }); + + describe('formatLocationName', () => { + it('formats location names with underscores', () => { + expect(formatLocationName('coffee_shop')).toBe('Coffee Shop'); + expect(formatLocationName('main_street')).toBe('Main Street'); + }); + + it('handles camelCase', () => { + expect(formatLocationName('coffeeShop')).toBe('CoffeeShop'); + }); + + it('capitalizes each word', () => { + expect(formatLocationName('north_side_park')).toBe('North Side Park'); + }); + + it('handles single words', () => { + expect(formatLocationName('library')).toBe('Library'); + }); + }); +}); diff --git a/frontend/src/types/test-utils.d.ts b/frontend/src/types/test-utils.d.ts new file mode 100644 index 0000000..6ee93c9 --- /dev/null +++ b/frontend/src/types/test-utils.d.ts @@ -0,0 +1,2 @@ +declare module '*.module.css'; +declare module '*.css'; diff --git a/frontend/src/utils/clothingUtils.ts b/frontend/src/utils/clothingUtils.ts new file mode 100644 index 0000000..80091d4 --- /dev/null +++ b/frontend/src/utils/clothingUtils.ts @@ -0,0 +1,25 @@ +/** + * Utility functions for formatting clothing/attire. + */ + +/** + * Formats attire for display. + * Handles both string format (legacy) and object format (new clothing system). + */ +export const formatAttire = (attire?: string | Record | null): string | null => { + if (!attire) return null; + + // If it's a string, return as-is + if (typeof attire === 'string') { + return attire; + } + + // If it's an object, format it as a comma-separated list + const items = Object.entries(attire) + .filter(([_, value]) => value !== null && value !== '') + .map(([_slot, item]) => item); + + if (items.length === 0) return null; + + return items.join(', '); +}; diff --git a/frontend/src/utils/index.ts b/frontend/src/utils/index.ts new file mode 100644 index 0000000..339671c --- /dev/null +++ b/frontend/src/utils/index.ts @@ -0,0 +1,8 @@ +/** + * Central export for all utility functions. + */ + +export { getMeterColor, renderMeterIcon, formatMeterId } from './meterUtils'; +export { capitalize, toTitleCase, formatLocationName } from './textFormatting'; +export { saveSession, clearSession, loadSession, hasStoredSession } from './storage'; +export { formatAttire } from './clothingUtils'; diff --git a/frontend/src/utils/meterUtils.tsx b/frontend/src/utils/meterUtils.tsx new file mode 100644 index 0000000..6a69caf --- /dev/null +++ b/frontend/src/utils/meterUtils.tsx @@ -0,0 +1,45 @@ +/** + * Utility functions for working with meters. + */ + +import type { ReactNode } from 'react'; + +/** + * Returns the appropriate Tailwind color class for a meter based on its ID. + */ +export const getMeterColor = (meterId: string): string => { + const colors: Record = { + attraction: 'bg-pink-500', + trust: 'bg-blue-500', + arousal: 'bg-red-500', + corruption: 'bg-purple-500', + energy: 'bg-yellow-500', + confidence: 'bg-orange-500', + money: 'bg-green-500', + comfort: 'bg-teal-500', + interest: 'bg-rose-500', + }; + return colors[meterId.toLowerCase()] || 'bg-gray-500'; +}; + +/** + * Renders a meter icon or placeholder. + * Returns a span with the icon character, or an empty div if no icon. + */ +export const renderMeterIcon = (icon: string | null): ReactNode => { + if (icon) { + return {icon}; + } + return

; +}; + +/** + * Formats a meter ID for display (e.g., "trust_level" → "Trust Level"). + */ +export const formatMeterId = (meterId: string): string => { + return meterId + .replace(/_/g, ' ') + .split(' ') + .map(word => word.charAt(0).toUpperCase() + word.slice(1)) + .join(' '); +}; diff --git a/frontend/src/utils/storage.ts b/frontend/src/utils/storage.ts new file mode 100644 index 0000000..92802a2 --- /dev/null +++ b/frontend/src/utils/storage.ts @@ -0,0 +1,88 @@ +/** + * LocalStorage utilities for persisting game state. + * Enables session recovery on page refresh. + */ + +const STORAGE_KEY = 'plotplay_session'; +const STORAGE_VERSION = 1; + +interface StoredSession { + version: number; + timestamp: number; + sessionId: string; + gameId: string; + gameTitle: string; +} + +/** + * Save current session to localStorage. + */ +export const saveSession = ( + sessionId: string, + gameId: string, + gameTitle: string +): void => { + try { + const data: StoredSession = { + version: STORAGE_VERSION, + timestamp: Date.now(), + sessionId, + gameId, + gameTitle, + }; + localStorage.setItem(STORAGE_KEY, JSON.stringify(data)); + } catch (error) { + console.error('Failed to save session to localStorage:', error); + } +}; + +/** + * Load saved session from localStorage. + * Returns null if no session exists or if it's invalid. + */ +export const loadSession = (): StoredSession | null => { + try { + const stored = localStorage.getItem(STORAGE_KEY); + if (!stored) return null; + + const data: StoredSession = JSON.parse(stored); + + // Validate version + if (data.version !== STORAGE_VERSION) { + console.warn('Stored session has incompatible version, ignoring'); + clearSession(); + return null; + } + + // Check if session is too old (older than 7 days) + const MAX_AGE = 7 * 24 * 60 * 60 * 1000; // 7 days in milliseconds + if (Date.now() - data.timestamp > MAX_AGE) { + console.warn('Stored session is too old, clearing'); + clearSession(); + return null; + } + + return data; + } catch (error) { + console.error('Failed to load session from localStorage:', error); + return null; + } +}; + +/** + * Clear saved session from localStorage. + */ +export const clearSession = (): void => { + try { + localStorage.removeItem(STORAGE_KEY); + } catch (error) { + console.error('Failed to clear session from localStorage:', error); + } +}; + +/** + * Check if a saved session exists. + */ +export const hasStoredSession = (): boolean => { + return loadSession() !== null; +}; diff --git a/frontend/src/utils/textFormatting.ts b/frontend/src/utils/textFormatting.ts new file mode 100644 index 0000000..76e7e1e --- /dev/null +++ b/frontend/src/utils/textFormatting.ts @@ -0,0 +1,33 @@ +/** + * Text formatting utilities. + */ + +/** + * Capitalizes the first letter of a string. + * Example: "hello" → "Hello" + */ +export const capitalize = (text: string): string => { + if (!text) return ''; + return text.charAt(0).toUpperCase() + text.slice(1); +}; + +/** + * Converts underscores to spaces and capitalizes each word. + * Example: "coffee_shop" → "Coffee Shop" + */ +export const toTitleCase = (text: string | null | undefined): string => { + if (!text) return ''; + return text + .replace(/_/g, ' ') + .split(' ') + .map(word => capitalize(word)) + .join(' '); +}; + +/** + * Formats a location/zone name for display. + * Replaces underscores with spaces and capitalizes. + */ +export const formatLocationName = (name: string): string => { + return name.replace(/_/g, ' ').replace(/\b\w/g, c => c.toUpperCase()); +}; diff --git a/frontend/tsconfig.json b/frontend/tsconfig.json index 4ed36bf..5a0bd99 100644 --- a/frontend/tsconfig.json +++ b/frontend/tsconfig.json @@ -21,5 +21,6 @@ } }, "include": ["src"], + "exclude": ["src/**/*.test.ts", "src/**/*.test.tsx", "src/tests"], "references": [{ "path": "./tsconfig.node.json" }] } diff --git a/frontend/vite.config.ts b/frontend/vite.config.ts index 01a601d..0de0427 100644 --- a/frontend/vite.config.ts +++ b/frontend/vite.config.ts @@ -10,8 +10,8 @@ export default defineConfig({ host: true, proxy: { '/api': { - target: 'http://backend:8000', // Change from 'backend' to 'localhost' for local dev - //target: 'http://localhost:8000', + //target: 'http://backend:8000', // Change from 'backend' to 'localhost' for local dev + target: 'http://localhost:8000', changeOrigin: true, } } diff --git a/games/coffeeshop_date/characters.yaml b/games/coffeeshop_date/characters.yaml index bece471..23591c4 100644 --- a/games/coffeeshop_date/characters.yaml +++ b/games/coffeeshop_date/characters.yaml @@ -1,75 +1,47 @@ -# =============================== -# Characters - Coffee Shop Date (v3 Spec) -# =============================== - characters: - id: "player" name: "You" age: 25 - gender: "male" + gender: "unspecified" pronouns: ["you"] + appearance: "You dressed with care: crisp shirt, neat chinos, and an easy smile you hope will stick." + dialogue_style: "Earnest, a touch self-deprecating, determined to keep the mood light." + clothing: + outfit: "player_date_casual" inventory: - phone: 1 - wardrobe: - outfits: - - id: "player_date_casual" - name: "Smart Casual" - tags: ["default"] - layers: - top: { item: "button-up shirt", color: "blue" } - bottom: { item: "chinos" } - feet: { item: "leather shoes" } + items: + - id: "phone" + count: 1 - id: "alex" - name: "Alex" - age: 22 + name: "Alex Ramos" + age: 24 gender: "female" pronouns: ["she", "her"] - role: "date" - dialogue_style: "friendly, slightly nervous, uses coffee metaphors" - - meters: - comfort: { default: 20 } - interest: { default: 15 } - + dialogue_style: "Warm, observant, and fond of coffee metaphors when she relaxes." personality: - core_traits: ["friendly", "cautious", "witty"] - values: ["honesty", "humor"] - fears: ["awkward silences", "being judged"] - quirks: ["laughs when nervous", "plays with her hair"] - - appearance: - base: - height: "165 cm" - build: "average" - hair: { color: "brown", style: "shoulder-length, wavy" } - eyes: { color: "green" } - - wardrobe: - outfits: - - id: "casual_date" - name: "Casual Date Outfit" - tags: ["default"] - layers: - top: { item: "sweater", color: "cream" } - bottom: { item: "jeans", style: "dark wash" } - feet: { item: "ankle boots" } - - behaviors: - gates: - - { id: "accept_compliment", when: "always" } - - { id: "accept_flirt", when: "meters.alex.comfort >= 40" } - - { id: "share_number", when: "meters.alex.interest >= 50" } - - { id: "accept_second_date", when: "meters.alex.interest >= 70" } - - { id: "accept_kiss", when: "meters.alex.comfort >= 70 and meters.alex.interest >= 80" } - - refusals: - generic: "She smiles politely but changes the subject." - too_forward: "She looks uncomfortable. 'Let's take things slow, okay?'" - low_comfort: "She shifts in her seat. 'I'm not quite ready for that yet.'" - - dialogue: - base_style: "friendly but cautious" - vocab: - normal: ["maybe", "interesting", "tell me more"] - interested: ["definitely", "I'd like that", "sounds fun"] \ No newline at end of file + core_traits: "friendly, perceptive, quietly ambitious" + quirks: "taps the rim of her mug when thinking; collects quirky mugs" + values: "honesty, thoughtful gestures" + appearance: "Alex's wavy brown hair is pulled into a loose bun, a rust scarf brightening her cream sweater and dark jeans." + gates: + - id: "accept_compliment" + when: "true" + acceptance: "Alex beams and nudges her mug toward yours in thanks." + refusal: "She tilts her head, unsure how to absorb the praise." + - id: "accept_flirt" + when: "meters.alex.comfort >= 40" + acceptance: "She leans closer, matching your playful tone with one of her own." + refusal: "She laughs softly but glances away, not quite ready for that." + - id: "share_number" + when: "meters.alex.interest >= 55" + acceptance: "She slides her phone across the table. \"Go on, text me so I have yours.\"" + refusal: "She swirls her latte. \"Maybe let's see how we feel after today.\"" + - id: "accept_second_date" + when: "meters.alex.interest >= 65 and meters.alex.comfort >= 50" + acceptance: "Her grin turns conspiratorial. \"I'd love another round of caffeine with you.\"" + refusal: "She tucks hair behind her ear. \"Tonight was nice, but let's not rush it.\"" + clothing: + outfit: "alex_cafe_chic" + inventory: + items: [] diff --git a/games/coffeeshop_date/flags.yaml b/games/coffeeshop_date/flags.yaml deleted file mode 100644 index fa4470d..0000000 --- a/games/coffeeshop_date/flags.yaml +++ /dev/null @@ -1,48 +0,0 @@ -# =============================== -# Flags - Coffee Shop Date (v3 Spec) -# =============================== - -flags: - took_mint: - type: "bool" - default: false - visible: false - description: "Set to true if player took a mint before entering." - - ordered_coffee: - type: "bool" - default: false - visible: false - description: "Set to true after ordering coffee." - - paid_for_alex: - type: "bool" - default: false - visible: true - label: "Paid for Alex" - description: "Set to true if the player pays for Alex's coffee." - - told_joke: - type: "bool" - default: false - visible: false - description: "Set to true if the player tells a funny story." - - complimented_alex: - type: "bool" - default: false - visible: false - description: "Set to true if player compliments Alex's appearance." - - got_number: - type: "bool" - default: false - visible: true - label: "Got Alex's Number" - description: "Set to true if Alex gives the player her number." - - alex_impressed: - type: "bool" - default: false - visible: false - description: "Set to true if Alex is particularly impressed by the player." \ No newline at end of file diff --git a/games/coffeeshop_date/game.yaml b/games/coffeeshop_date/game.yaml index 4ee6aea..2ee783d 100644 --- a/games/coffeeshop_date/game.yaml +++ b/games/coffeeshop_date/game.yaml @@ -1,63 +1,95 @@ -# =============================== -# Game Manifest - Coffee Shop Date (v3 Spec) -# A quick, linear test game for basic mechanics validation -# =============================== - meta: id: "coffeeshop_date" title: "Coffee Shop Date" - version: "1.0.0" - spec_version: "3.1" + version: "1.1.0" authors: ["PlotPlay Team"] - content_rating: "teen" - tags: ["test", "romance", "linear"] - description: "A simple first-date scenario for testing core mechanics" + description: "A breezy afternoon meet-up where a first date can bloom into something more." + content_warnings: ["mild language"] nsfw_allowed: false + license: "CC-BY-NC-4.0" -# Starting point -start: - node: "outside_cafe" - location: { zone: "downtown", id: "outside" } - -# Narration style narration: pov: "second" tense: "present" paragraphs: "1-2" - token_budget: 300 - checker_budget: 150 -# Meters +start: + location: "cafe_patio" + node: "outside_cafe" + day: 1 + slot: "afternoon" + time: "13:00" + meters: player: - confidence: { min: 0, max: 100, default: 50, visible: true, icon: "😎" } - money: { min: 0, max: 100, default: 30, visible: true, icon: "💵" } - - character_template: - comfort: { - min: 0, max: 100, default: 20, - thresholds: { nervous: [0, 30], relaxed: [31, 70], comfortable: [71, 100] } - } - interest: { - min: 0, max: 100, default: 15, - thresholds: { polite: [0, 30], interested: [31, 70], attracted: [71, 100] } - } - -# Time system + confidence: + min: 0 + max: 100 + default: 55 + visible: true + icon: "😎" + template: + comfort: + min: 0 + max: 100 + default: 25 + visible: true + icon: "🤝" + thresholds: + nervous: { min: 0, max: 39 } + relaxed: { min: 40, max: 69 } + warm: { min: 70, max: 100 } + interest: + min: 0 + max: 100 + default: 20 + visible: false + icon: "💖" + thresholds: + polite: { min: 0, max: 39 } + curious: { min: 40, max: 69 } + eager: { min: 70, max: 100 } + +flags: + shared_laugh: + type: "bool" + default: false + visible: true + description: "Set when Alex laughs freely with you." + second_date_offer: + type: "bool" + default: false + visible: false + description: "Marks that you invited Alex to another date." + time: mode: "slots" slots: ["afternoon", "evening"] - actions_per_slot: 10 - auto_advance: false - start: - day: 1 - slot: "afternoon" + actions_per_slot: 4 + +economy: + enabled: true + starting_money: 35 + max_money: 500 + currency_name: "dollars" + currency_symbol: "$" + +movement: + base_time: 1 + use_entry_exit: false + methods: + - walk: 1 + +modifiers: + stacking: {} + library: [] + +actions: [] +events: [] +arcs: [] -# Included content files includes: + - "items.yaml" - "characters.yaml" - - "flags.yaml" - - "modifiers.yaml" - "locations.yaml" - - "items.yaml" - - "nodes.yaml" \ No newline at end of file + - "nodes.yaml" diff --git a/games/coffeeshop_date/items.yaml b/games/coffeeshop_date/items.yaml index 3991a0e..3917c99 100644 --- a/games/coffeeshop_date/items.yaml +++ b/games/coffeeshop_date/items.yaml @@ -1,42 +1,98 @@ -# =============================== -# Items - Coffee Shop Date (v3 Spec) -# =============================== - items: - id: "phone" - name: "Your Phone" - category: "misc" - description: "Your smartphone with Alex's number programmed in." + name: "Smartphone" + category: "device" + description: "Your always-on companion for messages, maps, and escape plans." + value: 0 stackable: false droppable: false - - - id: "breath_mint" - name: "Breath Mint" - category: "consumable" - description: "A complimentary mint from the jar outside. Fresh and minty." - icon: "🍬" + - id: "vanilla_latte" + name: "Vanilla Latte" + category: "drink" + description: "A creamy latte with just enough sweetness to soothe nerves." + value: 6 stackable: true consumable: true - use_text: "You pop the mint in your mouth, feeling a cool burst of confidence." - effects_on_use: - - { type: "meter_change", target: "player", meter: "confidence", op: "add", value: 5 } - - - id: "coffee" - name: "Coffee" - category: "consumable" - description: "A hot cup of coffee." - icon: "☕" - value: 5 + use_text: "You savor the latte, letting the warmth steady your voice." + on_use: + - type: "meter_change" + target: "player" + meter: "confidence" + op: "add" + value: 3 + - id: "spiced_matcha" + name: "Spiced Matcha" + category: "drink" + description: "Matcha brightened with cinnamon and orange zest." + value: 6 stackable: true consumable: true - use_text: "You take a sip of the warm coffee, feeling energized." - effects_on_use: - - { type: "meter_change", target: "player", meter: "confidence", op: "add", value: 3 } + use_text: "The citrus notes cut through the sweetness, clearing your head." + on_use: + - type: "meter_change" + target: "player" + meter: "confidence" + op: "add" + value: 2 - - id: "alex_number" - name: "Alex's Phone Number" - category: "trophy" - description: "Alex's phone number written on a napkin with a little smiley face." - icon: "📱" - stackable: false - droppable: false \ No newline at end of file +wardrobe: + slots: ["top", "bottom", "feet", "accessory"] + items: + - id: "player_top_button_up" + name: "Blue Button-Up" + value: 45 + look: + intact: "A crisp blue button-up shirt with rolled sleeves." + occupies: ["top"] + conceals: [] + - id: "player_bottom_chinos" + name: "Charcoal Chinos" + value: 40 + look: + intact: "Tailored charcoal chinos that keep things relaxed but polished." + occupies: ["bottom"] + conceals: [] + - id: "player_shoes_leather" + name: "Leather Oxfords" + value: 60 + look: + intact: "Well-kept leather oxfords with a subtle shine." + occupies: ["feet"] + conceals: [] + - id: "alex_top_sweater" + name: "Cream Sweater" + value: 50 + look: + intact: "A soft cream sweater with cuffed sleeves." + occupies: ["top"] + conceals: [] + - id: "alex_bottom_jeans" + name: "Dark Jeans" + value: 45 + look: + intact: "Dark denim jeans, relaxed but flattering." + occupies: ["bottom"] + conceals: [] + - id: "alex_shoes_boots" + name: "Ankle Boots" + value: 55 + look: + intact: "Stylish leather ankle boots with a comfortable heel." + occupies: ["feet"] + conceals: [] + - id: "alex_accessory_scarf" + name: "Rust Scarf" + value: 25 + look: + intact: "A rust-colored scarf looped casually around her neck." + occupies: ["accessory"] + conceals: [] + outfits: + - id: "player_date_casual" + name: "Smart Casual" + items: ["player_top_button_up", "player_bottom_chinos", "player_shoes_leather"] + grant_items: true + - id: "alex_cafe_chic" + name: "Cafe Chic" + items: ["alex_top_sweater", "alex_bottom_jeans", "alex_shoes_boots", "alex_accessory_scarf"] + grant_items: true diff --git a/games/coffeeshop_date/locations.yaml b/games/coffeeshop_date/locations.yaml index dde73eb..dd21ebb 100644 --- a/games/coffeeshop_date/locations.yaml +++ b/games/coffeeshop_date/locations.yaml @@ -1,34 +1,47 @@ -# =============================== -# Locations - Coffee Shop Date (v3 Spec) -# =============================== - zones: - id: "downtown" name: "Downtown" - discovered: true - accessible: true - + summary: "A lively commercial strip with independent shops and the scent of espresso in the air." + privacy: "low" + access: + discovered: true locations: - - id: "outside" - name: "Outside the Coffee Shop" - type: "public" - privacy: "low" - discovered: true - description: "The afternoon sun warms the sidewalk. Through the window, you can see your date Alex already inside, looking at her phone." - features: ["sidewalk", "bench", "mint jar"] + - id: "cafe_patio" + name: "Cafe Patio" + summary: "A sunlit patio with wrought-iron tables and a mint jar by the door." + privacy: "medium" + access: + discovered: true connections: - - to: "coffee_shop" - type: "door" - distance: "immediate" - - - id: "coffee_shop" - name: "Corner Coffee Shop" - type: "public" + - to: "cafe_counter" + description: "Step inside toward the counter." + direction: "n" + - id: "cafe_counter" + name: "Coffee Shop Counter" + summary: "A wooden counter lined with pastries, the hum of grinders filling the room." privacy: "low" - discovered: true - description: "The cozy interior smells of fresh espresso and pastries. Soft jazz plays in the background." - features: ["counter", "tables", "window_seats", "menu_board"] connections: - - to: "outside" - type: "door" - distance: "immediate" \ No newline at end of file + - to: "cafe_patio" + description: "Carry the drinks back outside." + direction: "s" + - to: "cafe_table" + description: "Weave between tables to the quiet corner." + direction: "e" + inventory: + items: + - id: "vanilla_latte" + count: 2 + - id: "spiced_matcha" + count: 2 + - id: "cafe_table" + name: "Corner Table" + summary: "A tucked-away table with soft light and chalk doodles on the brick wall." + privacy: "medium" + connections: + - to: "cafe_counter" + description: "Return to the counter." + direction: "w" + inventory: + items: [] + entrances: ["cafe_patio"] + exits: ["cafe_patio"] diff --git a/games/coffeeshop_date/modifiers.yaml b/games/coffeeshop_date/modifiers.yaml deleted file mode 100644 index e944714..0000000 --- a/games/coffeeshop_date/modifiers.yaml +++ /dev/null @@ -1,36 +0,0 @@ -# =============================== -# Modifiers - Coffee Shop Date (v3 Spec) -# =============================== - -modifier_system: - library: - flattered: - id: "flattered" - group: "emotional" - when: "meters.alex.comfort >= 30 and meters.alex.interest >= 25" - duration_default_min: 15 - appearance: - cheeks: "slightly flushed" - eyes: "bright" - behavior: - dialogue_style: "warmer, more open" - description: "Feeling positive after a compliment or kind gesture." - - nervous: - id: "nervous" - group: "emotional" - when: "meters.alex.comfort < 30" - appearance: - posture: "slightly tense" - eyes: "darting" - behavior: - dialogue_style: "shorter responses, uncertain" - description: "Feeling uncertain or anxious in the interaction." - - confident_player: - id: "confident_player" - group: "emotional" - when: "meters.player.confidence >= 70" - behavior: - dialogue_style: "assured, relaxed" - description: "The player is feeling confident and comfortable." \ No newline at end of file diff --git a/games/coffeeshop_date/nodes.yaml b/games/coffeeshop_date/nodes.yaml index 7c8d4ef..342705e 100644 --- a/games/coffeeshop_date/nodes.yaml +++ b/games/coffeeshop_date/nodes.yaml @@ -1,258 +1,283 @@ -# =============================== -# Nodes - Coffee Shop Date (v3 Spec) -# Linear story with multiple endings based on relationship meters -# =============================== - nodes: - # ===== SCENE 1: OUTSIDE THE CAFE ===== - id: "outside_cafe" type: "scene" - title: "Outside the Coffee Shop" + title: "Outside Brewed Awakenings" + characters_present: ["alex"] beats: - - "You stand outside 'Corner Coffee Shop'. Through the window, you can see Alex already inside." - - "There's a small jar of complimentary breath mints by the door." - - "Your first date nerves are kicking in." + - "You spot Alex waiting on the patio, sunlight catching the copper strands in her hair." + - "She lifts a hand in a tentative wave, the mint jar between you glinting invitingly." + on_entry: + - type: "meter_change" + target: "alex" + meter: "comfort" + op: "add" + value: 5 choices: - - id: "take_mint_and_enter" - prompt: "Take a mint and head inside" - effects: - - { type: "inventory_add", owner: "player", item: "breath_mint", count: 1 } - - { type: "flag_set", key: "took_mint", value: true } - - { type: "meter_change", target: "player", meter: "confidence", op: "add", value: 5 } - goto: "meet_alex" - - - id: "just_enter" - prompt: "Head straight inside" - goto: "meet_alex" + - id: "greet_warmly" + prompt: "Offer a warm compliment about her scarf." + on_select: + - type: "meter_change" + target: "alex" + meter: "comfort" + op: "add" + value: 10 + - type: "meter_change" + target: "alex" + meter: "interest" + op: "add" + value: 6 + - type: "meter_change" + target: "player" + meter: "confidence" + op: "add" + value: 4 + - type: "goto" + node: "order_drinks" + - id: "arrive_rushed" + prompt: "Apologize for running a couple minutes late." + on_select: + - type: "meter_change" + target: "alex" + meter: "comfort" + op: "add" + value: 4 + - type: "meter_change" + target: "player" + meter: "confidence" + op: "subtract" + value: 6 + - type: "goto" + node: "order_drinks" - transitions: - - { when: "always", to: "meet_alex" } - - # ===== SCENE 2: MEETING ALEX ===== - - id: "meet_alex" + - id: "order_drinks" type: "scene" - title: "Meeting Alex" - present_characters: ["alex"] - entry_effects: - - { type: "move_to", location: "coffee_shop" } + title: "Ordering Drinks" + characters_present: ["alex"] beats: - - "You walk over to the table where Alex is sitting. She looks up and smiles nervously." - - "There's a moment of awkward silence as you both size each other up." + - "Inside, the scent of espresso wraps around you. Alex scan the chalkboard menu with a decisive nod." + - "\"My treat?\" you offer, already fishing out your wallet." choices: - - id: "confident_greeting" - prompt: "Greet her confidently: 'Hi Alex! Great to finally meet you.'" - effects: - - { type: "meter_change", target: "alex", meter: "interest", op: "add", value: 10 } - - { type: "meter_change", target: "player", meter: "confidence", op: "add", value: 5 } - goto: "order_coffee" - - - id: "nervous_greeting" - prompt: "Greet her nervously: 'Um, hi... nice place, right?'" - effects: - - { type: "meter_change", target: "alex", meter: "comfort", op: "add", value: 10 } - - { type: "meter_change", target: "player", meter: "confidence", op: "subtract", value: 5 } - goto: "order_coffee" + - id: "matching_lattes" + prompt: "Order matching vanilla lattes for the both of you." + when: "meters.player.money >= 12" + on_select: + - type: "meter_change" + target: "player" + meter: "money" + op: "subtract" + value: 12 + - type: "meter_change" + target: "alex" + meter: "interest" + op: "add" + value: 8 + - type: "meter_change" + target: "alex" + meter: "comfort" + op: "add" + value: 6 + - type: "goto" + node: "table_convo" + - id: "let_her_choose" + prompt: "Ask Alex to pick anything and insist on paying." + when: "meters.player.money >= 10" + on_select: + - type: "meter_change" + target: "player" + meter: "money" + op: "subtract" + value: 10 + - type: "meter_change" + target: "alex" + meter: "interest" + op: "add" + value: 10 + - type: "goto" + node: "table_convo" + - id: "split_the_bill" + prompt: "Suggest splitting the cost with a light joke." + on_select: + - type: "meter_change" + target: "player" + meter: "money" + op: "subtract" + value: 6 + - type: "meter_change" + target: "alex" + meter: "comfort" + op: "add" + value: 5 + - type: "goto" + node: "table_convo" - - id: "casual_greeting" - prompt: "Be casual: 'Hey! Have you been waiting long?'" - effects: - - { type: "meter_change", target: "alex", meter: "comfort", op: "add", value: 5 } - - { type: "meter_change", target: "alex", meter: "interest", op: "add", value: 5 } - goto: "order_coffee" - - transitions: - - { when: "always", to: "order_coffee" } - - # ===== SCENE 3: ORDERING COFFEE ===== - - id: "order_coffee" + - id: "table_convo" type: "scene" - title: "Ordering Coffee" - present_characters: ["alex"] + title: "Corner Table Conversation" + characters_present: ["alex"] beats: - - "Alex suggests you both order coffee. The menu board lists various drinks, each costing $5." - - "You have $30 in your wallet." + - "Steam curls from your mugs as the afternoon crowd fades into soft chatter." + - "Alex rests her chin on her hand, eyes bright with curiosity." choices: - - id: "pay_for_both" - prompt: "Offer to pay for both coffees ($10)" - conditions: "meters.player.money >= 10" - effects: - - { type: "meter_change", target: "player", meter: "money", op: "subtract", value: 10 } - - { type: "meter_change", target: "alex", meter: "interest", op: "add", value: 15 } - - { type: "flag_set", key: "paid_for_alex", value: true } - - { type: "inventory_add", owner: "player", item: "coffee", count: 1 } - goto: "conversation_start" - - - id: "split_bill" - prompt: "Suggest splitting the bill ($5 each)" - effects: - - { type: "meter_change", target: "player", meter: "money", op: "subtract", value: 5 } - - { type: "meter_change", target: "alex", meter: "comfort", op: "add", value: 5 } - - { type: "inventory_add", owner: "player", item: "coffee", count: 1 } - goto: "conversation_start" + - id: "ask_about_art" + prompt: "Ask about the mural she mentioned in her messages." + on_select: + - type: "meter_change" + target: "alex" + meter: "comfort" + op: "add" + value: 12 + - type: "meter_change" + target: "alex" + meter: "interest" + op: "add" + value: 8 + - type: "goto" + node: "share_story" + - id: "tell_funny_story" + prompt: "Share the catastrophe of your first attempt at latte art." + on_select: + - type: "meter_change" + target: "alex" + meter: "comfort" + op: "add" + value: 6 + - type: "meter_change" + target: "alex" + meter: "interest" + op: "add" + value: 12 + - type: "flag_set" + key: "shared_laugh" + value: true + - type: "goto" + node: "tell_joke" + - id: "offer_compliment" + prompt: "Compliment the way she pairs colors in her outfits." + when: "gates.alex.accept_compliment" + on_select: + - type: "meter_change" + target: "alex" + meter: "comfort" + op: "add" + value: 9 + - type: "meter_change" + target: "alex" + meter: "interest" + op: "add" + value: 7 + - type: "goto" + node: "share_story" - - id: "alex_pays" - prompt: "Let Alex pay for both" - effects: - - { type: "meter_change", target: "alex", meter: "interest", op: "subtract", value: 5 } - - { type: "meter_change", target: "player", meter: "confidence", op: "subtract", value: 10 } - - { type: "inventory_add", owner: "player", item: "coffee", count: 1 } - goto: "conversation_start" - - entry_effects: - - { type: "flag_set", key: "ordered_coffee", value: true } - - transitions: - - { when: "always", to: "conversation_start" } - - # ===== SCENE 4: CONVERSATION ===== - - id: "conversation_start" - type: "scene" - title: "Getting to Know Each Other" - present_characters: ["alex"] - beats: - - "You both sit down with your drinks. Time to break the ice and see if there's chemistry." - - "Alex seems interested but still a bit guarded." - choices: - - id: "ask_about_work" - prompt: "Ask about her work" - effects: - - { type: "meter_change", target: "alex", meter: "comfort", op: "add", value: 10 } - - { type: "meter_change", target: "alex", meter: "interest", op: "add", value: 5 } - goto: "conversation_deeper" - - - id: "tell_joke" - prompt: "Tell a funny story about your week" - effects: - - { type: "meter_change", target: "alex", meter: "interest", op: "add", value: 15 } - - { type: "meter_change", target: "alex", meter: "comfort", op: "add", value: 10 } - - { type: "flag_set", key: "told_joke", value: true } - goto: "conversation_deeper" - - - id: "compliment_appearance" - prompt: "Compliment her appearance" - conditions: "gates.alex.accept_compliment" - effects: - - { type: "meter_change", target: "alex", meter: "interest", op: "add", value: 10 } - - { type: "flag_set", key: "complimented_alex", value: true } - - { type: "apply_modifier", character: "alex", modifier_id: "flattered", duration_min: 15 } - goto: "conversation_deeper" - - - id: "talk_interests" - prompt: "Ask about her interests and hobbies" - effects: - - { type: "meter_change", target: "alex", meter: "comfort", op: "add", value: 15 } - - { type: "meter_change", target: "alex", meter: "interest", op: "add", value: 10 } - goto: "conversation_deeper" - - transitions: - - { when: "always", to: "conversation_deeper" } - - # ===== SCENE 5: DEEPER CONVERSATION ===== - - id: "conversation_deeper" + - id: "share_story" type: "scene" title: "Finding Common Ground" - present_characters: ["alex"] + characters_present: ["alex"] beats: - - "The conversation flows more naturally now. You're starting to learn about each other." - - "Alex seems more relaxed, occasionally laughing at your comments." - choices: - - id: "share_personal" - prompt: "Share something personal about yourself" - effects: - - { type: "meter_change", target: "alex", meter: "comfort", op: "add", value: 15 } - - { type: "meter_change", target: "alex", meter: "interest", op: "add", value: 10 } - goto: "check_chemistry" - - - id: "ask_about_dating" - prompt: "Ask about her dating experiences" - conditions: "meters.alex.comfort >= 40" - effects: - - { type: "meter_change", target: "alex", meter: "comfort", op: "add", value: 5 } - - { type: "meter_change", target: "alex", meter: "interest", op: "add", value: 10 } - goto: "check_chemistry" - - - id: "suggest_second_date" - prompt: "Suggest plans for a second date" - conditions: "meters.alex.interest >= 50" - effects: - - { type: "meter_change", target: "alex", meter: "interest", op: "add", value: 15 } - - { type: "flag_set", key: "alex_impressed", value: true } - goto: "check_chemistry" + - "\"I love that you notice the little things,\" she says. \"So what keeps you busy when you're not here?\"" + - You trade stories about weekend routines, the conversation loosening every minute. + on_entry: + - type: "meter_change" + target: "alex" + meter: "comfort" + op: "add" + value: 8 + - type: "meter_change" + target: "alex" + meter: "interest" + op: "add" + value: 6 + triggers: + - when: "true" + on_select: + - type: "goto" + node: "closing_moment" - - id: "keep_it_light" - prompt: "Keep the conversation light and fun" - effects: - - { type: "meter_change", target: "alex", meter: "comfort", op: "add", value: 10 } - goto: "check_chemistry" - - transitions: - - { when: "always", to: "check_chemistry" } - - # ===== SCENE 6: DATE ENDING ===== - - id: "check_chemistry" + - id: "tell_joke" type: "scene" - title: "End of the Date" - present_characters: ["alex"] + title: "Shared Laughter" + characters_present: ["alex"] beats: - - "An hour has passed quickly. You both realize it's time to wrap up." - - "You walk outside together." - entry_effects: - - { type: "move_to", location: "outside" } - transitions: - - { when: "gates.alex.accept_kiss", to: "ending_kiss" } - - { when: "gates.alex.share_number", to: "ending_number" } - - { when: "always", to: "ending_awkward" } - - # ===== ENDINGS ===== + - "Alex laughs so hard she has to dab foam from the corner of her mouth." + - "\"Okay, you win,\" she grins. \"Next time I'm letting you handle the latte art.\"" + on_entry: + - type: "meter_change" + target: "alex" + meter: "comfort" + op: "add" + value: 10 + - type: "meter_change" + target: "alex" + meter: "interest" + op: "add" + value: 10 + triggers: + - when: "true" + on_select: + - type: "goto" + node: "closing_moment" - - id: "ending_kiss" - type: "ending" - title: "Perfect First Date" - present_characters: ["alex"] - ending_id: "perfect_date" + - id: "closing_moment" + type: "scene" + title: "Heading Out" + characters_present: ["alex"] beats: - - "As you stand outside, Alex moves closer. She looks up at you with warm eyes." - - "The moment feels right. She leans in and kisses you softly." - - "'I had a wonderful time,' she says with a genuine smile. 'Let's do this again soon?'" - entry_effects: - - { type: "inventory_add", owner: "player", item: "alex_number", count: 1 } - - { type: "flag_set", key: "got_number", value: true } - credits: - summary: "You made a great impression. Alex is clearly interested in seeing you again." - epilogue: - - "Over the next few weeks, you and Alex go on several more dates." - - "The chemistry you felt on that first date only grows stronger." + - "Dusk edges in as you step back onto the patio, mugs empty but hands lingering close." + - "Alex hesitates, weight shifting as though she's not quite ready to say goodbye." + choices: + - id: "propose_second_date" + prompt: "Suggest meeting again for the night market this weekend." + when_any: + - "meters.alex.interest >= 60" + - "flags.shared_laugh == true" + on_select: + - type: "meter_change" + target: "alex" + meter: "interest" + op: "add" + value: 8 + - type: "flag_set" + key: "second_date_offer" + value: true + - type: "goto" + node: "goodbye_success" + - id: "graceful_farewell" + prompt: "Offer a warm goodbye and promise to text later." + on_select: + - type: "goto" + node: "goodbye_polite" - - id: "ending_number" + - id: "goodbye_success" type: "ending" - title: "Promising Start" - present_characters: ["alex"] - ending_id: "good_date" + title: "Promising Second Date" + characters_present: ["alex"] + ending_id: "alex_second_date" beats: - - "Alex smiles warmly. 'I had a really nice time tonight.'" - - "She pulls out her phone. 'Here, let me give you my number. We should definitely hang out again.'" - - "You exchange numbers and she gives you a quick hug goodbye." - entry_effects: - - { type: "inventory_add", owner: "player", item: "alex_number", count: 1 } - - { type: "flag_set", key: "got_number", value: true } - credits: - summary: "A solid first date. Alex enjoyed your company and wants to see you again." - epilogue: - - "You text Alex the next day and make plans for a second date." - - "Things are off to a good start." + - "Alex's smile widens. \"I'd like that a lot,\" she says, tapping her number into your phone." + - "\"Text me when you get home? I want to hear how the rest of your night goes.\"" + on_entry: + - type: "meter_change" + target: "player" + meter: "confidence" + op: "add" + value: 6 + - type: "meter_change" + target: "alex" + meter: "comfort" + op: "add" + value: 6 + on_exit: [] - - id: "ending_awkward" + - id: "goodbye_polite" type: "ending" - title: "Polite Goodbye" - present_characters: ["alex"] - ending_id: "awkward_date" + title: "Polite Parting" + characters_present: ["alex"] + ending_id: "coffee_date_polite" beats: - - "Alex checks her phone and looks a bit distracted." - - "'Well, this was nice,' she says politely but without much enthusiasm." - - "'I should probably get going. Thanks for the coffee.' She waves and walks away quickly." - - "You get the feeling she won't be texting you anytime soon." - credits: - summary: "The date didn't quite click. Sometimes chemistry just isn't there." - epilogue: - - "You never hear from Alex again." - - "Maybe next time you'll make a better connection." \ No newline at end of file + - "\"This was really nice,\" Alex says, giving your arm a gentle squeeze." + - "She heads down the sidewalk with a final wave, leaving the door open but uncertain." + on_entry: + - type: "meter_change" + target: "player" + meter: "confidence" + op: "add" + value: 2 diff --git a/games/college_romance/actions.yaml b/games/college_romance/actions.yaml index 7dfdde3..9de923f 100644 --- a/games/college_romance/actions.yaml +++ b/games/college_romance/actions.yaml @@ -1,58 +1,33 @@ -# =============================== -# Actions - College Romance (v3 Spec) -# =============================== - actions: - - id: "deep_talk_emma" - prompt: "Have a deep conversation with Emma about her family" - category: "conversation" - conditions: "npc_present('emma') and meters.emma.trust >= 60" + - id: "take_power_nap" + prompt: "Crash for a 20-minute power nap." + category: "self-care" + when: "meters.player.energy <= 40" effects: + - type: "advance_time_slot" + slots: 1 - type: "meter_change" - target: "emma" - meter: "trust" + target: "player" + meter: "energy" op: "add" - value: 10 + value: 18 - type: "meter_change" - target: "emma" - meter: "attraction" + target: "player" + meter: "mind" op: "add" - value: 5 - - type: "flag_set" - key: "emma_opened_up" - value: true - - - id: "flirt_emma" - prompt: "Flirt with Emma" - category: "romance" - conditions: "npc_present('emma') and gates.emma.accept_flirting" + value: 4 + - id: "send_group_text" + prompt: "Ping Emma and Zoe with a playful group text." + category: "social" + when: "time.slot in ['evening','night']" effects: - type: "meter_change" target: "emma" - meter: "attraction" - op: "add" - value: 8 - - type: "meter_change" - target: "emma" - meter: "arousal" - op: "add" - value: 5 - - - id: "flirt_zoe" - prompt: "Flirt with Zoe" - category: "romance" - conditions: "npc_present('zoe') and gates.zoe.accept_flirting" - effects: - - type: "meter_change" - target: "zoe" - meter: "attraction" + meter: "trust" op: "add" - value: 8 + value: 3 - type: "meter_change" target: "zoe" - meter: "arousal" + meter: "trust" op: "add" - value: 6 - - type: "flag_set" - key: "zoe_flirted" - value: true \ No newline at end of file + value: 3 diff --git a/games/college_romance/arcs.yaml b/games/college_romance/arcs.yaml index 29e58bb..b2232da 100644 --- a/games/college_romance/arcs.yaml +++ b/games/college_romance/arcs.yaml @@ -1,137 +1,60 @@ -# games/college_romance/arcs.yaml -# =============================== -# Arcs & Milestones - College Romance (v3 Spec) -# =============================== - arcs: - # === PLAYER SELF-IMPROVEMENT === - - id: "player_growth" - name: "Self-Improvement" - description: "Build your stats to unlock dates and deeper relationships." - category: "personal" - stages: - - id: "freshman_start" - name: "Freshman Beginning" - advance_when: "time.day >= 1" - effects_on_enter: - - { type: "flag_set", key: "arc_started", value: true } - - - id: "academic_focus" - name: "Academic Achievement" - advance_when: "meters.player.mind >= 50" - effects_on_advance: - - { type: "meter_change", target: "player", meter: "confidence", op: "add", value: 10 } - - - id: "fitness_achieved" - name: "Physical Fitness" - advance_when: "meters.player.body >= 50" - effects_on_advance: - - { type: "meter_change", target: "player", meter: "confidence", op: "add", value: 10 } - - { type: "meter_change", target: "player", meter: "looks", op: "add", value: 5 } - - - id: "well_rounded" - name: "Well-Rounded Student" - advance_when: "meters.player.mind >= 60 and meters.player.body >= 60 and meters.player.looks >= 60" - effects_on_advance: - - { type: "meter_change", target: "player", meter: "confidence", op: "add", value: 15 } - - # === EMMA PURITY PATH === - - id: "emma_purity" - name: "Emma's Pure Romance" + - id: "emma_path" + title: "Emma's Momentum" character: "emma" category: "romance" - description: "Build trust and genuine connection with Emma through slow, respectful progression." stages: - - id: "first_meeting" - name: "First Impressions" - advance_when: "flags.emma_met == true" - effects_on_enter: - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 5 } - - - id: "friendship_building" - name: "Building Friendship" - advance_when: "meters.emma.trust >= 30" - effects_on_advance: - - { type: "unlock_actions", actions: ["deep_talk_emma", "flirt_emma"] } - - - id: "romantic_interest" - name: "Growing Attraction" - advance_when: "meters.emma.attraction >= 40 and meters.emma.trust >= 40" - effects_on_advance: - - { type: "flag_set", key: "emma_likes_you", value: true } - - - id: "dating" - name: "Dating Officially" - advance_when: "flags.emma_first_kiss == true and meters.emma.trust >= 60" - effects_on_advance: - - { type: "flag_set", key: "dating_emma", value: true } - - - id: "deep_connection" - name: "Deep Emotional Bond" - advance_when: "meters.emma.trust >= 80 and meters.emma.attraction >= 75" - unlocks: - endings: ["emma_pure_ending"] - - # === EMMA CORRUPTION PATH === - - id: "emma_corruption" - name: "Emma's Corruption" - character: "emma" - category: "corruption" - description: "Push Emma's boundaries and awaken her wild side." - stages: - - id: "innocent" - name: "Innocent Beginning" - advance_when: "flags.emma_met == true" - - - id: "curiosity" - name: "Curious Exploration" - advance_when: "meters.emma.corruption >= 25" - effects_on_advance: - - { type: "meter_change", target: "emma", meter: "boldness", op: "add", value: 10 } - - - id: "experimenting" - name: "Bold Experimentation" - advance_when: "meters.emma.corruption >= 50 and meters.emma.boldness >= 40" - effects_on_advance: - - { type: "unlock_outfit", character: "emma", outfit: "emma_bold" } - - - id: "corrupted" - name: "Fully Corrupted" - advance_when: "meters.emma.corruption >= 75" - unlocks: - endings: ["emma_corrupt_ending"] - - - id: "total_corruption" - name: "Total Transformation" - advance_when: "meters.emma.corruption >= 90" - unlocks: - endings: ["emma_bad_girl_ending"] - - # === ZOE ROMANCE === - - id: "zoe_romance" - name: "Zoe's Wild Romance" + - id: "study_buddies" + title: "Study Buddies" + advance_when: "flags.emma_study_session == true" + on_enter: + - type: "meter_change" + target: "emma" + meter: "trust" + op: "add" + value: 5 + - id: "slow_burn" + title: "Slow Burn" + advance_when: "meters.emma.trust >= 55 and meters.emma.attraction >= 45" + on_enter: + - type: "meter_change" + target: "emma" + meter: "attraction" + op: "add" + value: 5 + - id: "shared_future" + title: "Shared Future" + advance_when: "flags.emma_final_choice == true" + on_enter: + - type: "unlock" + endings: ["ending_emma"] + + - id: "zoe_path" + title: "Zoe's Spotlight" character: "zoe" category: "romance" - description: "Navigate a passionate relationship with the bold and experienced Zoe." stages: - - id: "flirty_start" - name: "Playful Flirtation" - advance_when: "flags.zoe_flirted == true" - - - id: "mutual_attraction" - name: "Mutual Attraction" - advance_when: "meters.zoe.attraction >= 40 and meters.zoe.trust >= 30" - effects_on_advance: - - { type: "flag_set", key: "zoe_interested", value: true } - - - id: "passionate_affair" - name: "Passionate Connection" - advance_when: "flags.zoe_first_kiss == true and meters.zoe.attraction >= 60" - unlocks: - endings: ["zoe_romance_ending"] - - - id: "exclusive_relationship" - name: "Exclusive Partners" - advance_when: "meters.zoe.trust >= 70 and meters.zoe.attraction >= 80 and flags.chose_zoe == true" - unlocks: - endings: ["zoe_exclusive_ending"] \ No newline at end of file + - id: "backstage_pass" + title: "Backstage Pass" + advance_when: "flags.zoe_band_invite == true" + on_enter: + - type: "meter_change" + target: "zoe" + meter: "trust" + op: "add" + value: 5 + - id: "duet" + title: "Duet" + advance_when: "meters.zoe.attraction >= 55 and meters.zoe.trust >= 45" + on_enter: + - type: "meter_change" + target: "zoe" + meter: "attraction" + op: "add" + value: 5 + - id: "tour_partner" + title: "Tour Partner" + advance_when: "flags.zoe_final_choice == true" + on_enter: + - type: "unlock" + endings: ["ending_zoe"] diff --git a/games/college_romance/characters.yaml b/games/college_romance/characters.yaml index 339f90b..698ad9d 100644 --- a/games/college_romance/characters.yaml +++ b/games/college_romance/characters.yaml @@ -1,281 +1,110 @@ -# =============================== -# Characters - College Romance (v3 Spec) -# =============================== - characters: - id: "player" name: "You" - age: 19 - gender: "male" + age: 20 + gender: "unspecified" pronouns: ["you"] + appearance: "A sophomore trying to juggle labs and late nights, with a quick smile and quicker walk across campus." + dialogue_style: "Curious, a little self-deprecating, earnest when it counts." + clothing: + outfit: "player_campus_ready" inventory: - dorm_key: 1 - wardrobe: - outfits: - - id: "player_casual" - name: "Casual Campus Wear" - tags: ["default"] - layers: - top: { item: "t-shirt", color: "gray" } - bottom: { item: "jeans" } - feet: { item: "sneakers" } + items: [] - id: "emma" name: "Emma Chen" age: 19 gender: "female" pronouns: ["she", "her"] - role: "love_interest" - dialogue_style: "soft-spoken, thoughtful, uses 'um' and 'like' when nervous" - author_notes: "Emma is shy and studious. She has two paths: purity (slow romance) and corruption (bold experimentation)." - - meters: - trust: { default: 10 } - attraction: { default: 5 } - arousal: { default: 0 } - boldness: { default: 15 } - corruption: { default: 0 } - + dialogue_style: "Soft-spoken, thoughtful, peppering sentences with careful pauses." personality: - core_traits: ["shy", "studious", "kind", "curious"] - values: ["honesty", "academic success", "trust"] - fears: ["judgment", "failure", "embarrassment"] - desires: ["connection", "acceptance", "new experiences"] - quirks: ["tucks hair behind ear when nervous", "bites lower lip when thinking"] - - appearance: - base: - height: "162 cm" - build: "petite, slender" - hair: { color: "black", length: "shoulder-length", style: "straight, often in ponytail" } - eyes: { color: "dark brown" } - skin: { color: "light", tone: "warm" } - style: ["modest", "neat", "feminine"] - - wardrobe: - rules: - layer_order: ["outerwear", "top", "bottom", "feet", "accessories", "underwear_top", "underwear_bottom"] - required_layers: ["top", "bottom"] - sexual_layers: ["underwear_top", "underwear_bottom"] - - outfits: - - id: "emma_casual" - name: "Campus Casual" - tags: ["default"] - layers: - outerwear: { item: "cardigan", color: "cream" } - top: { item: "blouse", color: "pastel pink" } - bottom: { item: "jeans", style: "high-waist" } - feet: { item: "sneakers", color: "white" } - underwear_top: { item: "bra", style: "plain cotton" } - underwear_bottom: { item: "panties", style: "cotton bikini" } - accessories: { item: "small backpack" } - - - id: "emma_bold" - name: "Bold Weekend Outfit" - tags: ["unlockable"] - unlock_when: "meters.emma.corruption >= 40 or meters.emma.boldness >= 60" - layers: - top: { item: "crop top", color: "black" } - bottom: { item: "mini skirt", color: "red" } - feet: { item: "ankle boots", color: "black" } - underwear_top: { item: "lace bra", style: "push-up" } - underwear_bottom: { item: "thong", style: "lace" } - accessories: { item: "choker necklace" } - - behaviors: - gates: - - id: "accept_compliment" - when: "always" - - - id: "accept_flirting" - when_any: - - "meters.emma.trust >= 25" - - "meters.emma.corruption >= 20" - - - id: "accept_date" - when_any: - - "meters.emma.attraction >= 35 and meters.emma.trust >= 30" - - "meters.emma.corruption >= 30" - - - id: "accept_kiss" - when_any: - - "meters.emma.attraction >= 50 and meters.emma.trust >= 45" - - "meters.emma.corruption >= 40 and meters.emma.arousal >= 30" - - - id: "accept_touching" - when_all: - - "meters.emma.arousal >= 50" - - "(meters.emma.trust >= 60) or (meters.emma.corruption >= 50)" - - "location.privacy in ['medium', 'high']" - - - id: "accept_oral" - when_all: - - "meters.emma.arousal >= 70" - - "(meters.emma.trust >= 75) or (meters.emma.corruption >= 65)" - - "location.privacy == 'high'" - - - id: "accept_sex" - when_all: - - "meters.emma.arousal >= 80" - - "(meters.emma.trust >= 85 and meters.emma.attraction >= 85) or (meters.emma.corruption >= 75)" - - "location.privacy == 'high'" - - "(has('condoms') and flags.protection_discussed == true) or meters.emma.corruption >= 85" - - refusals: - generic: "She pulls back, cheeks warm. 'Not yet... I'm not ready.'" - low_trust: "She shakes her head gently. 'I don't know you well enough yet.'" - wrong_place: "She glances around nervously. 'Not here... someone might see.'" - too_fast: "She looks overwhelmed. 'This is moving too fast for me.'" - - movement: - willing_locations: - - { location: "player_room", when: "meters.emma.trust >= 50" } - - { location: "library", when: "always" } - - { location: "cafeteria", when: "always" } - - { location: "campus_cafe", when: "always" } - - { location: "emma_room", when: "flags.emma_invited_you_over == true" } - - refusal_text: - low_trust: "She hesitates. 'I don't think I should go there with you yet... sorry.'" - uncomfortable: "She looks uncertain. 'Maybe another time?'" - + core_traits: "studious, kind, observant" + quirks: "alphabetizes her notes; hums study playlists under her breath" + values: "consistency, quiet bravery, follow-through" + appearance: "Emma keeps her dark hair clipped back, a sage sweater layered neatly over pressed slacks." + gates: + - id: "accept_compliment" + when: "true" + acceptance: "Emma's smile grows shy. \"Thanks... I needed to hear that today.\"" + refusal: "She ducks her head. \"I'm not sure what to say to that.\"" + - id: "study_together" + when: "meters.emma.trust >= 25" + acceptance: "\"Sure! I could use company—just promise not to distract me too much.\"" + refusal: "\"Maybe another time? I really have to focus right now.\"" + - id: "accept_date" + when_all: + - "meters.emma.trust >= 40" + - "meters.emma.attraction >= 35" + acceptance: "Emma exhales, cheeks flushed. \"I'd like that... let's plan something calm.\"" + refusal: "She squeezes her notebook. \"I'm not ready for that yet.\"" + - id: "share_number" + when: "meters.emma.trust >= 45" + acceptance: "\"Here—text me so I have your number too.\"" + refusal: "\"Maybe after the midterm? It's nothing personal.\"" + - id: "accept_kiss" + when_all: + - "meters.emma.trust >= 55" + - "meters.emma.attraction >= 55" + acceptance: "She rises on her toes, letting the moment linger between you." + refusal: "She steps back gently. \"I'm not there yet.\"" + clothing: + outfit: "emma_study_chic" schedule: - - when: "time.weekday in ['monday', 'tuesday', 'wednesday', 'thursday', 'friday'] and time.slot == 'afternoon'" - location: "library" - - - when: "time.weekday in ['monday', 'wednesday', 'friday'] and time.slot == 'morning'" - location: "lecture_hall" - - - when: "time.weekday in ['saturday', 'sunday'] and time.slot == 'afternoon'" + - when: "time.slot == 'morning'" + location: "campus_dorm_room" + - when: "time.slot == 'afternoon'" + location: "campus_library" + - when: "time.slot == 'evening'" location: "campus_cafe" + inventory: + items: + - id: "textbook_stats" + count: 1 - id: "zoe" name: "Zoe Martinez" age: 21 gender: "female" pronouns: ["she", "her"] - role: "alt_love_interest" - dialogue_style: "confident, playful, uses nicknames like 'handsome' and 'sweetheart'" - author_notes: "Zoe is bold and experienced. She's the 'wild' option compared to Emma's innocence." - - meters: - trust: { default: 20 } - attraction: { default: 15 } - arousal: { default: 0 } - boldness: { default: 65 } - corruption: { default: 40 } - + dialogue_style: "Playful, confident, sprinkling in nicknames and stage metaphors." personality: - core_traits: ["confident", "flirty", "adventurous", "direct"] - values: ["honesty", "fun", "authenticity"] - desires: ["excitement", "passion", "connection"] - quirks: ["winks when flirting", "touches people when talking"] - - appearance: - base: - height: "168 cm" - build: "athletic, curvy" - hair: { color: "auburn", length: "mid-back", style: "wavy, loose" } - eyes: { color: "hazel" } - skin: { color: "olive", tone: "warm" } - style: ["bold", "fashionable", "sexy"] - - wardrobe: - outfits: - - id: "zoe_cafe" - name: "Barista Outfit" - tags: ["default", "work"] - layers: - top: { item: "fitted t-shirt", color: "black" } - bottom: { item: "tight jeans", color: "dark blue" } - feet: { item: "boots", style: "ankle" } - underwear_top: { item: "lace bra", style: "demi-cup" } - underwear_bottom: { item: "lace panties", style: "cheeky" } - - - id: "zoe_club" - name: "Night Out" - tags: ["party"] - layers: - top: { item: "halter top", color: "emerald green" } - bottom: { item: "leather pants", color: "black" } - feet: { item: "heels", style: "stiletto" } - underwear_top: { item: "strapless bra", style: "lace" } - underwear_bottom: { item: "thong", style: "lace" } - - behaviors: - gates: - - id: "accept_flirting" - when: "meters.zoe.attraction >= 15" - - - id: "accept_date" - when: "meters.zoe.attraction >= 30 and meters.zoe.trust >= 25" - - - id: "accept_kiss" - when_any: - - "meters.zoe.attraction >= 40" - - "location.privacy in ['medium', 'high']" - - - id: "accept_touching" - when_all: - - "meters.zoe.attraction >= 50" - - "meters.zoe.arousal >= 40" - - "location.privacy in ['medium', 'high']" - - - id: "accept_sex" - when_all: - - "meters.zoe.arousal >= 70" - - "meters.zoe.attraction >= 60" - - "location.privacy == 'high'" - - refusals: - generic: "She smirks. 'Hold on there, tiger. Not quite yet.'" - wrong_place: "She laughs. 'As much as I'd love to, not here.'" - + core_traits: "bold, loyal, improvisational" + quirks: "keeps drumsticks in her bag; quotes song lyrics mid-conversation" + values: "authenticity, creative sparks, showing up" + appearance: "Zoe's auburn hair is messy on purpose, band tee knotted at the waist, boots echoing with each step." + gates: + - id: "accept_compliment" + when: "true" + acceptance: "\"Keep talking like that and I'll write a song about you.\"" + refusal: "She arches a brow. \"Flattery needs rhythm—try again.\"" + - id: "invite_backstage" + when_any: + - "meters.zoe.trust >= 30" + - "flags.zoe_band_invite == true" + acceptance: "\"Come by the venue. I want you to hear the new bridge.\"" + refusal: "\"The set's messy tonight. Rain check?\"" + - id: "accept_date" + when_all: + - "meters.zoe.attraction >= 40" + - "meters.zoe.trust >= 35" + acceptance: "\"Name the night and I'll clear my setlist.\"" + refusal: "\"Feels too soon, darling. Let's ride the vibe a bit longer.\"" + - id: "accept_kiss" + when_any: + - "meters.zoe.attraction >= 45" + - "flags.zoe_band_invite == true" + acceptance: "She hooks a finger under your chin, grin widening before she closes the distance." + refusal: "She presses a palm to your chest. \"Tease.\"" + clothing: + outfit: "zoe_stage_wear" schedule: - - when: "time.weekday in ['monday', 'tuesday', 'wednesday', 'thursday', 'friday'] and time.slot in ['afternoon', 'evening']" + - when: "time.slot == 'afternoon'" location: "campus_cafe" - - - when: "time.weekday == 'friday' and time.slot == 'night'" - location: "night_club" - - - when: "time.weekday == 'saturday' and time.slot == 'night'" - location: "night_club" - - - id: "liam" - name: "Liam Park" - age: 20 - gender: "male" - pronouns: ["he", "him"] - role: "friend" - dialogue_style: "casual, bro-ish, supportive" - author_notes: "Liam is your gym buddy and wingman. Provides friendship path and advice." - - meters: - trust: { default: 35 } - attraction: { default: 0 } - boldness: { default: 50 } - - personality: - core_traits: ["supportive", "loyal", "easygoing", "direct"] - - appearance: - base: - height: "180 cm" - build: "athletic, fit" - hair: { color: "black", style: "short, messy" } - - behaviors: - gates: - - id: "workout_buddy" - when: "location.id == 'gym'" - - - id: "give_advice" - when: "meters.liam.trust >= 40" - - schedule: - - when: "time.weekday in ['monday', 'wednesday', 'friday'] and time.slot == 'morning'" - location: "gym" - - - when: "time.slot == 'noon'" - location: "cafeteria" \ No newline at end of file + - when: "time.slot == 'evening'" + location: "downtown_music_venue" + - when: "time.slot == 'night'" + location: "downtown_city_rooftop" + inventory: + items: + - id: "guitar_pick" + count: 1 diff --git a/games/college_romance/events.yaml b/games/college_romance/events.yaml index 009911a..1c1ae3f 100644 --- a/games/college_romance/events.yaml +++ b/games/college_romance/events.yaml @@ -1,147 +1,56 @@ -# =============================== -# Events - College Romance (v3 Spec) -# =============================== - events: - - id: "monday_blues" - title: "Monday Morning Blues" - category: "ambient" - scope: "global" - trigger: - scheduled: - - when: "time.weekday == 'monday' and time.slot == 'morning'" - narrative: "It's Monday morning. The campus feels sluggish as students drag themselves to their first classes of the week." - effects: - - { type: "meter_change", target: "player", meter: "energy", op: "subtract", value: 5 } - cooldown: { turns: 10 } - - - id: "emma_text_thinking" - title: "Emma's Text" - category: "relationship" - scope: "global" - trigger: - conditional: - - when: "time.slot in ['night', 'late_night'] and time.day >= 3 and meters.emma.attraction >= 35 and not npc_present('emma')" - narrative: "Your phone buzzes. It's a text from Emma: 'Hey... can't sleep. Been thinking about you. 😊'" - choices: - - id: "invite_emma" - prompt: "Invite her over" - conditions: "meters.emma.trust >= 50 and location.id == 'player_room'" - effects: - - { type: "flag_set", key: "emma_coming_over", value: true } - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 10 } - - { type: "meter_change", target: "emma", meter: "arousal", op: "add", value: 15 } - goto: "emma_night_visit" - - - id: "sweet_reply" - prompt: "Send a sweet message back" - effects: - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 5 } - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 5 } - cooldown: { turns: 7 } - - - id: "gym_with_liam" - title: "Workout Buddy Liam" - category: "friendship" - scope: "location" - location: "gym" - trigger: - location_enter: true - narrative: "Liam spots you from across the gym and waves enthusiastically. 'Yo! Let's hit some weights together, bro!'" - choices: - - id: "workout_with_liam" - prompt: "Work out with Liam" - effects: - - { type: "meter_change", target: "player", meter: "body", op: "add", value: 8 } - - { type: "meter_change", target: "player", meter: "energy", op: "subtract", value: 20 } - - { type: "meter_change", target: "liam", meter: "trust", op: "add", value: 5 } - - { type: "advance_time", minutes: 60 } - - - id: "decline_workout" - prompt: "Politely decline" - effects: - - { type: "meter_change", target: "liam", meter: "trust", op: "subtract", value: 2 } - cooldown: { turns: 3 } - - - id: "zoe_at_cafe" - title: "Zoe on Shift" - category: "relationship" - scope: "location" - location: "campus_cafe" - trigger: - conditional: - - when: "time.weekday in ['monday', 'tuesday', 'wednesday', 'thursday', 'friday'] and time.slot in ['afternoon', 'evening']" - narrative: "Zoe is working behind the counter. She notices you and shoots you a wink. 'Well, well. What can I get you, handsome?'" + - id: "emma_quad_wave" + type: "event" + title: "Emma Waves You Over" + characters_present: ["emma"] + when: "state.location.id == 'campus_quad' and time.slot == 'afternoon' and flags.met_emma == false" + probability: 100 + cooldown: 1 + once_per_game: true + beats: + - "Emma spots you across the quad, closing her textbook with a hopeful smile." choices: - - id: "flirt_with_zoe" - prompt: "Flirt back" - conditions: "gates.zoe.accept_flirting" - effects: - - { type: "meter_change", target: "zoe", meter: "attraction", op: "add", value: 8 } - - { type: "meter_change", target: "zoe", meter: "arousal", op: "add", value: 5 } - - { type: "flag_set", key: "zoe_flirted", value: true } - - - id: "just_order" - prompt: "Just order coffee ($3)" - conditions: "meters.player.money >= 3" - effects: - - { type: "meter_change", target: "player", meter: "money", op: "subtract", value: 3 } - - { type: "meter_change", target: "player", meter: "energy", op: "add", value: 10 } - cooldown: { turns: 2 } - - - id: "club_invitation" - title: "Club Night Invitation" - category: "social" - scope: "global" - trigger: - conditional: - - when: "time.weekday == 'friday' and time.slot == 'evening' and meters.player.confidence >= 40" - narrative: "Your phone buzzes with a group message: 'Pulse Nightclub tonight! Who's coming?' Several people have already said yes." + - id: "emma_event_greet" + prompt: "Cross the grass and say hi." + on_select: + - type: "flag_set" + key: "met_emma" + value: true + - type: "meter_change" + target: "emma" + meter: "trust" + op: "add" + value: 6 + - type: "goto" + node: "quad_catchup" + + - id: "zoe_pop_up_gig" + type: "event" + title: "Pop-Up Gig Invitation" + characters_present: ["zoe"] + when: "state.location.id == 'campus_cafe' and time.slot == 'evening' and flags.met_zoe == true and flags.zoe_band_invite == false" + probability: 60 + cooldown: 2 + beats: + - "Zoe leans over the counter, lowering her voice conspiratorially." + - "\"We're playing a pop-up set downtown tonight. You in?\"" choices: - - id: "accept_club" - prompt: "Say you'll go" - effects: - - { type: "flag_set", key: "invited_to_club", value: true } - - { type: "flag_set", key: "knows_downtown", value: true } - - - id: "decline_club" - prompt: "Stay in tonight" - effects: - - { type: "meter_change", target: "player", meter: "confidence", op: "subtract", value: 3 } - cooldown: { turns: 15 } - - - id: "midterms_reminder" - title: "Midterms Week" - category: "academic" - scope: "global" - trigger: - scheduled: - - when: "time.day == 14 and time.slot == 'morning'" - once: true - narrative: "It's midterms week. The campus is buzzing with stressed-out students cramming for exams. You need to study hard to maintain your grades." - effects: - - { type: "flag_set", key: "midterms_week", value: true } - - - id: "random_compliment" - title: "Random Compliment" - category: "ambient" - scope: "global" - trigger: - random: - weight: 15 - cooldown: 10 - narrative: "A passing student smiles at you. 'Nice outfit!' They're gone before you can respond, but it boosts your mood." - effects: - - { type: "meter_change", target: "player", meter: "confidence", op: "add", value: 3 } - - - id: "found_money" - title: "Found Money" - category: "ambient" - scope: "global" - trigger: - random: - weight: 10 - cooldown: 15 - narrative: "You spot a $10 bill on the ground. Lucky you!" - effects: - - { type: "meter_change", target: "player", meter: "money", op: "add", value: 10 } \ No newline at end of file + - id: "zoe_event_accept" + prompt: "Promise to be there." + on_select: + - type: "flag_set" + key: "zoe_band_invite" + value: true + - type: "meter_change" + target: "zoe" + meter: "trust" + op: "add" + value: 5 + - id: "zoe_event_decline" + prompt: "Apologize and admit you have to study." + on_select: + - type: "meter_change" + target: "zoe" + meter: "trust" + op: "subtract" + value: 3 diff --git a/games/college_romance/flags.yaml b/games/college_romance/flags.yaml deleted file mode 100644 index 165555f..0000000 --- a/games/college_romance/flags.yaml +++ /dev/null @@ -1,112 +0,0 @@ -# =============================== -# Flags - College Romance (v3 Spec) -# =============================== - -flags: - game_started: - type: "bool" - default: false - visible: false - description: "Set to true after intro." - - emma_met: - type: "bool" - default: false - visible: true - label: "Met Emma" - description: "Set true after first meeting Emma." - - emma_invited_you_over: - type: "bool" - default: false - visible: false - description: "Emma has invited you to her room." - - emma_first_kiss: - type: "bool" - default: false - visible: true - label: "First Kiss with Emma" - description: "You've shared your first kiss with Emma." - - emma_first_intimate: - type: "bool" - default: false - visible: false - description: "You've been intimate with Emma." - - gave_emma_flowers: - type: "bool" - default: false - visible: false - description: "You gave Emma flowers." - - protection_discussed: - type: "bool" - default: false - visible: false - description: "You and Emma have discussed protection." - - zoe_met: - type: "bool" - default: false - visible: true - label: "Met Zoe" - description: "Set true after first meeting Zoe." - - zoe_flirted: - type: "bool" - default: false - visible: false - description: "You've flirted with Zoe." - - zoe_first_kiss: - type: "bool" - default: false - visible: true - label: "First Kiss with Zoe" - description: "You've shared your first kiss with Zoe." - - liam_met: - type: "bool" - default: false - visible: true - label: "Met Liam" - description: "Set true after first meeting Liam." - - knows_downtown: - type: "bool" - default: false - visible: false - description: "You know about downtown area." - - invited_to_club: - type: "bool" - default: false - visible: false - description: "Someone invited you to the nightclub." - - route_locked: - type: "bool" - default: false - visible: false - description: "You've committed to a romantic path." - - chose_emma: - type: "bool" - default: false - visible: false - description: "You chose Emma as your romantic focus." - - chose_zoe: - type: "bool" - default: false - visible: false - description: "You chose Zoe as your romantic focus." - - midterms_completed: - type: "bool" - default: false - visible: true - label: "Completed Midterms" - description: "You've finished your midterm exams." \ No newline at end of file diff --git a/games/college_romance/game.yaml b/games/college_romance/game.yaml index 0972eda..3e49e69 100644 --- a/games/college_romance/game.yaml +++ b/games/college_romance/game.yaml @@ -1,104 +1,140 @@ -# =============================== -# Game Manifest - College Romance (v3 Spec) -# A comprehensive college dating sim testing all engine features -# =============================== - meta: id: "college_romance" - title: "College Romance: Emma & Zoe" - version: "1.0.0" - spec_version: "3.1" + title: "Campus Hearts" + version: "1.1.0" authors: ["PlotPlay Team"] - content_rating: "explicit" - tags: ["romance", "college", "slice_of_life", "nsfw", "stat-building", "multiple-routes"] - description: "Navigate college life while building relationships with Emma and Zoe. Manage your stats, make choices, and unlock different romance paths." + description: "Balance lectures, late nights, and two very different crushes during your first week back on campus." + content_warnings: ["alcohol references", "romance"] nsfw_allowed: true + license: "CC-BY-NC-4.0" -# Starting point -start: - node: "intro_dorm" - location: { zone: "campus", id: "player_room" } - -# Narration style narration: pov: "second" tense: "present" paragraphs: "2-3" - token_budget: 350 - checker_budget: 220 -# Global meters +start: + location: "campus_dorm_room" + node: "intro_dorm" + day: 1 + slot: "morning" + time: "08:00" + meters: player: - energy: { min: 0, max: 100, default: 70, visible: true, icon: "⚡", decay_per_slot: -10 } - money: { min: 0, max: 999, default: 60, visible: true, icon: "💵", format: "currency" } - mind: { min: 0, max: 100, default: 30, visible: true, icon: "🧠" } - body: { min: 0, max: 100, default: 30, visible: true, icon: "💪" } - looks: { min: 0, max: 100, default: 40, visible: true, icon: "✨" } - hygiene: { min: 0, max: 100, default: 70, visible: true, icon: "🧼", decay_per_slot: -8 } + energy: + min: 0 + max: 100 + default: 70 + visible: true + icon: "⚡" + decay_per_slot: -8 + money: + min: 0 + max: 500 + default: 60 + visible: true + icon: "💵" + format: "currency" + mind: + min: 0 + max: 100 + default: 35 + visible: true + icon: "🧠" + charm: + min: 0 + max: 100 + default: 40 + visible: true + icon: "✨" + template: + trust: + min: 0 + max: 100 + default: 15 + visible: false + thresholds: + distant: { min: 0, max: 29 } + friendly: { min: 30, max: 59 } + close: { min: 60, max: 79 } + devoted: { min: 80, max: 100 } + attraction: + min: 0 + max: 100 + default: 10 + visible: false + thresholds: + curious: { min: 0, max: 39 } + intrigued: { min: 40, max: 69 } + smitten: { min: 70, max: 100 } + stress: + min: 0 + max: 100 + default: 20 + visible: false - character_template: - trust: { - min: 0, max: 100, default: 10, - thresholds: { stranger: [0, 19], acquaintance: [20, 39], friend: [40, 69], close: [70, 89], intimate: [90, 100] } - } - attraction: { - min: 0, max: 100, default: 5, - thresholds: { none: [0, 19], interested: [20, 39], attracted: [40, 69], infatuated: [70, 89], in_love: [90, 100] } - } - arousal: { min: 0, max: 100, default: 0, hidden_until: "meters.{character}.attraction >= 30" } - boldness: { min: 0, max: 100, default: 20, hidden_until: "meters.{character}.trust >= 30" } - corruption: { min: 0, max: 100, default: 0 } +flags: + met_emma: + type: "bool" + default: false + visible: false + met_zoe: + type: "bool" + default: false + visible: false + emma_study_session: + type: "bool" + default: false + visible: false + zoe_band_invite: + type: "bool" + default: false + visible: false + evening_choice_made: + type: "bool" + default: false + visible: false + emma_final_choice: + type: "bool" + default: false + visible: false + zoe_final_choice: + type: "bool" + default: false + visible: false -# Movement rules -movement: - local: - base_time: 5 - distance_modifiers: - immediate: 0 - short: 1 - medium: 2 - long: 3 - restrictions: - min_energy: 5 - energy_cost_per_move: 2 - -# Time system with calendar time: mode: "hybrid" - slots: ["morning", "noon", "afternoon", "evening", "night", "late_night"] + slots: ["morning", "afternoon", "evening", "night"] actions_per_slot: 3 - auto_advance: true - - clock: - minutes_per_day: 1440 - slot_windows: - morning: { start: "06:00", end: "10:59" } - noon: { start: "11:00", end: "13:59" } - afternoon: { start: "14:00", end: "17:59" } - evening: { start: "18:00", end: "20:59" } - night: { start: "21:00", end: "23:59" } - late_night: { start: "00:00", end: "05:59" } + minutes_per_action: 45 + slot_windows: + morning: { start: "06:00", end: "10:59" } + afternoon: { start: "11:00", end: "16:59" } + evening: { start: "17:00", end: "21:59" } + night: { start: "22:00", end: "02:59" } - calendar: - enabled: true - epoch: "2025-09-01" - week_days: ["monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"] - start_day: "monday" +economy: + enabled: true + starting_money: 60 + max_money: 500 + currency_name: "dollars" + currency_symbol: "$" - start: - day: 1 - slot: "morning" - time: "08:30" +movement: + base_time: 1 + use_entry_exit: false + methods: + - walk: 1 + - bike: 1 -# Included content files includes: + - "items.yaml" - "characters.yaml" - - "flags.yaml" - - "modifiers.yaml" - "locations.yaml" - - "items.yaml" + - "modifiers.yaml" - "actions.yaml" - "events.yaml" - "arcs.yaml" - - "nodes.yaml" \ No newline at end of file + - "nodes.yaml" diff --git a/games/college_romance/items.yaml b/games/college_romance/items.yaml index 86e6742..30cabe6 100644 --- a/games/college_romance/items.yaml +++ b/games/college_romance/items.yaml @@ -1,124 +1,136 @@ -# =============================== -# Items - College Romance (v3 Spec) -# =============================== - items: - - id: "dorm_key" - name: "Dorm Room Key" - category: "key" - description: "Your dorm room key. Don't lose it or you'll pay a $50 replacement fee." - stackable: false - droppable: false - unlocks: - location: "player_room" - - - id: "condoms" - name: "Condoms" - category: "consumable" - description: "A pack of condoms. Responsible protection for intimate moments." - icon: "🎈" - value: 10 - stackable: true - consumable: false - obtain_conditions: - - "meters.player.confidence >= 30" - - - id: "flowers" - name: "Bouquet of Flowers" - category: "gift" - description: "Fresh roses wrapped neatly. A classic romantic gesture." - icon: "💐" - value: 20 - stackable: false - consumable: true - can_give: true - gift_effects: - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 15 } - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 10 } - - { type: "flag_set", key: "gave_emma_flowers", value: true } - - - id: "textbook" - name: "Psychology Textbook" - category: "consumable" - description: "A heavy textbook for your psych class. Study it to boost your mind stat." - icon: "📚" - value: 30 - stackable: true - consumable: true - use_text: "You crack open the textbook and study for an hour, absorbing new concepts." - effects_on_use: - - { type: "meter_change", target: "player", meter: "mind", op: "add", value: 8 } - - { type: "meter_change", target: "player", meter: "energy", op: "subtract", value: 15 } - - { type: "advance_time", minutes: 60 } - - - id: "protein_shake" - name: "Protein Shake" - category: "consumable" - description: "A chalky but effective protein shake. Good for post-workout recovery." - icon: "🥤" + - id: "coffee_cup" + name: "Campus Cafe Latte" + category: "drink" + description: "A steadying latte from the student cafe, sweetened with hazelnut." value: 5 stackable: true consumable: true - use_text: "You chug the protein shake. It tastes awful but you feel energized." - effects_on_use: - - { type: "meter_change", target: "player", meter: "energy", op: "add", value: 15 } - - { type: "meter_change", target: "player", meter: "body", op: "add", value: 2 } - - - id: "energy_drink" - name: "Energy Drink" - category: "consumable" - description: "A can of caffeinated energy drink. Restores energy quickly." - icon: "⚡" - value: 3 - stackable: true - consumable: true - use_text: "You crack open the can and down it. A jittery surge of energy hits you." - effects_on_use: - - { type: "meter_change", target: "player", meter: "energy", op: "add", value: 25 } - - { type: "meter_change", target: "player", meter: "hygiene", op: "subtract", value: 3 } - - - id: "shower_supplies" - name: "Shower Supplies" - category: "consumable" - description: "Soap, shampoo, and deodorant. Essential for basic hygiene." - icon: "🧼" - value: 8 - stackable: true - consumable: true - use_text: "You take a refreshing shower, washing away the day's grime." - effects_on_use: - - { type: "meter_change", target: "player", meter: "hygiene", op: "set", value: 90 } - - { type: "meter_change", target: "player", meter: "energy", op: "add", value: 5 } - - { type: "advance_time", minutes: 20 } - - - id: "stylish_outfit" - name: "Stylish New Outfit" - category: "equipment" - description: "A trendy outfit that makes you look sharp. Boosts your looks stat when you wear it." - icon: "👔" - value: 50 + use_text: "You sip the latte and feel the rush of caffeine sharpen your focus." + on_use: + - type: "meter_change" + target: "player" + meter: "energy" + op: "add" + value: 8 + - id: "textbook_stats" + name: "Applied Statistics Textbook" + category: "study" + description: "Emma's favorite study companion, covered in color-coded tabs." + value: 45 stackable: false - tags: ["clothing"] - slots: ["outfit"] - stat_mods: - looks: 15 - - - id: "cologne" - name: "Nice Cologne" - category: "consumable" - description: "A bottle of attractive cologne. Makes you smell good for dates." - icon: "💧" - value: 25 - stackable: true - consumable: true - use_text: "You spray on some cologne. You smell great now." - effects_on_use: - - { type: "meter_change", target: "player", meter: "looks", op: "add", value: 5 } - - { type: "apply_modifier", character: "player", modifier_id: "smells_good", duration_min: 120 } - - - id: "phone" - name: "Your Phone" - category: "misc" - description: "Your smartphone. Keeps you connected." + droppable: false + on_use: + - type: "meter_change" + target: "player" + meter: "mind" + op: "add" + value: 5 + - id: "guitar_pick" + name: "Zoe's Lucky Guitar Pick" + category: "music" + description: "An amber pick etched with a tiny lightning bolt." + value: 15 stackable: false - droppable: false \ No newline at end of file + droppable: false + - id: "concert_ticket" + name: "Basement Concert Ticket" + category: "event" + description: "Entry to Zoe's underground show—once per night only." + value: 12 + stackable: false + droppable: false + +wardrobe: + slots: ["outerwear", "top", "bottom", "feet", "accessory"] + items: + - id: "player_outer_denim" + name: "Light Denim Jacket" + value: 60 + look: + intact: "A light denim jacket with worn elbows and enamel pins." + occupies: ["outerwear"] + conceals: ["top"] + - id: "player_top_graphic" + name: "Graphic Tee" + value: 25 + look: + intact: "A black tee with a minimalist campus skyline print." + occupies: ["top"] + conceals: [] + - id: "player_bottom_black_jeans" + name: "Black Jeans" + value: 40 + look: + intact: "Slim black jeans comfortable enough for sprints across campus." + occupies: ["bottom"] + conceals: [] + - id: "player_shoes_sneakers" + name: "Canvas Sneakers" + value: 35 + look: + intact: "Well-loved canvas sneakers with neon laces." + occupies: ["feet"] + conceals: [] + - id: "emma_top_cable" + name: "Cable-Knit Sweater" + value: 55 + look: + intact: "A soft cable-knit sweater in sage green." + occupies: ["top"] + conceals: [] + - id: "emma_bottom_slacks" + name: "Tailored Slacks" + value: 65 + look: + intact: "Sharp charcoal slacks with pressed seams." + occupies: ["bottom"] + conceals: [] + - id: "emma_shoes_loafers" + name: "Leather Loafers" + value: 70 + look: + intact: "Polished loafers that clack smartly along the library floors." + occupies: ["feet"] + conceals: [] + - id: "zoe_top_bandtee" + name: "Vintage Band Tee" + value: 45 + look: + intact: "A vintage band tee with cracked ink and rolled sleeves." + occupies: ["top"] + conceals: [] + - id: "zoe_bottom_ripped_jeans" + name: "Ripped Jeans" + value: 50 + look: + intact: "Charcoal ripped jeans dusted with a hint of stage glitter." + occupies: ["bottom"] + conceals: [] + - id: "zoe_shoes_boots" + name: "Studded Boots" + value: 80 + look: + intact: "Studded black boots with a satisfying stomp." + occupies: ["feet"] + conceals: [] + - id: "zoe_accessory_bandana" + name: "Printed Bandana" + value: 20 + look: + intact: "A red bandana knotted around her wrist." + occupies: ["accessory"] + conceals: [] + outfits: + - id: "player_campus_ready" + name: "Campus Ready" + items: ["player_outer_denim", "player_top_graphic", "player_bottom_black_jeans", "player_shoes_sneakers"] + grant_items: true + - id: "emma_study_chic" + name: "Study Chic" + items: ["emma_top_cable", "emma_bottom_slacks", "emma_shoes_loafers"] + grant_items: true + - id: "zoe_stage_wear" + name: "Stage Wear" + items: ["zoe_top_bandtee", "zoe_bottom_ripped_jeans", "zoe_shoes_boots", "zoe_accessory_bandana"] + grant_items: true diff --git a/games/college_romance/locations.yaml b/games/college_romance/locations.yaml index 13cfb76..bc6b2eb 100644 --- a/games/college_romance/locations.yaml +++ b/games/college_romance/locations.yaml @@ -1,177 +1,90 @@ -# =============================== -# Locations - College Romance (v3 Spec) -# =============================== - zones: - id: "campus" - name: "University Campus" - discovered: true - accessible: true - properties: - size: "large" - security: "medium" - + name: "Northbridge University" + summary: "Brick dorms, sprawling greens, and students weaving between lectures." + privacy: "low" + access: + discovered: true + connections: + - to: ["downtown"] + methods: ["walk", "bike"] + distance: 2.0 locations: - # === DORM AREA === - - id: "player_room" - name: "Your Dorm Room" - type: "private" - privacy: "high" - discovered: true - description: "Your small but cozy dorm room. A bed, desk, closet, and mini-fridge make up your personal space." - features: ["bed", "desk", "closet", "mini_fridge", "shower"] - connections: - - to: "dorm_hallway" - type: "door" - distance: "immediate" - events: - on_first_enter: - narrative: "Welcome to your home for the year. Time to make the most of college life." - effects: - - { type: "flag_set", key: "game_started", value: true } - - - id: "dorm_hallway" - name: "Dorm Hallway" - type: "public" - privacy: "low" - discovered: true - description: "A long corridor lined with dorm room doors. Students come and go at all hours." - connections: - - to: "player_room" - type: "door" - distance: "immediate" - - to: ["dorm_common", "emma_room"] - type: "hallway" - distance: "short" - - to: "campus_quad" - type: "path" - distance: "short" - - - id: "dorm_common" - name: "Dorm Common Room" - type: "public" - privacy: "low" - discovered: true - description: "A communal space with worn couches, a TV, and vending machines. Students hang out here between classes." - features: ["couch", "tv", "vending_machine", "study_table"] - connections: - - to: "dorm_hallway" - type: "hallway" - distance: "short" - - - id: "emma_room" - name: "Emma's Dorm Room" - type: "private" - privacy: "high" - discovered: false - description: "Emma's neatly organized room. Textbooks are stacked precisely, and photos of family decorate her desk." + - id: "campus_dorm_room" + name: "Dorm Room 215" + summary: "Your base of operations: mismatched posters, roommate clutter, and textbooks stacked precariously." + privacy: "medium" access: - locked: true - unlocked_when: "flags.emma_invited_you_over == true" + discovered: true connections: - - to: "dorm_hallway" - type: "door" - distance: "immediate" - - # === ACADEMIC BUILDINGS === + - to: "campus_quad" + description: "Head downstairs and cut across the quad." + direction: "e" - id: "campus_quad" - name: "Campus Quad" - type: "public" + name: "Sunlit Quad" + summary: "The quad hums with frisbees, club tables, and gossip floating on the breeze." privacy: "low" - discovered: true - description: "The heart of campus. Students lounge on the grass, toss frisbees, and rush between classes." - features: ["benches", "fountain", "grass", "bulletin_board"] connections: - - to: "dorm_hallway" - type: "path" - distance: "short" - - to: ["library", "cafeteria", "lecture_hall"] - type: "path" - distance: "short" + - to: "campus_library" + description: "Follow the stone path toward the ivy-covered library." + direction: "n" - to: "campus_cafe" - type: "path" - distance: "medium" - - - id: "library" - name: "University Library" - type: "public" + description: "Slip between buildings toward the student cafe." + direction: "s" + - to: "campus_dorm_room" + description: "Head back to the dorms." + direction: "w" + - id: "campus_library" + name: "Lambert Library" + summary: "Stacks of books, group study rooms, and hushed whispers carrying through arches." privacy: "medium" - discovered: true - description: "A quiet sanctuary of books and study carrels. The smell of old paper fills the air." - features: ["study_desks", "computers", "quiet_floor", "group_study_rooms"] - connections: - - to: "campus_quad" - type: "path" - distance: "short" - - - id: "lecture_hall" - name: "Psychology Lecture Hall" - type: "public" - privacy: "low" - discovered: true - description: "A tiered lecture hall with uncomfortable seats. The professor's voice echoes from the podium." - features: ["seats", "projector", "whiteboard"] - connections: - - to: "campus_quad" - type: "path" - distance: "short" - - - id: "cafeteria" - name: "Campus Cafeteria" - type: "public" - privacy: "low" - discovered: true - description: "Noisy and crowded at peak hours. The food is mediocre but cheap." - features: ["food_counter", "tables", "drink_station"] - connections: - - to: "campus_quad" - type: "path" - distance: "short" - - - id: "gym" - name: "Campus Recreation Center" - type: "public" - privacy: "low" - discovered: true - description: "The smell of sweat and the clang of weights. Students work out, play basketball, and stay fit." - features: ["weights", "treadmills", "basketball_court", "locker_rooms"] connections: - to: "campus_quad" - type: "path" - distance: "medium" - + description: "Push through the heavy doors back into sunlight." + direction: "s" + inventory: + items: + - id: "textbook_stats" + count: 1 - id: "campus_cafe" - name: "The Daily Grind Café" - type: "public" + name: "Bean There Cafe" + summary: "A student-run cafe with warm lighting and an ever-present indie playlist." privacy: "low" - discovered: true - description: "A cozy coffee shop on campus. Much better than cafeteria coffee, but pricier." - features: ["counter", "tables", "comfy_chairs", "study_nook"] connections: - to: "campus_quad" - type: "path" - distance: "medium" + description: "Return to the bustle of the quad." + direction: "n" + inventory: + items: + - id: "coffee_cup" + count: 3 - id: "downtown" - name: "Downtown" - discovered: false - accessible: false - discovery_conditions: - - "meters.player.confidence >= 40 or flags.knows_downtown == true" - properties: - size: "medium" - transport_connections: - - to: "campus" - methods: ["bus", "walk"] - distance: 2 - + name: "Downtown Riverfront" + summary: "String lights, food trucks, and music spilling from basement venues." + privacy: "low" + access: + discovered: false + hidden_until_discovered: true + discovered_when: "flags.met_zoe == true or flags.met_emma == true" + connections: + - to: ["campus"] + methods: ["walk", "bike"] + distance: 2.0 locations: - - id: "night_club" - name: "Pulse Nightclub" - type: "public" + - id: "downtown_music_venue" + name: "The Riff Basement" + summary: "Graffiti-splashed walls, dim lighting, and amps stacked to the ceiling." + privacy: "low" + connections: + - to: "downtown_city_rooftop" + description: "Climb the narrow staircase for fresh air." + direction: "u" + - id: "downtown_city_rooftop" + name: "Riverfront Rooftop" + summary: "A rooftop with twinkle lights, a view of the river, and the distant thump of bass." privacy: "medium" - discovered: false - description: "Pulsing music, strobe lights, and a crowded dance floor. The energy is electric." - features: ["dance_floor", "bar", "vip_booth", "bathroom"] - discovery_conditions: - - "meters.player.confidence >= 50 or flags.invited_to_club == true" \ No newline at end of file + connections: + - to: "downtown_music_venue" + description: "Head back down to the show." + direction: "d" diff --git a/games/college_romance/modifiers.yaml b/games/college_romance/modifiers.yaml index 53d556b..52d222f 100644 --- a/games/college_romance/modifiers.yaml +++ b/games/college_romance/modifiers.yaml @@ -1,91 +1,38 @@ -# =============================== -# Modifiers - College Romance (v3 Spec) -# =============================== - -modifier_system: +modifiers: + stacking: + mood: "highest" library: - aroused: - id: "aroused" - group: "emotional" - when: "meters.{character}.arousal >= 50" - appearance: - cheeks: "flushed" - eyes: "dilated" - behavior: - dialogue_style: "breathless, intimate" - inhibition: -2 - description: "Feeling desire and attraction." - - flattered: - id: "flattered" - group: "emotional" - when: "meters.alex.comfort >= 30 and meters.alex.interest >= 25" - duration_default_min: 15 - appearance: - cheeks: "slightly flushed" - eyes: "bright" - behavior: - dialogue_style: "warmer, more open" - description: "Feeling positive after a compliment or kind gesture." - - exhausted: - id: "exhausted" - group: "physical" - when: "meters.player.energy < 20" - behavior: - coordination: -2 - clamp_meters: - arousal: { max: 40 } - description: "Too tired to do much of anything effectively." - - filthy: - id: "filthy" - group: "physical" - when: "meters.player.hygiene < 25" - appearance: - skin: "grimy" + - id: "tired" + group: "mood" + when: "meters.player.energy <= 35" + priority: 5 + mixins: ["eyes heavy", "muted tone"] + dialogue_style: "slower, yawning between sentences." clamp_meters: - attraction: { max: 30 } - description: "Poor hygiene is noticeable and off-putting." - - smells_good: - id: "smells_good" - group: "cosmetic" - duration_default_min: 120 - appearance: - aura: "pleasant scent" - behavior: - inhibition: 1 - description: "Wearing cologne makes you more appealing." - - drunk: - id: "drunk" - group: "intoxication" - duration_default_min: 180 - appearance: - eyes: "glossy" - posture: "unsteady" - behavior: - inhibition: -3 - coordination: -2 - safety: - disallow_gates: ["accept_sex"] - description: "Intoxicated and impaired. Cannot consent to sex." - - confident_player: - id: "confident_player" - group: "emotional" - when: "meters.player.confidence >= 70" - behavior: - dialogue_style: "assured, smooth" - description: "High confidence makes social interactions easier." - - stacking: - default: "highest" - per_group: - emotional: "additive" - intoxication: "highest" - - exclusions: - - group: "intoxication" - exclusive: true \ No newline at end of file + charm: { min: 0, max: 80 } + on_entry: + - type: "meter_change" + target: "player" + meter: "mind" + op: "subtract" + value: 4 + on_exit: + - type: "meter_change" + target: "player" + meter: "energy" + op: "add" + value: 6 + - id: "inspired" + group: "mood" + when_any: + - "flags.zoe_band_invite == true" + - "flags.emma_study_session == true" + priority: 6 + mixins: ["eyes bright", "animated gestures"] + dialogue_style: "words come quickly, enthusiasm spilling over." + on_entry: + - type: "meter_change" + target: "player" + meter: "charm" + op: "add" + value: 5 diff --git a/games/college_romance/nodes.yaml b/games/college_romance/nodes.yaml index e1069e6..ce78fdd 100644 --- a/games/college_romance/nodes.yaml +++ b/games/college_romance/nodes.yaml @@ -1,1188 +1,411 @@ -# =============================== -# Nodes - College Romance (v3 Spec) -# Complete story flow with multiple paths -# =============================== - nodes: - # ======================================== - # INTRO & TUTORIAL - # ======================================== - - id: "intro_dorm" type: "scene" - title: "Your First Day" - beats: - - "Your first morning as a college freshman. Boxes are still half-unpacked around your dorm room." - - "A schedule of classes sits on your desk, and the possibilities feel endless." - - "Time to start your college journey." - choices: - - id: "shower_first" - prompt: "Take a shower and get ready" - conditions: "has('shower_supplies')" - effects: - - { type: "meter_change", target: "player", meter: "hygiene", op: "set", value: 90 } - - { type: "meter_change", target: "player", meter: "confidence", op: "add", value: 5 } - - { type: "advance_time", minutes: 20 } - goto: "choose_first_activity" - - - id: "skip_shower" - prompt: "Head out immediately" - goto: "choose_first_activity" - - transitions: - - { when: "always", to: "choose_first_activity" } - - - id: "choose_first_activity" - type: "hub" - title: "First Day Choices" - beats: - - "You have your whole first day ahead of you. What should you do first?" - choices: - - id: "go_to_lecture" - prompt: "Go to your first lecture (Psychology 101)" - goto: "first_lecture" - - - id: "explore_campus" - prompt: "Explore the campus" - goto: "campus_tour" - - - id: "hit_cafeteria" - prompt: "Get breakfast at the cafeteria" - goto: "cafeteria_first" - - transitions: - - { when: "always", to: "campus_hub" } - - # ======================================== - # FIRST ENCOUNTERS - # ======================================== - - - id: "first_lecture" - type: "scene" - title: "Psychology 101" - present_characters: ["emma"] + title: "Morning Reset" + characters_present: [] beats: - - "The lecture hall is filling up with students. You scan for a good seat." - - "A girl with dark hair in a ponytail sits in the middle section, notebook already open. She seems studious and focused." + - "Sunlight slips past blackout curtains, splashing across textbooks, guitar cables, and the half-packed duffel on your bed." + - "Two notifications blink on your phone: Emma asking about the stats assignment, Zoe hyping tonight's basement show." choices: - - id: "sit_near_emma" - prompt: "Sit near the studious girl" - effects: - - { type: "flag_set", key: "emma_met", value: true } - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 5 } - goto: "meet_emma_lecture" - - - id: "sit_alone_back" - prompt: "Sit alone in the back" - effects: - - { type: "meter_change", target: "player", meter: "confidence", op: "subtract", value: 3 } - goto: "lecture_alone" - - transitions: - - { when: "flags.emma_met == true", to: "meet_emma_lecture" } - - { when: "always", to: "campus_hub" } - - - id: "meet_emma_lecture" - type: "scene" - title: "Meeting Emma" - present_characters: ["emma"] - beats: - - "The girl glances up as you sit down nearby. She offers a shy, polite smile." - - "The professor starts the lecture, but during a break, she leans over." - - "'Um, hi... I'm Emma,' she says softly. 'First day?'" + - id: "head_to_quad" + prompt: "Grab your backpack and cross the quad before class." + on_select: + - type: "goto" + node: "quad_catchup" + - id: "swing_by_cafe" + prompt: "Detour to the student cafe for caffeine and gossip." + on_select: + - type: "goto" + node: "cafe_first_meet" + - id: "stay_in_room" + prompt: "Stay in and review your notes for a bit." + on_select: + - type: "meter_change" + target: "player" + meter: "mind" + op: "add" + value: 4 + - type: "goto" + node: "afternoon_loop" + + - id: "quad_catchup" + type: "scene" + title: "Across the Quad" + characters_present: ["emma"] + beats: + - "Emma sits under the sycamore, highlighters scattered, lips moving as she recites formulas." + - "Her eyes brighten when she spots you, relief softening the stress lines in her forehead." + on_entry: + - type: "flag_set" + key: "met_emma" + value: true + - type: "meter_change" + target: "emma" + meter: "trust" + op: "add" + value: 6 choices: - - id: "introduce_confident" - prompt: "Introduce yourself confidently" - conditions: "meters.player.confidence >= 50" - effects: - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 8 } - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 5 } - goto: "emma_conversation_start" - - - id: "introduce_nervous" - prompt: "Introduce yourself nervously" - effects: - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 8 } - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 3 } - goto: "emma_conversation_start" - - - id: "introduce_casual" - prompt: "Be casual and friendly" - effects: - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 6 } - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 6 } - goto: "emma_conversation_start" - - transitions: - - { when: "always", to: "campus_hub" } - - - id: "emma_conversation_start" - type: "scene" - title: "Getting to Know Emma" - present_characters: ["emma"] - beats: - - "Emma seems interested in talking. She's clearly a bit shy but warming up to you." - - "You chat during breaks in the lecture, finding out she's a psych major too." + - id: "offer_study_help" + prompt: "Offer to walk through the stats problem set together." + on_select: + - type: "flag_set" + key: "emma_study_session" + value: true + - type: "meter_change" + target: "emma" + meter: "trust" + op: "add" + value: 6 + - type: "meter_change" + target: "player" + meter: "mind" + op: "add" + value: 3 + - type: "goto" + node: "afternoon_loop" + - id: "walk_with_emma" + prompt: "Suggest grabbing lunch together after class." + on_select: + - type: "meter_change" + target: "emma" + meter: "attraction" + op: "add" + value: 6 + - type: "meter_change" + target: "player" + meter: "charm" + op: "add" + value: 3 + - type: "goto" + node: "afternoon_loop" + + - id: "cafe_first_meet" + type: "scene" + title: "Bean There Banter" + characters_present: ["zoe"] + beats: + - "Zoe balances three mismatched mugs in one hand, sliding a latte toward you with a smirk." + - "\"You're the stats wizard, right? Come to rescue the caffeine-starved masses?\"" + on_entry: + - type: "flag_set" + key: "met_zoe" + value: true + - type: "meter_change" + target: "zoe" + meter: "trust" + op: "add" + value: 4 choices: - - id: "ask_study_together" - prompt: "Suggest studying together sometime" - effects: - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 10 } - - { type: "flag_set", key: "study_buddy_emma", value: true } - - - id: "ask_about_major" - prompt: "Ask why she chose psychology" - effects: - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 8 } - - - id: "compliment_notes" - prompt: "Compliment her neat handwriting" - conditions: "gates.emma.accept_compliment" - effects: - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 10 } - - { type: "apply_modifier", character: "emma", modifier_id: "flattered", duration_min: 30 } - - transitions: - - { when: "always", to: "campus_hub" } - - - id: "lecture_alone" - type: "scene" - title: "Solo Lecture" - beats: - - "You sit through the lecture alone, taking notes. It's informative but lonely." - - "Maybe you should try to be more social next time." - transitions: - - { when: "always", to: "campus_hub" } - - - id: "campus_tour" - type: "scene" - title: "Exploring Campus" - beats: - - "You wander around campus, getting your bearings. The quad is lively with students." - - "You discover the library, gym, and several cafés." - effects: - - { type: "meter_change", target: "player", meter: "confidence", op: "add", value: 5 } - transitions: - - { when: "always", to: "campus_hub" } - - - id: "cafeteria_first" - type: "scene" - title: "Cafeteria Introduction" - present_characters: ["liam"] - beats: - - "The cafeteria is buzzing with students grabbing breakfast." - - "A guy with a friendly grin waves you over. 'Yo! New here? I'm Liam. Come sit with me, bro!'" - choices: - - id: "sit_with_liam" - prompt: "Join Liam" - effects: - - { type: "flag_set", key: "liam_met", value: true } - - { type: "meter_change", target: "liam", meter: "trust", op: "add", value: 10 } - goto: "meet_liam" - - - id: "eat_alone" - prompt: "Politely decline and eat alone" - effects: - - { type: "meter_change", target: "player", meter: "confidence", op: "subtract", value: 5 } - goto: "campus_hub" - - transitions: - - { when: "flags.liam_met == true", to: "meet_liam" } - - { when: "always", to: "campus_hub" } - - - id: "meet_liam" - type: "scene" - title: "Meeting Liam" - present_characters: ["liam"] - beats: - - "Liam is energetic and friendly. He tells you about the gym, parties, and campus life." - - "'You gotta stay active, man. Hit the gym with me sometime. I'll show you the ropes.'" - effects: - - { type: "meter_change", target: "player", meter: "confidence", op: "add", value: 8 } - transitions: - - { when: "always", to: "campus_hub" } - - # ======================================== - # MAIN HUB - # ======================================== - - - id: "campus_hub" + - id: "banter_back" + prompt: "Introduce yourself with equally corny barista banter." + on_select: + - type: "meter_change" + target: "zoe" + meter: "attraction" + op: "add" + value: 7 + - type: "meter_change" + target: "player" + meter: "charm" + op: "add" + value: 4 + - type: "goto" + node: "afternoon_loop" + - id: "ask_about_band" + prompt: "Ask how rehearsals are going for her band." + on_select: + - type: "meter_change" + target: "zoe" + meter: "trust" + op: "add" + value: 6 + - type: "goto" + node: "afternoon_loop" + + - id: "afternoon_loop" type: "hub" - title: "Campus Life" + title: "Afternoon Crossroads" + characters_present: [] beats: - - "You're on campus with time to spend. What do you want to do?" - choices: - - id: "go_library" - prompt: "Study at the library" - goto: "library_study" - - - id: "go_gym" - prompt: "Work out at the gym" - goto: "gym_workout" - - - id: "go_cafeteria" - prompt: "Visit the cafeteria" - goto: "cafeteria_generic" - - - id: "go_cafe" - prompt: "Check out the campus café" - goto: "campus_cafe_visit" - - - id: "return_dorm" - prompt: "Return to your dorm room" - goto: "dorm_room_activities" - - - id: "find_emma" - prompt: "Look for Emma" - conditions: "flags.emma_met == true" - goto: "find_emma" - - - id: "find_zoe" - prompt: "Visit Zoe at the café" - conditions: "flags.zoe_met == true" - goto: "campus_cafe_visit" - + - "Classes blur past, leaving you with a stretch of afternoon to steer the day." dynamic_choices: - - id: "go_downtown" - prompt: "Take the bus downtown" - conditions: "flags.knows_downtown == true" - goto: "downtown_hub" - - - id: "go_club" - prompt: "Go to Pulse Nightclub" - conditions: "flags.invited_to_club == true and time.slot in ['night', 'late_night']" - goto: "nightclub_entrance" - - transitions: - - { when: "time.day >= 30 and meters.emma.trust >= 80 and meters.emma.attraction >= 80", to: "emma_pure_ending" } - - { when: "time.day >= 30 and meters.emma.corruption >= 75", to: "emma_corrupt_ending" } - - { when: "time.day >= 30 and meters.zoe.trust >= 70 and meters.zoe.attraction >= 80 and flags.chose_zoe == true", to: "zoe_exclusive_ending" } - - { when: "always", to: "campus_hub" } - - # ======================================== - # ACTIVITIES - # ======================================== - - - id: "library_study" - type: "scene" - title: "Library Study Session" - present_characters: ["emma"] - entry_effects: - - { type: "move_to", location: "library" } - beats: - - "The library is quiet and focused. Perfect for studying." - choices: - - id: "study_hard" - prompt: "Study intensely for 2 hours" - conditions: "meters.player.energy >= 30 and has('textbook')" - effects: - - { type: "meter_change", target: "player", meter: "mind", op: "add", value: 12 } - - { type: "meter_change", target: "player", meter: "energy", op: "subtract", value: 25 } - - { type: "advance_time", minutes: 120 } - - id: "study_with_emma" - prompt: "Study with Emma" - conditions: "npc_present('emma') and flags.study_buddy_emma == true" - effects: - - { type: "meter_change", target: "player", meter: "mind", op: "add", value: 10 } - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 8 } - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 5 } - - { type: "advance_time", minutes: 90 } - goto: "study_with_emma_scene" - - - id: "casual_study" - prompt: "Do light studying (1 hour)" - effects: - - { type: "meter_change", target: "player", meter: "mind", op: "add", value: 5 } - - { type: "meter_change", target: "player", meter: "energy", op: "subtract", value: 10 } - - { type: "advance_time", minutes: 60 } - - transitions: - - { when: "always", to: "campus_hub" } - - - id: "study_with_emma_scene" - type: "scene" - title: "Studying with Emma" - present_characters: ["emma"] - beats: - - "Emma shares her notes with you. Her handwriting is precise and her explanations are clear." - - "You catch her looking at you a few times, quickly glancing away when you notice." + prompt: "Head to the library to follow up with Emma." + when_any: + - "flags.met_emma == true" + - "flags.emma_study_session == true" + on_select: + - type: "goto" + node: "library_session" + - id: "drop_by_rehearsal" + prompt: "Swing by the cafe during Zoe's rehearsal break." + when: "flags.met_zoe == true" + on_select: + - type: "goto" + node: "rehearsal_break" choices: - - id: "focus_studying" - prompt: "Stay focused on the material" - effects: - - { type: "meter_change", target: "player", meter: "mind", op: "add", value: 5 } - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 5 } - - - id: "flirt_subtly" - prompt: "Flirt subtly while studying" - conditions: "gates.emma.accept_flirting" - effects: - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 10 } - - { type: "meter_change", target: "emma", meter: "arousal", op: "add", value: 5 } - - - id: "ask_personal" - prompt: "Ask about her personal life" - effects: - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 8 } - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 5 } - - transitions: - - { when: "meters.emma.trust >= 60 and meters.emma.attraction >= 50", to: "emma_asks_to_hang_out" } - - { when: "always", to: "campus_hub" } - - - id: "gym_workout" - type: "scene" - title: "Gym Session" - entry_effects: - - { type: "move_to", location: "gym" } - beats: - - "The gym is filled with the sounds of clanging weights and running feet." + - id: "prep_for_evening" + prompt: "Call it here and figure out tonight." + on_select: + - type: "goto" + node: "evening_choice" + + - id: "library_session" + type: "scene" + title: "Quiet Corners" + characters_present: ["emma"] + beats: + - "Stacks of books create a fort around your table. Emma shares colored tabs, you trade mnemonics." + on_entry: + - type: "flag_set" + key: "emma_study_session" + value: true + - type: "meter_change" + target: "emma" + meter: "trust" + op: "add" + value: 8 choices: - - id: "intense_workout" - prompt: "Intense workout (2 hours)" - conditions: "meters.player.energy >= 40" - effects: - - { type: "meter_change", target: "player", meter: "body", op: "add", value: 12 } - - { type: "meter_change", target: "player", meter: "energy", op: "subtract", value: 35 } - - { type: "meter_change", target: "player", meter: "hygiene", op: "subtract", value: 25 } - - { type: "advance_time", minutes: 120 } - - - id: "moderate_workout" - prompt: "Moderate workout (1 hour)" - conditions: "meters.player.energy >= 25" - effects: - - { type: "meter_change", target: "player", meter: "body", op: "add", value: 7 } - - { type: "meter_change", target: "player", meter: "energy", op: "subtract", value: 20 } - - { type: "meter_change", target: "player", meter: "hygiene", op: "subtract", value: 15 } - - { type: "advance_time", minutes: 60 } - - - id: "light_cardio" - prompt: "Light cardio (30 min)" - effects: - - { type: "meter_change", target: "player", meter: "body", op: "add", value: 3 } - - { type: "meter_change", target: "player", meter: "energy", op: "subtract", value: 10 } - - { type: "meter_change", target: "player", meter: "hygiene", op: "subtract", value: 8 } - - { type: "advance_time", minutes: 30 } - - transitions: - - { when: "always", to: "campus_hub" } - - - id: "cafeteria_generic" - type: "scene" - title: "Campus Cafeteria" - entry_effects: - - { type: "move_to", location: "cafeteria" } - beats: - - "The cafeteria is busy with students eating and socializing." - choices: - - id: "buy_meal" - prompt: "Buy a meal ($5)" - conditions: "meters.player.money >= 5" - effects: - - { type: "meter_change", target: "player", meter: "money", op: "subtract", value: 5 } - - { type: "meter_change", target: "player", meter: "energy", op: "add", value: 20 } - - { type: "advance_time", minutes: 30 } - - - id: "socialize" - prompt: "Socialize with other students" - effects: - - { type: "meter_change", target: "player", meter: "confidence", op: "add", value: 5 } - - { type: "advance_time", minutes: 20 } - - transitions: - - { when: "always", to: "campus_hub" } - - - id: "campus_cafe_visit" - type: "scene" - title: "The Daily Grind Café" - present_characters: ["zoe"] - entry_effects: - - { type: "move_to", location: "campus_cafe" } - beats: - - "The café smells amazing. Much better than the cafeteria." - - "Behind the counter, you see an attractive woman with auburn hair. She catches your eye and smirks." + - id: "share_story" + prompt: "Share a personal anecdote about bombing your first presentation." + on_select: + - type: "meter_change" + target: "emma" + meter: "trust" + op: "add" + value: 5 + - type: "meter_change" + target: "emma" + meter: "attraction" + op: "add" + value: 4 + - type: "goto" + node: "afternoon_loop" + - id: "walk_her_home" + prompt: "Offer to walk Emma back to her dorm." + on_select: + - type: "meter_change" + target: "emma" + meter: "attraction" + op: "add" + value: 6 + - type: "goto" + node: "evening_choice" + + - id: "rehearsal_break" + type: "scene" + title: "Backstage Banter" + characters_present: ["zoe"] + beats: + - "Zoe drapes her guitar strap over your shoulders. \"Sing the chorus and I'll owe you forever.\"" + on_entry: + - type: "meter_change" + target: "zoe" + meter: "attraction" + op: "add" + value: 6 choices: - - id: "order_coffee" - prompt: "Order a coffee ($3)" - conditions: "meters.player.money >= 3" - effects: - - { type: "meter_change", target: "player", meter: "money", op: "subtract", value: 3 } - - { type: "meter_change", target: "player", meter: "energy", op: "add", value: 15 } - - { type: "flag_set", key: "zoe_met", value: true } - goto: "meet_zoe" - - - id: "just_look_around" - prompt: "Look around and leave" - goto: "campus_hub" - - transitions: - - { when: "flags.zoe_met == true", to: "meet_zoe" } - - { when: "always", to: "campus_hub" } - - - id: "meet_zoe" - type: "scene" - title: "Meeting Zoe" - present_characters: ["zoe"] - beats: - - "The barista leans on the counter as she hands you your coffee. 'First time here, handsome?'" - - "Her nametag reads 'Zoe' and her smile is confident, almost predatory." - - "'I'm Zoe. And you look like you could use some fun in your life.'" - choices: - - id: "flirt_back" - prompt: "Flirt back confidently" - conditions: "meters.player.confidence >= 40" - effects: - - { type: "meter_change", target: "zoe", meter: "attraction", op: "add", value: 15 } - - { type: "meter_change", target: "zoe", meter: "arousal", op: "add", value: 8 } - - { type: "flag_set", key: "zoe_flirted", value: true } - - - id: "be_friendly" - prompt: "Be friendly but not too forward" - effects: - - { type: "meter_change", target: "zoe", meter: "trust", op: "add", value: 10 } - - { type: "meter_change", target: "zoe", meter: "attraction", op: "add", value: 5 } - - - id: "be_shy" - prompt: "Get flustered and nervous" - effects: - - { type: "meter_change", target: "zoe", meter: "attraction", op: "add", value: 3 } - - { type: "meter_change", target: "player", meter: "confidence", op: "subtract", value: 5 } - - transitions: - - { when: "always", to: "campus_hub" } - - - id: "dorm_room_activities" - type: "hub" - title: "Your Dorm Room" - entry_effects: - - { type: "move_to", location: "player_room" } - beats: - - "You're in your dorm room. What do you want to do?" + - id: "offer_feedback" + prompt: "Give thoughtful feedback on her new song." + on_select: + - type: "flag_set" + key: "zoe_band_invite" + value: true + - type: "meter_change" + target: "zoe" + meter: "trust" + op: "add" + value: 7 + - type: "goto" + node: "evening_choice" + - id: "flirt_playfully" + prompt: "Joke that you only attend shows for the backstage passes." + on_select: + - type: "meter_change" + target: "zoe" + meter: "attraction" + op: "add" + value: 8 + - type: "goto" + node: "evening_choice" + + - id: "evening_choice" + type: "scene" + title: "Evening Plans" + characters_present: [] + beats: + - "The sun sets behind the dorms, texts buzzing in quick succession." + - "Emma suggests a moonlit walk before curfew. Zoe sends the basement venue address." + on_entry: + - type: "flag_set" + key: "evening_choice_made" + value: false choices: - - id: "sleep" - prompt: "Sleep (advance to next morning)" - effects: - - { type: "meter_change", target: "player", meter: "energy", op: "set", value: 100 } - - { type: "advance_time", minutes: 480 } - goto: "wake_up_morning" - - - id: "take_shower" - prompt: "Take a shower" - conditions: "has('shower_supplies')" - effects: - - { type: "inventory_remove", owner: "player", item: "shower_supplies", count: 1 } - - { type: "meter_change", target: "player", meter: "hygiene", op: "set", value: 90 } - - { type: "meter_change", target: "player", meter: "energy", op: "add", value: 5 } - - { type: "advance_time", minutes: 20 } - - - id: "use_textbook" - prompt: "Study with textbook" - conditions: "has('textbook')" - effects: - - { type: "inventory_remove", owner: "player", item: "textbook", count: 1 } - - { type: "meter_change", target: "player", meter: "mind", op: "add", value: 8 } - - { type: "meter_change", target: "player", meter: "energy", op: "subtract", value: 15 } - - { type: "advance_time", minutes: 60 } - - - id: "rest" - prompt: "Rest for a bit" - effects: - - { type: "meter_change", target: "player", meter: "energy", op: "add", value: 20 } - - { type: "advance_time", minutes: 60 } - - - id: "leave_room" - prompt: "Leave room" - goto: "campus_hub" - - transitions: - - { when: "always", to: "campus_hub" } - - - id: "wake_up_morning" - type: "scene" - title: "New Morning" - beats: - - "You wake up refreshed and ready for a new day." - effects: - - { type: "meter_change", target: "player", meter: "hygiene", op: "subtract", value: 10 } - transitions: - - { when: "always", to: "campus_hub" } - - # ======================================== - # EMMA ROMANTIC PROGRESSION - # ======================================== - - - id: "find_emma" - type: "scene" - title: "Looking for Emma" - beats: - - "You search the usual spots where Emma might be." - transitions: - - { when: "npc_present('emma')", to: "emma_found" } - - { when: "always", to: "campus_hub" } - - - id: "emma_found" - type: "scene" - title: "Found Emma" - present_characters: ["emma"] - beats: - - "You find Emma. She looks up and smiles when she sees you." - transitions: - - { when: "gates.emma.accept_date and meters.emma.attraction >= 50", to: "emma_date_opportunity" } - - { when: "meters.emma.trust >= 60", to: "emma_deeper_trust" } - - { when: "always", to: "emma_casual_chat" } - - - id: "emma_casual_chat" - type: "scene" - title: "Chatting with Emma" - present_characters: ["emma"] - beats: - - "You have a nice conversation with Emma. She seems to enjoy your company." + - id: "choose_emma" + prompt: "Text Emma and plan a quiet walk." + when: "flags.met_emma == true" + on_select: + - type: "flag_set" + key: "evening_choice_made" + value: true + - type: "goto" + node: "emma_evening_walk" + - id: "choose_zoe" + prompt: "Head downtown to catch Zoe's set." + when_any: + - "flags.met_zoe == true" + - "flags.zoe_band_invite == true" + on_select: + - type: "flag_set" + key: "evening_choice_made" + value: true + - type: "goto" + node: "zoe_basement_show" + - id: "study_alone" + prompt: "Stay in, brew tea, and get ahead on coursework." + on_select: + - type: "meter_change" + target: "player" + meter: "mind" + op: "add" + value: 6 + - type: "goto" + node: "evening_study_alone" + + - id: "emma_evening_walk" + type: "scene" + title: "Moonlit Steps" + characters_present: ["emma"] + beats: + - "The campus is hushed, fountain lights reflecting in Emma's glasses." + - "She falls into stride beside you, breath fogging in the cool air." + on_entry: + - type: "meter_change" + target: "emma" + meter: "trust" + op: "add" + value: 8 choices: - - id: "ask_about_day" - prompt: "Ask about her day" - effects: - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 5 } - - - id: "compliment" - prompt: "Give her a compliment" - conditions: "gates.emma.accept_compliment" - effects: - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 8 } - - - id: "flirt" - prompt: "Flirt with her" - conditions: "gates.emma.accept_flirting" - effects: - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 10 } - - { type: "meter_change", target: "emma", meter: "arousal", op: "add", value: 5 } - - transitions: - - { when: "always", to: "campus_hub" } - - - id: "emma_asks_to_hang_out" - type: "scene" - title: "Emma's Invitation" - present_characters: ["emma"] - beats: - - "Emma looks nervous as she tucks her hair behind her ear." - - "'Um... I was wondering... would you want to hang out sometime? Like, outside of studying?'" - - "She's clearly asking you on a date, even if she won't say the word." + - id: "share_feelings" + prompt: "Tell Emma you're excited about where this is heading." + on_select: + - type: "flag_set" + key: "emma_final_choice" + value: true + - type: "flag_set" + key: "zoe_final_choice" + value: false + - type: "meter_change" + target: "emma" + meter: "attraction" + op: "add" + value: 10 + - type: "goto" + node: "final_reflection" + - id: "keep_it_easy" + prompt: "Keep the night light with campus gossip." + on_select: + - type: "meter_change" + target: "emma" + meter: "trust" + op: "add" + value: 4 + - type: "goto" + node: "final_reflection" + + - id: "zoe_basement_show" + type: "scene" + title: "Basement Show" + characters_present: ["zoe"] + beats: + - "The basement thrums with bass. Zoe's grin is all mischief when she spots you in the crowd." + - "Sweat-slick walls vibrate as she pulls you toward the backstage staircase." + on_entry: + - type: "meter_change" + target: "zoe" + meter: "attraction" + op: "add" + value: 9 choices: - - id: "accept_enthusiastic" - prompt: "Accept enthusiastically" - effects: - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 15 } - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 10 } - - { type: "flag_set", key: "emma_date_planned", value: true } - goto: "emma_first_date" - - - id: "accept_casual" - prompt: "Accept casually" - effects: - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 10 } - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 5 } - - { type: "flag_set", key: "emma_date_planned", value: true } - goto: "emma_first_date" - - - id: "decline" - prompt: "Decline politely" - effects: - - { type: "meter_change", target: "emma", meter: "attraction", op: "subtract", value: 20 } - - { type: "meter_change", target: "emma", meter: "trust", op: "subtract", value: 10 } - goto: "campus_hub" - - transitions: - - { when: "flags.emma_date_planned == true", to: "emma_first_date" } - - { when: "always", to: "campus_hub" } - - - id: "emma_date_opportunity" - type: "scene" - title: "Date Opportunity" - present_characters: ["emma"] - beats: - - "Emma seems interested in spending more time with you. This could be a good moment to ask her out properly." - choices: - - id: "ask_out" - prompt: "Ask her on a proper date" - conditions: "gates.emma.accept_date" - effects: - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 15 } - - { type: "flag_set", key: "emma_date_planned", value: true } - goto: "emma_first_date" - - - id: "not_yet" - prompt: "Wait for a better time" - goto: "campus_hub" - - transitions: - - { when: "flags.emma_date_planned == true", to: "emma_first_date" } - - { when: "always", to: "campus_hub" } - - - id: "emma_first_date" - type: "scene" - title: "First Date with Emma" - present_characters: ["emma"] - entry_effects: - - { type: "move_to", location: "campus_cafe" } - beats: - - "You meet Emma at the campus café for your first real date." - - "She's dressed nicely and looks nervous but excited." - - "You grab a table by the window and start talking." - choices: - - id: "be_romantic" - prompt: "Be romantic and attentive" - effects: - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 15 } - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 10 } - - - id: "be_fun" - prompt: "Be fun and make her laugh" - effects: - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 12 } - - { type: "meter_change", target: "emma", meter: "boldness", op: "add", value: 5 } - - - id: "be_forward" - prompt: "Be physically forward" - conditions: "meters.emma.attraction >= 60" - effects: - - { type: "meter_change", target: "emma", meter: "arousal", op: "add", value: 15 } - - { type: "meter_change", target: "emma", meter: "corruption", op: "add", value: 8 } - - transitions: - - { when: "gates.emma.accept_kiss", to: "emma_first_kiss_opportunity" } - - { when: "always", to: "emma_date_end" } - - - id: "emma_date_end" - type: "scene" - title: "End of Date" - present_characters: ["emma"] - beats: - - "The date wraps up. Emma seems to have had a good time." - - "'I really enjoyed this,' she says with a genuine smile." - effects: - - { type: "flag_set", key: "emma_first_date_done", value: true } - transitions: - - { when: "always", to: "campus_hub" } - - - id: "emma_first_kiss_opportunity" - type: "scene" - title: "The Moment" - present_characters: ["emma"] - beats: - - "As you walk Emma back toward the dorms, there's a moment of charged silence." - - "She looks up at you, her lips slightly parted. The moment feels right." - choices: - - id: "kiss_her" - prompt: "Kiss her gently" - conditions: "gates.emma.accept_kiss" - effects: - - { type: "flag_set", key: "emma_first_kiss", value: true } - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 20 } - - { type: "meter_change", target: "emma", meter: "arousal", op: "add", value: 15 } - goto: "emma_first_kiss_scene" - - - id: "dont_kiss" - prompt: "Don't push it yet" - effects: - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 5 } - goto: "campus_hub" - - transitions: - - { when: "flags.emma_first_kiss == true", to: "emma_first_kiss_scene" } - - { when: "always", to: "campus_hub" } - - - id: "emma_first_kiss_scene" - type: "scene" - title: "First Kiss" - present_characters: ["emma"] - beats: - - "You lean in slowly, giving her time to pull back if she wants." - - "She doesn't. Your lips meet softly, and she sighs against your mouth." - - "When you pull apart, her cheeks are flushed and her eyes are shining." - - "'Wow,' she whispers. 'That was... perfect.'" - effects: - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 10 } - transitions: - - { when: "always", to: "campus_hub" } - - - id: "emma_deeper_trust" - type: "scene" - title: "Growing Closer to Emma" - present_characters: ["emma"] - beats: - - "Your relationship with Emma has deepened significantly." - - "She seems more comfortable around you, more willing to be vulnerable." - choices: - - id: "invite_to_room" - prompt: "Invite her to your room" - conditions: "meters.emma.trust >= 70 and location.id != 'player_room'" - effects: - - { type: "flag_set", key: "emma_invited_to_room", value: true } - goto: "emma_room_invitation" - - - id: "ask_about_feelings" - prompt: "Ask about her feelings for you" - effects: - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 10 } - goto: "emma_confession" - - transitions: - - { when: "always", to: "campus_hub" } - - - id: "emma_room_invitation" - type: "scene" - title: "Private Time" - present_characters: ["emma"] - entry_effects: - - { type: "move_to", location: "player_room" } - beats: - - "Emma agrees to come to your room. There's nervous energy between you." - - "Once inside, the privacy changes the atmosphere." - transitions: - - { when: "gates.emma.accept_touching", to: "emma_intimate_scene" } - - { when: "always", to: "emma_room_casual" } - - - id: "emma_room_casual" - type: "scene" - title: "Time Alone Together" - present_characters: ["emma"] - beats: - - "You and Emma hang out in your room, talking and getting to know each other better." - - "The intimacy of the private space brings you closer." - effects: - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 10 } - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 8 } - transitions: - - { when: "always", to: "campus_hub" } - - - id: "emma_confession" - type: "scene" - title: "Emma Opens Up" - present_characters: ["emma"] - beats: - - "Emma takes a deep breath. 'I... I really like you. More than I thought I would.'" - - "She's being vulnerable with you, showing her real feelings." - choices: - - id: "reciprocate" - prompt: "Tell her you feel the same" - effects: - - { type: "meter_change", target: "emma", meter: "attraction", op: "add", value: 20 } - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 15 } - - { type: "flag_set", key: "mutual_feelings", value: true } - - transitions: - - { when: "always", to: "campus_hub" } - - - id: "emma_intimate_scene" - type: "scene" - title: "Intimate Moment with Emma" - present_characters: ["emma"] - beats: - - "The tension between you reaches a breaking point." - - "Emma's breathing quickens as you move closer." - choices: - - id: "touch_her" - prompt: "Touch her intimately" - conditions: "gates.emma.accept_touching" - effects: - - { type: "meter_change", target: "emma", meter: "arousal", op: "add", value: 20 } - - { type: "meter_change", target: "emma", meter: "corruption", op: "add", value: 10 } - - { type: "flag_set", key: "emma_intimate_touching", value: true } - goto: "emma_intimate_progression" - - - id: "take_it_slow" - prompt: "Take things slow" - effects: - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 15 } - goto: "campus_hub" - - transitions: - - { when: "flags.emma_intimate_touching == true", to: "emma_intimate_progression" } - - { when: "always", to: "campus_hub" } - - - id: "emma_intimate_progression" - type: "scene" - title: "Getting Physical" - present_characters: ["emma"] - beats: - - "Your hands explore as Emma gasps softly." - - "Her body responds to your touch, and she presses closer." - transitions: - - { when: "gates.emma.accept_sex and has('condoms')", to: "emma_first_sex" } - - { when: "gates.emma.accept_oral", to: "emma_oral_scene" } - - { when: "always", to: "emma_intimate_end" } - - - id: "emma_intimate_end" - type: "scene" - title: "Afterglow" - present_characters: ["emma"] - beats: - - "You hold each other, breathing heavily." - - "Emma looks at you with a mix of satisfaction and affection." - effects: - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 10 } - - { type: "flag_set", key: "emma_first_intimate", value: true } - transitions: - - { when: "always", to: "campus_hub" } - - - id: "emma_oral_scene" - type: "scene" - title: "Oral Intimacy" - present_characters: ["emma"] - beats: - - "Things escalate further as boundaries continue to fall." - - "Emma is willing to explore more with you." - effects: - - { type: "meter_change", target: "emma", meter: "corruption", op: "add", value: 15 } - - { type: "meter_change", target: "emma", meter: "arousal", op: "set", value: 100 } - - { type: "flag_set", key: "emma_oral_done", value: true } - transitions: - - { when: "gates.emma.accept_sex and has('condoms')", to: "emma_first_sex" } - - { when: "always", to: "emma_intimate_end" } - - - id: "emma_first_sex" - type: "scene" - title: "First Time Together" - present_characters: ["emma"] - beats: - - "Emma nods, her eyes full of trust and desire." - - "'I'm ready,' she whispers. 'I want this... with you.'" - - "You make love carefully, both of you experiencing something profound together." - effects: - - { type: "meter_change", target: "emma", meter: "trust", op: "set", value: 100 } - - { type: "meter_change", target: "emma", meter: "attraction", op: "set", value: 100 } - - { type: "flag_set", key: "emma_first_sex_done", value: true } - transitions: - - { when: "always", to: "emma_intimate_end" } - - - id: "emma_night_visit" - type: "scene" - title: "Late Night Visit" - present_characters: ["emma"] - entry_effects: - - { type: "move_to", location: "player_room" } - beats: - - "There's a soft knock at your door. It's Emma, looking nervous but determined." - - "'I couldn't stop thinking about you,' she admits." - transitions: - - { when: "gates.emma.accept_sex and has('condoms')", to: "emma_first_sex" } - - { when: "gates.emma.accept_touching", to: "emma_intimate_scene" } - - { when: "always", to: "emma_room_casual" } - - # ======================================== - # ZOE PATH - # ======================================== - - - id: "nightclub_entrance" - type: "scene" - title: "Pulse Nightclub" - present_characters: ["zoe"] - entry_effects: - - { type: "move_to", location: "night_club" } - beats: - - "The bass thrums through your chest as you enter the nightclub." - - "Strobe lights flash across the packed dance floor." - - "You spot Zoe near the bar, looking stunning in a tight dress." - choices: - - id: "approach_zoe" - prompt: "Approach Zoe at the bar" - conditions: "flags.zoe_met == true" - effects: - - { type: "meter_change", target: "zoe", meter: "attraction", op: "add", value: 10 } - goto: "zoe_club_interaction" - - - id: "hit_dance_floor" - prompt: "Hit the dance floor" - effects: - - { type: "meter_change", target: "player", meter: "confidence", op: "add", value: 5 } - goto: "club_dancing" - - transitions: - - { when: "npc_present('zoe')", to: "zoe_club_interaction" } - - { when: "always", to: "downtown_hub" } - - - id: "zoe_club_interaction" - type: "scene" - title: "Dancing with Zoe" - present_characters: ["zoe"] - beats: - - "Zoe grins when she sees you. 'There you are, handsome. Let's dance.'" - - "She pulls you onto the dance floor, moving against you with confidence." - choices: - - id: "dance_close" - prompt: "Dance close and intimate" - conditions: "gates.zoe.accept_flirting" - effects: - - { type: "meter_change", target: "zoe", meter: "attraction", op: "add", value: 15 } - - { type: "meter_change", target: "zoe", meter: "arousal", op: "add", value: 20 } - - - id: "kiss_on_floor" - prompt: "Kiss her on the dance floor" - conditions: "gates.zoe.accept_kiss" - effects: - - { type: "flag_set", key: "zoe_first_kiss", value: true } - - { type: "meter_change", target: "zoe", meter: "arousal", op: "add", value: 25 } - goto: "zoe_first_kiss_scene" - - transitions: - - { when: "flags.zoe_first_kiss == true", to: "zoe_first_kiss_scene" } - - { when: "gates.zoe.accept_sex", to: "zoe_propositions" } - - { when: "always", to: "downtown_hub" } - - - id: "club_dancing" - type: "scene" - title: "Dance Floor" - beats: - - "You lose yourself in the music and movement." - effects: - - { type: "meter_change", target: "player", meter: "energy", op: "subtract", value: 15 } - transitions: - - { when: "always", to: "downtown_hub" } - - - id: "zoe_first_kiss_scene" - type: "scene" - title: "Kissing Zoe" - present_characters: ["zoe"] - beats: - - "Zoe kisses you hard, her tongue sliding into your mouth." - - "It's passionate and hungry, very different from Emma's shy sweetness." - - "When she pulls back, she's breathless. 'Damn. You're good at that.'" - effects: - - { type: "meter_change", target: "zoe", meter: "attraction", op: "add", value: 20 } - transitions: - - { when: "gates.zoe.accept_sex", to: "zoe_propositions" } - - { when: "always", to: "downtown_hub" } - - - id: "zoe_propositions" - type: "scene" - title: "Zoe's Proposal" - present_characters: ["zoe"] - beats: - - "Zoe leans in close, her lips brushing your ear." - - "'Want to get out of here? My place is close,' she purrs." - - "The invitation is clear and direct." - choices: - - id: "go_with_zoe" - prompt: "Go with Zoe" - conditions: "gates.zoe.accept_sex" - effects: - - { type: "flag_set", key: "zoe_hookup", value: true } - goto: "zoe_sex_scene" - - - id: "decline" - prompt: "Decline for now" - effects: - - { type: "meter_change", target: "zoe", meter: "attraction", op: "subtract", value: 10 } - goto: "downtown_hub" - - transitions: - - { when: "flags.zoe_hookup == true", to: "zoe_sex_scene" } - - { when: "always", to: "downtown_hub" } - - - id: "zoe_sex_scene" - type: "scene" - title: "Night with Zoe" - present_characters: ["zoe"] - beats: - - "Zoe's apartment is stylish and modern." - - "She wastes no time, pulling you toward her bedroom." - - "The night is passionate and intense, Zoe taking charge confidently." - effects: - - { type: "meter_change", target: "zoe", meter: "arousal", op: "set", value: 100 } - - { type: "meter_change", target: "zoe", meter: "attraction", op: "add", value: 25 } - - { type: "flag_set", key: "zoe_first_sex", value: true } - transitions: - - { when: "always", to: "zoe_morning_after" } - - - id: "zoe_morning_after" - type: "scene" - title: "Morning After" - present_characters: ["zoe"] - beats: - - "You wake up in Zoe's bed. She's already awake, watching you with a satisfied smile." - - "'That was fun,' she says. 'We should definitely do that again.'" - effects: - - { type: "meter_change", target: "zoe", meter: "trust", op: "add", value: 15 } - transitions: - - { when: "always", to: "campus_hub" } - - # ======================================== - # CHOICE BETWEEN EMMA AND ZOE - # ======================================== - - - id: "relationship_decision" - type: "scene" - title: "A Decision to Make" - present_characters: ["emma", "zoe"] - preconditions: "meters.emma.attraction >= 60 and meters.zoe.attraction >= 60 and flags.route_locked == false" - beats: - - "Both Emma and Zoe have shown clear interest in you." - - "You can't pursue both without hurting someone. It's time to make a choice." - choices: - - id: "choose_emma_exclusive" - prompt: "Commit to Emma" - effects: - - { type: "flag_set", key: "chose_emma", value: true } - - { type: "flag_set", key: "route_locked", value: true } - - { type: "meter_change", target: "emma", meter: "trust", op: "add", value: 20 } - - { type: "meter_change", target: "zoe", meter: "attraction", op: "set", value: 0 } - - - id: "choose_zoe_exclusive" - prompt: "Commit to Zoe" - effects: - - { type: "flag_set", key: "chose_zoe", value: true } - - { type: "flag_set", key: "route_locked", value: true } - - { type: "meter_change", target: "zoe", meter: "trust", op: "add", value: 20 } - - { type: "meter_change", target: "emma", meter: "attraction", op: "set", value: 0 } - - - id: "keep_both" - prompt: "Try to keep both (risky)" - effects: - - { type: "flag_set", key: "playing_both", value: true } - - transitions: - - { when: "always", to: "campus_hub" } - - # ======================================== - # DOWNTOWN HUB - # ======================================== - - - id: "downtown_hub" - type: "hub" - title: "Downtown" - beats: - - "You're downtown. What do you want to do?" - choices: - - id: "return_campus" - prompt: "Take bus back to campus" - goto: "campus_hub" - - - id: "visit_club" - prompt: "Visit Pulse Nightclub" - conditions: "time.slot in ['night', 'late_night']" - goto: "nightclub_entrance" - - transitions: - - { when: "always", to: "campus_hub" } - - # ======================================== - # ENDINGS - # ======================================== - - - id: "emma_pure_ending" - type: "ending" - title: "Pure Love with Emma" - present_characters: ["emma"] - ending_id: "emma_pure" - beats: - - "Through patience, respect, and genuine connection, you and Emma have fallen deeply in love." - - "Your relationship is built on trust and mutual care." - - "Emma has opened up completely to you, sharing her heart and body." - - "On a quiet evening in your dorm room, she whispers: 'I love you. I've never felt this way about anyone.'" - - "You know you feel the same." - credits: - summary: "You found true love with Emma through patience and respect." - epilogue: - - "Your relationship continues to grow stronger throughout college." - - "Emma becomes more confident with your support." - - "After graduation, you move in together and start planning your future." - - - id: "emma_corrupt_ending" - type: "ending" - title: "Emma Corrupted" - present_characters: ["emma"] - ending_id: "emma_corrupt" - beats: - - "Emma has transformed from a shy, conservative student into someone bold and sexually adventurous." - - "You've pushed her boundaries and awakened desires she didn't know she had." - - "She still cares for you, but the innocence is gone." - - "'I can't believe I used to be so... timid,' she says with a wicked smile." - - "You're not sure if this change is entirely healthy, but she seems happy." - credits: - summary: "You corrupted Emma, transforming her into someone new." - epilogue: - - "Emma's personality shifts permanently." - - "She becomes known as the wild girl on campus." - - "Your relationship is intensely physical but emotionally complex." - - - id: "emma_bad_girl_ending" + - id: "stay_late" + prompt: "Stay after the set to help pack gear." + on_select: + - type: "flag_set" + key: "zoe_final_choice" + value: true + - type: "flag_set" + key: "emma_final_choice" + value: false + - type: "meter_change" + target: "zoe" + meter: "trust" + op: "add" + value: 8 + - type: "goto" + node: "final_reflection" + - id: "call_it_night" + prompt: "Congratulate her and head home early." + on_select: + - type: "goto" + node: "final_reflection" + + - id: "evening_study_alone" + type: "scene" + title: "Quiet Victory" + characters_present: [] + beats: + - "The dorm is quiet save for the hum of your desk lamp." + - "Notes align, plans crystallize, and both messages sit unanswered for now." + triggers: + - when: "true" + on_select: + - type: "goto" + node: "ending_solo" + + - id: "final_reflection" + type: "scene" + title: "Late-Night Reflections" + characters_present: [] + beats: + - "Back in your dorm, the night settles into a comfortable hush." + - "Two different futures glow on your phone screen." + triggers: + - when: "flags.emma_final_choice == true" + on_select: + - type: "goto" + node: "ending_emma" + - when: "flags.zoe_final_choice == true" + on_select: + - type: "goto" + node: "ending_zoe" + - when: "true" + on_select: + - type: "goto" + node: "ending_solo" + + - id: "ending_emma" type: "ending" - title: "Good Girl Gone Bad" - present_characters: ["emma"] - ending_id: "emma_gone_bad" + title: "Shared Notes" + characters_present: ["emma"] + ending_id: "ending_emma" beats: - - "Emma's corruption went too far." - - "Once a studious, conservative girl, she's now reckless and promiscuous." - - "She parties constantly, her grades have tanked, and she barely resembles the person you first met." - - "'Thanks for showing me how to have fun,' she slurs at a party, clearly drunk." - - "You wonder if you've ruined something beautiful." - credits: - summary: "Emma's corruption spiraled out of control." - epilogue: - - "Emma drops out of college after one year." - - "She loses herself completely in the party scene." - - "You feel guilty about the role you played in her transformation." + - "Emma passes you a neatly folded note: \"Next coffee is on me.\"" + - "The campus feels smaller, the future a little more certain." - - id: "zoe_romance_ending" + - id: "ending_zoe" type: "ending" - title: "Passionate Romance with Zoe" - present_characters: ["zoe"] - ending_id: "zoe_romance" + title: "Second Encore" + characters_present: ["zoe"] + ending_id: "ending_zoe" beats: - - "Your relationship with Zoe is fire and passion." - - "She's bold, confident, and unapologetically sexual." - - "While it's not as emotionally deep as it could be with Emma, the chemistry is undeniable." - - "'You're pretty great, you know that?' Zoe says, kissing you hard." - - "It's a wild ride, and you're enjoying every moment." - credits: - summary: "You and Zoe burn bright together." - epilogue: - - "Your relationship is exciting but sometimes exhausting." - - "Zoe introduces you to new experiences and adventures." - - "You're not sure where it's going, but it's one hell of a journey." + - "Zoe tugs you onstage during soundcheck, hands warm around yours." + - "\"Ready to make this our duet?\" she asks above the cheering." - - id: "zoe_exclusive_ending" + - id: "ending_solo" type: "ending" - title: "Exclusive Partners" - present_characters: ["zoe"] - ending_id: "zoe_exclusive" - beats: - - "You and Zoe have committed to each other exclusively." - - "Beneath her bold exterior, she's shown you a vulnerable side few people see." - - "Your relationship has depth and passion." - - "'I didn't think I'd ever want something serious,' she admits. 'But with you? I do.'" - - "You've found something real with Zoe." - credits: - summary: "You built an exclusive, committed relationship with Zoe." - epilogue: - - "After college, you and Zoe move to the city together." - - "She starts her own business while you pursue your career." - - "Your relationship remains passionate and strong." - - - id: "lonely_ending" - type: "ending" - title: "Missed Opportunities" - ending_id: "lonely" - beats: - - "Your first year of college is coming to an end." - - "You never built strong enough relationships with Emma or Zoe." - - "Looking back, you wonder what might have been if you'd been braver." - - "Summer break is here, and you're heading home alone." - credits: - summary: "You didn't pursue either romance path successfully." - epilogue: - - "Maybe next year will be different." - - "You promise yourself you'll take more chances." - - # ======================================== - # FALLBACK NODES - # ======================================== - - - id: "player_room_idle" - type: "scene" - title: "In Your Room" + title: "Still Figuring It Out" + characters_present: [] + ending_id: "ending_solo" beats: - - "You're in your dorm room." - transitions: - - { when: "always", to: "dorm_room_activities" } \ No newline at end of file + - "You file flashcards back into their case and silence your phone." + - "Some nights are for choosing yourself—and tomorrow is wide open." diff --git a/shared/plotplay_specification.md b/shared/plotplay_specification.md new file mode 100644 index 0000000..fa105de --- /dev/null +++ b/shared/plotplay_specification.md @@ -0,0 +1,2143 @@ +# PlotPlay Specification + +## Table of Contents + +1. [Introduction](#1-introduction) +2. [Game Package & Manifest](#2-game-package--manifest) +3. [Expression DSL & Condition Context](#3-expression-dsl-conditions) +4. [Meters](#4-meters) +5. [Flags](#5-flags) +6. [Time & Calendar](#6-time--calendar) +7. [Economy System](#7-economy-system) +8. [Items](#8-items) +9. [Clothing System](#9-clothing-system) +10. [Inventory](#10-inventory) +11. [Shopping System](#11-shopping-system) +12. [Locations & Zones](#12-locations--zones) +13. [Characters](#13-characters) +14. [Effects](#14-effects) +15. [Modifiers](#15-modifiers) +16. [Actions](#16-actions) +17. [Nodes](#17-nodes) +18. [Events](#18-events) +19. [Arcs & Milestones](#19-arcs--milestones) +20. [AI Contracts (Writer & Checker)](#20-ai-contracts-writer--checker) + +--- + +## 1. Introduction + +### Overview +PlotPlay is an AI-driven text adventure engine that blends authored branching structure with dynamic prose. +Authors define worlds, characters, and story logic; the engine enforces state, consent, +and progression rules while the Writer model produces immersive text and the Checker model ensures consistency. +Unlike freeform AI sandboxes, every PlotPlay game is deterministic, replayable, and always resolves at authored endings. + +**The key engine features are:** +- **Blended Narrative** — Pre-authored nodes give structure; AI prose fills the gaps, always within authored boundaries. +- **Deterministic State System** — Meters, flags, modifiers, clothing, and inventory are validated and updated in predictable ways. +- **Consent & Boundaries** — All intimacy is gated by explicit thresholds and privacy rules; non-consensual paths are impossible. +- **Dynamic World Layer** — Locations, time, schedules, and random events add variation between playthroughs. +- **Structured Progression** — Arcs and milestones track long-term growth and unlock authored endings; no endless sandbox drift. + +The engine uses **two-model architecture:** +- **Writer**: Expands on authored beats, generates dialogue and prose, stays within style/POV constraints. +- **Checker**: Strict JSON output, detects state changes, validates against rules, enforces consent & hard boundaries. +- Both models run each turn; their outputs are merged into the game state. + +### Core Concepts +PlotPlay is built on a small set of core entities. +Authors combine these to define worlds, characters, behaviors, and story flows. + +**Game Loop Entities** +- **Game** — A packaged story folder with game definition. The folder must contain the main manifest in the `game.yaml` +and optional split files included by the game manifest. +- **Turn** — One iteration which starts with player input followed by AI Writer response. +- **Node** — An authored story unit (scene, hub, encounter, or ending) with beats, choices, effects, and transitions. +- **Event** — A scheduled, conditional, or random trigger that overlays or interrupts play. +- **Arc** — Long-term progression trackers; arcs advance through milestones based on conditions, unlocking content and endings. +- **State** — The snapshot of current game condition: meters, flags, modifiers, clothing, inventory, time, location, arcs, and memory. +- **Character** — Any player or NPC; defined with identity, meters, flags, consent gates, wardrobe, and optional schedule/movement rules. +- **Character Card** — A compact runtime summary of a character (appearance, meters, gates, refusals) passed to the Writer for context. + +**Turn flow:** +- **Nodes** define the authored story structure (scenes, interactive hubs, endings). +- **Writer Model** produces freeform prose, respecting node type, state, and character cards. +- **Checker Model** parses prose back into structured state deltas (meter changes, flags, clothing, etc.). +- **Transitions** move the story between nodes, determined by authored conditions + Checker outputs. + +### State overview + +Game state is the single source of truth for everything that has happened in a game. +It captures the current snapshot of the world, characters, and story progression, +and it is the structure that both the Writer and Checker operate at each turn. + +The state is: +- **Author-driven** — all meters, flags, items, and arcs must be defined in the game’s configuration. +- **Validated** — unknown keys or invalid values are rejected at runtime. +- **Dynamic** — updated every turn by authored effects, Checker deltas, and engine rules. + +**Components of State** +- **Meters** — numeric values for player and NPCs (e.g., trust, attraction, energy, money). +- **Flags** — boolean or scalar markers of progress (e.g., emma_met, first_kiss). +- **Modifiers** — temporary or stackable statuses that affect appearance/behavior (e.g., drunk, aroused). +- **Inventory** — items held by player or NPCs, with counts and categories. +- **Clothing** — wardrobe layers and their current states (intact, displaced, removed). +- **Location & Time** — current zone, location, privacy level, day/slot/clock time, and calendar info. +- **Arcs** — long-term progression trackers (current stage, history, unlocks). +- **History/Memory** — rolling log of recent nodes, dialogue, and milestones, used for AI context. + +**Role of State** +- Provides **context** to the Writer (via character cards, location/time info, and node metadata). +- Provides **ground truth** to the Checker, which validates deltas against rules. +- Drives **transitions**, **events**, and **milestones** deterministically. +- Ensures **consistency**: narrative always reflects current meters, clothing, location, and consent gates. + +--- + +## 2. Game Package & Manifest + +### Game folder layout + +A **game** is a single folder containing a primary manifest file `game.yaml`plus any optional, referenced YAML files. +The manifest declares metadata, core config, and (optionally) a list of **includes**. +This lets small games live in a single file, while bigger games split sections into multiple files — **without changing the schema**. + +```yaml +/ + game.yaml # REQUIRED: main manifest + # optional referenced files, all inside this folder: + characters.yaml + nodes.yaml + events.yaml + arcs.yaml + items.yaml + zones.yaml + # ...or any custom names referenced via include +``` +The engine merges all includes into the game manifest which is then validated. +The manifest consists of a fixed set of root nodes, each defining a specific aspect of the game. + +### Game manifest template +```yaml +# ---Game metadata --- +meta: # REQUIRED. Game metadata node. + id: "" # REQUIRED. Game ID must match the game folder name. + title: "" # REQUIRED. Display title. + version: "" # REQUIRED. Content version (e.g., "1.0.0"). + authors: ["", ...] # REQUIRED. One or more authors. + description: "" # OPTIONAL. Short blurb. + content_warnings: ["", ...] # OPTIONAL. e.g., ["NSFW","strong language"] + nsfw_allowed: true # REQUIRED. Must be true for adult content. + license: "" # OPTIONAL. e.g., "CC-BY-NC-4.0" + +narration: # REQUIRED. Narration style and engine hints + pov: "" # Narration point of view. + tense: "" # Narration tense. + paragraphs: "1-2" # Hint to engine for narration size per turn. + +rng_seed: "" # OPTIONAL. Allows fixing random seed to reproduce the same gameplay. + # Default: auto (engine generates a random seed for each playthrough). + +# --- Game starting point --- +start: # REQUIRED. Game starting point. See corresponding sections for details about fields. + location: "" # Starting location + node: "" # Starting node. + day: 1 # Starting day. + slot: "" # # REQUIRED for slots/hybrid. Starting slot. + time: "08:00". # OPTIONAL Starting time, "HH:MM". + # The default is "00:00" for clock/hybrid modes. + +# --- Global state variables --- +meters: # OPTIONAL. Game meters definitions. See the Meters section. + player: { ... } # Player meters + template: { ... } # Template for NPC meters. +flags: { ... } # OPTIONAL. Game flags. See the Flags section. + +# --- Game world definition --- +time: { ... } # REQUIRED. See the Time & Calendar section. +economy: { ... } # REQUIRED. See the Economy section. +items: { ... } # REQUIRED. See the Items section. +wardrobe: { ... } # REQUIRED. See the Wardrobe & Outfits section. + +characters: [ ... ] # REQUIRED. See the Characters section. +zones: [ ... ] # REQUIRED. See the Locations & Zones section. +movement: { ... } # REQUIRED. See the Movement Rules section. + +# --- Game logic --- +nodes: [ ... ] # See the Nodes section. +modifiers: [ ... ] # See the Modifiers section +actions: [ ... ] # See the Actions section. +events: [ ... ] # See the Events section. +arcs: [ ... ] # See the Arcs & Milestones section. + +# ---Includes --- + +# Includes: pull in external files and merge their sections +# Each included file must declare recognized root keys (e.g., characters, nodes, zones). +# Unknown root keys cause a load error. +includes: [, ...] # OPTIONAL. List of yaml files to include. +``` + +### Loader behavior and rules + +1. First, loader Loads the `game.yaml`. +2. Then, for each file in `includes` in listed order, loader **loads** and **merges** any **recognized root keys** it contains. + - Entries with the same id replace prior ones in corresponding sections. +3. Loader **validates** the game after all merges: + - unique IDs within each list section (`characters`, `items`, `nodes`, `events`, `arcs`, `zones`). + - Cross-refs resolve (node targets, item/outfit/location IDs, etc.). + - Time config sanity, start node/location exist. +4. All included files must be inside the game folder; no `..`, no absolute paths, no URLs. +5. Loader loads **known root keys only**; unknown roots cause a load error (helps catch typos). +6. **No nested includes** inside included files (max depth = 1). + +### Authoring tips + +- Small games: keep everything in **one** `game.yaml`. +- Growing games: split by **natural sections** (`characters`, `nodes`, `events`, `arcs`, `zones`, `items`). +- For huge node sets, shard into `nodes_partN.yaml` — the loader will merge them into nodes. +- Avoid redefining `meta/time/start` outside `game.yaml` to keep entry clear. + +--- + +## 3. Expression DSL (Conditions) + +### Purpose & Syntax +The game engine uses a small, safe, deterministic expression language anywhere the spec accepts a condition +(e.g., node `preconditions`, effect `when`, event triggers, outfit `unlock_when`, +flag `reveal_when`, arc `advance_when`). + +``` +expr := or_expr +or_expr := and_expr { "or" and_expr } +and_expr := not_expr { "and" not_expr } +not_expr := ["not"] cmp_expr +cmp_expr := sum_expr [ ( "==" | "!=" | "<" | "<=" | ">" | ">=" | "in" ) sum_expr ] +sum_expr := term { ( "+" | "-" ) term } +term := factor { ( "*" | "/" ) factor } +factor := primary | "(" expr ")" +primary := literal | path | function_call + +literal := boolean | number | string | list +boolean := "true" | "false" +number := /-?\d+(\.\d+)?/ +string := double_quoted_string # use "..." +list := "[" [literal {"," literal}] "]" + +path := ident {("." ident) | ("[" string_or_number "]")} +ident := /[A-Za-z_][A-Za-z0-9_]*/ + +function_call := ident "(" [ arg {"," arg} ] ")" +arg := expr +``` + +### Types & Truthiness +- Types: **boolean**, **number**, **string**, **list** (homogenous recommended). +- Falsey: `false`, `0`, `""`, `[]`. Everything else is truthy. +- Short-circuit: `and`/`or` evaluate left→right with short-circuit. + +### Operators +- Comparison: `== != < <= > >=` +- Boolean: `and or not` +- Arithmetic: `+ - *` / (numbers only) +- Membership: `X in ["a","b"]` or `time.slot in ["evening","night"]` + +### Path Access +- Dotted or bracketed: `meters.emma.trust`, `flags["first_kiss"]` +- **Safe resolution**: Missing paths evaluate to `null` (falsey). They **never throw**. +- For dynamic paths, use `get("flags.route_locked", false)`. + +### Built-in Functions +- `has(item_id)` → bool (player inventory) +- `npc_present(npc_id)` → bool (NPC currently in same location) +- `rand(p)` → bool (Bernoulli; `0.0 ≤ p ≤ 1.0`; seeded per turn) +- `min(a,b)`, `max(a,b)`, `abs(x)` +- `clamp(x, lo, hi)` +- `get(path_string, default)` → safe lookup (e.g., `get("meters.emma.trust", 0)`) + +### Constraints & Safety +- No assignments, no user-defined functions, no I/O, no imports, no eval. +- Strings must be **double-quoted**. +- Division by zero → expression is false (and the engine logs a warning). +- Engine enforces **length & nesting caps** to prevent abuse. + +### Examples +```yaml +"meters.emma.trust >= 50 and gates.emma.accept_date" +"time.slot in ['evening','night'] and rand(0.25)" +"has('flowers') and location.privacy in ['medium','high']" +"arcs.emma_corruption.stage in ['experimenting','corrupted']" +"get('flags.protection_available', false) == true" +``` + +### Runtime Variables (Condition Context) + +All conditions are evaluated against a read-only **turn context** built by the engine. +The following variables and namespaces are available: + +#### Time & Calendar +- `time.day` (int) — narrative day counter (≥1) +- `time.slot` (string) — current slot (e.g., "morning") +- `time.time_hhmm` (string) — "HH:MM" in clock/hybrid modes +- `time.weekday` (string) — e.g., "monday" + +#### Location +- `location.zone` (string) — zone id +- `location.id` (string) — location id +- `location.privacy` (enum) — none | low | medium | high + +#### Characters & Presence +- `characters` (list of ids) — NPC ids known in game +- `present` (list of ids) — NPC ids present in current location + - Prefer `npc_present('emma')` for clarity. + +#### Meters +- `meters.player.` (number) +- `meters..` (number) + - Example: `meters.emma.trust`, `meters.player.energy` + +#### Flags +- `flags.` — boolean/number/string (as defined) + - Example: `flags.first_kiss == true` + +#### Modifiers (active) +- `modifiers.player` (list[string]) — active modifier ids +- `modifiers.` (list[string]) + - Often checked via gates or effects rather than here. + +#### Inventory +- `inventory.player.` (int count) +- `inventory..` (int count) + - Prefer `has('flowers')` for player possession checks. + +#### Clothing (runtime state) +- `clothing..layers.` — `"intact" | "displaced" | "removed"` +- `clothing..outfit` — current outfit id + +#### Gates (consent/behavior) +- `gates..` (bool) + - Gate values are derived from meters/flags/privacy; use this instead of re-implementing checks. + - Example: `gates.emma.accept_kiss` + +#### Arcs +- `arcs..stage` (string) — current stage id +- `arcs..history` (list[string]) — prior stages + +#### Macros + - `'always'` resolves to boolean truth + - `{owner}` - Item owner + - `{character}` - Current character in modifier context + - `{target}` - Effect target + - `{location}` - Current location + +### Authoring Guidelines +- Prefer checking **gates** (`gates.emma.accept_kiss`) over raw meter math. +- Keep expressions short; move complexity into flags/arcs or precomputed gates. +- Use `get(...)` when a path might not exist yet (e.g., optional flags). +- Randomness: use `rand(p)` sparingly and only where replay determinism is acceptable. + +### Validation & Errors +- Unknown variables/paths → resolve to `null` (falsey) and log a warning in dev builds. +- Type errors (e.g., `"foo" + 1`) → expression evaluates false; warning logged. +- Exceeding size/nesting caps → expression rejected at a load or first evaluation. + +--- +## 4. Meters + +### Definition & template +A **meter** is a numeric variable that tracks a continuous aspect of the player or an NPC. +Meters represent qualities such as trust, attraction, energy, health, arousal, or corruption. +They are: +- **Bounded** — every meter has min, max, and a default value. +- **Visible** or **hidden** — some are shown in the UI, others stay hidden until conditions reveal them. +- **Thresholded** — meters can define labeled ranges (e.g., stranger → friend → intimate) for easier gating and narrative logic. +- **Dynamic** — values can change through authored effects, Checker deltas, or automatic decay/growth rules. +- **Central to gating** — NPC behavior gates often check meter thresholds to decide whether an action is allowed. + +Meters are always defined in the game configuration and are validated at load time: + - The root `meters` node contains two sub-nodes: + - `player` defines meters for players, + - `template` defines meters for NPCs. + - Each NPC inherits all meters from the `template` subnode. + - Each NPC definition in the `characters` section can provide additional `meters` section +which may introduce additional meters for this specific NPC or override meters from the template. + +```yaml +# Single Meter Definition (template) +# Place under: meters.player., or meters.template., or characters..meters. + +: # REQUIRED. Meter ID unique within its parent node. +# --- Bounds & Defaults --- + min: # REQUIRED. Absolute floor (inclusive). + max: # REQUIRED. Absolute ceiling (inclusive). Must be > min. + default: # REQUIRED. Initial value. Must be within [min, max]. + + # --- Visibility & UI --- + visible: # OPTIONAL. Default: true for player meters, false for NPC meters. + hidden_until: ""# OPTIONAL. Expression DSL. When true, the meter may be shown in UI/logs. + icon: "" # OPTIONAL. Short icon/emoji or UI key, e.g., "⚡" or "heart". + format: "integer|percent|currency" # OPTIONAL. UI hint: "integer" (default) | "percent" | "currency". + + # --- Behavior & Dynamics --- + decay_per_day: # OPTIONAL. Applied at day rollover; negative = decay, positive = regen. + decay_per_slot: # OPTIONAL. Applied when slot advances; negative = decay, positive = regen. + delta_cap_per_turn: # OPTIONAL. Max absolute change allowed per turn for this meter. + # Overrides any game-wide default cap for this meter only. + + # --- Threshold Labels (authoring sugar) --- + thresholds: # OPTIONAL. Labeled ranges for gating & cards. Non-overlapping, ordered. + : { min: , max: } # inclusive bounds; must lie within [min, max] + : { min: , max: } + + # --- Notes (author-facing only; ignored by engine) --- + description: "" # OPTIONAL. Brief author notes + +``` +### Example (NPC meter) +```yaml +meters: + template: + trust: + min: 0 + max: 100 + default: 10 + thresholds: + stranger: {min: 0, max: 19} + acquaintance: {min: 20, max: 39} + friend: {min: 40, max: 69} + close: {min: 70, max: 89} + intimate: {min: 90, max: 100} + delta_cap_per_turn: 3 + description: "Social comfort with the player; drives access to dates/kissing." +``` + +--- + +## 5. Flags + +### Definition & template +A **flag** is a small, named piece of state that marks discrete facts or progress (met someone, completed a step, +unlocked a route, etc.). Flags are lightweight, easy to query in conditions, and are validated at load time. +They can be boolean, number, or string, but should remain simple and stable over a whole run. + +```yaml +# Single Flag Definition (template) +# Place under: flags. + +: + type: "bool|number|string" # REQUIRED. One of: "bool" | "number" | "string". + default: # REQUIRED. Initial value (must match 'type'). + + # --- Visibility & UI --- + visible: # OPTIONAL. Show in debug/author UIs. Default: false. + reveal_when: "" # OPTIONAL. Expression DSL; when true, UI may show this flag. + label: "" # OPTIONAL. Human-friendly name for UI. + + # --- Validation (optional helpers) --- + allowed_values: # OPTIONAL. Only for string/number; reject values outside this set/range. + - + - + # --- Notes (author-facing only; ignored by engine) --- + description: "" # OPTIONAL. Brief author notes +``` + +**Constraints & Notes** +- **Naming**: use clear, stable keys (e.g., `emma_met`, `route_locked`, `first_kiss`). +- **Usage**: reference in expressions like `flags.first_kiss == true` or `flags.route_locked != true`. +- **Scope**: flags are **global** ; if you need NPC-scoped facts, either prefix (`emma_*`) or use NPC's meters. + +### Examples + +```yaml +flags: + emma_met: + type: "bool" + default: false + visible: true + label: "Met Emma" + description: "Set true after the first introduction scene." + + first_kiss: + type: "bool" + default: false + description: "Marks the first successful kiss with Emma." + + route_locked: + type: "bool" + default: false + description: "Prevents switching arcs once a route is committed." + + study_reputation: + type: "string" + default: "neutral" + allowed_values: ["bad","neutral","good","excellent"] + description: "Lightweight reputation tag shown in some dialogue branches." +``` + +**Typical conditions** +```yaml +"flags.emma_met == true and time.slot in ['evening','night']" +"flags.first_kiss == true or meters.emma.attraction >= 60" +"flags.study_reputation in ['good','excellent']" +``` + +--- +## 6. Time & Calendar + +### Definition & template + +The **time system** governs pacing, scheduling, and event triggers. It supports three modes: +- **Slots** — day divided into named parts (morning, afternoon, evening, night). +- **Clock** — continuous minute-based time (HH:MM). +- **Hybrid** — both: slots exist, but minutes are tracked within them. + +In the `clock/hybrid` mode, the `minutes_per_action` parameter defines the amount of time taken by one single action, +so each action can advance time properly. Once time moves into another slot window, the engine automatically advances slot as well. + +In the `slots` mode the engine automatically advances slots after `actions_per_slot` action. + +Once the last slot passed, the engine advances to the next day. + +Time advances through **actions**, **movement**, **effects**, and **sleep**, +and is referenced by **events**, **schedules**, and **arcs**. + +```yaml +# Time and Calendar definition +# In game manifest (top level) + +time: + mode: "slots|clock|hybrid" # REQUIRED. "slots" | "clock" | "hybrid" + + slots: ["morning","afternoon","evening","night"] # REQUIRED for slots/hybrid + actions_per_slot: # OPTIONAL for slots. Auto-advance after N actions. Default: ∞ + minutes_per_action: # REQUIRED for clock/hybrid. E.g., 30 + slot_windows: # REQUIRED for hybrid. Map slots → HH:MM ranges. + morning: { start: "06:00", end: "11:59" } + afternoon: { start: "12:00", end: "17:59" } + evening: { start: "18:00", end: "21:59" } + night: { start: "22:00", end: "05:59" } + + # --- Calendar (optional) --- + week_days: ["monday","tuesday","wednesday","thursday","friday","saturday","sunday"] + start_day: "tuesday" # Day of the week at epoch start +``` + +### Runtime State +```yaml +state.time: + day: 3 # narrative day counter + slot: "afternoon" # slot derived from mode + time_hhmm: "14:35" # HH:MM (clock/hybrid only) + weekday: "wednesday" # derived from calendar +``` + +### Authoring Guidelines + +- Use **hybrid mode** by default: slot-friendly authoring + precise event triggers. +- Keep slot names short and consistent (`morning`, not `early_morning`). +- For events and schedules, rely on `time.slot`, `time.hhmm`, or `time.weekday`. +- Always define a **starting slot/time** in `start`. +- Test pacing: ensure players can rest to recover meters before exhaustion. +--- + +## 7. Economy system + +### Configuration + +The **economy system** provides a built-in money/currency mechanism. +When enabled, it automatically creates a money meter for the player and enables purchase mechanics. +When disabled: +- No money meter created +- `purchase_item` effects are ignored +- Item `value` properties have no effect + + +```yaml +# Economy system configuration +# In game manifest (top level) +economy: # REQUIRED + enabled: true # Default: true. Set false to disable a money system. + starting_money: 50 # Default player starting money. + max_money: 9999 # Optional: money cap. Default: 9999. + currency_name: "dollars" # Optional: display name. Default: "dollars". + currency_symbol: "$" # Optional: display symbol. Default: "$". +``` + +### Auto-Generated Money Meter + +When `economy.enabled: true`, the engine automatically creates: + +```yaml +meters: + player: + money: + min: 0 + max: 9999 # From economy.max_money + default: 50 # From economy.starting_money + visible: true + icon: "💵" + format: "currency" +``` + +--- +## 8. Items + +### Definition & template + +An **item** is a defined object (gift, key, consumable, equipment, trophy, etc.) that can be owned +by the player or NPCs or exist in locations. The game defintion defines a global list of all known items that mey be referenced by ID in applicable places. + + +Clothing items are NOT defined here — they are tracked separately and live in the global `wardrobe` section. + + +```yaml +# Single Item Definition (template) +# Place under the inventory top level + +items: + - id: "" # REQUIRED. Unique ID. + name: "" # REQUIRED. Display name. + category: "str" # OPTIONAL. Freeform category to group items + + # --- Presentation --- + description: "" # OPTIONAL. Short description. + icon: "" # OPTIONAL. UI hint (emoji or asset key). + + # --- Economy --- + value: # OPTIONAL. Shop/economy price. + stackable: # OPTIONAL. Default: true. + droppable: # OPTIONAL. Default: true. + + # --- Usage --- + obtain_conditions: ["", ...] # OPTIONAL. Conditions to obtain. + + consumable: # OPTIONAL. Destroyed on use. + use_text: "" # OPTIONAL. Flavor text when used. + + # --- Gifting --- + can_give: # OPTIONAL. Can be gifted. + + # --- Dynamic effects --- + on_get: [, ... ] # OPTIONAL. Effects applied when get item. See the Effects section. + on_lost: [, ... ] # OPTIONAL. Effects applied when lost item. See the Effects section. + on_use: [, ... ] # OPTIONAL. Effects applied when used. See the Effects section. + on_give: [, ... ] # OPTIONAL. Effects when given. See the Effects section. +``` + +### Examples + +```yaml +items: + # Consumable + - id: "energy_drink" + name: "Energy Drink" + category: "consumable" + value: 5 + stackable: true + consumable: true + target: "player" + use_text: "You crack the can and chug the sweet, fizzy boost." + on_use: + - { type: meter_change, target: player, meter: energy, op: add, value: 25 } + + # Gift + - id: "flowers" + name: "Bouquet of Flowers" + category: "gift" + value: 20 + stackable: false + can_give: true + on_give: + - { type: meter_change, target: "{owner|recipient}", meter: attraction, op: add, value: 10 } + + # Key + - id: "dorm_key" + name: "Dorm Room Key" + category: "key" + value: 0 + droppable: false + unlocks: + location: ["dorm_room"] + + # Equipment + - id: "lucky_charm" + name: "Lucky Charm" + category: "equipment" + value: 15 + on_get: + - { type: meter_change, target: "{owner}", meter: attraction, op: add, value: 10 } +``` +For item effects engine recognizes the following two macros: + - `{owner}` - the character who currently owns the item. + - `{recipient}` - the character who is receiving the item. + + +### Runtime Inventory Structure + +```yaml +state: + inventory: + player: + energy_drink: 3 # Non-clothing items + flowers: 1 + dorm_key: 1 + white_blouse: 1 # Clothing items also in inventory, see the Clothing & Wardrobe section. + red_dress: 1 + black_heels: 1 + wildflowers: 2 + lucky_charm: 1 + blue_jeans: 1 + black_lace_bra: 1 + + emma: + red_dress: 1 + black_heels: 1 + wildflowers: 2 +``` + +### Authoring Notes +- `id` must be unique across all items; referenced by inventory, nodes, effects. +- Use **effects** to model concrete outcomes (money change, meter changes, flags) on use/gift. +- Prefer **keys/unlocks** for access gating; use flags only if no physical artifact is desired. +- Keep `description` concise; long lore should live in node prose. + +--- +## 9. Clothing System + +### Concepts +The **wardrobe system** defines all clothing items globally, which can then be owned and worn by any character. + + +To simulate different clothing layers (e.g., outerwear, top, bottom, underwear), the wardrobe system +defines a set of **clothing slots** that are ordered and allow one item to conceal another one. + + +Clothing items can be worn separately or grouped into **outfits**. +Outfits predefine clothing items to slots and populate corresponding items once applied. + + +Outfits can be worn either as a single unit and add all items to the character's inventory, +or require a character to have/acquire all required items to be applied. Outfits just populate items into slots, +so individual items can be changed or removed as a set of items. Each clothing item has own state and can be +`intact`, `opened`, `displaced`, `removed`. +`displaced` and `opened` allow revealing items from underneath slots. +`removed` means that the item is removed but still present in the inventory and can be worn again by changing its condition. +There is no special order between these statuses, +the engine assumes that statuses will be set by effects ir detected by the Checker from narrative. + + +Both clothing items and outfits act like inventory items and can be bought, given, apply effects, etc. +The game engine automatically extends the character's inventory with clothing items and outfits. + +The game manifest defines a global list of clothing items and outfits. Similar to meters, the definition of each character +may extend and override the global lists. + + +### Global Wardrobe Definition + +```yaml +# Top level in game manifest - alongside 'items', 'meters', 'characters' +wardrobe: + slots: ["", ... ] # Ordered list of clothing slots. + # E.g. ["outerwear", "top", "bottom", "underwear_top", "underwear_bottom", "feet", "accessories"] + items: [, ...] # Global clothing item library + outfits: [, ...] # Global outfits library +``` + +```yaml +# Clothing Item Definition +# Place under the corresponding wardrobe.items node +items: + - id: "" # REQUIRED. Unique clothing item ID. + name: "" # REQUIRED. Display name. + value: # OPTIONAL. Shop price; non-negative. + state: "intact|opened|displaced|removed" # OPTIONAL. Default: "intact" + look: # OPTIONAL. Narrative description. + intact: "" # OPTIONAL. Description of the intact item. + opened: "" # OPTIONAL. Description of the opened item. + displaced: "" # OPTIONAL. Description of the displaced item. + removed: "" # OPTIONAL. Description of the removed item. + occupies: ["", ...] # REQUIRED. Which slot(s) the current item occupies? Items like dresses that use multiple slots. + conceals: ["", ...] # OPTIONAL. Which slots are under the current slot? Engine can generate a description based on this. + can_open: # OPTIONAL. Default: true. Can be opened/unfastened? + # --- Locking --- + locked: # OPTIONAL. Default: false. + unlock_when: "" # OPTIONAL. Unlock condition. + # --- Dynamic effects --- + on_get: [, ... ] # OPTIONAL. Effects applied when get item. See the Effects section. + on_lost: [, ... ] # OPTIONAL. Effects applied when lost item. See the Effects section. + on_put_on: [, ... ] # OPTIONAL. Effects applied when the item is put on. + on_take_off: [, ... ] # OPTIONAL. Effects applied when the item is taken off. +``` + +```yaml +# Outfit definition +# Place under the corresponding wardrobe.outfits node +outfits: + - id: "" # REQUIRED. Outfit ID. + name: "" # REQUIRED. Display name. + description: "" # OPTIONAL. Author notes. + + # --- Items --- + items: [, ...] # Items in the outfit by slot. + grant_items: # OPTIONAL. Auto-grant items. + + # --- Locking --- + locked: # OPTIONAL. Default: false. + unlock_when: "" # OPTIONAL. Unlock condition. + # --- Dynamic effects --- + on_get: [, ... ] # OPTIONAL. Effects applied when get outfit. See the Effects section. + on_lost: [, ... ] # OPTIONAL. Effects applied when lost outfit. See the Effects section. + on_put_on: [, ... ] # OPTIONAL. Effects applied when the outfit is put on. + on_take_off: [, ... ] # OPTIONAL. Effects applied when the outfit is taken off. +``` +Note: items in outfits will be merged into slots in order of appearance. +If some items occupy the same slot, the last one will be used. + + +### Examples +```yaml + TODO: add examples +``` +--- + +## 10. Inventory + +Inventory is a collection that lists items, clothing items, and outfits available in some context like shop of location. +Each list item defines an id of the item and provides how many items are available, defines additional logic +and may override the price. + +Currentle the engine allows adding inventory to: + - locations to define items present in the location (e.g., book at the table, dress in the closet); + - shops to define items available for sale. + +The internal game state object tracks the same inventory structure for each character, location, and shop. + +```yaml +# Inventory definition +# Place under shop or location nodes + +inventory: + items: [, ...] # OPTIONAL. Available items + clothing: [, ... # OPTIONAL. Available clothing items + outfits: [, ...] : # OPTIONAL. Available outfits +``` +```yaml +# Inventory_item definition +# Place inside lists in the inventory + +- id: # REQUIRED. + count: # OPTIONAL. Default: 1. Number of items available. + value: # OPTIONAL. Price override of the item. + infinite: # OPTIONAL. Infinite (ignores count)? Default: false. + discovered: # OPTIONAL. Discovered and visible? Default: true. + discovered_when: "" # OPTIONAL. Condition to reveal. +``` + +--- + +## 11. Shopping System + +The shopping system allows players to buy or sell item. +The `shop` node defines its own inventory with items available for sale. +It can also provide an option for the player to sell items. +Expressions allow to set price multipliers for selling and purchasing. + +The `shop` node can be **attached** to any location or character, so characters become merchants and location become stores. +Once a shop node is attached, game UI allows players to enther the shop, list items and buy/sell. + +```yaml +# Shop definition +# Place under any location or character +shop: # OPTIONAL. Shop definition. + name: "" # REQUIRED. Shop name + description: "" # OPTIONAL. Author notes. + when: "" # OPTIONAL. Expression DSL. Default: true. Defines when shop is open. + can_buy: "" # OPTIONAL. Expression DSL. Default: true. Can buy items from the player. + multiplier_sell: "" # OPTIONAL. Expression DSL. Multiplier for selling to the player. Default 1.0 + multiplier_buy: "" # OPTIONAL. Expression DSL. Multiplier for buying from the player. Default 1.0 + + # --- Inventory --- + inventory: +``` + +--- + +## 12. Locations & Zones + +### World Model +The world model is hierarchical: +- **Zones**: broad narrative areas (e.g., Campus, Downtown). +- **Locations**: discrete places within zones (e.g., Library, Dorm Room). + + +the zones must be listed twice. + +Locations define connections, each location lists zones it is connected to. + +Locations carry **privacy levels** (public → private), **discovery state**, **access rules**, and **connections**. +Zones may define **transport options** and **events** tied to entering or exploring. + +This model allows authored content to target specific areas and the engine to enforce rules +for **movement**, **privacy**, **discovery**, and **NPC willingness**. + +### Zone template +Zones have unique id, name, and define locations within a zone, access rules, and connections, each zone lists zones it is connected to. +Connections are one way links, so for bidirectional connection between two zones, each one must refer another one. +If there are no connections provides then it is possible to travel between any zone based on visibility and access rules. + +```yaml +# Zone definition +# Place under the top level zones node + +- id: # REQUIRED. Unique stable zone ID. + name: "" # REQUIRED. Display name. + summary: "" # OPTIONAL. Short description to show in UI and pass to Writer. + privacy: "low|medium|high" # REQUIRED. low | medium | high (default: low) + description: "" # OPTIONAL. Author notes. + + # --- Access & discovery --- + access: # OPTIONAL. Access rules. + discovered: # OPTIONAL. Default false. + hidden_until_discovered: # OPTIONAL. Default false. + discovered_when: "" # OPTIONAL. Expressions; if true, then revealed. + locked: # OPTIONAL. Default false. + unlocked_when: "" # OPTIONAL. Expression DSL. If true, then unlocked. + + # --- Transport & travel --- + connections: # OPTIONAL. Travel routes between zones. + - to: ["|all", ...] # REQUIRED. Connects to specified zones, shortcut 'all' means all zones. + exceptions: ["", ...] # OPTIONAL. Excludes zone from the connection if to='all'. + methods: ["bus|car|walk", ...] # OPTIONAL. Transport methods for the link. See the Movement Rules for details + distance: # OPTIONAL. Distance to calculate time and cost. See the Movement Rules for details. + + # --- Inline locations (see below) --- + locations: [ ... ] + + # --- Entrances and exits --- + entrances: [""] # OPTIONAL. List of locations that allow entering a zone. Not set = enter any location. + exits: [""] # OPTIONAL. List of locations that allow exiting a zone. Not set = exit from any location. + + +``` +### Location template +Locations are similar to zones with some differences: +- Connections have another system of connections which allows step by step movibg between locations +using cardinal direction and up/down between floors. +- Connections may be locked with conditional unlock (e.g., a closed door requires a key) +- Locations have own inventory which defines all present items with option to collect items. +- Dropped items may be added to a location's inventory. + +> Location's inventory is not a shop, but just a list of what is available in the location and can be collected. +> +> **All price options in the inventory are ignored.** + +```yaml +# Location definition lives under: zones[].locations[] +- id: # REQUIRED. Unique stable zone ID. + name: "" # REQUIRED. Display name. + summary: "" # OPTIONAL. Short description to show in UI and pass to Writer. + description: "" # OPTIONAL. Author notes. + privacy: "low|medium|high" # REQUIRED. low | medium | high (default: low) + + # --- Access & discovery --- + access: # OPTIONAL. Access rules. + discovered: # OPTIONAL. Default false. + hidden_until_discovered: # OPTIONAL. Default false. + discovered_when: "" # OPTIONAL. Expressions; if true, then revealed. + locked: # OPTIONAL. Default false. + unlocked_when: "" # OPTIONAL. Expression DSL. If true, then unlocked. + + # --- Connections (intra-zone travel) --- + connections: # OPTIONAL. Connection to adjacent locations + - to: "" # REQUIRED. Target location in the same zone + description: "" # OPTIONAL. Short description to show in UI and pass to Writer. + direction: "n|s|w|e|nw|ne|sw|se|u|d" # REQUIRED. Cardinal directions and up/down. + locked: # OPTIONAL. Default false. + unlocked_when: "" # OPTIONAL. Expression DSL. If true, then unlocked. + # --- Inventory --- + inventory: # OPTIONAL. Location's inventory. This is not a shop. + shop: # OPTIONAL. Shop definition. + +``` +### Runtime State (excerpt) +```yaml +state.location: + zone: "" + id: "" + privacy: "" # carried into consent checks +``` + +### Example +```yaml +# TODO add examples +``` +### Movement +The **movement system** governs how the player (and companions) travel between locations and zones. +Movement consumes **time** , requires **access conditions** to be met, +and checks **NPC consent** when traveling with companions. +- **Local**: moving between locations inside the same zone consumes **base_time**: + - in `time/hybrid` modes `base_time` means minutes for one movement; + - in the `slots` mode `base_time` means number of actions for movement; + - `base_time = 0` means immediate movement which does not consume time or actions. +- **Zone travel**: moving between different zones consumes time based on distance and travel method: + - Definition of methods provides own `base_time` for each method which means time to travel one unit of distance; + - Connections between zones define `distance` and available travel methods; + - The final travel time is calculated as `base_time * distance` for each method; + - For `slots` mode base time is the number of actions for movement. +- **Companions**: NPC willingness depends on trust/attraction/gates and defined for each character. + +```yaml + +# Movement system definition +# Place as a top level movement node +movement: # OPTIONAL. Top level node + base_time: # OPTIONAL. Base time for local travel. + # Minutes/actions consumed for one movement. + use_entry_exit: # OPTIONAL. Default false. + # If true, arrive to zone's entry locations and + # must reach the zone's exit location to travel out of a zone. + + methods: # REQUIRED if a game uses travel methods. List of travel methods. + - "": # REQUIRED. Unique method name and base time. +``` +--- +## 13. Characters + +### Character Template +A **character** is any entity (NPC or player avatar) that participates in the story. +Characters are defined with **identity**, **meters**, **consent gates**, **wardrobe**, and **availability**. + + +Characters cannot exist without a valid `id`, `name`, and `age`. +All other aspects (meters, outfits, behaviors) are optional but strongly recommended. + + + +Characters provide the core state the Writer and Checker operate on: they drive interpersonal progression, gating, and narrative consistency. + + +The player character is always defined as `player`. It can be defined as a character with `id: "player"`. +If such character is not defined, the game engine will create a default one. +The only difference between the player character and other characters are meters: +meters for player are taken from the `player` section of the `meters` node in the game manifest +while meters for other characters are taken from the `template` section. + +```yaml +# Character Template +# Place under the top level items node + +- id: # REQUIRED. Unique stable ID. + name: "" # REQUIRED. Display name. + age: # REQUIRED. + gender: "" # REQUIRED. Free text or enum ("female","male","nonbinary"). + pronouns: [] # OPTIONAL. List of pronouns for better UI pointing. E.g. ["she", "her", "herself"]. + description: "" # OPTIONAL. Author-facing description (cards, logs). + dialogue_style: "" # OPTIONAL. A simple string describing the character's speech patterns for the AI. + + # Personality - small text pieces describing character + # E.g. { + # "core traits": "strong, honest, loyal", + # "quirks": "clever, clever, clever", + # "fears": "darkness", + # } + personality: {"": ""} # OPTIONAL. Free text key/value pairs. + appearance: "" # OPTIONAL. Free text. + + meters: { ... } # OPTIONAL. Overrides / additions to character_template meters. + + gates: { ... } # OPTIONAL. Behavioral gates + + wardrobe: { ... } # OPTIONAL. Overrides / additions to global wardrobe. + clothing: # OPTIONAL. Initial character clothing + outfit: # OPTIONAL. If set, will populate items into slots + items: {: , ... } # OPTIONAL. Clothing items by slots. + + # --- Schedule --- + schedule: # OPTIONAL. Controls where the character is by time/day. List of schedules + - when: "" # A condition, typically checking time.slot or time.weekday + when_all: ["", ...] # A list of conditions, all must be true. + when_any: ["", ...] # A list of conditions, at least one must be true. + location: "" # A location where a character will appear when condition met + # Exactly one of when, when_all, or when_any must be set. + + # --- Movement willingness --- + movement: # OPTIONAL. Rules for following player to other zones/locations. + willing_zones: # OPTIONAL. List of rules for following player to other zones. + - zone: ">" # REQUIRED. Target zone. + when: "" # OPTIONAL. Condition when willing to move. Can be 'always', it is the same as not having a rule at all. + when_all: ["", ...] # OPTIONAL. List of conditions, all must be true. + when_any: ["", ...] # OPTIONAL. List of conditions, at least one must be true. + # Exactly one of when, when_all, or when_any must be set. + willing_locations: # OPTIONAL. List of rules for following player to other locations. + - location: ">" # REQUIRED. Target location. + when: "" # OPTIONAL. Condition when willing to move. Can be 'always', it is the same as not having a rule at all. + when_all: ["", ...] # OPTIONAL. List of conditions, all must be true. + when_any: ["", ...] # OPTIONAL. List of conditions, at least one must be true. + # Exactly one of when, when_all, or when_any must be set. + + inventory: # OPTIONAL. Items carried by this character. + shop: # OPTIONAL. Shop definition. +``` +> Exactly one of `location` or `zone` must be set where applicable. + +### Gates +Behavioral **gates** are a powerful tool for defining the conditions under which a character +will do certain action or behave in a certain way. They are defined as a list of conditions +that must be met for a character to be allowed to perform a certain action. + + +The game engine checks gates each turn and activate all gates that are met. +Active gates can be checked by their id in expressions. Also, each gate contains narrative text +that will be passed to the Writer and Checker to keep character's behavior consistent. + +```yaml +gates: # OPTIONAL. A list of consent/behavior gates. + - id: ````` # REQUIRED. Unique ID (e.g., "accept_kiss"). + when: "" # OPTIONAL. A single condition that must be true. + when_any: ["", ...] # OPTIONAL. A list of conditions where at least one must be true. + when_all: ["", ...] # OPTIONAL. A list of conditions where all must be true. + acceptance: "" # OPTIONAL. Text to pass to Writer and Checker if a gate is active + refusal: "" # OPTIONAL. Text to pass to Writer and Checker if a gate is not active +``` +> Exactly one of `when`, `when_any`, and `when_all` may be set. +> +> Either `acceptance` or `refusal` must be set.` + +Each evaluated gate contributes one of the following objects: + - `{ id, allow: true, text: acceptance }` if the gate is active and acceptance text is provided; + - `{ id, allow: false, text: refusal }` if the gate is not active and refusal text is provided; + +The engine exposes this compact form in: + - **Character cards** (for the Writer model) — used to naturally steer dialogue. + - **Checker envelope** — used for enforcement and validation. + +### Runtime State (excerpt) +```yaml +state.characters: + emma: + meters: { trust: 45, attraction: 35, arousal: 10, boldness: 20 } + outfit: "casual_day" + clothing: + top: "white_blouse" + bottom: "skirt" + underwear_top: "black_silk_bra" + underwear_bottom: "black_silk_panties" + clothing_state: + top: "opened" + bottom: "intact" + underwear_top: "intact" + underwear_bottom: "intact" + modifiers: [] + location: "library" +``` +### Example +```yaml +- id: "emma" + name: "Emma Chen" + age: 19 + gender: "female" + description: "A shy and conservative literature student, gradually opening up." + tags: ["student","shy","conservative"] + + meters: + trust: { min: 0, max: 100, default: 10 } + attraction: { min: 0, max: 100, default: 0 } + arousal: { min: 0, max: 100, default: 0 } + boldness: { min: 0, max: 100, default: 20 } + + gates: + "accept_date": + when: "meters.emma.trust >= 30" + acceptance: "She will accept the date." + refusal: "She will not accept the date." + "accept_kiss": + when_any: + - "meters.emma.trust >= 40 and meters.emma.attraction >= 30" + - "meters.emma.corruption >= 40" # Example of an alternative path + acceptance: "She will accept kiss." + refusal: "She will refuse kiss." + "accept_sex": + when_all: + - "meters.emma.trust >= 70" + - "meters.emma.attraction >= 70" + - "meters.emma.arousal >= 50" + - "location.privacy == 'high'" + acceptance: "She will accept sex." + refusals: "She will not accept sex and will get angry" + + schedule: + - when: "time.slot == 'morning'" + location: "library" + - when: "time.slot == 'night'" + location: "dorm_room" +``` +### Authoring Guidelines +- Define **gates explicitly**: they control intimacy and prevent unsafe AI output. +- Use **character-scoped meters** sparingly; prefer template defaults unless diverging. +- Keep wardrobe minimal unless outfits are narratively important. +- Use **schedule** for predictable presence; events can override temporarily. +- For romance/NSFW arcs, define **both trust and attraction** as core meters. + +--- + +## 14. Effects + +### Base Effect Definition + +An **effect** is an atomic, declarative instruction that changes the game state. Effects are: +- **Deterministic** — applied in order, validated against schema. +- **Declarative** — authors describe what changes, not how. +- **Guarded** — can include a `when` condition (expression DSL). +- **Validated** — invalid or disallowed effects are ignored and logged. + +Effects can be authored in nodes, events, arcs, milestones, or items. +The Checker may also emit effects as JSON deltas, which are merged into the same pipeline + +```yaml +# Single Effect Definition (template) +- type: "" # REQUIRED. Effect kind (see catalog below). + description: "" # OPTIONAL. Author notes. + when: "" # OPTIONAL. A single guard condition that must be true. Default: "always". + when_any: ["", ...] # OPTIONAL. A list of conditions where at least one must be true. + when_all: ["", ...] # OPTIONAL. A list of conditions where all must be true. + + # Rest of fields depend on type. +``` +> Only one of `when`, `when_any`, and `when_all` may be set. + +### Catalog of Effect Types + +#### Meter change +Applies a change to a meter. +```yaml +# Modify meter value +- type: meter_change + # ... common fields + target: "player|" # REQUIRED. Effect target. + meter: "" + op: "add | subtract | set | multiply | divide" + value: + respect_caps: true # OPTIONAL. Default: true (clamp to min/max). + cap_per_turn: true # OPTIONAL. Default: true (respect delta caps). +``` +#### Flag set +Changes a flag value. +```yaml +# Set flag +- type: flag_set + # ... common fields + key: "" + value: true | false | number | string +``` + +#### Inventory +```yaml +# Add item to inventory +- type: inventory_add + # ... common fields + target: "player | " # REQUIRED. Effect target. + item_type: "item | clothing | outfit" # REQUIRED. Type of the item + item: "" # REQUIRED + count: # OPTIONAL. Default: 1. + +# Remove item from inventory +- type: inventory_remove + # ... common fields + target: "player | " # REQUIRED. Effect target. + item_type: "item | clothing | outfit" # REQUIRED. Type of the item + item: "" # REQUIRED + count: # OPTIONAL. Default: 1. + +# Take item from the current location; checks availability +- type: inventory_take + # ... common fields + target: "player | " # REQUIRED. Effect target. + item_type: "item | clothing | outfit" # REQUIRED. Type of the item + item: "" # REQUIRED + count: # OPTIONAL. Default: 1. + +# Drops item at the current location inventory +- type: inventory_drop + # ... common fields + target: "player | " # REQUIRED. Effect target. + item_type: "item | clothing | outfit" # REQUIRED. Type of the item + item: "" # REQUIRED + count: # OPTIONAL. Default: 1. + +# Gives item to another player/npc +- type: inventory_give + # ... common fields + source: "player | " # REQUIRED. Effect source - who gives the item. + target: "player | " # REQUIRED. Effect target - who receives the item. + item_type: "item | clothing | outfit" # REQUIRED. Type of the item + item: "" # REQUIRED + count: # OPTIONAL. Default: 1. +``` + +#### Shopping +```yaml +# Purchase item +- type: inventory_purchase + # ... common fields + target: "player | " # REQUIRED. Effect target. Ignored for the flag_set + source: "" # REQUIRED. Source of the item (npc or location with a shop). + item_type: "item | outfit | clothing" # REQUIRED. Type of the item + item: "" # REQUIRED + count: # OPTIONAL. Default: 1. + price: # OPTIONAL. Default: defined by item or shop + +# Sell item from inventory +- type: inventory_sell + # ... common fields + target: "" # REQUIRED. Source of the item (npc or location with a shop). + source: "player | " # REQUIRED. Effect target. Ignored for the flag_set + item_type: "item | outfit | clothing" # REQUIRED. Type of the item + item: "" # REQUIRED + count: # OPTIONAL. Default: 1. + price: # OPTIONAL. Default: defined by item or shop +``` +#### Clothing +````yaml +# Puts an item from the wardrobe on +- type: clothing_put_on + # ... common fields + target: "player | " # REQUIRED. Effect target. Ignored for the flag_set + item: "" # REQUIRED. Clothing item will occupy corresponding slot(s). + state: "intact | displaced | opened | removed" # OPTIONAL. Default: taken from the item or intact. + +# Takes an item off and keeps it in the wardrobe +- type: clothing_take_off + # ... common fields + target: "player | " # REQUIRED. Effect target. Ignored for the flag_set + item: "" # REQUIRED. + +# Applies state to item +- type: clothing_state + # ... common fields + target: "player | " # REQUIRED. Effect target. Ignored for the flag_set + item: "" # REQUIRED. + state: "intact | displaced | opened | removed" # REQUIRED. + +# Applies state to the item that occupies the slot +- type: clothing_slot_state + # ... common fields + target: "player | " # REQUIRED. Effect target. Ignored for the flag_set + slot: "" # REQUIRED. + state: "intact | displaced | opened | removed" # REQUIRED. + +# Puts on all items from te outfit +- type: outfit_put_on + # ... common fields + target: "player | " # REQUIRED. Effect target. Ignored for the flag_set + item: "" # REQUIRED. + +# Takes off all items from the outfit +- type: outfit_take_off + # ... common fields + target: "player | " # REQUIRED. Effect target. Ignored for the flag_set + item: "" # REQUIRED. +```` + +#### Movement & Time +```yaml +# Local movement from the current location in a specified direction +- type: move + # ... common fields + direction: "n | s | w | e | nw | ne | sw | se | u | d" # REQUIRED. Cardinal directions and up/down. + # Also allows full values north, south, etc. + with_characters: ["", ...] # consent checked + +# Local movement within a zone to a location +- type: move_to + # ... common fields + location: "" # REQUIRED. Target location in the same zone + with_characters: ["", ...] # OPTIONAL. + +# Global movement between zones +- type: travel_to + # ... common fields + location: "" # REQUIRED. Target location in another zone. + method: "" # REQUIRED. Method to travel with. + with_characters: ["", ...] # OPTIONAL. + +# Time advancement +- type: advance_time + # ... common fields + minutes: # REQUIRED. Minutes to advance. + +# Time advancement for slot mode +- type: advance_time_slot + # ... common fields + slots: # REQUIRED. +``` + +#### Flow control +```yaml +# Switches game to a specified node +- type: goto + # ... common fields + node: "" + +# Combined effect with complex conditions +- type: conditional + when: "" # One of when/when_any/when_all is REQUIRED. + when_any: ["", ...] + when_all: ["", ...] + then: [ ] # Effects to apply when a condition is met. + otherwise: [ ] # Effects to apply when a condition is not met. + +# Random effect applies one of different sets of effects based on random value with defined weights (%) +- type: random + # ... common fields + choices: + - weight: + effects: [ ] + - weight: + effects: [ ] +``` +> Only one of `when`, `when_any`, and `when_all` may be set. + +#### Modifiers +```yaml +# Applies a modifier +- type: apply_modifier + # ... common fields + target: "player|" # REQUIRED. Effect target. Ignored for the flag_set + modifier_id: "" # REQUIRED. + duration: # OPTIONAL. Duration override + +# Removes a modifier +- type: remove_modifier + # ... common fields + target: "player|" # REQUIRED. Effect target. Ignored for the flag_set + modifier_id: "" # REQUIRED. +``` + + +#### Unlocks & Locks +```yaml +# Unlocks listed entity(ies) +- type: unlock + items: ["", ... ] + clothing: ["", ... ] + outfits: ["", ... ] + zones: ["", ... ] + locations: ["", ... ] + actions: ["", ... ] + endings: ["", ... ] + +# Locks listed entity(ies) +- type: lock + items: ["", ... ] + clothing: ["", ... ] + outfits: ["", ... ] + zones: ["", ... ] + locations: ["", ... ] + actions: ["", ... ] + endings: ["", ... ] + +``` +### Execution Order (per turn) + +1. **Gates** (hard rules, consent). +2. **Node entry_effects** / **event effects** (in order). +3. **Checker deltas** (validated, clamped). +4. **Modifiers resolution** (activation, expiry, stacking). +5. **Advance time** (explicit or defaults). +6. **Node transitions** (forced `goto` → authored `transitions` → fallback). + +### Constraints & Notes + +- Conditions use the Expression DSL. +- Unknown `type` or invalid fields → effect rejected, log warning. +- Invalid references (unknown meter/item/npc/location) → effect rejected. +- `when` guard false → effect skipped silently. +- All randomness is seeded deterministically (`game_id + run_id + turn_index`) for replay stability. + +### Examples +**Trust boost or penalty** +```yaml +- type: conditional + when: "player.polite == true" + then: + - { type: meter_change, target: "emma", meter: "trust", op: "add", value: 2 } + otherwise: + - { type: meter_change, target: "emma", meter: "trust", op: "subtract", value: 1 } + +``` +**Weighted random outcome** +```yaml +- type: random + choices: + - weight: 70 + effects: [{ type: flag_set, key: "heard_rumor", value: true }] + - weight: 30 + effects: [{ type: meter_change, target: "player", meter: "energy", op: "subtract", value: 5 }] +``` + +**Move with companion** +```yaml +- type: move_to + location: "emma_room" + with_characters: ["emma"] +``` +--- + +## 15. Modifiers + +### Purpose & Template +A **modifier** is a named, (usually) temporary state that overlays appearance/behavior rules +without directly rewriting canonical facts. Think **aroused**, **drunk**, **injured**, **tired**. +Modifiers can auto-activate from conditions, be applied/removed by effects, stack or exclude each other, +and may carry a default duration. They influence gates, dialogue tone, and presentation +but don’t invent hard state changes by themselves. + + +**Activation**: a modifier can be **auto-activated** by `when` each turn, or explicitly applied via an effect. + +```yaml +# Modifier Template +# Place under: modifiers.library + + # --- Identity --- +- id: "" # REQUIRED. Unique ID. + group: "" # OPTIONAL but recommended. Category for stacking/exclusions (e.g., "intoxication", "emotional"). + priority: # OPTIONAL. Priority within a group (see below). + + # --- Activation --- + when: "" # OPTIONAL. Auto-activation condition (evaluated each turn). + when_all: "" # OPTIONAL. Auto-activation condition (evaluated each turn). + when_any: "" # OPTIONAL. Auto-activation condition (evaluated each turn). + duration: # OPTIONAL. Default runtime duration in minutes/actions when applied without explicit duration. + + # --- Appearance & Behavior overlays (soft influence) --- + mixins: [" # OPTIONAL, Overrides dialogue style. + + # --- Safety & Gates (hard constraints) --- + disallow_gates: ["", ...] # OPTIONAL. Gates to disable, e.g., forbid "accept_sex" while drunk + allow_gates: ["", ...] # OPTIONAL. Gates to force. Rarely used; prefer arcs/gates unless tightly controlled + + # --- Systemic Rules --- + clamp_meters: # OPTIONAL. Enforce temporary boundaries on meters while active. + : { min: , max: } # e.g., arousal: { max: 60 } + + # --- One-shot hooks (optional sugar) --- + on_entry: [, ... ] # OPTIONAL. Apply once when the modifier becomes active. + on_exit: [, ... ] # OPTIONAL. Apply once when it ends. +``` +> No conditions at all or exactly one of `when`, `when_any`, and `when_all` must be set. + +### Modifiers Node & Stacking Rules + +All modifiers are defined under the `modifiers` node together with stacking rules. +Stacking rules define how multiple modifiers of the same group applied: +- All modifiers of the same group are sorted by priority (highest first). +Modifiers with the same priority are applied in the order they defined. +- If multiple modifiers of the same group is about to be applied, the engine decides what to do +based on the `stacking` parameter: + - `highest` - the highest priority modifier is applied. Any other active modifiers of the same group are removed. + - `lowest` - the lowest priority modifier is applied. Any other active modifiers of the same group are removed. + - `all` - all modifiers that are not currently active applied. + +```yaml +# Modifiers definition +# In game manifest (top level) +modifiers: + stacking: # OPTIONAL. Stacking rules + : "highest|lowest|all" # REQUIRED. List of staking options for groups + library: [ , ... ] # REQUIRED. Modifiers definition +``` + +### Examples +```yaml +modifiers: + library: + aroused: + group: "emotional" + when: "meters.{character}.arousal >= 40" + appearance: { "cheeks flushed" } + dialogue_style: "breathless" + + drunk: + group: "intoxication" + duration: 120 + appearance: { "eyes glossy" } + disallow_gates: ["accept_sex"] # hard stop while intoxicated + + injured_light: + group: "status" + duration: 240 + on_entry: + - { type: meter_change, target: "player", meter: "energy", op: "subtract", value: 10 } + on_exit: + - { type: flag_set, key: "injury_healed", value: true } +``` +--- + +## 16. Actions + +### Purpose & Template + +An **action** is a globally defined, reusable player choice that can be unlocked through effects. +Unlike node-based `choices` which are tied to a specific scene, +unlocked actions can become available to the player in any context, provided their conditions are met. +This allows for character growth and new abilities that persist across the game. + +Actions are defined in a top-level `actions` node. + + +```yaml +# Actions definition +# In game manifest (top level) +actions: + - id: # REQUIRED. UniqueID for unlocking. + prompt: "" # REQUIRED. The text shown to the player. + category: "" # OPTIONAL. UI hint (e.g., "conversation", "romance"). + when: "" # OPTIONAL. Expression DSL. Action is only available if true. + when_all: ["", ... ] # OPTIONAL. Expression DSL. Action is only available if true. + when_any: ["", ... ] # OPTIONAL. Expression DSL. Action is only available if true. + effects: [ , ... ] # OPTIONAL. Effects applied when the action is chosen. +``` + +> Only one of `when`, `when_any`, and `when_all` may be set. + +### Example + +```yaml +# actions.yaml + +actions: + - id: "deep_talk_emma" + prompt: "Ask Emma about her family" + category: "conversation" + when: "npc_present('emma') and meters.emma.trust >= 60" + effects: + - type: "meter_change" + target: "emma" + meter: "trust" + op: "add" + value: 10 + - type: "flag_set" + key: "emma_opened_up" + value: true +``` +--- + +## 17. Nodes + +### Purpose & Template + +A **node** is the authored backbone of a PlotPlay story. +Each node represents a discrete story unit — a scene, a hub, an encounter,an event, or an ending. +Nodes combine **authored beats and choices** with **freeform AI prose**, +and control how the story progresses via **transitions**. + +Nodes are where most author effort goes: they set context for the Writer, define conditions and effects, and connect to other nodes + +**Node types:** +- **scene** — A focused moment with authored beats and freeform AI prose. +- **hub** — A menu-like node for navigation or repeated interactions. +- **encounter** — Short, often event-driven vignette; usually returns to a hub. +- **ending** — Terminal node; resolves the story and stops play. + +```yaml +# Node template +# Place under the 'nodes' root node +- id: # REQUIRED. Unique node id + type: "scene|hub|encounter|ending" # REQUIRED. scene | hub | encounter | ending + title: "" # REQUIRED. Display name in UI/logs. + description: "" # OPTIONAL. Author notes. + characters_present: ["", ...] # OPTIONAL. Explicitly list character IDs present in this node. + + # --- Writer guidance --- + narration: # OPTIONAL. Override defaults from the game manifest. + pov: "" + tense: "" + paragraphs: "1-2" + + beats: [, ... ] # OPTIONAL. Bullets for Writer (not shown to players). + + # --- Effects --- + on_entry: [ , ... ] # OPTIONAL. Applied when the node is entered. + on_exit: [ , ... ] # OPTIONAL. Applied when the node is left. + + # --- Actions & choices --- + choices: # OPTIONAL. Pre-authored menu buttons. Always visible + - id: "" # REQUIRED. Unique id + prompt: "" # REQUIRED. Shown to player. + when: "

All files / components ChoicePanel.tsx

All files / components LoadingSpinner.tsx

All files / components MovementControls.tsx

All files components

All files hooks

All files / hooks index.ts

All files / hooks useKeyboardShortcuts.ts

All files / hooks useLocation.ts

All files / hooks usePlayer.ts

All files / hooks usePresentCharacters.ts

All files / hooks useSnapshot.ts

All files / hooks useTimeInfo.ts

All files / hooks useToast.ts

All files

All files / services gameApi.ts

All files services

All files / stores gameStore.ts

All files stores

All files tests

All files / tests testUtils.tsx

All files utils

All files / utils index.ts

All files / utils meterUtils.tsx

All files / utils storage.ts

All files / utils textFormatting.ts

Characters Present

{charId}

+ {character.name ?? character.id} +

+ + Quick Utilities +

+ + Economy +

+ {fallbackTitle} +

{currentGame?.title}

Resume Previous Session?

Select Your Adventure

@@ -33,11 +51,16 @@ export const InventoryPanel = () => { Inventory

+ + Movement +

Turn Log