Skip to content

GalacticCampaigns/ChronicleForge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ChronicleForge is an automated archival and deployment engine designed to preserve the legacies of Play-by-Discord TTRPG campaigns. While standard chat exports often strip away the context and beauty of a story, ChronicleForge acts as a digital "Refinery"—ingesting raw data and forging it into a high-fidelity, metadata-rich archive presented through a professional web gallery.

Built for GMs and Server Admins who value narrative integrity, ChronicleForge ensures that your players' investment is never lost to the "infinite scroll" or Discord’s data volatility.

⚔️ Core Features

  • High-Fidelity Preservation: Reconstructs complex metadata—including threaded branches, rich embeds, and reaction tallies—into a standardized 1:1 Discord API-compliant schema.
  • Narrative Consolidation: Automatically merges parent channels and fragmented threads into a single, seamless chronological narrative.
  • Intelligent Discovery (The Scout): Proactively monitors your server categories for new chapters and story arcs, adding them to your archive without manual intervention.
  • The Asset Vault: Efficiently caches user avatars and custom emojis for global reuse while implementing surgical filename truncation for long-term filesystem stability.
  • Forensic Safety Logic: Automated safety labeling using a 90% narrative-density threshold for NSFW content, featuring persistent manual overrides.
  • Hybrid Deployment: Optimized for zero-install setup via GitHub Codespaces or permanent local hosting on a Raspberry Pi.

🚀 Getting Started

Ready to begin your preservation journey? ChronicleForge supports both Mono-Repo (Engine + Gallery in one) and Split-Repo (Distributed) architectures.

Follow our step-by-step guide to configure your Discord Bot, establish your refinery-config.json, and run your first sync:

👉 View the Setup & Configuration Guide

📖 Why ChronicleForge?

In the world of online roleplay, the story is everything. ChronicleForge treats your logs not just as data, but as a masterpiece. By automating the technical heavy lifting of extraction, transformation, and web deployment, it allows you to focus on the story while we focus on the archive.


Forge your legacy. Preserve your story. Welcome to ChronicleForge.

About

Transform your Discord roleplay into a professional web-based chronicle. An automated, high-fidelity archival pipeline for TTRPG campaigns.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors