Previous Page
Map Making Tutorials
Data Module
If you haven't completed Part One of this tutorial yet, you can find it [here].
If you would like to jump straight into this tutorial without having to go through the terrain and trigger tutorials, you can use the map that we have been working on in those tutorials, located [here].
Get acquainted with the Data Module by editing existing data for units, abilities, effects, and weapons.
When we finish this tutorial, we will have a modified Jim Raynor (Commando) unit with extra health, armor, different abilities, and a modified weapon.
StarCraft II comes packed with hundreds of pre-made units, doodads, tilesets, and abilities. But what if we wanted to create a map with an entirely new unit or ability? Or a map where Dark Templar could Blink, and Battlecruisers had no armor but insane health? The Data Module is where we can set all of that up. In fact, the Data Module lets us modify almost everything about StarCraft II.
In this tutorial, we will go over ways to modify existing data including modifying unit health, armor, starting energy, adding and removing existing abilities to units, and modifying weapon firing rates and damage.
To open up the Data Module, press [F7] or click on the Data Module button from the toolbar at the top of any of the other editor modules. The Data Module button has a picture of a blue Marine on it.
The Data Module window looks intimidating on first glance. There are tables full of words in small fonts and drop-down menus with a lot of options whose purposes might not be that intuitive. Once we explain how things are organized, however, it won't feel so daunting.
We can think of Data in StarCraft II like a tree. Each map in StarCraft II has at least one “Mod” attached to it that contains information about the units, abilities, weapons, tilesets, effects, UI, etc. that can be used on that map
- Catalog
This trunk is broken into different "Catalogs" of data. “Units” are a catalog. “Abilities” are a separate catalog. These catalogs work together to form the game data as a whole. - Object
Each catalog contains "Objects," which are specific entries in that catalog. In the Units catalog, "Marine" is an object. "Stalker" is another object. - Field
Each Object contains a list of "Fields" that are associated with it. These are the types of information that define each unit. For the Marine object, "Life Maximum" is a field. "Abilities" is another field. - Value
Each field has one or more "Values." Some are a single value, like "Life Maximum." The Marine’s Life Maximum is 45. Some have a list of values, like "Abilities," since each unit can have multiple abilities.
Before we start working, we're going to set a couple of options like we did in the Trigger Module tutorial. Keep in mind that all of the options that we are going to set are for the sole purpose of following along with the pictures in this tutorial. There is no right or wrong way to set up your editor to work; so experiment and see what works best for you.
- View Raw Data
We're going to turn this option OFF. Every object has an ID that it is referred to with, and it has an associated text value that is its name. Take the unit we are going to be modifying, Jim Raynor (Commando), for example. His ID is just Raynor, but his name is Jim Raynor (Commando). Show Raw Data would let us view Raynor instead of Jim Raynor (Commando). - Display Object List As Tree
We're going to turn this option OFF. Show Object List organizes the list of objects into folders based on categories, so that you can look through the objects list like you do when looking through folders on your computer. - Display All Object Sources
We're going to turn this option OFF. As we modify data, we don't modify the game data for the entire game; we just modify the data for our particular map. This new data is stored in the map we're making. Toggling this option ON will show us the original data as one entry, and our new, modified data as a different entry when we modify existing units. Since we have the option set to OFF, when we change our unit, Jim Raynor (Commando), we won't see two entries for the unit, just one. - Show Object Explorer
We're going to turn this option ON. Explorer view is good for showing you what objects are connected to other objects in data. If we're viewing Jim Raynor (Commando) and we want to look at his weapon data really quick, we can find his weapon in the Explorer section and select it to show its data, rather than navigating to the Weapons tab and finding his weapon in the list of weapons in the game. - Table View
We're going to turn this option ON. When this option is turned ON, we see a table with a list of object fields on the left, and field values on the right. Double-clicking on a field or value will bring up a new window with controls to edit the value. Turning this option ON will automatically turn Detail View and XML View off. - Detail View
We're going to turn this option OFF. When this option is turned ON, instead of seeing a table with a list of fields and values, we will see all of the controls for editing those values. Turning this option ON will automatically turn Table View and XML View off. - XML View
We're going to turn this option OFF. When this option is turned ON, we see a text editor view of the data, which is formatted in XML. All of the game data in StarCraft II is stored and read by the game in this format. The Data Module’s main purpose is to make this data easier to read and modify for those unfamiliar XML. We will go into more detail about this view in another tutorial. Turning this option ON will automatically turn Table View and Detail View off. - Show Default Values
We're going to turn this option ON. Instead of storing every value of every field for every unit, we save space by storing some default values for some objects, and then setting up new objects so that they "inherit" values from these first, or parent, objects. In the editor, these default values show up grey, and can be hidden by toggling this option ON. This can be confusing if we're looking for a value that hasn't been explicitly set for a unit, because it will be hidden to us. - Show Advanced Values
We're going to turn this option ON. By default, certain fields that require a detailed knowledge of game data are hidden. Experienced users may need to use these fields to implement more advanced functionality. These fields can be shown by toggling this option ON. - Show Field Type Names
We're going to turn this option OFF. Fields are organized by "field type," so that all fields related to unit behaviors or unit abilities, are grouped together in Table View. Sometimes this is helpful for finding fields, but sometimes it can be confusing if you don't know what field type your desired field is grouped under. For now, we are going to leave it OFF. - Combine Structure Values
We're going to turn this option ON. Some object fields are related. Double-clicking on any one of the related fields will bring up the same window with controls for all of the related fields. An example of this is Unit Command Card fields. Turning this option ON will combine all of those fields in Table View into one field with a "+" sign after the field name. - XML Syntax Highlighting
We're going to turn this option ON. Some object fields are related. Double-clicking on any one of the related fields will bring up the same window with controls for all of the related fields. An example of this is Unit Command Card fields. Turning this option ON will combine all of those fields in Table View into one field with a "+" sign after the field name. - Commit XML Changes
This button is greyed out unless you have uncommitted XML data changes while working in XML view. We aren’t using XML view in this tutorial, so we won’t use this button.
Reported!
[Close]Comments (52)
please reply
Bottom line: you didn't, Blizzard just sucks at keeping things up-to-date.
BAD: I think this tutorial makes a mistake (although clearly motivated by good intentions). When reviewing the steps to configure the Data Editor’s view, each button that affects the view is listed as a separate step.
This is counter-intuitive, because most of these buttons work like “radio buttons”. Therefore, it does not consist of separate steps to set Table View ON, Detail View OFF, and XML View OFF. There is only one step involved: click Table View. Done.
It’s pretty clear that the tutorial’s goal is to describe what the other options do, providing an overview-level understanding of the different views in the data editor. I think that’s a great thing to do! And I appreciated having that information provided in this tutorial.
The only issue is that this extra info is presented as **separate steps**. Again: they require only **one** step on the user’s part, because they function as radio buttons.
I would have included the same information, but grouped it differently. For example, since the tutorial is using Table View, I would have put the descriptions for Detail View and XML View “within” the step that sets Table View ON, using indentation/formatting/styling to distinguish them as “supplementary information” rather than “steps to get the user’s Data Editor to match the tutorial.”
If any community managers, authors, devs, or other Blues are reading this, I’d like to request someone revisits this article to make edits along these lines.
----
That said, I can’t overstate enough how pleased I am that SC2 Editor Guides are available on this site! This is of huge benefit to me (and many others, I hope!), and I would love to see more of this. ☺
Thank you for the tutorials, they are still awesome. :^)
cause at first it starts off all blaack and i have no clue what to do after that any suggestions?
okay what you do is hit new page top left then when it gives you the settings it will show (liberty)melee change that to campaign
because if you didn't change it you will have only what you can use in a quick match.
Sniper rifle round just animates standard attack - but at least it animates something. I guess I can mess around with that to make Raynor "line up the shot". Basically, can anyone explain what the time parameters stand for? Why have we changed the grenade throw from -1.0 to 1.5 , WHY is it negative in the first place? Wouldn't that mean that the animation happens BEFORE we click it? (obviously pretty hard, since the code would need to literally read the user's mind). Anyone able to steer me in the right direction?