RenPSP

RenPSP
General
Author	Angelo Barredo (weetabix)
Type	Game Engine
Version	0.5
License	Mixed
Last Updated	2013/07/19
Links
Download
Website
Source

RenPSP is a Lua Player clone of the Ren'Py Visual Novel Engine for the PlayStation Portable platform.

The engine was written in Lua language for LuaPlayer platform, so it is not a fully RenPy port, but an imitation.

Features

• Support for .rpy scripts.
• Support image formats (JPEG, PNG, BMP).
• Support audio formats (WAV, MP3, OGG Vorbis, Atrac3).
• Single save file function.
• Cyrillic 1251 character map compatibility.

Installation

For the PSP version:

• Put everything in ms0:/PSP/GAME/. It checks /GAME/ folder for loadable scripts.
• Lua Player Euphoria v8 is the default Lua Player EBOOT.PBP.
• Rename EBOOT_LPP.PBP to EBOOT.PBP to use Lua Player Plus rev163.

Windows version (based on LuaPlayer 0.20):

• Just run win32_start.bat.
• Tested on Windows XP, Windows 7 and Windows 8.

Release comes with several mini-VNs:

• A test game to demonstrate some features.
• The Question by LSF Team (revised).
• 9 мая by IIchan Eroge Team.
• Ripples by Ayu Sakata (revised).

User guide

Engine's state is saved to saves/default.sav, this file is not encrypted. Screenshot is saved to screenshot.png.

It supports for simple narration, code branching with menus and conditions, characer emotions change, label jumping. There is no transition effects.

Code lines and conditions are supported, but they must be written in Lua, not Python as is original RenPy. Main difference for simple games is using "A~=B" instead of "A!=B".

Supported RenPy semantics of:

 define CHARACTER_ID = Character('FULL_NAME')
 image SPRITE_ID [SPRITE_SUBID] = FILENAME
 scene SPRITE_ID
 show SPRITE_ID [SPRITE_SUBID] [at POSITION]
 hide SPRITE_ID
 label LABEL_ID:
 jump LABEL_ID
 play [sound|music] FILENAME
 stop [sound|music]
 $ LuaCode()
 if LuaCode(): elif Lua()Code: else:
 menu:
 return

Those lines are ignored:

 # ... , with ... , pass

Anything else is parsed to lexems, first of them is converted to sayer's name.

Set of supported images format is uncertain. However, engine does not support image higher then 800õ600 for sure. Included demos use JPEG and 8-bit PNG.

Monotype font Lucida Console is used for text rendering. Text is rendered character by character. Encoding used is CP-1251.

All characters from english and russian keyboard layouts are supported:

qwertyuiop[]\ asdfghjkl;' zxcvbnm,./ `
QWERTYUIOP{}| ASDFGHJKL:" ZXCVBNM<>? ~
éöóêåíãøùçõú\ ôûâàïðîëäæý ÿ÷ñìèòüáþ. ¸
ÉÖÓÊÅÍÃØÙÇÕÚ/ ÔÛÂÀÏÐÎËÄÆÝ ß×ÑÌÈÒÜÁÞ, ¨
1234567890-= !@#$%^&*()_+ !"¹;%:?*()_+

There are also some additional characters for better typoghaphics: « » — ©

Controls

PSP:

Square - Toggle text display

Cross - Go to next dialog line, Select a menu item

L/R - Game log

Start - Menu

D-Pad - Navigate menu

Triangle - Take a PNG screenshot

Windows:

q - L

w - R

a - Select

s - Start

r - Triangle

d - Square

f - Circle

c - Cross

Arrows - D-Pad

Screenshots

Comapatibility

Tested on PSP FAT with 5.00 M33-3 and 6.60 ME.

Changelog

0.5

• Added ICON0 and PIC1 design.
• Support for game description files (see desc.lua on any game folder).
• Game preview backgrounds on main menu (only on Windows version for now).
• Screenshots are now saved in ms0:/PICTURE/RenPSP.
• Sounds can now be disabled upon game boot.
• Support for $renpy.save() and $renpy.load() functions.
• Menu selection scrolling.
• Fixed background loading from save game.

0.4a

• Corrections to new features:
  • OSK input function disabled.
  • Custom game skin variables corrected.
  • Background clearing fix.
• Game-specific Improvements:
  • 9 мая:
    • Sample use of customized game skin and helpfile.
    • Background music compatibility fix.
  • Ripples:
    • Background music compatibility fix.

0.4

• New default skin.
• Set Lua Player Euphoria v8 as default Lua Player.
• Fixed image memory leaks from sprites and backgrounds (improved as of 0.4a).
• Game skin and helpfile customization.
• Custom game skin variables corrected (as of 0.4a).

0.3

• Added LuaPlayer Plus r163 EBOOT with the release.
• Images loaded when used, not upon initialization.
• Full paths used for most files.
• Use of RenPSP logfile.
• 8 New Character Positions.

0.2

• Skip function stops correctly.
• Settings, Help File, Test script, and Dropdown menu changed from Russian to English.
• Fixed If-Else Test in Test script.
• UI Changes (Black dialog and answer boxes, Katawa Shoujo SD Character Icons for the dropdown menu).

0.1

• Initial Release.

Credits

• lolbot for the original RenPSP engine.
• Ayu Sakata of Sakevisual for permitting the port of Ripples on the PSP.
• Danny Glover for Lua Player Euphoria.
• NaNnI for Lua Player Plus.
• http://iichan.hk/

External links

• Author's website - http://weetabix-su.github.io/renpsp-dev/
• GitHub - https://github.com/weetabix-su/renpsp-dev
• Wololo - https://wololo.net/talk/viewtopic.php?t=33799
• Lemma Soft Forums - https://lemmasoft.renai.us/forums/viewtopic.php?t=17991