A downloadable tool

Download NowName your own price

This is Pronoun Tool, a simple tool to select and display pronouns in your Ren'Py game. (For an example of a game using a simpler version of this tool, take a look at TOMATO CLINIC.) It was made in Ren'Py but has support for the extra self-voicing options available in Ren'Py 7.4.


  • Player-selectable pronouns (3 by default but more can be added) 
  • Menu to select pronouns using a screen and using a dialogue choice menu
  • Text tags to change what text is displayed depending on the pronouns selected
    • e.g., This is {0}Mr{/0}{1}Ms{/1}{2}Mx{/2} Parrot.
  • Pronouns as variables (with note re: extra work required for translation)
    • e.g., [they!t!c] went to the supermarket with [their!t] friend.
  • Display pronouns on-screen when a character is speaking (toggleable)
  • Guide to show how these functions work in-game

To use this tool, follow these steps:

  1. Copy the file named pronountool.rpy from the game folder into the game folder of your own game.
  2. Follow the instructions in pronountool.rpy to implement it in your game.

You can also play the guide by launching the tool through Ren'Py if you put the folder into your Ren'Py project directory. It gives examples of how to use each of the features.

The code in this tool can be used in any way you like! If you use this tool, I would appreciate it if you credit Pronoun Tool or npckc (https://npckc.site or https://npckc.itch.io) in some way, but it isn't required.


want to see more games like this? sign up for my newsletter!

join my patreon for secret updates, a monthly digital postcard & early access to my games!



  • 2020/12/13 updated text tag names to avoid any potential conflict with default ren'py
  • 2020/12/12 full release
  • 2020/12/09 early access for patrons
Rated 4.8 out of 5 stars
(39 total ratings)
GenreVisual Novel
Made withClip Studio Paint, Ren'Py
Tagsgender-inclusive, inclusive, pronouns, Ren'Py
Code licenseMIT License
Average sessionA few minutes
InputsKeyboard, Mouse, Gamepad (any), Touchscreen
AccessibilityColor-blind friendly, Subtitles, Interactive tutorial
LinksHomepage, Twitter, Patreon


Download NowName your own price

Click download now to get access to the following files:

pronountool.zip 205 kB

Development log


Log in with itch.io to leave a comment.

every time i try to test to see if it will run properly, i get an error that says: File "game/pronountool/game/screens.rpy", line 426:keyword argument 'xpos' is incompatible with 'xalign'.  Every time I try to click on it to fix the issue nothing shows up. I'm new to coding so I could be doing something totally wrong and just not know it but still

i couldn't recreate this issue on my end. have you checked line 426 of your screens.rpy file?

(1 edit)

i tried it and all thats there is xpos gui.dialogue_xpos which i believe is there before i even added the tool

This is great, thank you! Is there a way to have mixed pronouns for a character, ie. she/they? I was thinking maybe it's possible to have a new pronoun set for those options and then somehow make it 50-50 which pronoun list gets used each time... not sure how to do that though, I'll try and work it out!

i think what you could try doing is calling renpy.random every time the pronoun is used to randomise the pronoun, but i think that's not an ideal application and it would probably be better to alter this tool a lot to fit your needs or just use it as a base to make a tool of your own.

i love how she creates helpful games. thanks!

(2 edits) (-1)

Oh my gosh this is super helpful, thank you so much!!

Edit: My friend helped me out! I just had to copy the variables from the pronountool.rpy and paste them on the script.rpy after the selected pronouns line, hehe. Thanks again for this wonderful tool!

I just wanted to ask a question, if it's alright. I'm reading the instructions to implement the tool and it worked for me when I used the pronoun text tags but I'm having trouble making the pronoun variable work; it goes to "they/them" by default. 

Is there something we need to add to the script.rpy or any of the other rpy files to make the variable work when you're typing dialogue? Sorry about this, I'm a bit of a beginner with Ren'Py and coding 💦


glad it worked out! i'll go over that part and see if i can make it more clear in the explanation.


oh man, thank you so much for this tool. i use ren'py a lot and pronouns suck to program in. 10/10, good job!

Deleted 1 year ago

have you followed the instructions as listed in step 2? just copying the file to the game will not work.

(1 edit)

Sorry, I did, I was just opening the script and options and stuff individually form the main menu instead of clicking 'open project'. I haven't poked renpy in some time so when it said to just look at the pronountool.rpy it wasn't immediately clear what that meant. But I've found it now and I look forward to poking around with it! Thank you for the quick response!!

sorry if it wasn't clear! i hope it works for you.


Mx Parrot explained things very clearly and sweetly, and I was enthused when I understood how the {0}{1}{2} tags work! Super cool!

Thank you so much, npckc <3


i'm glad the explanation was clear! (:

Hello! First, huge thank you for developing this, it is so incredibly helpful. I am new to Ren'py and Python in general, so I think I'm messing something up, but I can't figure out what it is.

It's weird because I'm able to get the preferences menu working and the player can choose their pronouns, but I think I'm typing this part in particular incorrectly because the error keeps coming up as "Exception: Unknown keyword arguments: pronouns". I haven't made any changes to the actual pronountool script, so I feel like it's probably just something I'm mistyping in this space.

Thank you for your help in advance, and sorry if this has a really simple solution that I'm just overlooking. ^^;


hello! unfortunately i can't tell what the error is just from that. i think ren'py should give you a more detailed traceback.txt, but would you be able to copy/paste that into a comment here (or send it to me @ https://npckc.site#contact)?

Oh, okay, will do! Thank you!


Hello, first of all, thank you for creating this. I was wondering if there's a way to incorporate this into imagemap. Thanks a lot! 


hmm, i think you could do it if you add a screen for your imagemap and show that in the pronounselection label instead of the choice menu that currently appears.

Yep, I tried doing that with the screen variable but I keep having errors for some reason. How would you recommend the correct approach?

unfortunately without actually looking at your code i can't say anything more specific. i don't think you should be using screen variables though - the screen you create should be using the variables specified in pronounselection so that it can change the variables directly.

Sorry, it was SetVariable, not Screen Variables. Anyway, the code is this.

I managed to work around it somehow. Thanks for the help regardless.

this is a really nice tool and I like it a lot!!! it'd be really cool if custom pronouns were available too

the tool has 3 pronouns by default but more can be added, as stated in the summary.

I know about that but I mean like when the player gets asked what pronouns they have and they choose their own custom set


if that's something you want to do, you could set it up by asking the user for input in renpy. it would cause issues with translation though, so it hasn't been included in this tool.


oh ok!! thank you for responding!!