This document will help you get started with installing AliceOS and attaching it to your Ren'Py project.
Downloading the base system¶
If you do not plan to customize AliceOS too much, you can add the base system archive and use AliceOS that way.
Download the latest release from the Downloads page and extract the ZIP archive. Then, copy
AliceOSBaseSystem.rpa over to your Ren'Py project's game folder.
The latest version of AliceOS for download will always correspond to the latest version of the Ren'Py SDK made available at that time. At the time of writing, this means that AliceOS is building against Ren'Py SDK v7.3.2. If you are unsure of what version AliceOS is built with, check the Travis results and click on "Ren'Py Latest SDK".
It is recommend that you make sure that your version of Ren'Py is up to date to ensure compatibility with AliceOS.
Usage with DDLC Mods¶
If you plan to use AliceOS in a mod for Doki Doki Literature Club!, you must make sure that the base system version that you use is built against Ren'Py 126.96.36.199 to maintain compatibility.
The release ZIP file is generally noted as 'AliceOS-x.x.x-_AliceOSBaseSystem-rp6.zip'.
Building from source code¶
Alternatively, you can build
AliceOSBaseSystem.rpa yourself with the customization you need. This may also be helpful in building AliceOS for your specific Ren'Py version, if necessary.
- Download the source code for the particular release you'd like and open Ren'Py Launcher.
- Select the AliceOS source code and click "Build Distributions".
- Uncheck the distribution options and check "Alice OS Base System Distributable".
- Click "Build".
Your resulting ZIP file will be located in
AliceOS-x.x.x-dists, and you can follow the instructions from Downloading the base system to finalize installation.