Lang File Introduction
The language file (lang) is a file in which all text in NT is referenced and thus can be freedly edited by the player.
In order to edit the text, these steps must be followed:
- Make sure Nuclear Throne Together is installed correctly. (Follow the 'readme' file)
- 2023 Beta & NTT Development should include lang-example by default, so the external NTT install is not necessary.
- Once installed it will include a file called 'lang-example', which includes all the text seen in-game.
- Open lang-example with any text editor program and make any changes as desired, using the guide below.
- Once finished, save the file as simply 'lang', NOT 'lang-example'. The example file is meant to be the placeholder in case anything goes wrong.
- The file will be saved as lang.ini, however some players without file extensions showing may accidentally save it as 'lang.ini.ini', which the game will not recognize.
- NT can now be loaded with the new edits in place. Make sure to create a save backup.
Lang edits are incredibly easy to modify following those simple steps, and thus are the most common edits that players make to vanilla NT. If wanting to use it in NTT run the command '/loadloc lang' and it will use the same file.
Lang File Editing
The lang file is split up into categories defined by text within brackets. Any text in the lang file can be edited, however only things AFTER the = (equal sign) should be modified as that is the text that appears in game - everything before is classification that directs the game on when to display.
Text can be highlighted with certain colors. Start the desired text with @ then a letter from below to change its color. @s is often used to 'end' the highlight there, but really just resets the color to the default used(Silver). Multiple colors can be used within the same line.
- @s for the color silver (default color)
- @d for the color dark gray
- @w for the color white
- @r for the color red
- @b for the color blue
- @g for the color green
- @y for the color yellow
- @p for the color purple
There are a few other non-text effects too which can be done. These may not work for every part of text editing, but definitely will for loading screen tips:
- @q will make text shake and is used for cursed weapon screen tips. @q can be stacked multiple times for increased shakiness.
- @0 for a weird fish symbol.
- @(sprite) inserts a sprite into the text. A full list of sprites can be found here.
- A more in-depth guide on how to add sprites can be found here, as well as other more complex editing options.
- # can be used as a line break, but only if the entire line is surrounded in quotation marks e.g. "A BARE HEAD#IS A FAIR HEAD"
The (likely modified) 'Press Start' font is used by any text in-game, however it is a font that only supports base ASCII characters, so any text edits using other unicode will not appear in-game. Only 'Press Start 2P' font supports other unicode which is often used in fan projects, but not within NT itself.
Adding additional lines for more screen tips within categories will ONLY work in 2023 beta onwards. Trying to add it to older versions will not register the extra lines.
To add an additional tip simply make a line break, copy the line above pasting it on the new line, and increase its listed number by one.
Lang File Categories
Here are some the categories in the lang file that can be edited. Any of these can be quickly jumped to by going ctrl+f in the document and then pasting any category below, such as copying [Skills] to quickly jump to the mutations section. Categories are not in order of how they appear in the lang, and only ones especially relevant to editing are included.
- [Races] refers to mutants.
- Name, Passive & Active are all seen from the character select screen.
- TB & Ultras are shown during mutation select screens.
- (Mutant ID 0 is for Random, co-op ultras are stored under the same ID separately)
- Text seen during level transitions:
- [Tips] includes most screen tips, which appears during level transitions.
- (Grouped screen tips for Skills, Crowns & Weapons are all listed in their respective categories.)
- [GenCont] is the loading screen text.
- Text seen in game:
- [Weapons] will list all the weapon names upon walking over them and their screen tips. Not all weapons have screen tips by default.
- [Ammo] specifies the ammo type whenever ammo is gained.
- [HUD] is for on-screen text when on low/no pickups, and other misc. elements.
- 0 is Melee, 1 is Bullets, 2 is Shells, 3 is Bolts, 4 is Explosives and 5 is Energy.
- [Pickups] is used for the on-screen text when at full pickups, and changing what numbers appear when gaining pickups visually.
- [Bosses] is the text that appears during boss intros, if toggled on.
- Text seen on selection screens:
- [Skills] is for mutations. It includes the name/text on the mutation select screen, as well as their screen tips.
- [Crowns] similarly lists the name/text on the crown select screen, as well as their screen tips.
- [LevCont] is all the other text that appears on mutation/crown select screens and level up text.
- Text seen on the pause menu:
- [PauseMenu] is the menu navigation buttons seen on pause.
- [Area] is the current area that appears on the pause menu and game over/victory screens.
- [ModeNotice] is to signify special runs on character select and the pause screen, such as hardmode.
- Text seen on the game end screen:
- [GameOver] includes all of the text seen on the game over and victory screens.
- [CauseOfDeath] is used on NTT where on the game over screen where the death source can be hovered over to see its name.
- Text seen on the main menu:
- [MainMenu] is for all the buttons on the main menu.
- [PlayMenu] is the second menu pulled up upon hitting the 'Play' button.
- [Stats] is used for everything seen in the stats menu. The actual numbers can only be modified via save editing.
Screen Tips Classifications
Here is a list of the requirements for each screen tip to appear in game and how many tips are assigned to each category by default:
Screen Tip Classification |
||
---|---|---|
General | Appears anywhere | 51 Tips |
Tutorial | When playing the tutorial | 4 Tips |
Daily | When playing the daily | 6 Tips |
Weekly | When playing the weekly | 5 Tips |
Hardmode | When playing hardmode | 8 Tips |
Coop | When playing co-op | 12 Tips |
Curse | Holding a cursed weapon | 5 Tips |
Low | When below 4 HP | 5 Tips |
Loop | When in loop | 8 Tips |
Tip Groupings |
||
Areas | Being in a specific area | 67 Tips |
Races | Playing as a specific mutant | 112 Tips |
Ultras | Having either ultra on a character | 49 Tips |
Skills | Having a mutation | 29 Tips |
Crowns | Having a crown | 16 Tips |
Weapons | Primary weapon held | 116 Tips |
Area # | Area Name | Tip Count | Area # | Secret Area Name | Tip Count |
Area:0 | Campfire (Loop) | 3 Tips | Area:100 | Vaults | 1 Tip |
Area:1 | Desert | 7 Tips | Area:101 | Oasis | 4 Tips |
Area:2 | Sewers | 8 Tips | Area:102 | Pizza Sewers | 2 Tips |
Area:3 | Scrapyards | 8 Tips | Area:103 | Y.V.'s Mansion | 4 Tips |
Area:4 | Crystal Caves | 6 Tips | Area:104 | Cursed Crystal Caves | 4 Tips |
Area:5 | Frozen City | 6 Tips | Area:105 | Jungle | 4 Tips |
Area:6 | Labs | 3 Tips | Area:106 | IDPD HQ | 0 Tips |
Area:7 | Palace | 2 Tips | Area:107 | Y.V.'s Crib | 5 Tips |
Race | Mutant | Mutant Tips Count | Ultra Tips Count |
Race 0 | Random | 7 Tips | 1 Tip |
Race 1 | Fish | 6 Tips | 2 Tips |
Race 2 | Crystal | 2 Tips | 2 Tips |
Race 3 | Eyes | 5 Tips | 3 Tips |
Race 4 | Melting | 6 Tips | 2 Tips |
Race 5 | Plant | 7 Tips | 1 Tip |
Race 6 | Y.V. | 16 Tips | 9 Tips |
Race 7 | Steroids | 8 Tips | 2 Tips |
Race 8 | Robot | 7 Tips | 4 Tips |
Race 9 | Chicken | 8 Tips | 3 Tips |
Race 10 | Rebel | 9 Tips | 2 Tips |
Race 11 | Horror | 8 Tips | 3 Tips |
Race 12 | Rogue | 6 Tips | 3 Tips |
Race 13 | Big Dog (Playable) | 2 Tips | 3 Tips |
Race 14 | Skeleton | 4 Tips | 3 Tips |
Race 15 | Frog | 9 Tips | 5 Tips |
Race 16 | Cuz (Unused) | 2 Tips | 1 Tip |