Brad Wardell's views about technology, politics, religion, world affairs, and all sorts of politically incorrect topics.
Published on July 29, 2010 By Draginol In Elemental Dev Journals

Starting with beta 4 of Elemental, the modding tools for the game have begun to be made available.

This article will serve as a very very basic primer on how modding works in Elemental. 

During the beta process, the team will try as much as it can to help users learn what can and can’t be done with the existing modding tools. Those who need a lot of hand holding should probably wait until after release since the team will have very limited time available to document what is what until post-release.

That said, the basics are fairly straight forward and I’ll go through them here.

The Legal Stuff

To get this first part out of the way, all of the content that comes with Elemental is copyrighted by Stardock Entertainment. We spent a lot of time and money producing the content that comes with it.  You may not distribute this content to be used for non-Elemental related purposes. As you go through the Elemental folders, you will quickly see why most games restrict what is readily accessible. We ask modders to respect the artistic effort that went into creating these assets.

The Formats

Elemental is very data-driven. What this means is that the game itself contains very little “hard coded” content. This is the basis of what makes the game easy to mod.

The formats we use are:

XML. This can be read in with a plain text editor. Nearly everything in the game is XML. Our editors output to XML.

PNG. This is a popular graphics format used on most web pages. We use it everywhere for static images.

MP3. For songs in the game, we use MP3, a popular audio format.

WAV. We also use WAV files, a popular sound format for sound effects.

DXPACK. This is the format that DesktopX uses (www.desktopx.net). We use it for all of our user interface related elements.

HKB. This is the Havok format. The Havok site has a free exporter for it to use in 3D Studio or Maya or what have you.  However, you will need our converter to use it with Elemental which we’ll be releasing shortly.

The Tools (as of Beta 4)

We include two of the tools with beta 4. The Map Editor and the Tile Editor.

In Beta 4, when you choose one, you have to wait until it loads all the data (we’ll add a fancy load screen later) so at first you’ll be looking at a black screen for a bit.

The Tile Editor

image

Use the middle mouse button (holding it down) to adjust the rotation of the screen. Hold the left mouse button down to move the screen around.

image

image

 

image

For Beta 4, just save your tile.

The saved tile goes to your my games folder in documents (documents\my games\elemental)

image image

Opening up your tile in a text editor just shows its XML:

image

In Elemental, file extensions mean very little. The game goes by XML keys (<TileDesigns> in this case).

The Map Editor

image

THE MOST IMPORTANT KEYS IN THE EDITOR:

+ and – on the 10-key will increase and decrease the size of the cursor.

image

image

RIGHT-CLICKING on the map will cause the selected terrain or object to be applied.

image

For mountain height, hold down the right mouse button while dragging the mouse. It’s dangerously fun.

image

image

image

When you create something in the tile editor, it is not assigned to anything in particular (a quest, a goodie hut, a city improvement, etc.) thus it is shown as a prop. It won’t do anything by default.

In one of our upcoming entries, we’ll show you how to make quests and goodie huts. But they’re fairly easy to make.  Here’s an example:

<GoodieHutTypes>
    <GoodieHutType InternalName="WhateverYouWantToCallIt">
        <Name>My Weird Village</Name>
        <Description>This weird village will give you stuff.</Description>
        <Medallions>
            <All>CaveGrassland_Medallion.png</All>
        </Medallions>
        <Destructable>1</Destructable>
        <TileDesign>WeirdVillage</TileDesign>
        <DrawnIcon>Gfx/TacticalIcons/Quest_Cave1.png</DrawnIcon>
        <IconSize>50</IconSize>

    <Treasure>
      <Title>Found Gildar!</Title>
      <Desc>Scouring the area, you find 30 gildar!</Desc>
      <Liklihood>3</Liklihood>
      <GameModifier>
        <ModType>Resource</ModType>
        <Attribute>Gold</Attribute>
        <Value>30.00</Value>
        <PerTurn>0</PerTurn>
      </GameModifier>
        <SFX>GoldPouch_1</SFX>
        <Image>Gfx\Items\Gold_Medium1.png</Image>
    </Treasure>
    </GoodieHutType>
