Sign in to follow this  

T-Edition - English Lua Version (requires: Windows/Wine, snes9x-rr)

2 posts in this topic

Welcome to T-Edition - English Lua Version (or "T-Edition Lua" for short), a project four whole months in the making. This project aims not to be the most comprehensive version of T-Edition in English, but merely a stopgap measure to make the game playable while those more experienced continue their labors. However, make no mistake, the game is fully translated and playable now, as long as you don't mind using a specific emulator.

You can discuss the game and your playthrough on the New Game Plus Discord in #ff6-t-edition.
Do not discuss anything technical about the Lua in that channel. It is exclusively for game (and the real translation project) chat.
If you need to discuss the Lua, #scripting-development is the channel for that. See FAQ below for info on minor text corrections, or ping @Serity for critical issues.
As a rule of thumb, if it's about something that uses the menu's 8x8 font, that's the rom-hack.
If it isn't in the main menu, and it involves the variable-width font as seen in below screenshots, it's the Lua.

What is T-Edition?
Rather than rehash this topic, I'm going to just point you to Poemato's excellent overview of T-Edition, though note that Poemato (and that webpage) are not associated with the Lua project.

About the T-Edition Lua Project
Started in February 2020, the Lua Version uses the American GBA script of FF6 as a base, then, using a mash of Poemato's and Kain Stryder's playthrough videos, as well as manual- and (heavily edited) machine-translations, updates the rest of the new content that Tsushiy added to be in English. It also translates all combat messages and events, combat skill and spell names, map names, etc. to provide a near-complete English experience. EX Mode is supported, though note the caveats in Information to Know below. Item descriptions are not translated in-game, but an emulator overlay is displayed with the same information.

As the title of this thread implies, this version is only playable on Windows or Windows emulators (such as Wine), with use of the snes9x-rr emulator. This is because snes9x-rr supports Lua scripting, which is the tool of choice I used to manipulate the game as it is running to have the game display specific text at specific times. Other emulators, such as Bizhawk, do support Lua scripting, but they don't support the functions necessary to perform this kind of task. Snes9x-rr is only available for Windows, so you won't be able to play this on your (non-Windows) phone, Game Boy Advance, or other device that doesn't support Windows, unless it's able to emulate the OS, such as Wine for Linux.

This Lua script builds on top of the translation work (".ips" or "T-Edition English") that Lazarus and Kain have been working on, but is not associated with them. Their work currently encompasses the menus, in-combat and out-, and includes the English font that this script piggybacks off of to display its text. Without them, there wouldn't have even been a start to this Lua script, so make sure you give shoutouts to their work as well!


  • Snes9x-rr is required. Acquire that at their Github - this Lua script was developed using version 1.60 and may or may not fully work on later versions.
  • The T-Edition English patch is required. Acquire that at Kain's forum post.
  • The latest version of T-Edition Lua can be found here, which is currently Version 1.01. You can check your version at the top of the Lua's readme.txt. Minor text edits may be posted there without a version change.
  • To update, simply extract the new .zip where you extracted it previously - there's no need to re-patch the ROM, only the Lua file has been modified.
  • For the T-Edition Lua changelog, see the second post in this thread or readme.txt.


  • Installation instructions are in the readme.txt included with the Lua script. It will also cover many of the same points that are posted below.
  • There are separate install instructions for EX mode in the Lua's readme.txt, and you will need a Japanese unheadered ROM.
  • Check HTML/Readme.html within the T-Edition English's .rar for bugs/FAQ about T-Edition itself, or the "readme translation.txt" in the same location for details about Lazarus and Kain's .ips project.
  • Changes from Vanilla FF6 are mostly documented within HTML/_index.html in T-Edition English's .rar. Check there for any gameplay questions you may have!
  • Current saves from other emulators should be supported (untested), as long as you copy the .srm to snes9x-rr's saves folder before starting up the emulator.

Information to Know

  • Use snes9x-rr's Rewind function with great caution. The Rewind feature does not also rewind the Lua state, so if you Rewind to the middle of a text box, problems will happen, up to and including game crashes. If you must Rewind, make absolutely sure you do not stop Rewinding until there are no text boxes remaining on the screen.
  • Unnamed characters ("??????" names - Terra in the intro, unnamed characters at the Costume Change) will have their names display as blank due to the missing large-? character in the English fontset. This is a minor, ignorable problem that will be solved once those characters are named.
  • EX Mode support requires a japanese ROM and includes an English .ips patch that heavily borrows from Lazarus's work in order to have matching item and enemy names. It is not supported by them, and is extremely lackluster in comparison (for example, "Eqp" instead of "Equip" in the menu) and will have untranslated text scattered about. It is included for the sole purpose of making the mode playable, and anywhere that there is untranslated text, if you've reached EX, you should know by now what it says. Do not contact the .ips project about anything related to this Lua's EX Mode.


Q: Why is there a frame counter on my screen?
A: Press [.] by default to turn it off. Check your [Input => Customize Hotkeys => Movie Frame Count] hotkey if this doesn't work.

