Skip to content

RenPy

Note

It is just ExtendedBBCode in with[] replaced with {} in most cases.

Tag Example
h1-h4
Will display <text> using Label Settings from headers.
{h1}<text>{\h1}
{h2}<text>{\h2}
{h3}<text>{\h3}
{h4}<text>{\h4}
space
Will add vertical space bettween lines of given {size}
<text>
{space=<size>}
<text>
b
Makes <text> use the bold (or bold italics) font RichTextLabel
{b}<text>{/b}
i
Makes <text> use the italics (or bold italics) font of RichTextLabel
{i}<text>{/i}
u
Makes <text> underlined.
{u}<text>{/u}
s
Makes <text> strikethrough.
{s}<text>{/s}
code
Makes <text> use the mono font of RichTextLabel.
{code}<text>{/code}
p
Adds new paragraph with <text> . Supports configuration options, see {Paragraph options}{Paragraph options}.
{p}<text>{/p}
{p <options>}<text>{/p}
center Makes <text> horizontally centered.
Same as {p align=center}.
{center}<text>{/center}
left
Makes <text> horizontally left-aligned.
Same as {p align=left}.
{left}<text>{/left}
right 
Makes <text> horizontally right-aligned.
Same as {p align=right}.
{right}<text>{/right}
fill
Makes <text> fill the full width of {RichTextLabel}{RichTextLabel}.
Same as {p align=fill}.
{fill}<text>{/fill}
indent
Indents <text> once. The indentation width is the
same as with {ul} or {ol}, but without a bullet point.
{indent}<text>{/indent}
a
Creates a hyperlink (underlined and clickable text).
Can contain optional <text> or display <link> as is.
If link starts with  httpit will be open in system web browser,
else it will be handle by {custom_link}{custom_link} signal.
{a=<link>}text{/a}
{a}<link>{/a}
hint
Creates a tooltip hint that is displayed when hovering the text with the mouse.
Tooltip text should not be quoted (quotes will appear as-is in the tooltip otherwise).
[hint={tooltip text displayed on hover}]<text>{/hint}
img 
Inserts an image from the <path> (can be any valid Texture2D resource).
If both <width> and <height> are provided, the image will be scaled to that size.
{img=<path>}
{img=<path> size=<height>x<width>}
font 
Makes <text> use a font resource from the <path>.
Supports configuration options, see {Font options}{Font options}.
{font=<path>}<text>{/font}
{font <options>}<text>{/font}
font_size
Use custom font size for <text>.
{font_size=<size>}<text>{/font_size}
dropcap
Use a different font size and color for <text>,
while making the tag's contents span multiple lines if it's large enough.
A {drop cap} is typically one uppercase character,
but {dropcap} supports containing multiple characters.
Margins values are comma-separated and can be positive, zero or negative.
Negative top and bottom margins are particularly useful
to allow the rest of the paragraph to display below the dropcap.
[dropcap font_size=<size> color=<color> margins=<left>,<top>,<right>,<bottom>]<text>{/dropcap}
opentype_features 
Enables custom OpenType font features for <text>.
Features must be provided as a comma-separated <list>.
{opentype_features=<list>}<text>{/opentype_features}
lang
Overrides the language for <text> that is set by the BiDi > Language property in {RichTextLabel}{RichTextLabel}.
<code> must be an ISO {language code}{language code}.
This can be used to enforce the use of a specific script for a language without starting a new paragraph.
Some font files may contain script-specific substitutes, in which case they will be used.
{lang=<code>}<text>{/lang}
color
Changes the color of <text>.
Color must be provided by a common name (see {Named colors}{Named colors})
or using the HEX format (e.g. #ff00ff, see Hexadecimal color codes).
{color=<code/name>}<text>{/color}
bgcolor
Draws the color behind <text>.
This can be used to highlight text.
Accepts same values as the color tag.
{bgcolor=<code/name>}<text>{/bgcolor}
fgcolor
Draws the color in front of <text>.
This can be used to "redact" text by using an opaque foreground color.
Accepts same values as the color tag.
{fgcolor=<code/name>}<text>{/fgcolor}
outline_size
Use custom font outline size for <text>.
{outline_size=<size>}<text>{/outline_size}
outline_color
Use custom outline color for <text>.
Accepts same values as the color tag.
{outline_color=<code/name>}<text>{/outline_color}
table
Creates a table with the <number> of columns.
Use the cell tag to define table cells.
{table=<number>}<cells>{/table}
cell
Adds a cell with <text> to the table.
If <ratio> is provided, the cell will try to expand to
that value proportionally to other cells and their ratio values.
Supports configuration options, see {Cell options}{Cell options}.
{cell}<text>{/cell}
{cell=<ratio>}<text>{/cell}
{cell <options>}<text>{/cell}
ul
Adds an unordered list.
List <items> must be provided by putting one item per line of text.
The bullet point can be customized using the <bullet> parameter, see [Unordered list bullet].
{ul}<items>{/ul}
{ul bullet=<bullet>}<items>{/ul}
ol
Adds an ordered (numbered) list of the given <type> (see Ordered list types).
List <items> must be provided by putting one item per line of text.
{ol type=<type>}<items>{/ol}
wave
wave-fx

{wave amp=50 freq=2}<text>{/wave}
tornado
tornado-fx
{tornado radius=5 freq=2}<text>{/tornado}
shake
shake-fx
{shake rate=5 level=10}<text>{/shake}
rainbow
rainbow-fx
{rainbow freq=0.2 sat=10 val=20}<text>{/rainbow}
lb, rb
Adds [ and ] respectively.
Allows escaping BBCode markup.
These are self-closing tags, which means you do not need to close them
(and there is no {/lb} or {/rb} closing tag).
{lb}b{rb}text{lb}/b{rb} will display as {b}text{/b}.
Several Unicode control characters can be added using their own self-closing tags.
This can result in easier maintenance compared to pasting those
control characters directly in the text.
{lrm} (left-to-right mark),
{rlm} (right-to-left mark),
{lre} (left-to-right embedding),
{rle} (right-to-left embedding),
{lro} (left-to-right override),
{rlo} (right-to-left override),
{pdf} (pop directional formatting),
{alm}(Arabic letter mark),
{lri} (left-to-right isolate),
{rli}(right-to-left isolate),
{fsi} (first strong isolate),
{pdi} (pop directional isolate),
{zwj} (zero-width joiner),
{zwnj} (zero-width non-joiner),
{wj} (word joiner),
{shy} (soft hyphen)