mirror of
https://github.com/prosolis/gogobee.git
synced 2026-07-15 00:32:40 +00:00
81b2359109
Five correctness fixes from a code review of the N5 branch: - Robbie no longer sweeps/sells cross-zone keys (Type "key"), which permanently broke the vault unlock they exist to open. - Robbie's gift tier now reads the canonical DnD level, not the frozen legacy CombatLevel that pegged every gift at tier 1. - Boss epilogue (D1b) now fires on the compact autopilot boss resolve — the primary long-expedition path — not just manual !fight. Deduped the two manual sites into a shared writeBossEpilogue helper. - Finale reward latches epilogue_cleared before granting the Legendary + title, so a failed/late write can't make the reward repeatable. - Misty arc beat's occupied-slot guard moved above the counter increment, so a contended pending slot defers the encounter instead of consuming a 5/15/30 beat forever. Claude-Session: https://claude.ai/code/session_017mEwUmmS7aQTP2NQXj6rUa
1425 lines
55 KiB
Go
1425 lines
55 KiB
Go
package plugin
|
||
|
||
import (
|
||
"fmt"
|
||
"strings"
|
||
|
||
"maunium.net/go/mautrix/id"
|
||
)
|
||
|
||
// !zone — Phase 11 D1c. The command surface for the dungeon-zone state
|
||
// machine landed in D1b. This file is presentation + dispatch only; the
|
||
// actual run/state plumbing lives in dnd_zone_run.go and the registry in
|
||
// dnd_zone.go.
|
||
//
|
||
// Subcommands:
|
||
//
|
||
// !zone → list zones available at player level
|
||
// !zone list → same
|
||
// !zone enter <id|number|name> → start a run
|
||
// !zone status → current room / cleared count / mood / loot
|
||
// !zone map → ASCII layout of the run with current marker
|
||
// !zone advance → resolve the current room and move on
|
||
// !zone abandon → end the active run (no rewards)
|
||
// !zone taunt → poke TwinBee (mood −10, snarky reply)
|
||
// !zone compliment → flatter TwinBee (mood +5, fond reply)
|
||
//
|
||
// TwinBee narration / mood triggers arrive in D1d. Combat / trap / boss
|
||
// resolution per room is wired in D1e via dnd_zone_combat.go.
|
||
|
||
func (p *AdventurePlugin) handleDnDZoneCmd(ctx MessageContext, args string) error {
|
||
userMu := p.advUserLock(ctx.Sender)
|
||
userMu.Lock()
|
||
defer userMu.Unlock()
|
||
|
||
c, err := LoadDnDCharacter(ctx.Sender)
|
||
if err != nil {
|
||
return p.SendDM(ctx.Sender, "Couldn't load your character: "+err.Error())
|
||
}
|
||
if c == nil || c.PendingSetup {
|
||
return p.SendDM(ctx.Sender,
|
||
"No Adv 2.0 character yet — run `!setup` (or just enter combat and we'll auto-build one).")
|
||
}
|
||
|
||
args = strings.TrimSpace(args)
|
||
sub, rest := splitFirstWord(args)
|
||
switch strings.ToLower(sub) {
|
||
case "", "list", "ls":
|
||
return p.zoneCmdList(ctx, c)
|
||
case "enter", "start":
|
||
return p.zoneCmdEnter(ctx, c, rest)
|
||
case "go", "choose":
|
||
// Graph-mode fork commit. Outside the POC gate (or with no
|
||
// fork pending) the handler short-circuits with a friendly
|
||
// message — see zoneCmdGo for the full surface.
|
||
return p.zoneCmdGo(ctx, rest)
|
||
case "status", "info":
|
||
return p.zoneCmdStatus(ctx)
|
||
case "map", "m":
|
||
return p.zoneCmdMap(ctx)
|
||
case "advance", "next", "a":
|
||
return p.zoneCmdAdvance(ctx)
|
||
case "revisit", "back":
|
||
return p.handleRevisitCmd(ctx, rest)
|
||
case "abandon", "leave", "quit":
|
||
return p.zoneCmdAbandon(ctx)
|
||
case "taunt":
|
||
return p.zoneCmdTaunt(ctx)
|
||
case "compliment":
|
||
return p.zoneCmdCompliment(ctx)
|
||
case "lore", "history":
|
||
return p.zoneCmdLore(ctx)
|
||
default:
|
||
return p.SendDM(ctx.Sender, zoneHelpText())
|
||
}
|
||
}
|
||
|
||
func zoneHelpText() string {
|
||
var b strings.Builder
|
||
b.WriteString("**!zone** — dungeon zone runs.\n\n")
|
||
b.WriteString("`!zone` or `!zone list` — show zones available at your level\n")
|
||
b.WriteString("`!zone enter <id|#>` — start a new run\n")
|
||
b.WriteString("`!zone status` — show your current run\n")
|
||
b.WriteString("`!zone map` — show the room layout\n")
|
||
b.WriteString("`!zone advance` — resolve the current room and move on\n")
|
||
b.WriteString("`!zone go <n>` — at a fork, take path #n\n")
|
||
b.WriteString("`!revisit <n>` — walk back to a room you've already cleared\n")
|
||
b.WriteString("`!zone abandon` — end the active run (no rewards)\n")
|
||
b.WriteString("`!zone taunt` — poke TwinBee (they'll remember)\n")
|
||
b.WriteString("`!zone compliment` — flatter TwinBee (they'll like that)\n")
|
||
b.WriteString("`!zone lore` — I share zone history")
|
||
return b.String()
|
||
}
|
||
|
||
// splitFirstWord returns (firstWord, rest) with rest trimmed.
|
||
func splitFirstWord(s string) (string, string) {
|
||
s = strings.TrimSpace(s)
|
||
if s == "" {
|
||
return "", ""
|
||
}
|
||
i := strings.IndexAny(s, " \t")
|
||
if i < 0 {
|
||
return s, ""
|
||
}
|
||
return s[:i], strings.TrimSpace(s[i+1:])
|
||
}
|
||
|
||
// ── list ────────────────────────────────────────────────────────────────────
|
||
|
||
func (p *AdventurePlugin) zoneCmdList(ctx MessageContext, c *DnDCharacter) error {
|
||
zones := zonesForLevel(c.Level)
|
||
if len(zones) == 0 {
|
||
return p.SendDM(ctx.Sender, "No zones available at your level. (This shouldn't happen — file a bug.)")
|
||
}
|
||
var b strings.Builder
|
||
b.WriteString(fmt.Sprintf("**Zones available at L%d** (you can enter zones up to 2 tiers above your current tier):\n\n", c.Level))
|
||
for i, z := range zones {
|
||
b.WriteString(fmt.Sprintf("**%d.** %s — _T%d, L%d–%d_ `!zone enter %s`\n",
|
||
i+1, z.Display, int(z.Tier), z.LevelMin, z.LevelMax, z.ID))
|
||
b.WriteString(fmt.Sprintf(" %s\n", z.Atmosphere))
|
||
}
|
||
if active, isLeader, _ := activeZoneRunFor(ctx.Sender); active != nil {
|
||
zone := zoneOrFallback(active.ZoneID)
|
||
tail := "Use `!zone status` or `!zone abandon`."
|
||
if !isLeader {
|
||
tail = "Use `!zone status`; your leader ends it."
|
||
}
|
||
b.WriteString(fmt.Sprintf("\n_⚠ Active run: **%s**, room %d/%d. %s_",
|
||
zone.Display, active.CurrentRoom+1, active.TotalRooms, tail))
|
||
}
|
||
return p.SendDM(ctx.Sender, b.String())
|
||
}
|
||
|
||
// ── enter ───────────────────────────────────────────────────────────────────
|
||
|
||
// resolveZoneInput maps a user-typed token (id, display name, or 1-based
|
||
// list index from `!zone list`) to a ZoneID at-or-below the player's
|
||
// allowed tier ceiling. Matching is case-insensitive and forgiving on
|
||
// spaces/underscores.
|
||
func resolveZoneInput(input string, available []ZoneDefinition) (ZoneID, bool) {
|
||
in := strings.ToLower(strings.TrimSpace(input))
|
||
if in == "" {
|
||
return "", false
|
||
}
|
||
// Numeric index into the available list (1-based).
|
||
if n := atoiSafe(in); n >= 1 && n <= len(available) {
|
||
return available[n-1].ID, true
|
||
}
|
||
normIn := strings.ReplaceAll(in, " ", "_")
|
||
for _, z := range available {
|
||
if strings.EqualFold(string(z.ID), in) || strings.EqualFold(string(z.ID), normIn) {
|
||
return z.ID, true
|
||
}
|
||
if strings.EqualFold(z.Display, input) {
|
||
return z.ID, true
|
||
}
|
||
// Loose match: ignore "the " prefix on display name.
|
||
disp := strings.TrimPrefix(strings.ToLower(z.Display), "the ")
|
||
if disp == in || disp == normIn {
|
||
return z.ID, true
|
||
}
|
||
}
|
||
return "", false
|
||
}
|
||
|
||
// atoiSafe — returns -1 on parse failure.
|
||
func atoiSafe(s string) int {
|
||
n := 0
|
||
if s == "" {
|
||
return -1
|
||
}
|
||
for _, r := range s {
|
||
if r < '0' || r > '9' {
|
||
return -1
|
||
}
|
||
n = n*10 + int(r-'0')
|
||
}
|
||
return n
|
||
}
|
||
|
||
func (p *AdventurePlugin) zoneCmdEnter(ctx MessageContext, c *DnDCharacter, rest string) error {
|
||
if cs, _ := activeCombatSessionFor(ctx.Sender); cs != nil {
|
||
return p.SendDM(ctx.Sender, "⚔️ Finish your fight first — `!attack` or `!flee`.")
|
||
}
|
||
// startZoneRun only refuses a player who owns an active run. A seated party
|
||
// member owns neither run nor expedition row, so without this they could
|
||
// open a private dungeon while riding the leader's — and activeZoneRunFor
|
||
// would then hand every party read their solo run instead of the party's.
|
||
// seatedExpeditionFor, not activeExpeditionFor: the seat outlives an
|
||
// `extracting` expedition, and so must the refusal.
|
||
if seated, _ := seatedExpeditionFor(ctx.Sender); seated != nil {
|
||
return p.SendDM(ctx.Sender,
|
||
"You're already in your party's dungeon. `!expedition leave` to strike out on your own.")
|
||
}
|
||
if rest == "" {
|
||
return p.SendDM(ctx.Sender,
|
||
"`!zone enter <id|#>` — pick from `!zone list`. Example: `!zone enter goblin_warrens` or `!zone enter 1`.")
|
||
}
|
||
if remaining := restingLockoutRemaining(c); remaining > 0 {
|
||
return p.SendDM(ctx.Sender, fmt.Sprintf(
|
||
"🛌 You're still resting — %s remaining. The dungeon won't go anywhere.",
|
||
formatRespecDuration(remaining)))
|
||
}
|
||
available := zonesForLevel(c.Level)
|
||
id, ok := resolveZoneInput(rest, available)
|
||
if !ok {
|
||
return p.SendDM(ctx.Sender,
|
||
"Unknown zone for your level. Try `!zone list` to see what's available.")
|
||
}
|
||
run, err := startZoneRun(ctx.Sender, id, c.Level, nil)
|
||
if err != nil {
|
||
switch err {
|
||
case ErrRunAlreadyActive:
|
||
active, _ := getActiveZoneRun(ctx.Sender)
|
||
zone := zoneOrFallback(active.ZoneID)
|
||
return p.SendDM(ctx.Sender, fmt.Sprintf(
|
||
"You're already in **%s** (room %d/%d). Finish it or `!zone abandon` first.",
|
||
zone.Display, active.CurrentRoom+1, active.TotalRooms))
|
||
case ErrZoneTierLocked:
|
||
return p.SendDM(ctx.Sender,
|
||
"That zone is too far above your level. (Cap: 2 tiers above your current.)")
|
||
case ErrUnknownZone:
|
||
return p.SendDM(ctx.Sender, "Unknown zone.")
|
||
default:
|
||
return p.SendDM(ctx.Sender, "Couldn't start zone run: "+err.Error())
|
||
}
|
||
}
|
||
zone := zoneOrFallback(run.ZoneID)
|
||
var b strings.Builder
|
||
b.WriteString(fmt.Sprintf("🗝 **Entering %s** _(T%d, %d rooms)_\n\n", zone.Display, int(zone.Tier), run.TotalRooms))
|
||
// Wounded-entry warning: if HP < 50% MaxHP at zone-enter time, flag it
|
||
// before the player advances into combat. Wounds carry across runs,
|
||
// monster damage tuning assumes near-full HP; entering at half or less
|
||
// is a death-spiral invitation.
|
||
if c.HPMax > 0 && c.HPCurrent*2 < c.HPMax {
|
||
b.WriteString(fmt.Sprintf("⚠️ _You're entering at **%d/%d HP**. Consider `!rest` first._\n\n",
|
||
c.HPCurrent, c.HPMax))
|
||
}
|
||
b.WriteString("_" + zone.Hook + "_\n\n")
|
||
if line := twinBeeLine(zone.ID, DMRoomEntry, run.RunID, narrationCadence(run)); line != "" {
|
||
b.WriteString(line)
|
||
b.WriteString("\n\n")
|
||
}
|
||
if aside := moodAsideLine(run.DMMood, run.RunID, narrationCadence(run)); aside != "" {
|
||
b.WriteString(aside)
|
||
b.WriteString("\n\n")
|
||
}
|
||
b.WriteString(fmt.Sprintf("**Room 1/%d — %s.** Use `!zone advance` to proceed, `!zone map` for layout.",
|
||
run.TotalRooms, prettyRoomType(run.CurrentRoomType())))
|
||
return p.SendDM(ctx.Sender, b.String())
|
||
}
|
||
|
||
// ── status ──────────────────────────────────────────────────────────────────
|
||
|
||
func (p *AdventurePlugin) zoneCmdStatus(ctx MessageContext) error {
|
||
run, isLeader, err := activeZoneRunFor(ctx.Sender)
|
||
if err != nil {
|
||
return p.SendDM(ctx.Sender, "Couldn't read run state: "+err.Error())
|
||
}
|
||
if run == nil {
|
||
return p.SendDM(ctx.Sender, "No active zone run. Use `!zone list` then `!zone enter <id>`.")
|
||
}
|
||
_ = applyMoodDecayIfStale(run, isLeader)
|
||
zone := zoneOrFallback(run.ZoneID)
|
||
var b strings.Builder
|
||
b.WriteString(fmt.Sprintf("**%s** — room %d/%d (%s)\n",
|
||
zone.Display, run.CurrentRoom+1, run.TotalRooms, prettyRoomType(run.CurrentRoomType())))
|
||
b.WriteString(fmt.Sprintf("Cleared: %d Loot: %d DM mood: %d/100 (%s)\n",
|
||
len(run.RoomsCleared), len(run.LootCollected), run.DMMood, dmMoodLabel(run.DMMood)))
|
||
b.WriteString(fmt.Sprintf("Started: %s Last action: %s",
|
||
run.StartedAt.Format("2006-01-02 15:04"),
|
||
run.LastActionAt.Format("2006-01-02 15:04")))
|
||
return p.SendDM(ctx.Sender, b.String())
|
||
}
|
||
|
||
// dmMoodLabel returns a human-friendly label for the mood gauge per
|
||
// design doc §3.2 mood bands (≥80 effusive, 60–79 friendly, 40–59 neutral,
|
||
// 20–39 grumpy, <20 hostile).
|
||
func dmMoodLabel(mood int) string {
|
||
switch {
|
||
case mood >= 80:
|
||
return "effusive"
|
||
case mood >= 60:
|
||
return "friendly"
|
||
case mood >= 40:
|
||
return "neutral"
|
||
case mood >= 20:
|
||
return "grumpy"
|
||
default:
|
||
return "hostile"
|
||
}
|
||
}
|
||
|
||
// prettyRoomType formats a RoomType for display strings.
|
||
func prettyRoomType(rt RoomType) string {
|
||
switch rt {
|
||
case RoomEntry:
|
||
return "Entry"
|
||
case RoomExploration:
|
||
return "Exploration"
|
||
case RoomTrap:
|
||
return "Trap"
|
||
case RoomElite:
|
||
return "Elite"
|
||
case RoomBoss:
|
||
return "Boss"
|
||
default:
|
||
return "?"
|
||
}
|
||
}
|
||
|
||
// ── map ─────────────────────────────────────────────────────────────────────
|
||
|
||
func (p *AdventurePlugin) zoneCmdMap(ctx MessageContext) error {
|
||
run, isLeader, err := activeZoneRunFor(ctx.Sender)
|
||
if err != nil {
|
||
return p.SendDM(ctx.Sender, "Couldn't read run state: "+err.Error())
|
||
}
|
||
if run == nil {
|
||
return p.SendDM(ctx.Sender, "No active zone run. Use `!zone enter <id>`.")
|
||
}
|
||
zone := zoneOrFallback(run.ZoneID)
|
||
var b strings.Builder
|
||
b.WriteString(fmt.Sprintf("**%s — Map**\n```\n", zone.Display))
|
||
if g, ok := loadZoneGraph(run.ZoneID); ok {
|
||
b.WriteString(renderZoneGraphMap(g, run))
|
||
b.WriteString("\n```\n")
|
||
b.WriteString("_E=Entry ?=Exploration T=Trap ★=Elite ☠=Boss ⚿=Secret · ✓ cleared ▶ here · pending ╳ locked_")
|
||
if path := renderVisitedPath(g, run); path != "" {
|
||
b.WriteString("\n**Path:** " + path)
|
||
}
|
||
// A member reads the same map but can't walk it — `!revisit` is the
|
||
// leader's call, like the fork. Offering them the numbers would only
|
||
// earn a refusal.
|
||
if targets := revisitTargets(g, run); len(targets) > 0 && isLeader {
|
||
nums := make([]string, len(targets))
|
||
for i, n := range targets {
|
||
nums[i] = fmt.Sprintf("`!revisit %d`", n)
|
||
}
|
||
b.WriteString("\n**Back to:** " + strings.Join(nums, " · "))
|
||
}
|
||
return p.SendDM(ctx.Sender, b.String())
|
||
}
|
||
// No registered graph (defensive — every zone has one post-G8).
|
||
cleared := map[int]bool{}
|
||
for _, r := range run.RoomsCleared {
|
||
cleared[r] = true
|
||
}
|
||
b.WriteString(renderZoneMap(run.RoomSeq, run.CurrentRoom, cleared))
|
||
b.WriteString("\n```\n")
|
||
b.WriteString("_E=Entry ?=Exploration T=Trap ★=Elite ☠=Boss · ✓ cleared ▶ here · pending_")
|
||
return p.SendDM(ctx.Sender, b.String())
|
||
}
|
||
|
||
// renderZoneMap produces a horizontal ASCII layout: a row of room glyphs
|
||
// connected with `──`, with a status row underneath showing cleared/here/
|
||
// pending markers per room. Glyphs match the legend printed alongside the
|
||
// map. roomSeq is the run's room order; current is the 0-based index of
|
||
// the player's location; cleared maps room index → true for finished rooms.
|
||
func renderZoneMap(roomSeq []RoomType, current int, cleared map[int]bool) string {
|
||
if len(roomSeq) == 0 {
|
||
return "(no rooms)"
|
||
}
|
||
var top, bot strings.Builder
|
||
for i, rt := range roomSeq {
|
||
if i > 0 {
|
||
top.WriteString("──")
|
||
bot.WriteString(" ")
|
||
}
|
||
top.WriteString(roomGlyph(rt))
|
||
switch {
|
||
case cleared[i]:
|
||
bot.WriteString("✓")
|
||
case i == current:
|
||
bot.WriteString("▶")
|
||
default:
|
||
bot.WriteString("·")
|
||
}
|
||
}
|
||
return top.String() + "\n" + bot.String()
|
||
}
|
||
|
||
// roomGlyph returns the single-character ASCII map glyph for a RoomType.
|
||
func roomGlyph(rt RoomType) string {
|
||
switch rt {
|
||
case RoomEntry:
|
||
return "E"
|
||
case RoomExploration:
|
||
return "?"
|
||
case RoomTrap:
|
||
return "T"
|
||
case RoomElite:
|
||
return "★"
|
||
case RoomBoss:
|
||
return "☠"
|
||
default:
|
||
return "·"
|
||
}
|
||
}
|
||
|
||
// ── advance ─────────────────────────────────────────────────────────────────
|
||
|
||
// stopReason classifies why a single advanceOnce step stopped. StopOK means
|
||
// the step walked into the next room cleanly and a loop caller may keep
|
||
// going. Everything else is an interrupt — the autopilot loop in
|
||
// expeditionCmdRun renders the result and stops; the one-shot
|
||
// zoneCmdAdvance treats them all the same (single dispatch).
|
||
type stopReason int
|
||
|
||
const (
|
||
stopOK stopReason = iota // walked to next room; loop may continue
|
||
stopFork // advanceTransitionGraph returned a forkMsg
|
||
stopElite // standing at an Elite doorway; needs !fight
|
||
stopBoss // standing at a Boss doorway; needs !fight
|
||
stopEnded // patrol or room resolution killed the player
|
||
stopComplete // run cleared (boss down, no outgoing edges)
|
||
stopBlocked // an active CombatSession blocks the advance
|
||
stopHarvestCombat // auto-harvest pulled into combat that resolved short of death
|
||
stopPreflight // pre-iteration preflight tripped (low HP / low SU)
|
||
stopBossSafety // compact autopilot bailed before boss (HP/SU/exhaustion gate) — caller pitches a rest camp
|
||
)
|
||
|
||
// bossSafetyHPPct — compact-autopilot won't engage a boss while current HP
|
||
// is at or below this fraction of max. 0.80 ≫ autopilotLowHPPct (0.30) so
|
||
// the gate fires well before the player is in real danger; the boss is
|
||
// the run's climax beat and we'd rather rest first than chip-trade into it.
|
||
const bossSafetyHPPct = 0.80
|
||
|
||
// bossSafetyExhaustion — gate trips at this level or above. 3 is the 5e
|
||
// "disadvantage on attack rolls and saving throws" tier; engaging a boss
|
||
// past that is a coin-flip TPK. A standard rest decrements exhaustion by 1,
|
||
// so two rest cycles clears a stack of 3 even without a long rest.
|
||
const bossSafetyExhaustion = 3
|
||
|
||
// bossSafetyGate reports whether the compact autopilot should pause before
|
||
// engaging the boss. Returns (player-facing reason, true) when blocked.
|
||
// Plumbed through the boss/elite branch of advanceOnceWithOpts so the
|
||
// scheduler can pitch a rest camp in response (see tryAutoRun).
|
||
func bossSafetyGate(userID id.UserID, exp *Expedition) (string, bool) {
|
||
cur, max := dndHPSnapshot(userID)
|
||
if max > 0 && float64(cur) <= float64(max)*bossSafetyHPPct {
|
||
return fmt.Sprintf("HP %d/%d — below %.0f%% boss-engage threshold", cur, max, bossSafetyHPPct*100), true
|
||
}
|
||
if exp != nil && exp.Supplies.DailyBurn > 0 && exp.Supplies.Current < exp.Supplies.DailyBurn {
|
||
return fmt.Sprintf("supplies %.1f/%.1f SU — under a day's burn", exp.Supplies.Current, exp.Supplies.DailyBurn), true
|
||
}
|
||
if c, _ := LoadDnDCharacter(userID); c != nil && c.Exhaustion >= bossSafetyExhaustion {
|
||
return fmt.Sprintf("exhaustion %d — too worn to fight clean", c.Exhaustion), true
|
||
}
|
||
return "", false
|
||
}
|
||
|
||
// advanceResult bundles the staged narration + dispatch shape of one
|
||
// advanceOnce step. preStream/intro/phases/final mirror the streamOrSend
|
||
// contract — phases nil means "no per-step pacing required". reason tells
|
||
// loop callers whether they may iterate again.
|
||
type advanceResult struct {
|
||
preStream []string
|
||
intro string
|
||
phases []string
|
||
final string
|
||
reason stopReason
|
||
// nextRoomType — when reason is stopOK, the type of the room the
|
||
// player just stepped into. The autopilot loop reads this to break
|
||
// before running a redundant iteration whose only job would be to
|
||
// re-emit the Boss/Elite doorway gate (and produce a duplicate
|
||
// "Room X/Y — Boss" line in the same DM).
|
||
nextRoomType RoomType
|
||
// harvest carries the auto-harvest pass result for the room the
|
||
// player just walked into (Josie H2 — auto-harvest parity between
|
||
// `!zone advance` and `!expedition run`). Zero value when no
|
||
// harvest ran (Entry/Trap/Elite/Boss rooms, forks, stops).
|
||
harvest autoHarvestResult
|
||
harvestFooter string
|
||
// zoneCleared is true only when this step was a *full* zone clear
|
||
// (reason == stopComplete and not a mid-zone region clear). The K
|
||
// event anchor reads it so a foreground `!zone advance` clear can roll
|
||
// the grind-loop player's mid-day event — a mid-zone region clear does
|
||
// not, since the run continues and it would fire per region.
|
||
zoneCleared bool
|
||
}
|
||
|
||
// zoneCmdAdvance resolves the room the player is currently standing in,
|
||
// then moves them to the next. Thin wrapper over advanceOnce + dispatch;
|
||
// the expedition autopilot (expeditionCmdRun) reuses advanceOnce in a
|
||
// loop. Resolution branches on RoomType — combat for Exploration/Elite/
|
||
// Boss, a trap nick for Trap, narration-only for Entry. Player loss
|
||
// aborts the run with a mood penalty and player-death flavor; boss win
|
||
// drops the zone Loot table.
|
||
func (p *AdventurePlugin) zoneCmdAdvance(ctx MessageContext) error {
|
||
// The party walks on the leader's row. advanceOnce would tell a member they
|
||
// have no run at all — right outcome, wrong story. Ask membership directly
|
||
// rather than `run != nil && !isLeader`: that spelling misses the window
|
||
// where the leader has an expedition but has not taken the first step (no
|
||
// run row yet), and it would re-resolve the run advanceOnce is about to
|
||
// resolve anyway, firing the §4.3 idle reap twice per keystroke.
|
||
if isPartyMember(ctx.Sender) {
|
||
return p.SendDM(ctx.Sender,
|
||
"Your party leader sets the pace. `!map` to see where you're standing.")
|
||
}
|
||
res, err := p.advanceOnce(ctx)
|
||
if err != nil {
|
||
return p.SendDM(ctx.Sender, err.Error())
|
||
}
|
||
sendErr := p.streamOrSend(ctx.Sender, res.preStream, res.intro, res.phases, res.final)
|
||
// K fourth event anchor: a foreground single-day zone clear is a presence
|
||
// moment for the grind-loop player the other three anchors miss. Rolled
|
||
// after the clear DM so any triggered event lands behind it, and only here
|
||
// — zoneCmdAdvance is the foreground path; autopilot walks go through
|
||
// runAutopilotWalk and never reach this.
|
||
if res.zoneCleared {
|
||
p.maybeFireAnchoredEvent(ctx.Sender, advEventChanceZoneClear)
|
||
}
|
||
return sendErr
|
||
}
|
||
|
||
// advanceOnce runs the single-room advance pipeline and returns a
|
||
// structured result the caller can stream as-is or aggregate. Errors
|
||
// returned here are user-facing (already prefixed with the appropriate
|
||
// "Couldn't ..." context); callers should SendDM them verbatim. State
|
||
// mutations on run / character / combat sessions persist regardless of
|
||
// how the caller dispatches the narration.
|
||
// advanceOnce — single-room advance. compact==true switches to the
|
||
// terse autopilot-friendly combat narration and auto-resolves elite
|
||
// doorways (boss still stops; boss is the climax beat). Foreground
|
||
// `!expedition run` / `!zone advance` always pass false.
|
||
func (p *AdventurePlugin) advanceOnce(ctx MessageContext) (advanceResult, error) {
|
||
return p.advanceOnceWithOpts(ctx, false, false)
|
||
}
|
||
|
||
// inlineBossCombat (only consulted when compact==true) selects between the
|
||
// two background combat paths at a boss/elite doorway. true keeps the
|
||
// legacy inline auto-resolve (SimulateCombat — fast, but ignores enemy
|
||
// multiattack). false returns stopBoss/stopElite after the safety gate so
|
||
// a turn-based driver — autoDriveCombat / pickAutoCombatAction — handles
|
||
// the fight via the regular !fight / !attack engine. Both the headless sim
|
||
// and the production autorun (long-expedition D8-f) now pass false so the
|
||
// real engine (with multiattack) resolves the encounter and simPickSpell
|
||
// actually fires; D8-prereq re-wired this seam, D8-f flipped prod onto it.
|
||
func (p *AdventurePlugin) advanceOnceWithOpts(ctx MessageContext, compact, inlineBossCombat bool) (advanceResult, error) {
|
||
run, err := getActiveZoneRun(ctx.Sender)
|
||
if err != nil {
|
||
return advanceResult{}, fmt.Errorf("Couldn't read run state: %s", err.Error())
|
||
}
|
||
if run == nil {
|
||
return advanceResult{}, fmt.Errorf("No active zone run. Use `!zone enter <id>`.")
|
||
}
|
||
if cs, _ := getActiveCombatSession(ctx.Sender); cs != nil {
|
||
return advanceResult{
|
||
final: "⚔️ Finish your fight first — `!attack` or `!flee`.",
|
||
reason: stopBlocked,
|
||
}, nil
|
||
}
|
||
// getActiveZoneRun above resolves the sender's own row, so the walker is
|
||
// always this run's owner.
|
||
_ = applyMoodDecayIfStale(run, true)
|
||
zone := zoneOrFallback(run.ZoneID)
|
||
// A pending fork means advanceTransitionGraph already cleared the
|
||
// current room and stopped — re-running resolveRoom would re-fire
|
||
// combat and re-drop loot on the same room. Re-emit the fork prompt
|
||
// and let the caller surface it; the player commits via !zone go <n>.
|
||
// This returns *before* crediting the daily streak: spamming `!zone
|
||
// advance` at a fork resolves no room, so it must not keep the streak alive.
|
||
if pf, derr := decodePendingFork(run.NodeChoices); derr == nil && pf != nil {
|
||
return advanceResult{
|
||
final: renderForkPrompt(zone, *pf),
|
||
reason: stopFork,
|
||
}, nil
|
||
}
|
||
// compact==true is the background auto-walk path; only credit
|
||
// player-initiated advances toward the daily streak.
|
||
if !compact {
|
||
markActedToday(ctx.Sender)
|
||
}
|
||
prev := run.CurrentRoomType()
|
||
prevIdx := run.CurrentRoom
|
||
|
||
// Elite/Boss rooms are manual: !zone advance stops at the doorway and the
|
||
// player engages with !fight. Patrols don't roll while standing at the
|
||
// door — only on the advance that walked the player here, which already
|
||
// fired below on the previous room. A won CombatSession for the encounter
|
||
// means the fight's done; fall through so the graph clears the room.
|
||
//
|
||
// compact==true (background autopilot) auto-resolves elite rooms via
|
||
// the same forward-sim engine used for exploration combat. Long-
|
||
// expedition D3 extends the same path to boss rooms — gated by a
|
||
// safety check (HP/SU/exhaustion). When the gate trips the walk
|
||
// returns stopBossSafety; the autorun layer pitches a rest camp in
|
||
// response (see tryAutoRun). Foreground (!compact) still parks the
|
||
// player at the doorway for a manual !fight.
|
||
var eliteAutoIntro string
|
||
var eliteAutoPhases []string
|
||
var eliteAutoOutcome string
|
||
eliteAutoResolved := false
|
||
if prev == RoomElite || prev == RoomBoss {
|
||
encID := encounterIDForRoom(prevIdx)
|
||
sess, serr := getCombatSessionForEncounter(run.RunID, encID)
|
||
if serr != nil {
|
||
return advanceResult{}, fmt.Errorf("Couldn't read combat state: %s", serr.Error())
|
||
}
|
||
if sess == nil || sess.Status != CombatStatusWon {
|
||
if !compact {
|
||
kind := "Elite"
|
||
r := stopElite
|
||
if prev == RoomBoss {
|
||
kind = "Boss"
|
||
r = stopBoss
|
||
}
|
||
return advanceResult{
|
||
final: fmt.Sprintf("**Room %d/%d — %s.** Type `!fight` to engage.",
|
||
prevIdx+1, run.TotalRooms, kind),
|
||
reason: r,
|
||
}, nil
|
||
}
|
||
if prev == RoomBoss {
|
||
// Cheap extra read — only fires on the boss doorway tick.
|
||
exp, _ := getActiveExpedition(ctx.Sender)
|
||
if reason, blocked := bossSafetyGate(ctx.Sender, exp); blocked {
|
||
return advanceResult{
|
||
final: fmt.Sprintf(
|
||
"⏸ **Autopilot held back from the boss** — %s. Pitching a rest camp; will re-engage after recovery.",
|
||
reason),
|
||
reason: stopBossSafety,
|
||
}, nil
|
||
}
|
||
}
|
||
if !inlineBossCombat {
|
||
// Background caller wants to drive the fight itself via the
|
||
// turn engine (autoDriveCombat / pickAutoCombatAction).
|
||
// Surface the doorway like the foreground path does, after
|
||
// the safety gate has had a chance to defer the engagement.
|
||
kind := "Elite"
|
||
r := stopElite
|
||
if prev == RoomBoss {
|
||
kind = "Boss"
|
||
r = stopBoss
|
||
}
|
||
return advanceResult{
|
||
final: fmt.Sprintf("**Room %d/%d — %s.** Type `!fight` to engage.",
|
||
prevIdx+1, run.TotalRooms, kind),
|
||
reason: r,
|
||
}, nil
|
||
}
|
||
// Compact-mode elite/boss auto-resolve. resolveCombatRoom
|
||
// selects monster + label by run.CurrentRoomType().
|
||
ai, ap, ao, aended, aerr := p.resolveCombatRoom(ctx.Sender, run, zone, prev == RoomElite, true)
|
||
if aerr != nil {
|
||
return advanceResult{}, fmt.Errorf("Couldn't auto-resolve %s: %s", strings.ToLower(string(prev)), aerr.Error())
|
||
}
|
||
if aended {
|
||
return advanceResult{
|
||
intro: ai,
|
||
phases: ap,
|
||
final: ao,
|
||
reason: stopEnded,
|
||
}, nil
|
||
}
|
||
eliteAutoIntro = ai
|
||
eliteAutoPhases = ap
|
||
eliteAutoOutcome = ao
|
||
eliteAutoResolved = true
|
||
}
|
||
}
|
||
|
||
// §4.1 Patrol Encounter: at Threat-Clock Alert+, patrols may move
|
||
// through cleared rooms. Roll on `!advance` *before* the next room's
|
||
// own resolution. Player KO ends the run.
|
||
//
|
||
// Patrol-then-room is chained into a single 2–3s-paced stream so the
|
||
// player reads patrol → patrol play-by-play → patrol resolution →
|
||
// room intro → room play-by-play → final, in one continuous beat.
|
||
patrolIntro, patrolPhases, patrolOutcome, patrolEnded, perr := p.tryPatrolEncounter(ctx.Sender, run, zone)
|
||
if perr != nil {
|
||
return advanceResult{}, fmt.Errorf("Couldn't resolve patrol: %s", perr.Error())
|
||
}
|
||
var preStream []string
|
||
if patrolPhases != nil {
|
||
if patrolIntro != "" {
|
||
preStream = append(preStream, patrolIntro)
|
||
}
|
||
preStream = append(preStream, patrolPhases...)
|
||
}
|
||
if patrolEnded {
|
||
// Patrol dropped the player; run is over.
|
||
return advanceResult{
|
||
preStream: preStream,
|
||
final: patrolOutcome,
|
||
reason: stopEnded,
|
||
}, nil
|
||
}
|
||
// Patrol survived (or didn't fire). If it fired, patrolOutcome becomes
|
||
// a streamed midpoint between the patrol fight and the room resolver.
|
||
if patrolPhases != nil && patrolOutcome != "" {
|
||
preStream = append(preStream, patrolOutcome)
|
||
}
|
||
|
||
// Resolve the current room *before* clearing it, so combat results
|
||
// can decide whether the player advances or the run ends. Combat
|
||
// rooms return a non-nil phases slice — those get streamed with
|
||
// 2–3s delays for suspense; non-combat rooms collapse into a single
|
||
// SendDM as before.
|
||
intro, phases, outcome, ended, err := p.resolveRoom(ctx.Sender, run, zone, compact)
|
||
if eliteAutoResolved {
|
||
// Fold the auto-resolved elite combat in. resolveRoom returned
|
||
// empty for the elite room type (turn-based system never ran),
|
||
// so we just use the forward-sim narration we captured above.
|
||
intro = eliteAutoIntro
|
||
phases = eliteAutoPhases
|
||
outcome = eliteAutoOutcome
|
||
}
|
||
if err != nil {
|
||
return advanceResult{}, fmt.Errorf("Couldn't resolve room: %s", err.Error())
|
||
}
|
||
if ended {
|
||
// Death (combat or otherwise). Stream phases if present, then the
|
||
// death narration as the final message.
|
||
return advanceResult{
|
||
preStream: preStream,
|
||
intro: intro,
|
||
phases: phases,
|
||
final: outcome,
|
||
reason: stopEnded,
|
||
}, nil
|
||
}
|
||
|
||
// Graph-mode advance (G9a — only mode now): clear the current room,
|
||
// then either auto-advance down a single edge, surface a fork prompt
|
||
// for 2+ edges, or complete the run when there are 0 outgoing edges.
|
||
c, cerr := LoadDnDCharacter(ctx.Sender)
|
||
if cerr != nil {
|
||
return advanceResult{}, fmt.Errorf("Couldn't load character: %s", cerr.Error())
|
||
}
|
||
next, forkMsg, complete, gerr := p.advanceTransitionGraph(run, zone, c)
|
||
if gerr != nil {
|
||
return advanceResult{}, fmt.Errorf("Couldn't advance: %s", gerr.Error())
|
||
}
|
||
var campStruck string
|
||
if kind := autoBreakCampOnMove(ctx.Sender); kind != "" {
|
||
campStruck = fmt.Sprintf("⛺ Camp struck (**%s**) — the party moved on.\n\n", kind)
|
||
}
|
||
if complete {
|
||
_, _ = applyMoodEvent(run.RunID, MoodEventZoneComplete)
|
||
var b strings.Builder
|
||
if outcome != "" {
|
||
b.WriteString(outcome)
|
||
b.WriteString("\n\n")
|
||
}
|
||
if campStruck != "" {
|
||
b.WriteString(campStruck)
|
||
}
|
||
// A "complete" run is only a full zone clear when it isn't a mid-zone
|
||
// region clear of a multi-region zone. For the latter, name the region
|
||
// and point at the next one — "Cleared {zone}. Run complete." reads
|
||
// wrong right before the auto-advance transit block (and is shared with
|
||
// manual `!region travel`, which advances next).
|
||
region, next, midZone := midZoneRegionClear(ctx.Sender, run.RunID)
|
||
if midZone {
|
||
b.WriteString(fmt.Sprintf("🏁 **Cleared %s.** The way to %s opens ahead.\n\n", region.Name, next.Name))
|
||
} else {
|
||
b.WriteString(fmt.Sprintf("🏆 **Cleared %s.** Run complete.\n\n", zone.Display))
|
||
}
|
||
if line := twinBeeLine(zone.ID, DMZoneComplete, run.RunID, prevIdx); line != "" {
|
||
b.WriteString(line)
|
||
b.WriteString("\n\n")
|
||
}
|
||
if granted := p.rollZoneLoot(ctx.Sender, run, zone); len(granted) > 0 {
|
||
b.WriteString("**Loot:**\n")
|
||
for _, id := range granted {
|
||
b.WriteString("• " + id + "\n")
|
||
}
|
||
}
|
||
// Success-path expedition close-out: flip the wrapping expedition to
|
||
// 'complete' (when this clear finishes the whole zone) and surface any
|
||
// completion milestones. No-op for standalone runs / mid-zone region
|
||
// clears.
|
||
if lines := p.finalizeExpeditionOnZoneClear(ctx.Sender, run.RunID); len(lines) > 0 {
|
||
b.WriteString("\n")
|
||
for _, line := range lines {
|
||
b.WriteString(line)
|
||
}
|
||
}
|
||
return advanceResult{
|
||
preStream: preStream,
|
||
intro: intro,
|
||
phases: phases,
|
||
final: b.String(),
|
||
reason: stopComplete,
|
||
zoneCleared: !midZone,
|
||
}, nil
|
||
}
|
||
if forkMsg != "" {
|
||
var b strings.Builder
|
||
if outcome != "" {
|
||
b.WriteString(outcome)
|
||
b.WriteString("\n\n")
|
||
}
|
||
b.WriteString(fmt.Sprintf("✓ Cleared room %d (%s).\n\n", prevIdx+1, prettyRoomType(prev)))
|
||
if campStruck != "" {
|
||
b.WriteString(campStruck)
|
||
}
|
||
b.WriteString(forkMsg)
|
||
return advanceResult{
|
||
preStream: preStream,
|
||
intro: intro,
|
||
phases: phases,
|
||
final: b.String(),
|
||
reason: stopFork,
|
||
}, nil
|
||
}
|
||
finalMsg := p.formatNextRoomMessage(run, zone, prev, prevIdx, outcome, next)
|
||
if campStruck != "" {
|
||
finalMsg = campStruck + finalMsg
|
||
}
|
||
|
||
// H2 — auto-harvest the room the player just walked into. Only fires
|
||
// for Exploration rooms (Entry/Trap/Elite/Boss self-skip via
|
||
// currentRoomCleared / autoHarvestRoom's no-op when there's nothing
|
||
// to harvest). Uses standalone storage when there's no active
|
||
// expedition, expedition region_state when there is.
|
||
hr, hfooter := p.runHarvestForAdvance(ctx.Sender, run.RunID, c, next)
|
||
if hfooter != "" {
|
||
finalMsg += "\n\n" + hfooter
|
||
}
|
||
if hr.CombatNarr != "" {
|
||
// Harvest interrupt fired combat. Append the narration to the
|
||
// final block; reclassify reason for the autopilot loop so it
|
||
// can break with the right footer/tally treatment.
|
||
finalMsg += "\n\n" + hr.CombatNarr
|
||
}
|
||
res := advanceResult{
|
||
preStream: preStream,
|
||
intro: intro,
|
||
phases: phases,
|
||
final: finalMsg,
|
||
reason: stopOK,
|
||
nextRoomType: next,
|
||
harvest: hr,
|
||
harvestFooter: hfooter,
|
||
}
|
||
if hr.CombatNarr != "" {
|
||
res.reason = stopHarvestCombat
|
||
if hr.PlayerEnded {
|
||
res.reason = stopEnded
|
||
}
|
||
}
|
||
return res, nil
|
||
}
|
||
|
||
// runHarvestForAdvance runs an auto-harvest pass on the room the player
|
||
// just walked into and returns the result plus a rendered per-room
|
||
// footer. Reloads the run so the harvest sees the post-graph-advance
|
||
// current node; binds to the active expedition when one exists, falls
|
||
// through to standalone (per-run) storage otherwise. nextRoomType is a
|
||
// fast-path filter so we don't even touch the DB for Entry/Trap/Elite/
|
||
// Boss rooms — autoHarvestRoom would no-op on them anyway.
|
||
func (p *AdventurePlugin) runHarvestForAdvance(
|
||
userID id.UserID, runID string, c *DnDCharacter, nextRoomType RoomType,
|
||
) (autoHarvestResult, string) {
|
||
if nextRoomType != RoomExploration {
|
||
return autoHarvestResult{}, ""
|
||
}
|
||
fresh, ferr := getZoneRun(runID)
|
||
if ferr != nil || fresh == nil {
|
||
return autoHarvestResult{}, ""
|
||
}
|
||
exp, _ := getActiveExpedition(userID)
|
||
hr, herr := p.autoHarvestRoom(userID, fresh, c, exp)
|
||
if herr != nil {
|
||
return autoHarvestResult{}, ""
|
||
}
|
||
return hr, renderAutoHarvestFooter(hr.Summary)
|
||
}
|
||
|
||
// formatNextRoomMessage builds the "✓ Cleared room X. ... Room Y/N —
|
||
// TYPE." block used by both the legacy linear advance and graph-mode
|
||
// single-edge auto-advance. nextIdx is derived from the live run row
|
||
// — markRoomCleared / advanceZoneRunNode have already bumped it by the
|
||
// time this is called.
|
||
func (p *AdventurePlugin) formatNextRoomMessage(run *DungeonRun, zone ZoneDefinition, prev RoomType, prevIdx int, outcome string, next RoomType) string {
|
||
nextIdx := prevIdx + 1
|
||
var b strings.Builder
|
||
if outcome != "" {
|
||
b.WriteString(outcome)
|
||
b.WriteString("\n\n")
|
||
}
|
||
b.WriteString(fmt.Sprintf("✓ Cleared room %d (%s).\n\n", prevIdx+1, prettyRoomType(prev)))
|
||
if next == RoomBoss {
|
||
if line := composeBossEntry(zone.ID, run.RunID, nextIdx); line != "" {
|
||
b.WriteString(line)
|
||
b.WriteString("\n\n")
|
||
}
|
||
} else {
|
||
if line := twinBeeLine(zone.ID, DMRoomEntry, run.RunID, nextIdx); line != "" {
|
||
b.WriteString(line)
|
||
b.WriteString("\n\n")
|
||
}
|
||
}
|
||
// Reload mood — combat-event nat20/nat1 deltas have been persisted via
|
||
// scanMoodEventsFromCombat but not reflected on the in-memory run.
|
||
freshMood := run.DMMood
|
||
if fresh, _ := getZoneRun(run.RunID); fresh != nil {
|
||
freshMood = fresh.DMMood
|
||
}
|
||
if aside := moodAsideLine(freshMood, run.RunID, nextIdx); aside != "" {
|
||
b.WriteString(aside)
|
||
b.WriteString("\n\n")
|
||
}
|
||
b.WriteString(fmt.Sprintf("**Room %d/%d — %s.** ", nextIdx+1, run.TotalRooms, prettyRoomType(next)))
|
||
// Route the action hint by what's actually ahead. The next advance
|
||
// against an Elite/Boss room hits the doorway gate and demands
|
||
// `!fight` — telling the player to `!zone advance` here would
|
||
// directly contradict that gate's message.
|
||
switch next {
|
||
case RoomBoss:
|
||
b.WriteString("`!fight` when you're ready for the boss.")
|
||
case RoomElite:
|
||
b.WriteString("`!fight` when ready.")
|
||
default:
|
||
b.WriteString(continueHint(id.UserID(run.UserID)))
|
||
}
|
||
return b.String()
|
||
}
|
||
|
||
// streamOrSend dispatches a staged room resolution. When the room produced
|
||
// combat phases (or there was a paced patrol pre-stream), the messages get
|
||
// streamed with 2–3s delays. Otherwise everything collapses into a single
|
||
// SendDM. preStream is non-empty when a patrol fight ran ahead of the
|
||
// current room and its play-by-play needs to lead the dispatch.
|
||
func (p *AdventurePlugin) streamOrSend(userID id.UserID, preStream []string, intro string, phases []string, final string) error {
|
||
if phases == nil && len(preStream) == 0 {
|
||
var b strings.Builder
|
||
if intro != "" {
|
||
b.WriteString(intro)
|
||
b.WriteString("\n\n")
|
||
}
|
||
b.WriteString(final)
|
||
return p.SendDM(userID, b.String())
|
||
}
|
||
msgs := append([]string{}, preStream...)
|
||
if intro != "" {
|
||
msgs = append(msgs, intro)
|
||
}
|
||
if phases != nil {
|
||
msgs = append(msgs, phases...)
|
||
}
|
||
return p.streamFlow(userID, msgs, final)
|
||
}
|
||
|
||
// streamFlow ships a list of phase messages followed by a final message,
|
||
// with the zone-combat 2–3s delay pacing. Single entry point for both the
|
||
// patrol-and-die path and the patrol-leading-into-room path.
|
||
func (p *AdventurePlugin) streamFlow(userID id.UserID, phaseMessages []string, finalMessage string) error {
|
||
if len(phaseMessages) == 0 {
|
||
return p.SendDM(userID, finalMessage)
|
||
}
|
||
// Fire-and-forget: streamFlow's whole job is to hand off to the
|
||
// streamer and return — no post-flush chaining. Explicit discard
|
||
// honors the sendZoneCombatMessages contract.
|
||
_ = p.sendZoneCombatMessages(userID, phaseMessages, finalMessage)
|
||
return nil
|
||
}
|
||
|
||
// streamFlowThen behaves like streamFlow but runs after() once the final
|
||
// message has actually been delivered. Emergence follow-ups (e.g. the pet
|
||
// arrival DM) must land strictly *after* the paced run narration — rolling
|
||
// them before streamFlow returns races the streamer's goroutine and surfaces
|
||
// "there's an animal in your house" ahead of the "Run complete" beat the
|
||
// player is still waiting on. after may be nil.
|
||
func (p *AdventurePlugin) streamFlowThen(userID id.UserID, phaseMessages []string, finalMessage string, after func()) error {
|
||
if len(phaseMessages) == 0 {
|
||
err := p.SendDM(userID, finalMessage)
|
||
if after != nil {
|
||
after()
|
||
}
|
||
return err
|
||
}
|
||
done := p.sendZoneCombatMessages(userID, phaseMessages, finalMessage)
|
||
if after != nil {
|
||
go func() {
|
||
<-done
|
||
after()
|
||
}()
|
||
}
|
||
return nil
|
||
}
|
||
|
||
// resolveRoom dispatches to the per-room-type resolver. Returns staged
|
||
// messages (intro, phases, outcome) so combat rooms can be paced with
|
||
// inter-phase delays — see resolveCombatRoom for the contract. For
|
||
// non-combat rooms (entry, trap), phases is nil and outcome carries the
|
||
// resolution narration.
|
||
// currentSecretNode returns the run's current graph node when it is a secret
|
||
// room, so resolveRoom can divert it to the treasure-cache resolver. Returns
|
||
// false for a non-secret node, an unknown zone, or a legacy row that never got
|
||
// a CurrentNode written (those pre-date branching graphs and have no secrets).
|
||
func currentSecretNode(run *DungeonRun) (ZoneNode, bool) {
|
||
if run.CurrentNode == "" {
|
||
return ZoneNode{}, false
|
||
}
|
||
g, ok := loadZoneGraph(run.ZoneID)
|
||
if !ok {
|
||
return ZoneNode{}, false
|
||
}
|
||
n, ok := g.Nodes[run.CurrentNode]
|
||
if !ok || n.Kind != NodeKindSecret {
|
||
return ZoneNode{}, false
|
||
}
|
||
return n, true
|
||
}
|
||
|
||
func (p *AdventurePlugin) resolveRoom(userID id.UserID, run *DungeonRun, zone ZoneDefinition, compact bool) (intro string, phases []string, outcome string, ended bool, err error) {
|
||
// Revisit R2 — a cleared room stays cleared. Advancing out of a room the
|
||
// player backtracked into must not re-roll its combat or re-arm its trap.
|
||
//
|
||
// The revisit plan assumed terminal CombatSession rows already gated this.
|
||
// They only gate Elite/Boss (checked at the doorway in advanceOnceWithOpts);
|
||
// an Exploration room re-enters resolveCombatRoom unconditionally, and a
|
||
// Trap room re-arms. Without this, `!revisit` would be a loot exploit:
|
||
// walk back one room, advance, farm the same enemy forever.
|
||
//
|
||
// A no-op under forward-only navigation — advance clears the current room
|
||
// only after resolving it, so the room being resolved is never already in
|
||
// RoomsCleared.
|
||
if run.RoomIsCleared(run.CurrentRoom) {
|
||
return
|
||
}
|
||
// N5/D4 — a secret room is a no-combat treasure cache, not the exploration
|
||
// fight its RoomType collapses to. Keyed off the graph node (which still
|
||
// carries NodeKindSecret) rather than CurrentRoomType (which does not), so
|
||
// it must be checked before the RoomType switch below.
|
||
if node, ok := currentSecretNode(run); ok {
|
||
outcome = p.resolveSecretRoom(userID, run, zone, node)
|
||
return
|
||
}
|
||
switch run.CurrentRoomType() {
|
||
case RoomEntry:
|
||
return
|
||
case RoomTrap:
|
||
_, narration := p.resolveTrapRoom(userID, run, zone)
|
||
outcome = narration
|
||
return
|
||
case RoomExploration:
|
||
return p.resolveCombatRoom(userID, run, zone, false, compact)
|
||
case RoomElite, RoomBoss:
|
||
// Manual turn-based combat (!fight / !attack). zoneCmdAdvance only
|
||
// reaches resolveRoom for an Elite/Boss room once a won CombatSession
|
||
// exists for it — so there's nothing to resolve here. Return empty
|
||
// and let the caller advance the graph past the now-cleared room.
|
||
return
|
||
}
|
||
return
|
||
}
|
||
|
||
// resolveCombatRoom spawns one roster enemy (elite filter optional),
|
||
// runs combat, persists side effects, fires nat-1/nat-20 mood deltas,
|
||
// and renders the staged narration. Returns:
|
||
//
|
||
// intro — pre-combat block (TwinBee combat-start + monster stat block)
|
||
// phases — RenderCombatLog output, streamed with delays by the caller
|
||
// outcome — post-combat block: nat20/nat1 flavor, kill line, loot, d20 summary
|
||
// ended — true when the player went down (caller skips next-room teaser)
|
||
//
|
||
// Phases will be nil only on a "no roster" skip — caller treats that as a
|
||
// non-paced fallthrough.
|
||
func (p *AdventurePlugin) resolveCombatRoom(userID id.UserID, run *DungeonRun, zone ZoneDefinition, elite, compact bool) (intro string, phases []string, outcome string, ended bool, err error) {
|
||
// Long-expedition D3 — compact autopilot now auto-resolves boss rooms
|
||
// too. The room-type drives monster selection (boss room → zone.Boss
|
||
// bestiary entry; exploration/elite → roster pick). Foreground boss
|
||
// combat is still the manual !fight path; resolveRoom() doesn't
|
||
// dispatch for RoomBoss outside compact.
|
||
isBoss := run.CurrentRoomType() == RoomBoss
|
||
var monster DnDMonsterTemplate
|
||
var ok bool
|
||
if isBoss {
|
||
monster, ok = dndBestiary[zone.Boss.BestiaryID]
|
||
} else {
|
||
monster, ok = pickZoneEnemy(zone, run.RunID, run.CurrentRoom, elite)
|
||
}
|
||
if !ok {
|
||
kind := "exploration"
|
||
switch {
|
||
case isBoss:
|
||
kind = "boss"
|
||
case elite:
|
||
kind = "elite"
|
||
}
|
||
outcome = fmt.Sprintf("_(No %s roster entry — skipping.)_", kind)
|
||
return
|
||
}
|
||
preHP, _ := dndHPSnapshot(userID)
|
||
// P6e: the whole party fights the room, not just whoever owns the run.
|
||
// Seats[0] is the leader — their view drives this narration, which is the
|
||
// leader's stream. The mood scan reads the whole fight's log.
|
||
pres, seated, rerr := p.runZoneCombatRoster(
|
||
fightRoster(userID), monster, int(zone.Tier), nil, run.DMMood)
|
||
if rerr != nil {
|
||
err = rerr
|
||
return
|
||
}
|
||
result := pres.Seats[0]
|
||
postHP, maxHP := dndHPSnapshot(userID)
|
||
nat20s, nat1s := scanMoodEventsFromEvents(run.RunID, pres.Events)
|
||
|
||
// Compact mode: skip TwinBee banter, skip the multi-beat play-by-play.
|
||
// Render a single outcome line. Still records kills, threat, and drops.
|
||
if compact && result.PlayerWon {
|
||
hpDelta := preHP - postHP
|
||
var ob strings.Builder
|
||
label := monster.Name
|
||
switch {
|
||
case isBoss:
|
||
label = "👑 Boss — " + monster.Name
|
||
case elite:
|
||
label = "Elite " + monster.Name
|
||
}
|
||
ob.WriteString(fmt.Sprintf("⚔️ **%s** down — HP %d→%d", label, preHP, postHP))
|
||
if hpDelta > 0 {
|
||
ob.WriteString(fmt.Sprintf(" (−%d)", hpDelta))
|
||
}
|
||
ob.WriteString(".")
|
||
// Run-scoped once, for the owner: the kill record and the threat one kill
|
||
// costs. Character-scoped effects fan out per seat.
|
||
recordZoneKillForUser(userID, monster.ID)
|
||
applyRoomCombatThreatForUser(userID, elite || isBoss)
|
||
drop, downed := p.closeOutZoneWin(pres, seated, zone, monster, isBoss, elite, "zone")
|
||
if drop != "" {
|
||
ob.WriteString(" ")
|
||
ob.WriteString(drop)
|
||
}
|
||
if line := partyCasualtyLine(downed); line != "" {
|
||
ob.WriteString("\n")
|
||
ob.WriteString(line)
|
||
}
|
||
// D1b campaign capstone. The compact autopilot resolves boss rooms
|
||
// itself (the primary long-expedition path), so the epilogue has to
|
||
// fire here too — otherwise almost every player clears the boss
|
||
// without ever seeing it.
|
||
if isBoss {
|
||
writeBossEpilogue(&ob, zone.ID)
|
||
}
|
||
outcome = ob.String()
|
||
return
|
||
}
|
||
|
||
// Intro: pre-combat narration + creature stat block. This lands first,
|
||
// before the 5–8s phase pacing kicks in.
|
||
var ib strings.Builder
|
||
if elite {
|
||
if line := eliteRoomEntryLine(zone.ID, run.RunID, narrationCadence(run)); line != "" {
|
||
ib.WriteString(line)
|
||
ib.WriteString("\n")
|
||
}
|
||
}
|
||
if line := twinBeeLine(zone.ID, DMCombatStart, run.RunID, narrationCadence(run)); line != "" {
|
||
ib.WriteString(line)
|
||
ib.WriteString("\n")
|
||
}
|
||
if elite {
|
||
ib.WriteString(fmt.Sprintf("⚔️ **Elite encounter — %s** (HP %d, AC %d)", monster.Name, monster.HP, monster.AC))
|
||
} else {
|
||
ib.WriteString(fmt.Sprintf("⚔️ **%s** (HP %d, AC %d)", monster.Name, monster.HP, monster.AC))
|
||
}
|
||
if curios := activeMagicItemsLine(userID); curios != "" {
|
||
ib.WriteString("\n")
|
||
ib.WriteString(curios)
|
||
}
|
||
intro = ib.String()
|
||
|
||
// Phases: forward-simulating engine play-by-play. Use the player's
|
||
// display name when available so narrative lines read naturally.
|
||
// In compact mode we already returned early on a win; the remaining
|
||
// compact loss path still wants no multi-beat phases (the player
|
||
// needs the outcome, not 10 lines of attrition).
|
||
if !compact {
|
||
playerName := "You"
|
||
if name, _ := loadDisplayName(userID); name != "" {
|
||
playerName = name
|
||
}
|
||
phases = RenderCombatLog(result, playerName, monster.Name)
|
||
}
|
||
|
||
// Outcome: post-combat block. Nat20/nat1 narration goes here so it
|
||
// lands *after* the play-by-play, where it has dramatic context.
|
||
var ob strings.Builder
|
||
if nat20s > 0 {
|
||
if line := twinBeeLine(zone.ID, DMNat20, run.RunID, narrationCadence(run)); line != "" {
|
||
ob.WriteString(line)
|
||
ob.WriteString("\n")
|
||
}
|
||
} else if nat1s > 0 {
|
||
if line := twinBeeLine(zone.ID, DMNat1, run.RunID, narrationCadence(run)); line != "" {
|
||
ob.WriteString(line)
|
||
ob.WriteString("\n")
|
||
}
|
||
}
|
||
if !result.PlayerWon {
|
||
// resolveCombatRoom gates room progression — a retreat here has
|
||
// nowhere to go (the elite/room is still blocking the way), so
|
||
// any loss ends the run. The retreat-continues semantic only
|
||
// fits the non-gating expedition paths (runHarvestInterrupt,
|
||
// tryPatrolEncounter); see retreatThreatBump in
|
||
// dnd_expedition_combat.go.
|
||
_, _ = applyMoodEvent(run.RunID, MoodEventPlayerDeath)
|
||
_ = abandonZoneRun(userID)
|
||
// Timeout loss = retreat; the fighters took wounds but nobody actually
|
||
// died. Don't fire markAdventureDead — that would trigger the 6h respawn
|
||
// timer for what is mechanically "ran out the clock". Death is read per
|
||
// seat off HP, which for a solo walker is the same `!TimedOut` rule.
|
||
closeOutZoneLoss(pres, seated, zone, "zone")
|
||
if !result.TimedOut {
|
||
forceExtractExpeditionForRunLoss(userID, "combat death")
|
||
} else {
|
||
forceExtractExpeditionForRunLoss(userID, "combat retreat")
|
||
}
|
||
if line := twinBeeLine(zone.ID, DMPlayerDeath, run.RunID, narrationCadence(run)); line != "" {
|
||
ob.WriteString(line)
|
||
ob.WriteString("\n")
|
||
}
|
||
if result.TimedOut {
|
||
ob.WriteString(fmt.Sprintf("⏳ The fight drags on. **%s** outlasts you. You retreat, wounded but alive.", monster.Name))
|
||
} else {
|
||
ob.WriteString(fmt.Sprintf("💀 You fell to **%s**. Run ended.", monster.Name))
|
||
}
|
||
if rollLine := dndRollSummaryLine(result); rollLine != "" {
|
||
ob.WriteString("\n")
|
||
ob.WriteString(rollLine)
|
||
}
|
||
outcome = ob.String()
|
||
ended = true
|
||
return
|
||
}
|
||
if line := twinBeeLine(zone.ID, DMCombatEnd, run.RunID, narrationCadence(run)); line != "" {
|
||
ob.WriteString(line)
|
||
ob.WriteString("\n")
|
||
}
|
||
ob.WriteString(fmt.Sprintf("✅ **%s** down. You finished at **%d/%d HP**.", monster.Name, postHP, maxHP))
|
||
if rollLine := dndRollSummaryLine(result); rollLine != "" {
|
||
ob.WriteString("\n")
|
||
ob.WriteString(rollLine)
|
||
}
|
||
recordZoneKillForUser(userID, monster.ID)
|
||
applyRoomCombatThreatForUser(userID, elite)
|
||
drop, downed := p.closeOutZoneWin(pres, seated, zone, monster, false, elite, "zone")
|
||
if drop != "" {
|
||
ob.WriteString("\n")
|
||
ob.WriteString(drop)
|
||
}
|
||
if line := partyCasualtyLine(downed); line != "" {
|
||
ob.WriteString("\n")
|
||
ob.WriteString(line)
|
||
}
|
||
outcome = ob.String()
|
||
return
|
||
}
|
||
|
||
// BossOutcomeInputs is the carrier struct for renderBossOutcome — the
|
||
// shared staged-narration body used by zone bosses (resolveBossRoom)
|
||
// and arena bosses (resolveArenaBoss, post-L2). Pure inputs: every
|
||
// field is read-only and the helper performs no DB writes.
|
||
type BossOutcomeInputs struct {
|
||
ZoneID ZoneID // routes twinBeeLine (use ZoneArena for arena fights)
|
||
RunID string // deterministic seed for twinBeeLine pickers
|
||
RoomIdx int // ditto
|
||
|
||
Monster DnDMonsterTemplate
|
||
Result CombatResult
|
||
PreHP, PostHP, MaxHP int
|
||
PhaseTwoAt float64 // fraction of MaxHP; 0 disables phase-two narration
|
||
Nat20s, Nat1s int // pre-counted by scanMoodEventsFromCombat
|
||
|
||
// Caller-supplied headlines so arena and zone read in their own voice.
|
||
// DefeatHeadline is the full sentence shown after the PlayerDeath
|
||
// TwinBee line; VictoryHeadline is the full sentence shown after
|
||
// BossDeath. The roll-summary line is appended automatically.
|
||
DefeatHeadline string
|
||
VictoryHeadline string
|
||
}
|
||
|
||
// renderBossOutcome composes the outcome block for a boss-shaped
|
||
// encounter: optional Nat20/Nat1 mood line, optional phase-two barb if
|
||
// the enemy crossed PhaseTwoAt mid-fight, BossDeath/PlayerDeath flavor,
|
||
// the caller-supplied victory/defeat headline, and a trailing dice-roll
|
||
// summary. Side-effect free — callers handle abandonZoneRun, loot,
|
||
// kill records, payout, etc.
|
||
func renderBossOutcome(in BossOutcomeInputs) string {
|
||
var ob strings.Builder
|
||
if in.Nat20s > 0 {
|
||
if line := twinBeeLine(in.ZoneID, DMNat20, in.RunID, in.RoomIdx); line != "" {
|
||
ob.WriteString(line)
|
||
ob.WriteString("\n")
|
||
}
|
||
} else if in.Nat1s > 0 {
|
||
if line := twinBeeLine(in.ZoneID, DMNat1, in.RunID, in.RoomIdx); line != "" {
|
||
ob.WriteString(line)
|
||
ob.WriteString("\n")
|
||
}
|
||
}
|
||
if phaseTwoCrossedInEvents(in.Result.Events, in.Result.EnemyStartHP, in.PhaseTwoAt) {
|
||
if line := bossPhaseTwoLine(in.ZoneID, in.RunID, in.RoomIdx); line != "" {
|
||
ob.WriteString(line)
|
||
ob.WriteString("\n")
|
||
}
|
||
}
|
||
if !in.Result.PlayerWon {
|
||
if line := twinBeeLine(in.ZoneID, DMPlayerDeath, in.RunID, in.RoomIdx); line != "" {
|
||
ob.WriteString(line)
|
||
ob.WriteString("\n")
|
||
}
|
||
ob.WriteString(in.DefeatHeadline)
|
||
if rollLine := dndRollSummaryLine(in.Result); rollLine != "" {
|
||
ob.WriteString("\n")
|
||
ob.WriteString(rollLine)
|
||
}
|
||
return ob.String()
|
||
}
|
||
if line := twinBeeLine(in.ZoneID, DMBossDeath, in.RunID, in.RoomIdx); line != "" {
|
||
ob.WriteString(line)
|
||
ob.WriteString("\n")
|
||
}
|
||
ob.WriteString(in.VictoryHeadline)
|
||
if rollLine := dndRollSummaryLine(in.Result); rollLine != "" {
|
||
ob.WriteString("\n")
|
||
ob.WriteString(rollLine)
|
||
}
|
||
return ob.String()
|
||
}
|
||
|
||
// ── taunt / compliment ──────────────────────────────────────────────────────
|
||
|
||
func (p *AdventurePlugin) zoneCmdTaunt(ctx MessageContext) error {
|
||
return p.zoneMoodInteraction(ctx, MoodEventTaunt, tauntResponseLine, "💢")
|
||
}
|
||
|
||
func (p *AdventurePlugin) zoneCmdCompliment(ctx MessageContext) error {
|
||
return p.zoneMoodInteraction(ctx, MoodEventCompliment, complimentResponseLine, "💐")
|
||
}
|
||
|
||
// zoneMoodInteraction is the shared wiring for !zone taunt / !zone compliment:
|
||
// require an active run, apply the mood event, render a deterministic line
|
||
// from the prewritten pool, and report the new mood band.
|
||
func (p *AdventurePlugin) zoneMoodInteraction(
|
||
ctx MessageContext,
|
||
ev DMMoodEvent,
|
||
render func(runID string, roomIdx int) string,
|
||
icon string,
|
||
) error {
|
||
// Mood is a property of the run, not of the player who typed at TwinBee — so
|
||
// a member's taunt or compliment moves the party's gauge. That is only safe
|
||
// because applyMoodEvent lands an atomic `gm_mood + delta`; the decay write
|
||
// it sits next to is absolute, and applyMoodDecayIfStale refuses it for a
|
||
// non-owner for exactly that reason.
|
||
run, isLeader, err := activeZoneRunFor(ctx.Sender)
|
||
if err != nil {
|
||
return p.SendDM(ctx.Sender, "Couldn't read run state: "+err.Error())
|
||
}
|
||
if run == nil {
|
||
return p.SendDM(ctx.Sender, "No active zone run. Use `!zone enter <id>`.")
|
||
}
|
||
_ = applyMoodDecayIfStale(run, isLeader)
|
||
newMood, err := applyMoodEvent(run.RunID, ev)
|
||
if err != nil {
|
||
return p.SendDM(ctx.Sender, "Couldn't apply mood event: "+err.Error())
|
||
}
|
||
var b strings.Builder
|
||
if line := render(run.RunID, narrationCadence(run)); line != "" {
|
||
b.WriteString(line)
|
||
b.WriteString("\n\n")
|
||
}
|
||
delta := MoodEventDelta(ev)
|
||
sign := "+"
|
||
if delta < 0 {
|
||
sign = "−"
|
||
delta = -delta
|
||
}
|
||
b.WriteString(fmt.Sprintf("%s DM mood: %d/100 (%s) _(%s%d)_",
|
||
icon, newMood, dmMoodLabel(newMood), sign, delta))
|
||
return p.SendDM(ctx.Sender, b.String())
|
||
}
|
||
|
||
// ── lore ────────────────────────────────────────────────────────────────────
|
||
|
||
// zoneCmdLore renders a deterministic TwinBee lore line for the active
|
||
// run's current room. Pulls from the zone-specific LoreLines* pool when
|
||
// one exists (Tier 1–5 ship dedicated lore), falls back to the generic
|
||
// LoreLines pool otherwise. roomIdx is folded into the selector so
|
||
// repeated `!zone lore` in the same room returns the same prose, but
|
||
// cross-room calls vary.
|
||
func (p *AdventurePlugin) zoneCmdLore(ctx MessageContext) error {
|
||
run, _, err := activeZoneRunFor(ctx.Sender)
|
||
if err != nil {
|
||
return p.SendDM(ctx.Sender, "Couldn't read run state: "+err.Error())
|
||
}
|
||
if run == nil {
|
||
return p.SendDM(ctx.Sender, "No active zone run. Use `!zone enter <id>`.")
|
||
}
|
||
zone := zoneOrFallback(run.ZoneID)
|
||
line := twinBeeLine(zone.ID, DMLore, run.RunID, narrationCadence(run))
|
||
if line == "" {
|
||
return p.SendDM(ctx.Sender, "I have nothing to say about this place.")
|
||
}
|
||
return p.SendDM(ctx.Sender, fmt.Sprintf("📖 **%s — Lore**\n\n%s", zone.Display, line))
|
||
}
|
||
|
||
// ── abandon ─────────────────────────────────────────────────────────────────
|
||
|
||
func (p *AdventurePlugin) zoneCmdAbandon(ctx MessageContext) error {
|
||
if isPartyMember(ctx.Sender) {
|
||
return p.SendDM(ctx.Sender,
|
||
"Only your party leader can call off the run. `!expedition leave` to walk out alone.")
|
||
}
|
||
run, _ := getActiveZoneRun(ctx.Sender)
|
||
if err := abandonZoneRun(ctx.Sender); err != nil {
|
||
if err == ErrNoActiveRun {
|
||
return p.SendDM(ctx.Sender, "No active run to abandon.")
|
||
}
|
||
return p.SendDM(ctx.Sender, "Couldn't abandon run: "+err.Error())
|
||
}
|
||
if run == nil {
|
||
return p.SendDM(ctx.Sender, "Run abandoned.")
|
||
}
|
||
zone := zoneOrFallback(run.ZoneID)
|
||
return p.SendDM(ctx.Sender, fmt.Sprintf(
|
||
"🚪 Abandoned **%s** at room %d/%d. No rewards.",
|
||
zone.Display, run.CurrentRoom+1, run.TotalRooms))
|
||
}
|