</GoodieHutTypes>

Throw that into your quests folder and it should automatically show up in the game (I haven’t tried this yet but…in theory).

Quests, Items, Adventures

Once players get a handle on the basics, we’ll start talking about how to make items, quests, adventures, etc.

 

 

 

 

 

 

 

 

 

 

 

 

 

Sharing your Creations

You can share your creations in one of two ways.

Way #1: Impulse::Reactor

If you hit Shift-Tab you get the Impulse:Reactor overlay. One of the options is mods.

image

image

image

image

The mods available in game will eventually be heavily moderated.

For users who want to avoid our deliciously evil moderating ways, you can simply share mods with others the old fashioned way. Just drop them into your my games\elemental folder in the proper place and they’ll just show up.

For Beta 4, we’re only letting maps be shared because our moderator tools are very primitive and the map format isn’t likely to change between now and release.

One caveat about beta 4 (and it’ll be easy to find out which users didn’t read this article) – the game will spawn resources on the map even when you have chosen not to. This is a temporary thing that will be addressed by release so go ahead and continue to choose the save option to not allow things to be spawned because the game will use it later.

Hope this helps and have fun!


Comments (Page 4)
6 PagesFirst 2 3 4 5 6 
on Jul 29, 2010

damn already addicted to the editors yet not everything is in there yet!

on Jul 30, 2010

Civfreak
Oh so you can't actually mod the UI atm then? I've been going crazy trying to figure out how to modify the UI using Desktopx and reading line after line of xml trying to figure it out dohh.

 

Depending upon what you're trying to do, you can open the dxpacks with 7-zip (or other ZIP utility) and experiment with changing the component art (e.g., PNG files) and DesktopX .ini and XML outside of DesktopX.  Also, I'm not familiar with DesktopX for creating stuff, but I was able to open the dxpacks in the DesktopX builder and make some changes as a test to an Elemental dxpack file.

 

 

on Jul 30, 2010

Wow, looks promising Hope I get today my new modem - yesterday I went to the cinema and had a good excuse

Btw, I have some free space at my webserver, if there is an interest and nobody is faster, I could setup a ModWiki for Elemental during the weekend.

on Jul 30, 2010

There already is an Elemental Wiki, make a modding section there.

on Jul 30, 2010

To those having difficulty with the keypad +/- on a laptop -- every laptop I've seen DOES have a numeric keypad, it's just hidden. Look for blue or gray extra numbers/symbols on keys under the right hand... hold down the Fn key at the lower left to activate those. Keypad +/- should be included.

Morlark
I'm glad the tile editor stores rotation values in sane units.
Late to the party, I don't have it yet. If it's not radians I'll be back to chastise you.

on Jul 30, 2010

Frogboy



Quoting Annatar11,
reply 1
Thanks for the guide, Frogboy. My main interest is in quests, which sadly you haven't gone into. I am a bit worried that they seem too restrictive at the moment. Glancing at the quest XMLs it seems like they're exclusively associated with tiles, which means it's impossible to create a quest that starts from an item dropped by a creature, or a quest that has you loot quest items from creatures unrelated to the quest itself (for example, a quest to collect wolf pelts, where the pelt is a quest item and the wolves are just regular map monsters).

These are very basic quest formats, but at a glance I don't see that they're actually supported by Elemental. If that's true, the quest variety possible is rather significantly hampered, since each can only rely on very specific tiles...


True. These are things we would have to add later. At the end of the day, this IS a strategy game after all.  I agree there's a lot of interesting directions we can go with quests and such as time goes on.  

That said, you can actually make a quest that requires the player to gather various types of loot and bring back (the Rats in the Basement quest has the player bring back an item, you could have something else drop that item in a different quest or as part of loot or something).

AOW:SM had some really cool ways to trigger Quest and a lot of other events some even global events. Now that Elemental is going to replace AOW:SM for me and my friends as far as Fantay TBS goes, will it be possable to set up Events even global ones?

