Ren'Py Parity

Novella's feature target is parity with Ren'Py, with its own APIs and programming style. This page records where each area stands in iteration 1, read from the engine's code rather than from plans. Supported works as a Ren'Py user would expect; Partial works with the limits stated; Not yet is absent. Some differences are deliberate and are marked by design.

Area Supported Partial Not yet
Script statements Dialogue with attributes, temporary @ attributes, one-off speakers, line ids and a transition (with) played before the line appears; narration; extend; show, scene, hide with at, behind, zorder, as, onlayer and inline ATL; with; pause and pause hard; menu with a caption, conditions and set; named menus (menu name:), which can be jumped to or called like a label from anywhere in the story; jump, call with arguments, return with a value, and expression targets; label parameters; if/elif/else; while; $ assignments; play, queue, stop; voice and voice sustain; movie; input; window; nvl clear; notify; pass; define and default; image name: with an ATL block Custom statements are run commands implemented in C# or Divooka rather than new syntax; call expression takes no arguments; python: and init python: run real Python through IronPython in a game that opts into it, but $ is Novella's own expression language, by design, and what a block makes that a story variable cannot hold (objects, dictionaries, sets) is pickled into one hidden variable, as Ren'Py pickles its store, while functions and classes are defined again at start and so belong in init python:; the standard library ships beside the game init priorities; show expression; camera and show layer
Expressions Numbers, strings, booleans, none, lists and indexing; arithmetic, chained comparisons, in, and/or/not, conditional expressions; about thirty built-in functions and the game's own queries (visited, seen_label, seen_image, heard, achieved, showing); persistent. variables; [expression] interpolation; random draws replayed by rollback Functions are added from C# (RegisterFunction), from a Divooka graph (Register Expression Function), or from the script by init python: in a game that opts into Python; in a story written with the C# story builder, a condition or effect can be a C# lambda over the story's variables, and in one written as nodes a Function graph handed to a From Function node, neither of which has a script form Dictionaries, objects and classes as story values (Python may make them, and keeps them in saves, but the story's own expressions cannot hold them)
ATL Property settings; interpolation with Ren'Py's warpers and the Penner families; pause; picture lines with transitions, for frame animation; images that are timelines (image name:); repeat and repeat n; block; parallel; choice with weights; time; on show, on replace and on hide, an image whose transform handles hide staying until the handler ends; contains; function, calling a function the game registers in C#; transforms included by name with parameters; inline timelines under show and scene; the standard positions; timelines that replay exactly after a load or rollback, random choices included, because each shown image keeps a saved seed The property set covers position, anchor, alignment, offset, zoom, rotation, alpha, blur, saturation, brightness, tint and size, but not crop, polar coordinates, matrixcolor or tiling; timeline expressions read the transform's parameters but not game variables The statement event, which the parser reports as an error, and on for events other than an image's own show, replace and hide; splines and circles
Transitions dissolve, fade, flash, pixellate, move, ease; the movein, moveout, easein, easeout families; slide, slideaway, push, wipe in four directions; irisin, irisout, zoomin, zoomout, vpunch, hpunch, blinds, squares, crossfade; imagedissolve with a mask; named transitions with arguments; transitions on stage statements, on dialogue lines and on show screen and hide screen; a preference to turn transitions off call screen with a transition fades the called screen in over the transition's duration, whatever the transition's kind, because a called screen is not part of the stage MultipleTransition, ComposeTransition, AlphaDissolve and other transition classes
Images and layered images Images defined from file names; the built-in black and white, which need no definition; attribute resolution that keeps current attributes; colour images; placeholders for missing art; movie images; filters (grayscale, sepia, tint, flip, zoom, crop, blur, alpha, brightness, saturation); composite; condition switches; side images; layered images with groups, multiple, defaults and conditions Layered images lack if_any/if_all/if_not, per-layer transforms and offsets, and auto attributes Text, frame and other displayables as image definitions; dynamic displayables
Stage and layers The master, transient, screens and overlay layers, with transient cleared after each line, menu, input and click-to-continue pause; layers made with onlayer under any other name, drawn above master and below transient in name order; z-order and behind; tags with as Layer transforms and the camera
Audio channels music, sound, voice, ambience and audio, plus defined channels with a mixer, looping, a default fade-out and norestore; fades, queues, per-play volume, if_changed, aliases and playlists; music, sound and voice volumes and mute; channels restored on load and rollback; typing sounds; WAV, MP3, AAC, FLAC, Vorbis and Opus decoding Audio filters and panning
Movies Full-screen movie with noskip and keepmusic; looping movie images on the stage; movie sound through the mixer; headless playthroughs that picture a movie and click through it when it is skippable Movies with an alpha mask
Voice voice, voice sustain, automatic voicing from a file pattern by line id or character Replaying a line's voice from the history; per-character voice volume
Screens and screen language Every default screen: main menu, game menu, save, load, preferences, history, choice, input, NVL, quick menu, confirm, notify, gallery, music room, achievements, about and help; a splash label; a main menu written as a label; all drawn with named built-in styles made from the theme; a screen language written as a screen definition in a script, with ScreenBuilder in C# or with the Screens nodes: the boxes vbox, hbox, grid, frame, fixed and a clipped, scrolling viewport; if/elif/else, for and use; screen variables (default); text, images, text and picture buttons (with sensitive), bars, inputs, spaces, timers and keys; placement with at, align, pos and anchor; the actions return, jump, set, toggle, notify, play, open (save, load, preferences, history, gallery, music room, achievements, main menu), close, show, hide and run; laid out again every frame from the story's variables. Screens are shown with show screen and called with call screen, and a called screen the player closes without answering returns none Anything the language cannot say is a C# NovellaScreen class, which wins over a defined screen of the same name; built-in screens other than the main menu are restyled but cannot be replaced Drag and drop; imagemaps' hotspot cropping; transforms on screen elements
Styles Named styles with a parent (style name is parent:), a second definition adding to the first; the state prefixes idle_, hover_, selected_ and insensitive_, plus visited_ for a choice taken in an earlier playthrough and the compound selected_idle_, selected_hover_ and selected_insensitive_, looked up as Ren'Py does (at each style, the most particular prefix, then the plain property, then the parent); backgrounds that are a colour, a picture, frame(...), solid(...) or any image function (Frame and Solid spelt either way); text, box, layout and sound properties; 74 built-in styles (say_window, say_dialogue, choice_button, save_slot and the rest) that every built-in screen draws with, made from the theme, so the theme's settings play the part of Ren'Py's gui variables and a story's style of the same name refines them; style and style_prefix on screens and properties on an element itself; a character's window_style, namebox_style, who_style and what_style and part properties such as what_size 40; {style=name} spans; the same in C# and in Divooka nodes; the lint checking parents, circles, property names and values, and every style named Novella's own property set: Ren'Py properties such as outlines, xpadding or xminimum are written as Novella's (outline_width and outline_color, padding, xsize) or have no counterpart; a background is an image source (a picture, a frame, a colour, a composite or a filtered picture), not any displayable at all Frame's tile, and backgrounds that animate; changing a style while the game runs; the {=style} spelling of a span
Save, load, rollback, skip, auto Paged save slots with thumbnails, deleting a save, rotating autosaves, quick save and load, Continue; saves as readable JSON; after_load; rollback and roll forward with a limit and rollback_past_choices; skip seen text, unseen text and after choices; auto-forward; hiding the window; screenshots Live scripts cannot be saved, loaded or rolled back, and neither can a story label one runs with Call Label; a save's name is stored but the save screen does not ask for one; a Python value pickle cannot write (a generator, an open file) is not kept Blocking or fixing rollback from the script (block_rollback, fixed rollback); cloud saves
History Lines and choices as shown, translated, with a limit Voice replay; returning to a line from the history
Persistent data persistent. variables with defaults that apply once; seen lines, images, audio and labels; choices made in earlier playthroughs; achievements; preferences, kept apart from saves Data shared between games (Ren'Py's MultiPersistent)
Gallery and music room Gallery entries unlocked when their images are seen, or by a condition, with a viewer; music room tracks unlocked when heard, or by a condition
Achievements Definitions, achieve, hidden achievements, notifications, an Achievements screen, achieved() Steam and other platform backends
Translations Line translations by explicit or derived id; string tables; dropping a line in a language; a language preference; translate() and language(); the engine's interface in Simplified Chinese, Traditional Chinese and Japanese; coverage reported by the lint The Traditional Chinese and Japanese interface tables are incomplete, falling back to English Per-language fonts and styles; a tool that generates translation files
Text Ren'Py's text tags, including ruby, {w}, {p}, {nw}, {fast}, {cps}, inline images and spaces; {a=} links, clickable once the line has finished showing, that jump to a label, call one and come back to the line, or open a web address; interpolation; NVL pages; centered text; per-character fonts, sizes, colours and quotation marks {vspace}, {k} and {clear} are accepted and ignored Custom text tags
Accessibility and self-voicing Text size and window opacity preferences; a transitions toggle; a text shadow on by default Self-voicing: the preference is stored but has no switch in the preferences and no speech synthesizer behind it; an accessibility menu; font and contrast overrides
Developer tools Lint (NovellaPlayer lint, Validate, the console's lint, the Check Story and Check Game nodes); a console (Shift+O) that evaluates expressions, sets variables, lists problems and warps with jump label; reload (Shift+R); starting at a label (--label); headless playthroughs with described screenshots; frame timing with NovellaPlayer bench Reload restarts the current label from its beginning rather than the current line Warping to a file and line; the interactive director; an image location picker; a variable viewer
Stories without a script The C# story builder and the Divooka nodes can each say what the script language says, Python blocks, animated images and screens in boxes included, which Novella's tests check by building one story both ways and comparing the script each prints; labels built in code do not fall through to the next label, and the lint warns where one can run off its end The arguments the builder and the nodes pass to a label, a command or a screen are values fixed when the story is built, where a script's are expressions worked out as it plays (Add Use Screen takes expressions, so a row of a list can hand on its item); a lambda or a From Function graph has no script form, so a story that uses one does not read back from its script
Distribution and building A game runs as a C# program (built like any .NET 10 application), as a script folder with NovellaPlayer, or as a Divooka document in Divooka Compute or Explore A command that packages a game for distribution; single-click desktop publishing through the Divooka runner templates; Android, iOS and web builds
Gamepad Playing every screen from a pad, a game's own screens included: A continues and selects, B goes back or opens the game menu, Start opens the game menu, the d-pad and left stick move between buttons, the bumpers roll back and forward, X hides the window, Y toggles auto-forward and Back toggles skipping
Live2D and 3D Live2D; a 3D stage

The plans for what is missing are in RFC 170. The gaps that remain, in short: no drag and drop or imagemap hotspot cropping in screens; no styles changed at runtime; no ATL event; no Live2D, 3D stage or self-voicing; no mobile or web builds; no tool that generates translation files; and no block_rollback or fixed rollback.