Puyo Puyo Tetris 2: How to Edit Cutscene Dialog and Other in-game Text

Here is a full tutorial on how to edit cutscene dialog and other in-game text in Puyo Puyo™ Tetris® 2 game. Don’t let Schezo succeed in fixing his bad habit.

Introduction

Don’t be like Arle THIEF. Before you can make her pay the ultimate price, you will need a couple of things:

Puyo Text Editor[github.com]
PuyoPac[github.com] (1.1.0-dev or higher)
A text editor (Notepad++, Visual Studio Code, etc…)

Using Puyo Text Editor

If you haven’t yet done so, download Puyo Text Editor using the link above. Then extract the entire contents of the archive to a folder of your choice.

Text files in this game are stored as CNVRS-TEXT files, which are located in the appropriate text_common PAC file for your game’s language in image/x64/raw/text/ in the game’s folder. For English text, this PAC file is located at image/x64/raw/text/text_common_en.pac. These PAC files can be created or extracted using PuyoPac.

The easiest way to use this tool is to drag CNVRS-TEXT files (which creates XML files you can edit) or XML files (which creates CNVRS-TEXT files you can use in-game) onto Puyo Text Editor, as such:

As you can see below, dragging the CNVRS-TEXT file onto the app created a XML file that you can edit:

To convert the XML file back to a CNVRS-TEXT file, simply repeat this process using the XML file.

Reminder: Always make a backup of the files you are editing.

Editing the XML file

Take the XML file created by Puyo Text Editor and open it up in your text editor. You will see something like this (this image uses the CNVRS-TEXT file for Act 1, which is named chapter01.cnvrs-text in the text_common PAC file):

It’s not shown here, but there are a variety of elements that can be used in the text:

Element

Description

Changes the color of the specified characters to the color specified by c. c is a hex color in the format AARRGGBB. Note that this color is applied using the multiply blend mode. As such, the color will only appear as intended if the original text was in white.

Writes the value of the variable with the specified name n.

Shows an image with the specified name n.

Once you’re done making changes, convert this file back to a CNVRS-TEXT, re-build the PAC, then test it out!

Cutscenes can be further edited (such as changing the size of the textbox) by editing its plain-text PSS file, but that’s a topic for another guide.

Note: & and < must use their encoded enties (& and < respectively) in the XML file.

Example

Using the XML file from before, let’s change the first line to something simple:

After you convert this file back to a CNVRS-TEXT and re-build the PAC file, this is what it’ll look like in-game, which in this case is the first line of dialog in Act 1-6:

That’s all there is to it.

Conclusion

Compared to Puyo Puyo Tetris 1 and Puyo Puyo Champions, many text-related things that were stored as textures in those games are now stored as text, making them quite easy to edit: