Chronicle [ Intro Video ] — Available now on One Click Chronicle is a comprehensive calendar management tool that runs directly as a mod in Roll20. If you're running a campaign with actual in-game time, whether it's a single year or a thousand-year history, this script gives you a professional calendar interface, automatic event tracking, weather generation, and moon phase calculations all in one place. Create your own custom calendars from scratch, or load one of five pre-built options (Gregorian, Pathfinder's Golarion, Forgotten Realms, Greyhawk, or Eberron). Track what happened when, organize your world's history with tags, and switch between calendar and timeline views to explore your story from every angle. Why you might want to use Chronicle You're running a long campaign with significant in-game time You want players to feel time passing meaningfully You want to track downtime You like tracking cause-and-effect across sessions You love world building and want to organize what happened when You need a quick way to answer "wait, when did that happen?" Features at a Glance Calendar Mode View your world on a traditional calendar grid. Navigate forward and backward through time, add events and notes, generate weather, and see moon phases all on a single interface. The featured date system lets you always know what "today" is in your world, and everything—holidays, weather, moons—updates automatically as you move through time. Timeline Mode Read your world's history as a chronological story. Filter by tags, event type, date range, or show only untagged items. Jump between timeline and calendar views instantly. See at a glance how much time has passed between important moments using elapsed time displays. Design Mode Edit a pre-existing calendar or build a calendar system from scratch with custom month names, variable day counts, and defined week structures. The script handles all the math—day-of-week calculations, date navigation, year progression—automatically. Or load a preset calendar and start tracking immediately. Event & Note Organization Create events (broad historical happenings) or notes (specific dates and times). Tag everything for fast searching. The timeline remembers every detail, and you can add new tags on the fly or search existing ones. Holiday System Define recurring holidays or special days that appear every year on your calendar. Announce them to the party, whisper descriptions to players, or keep them as GM notes. Weather Generation Set up climate zones and temperature ranges once, then generate realistic weather for any date. Weather sticks to the dates you create it for—check back months later and the conditions are still there. Moon Phases Add multiple moons to your world, each with its own orbital period and color. The script calculates the correct phase for any date automatically. Display them on the calendar grid or just track them in the background. Display Modes Chronicle ships with Light Mode, Dark Mode and Fantasy Mode. Send to Chat: Sharing Calendar Information The "Send to Chat" button lets you broadcast calendar information to all players without leaving the interface. It automatically formats and displays the current date's information in a clean, readable message, showing the day, weather, moon phase, events and notes, and the week for reference. Send to chat does not display any item tagged with "gm". Getting Started First-Time Setup: Run the initialization command ( !chr ) and you'll get a main interface handout. From there, you can either load a preset calendar (one click and go!) or create a custom one from scratch, basically by pushing buttons and answering questions. All items are editable. Presets Available: Gregorian — Standard Earth calendar. Note: Holidays with complex calculations (Ex: Easter, most Jewish and Muslim holidays) are not included. Absalom Reckoning — Pathfinder's Golarion calendar Faerun — Forgotten Realms (Harptos calendar) Greyhawk — Common Year with festival weeks Eberron — Galifar Calendar with 12 moons Core Features in Detail Basic Calendar Structure Every calendar needs: Calendar Name : What you call your calendar system ("Mystara," "Exandrian," etc.). Calendar Description : Optional context about your calendar. Built-in calendars come with descriptions you can read or replace. Months : Define the month names and how many days each has. Your months don't have to be the same length. Weeks : Set up how many days are in a week and give them names (Monday through Sunday, or whatever your world uses). Climate Zones : If you want weather, define your climate regions (temperate, desert, arctic, etc.) with temperature ranges. This is used to make weather generation more believable. Days in Year : The script calculates this automatically based on your months, but you can override it. Events and Notes Events : The big things that happened in your world's history. Wars, plagues, the founding of kingdoms. Events appear at the beginning of the year they're in—no specific date needed. Notes : Specific moments tied to exact dates. The party fought goblins on the 3rd of Deepwinter. They discovered a hidden artifact on the 15th of Springtide. Notes are where session details live. Tags : Labels for organizing everything. Tag a note "Waterdeep," and you can filter to see everything that happened in that city. Tag it "party," "drow," "main-quest," or whatever makes sense for your campaign. Tags can be created on-the-fly or selected from existing ones. GM Identifier : Every event and note shows who added it. If multiple GMs are running the campaign, this helps track who recorded what. This can help organize a West Marches-style campaign, for example. Holidays and Special Days Set up holidays once, and they appear on your calendar every single year. Define the name, which month and day it falls on, and an optional description. From Calendar Mode, click any holiday to whisper its description to yourself or announce it to the party. Weather System Setup : Answer a few basic questions about your campaign area's geography to define the climate zone with minimum and maximum temperatures, and appropriate precipitation. That's it. Generation : Click "Generate Weather" on any date and the script creates realistic conditions—temperature, conditions (clear, rainy, snowy, etc.), and wind. The weather sticks to that date. Check back a week later and it's still there. Display : In Calendar Mode, weather appears in the Featured Date section. In Timeline Mode, you can filter weather visibility in and out depending on whether you want to focus on story or conditions. Notes : Weather is completely optional. If you don't generate any, the system doesn't show it. Moons and Lunar Cycles Moon Properties: Name : What you call it (Selûne, Luna, the Red Moon, etc.) Orbital Period : How many days it takes to complete a full cycle Full Moon Reference : A date when you know it was full (used to calculate phases for all other dates) Size : Display multiplier (0.1 to 1.0, where 1.0 is full size) Color : Choose from 12 options (yellow, red, green, blue, cyan, orange, purple, tan, brown, white, gray, dark). Useful for campaign worlds with multiple moons. Visibility : Toggle whether it shows on the calendar grid How It Works: The script calculates moon phases automatically based on your reference date. Add three moons with different periods, and they'll all show their correct phase for any date you look at. When multiple moons are visible, hover over them to see names. Single-moon calendars have no tooltip to reduce clutter. Timeline Mode See all your events and notes in chronological order (oldest-first or newest-first). Zoom in to see day-by-day detail, or zoom out to see yearly summaries. Filtering: Filtering allows you to see just specific types of events in your timeline: broad historical events, actions of a single PC group, biography of a single character. By type (events only, notes only, holidays only, weather only) By tag (click any tag to filter) By [Untagged] to find items without tags By date range (last month, specific year, all history) More Controls: Tag Mode : Choose "Any" to show items with any of the selected tags, or "All" to show only items with every selected tag. Useful for complex queries. Elapsed Time : Next to each entry, see how much time has passed since the featured date. Click the elapsed time button to mark that as the reference date without leaving Timeline Mode. Editing : Toggle "Details" to see edit buttons, delete options, and tag management right in the timeline. Quick way to organize on the fly. Calendar Navigation Date Navigation: Jump year-by-year, month-by-month, or day-by-day Click any date on the calendar to jump directly there Click dates in Timeline Mode to switch to Calendar Mode at that date Use the dropdowns to skip to specific months or years Featured Date: The date currently displayed (think of it as "today" in your world). This is where new events and notes are added. Everything on the calendar is shown relative to this date. Design Mode: Building Your Calendar If you're using a preset calendar, you're done. If you're building custom: Months Table : Add each month with name and day count. Weeks Configuration : Name your days of the week. Climate Setup : Optional. Define regions and temperature ranges for weather generation. Holidays : Add recurring annual holidays. Moons : Add celestial bodies with their periods and colors. Leap Years (Optional) : Enable leap years, set cycle length, and define exceptions. Seasons (Optional) : Mark the days of the year when seasons change (solstices, equinoxes). The interface shows a table for every configurable element. Use the Edit and Delete buttons to manage entries. Setup is super simple. Tips for Getting the Most Out of Chronicle Be consistent with tags. Don't invent them as you go. Decide early on whether you're tagging by location, character, story arc, or something else. Consistency makes searching powerful. Add notes regularly. After each session, spend two minutes adding what happened. You'll thank yourself when you need to reference something three months of real time later. Use both views. Calendar Mode is great for prepping sessions and seeing "what's today?" Timeline Mode is perfect for planning future sessions and understanding your world's narrative arc. Switch modes by need. Use Design Mode when you're building. Use Calendar Mode when you're running the game. Use Timeline Mode when you're planning or exploring history. Don't overthink weather. If you don't want it, don't set it up. Chronicle works fine without it. What You'll Find in Your Game When you install Chronicle: Chronicle — The main interface handout (this is what you interact with) Chronicle Calendar: [Name] — Your calendar data (pre-archived for protection against corruption) Chronicle Events: [Name] — Your events, notes, and weather (pre-archived for protection against corruption) The main interface handout stays visible. The calendar and events handouts are archived to keep your Journal clean. Command Reference (Basics) !chr — Open the main interface All other actions are handled through the interface buttons. Commands are rarely needed, but you can discover them by pressing a button, going into the chat, and pressing the up arrow to discover what was sent. This script was released early for playtesting, for free, on my Patreon .
