Ren'Py Phone System
A downloadable ren'py script
No longer are your visual novels bound to fantasy settings or by roleplaying "Your phone buzzes and you read the message." in the dialogue box"! Let your characters talk the modern way with this lil Ren'Py phone system (coming in both smart phone and flip phone flavours, of course). 📱
If you like this project, make sure to give it a star on Github, leave a rating, and/or get the supporters edition! ⭐ And you can view the demo here 🥰
✨What does the Ren'Py Phone™️ do?
- Obviously, a contacts list and direct messages
- Smart Phone mode (default) and Flip Phone mode!
- Light Mode (default) and Dark mode!
- Group chats between characters! They can join, leave, and add others as well.
- Emojis! Use any images you want as in-line text emojis.
- Photos! Send photos in chat of any size or aspect ratio
- Choices! Have the user select what text to reply with, and optionally, make that branch to different paths with Jump/Call
- Animated! Pretty little animations that make it feel more like a real phone.
- Optional sounds included! But of course you can always use your own as well. You can also customise when they play (or if at all)
- Super easy to customise! A giant config exists at the top of the file where you can change anything from the language of the phone to the size of the text
- Easily change the phone design, screen layout, and bubbles! The images are super easy and there's a few examples of how to change it already~ (for example, adding a fake status bar to the top of the phone)
- Lots of small quality of life features: timestamps in chats, making message previews in the contact list different than the message, hiding/showing/deleting existing chats, forcing pauses, forcing the user to look at a specific chat, notifications, message history in the dialogue history, move the phone around and change the size, animate the phone, wait for the user to click to continue or have automated messages send with pauses, support Ren'Py's skip mode, and a lot more!!
- The Ren'Py Phone is 100% standalone and does not require you to change anything about your project to add it
- Does not rely on NVL mode or other special Ren'Py settings, use it anywhere anyhow
- Takes like, a few lines of code at most, to get started. I tried to make it super-duper-super easy!
- The download includes a fully fleshed out demo game, where the examples for you to copy to your project (ex. how to send a message) are in script.rpy and the phone system is in phone.rpy
- Fully documented both in code and with setup instructions in the README
- This project is free with a license that's basically "credit me"! Please see the top of phone.rpy to learn more specific details.
- Ultimately, after downloading, just head over to the README.md and go through those few steps!
😇Supporter's edition? More phones!
- This is purely optional but I did pour a tonne of love into making it, so if it helps you or you can profit off of your game with it, I hope maybe this is worth it!
- You get 7 extra smart phone designs and 4 extra flip phone designs included! (and some of them are really heckin cute, like the flower flip phone or sticker smart phone)
- Priority support! I will help you directly, 1:1, night or day, rain or snow, even during a zombie apocalypse! (zombie apocalypse support not 100% guaranteed)
💗Projects using my phone!
- Haven University by Sam Rose, which initially was what I developed this for
- Your game here! DM me on Discord @ kleineluka!
Hey, listen! Need help setting it up, found a bug, or just have a question? Please reach out! You can find my contacts on my website here, on Discord at kleineluka, or through email (lukazoeysong@gmail.com)! 💗
Download
Click download now to get access to the following files:
Comments
Log in with itch.io to leave a comment.
Hi!! This is sooo awesome!! I'm using this in my game Yuki's Oblivion (its in development still). Will, of course, be crediting ^^
Awesome!! Thanks so much for sharing and I'm glad it's working well for your use-case, I can't wait to see it when it's done :)
Hi Zoey,
Thank you for the awesome script! I just played the demo and I noticed the profile picture at the top and the text at the bottom goes outside of the phone screen, is this intentional? If so how do I make anything outside of the phone screen cut off? Or at least scale them in a way so they fit in the first place? Thank you so much in advance!
Hi! Is it possible you could show a screenshot of what you mean? I'm not sure I see that on my end in the demo. Also, your device and resolution may help, in case it's a scaling issue. Thanks :)
I'm on Windows 11 Desktop, and using resolution of 1920 x 1080. Here's a screenshot:
Did you change anything at all in the demo? That's so strange, I don't have that happening on my end. It looks just like a z-order issue with the phone case being too low. Does changing the window's aspect resolution impact it at all (ex. shrinking the window make it go away)?
The only thing I changed is renaming the inner folder to Game so Renpy can run it, and putting the game in the same folder as my other renpy project. though I re-downloaded and it's still the same thing. But I think I figured it out. in the message_viewport, you defined the ysize to be 750, so I removed that line and it somehow auto-scaled on its own with the correct ratio O_O
Hmm, strange. I'll have to take a look at that line of code. So does it all work as intended now?
This code is perfect, thank you !
I'm having some issues with it as I'm fairly new with Ren'py but I'm learning ! I alas need your help with a little problem I can't seems to resolve : my textbox keeps appearing in the back of the phone when it's open ! It's just... slighty smaller, and return to normal once the phone is closed.
Do you have any idea how to make the textbox disappear for good ? Thank you very much for your time !
hihi yes! thank you :) and did you adjust the screens.rpy with the code snippet in the README? basically, you add an extra line if the global phone mode is toggled on, to hide the textbox completely. feel free to add me on discord (kleineluka) if you need further help
I did, but with no effect :/ ! I even erased persistent data after changing but it didn't work... Thanks for your time and proposition !
EDIT : I found the problem ! I erased by mistake a # in front of " background Image("gui/textbox.png", xalign=0.5, yalign=1.0)" in the style window !
EDIT OF THE EDIT : I am but a fool and my ancestors are disappointed in me. Changing this # made all my textbox disappear, with or without the phone open. Fixed this, but now the textbox during phone is back.
Hi, I'd need to see your screen code to help further debug as I'm a bit lost as to where you are right now in the process of debugging it. If possible, could you reach out on Discord? It's a bit easier than Itch.io comments and I am much more active :)
oh cool, i wonder if is possible turn it in a discord screen? I was trying do it with nvl system but still no sucess i will try it thanks
I plan to release a Discord-like chat program soon as well :) it is absolutely possible, even just with refactoring the code here. o/
It's just perfect, thank you so much.