Skip to content

rubyblaire/scenekeeper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SceneKeeper

SceneKeeper is a lightweight, SFW roleplay scene assistant for FFXIV.

It is designed to help roleplayers keep active scenes organized, readable, and easy to revisit. Whether you are writing in a busy venue, hosting a companion session, managing a group scene, or tracking a long-term story arc, SceneKeeper gives you a cleaner space to manage the moment.


✦ Features

Scene Workspace

SceneKeeper gives you a focused workspace for your current RP scene.

Use it to track:

  • Scene title
  • Scene tags
  • Scene notes
  • Scene partners
  • Follow-up tasks
  • Pinned dialogue
  • Captured chat
  • Saved scene history

The goal is simple: keep the important pieces of your scene visible while chat is moving quickly.


Scene Partner Tracking

Keep track of the characters involved in your active RP scene.

SceneKeeper supports:

  • Adding partners from captured chat
  • Adding your current target as a partner
  • Adding partners through the right-click context menu
  • Tracking whether partners are nearby
  • Partner notes
  • Partner relationship or context details
  • Partner tags
  • Partner-specific colors

Partner tracking is especially useful for busy venues, group RP, and multi-person scenes where several conversations may be happening at once.


Partner Colors

Assign custom colors to individual scene partners for easier visual tracking.

Partner colors can be used with:

  • Nearby partner markers
  • Soft visual highlights
  • Multi-person scenes
  • Venue scenes
  • Group RP
  • Long-running story groups

This makes it easier to tell who is who at a glance.


Nearby Partner Detection

SceneKeeper can show whether tracked scene partners are currently nearby.

This is helpful for:

  • Busy RP venues
  • Multi-room events
  • Companion sessions
  • Group scenes
  • Large social gatherings

Soft Visual Markers

Optional soft markers can help identify tracked scene partners on screen.

Marker options may include:

  • Marker visibility
  • Marker size
  • Highlight size
  • Global marker color
  • Partner-specific marker colors
  • Partner visibility state

Markers are intended to be subtle, readable, and non-intrusive.


✦ Captured Chat

SceneKeeper provides a cleaner local view of RP-relevant chat.

Captured Chat supports:

  • Selected chat type capture
  • Partner-based filtering
  • Search
  • Select visible lines
  • Pin important lines
  • Copy selected chat
  • Copy selected chat as Markdown
  • Add sender as partner
  • Clear captured chat between scenes

Chat Type Toggles

Choose which chat types SceneKeeper should include in Captured Chat.

Supported chat types may include:

  • Say
  • Emote
  • Yell
  • Shout
  • Tell
  • Party
  • Alliance
  • Free Company
  • Linkshell
  • Cross-world Linkshell

This helps keep your captured chat focused and avoids unnecessary clutter.


Partner Chat Filter

Busy RP spaces can get messy fast. SceneKeeper includes partner-based filtering so you can focus on the people actually involved in your scene.

Filter modes may include:

  • All Captured Chat
  • Scene Partners Only
  • Scene Partners + Me
  • Pinned Only

This is especially useful for:

  • Crowded RP rooms
  • Multi-scene venues
  • Companion sessions
  • Events with overlapping conversations
  • Group RP

SceneKeeper can also show how many captured lines are visible after filtering.


Captured Chat Search

Search through captured chat by:

  • Sender name
  • Message content
  • Chat type

This makes it easier to find a specific line, moment, or speaker without scrolling through everything manually.


Pinned Scene Lines

Pin important lines from captured chat so they are easy to find later.

Pinned lines are useful for:

  • Memorable dialogue
  • Emotional beats
  • Important lore reveals
  • Promises or threats
  • Scene quotes
  • Journal excerpts
  • Recap writing

Pinned lines are saved with scene history.


✦ Scene Builder

Scene Builder gives long-form RP writers a dedicated space to draft up to five RP paragraphs before posting.

Each paragraph box is hard-limited to 350 characters to help keep posts within a safer chat-friendly range.

Scene Builder includes:

  • Five paragraph boxes
  • Paragraph labels from 1/5 through 5/5
  • Character counters
  • Guided clipboard queue
  • Copy Next button
  • Copy All button
  • Clear Builder button
  • Panic Stop button

Scene Builder is especially useful for players who normally write RP posts in Notepad, Discord, or another external editor before copying them into chat.


Guided Queue

The Guided Queue helps you post multi-part RP responses safely.

Instead of automatically sending messages, SceneKeeper copies each paragraph to your clipboard one at a time. You stay in control of when each paragraph is pasted and sent.

Basic flow:

Write paragraphs.
Start Guided Queue.
Paste and send paragraph 1 in chat.
Click Copy Next.
Paste and send paragraph 2.
Repeat until finished.

The queue can be stopped at any time with Panic Stop.


Spell Check

Scene Builder includes spellcheck support for long-form RP writing.

Spellcheck tools may include:

  • Checking Scene Builder paragraphs
  • Suggested replacements
  • Ignoring words
  • Adding words to a custom dictionary
  • Custom dictionary controls

This is useful for character names, lore terms, locations, venue names, and FFXIV-specific words.


✦ Scene Notes

Use the notes area to keep track of important scene details while you write.

Examples:

  • Current scene premise
  • Important names
  • Locations
  • Character intentions
  • OOC reminders
  • Scene tone
  • Hooks to revisit later
  • Plot points to remember

Scene notes are saved with scene history.


✦ Follow-Up Tasks

