Mission Director Basics and Installation

The place to discuss scripting and game modifications for X³: Reunion.

Moderators: Moderators for English X Forum, Scripting / Modding Moderators

Post Reply
Xenon_Slayer
EGOSOFT
EGOSOFT
Posts: 10860
Joined: Sat, 9. Nov 02, 12:45

Mission Director Basics and Installation

Post by Xenon_Slayer » Wed, 2. Jan 08, 16:55

As of X³:Reunion 2.5 the Mission Director is available to all modders who wish to use it. The Mission Director is active only in modified games, so the script editor or a mod must be active in that save game.

What is the Mission Director
The Mission Director, MD for short, is a new tool designed to create mission content in X³:Reunion. It uses an XML based mission-design framework which is editable outside of the game and acts like a plug-in. The MD is not a programming language. Programmers may find they need to think a little differently when creating missions, and newcomers may find it easier to learn than a whole language. If you understand the structure of the X-Universe, you may find the lines of code self explanatory.

Comparing the Mission Director to the Script Editor
You may be asking how the MD differs from the Script Editor, and other programming languages for that matter. You will find that some of the actions in the MD will look very similar to some of the commands used in the SE. Beyond some basic logic that is where the similarities end. If you attempted to create mission in the script editor you would be met with limitations which made development either impossible or painfully time consuming. The simple answer is that the script editor is not designed for mission development.

The Current State of the Mission Director
The Mission Director is open to you to develop and disseminate throughout the modding community, much like the Scripts and Mods. At this stage of its development the Mission Director is unsupported by Egosoft. Assistance can be obtained from volunteers on the forum, but any problems with coding or schemas will not be fixed. There are a number of known minor issues, but none of these should significantly affect your use of the Mission Director.

How to Install The Mission Director
The Mission Director files can be downloaded here: X³:Reunion Mission Director support files

The folder ‘director’ goes in the X3 Reunion directory. The folder will have no mission inside it but there are some samples in the ‘sample’ folder. They must be moved into the ‘director’ folder for use ingame.

How to Edit Mission Files
Like scripts, mission files are XML files. Unlike scripts they are edited outside of the game, so a XML editing tool is needed. We strongly recommend Microsoft Visual Web Developer 2008 Express Edition, which is available for free. Visual Studio.NET 2005/2008 and Visual Web Developer 2005 are also fine for those who already have them.

The provided Mission Director schema files help you create the XML file by displaying all available nodes and attributes as you edit the XML. This functionality is only available if the schema files are in the same folder as the XML you are editing.

The file ‘director.htm’ can be opened in any browser but it works best in IE due to limitations in XML and javascript support in other browsers. This will display all condition, action and variable documentation, as well as well as lists for several things you may need such as sound effects, pilot faces and voice numbers.

There is PDF guide provided in the director folder. This holds a full description of the Mission Directors aims, features and functionality.
Forum server status: Good <27% on fire

Lazerath
Posts: 749
Joined: Tue, 22. Mar 05, 07:31

Post by Lazerath » Wed, 2. Jan 08, 19:53

Sweet!!! :D Thanks for the update!
COMPUTER SPECS
[Mobo] SABERTOOTH 990FX R2.0
[CPU] AMD FX-9370 8 Cores 4.4 - 4.7GHZ 16MB DDR3-1866
[Cooling] Corsair Hydro Series H80I CPU Cooler System
[Video] Evga 970 GTX SC 3.5Gb Ram ==> [Ram] G-Skills Ripjaws X 16GB
[Harddrive] (2) x Samsung 850 Evo 250GB SSD
[Harddrive] Samsung 840 Series 120GB SSD ==> [Harddrive] WD BLACK 1TB 64MB 7200RPM
[Disc Player] LG 14X BLU-RAY BURNER ==> [Case] Thermaltake A71 Chaser [Windows 7 Pro]

Jakesnake5
Posts: 2874
Joined: Fri, 17. Feb 06, 05:55

