# SpoonardsJournal
**SpoonardsJournal** is a character-focused World of Warcraft journal for **The Burning Crusade Classic Anniversary**.
It quietly records what your character actually does while you play, then turns those recorded events into a persistent Chronicle covering adventures, places, NPCs, companions, bosses, discoveries, milestones and memorable moments.
The goal is simple:
**Your character should build a history worth looking back on.**
SpoonardsJournal does not invent adventures or fabricate events. The Chronicle is built from things the addon has actually observed during play.
---
## Character Chronicle
Every character receives their own persistent Chronicle.
The addon can remember:
* Adventures and play sessions
* First-time zones
* First-time NPC encounters
* Quest activity
* Boss encounters
* Boss victories and failed attempts
* Deaths
* Rare and notable loot
* Trades
* Selected conversations
* NPC dialogue
* NPC gossip
* Group members
* Frequently visited places
* Regular companions
* Recurring enemies
* Personal notes
* Important moments
* Milestones
* Character habits
Character history remains separate for each WoW character and persists between sessions.
---
## Journal Stories
Recorded adventures are turned into readable first-person journal entries.
Story options include:
* Mixed
* Plain
* Dry
* Practical
* Reflective
Story length can be set to:
* Short
* Standard
* Full
You can also adjust:
* Wording variety
* Humour level
* Combat detail
* Death commentary
* NPC dialogue use
* Session reflections
* Strict recorded-history mode
The narrative system is designed to add personality without inventing things your character did not actually experience.
---
## Spoken Character Banter
SpoonardsJournal can give your character occasional live reactions while you play.
The addon now contains more than **1,000 built-in spoken and discovery lines** across a wide range of situations.
Reactions can occur for:
* First-time discoveries
* Friendly NPCs
* Hostile NPCs
* Dangerous enemies
* Low health
* Critical health
* Low mana
* Falling
* Death
* Resurrection
* Finishing combat
* Boss victories
* Failed boss attempts
* Boss special abilities
* Druid transformations
* Random situational observations
Spoken personality is separate from the written Chronicle voice.
Available personalities:
* Mixed
* Grounded
* Dry
* Cheeky
* Dramatic
Frequency can be set to:
* Rare
* Normal
* Chatty
---
## Character-Aware Dialogue
Banter can take your character into account.
The addon automatically detects:
* Class
* Race
* Gender
* Faction
All Burning Crusade playable classes and races are supported.
Identity flavour can be set to:
* Subtle
* Normal
* Strong
Class, race, gender and faction references can each be switched on or off independently.
This allows a Dwarf Warrior, Blood Elf Mage or Tauren Shaman to occasionally sound more like the character being played without replacing the general personality system.
---
## Random Situational Comments
The character can occasionally comment on what is happening around them even when a normal banter trigger has not fired.
Situational comments can respond to things such as:
* Current zone
* Current sub-zone
* Resting in an inn or city
* Travelling alone
* Travelling with a group
* Being inside an instance
* Looking at a friendly NPC
* Looking at a hostile target
* Recovering while low on health
* Recovering while low on mana
These checks only use information the addon can actually observe.
Random comments use long intervals and adjustable trigger chances to avoid constant chatter.
---
## Public /say Behaviour
Inside dungeons and raids, character banter can use `/say` automatically.
Outdoors, Blizzard requires a real player input before an addon can send public chat.
SpoonardsJournal handles this with a small temporary **click-to-say strip** near the chat area.
The strip:
* Requires only one click
* Shows the prepared line on hover
* Automatically expires
* Can be dismissed immediately
* Hides when combat begins
* Can return after combat if the comment is still relevant
Outdoor behaviour can be set to:
* Ask before `/say`
* Local only
* Off
Instance behaviour can be set to:
* Automatic `/say`
* Local only
* Off
---
## Health and Mana Controls
Players can choose exactly when resource-related banter triggers.
Customise:
* Low-health percentage
* Critical-health percentage
* Low-mana percentage
* Falling delay
These can be changed through the Banter settings window or slash commands.
---
## Boss Special Alerts
SpoonardsJournal includes optional boss ability warnings.
Boss Alerts can detect visible boss:
* Casts
* Channels
* Raid-boss emotes
* Selected boss yells
* Manually watched abilities
Alerts can include:
* Centre-screen warning
* Ability icon
* Ability name
* Warning sound
* Local chat message
* Optional automatic instance `/say`
Automatic boss-warning speech can use either:
* Plain mechanic alerts
* Your selected character personality
Observed boss abilities are also remembered in Boss History.
---
## NPC Journal
First-time NPC encounters can be recorded into a dedicated NPC Journal.
NPC records can include:
* NPC name
* NPC ID
* First seen
* Last seen
* Zone
* Sub-zone
* Level
* Classification
* Creature type
* Creature family
* Friendly or hostile status
* Danger status
* Personal notes
Discoveries are remembered permanently for that character.
Combat discoveries are collected quietly and can be shown together in a single post-combat recap rather than interrupting the fight.
---
## People
The Chronicle can remember players you regularly encounter.
People records can include:
* First encounter
* Last encounter
* Adventures together
* Groups together
* Dungeon or raid activity
* Trades
* Conversations
* Relationship familiarity
Relationship levels can develop over time from Stranger through to long-term companions.
---
## Places
SpoonardsJournal keeps a history of places your character visits.
Place records can include:
* First visit
* Last visit
* Number of adventures
* Kills
* Deaths
* Quests
* Boss encounters
* Discoveries
* Memorable moments
Frequently visited places gradually develop familiarity levels.
---
## Nemesis Tracking
Recurring dangerous enemies can become part of your character's history.
The Nemesis system uses recent recorded combat information to help identify enemies connected to repeated deaths or dangerous encounters.
It does not permanently store a full combat log.
---
## Boss History
Bosses receive their own long-term records.
Boss History can remember:
* First encounter
* Last encounter
* Attempts
* Victories
* Failed attempts
* Observed special abilities
* Recent encounter history
---
## Chronicle Browser
The full Chronicle includes dedicated sections for:
* Home
* Search
* Timeline
* People
* Places
* Bosses
* Nemesis
* Chapters
* Weekly Chronicles
* Pinned Memories
* Milestones
* Habits
* Diagnostics
* Backups
---
## Search
Global Chronicle search can search across recorded:
* Adventures
* Archived stories
* Quests
* NPCs
* People
* Places
* Bosses
* Items
* Dialogue
* Milestones
* Personal notes
---
## Memories
Important moments can be edited, pinned and given personal notes.
You can also manually record a moment with:
`/sj remember <note>`
This gives you a way to preserve things that matter to you even when they cannot be detected automatically.
---
## Recaps
SpoonardsJournal can provide:
### Previously...
A short summary of what your character had been doing before the current session.
### Adventure Complete
A summary when an adventure ends.
### Weekly Chronicle
A longer-term summary of recent activity.
---
## Chapters and Milestones
Long-term character history can be organised into Chronicle chapters.
The addon can also recognise milestones such as:
* Level progression
* First recorded boss victory
* First notable item
* Kill totals
* Quest totals
* Other long-term achievements
---
## Archive and Backups
Older raw sessions can be archived while preserving important summaries and Chronicle information.
Internal SavedVariables backups are also available through the addon.
No external scripts or programs are required.
---
## Privacy
Chat recording is configurable.
Recommended defaults:
* Nearby `/say` — On
* Party — On
* Raid — On
* Guild — Off
* Whispers — Off
Guild chat and whispers remain opt-in.
All Chronicle data is stored locally in World of Warcraft SavedVariables.
---
## Interface and Accessibility
The Journal interface includes:
* Resizable main window
* Saved window size
* Saved window position
* Independent UI scaling
* Independent text scaling
* Improved text reflow
* Minimap button
* High-contrast parchment-style reading area
* Clear selected tabs
* Adventure Archive sidebar
* Larger text options
Text size can be increased without making the entire interface excessively large.
---
## First-Time Setup
A guided introduction appears when SpoonardsJournal is first installed or after significant configuration updates.
The setup covers:
* Story style
* Story detail
* Exploration behaviour
* Spoken personality
* Banter frequency
* Character-aware dialogue
* Random situational comments
* Boss Alerts
* Privacy
* Text size
* Window scale
The introduction can be reopened at any time with:
`/sj setup`
---
## Useful Commands
`/sj`
Open the Journal.
`/sj chronicle`
Open the full Chronicle.
`/sj npcs`
Open the NPC Journal.
`/sj banter settings`
Open Advanced Banter settings.
`/sj banter identity`
Open character-aware dialogue settings.
`/sj bossalerts`
Open Boss Alert settings.
`/sj storysettings`
Open narrative settings.
`/sj previously`
Show the previous-adventure recap.
`/sj remember <note>`
Record an important personal moment.
`/sj search <text>`
Search the Chronicle.
`/sj diagnostics`
Run Chronicle diagnostics.
`/sj backup`
Create an internal SavedVariables backup.
`/sj exportbook`
Prepare the Chronicle HTML export.
`/sj help`
Show the full command list.
---
## Current Version
**SpoonardsJournal v0.7.4**
Designed for:
**World of Warcraft: The Burning Crusade Classic Anniversary**
SpoonardsJournal is built for players who want their character to feel like they have an actual history — not just a list of completed quests and defeated bosses.