Add simple follow-up tasks to a scene so important next steps are not forgotten.

Examples:

  • Update character journal
  • Send a follow-up message
  • Schedule the next scene
  • Add a new character note
  • Save screenshots
  • Write a recap
  • Follow up on a plot hook

Follow-up tasks are saved with scene history.


Manual Task Sharing

SceneKeeper includes manual task sharing for follow-up tasks.

You can copy a task share payload, send it to another player, and they can import it into their own SceneKeeper.

Manual task sharing supports:

  • Scene share codes
  • Task export
  • Task import
  • Task merge handling
  • Updated timestamps
  • Updated-by tracking

This keeps SceneKeeper local-first while still allowing players to share follow-up tasks when needed.


✦ Scene Tags

Add tags to scenes for easier organization.

Examples:

  • Romance
  • Mystery
  • Combat
  • Venue
  • Important
  • Follow-up
  • Completed
  • Ongoing
  • Character Arc

Tags are included in saved scene history and Markdown exports.


✦ Scene History

Save completed or important scenes to History so they can be revisited later.

Saved scenes may include:

  • Scene name
  • Scene notes
  • Scene tags
  • Scene partners
  • Partner notes
  • Partner relationship/context details
  • Partner tags
  • Captured chat
  • Pinned lines
  • Follow-up tasks

History can be searched, copied, loaded, or deleted.


Searchable History

Search your saved scenes by details such as:

  • Scene name
  • Partner name
  • Tags
  • Notes
  • Captured dialogue
  • Pinned lines

This makes SceneKeeper useful for long-term RP continuity and recurring character arcs.


✦ Markdown Export

SceneKeeper can copy scene information in Markdown format for easy use outside the game.

Useful for:

  • Discord recaps
  • Character journals
  • Carrd pages
  • GitHub notes
  • Personal archives
  • Story summaries
  • RP continuity tracking

You can copy:

  • Current scene as Markdown
  • Selected captured chat as Markdown
  • Saved scenes as Markdown
  • Scene summaries
  • Pinned lines

✦ Button Feedback

SceneKeeper provides visible feedback when actions are completed.

Examples:

  • Copied!
  • Scene saved.
  • Scene loaded.
  • Markdown copied.
  • Summary copied.
  • Builder cleared.
  • Queue stopped.

This helps make it clear when a button has successfully done something.


✦ Commands

/sk
/scenekeeper

/sk add <name>
/sk remove <name>
/sk clear
/sk scene <scene name>
/sk start
/sk pause
/sk resume
/sk save
/sk new
/sk settings

✦ Installation

SceneKeeper is distributed through a custom Dalamud repository.

  1. Open Dalamud settings in-game.
  2. Go to the Experimental tab.
  3. Add the custom repository URL.
  4. Save and close settings.
  5. Open the plugin installer.
  6. Search for SceneKeeper.
  7. Install and enable the plugin.

Repository URL:

https://raw.githubusercontent.com/rubyblaire/scenekeeper/main/pluginmaster.json

✦ Requirements

  • FFXIV
  • Dalamud
  • Custom plugin repositories enabled
  • Compatible with Dalamud API 15

✦ Purpose

SceneKeeper is made for organization, comfort, and continuity during roleplay.

It does not replace roleplay, automate roleplay, or control your character.

It simply gives you a cleaner space to keep track of:

  • Who is in your scene
  • What has been said
  • Which lines matter most
  • Who is nearby
  • What needs to happen next
  • Which scenes are worth saving
  • What details you want to remember
  • Which paragraphs you are preparing to post

The goal is to make RP smoother, especially when chat moves quickly, a scene has multiple participants, or a writer wants to prepare longer responses in advance.


✦ Intended Use

SceneKeeper is designed for SFW roleplay support.

It is useful for:

  • Venue roleplay
  • Companion or host sessions
  • Story-driven scenes
  • Group scenes
  • Long-form RP
  • Character meetings
  • Event nights
  • Personal scene organization
  • Continuity tracking
  • Scene recaps
  • RP journaling
  • Multi-paragraph writing

✦ Privacy

SceneKeeper is designed as a local roleplay organization tool.

  • Scene notes are stored locally.
  • Scene partner lists are stored locally.
  • Scene history is stored locally.
  • Captured chat is handled locally.
  • Scene Builder text is handled locally.
  • Task share payloads are manually copied and imported by users.
  • No analytics are included.
  • No remote logging is included.

✦ Customization

SceneKeeper includes options for adjusting how scene information is displayed and saved.

Customization may include:

  • Chat log filters
  • Partner chat filtering
  • Captured chat search
  • Marker visibility
  • Marker size
  • Highlight size
  • Global marker color
  • Partner-specific colors
  • Scene tracking behavior
  • Captured chat cleanup
  • Maximum saved scenes
  • Scene Builder behavior
  • Custom spellcheck dictionary
  • History search behavior

✦ Development

SceneKeeper is developed by Ruby Blaire.

This plugin is distributed through a custom repository and is not affiliated with or endorsed by Square Enix, Dalamud, or XIVLauncher.


✦ Disclaimer

SceneKeeper is a third-party plugin for use with Dalamud.

Use responsibly and in accordance with the rules and expectations of the communities, venues, and spaces you participate in.


✦ License

All rights reserved unless otherwise stated.

About

An FFXIV roleplay toolkit for tracking scene partners, filtering captured chat, drafting multi-part posts, saving scene history, and keeping RP continuity organized.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages