Skip to main content

Indie game storeFree gamesFun gamesHorror games
Game developmentAssetsComics
SalesBundles
Jobs
TagsGame Engines

Controller Support Expansion for Ren'Py

Comprehensive set of features to improve controller support in Ren'Py. · By Feniks

Mouse sensitivity + "TypeError: missing a required argument: 'title'"

A topic by Adelie created May 30, 2026 Views: 190 Replies: 4
Viewing posts 1 to 4

Hi there!

I love that you've included all these accessibility options, but I notice mouse sensitivity isn't available. Is there a reason that a scaling adjustment to the mouse movement can't be added? I saw that there was one for keyboard movement, but nothing for mouse. This is really important for people with limited hand motion. I had emailed, but you suggested that I try to add it myself, however I'd love to include the Controller Expansion as well and given it's massive mouse overhaul, I'm struggling to figure out where to put a relative mouse motion adjustment to get it to refresh appropriately.

I'm also having a problem where if I'm in game (not the main menu/preferences/history etc) if I hit Esc I get a "TypeError: missing a required argument: 'title'". I did save the traceback for this error, I assumed it had something to do with the keyboard settings. 

Thank you for all your work!

Developer

Hey there! The stick sensitivity options will work for the virtual cursor as well, so you can adjust it that a small nudge will move the virtual cursor much farther, or that a large nudge will not move it very far if you need slower movement for precision. You can use the StickSensitivityAdjustment class as a bar value as demonstrated in the included preferences example screen.

For the TypeError, I'll direct you to /post/13055124 - specifically that you can remove the _game_menu_screen = "game_menu" stuff or adjust your game_menu screen.

Fantastic! I love this. I'll make sure I understand it in the preferences screen. And I totally missed the Need Support post, so sorry about that! I swear I only saw the other two. My apologies.

Sorry to continue asking, but where is the virtual cursor receiving mouse input? I see it taking stick events and I see the sensitivity being applied in the stick event. Is the solution that I have to create an entire equivalent MouseEvent class? I apologize that I am clearly missing something crucial here, I apparently am not as good at Python as I previously thought. I've never really had to overwrite another event handler, and I was unclear if Renpy is using Pygame for the mouse handling.

Developer

The virtual cursor isn't receiving mouse input; it's mimicking the functionality of a mouse by navigating around an image (the cursor) that can be used to focus things. If you specifically want a mouse cursor that takes over the usual game's mouse events, it's probably going to need to sit on top of everything and eat pygame.MOUSEMOTION and MOUSEDOWN/UP events so that you can use those events to control your desired mouse functionality. Then, depending on how you have your system set up, you might send modified mouse events back to Ren'Py at your desired coordinates. You will probably need to send some kind of mouse event out to the rest of the UI for things like drag & drop and edgescrolling at minimum, as they're hardcoded to listen for the pygame mouse events.

Most of Ren'Py's code to handle mouse events is in renpy/display/core.py in the Interface class.