Post by Jakesnake5 » Wed, 2. Jan 08, 20:13

And now all HE** is about to break loose.

<Puts on thermal suit>
Perfection is in the hands of God, we bags of dirt can only do the best we can©
Image
Modders are a source of ideas to help the Game Makers improve what they have made. Cherrish them, for they are the fruit of thy labors.©

User avatar
Stevio
Posts: 1983
Joined: Sat, 4. Jun 05, 10:36

Post by Stevio » Wed, 2. Jan 08, 20:22

Great thanks dudes ;)
your work is very much appreciated! :thumb_up:
My Scripts
Image
So say we all!

User avatar
Tenlar Scarflame
Posts: 3274
Joined: Mon, 30. May 05, 04:51

Post by Tenlar Scarflame » Wed, 2. Jan 08, 21:00

Now this looks like it might be less noob-repellant than the script editor... meaning it's right up my alley. :P

A round of applause to Ego for their continued awesomeness.
My music - Von Neumann's Children - Lasers and Tactics

I'm on Twitch! 21:15 EST Sundays. Come watch me die a lot.

User avatar
LV
Sith Lord
Posts: 6358
Joined: Wed, 6. Nov 02, 21:31

Post by LV » Wed, 2. Jan 08, 22:19

While I understand your apprieciation y'all, pointless reply's and such will be purged from this thread with Imperial Impunity :)

Serious questions/viewpoints/posts only please ladies , the rest shall perish as it's glued.
LV's TC Scripts
Readme's For All My Scripts


I felt a great disturbance in the forum, Like millions of voices cried out in terror, then were silenced

si tacuisses, philosophus mansisses

eladan
Posts: 5309
Joined: Sat, 7. Jan 06, 17:01

Post by eladan » Thu, 3. Jan 08, 00:02

Thanks XS.

How about listing the 'known minor issues' so that we know when we encounter them, and don't go off the deep end thinking it's us rather than the MD?

Galaxy613
Posts: 2517
Joined: Tue, 28. Dec 04, 03:19

Post by Galaxy613 » Thu, 3. Jan 08, 00:24

Yes, please tell us of any problems that have already been identified so we don't find "new" bugs to report about.

Anyways, thanks for all of this stuff. I can not wait to see what people make with this. I think I might make some simple "go kill 10-5 xenon/pirates in [sector name] for a reward" that X3 was previously lacking. 8)
10,000 Lightyears of awesomeness

Xenon_Slayer
EGOSOFT
EGOSOFT
Posts: 10860
Joined: Sat, 9. Nov 02, 12:45

Post by Xenon_Slayer » Thu, 3. Jan 08, 00:51

If anyone runs into anything you think is an issue you can either PM one of us or post it here or if suitable a different thread. As the MD is unsupported we will probably not be able to do anything about it other than discuss workarounds.
As for a list, that will be up to you guys as we go along sorry. As we said, there should not be any big problems.
Forum server status: Good <27% on fire

ChemODun
Posts: 320
Joined: Mon, 12. Feb 07, 22:58

Post by ChemODun » Fri, 4. Jan 08, 01:03

Error in director.xsd (in documentation tag)
existed record

Code: Select all

      <xs:element name="object_shields">
        <xs:annotation>
          <xs:documentation>
            Specified object has shield level (percentage)
          </xs:documentation>
        </xs:annotation>
        <xs:complexType>
          <xs:attributeGroup ref="condition" />
          <xs:attributeGroup ref="object">
            <xs:annotation>
              <xs:documentation>
                Object to check (player ship if not specified)
              </xs:documentation>
            </xs:annotation>
          </xs:attributeGroup>
          <xs:attributeGroup ref="range">
            <xs:annotation>
              <xs:documentation>
                Hull percentage
              </xs:documentation>
            </xs:annotation>
          </xs:attributeGroup>
        </xs:complexType>
      </xs:element>
must be