Q: My controller won't work!
A: Start or restart snes9x-rr after plugging in your controller - the Detect Gamepad Changes option doesn't always work. Make sure that "use SNES joypad(s)" is selected in the Input menu and that Joypad #1 is enabled in [Input => Input Configuration]. Check your "Joypad Swap" button as well - [6] by default will switch your main input between player 1 and 2, but it can be changed on page 2 of [Input => Customize Hotkeys].

Q: What is EX Mode?
A: Check HTML/EX Readme.html within T-Edition English's .rar for more details, but tl;dr is at a certain point in the game you have the option to swap your save file over to a different ROM to take on twelve new bosses (and nothing else, because you can't leave the room).

Q: What's this about Wine for Linux?
A user has reported that Wine, an Windows emulator running on Linux, runs snes9x-rr just fine, albeit with some ignorable warnings in the log. However, as I don't use Linux, I'm unable to offer any support with setting up or using Wine, sorry!

Q: I just got item X, why can't I find it in my inventory?
A: Updating to 1.01 will make item names between the game and the Lua match. Besides that, due to a T-Edition bug, some accessories may be sorted near the top of the item list, with the first few weapons. Also, it may be a key item, so check there, too. Prior to 1.01, the .ips patch and the Lua translation used different translations for some item names or spells, so the name in the item list might not have matched the "obtained" messages.

Q: A weird effect happened when I used a consumable in battle!
A: This is a T-Edition bug. Check HTML/Readme.html for more details. This happens when specific accessories are visible in the menu when you use an item in battle - fix it by manually sorting the problematic accessories further down (auto-sort will put problematic ones near the top of your list), or don't scroll the item list down far enough to see them in view. This may be especially noticeable early game with the Black Belt.

Q: What's up with the garbage item descriptions?
A: Lazarus's current project is inserting them into the .ips patch. As a result, to avoid overlap of work, I've chosen not to include them in the text boxes in the Lua version. However, in the meantime, to prevent players from having to necessarily cross-reference the documentation constantly, the item descriptions have been included as a small overlay at the bottom of the screen in the Item, Equip and Relic menus. If you don't see them, make sure [Display Message Before Applying Filters] is checked in Graphics options.

Q: I unlocked a costume but it won't show up, what gives?
A: T-Edition doesn't always process costume information right away. There are two reasons you may not get access to your costume. Firstly, you must unlock costumes for a character in order [First => Second => Third => Fourth]. If you unlock the third costume but not the first, you won't have access to any costumes for that character. Secondly, you may have to walk into the Achievements room in the Narshe Adventuring School before the game processes and updates it.

Q: This text is misaligned/the opera is a bit out of sync/there's some weird spacing errors/the dev room music menu is kinda weird/etc.
A: First of all, honestly, thank you for your interest in improving the project. I wouldn't have made it this far without players testing and proofreading. Second of all, I don't care. Well, that's not accurate, I do care, but at this point, for the most part, this project is pretty much done, unless some terrible reproducible glitch is found, since the primary intent is to make the game playable. Thirdly, the Opera is a very timing-specific mess due to the automatic text advancement and speed that the text displays on screen. It currently works without getting the player stuck, and I do not want to touch it ever, ever again.

Q: I'm getting slowdown if I run the Lua script that's not there if I disable it!
A: Unfortunately, the Lua script adds a lot of hooks and code that the emulator is checking for and constantly running. You may experience slowdown on weaker computers, and in particular, the Fast Forward feature won't go as smoothly as you may be used to since the game has to also execute the Lua code. Other functions such as the Memory View or RAM Watch may cause slowdown as well. Feel free to click "Stop" in the Lua window if you wish to use Fast Forward at maximum speed without caring about the text, for example when grinding levels or achievements, then click "Restart" when you are ready to use the Lua once again.

Supplemental Info and Downloads

Rage List Sorted by Effect - Find this .txt file here. LamiaQen is (as of this posting) in the rage list of the .ips twice by accident - the one in the "B"s section is "B. Lamia".

Costume Unlocker Cheat - Extra .lua script in order to unlock all costumes from the start of the game. Suggested only for a second playthrough without New Game Plus. May irreversibly alter or hinder achievement progress. Presented without warranty or support. May prevent you from actually unlocking costumes. Download it here and read the text at the top of the .lua file (open in any text editor) for instructions and what it actually does. Only unlocks the costumes while it's running unless you modify the setting near the top of the .lua to be permanent.




Edited by Serity

Share this post

Link to post
Share on other sites

1.01 - May 29, 2020: Updated all item names to match the in-game names. Removed expanded chest name option and just displays full name by default. Updated dialog to reflect new names. Some names are incorrect (such as Heiji's Club) but are named as such regardless to match the game's names. For full list of item name changes with explanations, see
1.00a: Fixed a missing choice in the EX portrait room.
1.00: Initial release.

Edited by Serity

Share this post

Link to post
Share on other sites

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now
Sign in to follow this