PC A Guide to TEdit 3

Discussion in 'News & Features' started by ahamling27, Feb 10, 2012.

Thread Status:
Not open for further replies.
  1. ahamling27

    ahamling27 Map Expert/Admin Staff Member


    TEdit 3 is a wonderful map editing program that you might have seen featured before. You might have questions about how to use it though and I hope this guide will help with your understanding of it.

    Getting Started

    First you need to make sure you have the latest version of TEdit. It's constantly being updated so go here to get the latest version. You should see a few packages and the top most package should always be the most up-to-date version. If you use this program daily, check BinaryContruct's GitHub daily as well.

    After you download the package, unzip it to a place you will remember. TEdit doesn't use an installer, once you unzip it, it's ready to go. Personally, I have a folder on my desktop named "TEdit" and when there is an update, I just clear it out and copy the new version in.

    The Menu Bar


    At the top of TEdit is the Menu Bar. Under File you can select New, Open, Save, Save-As, or Exit. Edit has Undo, Redo, Copy, Paste, a check box for Paste Empty Tiles, and Delete. The Display button which layers are being shown in the main window. The Plugins drop-down is a menu for just that, plugins. There aren't any 3rd party plugins yet, but development support is on its way. Finally, the Help menu is only there to tease you; currently it has four commands, Wiki, Update, Download New XML Data, and About, all of which do nothing, but I'm sure that will change in an upcoming patch. We'll get more in-depth with some of the menu options down below, but for the most part, they are pretty self explanatory.

    The Toolbar


    The first eight buttons on the toolbar are pretty self explanatory and most can all be found under the File and Edit menus. I won't go into much detail about these buttons except for the New button. Clicking New lets you create a new blank world with a custom width and height. The width and height can be anything from 200 blocks to the limits of a large world. There are two other sliders, Surface Level sets the level of the dirt surface and Bedrock Level sets the level the dirt stops and stone starts. The stone layer will then go all the way down to the Hell layer. The Hell layer can not be removed though and it's somewhere between 175-200 blocks depending on the size of your map. Even smaller than a Small sized map will still have some 180 blocks of hell. Keep in mind though, that a generated world in TEdit will only generate a dirt and stone layer. There is no actual hell, just the background wall of hell.


    The bottom nine buttons are the meat of the tools and therefore deserve a thorough explanation.

    Arrow Tool (Keybinding=E) - The Arrow Tool is easily the simplest tool. When you want to edit a chest or a sign, you need to select the Arrow Tool, then right click the chest or sign. The right side panel will switch over to the Chest-Sign tab and you can edit away.

    Selection Tool (Keybinding=S) - The Selection Tool has some great uses. For one, it's the main tool used to copy and paste items. Left click and hold it down then drag your to your desired selection. It's as simple as pressing Ctrl+C to copy and then Ctrl+V to paste that selection. The Selection Tool also lets you the ability to use the Paint Bucket Tool to only fill inside your selection. Finally, with an area selected, you may only edit the map within that selection. To remove a selection you can right click with the Selection Tool or press Esc or Ctrl+D.

    Picker Tool (Keybinding=R) - The Picker Tool works like an eye dropper tool you would see in an image editing program. Left clicking with this tool will pick that type of block, wall, or liquid to use with the Pencil Tool, Brush Tool, or Fill Tool. When you pick the Fill Tool you will have an option up top that says Paint Mode, by default it will only pick tiles(blocks) but you can have the picker also pick only walls, tiles and walls together, wires, or liquids. You can also right click with the Picker Tool to select a mask, which follows the same Paint Mode as left clicking. More on Masks and masking below.

    Pencil Tool (Keybinding=E) - The Pencil Tool is your basic drawing tool with a one block width. When selected you can determine what you want to draw under Paint Mode. You can draw only tiles(blocks), only walls, tiles and walls together, wires, and liquids. There is also an Eraser button above the Paint Mode selector to erase with the Pencil. Drawing is as simple as picking your tile and/or wall and left clicking and/or dragging the tool around the map. Right clicking with the Pencil Tool will lock the tool into vertical lines, so while holding your right mouse button down you can draw vertical lines no matter if you move the mouse up and down. Holding the left and right mouse button down together will lock it into vertical lines.

    Brush Tool (Keybinding=B) - The Brush Tool works just like the Pencil Tool with the exception that it can have a custom height and width. Once selected, at the top of the screen you have options for Width, Height, Outline, and shape. You also have toggles for locking the width and height equally and whether to use an outline or not. Width and Height can be toggled from 2 to 200, though if you are using the brush to paint in a large area, it is advised to use something like a 200 height and 5 width. Using a 200 by 200 brush is very taxing on the editor because you are editing 40,000 tiles at once, compared to 1,000 with a 200 by 5 brush. You can also select whether you want your brush to be a rectangle or an elliptical. The outline section allows you to use the tiles(blocks) as an outline of the brush size you have and the outline can be toggled from a width of 1 tile to up to 10. Combining tiles and walls together with the Outline tool is an easy way to place background walls within a border of tiles. The Brush Tool also paints horizontally if you right click and draw, as well as vertical drawing if you left and right click together and draw. The Brush Tool also follows masking rules and you can decide whether you want to brush only tiles, walls, tiles and walls together, wiring, or liquids.

    Fill Tool (Keybinding=F) - The Fill tool fills an area in with the selected tile, wall, liquids, or empty space if the eraser is selected. It works in a contiguous manner, meaning that it will replace all of a selected tile, wall, liquid, or empty space that is clicked continuously until it meets a border. You can limit what gets filled in by using the Selection Tool. By creating a Selection rectangle, only what's inside that rectangle will be replaced contiguously. The Fill Tool has the same menu as the Pencil and Picker Tools to determine if you want to fill with tiles, walls, tiles and walls, wires, and liquids. It will also follow masking rules.

    Pointer Tool (Keybinding=P) - The Pointer Tool determines where you want the starting spawn point, where the NPC's call home, and where the Dungeon Entrance and Old Man are. Once the tool is selected, you get the option of selecting who or what you want to place and simply left clicking on the map will place that respected spawn point there. Keep in mind that spawn points can't be placed in blocks, they must be in an open area, they can have background walls or furniture behind them though. If you want to place an NPC and they haven't been spawned in the map yet you can add them from the World Properties tab on the right side panel. Simply clicking add will add them to the map and you can place them where you please then. The Old Man pointer will place the Old Man where you make the dungeon entrance at. Keep in mind that the dungeon entrance must follow the same rules as a regular dungeon. It must contain dungeon brick, but not player placed dungeon brick. The Dungeon pointer should also be placed in the same area, possibly just inside the dungeon itself. The Old Man pointer is new and I admittedly don't know if you can place the Old Man away from the dungeon and keep him there. I would imagine that he might load up where you pointed him to, but he would make his way back to the dungeon entrance anyway.

    Sprite Placer Tool (Keybinding=T) - The Sprite Placer tool is used in conjunction with the Sprites tab in the right side panel. Once you have the Sprties tab open on the right, it's as easy as selecting your sprite then clicking the Sprite Placer Tool and then clicking where you want it on the map. The Sprite tab on the right side panel also has a search option. In the Filter box, type in what you are looking for(it will even take partial spellings) and either click the Filter button to the right or press the Tab key to search for it.

    Morph Tool (no keybinding yet) - The Morph Tool is a relatively new too. It works much like the brush, but instead of drawing with it, it will morph whatever you are drawing over with the selected biome. It will even work differently at different depths. It leaves tiles like ores untouched but will add the right kind of grass to the surface of the biome.

    Masks and Masking

    Masking is changing a certain tile and/or wall from one type to another, without changing any surrounding tiles and/or walls. In the example below, I want to paint mud over dirt, but I want to keep the sand from turning into mud.


    The Mask Mode has three options to it. Disable Mask turns masking off. Edit Empty Tiles is a little confusing. If you have a complete empty space void of tiles and walls, you can paint there with Edit Empty Tiles selected. If you only have tiles painted and you select Edit Empty Tiles for the wall mask, you will still be painting walls behind the tiles because the wall space is empty. Conversely if you select Edit Empty Tiles for the tile mask and have a bunch of walls drawn, you will still be able to paint over those walls with tiles. Remember they work independently of each other. If you are super confused at this point, just play around with tiles and walls with different masking tools and you will get the hang of it pretty quickly.

    Edit Matching Tiles is what the example above shows. The Mask selected under Edit Matching Tiles will be the only tile/wall that can be painted/drawn/filled over. Masks work with all the painting tools, the Pencil, the Brush, and the Fill Tool. This is a great tool for when you build something but hate the color you used. Built a giant green tower but now want it blue? Just select blue brick as your tile, enable Edit Matching Tiles then select green brick as the mask. If you make the size of the brush like 200 by 5 you can paint that green brick blue in seconds. You could even set a mask for the background walls and change the tiles and walls in a single swipe of the brush.

    Display and Plugins

    Under Display in the Menu Bar, you can change what is being displayed in the main editing window. Your options are Show Textures, Show Grid, Show Walls, Show Tiles, Show Liquid, Show Wires, and Show Points. They are all pretty self explanatory and in the picture below you can see what it looks like when you deselect Show Tiles.


    Plugins are relatively new to TEdit. Under this menu you have two plugins to choose from, Settle Sand is pretty self explanatory, and the other is Simple Ore Generator. Simple Ore Generator does exactly what it implies. If you generate a world in TEdit you get a pretty plain dirt and stone world. Once it's generated though, you can add ore and other tiles using the Simple Ore Generator. In the picture below you can see from left to right I'm adding in new ores and even mud, clay, and sand. The generator is meant for ores but can actually generate any tile, but they'll be in shapes and sized like ore would be found. Here's a picture of the generator in action, each subsequent frame is another ore, tile, or liquid being added to the map. If you ask me, it's pretty good at what it does, considering the Simple Ore Generator is one of the newest features of TEdit.


    World Properties Tab

    The World Properties Tab in the Utilities side bar contains some useful variables that you can customize to make your world unique. I'll break this up into two sections, the top half and bottom half of the World Properties tab. Here's what the top half looks like:


    Starting from the top, World Name is whatever you want to name your world. Your worlds folder always has maps labeled world1, world2, etc. Making the world name unique will help you pick it out quicker and stop you from opening the wrong map. Next up is the World Id and currently you can not edit this. Not much is known about this number as BinaryConstruct has no idea what it actually does.

    Up next is a check mark for Blood Moon. Enabling this will cause your world to spawn a Blood Moon when it's loaded the next time. Under that is a slider for the Moon Phase. You can change this from a value of 0 to 7. Terraria has a moon cycle just like the real moon, it goes from a new moon to full moon and back again.

    Up next is the time of day. A slider that is colored to match the lighting of the game can be set to whatever time you want. The check box below it determines if it is day time or night time.
    The Surface Level and Bedrock Level sliders are up next. They are the same sliders that are in TEdit's World Generator. They change the topmost dirt surface level and the level where the dirt meats the stone level. Adjusting these sliders also adjusts the default background walls underground. This can be useful when you want to get rid of background walls and let some light in deep underground for a custom adventure map. You can always fill in your own dirt walls if needed underground as well. Furthermore, if you pull the sliders all the way to the right(the highest values) the default background walls will be completely removed. I believe they are hidden behind the default hell background that cannot be altered or removed.

    The next section contains a couple check boxes and two sliders. Checking the Meteor box will cause a Meteor to spawn at the next appropriate time after the world is loaded into Terraria. The Difficulty check box can turn your world into a Hardmode world. Keep in mind that TEdit doesn't add hallow or corruption into your map, so just checking this box will flag it as hardmode but if you want hallow and a larger corruption biome you must add those tiles in yourself. Although Wyverns and other non-biome specific hardmode enemies will spawn after this box is checked. The next slider determines how many Altars have been smashed. This can be set from 0-3. This determines how many of the new ores are generated, but since these are enabled in an editor and not in-game, the new ores won't be generated. Orbs smashed works the same except it counts how many Shadow Orbs have been smashed. If you set this to anything but 0 you then have a chance for a Meteorite to spawn.

    The Bosses Downed section contains all the bosses and whether they have been defeated or not. If the Eye of Cthulhu is checked, the game will allow the Dryad to spawn and move in with you, but if it is deselected the EoC has a chance to spawn naturally if your character meets the right criteria. If Eater of Worlds is checked, I don't believe there is any difference, except that if you haven't defeated the Eye of Cthulhu yet the Dryad can spawn and move in with you. If you check Skeletron Downed the old man will be removed from your map and you can access the dungeon. You can load up a map that has defeated Skeletron already and deselect this box, doing that can enable the Old Man to come back and you will be able to fight Skeletron again. If Clowns Downed is checked the Clothier will start selling the clown costume. If Frost Legion Downed is checked and you load the map during the holiday season, Santa Claus will move in to your home, if you have a spare room. Finally, if Goblin Invasion Downed is checked the Goblin Tinkerer will spawn on the map for you to save.

    Here is the bottom half of the World Properties tab:


    These sections deal almost entirely with NPC's, with the Invasion Type being the exception. NPC's Saved are boxes that will cause the respected NPC to be able to spawn in the map. Checking these will allow you to place them in homes you made. Now, the really cool part. If you don't have the NPC's Saved boxes checked, and you add one of those NPC's to the map they will sit there all bound up, ready to be saved! This is really neat for custom map makers. You now have the option to set these 3 NPC's in your map, ready to be saved.

    Invasion Type will add an invasion to your map when you load the map up in Terraria. Currently there are two options, Frost Legion and Goblin Invasion. Actually enabling Frost Legion will spawn their invasion regardless of whether it's the Holiday Season or not. Invasion size will set the size of the invasion you can have as little as 1 enemy or 1000 enemies. Oddly enough there is a setting for 0 enemies. Invasion X Target sets where the invaders start coming from, not where they migrate too. The invasions will always migrate towards the natural spawn point of the map. If you set the natural spawn point far away from the center of the map, you might have a hard time getting the invasions to show up. Both invasions prefer to invade closer to the center of the map.

    The next section is where you can name each NPC and add them to the map if they haven't naturally spawned yet. When adding them for the first time TEdit will set them at your spawn point. You can always change this with the Pointer Tool. Adding the Goblin Tinkerer, Wizard, and Mechanic to a map where they haven't been saved yet will cause them to spawn all tied up, ready to be saved. As mentioned earlier, this is a nice addition for adventure map creators.

    Clipboard Tab

    The Clipboard Tab saves everything you copy here. There are three options on top, Empty Clipboard, Import Schematic or Image, and Import False Color Image. With a check box for Paste Empty Tiles. If you deselect Paste Empty Tiles, you can paste objects and leave out the empty space. If this is checked, the empty space will get pasted, overwriting whatever you are pasting over. It's very helpful for pasting structures into new maps without disturbing the area around the structure.


    Empty Clipboard is pretty self explanatory, except that in the build I was using and the most current version as of the day this was published, it was greyed out and unusable. You can always just click Remove under any clip in the clipboard to remove them anyway.

    Import Schematic or Image is a very useful tool for map makers. Underneath each clip you can click Export and that allows you to save clippings outside of the editor to be imported into another world or just saved for a later date. You can also share Schematics and there are a couple threads on TerrariaOnline.com that have shematics people are sharing.

    Import Schematic or Image also allows you to import an image that uses the same color scheme as TEdit as a schematic. The editor will convert the color of the image into the appropriate tile. This works if you take a screenshot of something in the editor and then load it in as a schematic. Watch out for scaling problems though, depending on the scale of the image, it might not scale exactly the same as the way it was made to be. The image imported must be a 24 bit PNG as well.

    Import False Color Image is something that I don't fully understand. It's complicated but if you must know how it works I will point you to the official TEdit Wiki here. That link should explain it to you, and if you still don't understand it, don't worry.

    More Information

    You can go here for a complete list of Shortcuts and Keybindings. There are lots of shortcuts from clearing selections, to zooming in and out if you don't have a scroll wheel on your mouse.

    You can also go here to learn how TEdit manages your save files. TEdit makes it's own backups of worlds edited through TEdit and you can go there to learn more about that.

    More information can always be found at the official TEdit Wiki here. The wiki is a little outdated, but most tools work as mentioned and only the newest features of TEdit 3 are left out. More importantly, just messing around with TEdit will teach you the most about how it works. Sure TEdit has some quirks, and there might be a few bugs here and there, but overall TEdit is an amazing tool with some awesome potential to make some great maps.

    As always, you can find the most up-to-date version of TEdit here.

    TEdit is an open source project being hosted at GigHub.com. If you want to help with development check out TEdit's GitHub page here.

    Of course, none of this would be possible with out the awesome work of BinaryConstruct for developting such an awesome tool. Big thanks to Aimeryan who works on the TEdit Wiki and Kyphis who works on schematics. Big thanks to SineSwiper for his work on XML settings and Heathtech for his work on Wall, Tile, and Tree textures.
  2. Blue Lit

    Blue Lit Spore Zombie

    best thing for custom maps...

    Edit: 1st post, viewed it within the 1st min it was posted on the front page!! :L
  3. Seth Core and Clarence

    Seth Core and Clarence Eskimo Zombie

    I used this to make my maps and I knew 7/8ths of whats in this guide.
  4. Deathrogue

    Deathrogue Cursed Man

    Awesome guide, awesome avatar.
    ahamling27 likes this.
  5. Seth Core and Clarence

    Seth Core and Clarence Eskimo Zombie

    oh follow e FOLLOW ME!

    and by the way are you making any more maps and is the mini map coming soon?
  6. Twiganator12

    Twiganator12 Yellow Slime

    this is amazing im using it to make a infected map for Psisyndicate
  7. BinaryConstruct

    BinaryConstruct Lava Slime

    Novate, Cauthos and ahamling27 like this.
  8. Asaroki

    Asaroki Green Slime

    Nice guide ahamling. It'll help me find new things i didnt know about tedit.
  9. RainWanderer

    RainWanderer Unicorn

    Note: Although you mentioned "paste empty tiles" you didn't explain what it is for users. I have seen many people forgetting this awesome feature: It let you paste something from the clipboard, but ignore the empty tiles (no wall/blocks tiles). This is particularly useful to paste structures with minimal damage to the original terrain.
    Cauthos likes this.
  10. Deanthelis

    Deanthelis Eskimo Zombie

    Color Key:
    Capitalization, punctuation
    Optional, but helps
    Editor's Notes

    I feel you may want an editor. Just a friendly suggestion.

    That was fun. We should do this again some time.
  11. ahamling27

    ahamling27 Map Expert/Admin Staff Member

    Thanks for pointing that out, I'll get in there ASAP. I knew something would fall through the cracks though, it's a long read. :D
  12. Deanthelis

    Deanthelis Eskimo Zombie

    *Prepares to edit*
  13. ahamling27

    ahamling27 Map Expert/Admin Staff Member

    Thanks! I did have 2 others read through it as well as myself. It's a long read and easy to miss things. You should be an editor though. :p
  14. mellsbells

    mellsbells Green Slime

    I've been using Tedit for some time, and this is still extremely informative! Great going <3
    Cauthos likes this.
  15. Deanthelis

    Deanthelis Eskimo Zombie

    Send me things before you post them if you like, I'll happily edit away.
  16. XoGenius

    XoGenius Doctor Bones

    Amazing guide ahamling! My knowledge of this program has improved by alot! :)
  17. BinaryConstruct

    BinaryConstruct Lava Slime

    This was a bug, see below.

    Here are the layer heights that hardcoded:
  18. Deanthelis

    Deanthelis Eskimo Zombie

    Editing my post now.

    Just wondering-How goes the plugin support? I'm looking forward to making a few things. I've played with world gen a fair amount, and I'm currently working on version of dungeon generation to cover the whole map; it would be better suited as a dungeon generator plugin, don't you think? I'd probably do the Hell buildings afterward.
  19. oliveorange

    oliveorange Green Slime

    Where has this magic been all my life? ;A; <3
    I need to look into using this; it really looks promising! <3
  20. BinaryConstruct

    BinaryConstruct Lava Slime

    Once I finish plugin gui support I'll add a sample plugin project to GitHub. You will be able to use this project as a template to create your plugin content.
    ahamling27 likes this.
Thread Status:
Not open for further replies.

Share This Page