【星楼钟塔】用Renpy制作一款简单的视觉小说/Replay（1）

熊猫人教信徒 · 发表于 2023-2-22 22:20:14

使用的工具：

视觉小说转换器、Renpy本体、VSCode（Visual Studio Code）啊当然可能有人会用Atom，但我个人感觉VSC的功能要更多一些，而且对Atom也不太熟~所以这里就用VSC啦。

前排声明：

·本贴为低代码/无代码向。

·因为本人也算是代码白痴，深入一丢丢就还得再去学的地步，如若由部分错误请轻喷QWQ，顺便快艾特我我去看看能不能改正。

·通过视觉小说转换器制作的视觉小说肯定比不过存代码敲出来的视觉小说，质量是比较原始（粗劣）的，后续可能会再发相关系列的贴来进一步的打磨，虽然那个时候可能需要一定的代码知识啦~

·同上，本贴的目的是能够制作一款简单的视觉小说，并且至少达到能够畅通无阻运行完，能够发布的水平。UI优化呀，细节方面的看看有没有机会下一次再来说QWQ。

———————————————————————————

工具的准备与说明：

视觉小说转换器

下载地址：点我。

视觉小说转换器是由B站大佬凉宫春日应援团及小队军医开发的一款转换器，它最大的功能是可以将特定的EXCEL表（剧本）转化为RPY文件（假如你接触过Renpy游戏的汉化的话，应该对该文件不陌生，简单来说，RPY是Renpy视觉小说的特殊运行文件，需要由特殊的编程软件打开，这里推荐的是VSCode，当然，这里就是后话啦。

视觉小说转化器的优点在于，它能够将EXCEL表的内容转化成代码串，达到低代码甚至无代码的效果。对于新手或者代码白痴来说，可以仅仅只用填EXCEL表格就制作出来一项视觉小说，而且可以通过转换后的RPY文件学习Renpy代码的编写；对于老手或者具有较好编程基础的人来说，视觉小说转换器可以大幅度缩短制作用时，缩短重复工作等等。

Renpy

下载地址：点我。

相信你一定认识这个戴着探险帽，有着红色头发的女孩，她的身上总是缠绕着一只黄色可爱的蛇（蛇真的会可爱吗，我不信）。这就是Renpy的标志。

目前兽圈、gay圈绝大部分的视觉小说都是由Renpy制作的，比较著名的有矛之酒馆、Lustful Desires，还有很多耳熟能详的名字，比如兽人大学、after class等等等等（呃？应该？没记错的话？）。

VSC（visual studio code）

下载地址：点我。

VSC是（巴拉巴拉巴拉省略一长串的）代码编辑器，当然咱讲究的是低代码，所以这里使用的VSC其实主要目的是为了打开RPY文件来修改bug和后续添加代码等等。

这里需要注意的是，VSC默认是英文，如果需要切换成中文的话，点击拓展，然后搜索chinese（simplified）插件即可。另外，建议也下载下面的插件Renpy Language 能够帮助VSC更好的读取和编写Rpy语言。

——————————————————————

第一步，从项目的创建开始。

首先需要打开Renpy，这里需要注意的是，假如你的Renpy显示的是英文，但是你又不看不太懂或者不喜欢的话，可以点击这个位置的设置，然后选择简体中文/繁体中文即可。

然后选择创建新项目即可，这里需要注意一下的是，项目名称只能输入英文和下划线等特殊符号。

第二步，认识相应的文件和文件夹

创建完新的项目过后，打开项目的目录或者从Renpy查看，可以发现新目录下多了很多的文件夹和以RPY结尾的东西。

这个是新项目文件夹下的目录，如果找不到的话也可以在Renpy点击game。

打开目录下的第一个game点击可以直接跳转到文件夹目录下噢

这里简单介绍几个文件夹和编辑文件。

·images文件夹，这里是你放图片的地方，PNG和JPG格式的图片都可以。所有的立绘、背景图、头像、图片的丢进去就完事了。注意一下，不能丢UI素材、对话框图片等等。

·audio文件夹，这里是你放音频的地方，推荐格式为MP3。包括音效（如开门声，雨声，爆炸声等等）、BGM、配音等等。

·gui文件夹，还记得在images文件夹说的不能丢什么东西进去吗？那些东西都应该丢在这里，这里是修改UI而需要的素材存放的地方，只不过本贴还暂时讲不到~。

·script.rpy 主要编辑文件，如果没有使用视觉小说转换器的话，绝大多数的时候，都是在这里编写剧情和效果的主文本。如果要使用视觉小说转换器的话，需要优先删掉该文件。

·gui.rpy 界面、UI编辑文件。可以用来修改UI和字体等等，本贴暂不介绍。

第三步，填写EXCEL（剧本）表格。

在这里推荐大家去看视觉小说创造者UP主凉宫春日应援团的视频，这里只做部分的补充和个人经验的分享。

1.主部分（角色、对话列）

主部分：一般是剧情文本。

·感觉这里...emmm，可能是我的问题，也有可能是什么其他的问题。总而言之就是角色那一列如果不填的话，是默认为旁白的，而不是上一个说话的人。所以这里建议按照“谁说话，就填谁、不填就是旁白”的原则来写，呃...当然如果没有出现这个问题的话不用在意这个！

