1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
|
# org-d20 #
## Description ##
org-d20 is a minor mode for Emacs' [Org-mode](https://orgmode.org/)
for GMs running games whose rules centre around rolling d20s. It
should be useful for *Dungeons and Dragons* 3rd, 4th and 5th editions,
Paizo's *Pathfinder*, and
[d20 System](https://en.wikipedia.org/wiki/D20_System) games like *d20
Modern*.
The idea is that you're already keeping your campaign notes in an
Org-mode file. This minor mode does useful things for you while you
are visiting that buffer. For example,
- rolling dice, with 5e's advantage and disadvantage displayed in case
those are needed;
- tracking combat turns and rounds right next to your existing
description of the monsters and the terrain.
The minor mode's defaults suit the way that I run D&D 5e. Patches to
add `defcustoms` to make org-d20 more suitable for other games, and
other sets of house rules, are welcome.
## Screenshot ##
![screenshot](https://spwhitton.name/img/org-d20-0.3pre.png)
## Installation ##
Presently manual. I hope to make org-d20 available from a popular
online repository soon.
## Usage ##
It's useful to activate the mode automatically when you open the
Org-mode file in which you are keeping your campaign notes. You can
also specify the names of your party members, and their initiative
modifiers, if you want to use org-d20's combat tracker.
You can either end the Org-file with a footer like this:
# Local Variables:
# mode: org
# mode: org-d20
# org-d20-party: (("Zahrat" . 2) ("Ennon" . 4) ("Artemis" . 5))
# End:
or start it with a first line like this:
# -*- mode: org; mode: org-d20; org-d20-party: (("Zahrat" . 0) ("Anca" . 1)) -*-
Then close and reopen the file. Emacs will probably ask you to
confirm that the value for org-d20-party that you've supplied is safe.
The following bindings should then be available:
- <kbd>C-c , i</kbd> -- start a combat, or advance the turn/round counter
for an existing combat, depending on point
- <kbd>C-c , a</kbd> -- add new monsters to an existing combat
- <kbd>C-c , d</kbd> -- apply damage to the monster at point
- <kbd>C-c , r</kbd> -- prompt for dice expression and evaluate it
- <kbd><f10></kbd> -- evaluate the dice expression (e.g. `4d10`) at
point
- <kbd><f11></kbd> -- roll the last dice expression again
- <kbd><f12></kbd> -- roll d20, with advantage and disadvantage shown
- <kbd>S-<f12></kbd> -- roll percentile dice
## Bugs/patches ##
Please report bugs and submit patches by e-mail to
`<spwhitton@spwhitton.name>`.
## License ##
Copyright (C) 2017-2018 Sean Whitton
org-d20 is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation, either version 3 of the License, or (at your
option) any later version.
org-d20 is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
You should have received a copy of the GNU General Public License
along with org-d20. If not, see
[<http://www.gnu.org/licenses/>](http://www.gnu.org/licenses/).
|