1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
|
.\" Copyright © 2015 Andrew Savchenko
.\" Distributed under the terms of GNU FDL-1.3+ license,
.\" based on original Ren'Py documentation licensed under MIT.
.TH renpy 1 "31 May 2015" "Ren'Py" "Ren'Py Gentoo's manual"
.SH NAME
renpy \- a visual novel engine
.SH SYNOPSIS
.BI renpy " game_directory"
.\" ****************************************************************
.SH DESCRIPTION
.B renpy
(Ren'Py) is a visual novel engine \- used by hundreds of creators
from around the world \- that helps you use words, images, and
sounds to tell interactive stories that run on computers and mobile
devices. These can be both visual novels and life simulation games.
The easy to learn script language allows anyone to efficiently
write large visual novels, while its
.BR python (1)
scripting is enough for complex simulation games.
.\" ****************************************************************
.SH RUNNING A GAME
In order to run a game, provide
.I game_directory
as an argument to
.BR renpy .
Exact directory name may vary depending or a game, but usually
this path corresponds to
.I */game
wildcard and contains
.I script_version.rpy*
file within. Game directory usually contains other
.IR *.rpy* " and " *.rpa " files."
One may use
.BR find (1)
tool to locate required directory within unpacked game top
directory:
.RS
find -O3
.I top_directory
-type f -iname "script_version.rpy*"
.RE
A directory one level above may be provided as an argument as well.
.\" ****************************************************************
.SH PORTABILITY
All
.B renpy
games are written in
.BR python (1),
so one can run then on any platform and architecture.
As you may have noticed, Ren'Py games are often distributed in
different archives for different architectures. This happens due to
bundling of
.BR python (1)
interpreter and required libraries in a game's tarball. Since you
are using OS native
.B renpy
setup, you should be able to run any of these games.
.\" ****************************************************************
.SH GAMES CATALOGUE
A large catalogue of Ren'Py powered games is available at
.IR http://games.renpy.org/ .
.\" ****************************************************************
.SH TROUBLESHOOTING
In some cases game may fail to run with current
.B renpy
version due to various errors.
In such case please try to use the closest
.B renpy
version to one used by game developer. Most games contain
.IR script_version.rpy " file in the " game " directory."
This file actually contains
.B renpy
version used during a game build.
You may install multiple slots of
.B renpy
in Gentoo and use
.BI eselect " renpy"
module to switch between various versions.
If
.I game
directory contains both
.IR *.rpyc " (or " *.rpyo ") and " *.rpy " files, delete"
.IR *.rpyc " (or " *.rpyo ") files, they will be regenerated by"
the interpreter.
Another solution will be to switch between version of
.BR python (1)
using
.IR eselect (1)
tool in order to find one suitable to interpret game's
.IR *.rpyc " files."
Some games may lack general media files, e.g.
.I click.ogg
sound, so you should create or download one and place in the
.I game
directory.
Also please pay attention to
.I problems.html
page from
.B renpy
html documentation, see
.B FURTHER READING
section.
.\" ****************************************************************
.SH ENVIRONMENT VARIABLES
.B renpy
supports a number of environment variables to control its
behaviour. Please refer to html docs for further details
(see
.B FURTHER READING
section).
.\" ****************************************************************
.SH FURTHER READING
.B renpy
comes with extensive html documentation. To use it install
.B renpy
with
.I USE="doc"
and go to
.I /usr/share/doc/renpy-*/html/doc/index.html
Alternatively one may refer to online documentation:
.IR http://www.renpy.org/doc/html/ .
Be warned that online docs maybe different from your current active
version, so it recommended to use shipped documentation instead.
.\" ****************************************************************
.SH BUGS
Any bugs related to Gentoo packaging (e.g. omitted dependencies)
please report on bugzilla:
.IR https://bugs.gentoo.org .
For bugs in the Ren'Py engine itself, please contact upstream:
.I https://github.com/renpy/renpy/issues
and add a Gentoo bug if you feel it necessary.
For issues with games themselves please contact corresponding
authors.
.\" ****************************************************************
.SH SEE ALSO
.BR python (1)
\- an interpreter used by Ren'Py engine.
.BR unrpa (1)
\- a tool to unpack
.I *.rpa
data files (Ren'Py Archives).
|
GitWeb