And if so will there be an editor that is somewhat user friendly for those of us that are no programmers?

on Jul 30, 2010

Hey Frogster, I got a thought. How about compiling all this into a PDF file with pics and explanations for us to download? Maybe include some of the posts Folcik has made as well and a few other posts in the modding section of the forums. It would be great as a "Beginners Guide". Also include a list of the locations of relevant files that are the most common that people will be modding.

Anyway, GREAT WORK. I'm really looking forward to more Modding Tutorials and to modding Elemental. I finally feel like I've found the project I've been looking for to leave my mark on the modding community. This is going to be SO EPIC. I haven't been this excited about doing mod work in a long, Long, LONG time. Thanks Brad, and a big Thank You to the Whole Team.

on Jul 30, 2010

Will we have any access to the random map generation? The fact that we can set a mountains altitude could be interesting.

on Jul 30, 2010

Raven X



Quoting BlackRainZ,
reply 41
Well, I just tried to go into a battle and it didn't give me the option for tactical battle. I have the latest version.



Did you set the "Threshold" down in the "Options"? It defaults to 4 but I turn it down to 1 so I'm guaranteed the choice in every encounter whether or not to do a tactical battle.

I wonder will we be able to set are own default for this without having to do this on every game. I too always set mine to 1 and would like for this to be my set default.  I also fight every tactical battle (I never use the Auto-Combat nor will I ever no matter the odds.)

 

on Jul 30, 2010

Raven X
Hey Frogster, I got a thought. How about compiling all this into a PDF file with pics and explanations for us to download? Maybe include some of the posts Folcik has made as well and a few other posts in the modding section of the forums. It would be great as a "Beginners Guide". Also include a list of the locations of relevant files that are the most common that people will be modding.

Knock yourself out.

I think it would probably be better if I worked on the actual game though.

on Jul 30, 2010

Disregard this one.

 

on Jul 30, 2010

Raven X
Anyway, GREAT WORK. I'm really looking forward to more Modding Tutorials and to modding Elemental. I finally feel like I've found the project I've been looking for to leave my mark on the modding community. This is going to be SO EPIC. I haven't been this excited about doing mod work in a long, Long, LONG time. Thanks Brad, and a big Thank You to the Whole Team.


Dude, I'm right there with ya.  I'm no modder, I've never modded any game in my life, don't know the first thing about it, BUT this is making me want to dive in head first and take the plunge.

 

on Jul 30, 2010

tejondour
To those having difficulty with the keypad +/- on a laptop -- every laptop I've seen DOES have a numeric keypad, it's just hidden. Look for blue or gray extra numbers/symbols on keys under the right hand... hold down the Fn key at the lower left to activate those. Keypad +/- should be included.


Quoting Morlark, reply 22I'm glad the tile editor stores rotation values in sane units.Late to the party, I don't have it yet. If it's not radians I'll be back to chastise you.

 

You just made my weekend.  That Fn key suggestion did the trick and now I'm happily crafting maps!

on Jul 30, 2010

Frogboy


Knock yourself out.

I think it would probably be better if I worked on the actual game though.

Bah, you got employees for that!!!

Besides, you're the Master Modder . We all know Modding is your Real Passion

on Jul 30, 2010

Raven X
Hey Frogster, I got a thought. How about compiling all this into a PDF file with pics and explanations for us to download? Maybe include some of the posts Folcik has made as well and a few other posts in the modding section of the forums. It would be great as a "Beginners Guide". Also include a list of the locations of relevant files that are the most common that people will be modding.

Anyway, GREAT WORK. I'm really looking forward to more Modding Tutorials and to modding Elemental. I finally feel like I've found the project I've been looking for to leave my mark on the modding community. This is going to be SO EPIC. I haven't been this excited about doing mod work in a long, Long, LONG time. Thanks Brad, and a big Thank You to the Whole Team.


I can't wait to create my Greyhawk and Forgotten Realms maps.

6 PagesFirst 2 3 4 5 6