How Renpy and I met
I got into Renpy after playing Doki Doki Literature Club, a visual novel made with it. DDLC is far and away the best story I've ever seen and had such a huge impact on me than it was the first game I ever played mods for. There's a large modding community and they've come up with some really great extensions to the story. After playing a few (I got lucky and tried most of the best ones first), I was finally motivated to make one myself.
Hence came MC's Revenge, a project I picked up from another modder who abandoned it for adoption. I finished MCR and the reception was good, so not long later I took up a much larger project that I'd actually been planning while I was making MCR, Return To The Portrait.
RTTP is a lot more ambitious and has required me to deal with Renpy in a lot more depth, so I've gotten to see the ugly complexities. Currently RTTP has had part 1 released and I'm working on part 2. So that's my experience with Renpy.
Okay, this is going to be kind of an unfair review because I'm only counting my grievances. That's genuinely how I feel about Renpy - I just never encountered anything that worked better or more easily than I expected. This is probably because I've never used any other VN engine, so I don't know, maybe Renpy isn't below average. But I do know that it has a lot of weak areas, many of which don't seem like they would've been hard to implement better.
Complex character sprites aren't well supported
You can't dynamically generate pose tags; instead you have to hardcode all the ones you're going to use during init.
They've got the
as an attempt at a more sophisticated way of handling character
sprites, but it's got a slew of its own problems. It makes your tags insufferably long since each component has to
be space-delimited and have a unique prefix typed out everywhere you use it, it doesn't support composing
other layered images as far as I can tell, and it seems
to cause incorrect image composition (some layers appear with lines of pixels missing between them that worked with
im.Composite), and so despite how badly I need this feature for RTTP and how many hours I've
sunk into trying to make it work, I've ended up not using it.
A good visual novel engine would be designed with the assumption that a character will have too many possible poses to hardcode
them all, so it would support using a function that converts the posecode as a string to whatever object the VN engine takes
This inadequacy is the whole reason u/AgentGold had to write the 1800-line Create_Definitions.pl for DDLC modders. Implementing
pose codes better would have saved most if not all of that tremendous amount of work, as well as dozens of lines of
image declarations in almost every VN made with Renpy. It would free developers and their artists to create more
flexible and more expressive character sprites.
Too many DSLs... that all do the same thing
I'd expect to run into at least one DSL for a visual novel engine. Script language makes sense.
But Renpy has two DSLs besides script language and the
and ATL (animation/transformation language),
and neither of them is simple or intuitive.
In screen language, you give each button an
Action attribute, and the
Action is always syntactically
treated as a Python function call. Even the
NullAction used when you want a button to do nothing is specified with
The worse problem I have with screen language is that a lot of it seems to just be duplicating the functionality of either
Python or Renpy script. Built-in Actions include
If (it takes a condition / action if true / action if false)... any of those sound familiar? There's a screen
language version for just about every Renpy script statement I can think of, which is just capitalized and has different
syntax. (Note that you also use actual Python flow control constructs in screen definitions, and even outright embed
Python code and use variables, so I'm honestly not sure if there's ever a need for
You also can specify multiple actions by passing a Python list of actions to the
action attribute, even
though you don't wrap it in a list if there's only one. This is a shining example of why convenience shortcuts can be harmful:
if you're learning by example like I was, you see an action specified without brackets and naturally assume that passing a
Python list would be either a syntax error or a TypeError. If single actions had to be wrapped in brackets, the readability cost
of finished code would be minimal and Renpy would be more self-documenting. Although to be fair I'll admit this point is
arguable. I'm saying it because it's going to be important in a second.
And there's a lot more to this myriad of redundancy and confusion.
Buttons in screen language can be made to show up but not be clickable with their
sensitive property. OR this
can be done by using the
SensitiveIf() action - as a member in a list of actions. Because that
makes sense. (I learned this way of doing it first, which led me to believe that it was the only way because it's so
obviously the worst that I don't think anyone would choose it if they knew any other way.)
Similarly, there's a Python equivalent for almost anything Renpy script does.
can be used from a
python block (which embeds literal Python code in script) as equivalent to the
image statement, for example. But the Renpy way is almost always clearer and better, because, of
course, that's how it was made to be used.
This all flies in the face of "There should be one-- and preferably only one --obvious way to do it." Having this kind of ambiguity only confuses me and forces me to wonder what the difference is and which one I should be using.
Renpy's the best demonstration I've seen of why features are bad. Even after working with Renpy for over a year and getting experience with almost every major area of functionality, there are still a lot of things I don't understand about Renpy, and I never will since with any luck I'll never have to work with Renpy again after I finish Return To The Portrait.
ATL doesn't support blocking animations or even uncancelable ones
Okay, so ATL has this distinction between transformations, which are for transforming or moving a sprite, and transitions, which are for defining how to transition between two images. Usually transitions are used for things like scene fades.
Apparently transitions are always blocking and transformations are always non-blocking. This is a reasonable default but isn't wanted all the time. The inability to do non-blocking transformations wouldn't be a huge deal, but here's the worse problem with transformations: since they're non-blocking, they get interrupted and left unfinished by subsequent animations depending on how quickly the player moves through.
There's not apparently a way to tell Renpy that a transformation should be instantly completed if it gets superseded (I went on the Renpy Discord and asked about it and got that response from the creator). You wouldn't believe the shitty ways I've had to come up with to hack around this in Return To The Portrait. In the original DDLC Dan used an approach of having every single use of a character animation in the script specify both their destination position and their destination status (normal, focused, sunk). But that approach couldn't really work for my script since I had too much nonlinearity. There are scenes where a large block of dialog plays out the same regardless of a previous choice, but that choice does change which position a character is at, and so if I'd done it Dan's way I'd have littered every such scene with a vomit-inducing amount of if/else branches.
ATL doesn't support flow control
Of course, ATL is the only DSL that's not only well-designed enough to not reinvent Python flow control with its own unique syntax but also to not support Python flow control. If you want to do branching in ATL logic, you have to find some hideous workaround like having two different transforms and the decision logic actually be in the Renpy script.
ATL doesn't support non-idempotent animations
You normally use the
pos properties to set positions. The
pos that can't take a fraction of the screen dimensions) are independent of those
and could be used to work around this in some situations, but they still have to be idempotent, so at
best this could work if you know you'll only need to nudge the character once.
And there's another problem with trying to use
offset to get around this: since they're independent
and transforms don't touch any properties they don't mention, if you later apply a transform that only sets
offset will stay how the previous one left it.
So pretty much, if you ever want to animate a character moving a specified distance instead of to a specified position, you have to keep track of their position. And you know what that means if your script is non-linear...
ATL doesn't allow mixing relative and absolute positions to the same property
ATL parameters interpet position as absolute pixels if it's an int, and a proportion of screen width if it's a float.
But of course this means you can't mix them.
xpos 0.5 + 100 would mean
It's worse than that. That limitation's at least understandable why it's that way, but you can't even mix them in different places in the same transform. For example,
transform test: xpos 200 linear 1 xpos 0.5
will make a character appear at 200 times the screen width and move to the middle over 1 second.
transform test: xpos 0.5 linear 1 xpos 100makes the character appear at half a pixel in and move to 100 pixels in. So apparently it just goes by whichever is last.
Again, in some situations you could use
xoffset to get around this, but that's a timebomb for a few
fun hours debugging when you add a transformation that needs to not touch
ATL doesn't support defining the duration of an animation based on moving at a constant speed rather than the total duration being a constant
I don't think I need to elaborate here. It's not needed that often, but this would've been the first thing I'd think of if I wrote the ATL specification.
Persistent object returns None on accessing undefined fields
This isn't even how Python objects work. Someone presumably added extra code to make the global
persistent object behave in a non-standard, useless and bug-prone way.
expression in some cases where you need to be able to
Renpy's script language has a lot of statements that take an identifier, like
show which of course
takes the name of an image. If you want to have these statements branch without doing massive trees of explicit
ifs everywhere, you've got the
expression statement, which will make the name be interpreted
as a Python expression that evaluates to the name of a Renpy object.
But there are some situations I've often wanted to have
expression in where it conveniently isn't valid
syntax, such as with the
at clause in a
show statement (which specifies a transform).
You can use
expression to determine what image to show, but not what transform to show it with.