·“”符号为非必要。

2.次要部分（效果）

次要部分：主要是效果展示，依附于主部分。

·背景、立绘、音效、语音（呃，分支左边那个，手贱的时候不小心改了）、头像，任何需要从audio文件夹、images文件夹使用的素材，这里都填写素材文件名，注意，尽可能的不要用纯数字来命名（这里个人推测可能是视觉小说转换器或者Renpy的bug，识别数字的时候默认是数字而不是文本，就是说有可能你命名为1，但是转换出来，在VSC里面显示的是1.0，然后就找不到这个素材报错啦）

·只有语音需要填写后缀名，推荐格式为MP3。

·音效一列默认只播放一次，如若要循环播放的话需要在前面加上“循环”两字。比如风铃这个音效想要循环，则需填“循环风铃”。

·头像一列只用在人物出场时填写一次即可。

·建议在images文件夹和audio文件夹分别放一个纯黑的图片，纯空的音频，取名为none或者空白，这样在需要全黑屏或者关闭BGM的时候在背景或者音乐列填写none就能达到效果了。

·背景的分辨率请与游戏的分辨率对标（一般来说是1920*1080），不然可能会出现背景太大或者太小的问题。然后头像的高可以设置在300，宽可以合理设置。（刚好与原版UI的文本框重合。）

3. 分支。

我们不妨来看看，视觉小说的分支逻辑。什么时候需要分支？分支意外着什么？

·分支的填写：需要在对话列上写明选择项，然后在“分支”一列跳转相应的附表格。

·请注意，附表格命名尽量不要纯数字，也请尽可能的不要带特殊符号。（不然Renpy可能识别不出来报错。）

第四步，使用视觉小说转换器，获得RPY文件。

打开视觉小说转换器，然后点击浏览，选中填写完毕的剧本EXCEL表格，然后选择输出的路径，即可转换成功啦！

视觉小说转换器

转换出来的RPY文件

然后将转换出来的RPY文件，放置在game目录下即可。（不用管RPYC文件）

·注意，再提醒一下！转换出来的RPY文件其实在某种程度上也能算Script.rpy文件，所以请一定要先删掉Script.rpy文件噢！

最后一步，运行与bug修复。

把转换出来的RPY文件放在game目录下，就可以通过Renpy来启动项目了！你可以看看你制作的作品了，当然，可能也会有很多BUG。

只要按照填写标准来写的话，一般是不会出现bug的，绝大多数的bug都是因为填写不规范而导致，少部分可能是因为bug，导致Renpy没有识别到某些东西。这个时候，就需要前面的VSC工具来挑错啦~

唔，看着会不会觉得有些头疼呢。

例如该项bug而产生的异常，只看第一段，它说的是在audio文件夹找不到K1音频文件，无法播放该语音，所以发生了异常。我们这个时候可以打开audio文件夹，发现，有K1这个音频文件。

然后我们点击第一段蓝色的部分，即可用VSC打开出错误的RPY文件，甚至还贴心的给你列出了是哪一行的代码（line 17 即17行）。

然后通过VSC，找到第17行，可以发现，第16行voice，即语音的意思，而语音文件需要添加后缀.mp3，这里没有添加，导致运行到这里的时候无法正常播放该音频文件，从而报错。然后我们加上后缀，重新运行，正常读出~BUG就修复啦。

修改后（在16行K1后面添加上MP3后缀。）

一些常见的BUG汇总：

·背景读取不出来：请仔细查看images文件夹是否有相应的文件，文件名是否相同（有没有空格之类的），或者说，是否有特殊符号、字母全大写等（之前就有遇见过，查了一些资料说是Renpy的一个小BUG，很多人都遇见了，把名称改为小写就没事了）。

·注意看一下，在EXCEL（剧本）表格上的次要区是否有填错（比如背景填到音乐一栏去了之类的。）

·比如上面的voice指令，以及视觉小说转换器转换出来的RPY文件有一些指令是默认audio文件夹和images文件夹的，这就意味着，如果你在这两个文件夹下又新增了几个子文件夹，并且在里面放了素材可能会导致Renpy读不出来而报错。这里的建议是修改一下VSC里相关代码里素材的路径，如果实在不会的话~不要在这两个文件夹下新建文件夹就好了~

—————————————————————————

一些成果展示：

一个小样品，完整可以看附件噢。

因为感觉自己独角戏很尴尬，所以拉来了歧老师。

之前制作的作品，就不放出来啦。

后记：

·如果在这一块有什么奇奇怪怪的bug的话或者有一些不太懂的问题的话可以在论坛私聊我，我会的话会尽量解决的！当然，太难的我也可能不会qwq。

·附件有一个自己之前收集的一些素材网站，虽然很杂，但还是希望能够为一些创作者帮上一点点忙。但是...真的！很少。qwq

·感谢你看到这里！第一次写相关的教程贴，感觉蛮难的，肯定有一些表述不太清楚的地方，请不要介意。

*我的天，头一次码这么多字的贴，好累。

*噢，还有一点，如果有意使用我那些收集的网站的话，请注意看该网站的使用条例噢。当然，自己找素材的时候也是！注意使用条例噢！