code, howto, Ren'Py

Working with Ren’Py: Part 1: Downloading and Configuring

1_Logo

Working with Ren’Py:

Ren’Py is a engine for creating visual novels. It comes with a suite of tools for taking code and transforming it into programs that can be run on Windows, Mac, Linux, and even, with a little more work, mobile platforms like Android and iOS.

Note: As of this writing, the latest version is Ren’Py 7.0. All screenshots and code in this guide are based on that version.

 

Downloading

2_Download.png

Ren’Py can be downloaded from its its Download (Latest) page. It has builds for Windows, Mac, and Linux by default. (Additional, individual downloads for tools can be found under at the bottom of the same page.)

Depending on the platform chosen, the downloaded file will need to be uncompressed into its full content of files. On Windows, this is done through its self-extracting file. On Mac and Linux, it can be uncompressed either through the default file viewer or from command-line tools.

3_Files

Navigating to the now uncompressed folder shows its contents. To run Ren’py, open the “renpy” executable on Windows, “renpy” shell script in Linux, or the “renpy.app” on Mac.

4_Launcher

The Ren’Py Launcher provides access to all of the files, directories, and possible actions for any project. By selecting projects on the left-hand side (“Tutorial” is selected by default), they can be changed, built, or run.

With “Tutorial” selected, click on “Launch Project” in the lower, right-hand corner. This will open the project in a playable view.

5_Tutorial.png

“Tutorial” can be played through clicking on “Start”. It contains various examples of how to accomplish common tasks in Ren’Py as well as demonstrating it at the same time.

6_Exiting

To close “Tutorial”, press ESCAPE and then choose “Quit” and confirm it. (Unless changed by the author, this is the default way to access settings while playing something made in Ren’Py.)

 

Configuring

4_Launcher

Editing files is as easy as choosing them from under the “Edit File” listing when selecting a project.

With “Tutorial” selected or choosing it from the left-hand Projects listing, click on “script.rpy” under the Edit File listing.

7_Editors

If trying to open a File for the first time, the Ren’Py Launcher will ask which editor should be downloaded and connected to editing files.

The first three, Atom, Editra, and jEdit, are listed in order of size and functionality. Atom, for example, comes with more features, but is also much larger to install.

If unsure, choose Atom, the recommended editor for Ren’Py 7.0.

8_EditorDownload

Once an editor is chosen, it will be downloaded, uncompressed, and configured for use with the Ren’Py Launcher. Depending on a number of factors like bandwidth and computer speed, this step may take some time.

9_Ready

Once ready, Ren’Py will prompt to “Proceed” to open “script.rpy” in the editor chosen and downloaded.

10_CodeView

Note: The above screenshot is from Atom.

When opened, files can be edited in different ways. Once done editing, it can be closed by closing the tab of the open file or editor itself.

Note: If following this guide closely, close the “script.rpy” file instead of editing it at this time. It needed to be opened once to prompt the editor choosing and download screen.

4_Launcher

Return to the Ren’Py Launcher.

Ren’Py is now downloaded and configured for editing existing and creating new visual novels!

 

 

 

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

w

Connecting to %s