Code: Select all

      <xs:element name="object_shields">
        <xs:annotation>
          <xs:documentation>
            Specified object has shield level (percentage)
          </xs:documentation>
        </xs:annotation>
        <xs:complexType>
          <xs:attributeGroup ref="condition" />
          <xs:attributeGroup ref="object">
            <xs:annotation>
              <xs:documentation>
                Object to check (player ship if not specified)
              </xs:documentation>
            </xs:annotation>
          </xs:attributeGroup>
          <xs:attributeGroup ref="range">
            <xs:annotation>
              <xs:documentation>
                Shield percentage
              </xs:documentation>
            </xs:annotation>
          </xs:attributeGroup>
        </xs:complexType>
      </xs:element>
i.e. exist Hull percentage, must be Shield percentage

append.

Exist text:

Code: Select all

      <xs:element name="remove_inventory">
        <xs:annotation>
          <xs:documentation>
            Add item to player inventory
          </xs:documentation>
        </xs:annotation>
....
must be

Code: Select all

      <xs:element name="remove_inventory">
        <xs:annotation>
          <xs:documentation>
            Remove item from player inventory
          </xs:documentation>
        </xs:annotation>
i.e. exist Add item to player inventory, must be Remove item from player inventory
Multiply entropy by absolute zero

Ñâîáîäà ñðåäè çâåçä / Freedom in space

ChemODun
Posts: 320
Joined: Mon, 12. Feb 07, 22:58

Post by ChemODun » Fri, 4. Jan 08, 10:53

May I propouse create new event for any object:
object_comm_initiated_by_player.

This event must be occur when player try establish communication whith any object (via standart comm)
Multiply entropy by absolute zero

Ñâîáîäà ñðåäè çâåçä / Freedom in space

CBJ
EGOSOFT
EGOSOFT
Posts: 35995
Joined: Tue, 29. Apr 03, 00:56

Post by CBJ » Fri, 4. Jan 08, 10:59

You seem to have missed the part about the MD being unsupported in X3. There will be no changes to this technology preview release.

jlehtone
Posts: 17092
Joined: Sat, 23. Apr 05, 21:42

Post by jlehtone » Fri, 4. Jan 08, 11:51

Doesn't technology preview imply the possibility that in future there may be a product containing such technology? And not just that, but that the feedback received for the preview might actually influence the decisions about how the technology could be in the product, should one become tangible?

If so, proposals are such feedback and good, but the proposer can not expect response, perhaps ever. DevNet?
Goner Pancake Protector X
Insanity included at no extra charge.
There is no Box. I am the sand.

User avatar
Sandalpocalypse
Posts: 4115
Joined: Tue, 2. Dec 03, 23:28

Post by Sandalpocalypse » Fri, 4. Jan 08, 11:51

I read the documentation. This is looking good. I'm no programmer and the MSCI always intimidated me. MD seems more straightforward...

Any news on the Steam patch? :x

CBJ
EGOSOFT
EGOSOFT
Posts: 35995
Joined: Tue, 29. Apr 03, 00:56

Post by CBJ » Fri, 4. Jan 08, 12:53

jlehtone wrote:Doesn't technology preview imply the possibility that in future there may be a product containing such technology? And not just that, but that the feedback received for the preview might actually influence the decisions about how the technology could be in the product, should one become tangible?

If so, proposals are such feedback and good, but the proposer can not expect response, perhaps ever. DevNet?
Yes, you are absolutely right. Feedback is indeed welcome; the point I was making (perhaps rather more tersely than was strictly necessary) was that any such feedback won't be acted upon in the current product, so people shouldn't post with that expectation. In penance for my shortness in the last reply, I'll divulge a little snippet of information that I probably shouldn't: player comms integration is one of the MD features that is already under development for whatever future product the MD might be used in.
Sandalpocalypse wrote:Any news on the Steam patch?
As far as I'm aware it is already available from Steam.

Post Reply

Return to “X³: Reunion - Scripts and Modding”