lonelog.nvim implements the Lonelog notation standard (v1.4.1), a structured markdown format for solo RPG session logs. All features are pure Lua with zero external dependencies.

## Session 5

### S1 *The abandoned mine*
@ Enter the darkness
? Is anyone here?
d: 2d6+3[4, 2] = 10  => The tunnel is empty, but torchlight flickers ahead.
[E:Torch 3/6]

### S2 *Collapsed passage*
d: 1d20>=15[17] = 17 >= 15 -> Success
[F:Goblin|HP 6|alert]

Press <leader>lR on any d: line to roll and replace the result in-place.

Dice engine — Standard notation (2d6+3), advantage (2d20kh1), exploding (4d6!), success counting (6d6>>4), Fate dice (4df), comparison operators (>=, <=, vs), and multi-roll on one line.

Oracle system — Fate (7 weighted outcomes), Binary (50/50), and Mythic (2d10 + chaos factor) oracles with persistent chaos factor and interactive adjustment.

Tag navigation — Browse tags by type (NPCs, locations, PCs, threads, foes, inventory, rooms) with search filtering in the native browser. Jump to any tag's line instantly.

Scene navigation — Navigate main scenes, flashbacks, sub-scenes, and thread scenes. Auto-numbering for scene markers.

Progress elements — Insert and increment clocks ([E:Name 0/5]), tracks ([Track:Name 0/5]), and timers ([Timer:Name 0]) with smart auto-increment.

Session management — Auto-numbered session headers, campaign YAML frontmatter with auto-updating dates, and a session summary with scene/tag/dice breakdown and oracle result distribution.

Inline rolling — Roll dice, resolve table lookups, and process generator blocks directly on the current line with a single keypress.

Tag autocomplete — Automatic name completion when editing tags, with relevance-based sorting.

Add-on system — Optional modules for combat blocks with round markers, dungeon status with room state editor and ASCII maps, and resource tracking with supply dice and slot-based inventory.

Telescope integration — Auto-detected; falls back to a built-in vertical split browser with search filtering when Telescope is not available.

Zero dependencies — Pure Lua, requires only Neovim 0.8+.

Press <leader> followed by these keys:

The summary includes:

• Scenes list with context
• Tags grouped by type (NPCs, locations, threads, etc.)
• Notation counts (actions, questions, dice, notes, dialogues)
• Progress elements (clocks, tracks, timers)
• Dice breakdown by notation type (counts, sums, averages per notation)
• Oracle result distribution

See :help lonelog-keymaps for the complete keymap reference (45+ keymaps).

{
  "Django0033/lonelog.nvim",
  cmd = { "Lonelog", "LonelogOracle", "LonelogDice", "LonelogTags",
          "LonelogScenes", "LonelogRollLine" },
  config = function()
    require("lonelog").setup()
  end,
}

use {
  "Django0033/lonelog.nvim",
  config = function()
    require("lonelog").setup()
  end,
}

-- init.lua
vim.pack.add({ 'https://github.com/Django0033/lonelog.nvim' })
require("lonelog").setup()

git clone https://github.com/Django0033/lonelog.nvim.git \
  ~/.local/share/nvim/site/pack/plugins/start/lonelog.nvim

require("lonelog").setup()

require("lonelog").setup({
  use_telescope = "auto",         -- "auto" | true | false
  sidebar = { width = 50 },
  float = { border = "rounded", height = 0.4, width = 0.6 },
  oracle = { default_table = "fate", persist_chaos = true, custom_tables = {} },
  dice = { max_dice = 100, max_sides = 1000 },
  prompt_for_scene_context = true,
  keymaps = { /* see :help lonelog-keymaps */ },
  highlight = {
    lonelogAction = { fg = "#ff6600", bold = true },
  },
  campaign = {
    default_ruleset = "",
    default_genre = "",
    default_player = "",
  },
  addons = {
    combat = false,
    dungeon = false,
    resources = false,
  },
})

oracle = {
  custom_tables = {
    Weather = { "Sunny", "Cloudy", "Rain" },        -- equal weight
    NPC_Reaction = { Hostile = 1, Neutral = 2, Friendly = 1 },  -- weighted
  },
}

keymaps = {
  oracle = false,             -- disable entirely
  scene_marker = "<leader>z", -- rebind
}

Bundled but disabled by default. Enable the ones you need:

require("lonelog").setup({
  addons = {
    combat  = true,   -- [COMBAT] blocks, round markers, auto-roster
    dungeon = true,   -- dungeon status, room nav, room state editor
    resources = true, -- inventory, wealth, supply dice, resources block
  },
})

See :help lonelog-commands for the full list (30+ commands).

:help lonelog

Covers all keymaps, notation format, oracle probabilities, tag autocomplete, syntax highlighting, add-on configuration, and session workflow tips.

• Neovim 0.8+ — requires vim.ui.input, vim.ui.select, nvim_open_win
• (Optional) telescope.nvim for enhanced picker
• Zero external dependencies — pure Lua