*updated*
Hey Folks :)
Want to enter your dungeon with you own portal in town?
This is the „right“ way to create a custom map, connected with a portal. There are some ways around here about adding a few lines to the rules-file, but the data is always too specific.
But the other threads may help with other problems, so here are the links:
Here you'll learn how to help TorchEd completing its mission ;)
- First of all create your dungeon layout and a portal. You may be interested in the official tutorial located in \TorchED\DocsToolsAndTutorials\DungeonCreation\
Note: I'll create the "right" dungeon and rules files in this tutorial!
In this tutorial I'm using the Crypt palatte (so my Dungeon Layout is located \media\layouts\crypt\mymod\mymod.layout).
i don't know if it's important or necessary to use a special group (you don't have to use only the objects of one palette) - i've chosen the crypt group because my level looked like the other crypt ones ;)- At this point my Mod-Directory looks like this:
- MyMod\mod.dat
MyMod\media\layouts\crypt\mymod\mymod.layout(My Dungeon Layout)
MyMod\media\layouts\town\1X1SINGLE_ROOM\Merge\MyTownPortal\myportal.layout(The Portal)
During this tutorial we are (or better TorchEd is) going to create:- MyMod\media\dungeons\mymod.dat (The Dungeons File)
MyMod\media\layouts\crypt\mymod_rules.dat (The Rule Set) - Let's start: Open your dungeon layout and open the Dungeons Tool
→ Data Editors → Dungeons
Create a new entry for your dungeon by clicking on the green + symbol.
Name the file and save it (don't change the path – it has to be located in \media\dungeons\).
Now you have to fill in a dungeonname. Use lowercase letters and no special characters. You have to use this name in the portals Warper-Properties as Dungeon Name!
Enter also a Display Name and as Parent Dungeon fill in the word Town.
After this, add at least one Strata (one for every dungeon level).
- Switch to the Rule Sets tab and create a new rule (don't clone) by clicking the green +.
On the left, select the fitting entry – in my case it was [...]/crypt and as a filename enter for example “your dungeonname”_rules and TorchEd will save it there: \media\layouts\crypt\
Okay now select your new Rule Set and fill in a Name (I used the dungeonname again) and a Display Name. Select a skybox of your choice (media/skyboxes/crypt/crypt_sky.mesh for example) and uncheck the Randomized and Requiere Exit Boxes and set the Camera Dist to 1.
Note: of course you can also change other options in the rule set (like adding music), i only mentioned the important ones
- Select the ChunkTypes Tab and click on the left Modify button below the first empty box. Now add an entry, I took the 1X1SINGLE_ROOM and click Ok to close this window again. Select the entry in the left box (1X1SINGLE_ROOM for example) and open the pull-down-menu in the middle. Select your folder that includes your dungeon layout. As mentioned above my layout is located in \media\layouts\crypt\modname\dungeoname.dat so I had to select MODNAME as folder.
After this step, click on the right Modify button and add your listed dungeon layout.
Max Appearance has to be 1, if there is only one strata in your dungeon - i'm not sure what this option does or when you have to increase it, but with only one strata and a value of 10 here, the portal leads me to another level o_O - i guess it has to be the number of ChunkTypes or the number of layouts per ChunkType. All in all, set it on 1 ;)
Note: The last steps created some TorchEd error exceptions so I had to restart the DungeonEditor Tool after adding the ChunkType 1X1SINGLE_ROOM on the left, but after the restart (don't forget to save your Rule and Dungeon Set!) it worked. - Before continuing, switch back to the Dungeon Tab and select your created file and there select your Strata. On the right side add as Rule Set your new created Rule Set from the list. So you can't forget this step! :)
Turn back to your Rule Set and continue: - Now select the Layout Tab of you Rule Set and right-click in the middle of the grid and select your ChunkType (in my case 1X1SINGLE_ROOM). This is the point TorchED often fails.
As you will see, TorchEd can't save this step. Try selecting another rule after saving yours and select your Rule Set again. Is the Layout saved, congrats – your portal should work now :)
But in my case and the cases a lot of other users here, TorchEd didn't save the Layout.
So don't start copying some code into your Rule Set file like it's mentioned in some other threads because it's code that doesn't suit to your project. Help TorchEd to help itself. - Open your file-browser / windows explorer and locate your Rule Set file (in my case: \media\layouts\crypt\dungeonname_rules.dat). Open this file with a simple text-editor of your choice (Windows Notepad oder Notepad++ for example).
Add the following two lines BEFORE the last line [/LEVEL]:- Code: Select all
[LAYOUT]
[/LAYOUT]

- Save and exit your editor. Now return to the Dungeons Tool of TorchEd (reopen if it was opened) and select your Rule Set again. Switch over to the Layout Tab and now right-click in the middle of that grid again and select your Chunk Type (in my case 1X1SINGLE_ROOM). Save and now it should be saved forever. ;)

Try selecting some other rules and switch back to your rule, it should be saved now, otherwise you made a mistake editing the file. In this case delete your Rule Set and start again with a fresh one :) - Now everything should work. Save all your data and start Torchlight. Create a new character and in the town, search for your portal, click on it et voila, your dungeon!
Note: You may delete every file ending *.adm or *.cmp in your Mod-Folder and it's subdirs - that are some type of cache files and sometimes Torchlight didn't refresh some data while these files existed
kind regards
Asto
[Note: maybe i'll create a video tutorial about this including the portal and map creation - but i need a better screen capture tool ^^]
PS: Found a grammar mistake? The English language isn't my native one. So feel free to contact me via PM about mistakes. ty :)
