Puyo Puyo™ Tetris® 2

Puyo Puyo™ Tetris® 2

Not enough ratings
How to edit cutscene dialog and other in-game text
By NickW
Don't let Schezo succeed in fixing his bad habit.
2
2
   
Award
Favorite
Favorited
Unfavorite
Introduction


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


Note: The .NET 5.0+ runtime[dotnet.microsoft.com] is required to run Puyo Text Editor and PuyoPac.
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
<color name="n" value="c">...</color>
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.
<var name="n" />
Writes the value of the variable with the specified name n.
<image 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 (&amp; and &lt; 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:





9 Comments
WANTEDFELON 8 Jun @ 5:11pm 
dude please help me figure this out "'...Common.cnvrs-text' is not a valid CNVRS-TEXT file." im trying to mod sonic frontiers text using this and im losing my fucking mind
kitifulnines 26 May, 2021 @ 12:43am 
Hey, so, I'm having an issue. I've been unable to use PuyoPac. I have .NET 5.0, I have the pac file in the same folder as PuyoPac, but the extract cmd doesn't work at all and while create does SEEM to work at first, nothing happens after I drag the file in. It just immediately closes after I hit enter and doesn't do anything. I've used the latest and earlier versions of everything, and still no luck :/
k i'll have a whiff 1 Apr, 2021 @ 11:24am 
A bit late here, but the second solution worked. Thanks! ^^
NickW  [author] 29 Mar, 2021 @ 4:09pm 
@Pomeriggio A bit late but verify that PuyoPac has permissions to access the folder your PAC file is stored in, or copy the PAC to the same folder as PuyoPac.
k i'll have a whiff 25 Mar, 2021 @ 10:56am 
I already have .NET 5.0, so I'm out of luck :|
NickW  [author] 25 Mar, 2021 @ 10:19am 
@Pomeriggio Should mention in the guide that you need to have the .NET 5.0 (or later) runtime installed to run Puyo Text Editor and PuyoPac. You can download it from https://dotnet.microsoft.com/download

The CNVRS-TEXT files are located in the appropriate text_common PAC file (see the guide). You need to extract the PAC to access them.
k i'll have a whiff 25 Mar, 2021 @ 8:37am 
One thing I forgot to add is that there are no CNVRS-TEXT files for the chapters' text, they're all PAC files
k i'll have a whiff 25 Mar, 2021 @ 6:42am 
I can't seem to make it work: when I drag a PAC file in the "extract" command file, the "extract" file instantly closes without creating the CNVRS-TEXT file.

I'm using the latest version of PuyoPac, by the way, so I don't know what to do...
セクシュアル Energy 24 Mar, 2021 @ 7:47pm 
lol cool