You've reached a page on the Ren'Py wiki. Due to massive spam, the wiki hasn't been updated in over 5 years, and much of the information here is very out of date. We've kept it because some of it is of historic interest, but all the information relevant to modern versions of Ren'Py has been moved elsewhere.
Some places to look are:
Please do not create new links to this page.
Just like a traditional story, you might want to divide your Visual Novel up into chapters (or Acts, or any other story-telling chunk which makes sense in the context of your work.) Here's how.
scene black with dissolve
show text "Chapter 1\nA Frightening Sight" with Pause(1.5)
scene black with dissolve
scene your_scene_title
e "And now the story really begins."The code above will cause Ren'Py to fade to a black screen, showing "Chapter 1" centered on the screen, and below it on the next line "A Frightening Sight", also centered. (The "\n" means "new line".) After a pause of 1.5 seconds, the text will fade out again.
If you just say:
show text "Chapter 1/A Frightening Sight" with Pausethen "Chapter 1" etc. will stay on the screen until the player clicks or hits Return.
"black" (note the lower case "b") is the only color which Ren'Py knows about by default. If you want to use a different color as the background for your chapter titles, then you'll have to set that up before you can use it, in an init block, like so:
init:
image black = Solid((0, 0, 0, 255))
image white = Solid((255, 255, 255, 255))
image grey = Solid((128, 128, 128, 255))Just google for "web colors" if you don't know what the values in brackets should be for the color you want.
Note that there's nothing special about this "Chapter scene" - you don't have to use a Solid color if you don't want to. A custom scene-title .jpg would work just as well.