mirror of
https://github.com/Threnklyn/dungeon-sheets.git
synced 2026-05-19 12:33:27 +02:00
Mark Wolfman
43 lines
1.3 KiB
ReStructuredText
43 lines
1.3 KiB
ReStructuredText
==========
|
|
GM Notes
|
|
==========
|
|
|
|
.. warning::
|
|
|
|
GM notes files are python modules that are imported when
|
|
parsed. **NEVER parse a gm notes file without inspecting it** to
|
|
verify that there are no unexpected consequences, especially a file
|
|
from someone you do not trust.
|
|
|
|
Dungeonsheets has the ability to parse a python file with entities
|
|
needed for game manager (GM) session notes.
|
|
|
|
Each file must contain a line like::
|
|
|
|
dungeonsheets_version = "0.4.2"
|
|
sheet_type = "gm"
|
|
|
|
Without the version line, the ``makesheets`` command-line utility
|
|
will ignore the file. This is necessary to avoid importing non-D&D
|
|
python files. Without the ``sheet_type`` line, the file will be
|
|
interpreted as a character sheet.
|
|
|
|
Basic Info
|
|
==========
|
|
|
|
Currently, only two attributes are supported: ``monsters`` and
|
|
``session_title``. More attributes will be added in the future, but if
|
|
there's something specific you have a need for, please consider
|
|
`contributing`_ an issue or pull-request.
|
|
|
|
.. code:: python
|
|
|
|
session_title = "Objects in Space"
|
|
monsters = ["ogre", "giant eagle"]
|
|
|
|
``monsters`` should be a list of either strings or subclasses of
|
|
:py:class:`Monster`. These entries will then by listed on the
|
|
resulting PDF with their stat block and features.
|
|
|
|
.. _contributing: https://github.com/canismarko/dungeon-sheets/blob/master/CONTRIBUTING.rst
|