documentation index

### Chapters

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 Pause

then "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.

documentation index