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

Cycrow
Moderator (Script&Mod)
Moderator (Script&Mod)
Posts: 20543
Joined: Mon, 15. Nov 04, 00:26

Post by Cycrow » Fri, 12. Sep 08, 21:08

what do you need a compiler for ?

the mission director is not a programming language, its designed for a very specific task, creating missions via the use of game events.

due to the use of xml and the schema, theres no need for a "command dictionary" as everything you need is explained in the schema, you jsut need to use a program that can understand it

XGamer
Posts: 1359
Joined: Sun, 25. Apr 04, 19:09

Post by XGamer » Sat, 13. Sep 08, 14:16

All you need is the VWD 2005 Express Edition which can be downloaded for free from the Microsoft Website. Link

And for the "Command Dictionary" just open director.htm in the Director Folder with any Browser such as Internet Explorer. It lists all available Commands, Variables and stuff that you can use and explains briefly what they do.

greetz
XGamer
MD Supporter | [url=ts3server://ts3.x-tec-online.de]Join TeamSpeak3[/url] (Topics:EN|DE)
Image

Stu Austin
Posts: 1892
Joined: Tue, 23. Dec 03, 23:32

Post by Stu Austin » Wed, 24. Sep 08, 16:05

I can't find any info but is Mission Director going to be included with Terran Conflict?
Transcend Mod Team - AP, TC, Reunion

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

Post by CBJ » Wed, 24. Sep 08, 16:11

Yes, of course!

Stu Austin
Posts: 1892
Joined: Tue, 23. Dec 03, 23:32

Post by Stu Austin » Wed, 24. Sep 08, 16:15

Thanks CBJ.
Transcend Mod Team - AP, TC, Reunion

troop5
Posts: 8
Joined: Thu, 9. Oct 08, 21:11

Post by troop5 » Sun, 12. Oct 08, 09:03

Hello guys,

I'm kinda new here, is there somewhere else in the forum to ask for advice on how to get a certain mission i am working on to do what i want it to? I'm kind of running into a dead end. Would this be the place to ask?

Thanks.

XGamer
Posts: 1359
Joined: Sun, 25. Apr 04, 19:09

Post by XGamer » Sun, 12. Oct 08, 10:51

Yes, this Topic is the Very best place to ask for help regarding the Mission Director and Problems on making own missions. So just fire away :)

greetz
XGamer
MD Supporter | [url=ts3server://ts3.x-tec-online.de]Join TeamSpeak3[/url] (Topics:EN|DE)
Image

troop5
Posts: 8
Joined: Thu, 9. Oct 08, 21:11

Post by troop5 » Mon, 13. Oct 08, 04:33

Thanks for the reply.

Well what i have been working on was just trying to modify one of Xenon Slayers sample missions, it was BM04 Retrieve Unmanned Ship.

This is what it looks like, not much has changed other than giving the reward to the player.


Code: Select all

<?xml version="1.0" encoding="ISO-8859-1" ?>
<?xml-stylesheet href="director.xsl" type="text/xsl" ?>
<director name="template" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="director.xsd">
  <documentation>
    <author name="JM" alias="Troop5" contact="" />
    <content reference="MMSR01" name="More Missions Ship Retreval 01" description="Retreive Unmanned Ship"/>
    <version number="0.2" date="10/10/08" status="Sample" />
  </documentation>
  <cues>
    <cue name="MMSR01 Add Mission">
      <action>
        <add_bbs_quest name="MMSR01" priority="500" max="1"/>
      </action>
      <cues>
        <cue name="MMSR01" instantiate="static">
          <condition>
            <check_all>
              <bbs_quest_evaluated quest="MMSR01"/>
              <match_object object="{player.dockobject}" race="default"/>
            </check_all>
          </condition>
          <action>
            <do_all exact="5" comment="Checks if there is a suitable sector nearby for the unmanned ship to spawn in.">
              <find_sector name="MMSR01.Test Sector" sector="{player.sector}" min="1" max="2"/>
              <do_if value="{sector.race@MMSR01.Test Sector}" exact="{lookup.race@argon}">
                <set_sector name="MMSR01.Ship Sector" value="{sector@MMSR01.Test Sector}"/>
              </do_if>
              <do_if value="{sector.race@MMSR01.Test Sector}" exact="{lookup.race@boron}">
                <set_sector name="MMSR01.Ship Sector" value="{sector@MMSR01.Test Sector}"/>
              </do_if>
              <do_if value="{sector.race@MMSR01.Test Sector}" exact="{lookup.race@paranid}">
                <set_sector name="MMSR01.Ship Sector" value="{sector@MMSR01.Test Sector}"/>
              </do_if>
              <do_if value="{sector.race@MMSR01.Test Sector}" exact="{lookup.race@split}">
                <set_sector name="MMSR01.Ship Sector" value="{sector@MMSR01.Test Sector}"/>
              </do_if>
              <do_if value="{sector.race@MMSR01.Test Sector}" exact="{lookup.race@teladi}">
                <set_sector name="MMSR01.Ship Sector" value="{sector@MMSR01.Test Sector}"/>
              </do_if>
              <do_if value="{sector.race@MMSR01.Test Sector}" exact="{lookup.race@pirate}" comment="1.5 The Reward">
                <set_sector name="MMSR01.Ship Sector" value="{sector@MMSR01.Test Sector}"/>
              </do_if>
              <do_if value="{sector.race@MMSR01.Test Sector}" exact="{lookup.race@xenon}" comment="Double The Reward">
                <set_sector name="MMSR01.Ship Sector" value="{sector@MMSR01.Test Sector}"/>
              </do_if>
            </do_all>
          </action>
          <cues>
            <cue name="MMSR01 Mission Offer">
              <condition>
                <check_all>
                  <check_value value="{sector.exists@MMSR01.Ship Sector}" exact="1"/>
                </check_all>
              </condition>
              <action>
                <do_all>
                  <set_value name="MMSR01.Offer Race" exact="{player.dockobject.race}"/>
                  <create_actor name="MMSR01.Offer Actor" character="{random.pilot.{value@MMSR01.Offer Race}}" comment="For In Space Testing"/>
                  <set_value name="MMSR01.Random" min="0" max="100"/>
                  <offer_bbs_quest quest="MMSR01" author="{actor.name@MMSR01.Offer Actor}" text="[center][u]Ship Retreval[/u]\n\n Greetings my name is {actor.name@MMSR01.Offer Actor} and i run a small space tour company. Recently one of my transporters was attacked by pirates on the way to a pickup destination, fortunately the pilot ejected and was picked up some time later. However it seems the attackers didn't destroy or take the ship for themselves, my transponder still reads its in the vicinity. I need someone to get my ship back. I will pay 4,500Cr for the retreval. It is no farther than 2 sectors from here. Please contact me if you are interested.[/center] \n\n[center][select value='Accept']Contact {actor.name@MMSR01.Offer Actor}[/select][/center]"/>
                </do_all>
              </action>
              <cues>
                <cue name="MMSR01 Accepted">
                  <condition>
                    <bbs_quest_selected quest="MMSR01" answer="Accept"/>
                  </condition>
                  <action>
                    <do_all>
                      <accept_bbs_quest quest="MMSR01"/>
                      <set_object name="MMSR01.Offer Station" value="{player.dockobject}"/>
                      <set_sector name="MMSR01.Offer Sector" value="{player.sector}"/>
                      <set_value name="MMSR01.Mission Start Time" exact="{player.age}"/>
                      <set_value name="MMSR01.Mission Time Limit" exact="100s"/>
                      <incoming_message author="{actor.name@MMSR01.Offer Actor}" popup="1" text="Thank you for responding. The Last Known Coordinates of the ship is 10.13.8 in the {sector.name@MMSR01.Ship Sector} Sector. Please find it and return it at your convinence."/>
                      <set_value name="MMSR01.Unmanned Ship Hull" min="22" max="60"/>
                      <set_value name="MMSR01.X Position" min="5" max="15"/>
                      <set_value name="MMSR01.Y Position" min="5" max="15"/>
                      <set_value name="MMSR01.Z Position" min="5" max="15"/>
                      <create_ship name="MMSR01.Unmanned Ship" class="tp" typename="{random.type@SS_SH_A_TP|SS_SH_B_TP|SS_SH_P_TP|SS_SH_S_TP|SS_SH_T_TP|SS_SH_A_TP_1|SS_SH_B_TP_1|SS_SH_P_TP_1|SS_SH_S_TP_1|SS_SH_T_TP_1}"
                                   race="neutral" capturable="1" highlight="1" racelogic="1">
                        <position x="{value@MMSR01.X Position}km" y="{value@MMSR01.Y Position}km" z="{value@MMSR01.Z Position}km"/>
                        <sector sector="MMSR01.Ship Sector"/>
                        <equipment loadout="minimum"/>
                        <command command="none"/>
                      </create_ship>
                      <set_hull object="MMSR01.Unmanned Ship" exact="{value@MMSR01.Unmanned Ship Hull}"/>
                    </do_all>
                  </action>
                  <cues>
                    <cue name="MMSR01 Unmanned Ship Destroyed">
                      <condition>
                        <check_all>
                          <object_destroyed object="MMSR01.Unmanned Ship"/>
                        </check_all>
                      </condition>
                      <action>
                        <do_all>
                          <incoming_message author="{actor.name@MMSR01.Offer Actor}" popup="1" text="I had a bad feeling about hiring you. How could you let my ship be destroyed!? Well, not only do you NOT get paid. I have taken a substantial loss, i'll be sure not to contact you again."/>
                          <cancel_cue cue="MMSR01"/>
                        </do_all>
                      </action>
                    </cue>

                    <cue name="MMSR01 Unmanned Ship Destroyed by Player">
                      <condition>
                        <object_destroyed_by_player object="MMSR01.Unmanned Ship"/>
                      </condition>
                      <action>
                        <do_all>
                          <incoming_message author="{actor.name@MMSR01.Offer Actor}" popup="1" text="You idiot! You were suppose to retreve my ship, not destroy it! I'm considering putting this reward money into a bounty on your head!!"/>
                          <cancel_cue cue="MMSR01"/>
                        </do_all>
                      </action>
                    </cue>

                    <cue name="MMSR01 Unmanned Ship Captured">
                      <condition>
                        <match_object object="MMSR01.Unmanned Ship" race="player"/>
                      </condition>
                      <timing>
                        <time exact="3s"/>
                      </timing>
                      <action>
                        <do_all>
                          <incoming_message author="{actor.name@MMSR01.Offer Actor}" popup="1" text="You found my ship, well done! Now bring the ship back to the {object.name@MMSR01.Offer Station} in {sector.name@MMSR01.Offer Sector} for your reward. I have someone waiting to pickup the ship so be sure to have one of your own to transfer to if you are flying it in, so we may complete this transaction."/>
                        </do_all>
                      </action>
                      <cues>
                        <cue name="MMSR01 Ship Returned">
                          <condition>
                              <check_all>
                                <object_docked object="MMSR01.Unmanned Ship" param="{object@MMSR01.Offer Station}"/>
                                <check_value value="{player.ship}" exact="{object@MMSR01.Unmanned Ship}" negate="1"/>
                              </check_all>
                          </condition>
                          <action>
                            <do_all>
                              <incoming_message author="{actor.name@MMSR01.Offer Actor}" popup="1" text="Thank you for returning my ship. As promised, the sum of 4500Cr has been deposited into your Account. It's been a pleasure doing business with you."/>
                              <set_owner object="MMSR01.Unmanned Ship" race="{value@MMSR01.Offer Race}"/>
                              <reward_player>
                                <money exact="4500"/>
                              </reward_player>
                              <cancel_cue cue="MMSR01"/>
                            </do_all>
                          </action>
                        </cue>
                      </cues>
                    </cue>
                  </cues>
                </cue>
              </cues>
            </cue>
          </cues>
        </cue>
      </cues>
    </cue>
  </cues>
</director>
The problem is, the mission becomes complete only when i automate the ship to return to the destination station when i am not inside it. Which is fine but i would like to be able to fly it in myself and change ships when i get there too.

How would i go about making it work, say for example, completing only after i return the ship at the station and switch to another ship that is docked there?

I realize i can make the negate variable go away, but if i do that i get rewarded and ship is taken away as soon as i dock. But then you run into problems, flying the same ship that's not suppose to be there.

I've fooled around a bit with other things like player_changed_ship and i just cant get anywhere with this.

Any suggestions?

User avatar
Ketraar
Moderator (DevNet)
Moderator (DevNet)
Posts: 8726
Joined: Fri, 21. May 04, 17:15

Post by Ketraar » Mon, 13. Oct 08, 11:33

Hi

Code: Select all

<object_docked object="MMSR01.Unmanned Ship" param="{object@MMSR01.Offer Station}"/>
<check_value value="{player.ship}" exact="{object@MMSR01.Unmanned Ship}" negate="1"/> 
just try to use object_is_docked instead of object_docked, and it should work, since the object_docked is event driven unlike object_is_docked.

Like this

Code: Select all

<object_is_docked object="MMSR01.Unmanned Ship" param="{object@MMSR01.Offer Station}"/>
<check_value value="{player.ship}" exact="{object@MMSR01.Unmanned Ship}" negate="1"/> 
Hope that helps

MFG

Ketraar

troop5
Posts: 8
Joined: Thu, 9. Oct 08, 21:11

Post by troop5 » Tue, 14. Oct 08, 05:20

Thanks for the reply Ketraar.

I'll give this a shot and let you know if it works. :)

troop5
Posts: 8
Joined: Thu, 9. Oct 08, 21:11

Post by troop5 » Tue, 14. Oct 08, 05:49

It worked perfectly! :D

Obviously i need to go through that XMD guide more closely i think. I cant believe i missed that.

Thanks again Ketraar.

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

Post by jlehtone » Thu, 7. May 09, 08:45

Random thought: Would it be technically possible to backport X3TC MD content into X3R?

User avatar
Ketraar
Moderator (DevNet)
Moderator (DevNet)
Posts: 8726
Joined: Fri, 21. May 04, 17:15

Post by Ketraar » Thu, 7. May 09, 10:50

In general. No.

The amount of commands available in TC that are missing in X3R MD is huge. You can try though, open the TC MD files with the X3R director.xsd and you'll see.

Not to speak that there are several bugs in the X3R MD, so that I have put it aside and there is no turning back, no more X3R MD... ever!

MFG

Ketraar

Sir_Maniac
Posts: 2
Joined: Sun, 26. Apr 09, 08:57

Post by Sir_Maniac » Thu, 21. May 09, 05:45

Just curious. I haven't been able to access a string set with <set_value>. The variable {value@val} returns '0'. Is there a way to compare a string's value, or insert a string inline?

So hypothetically the following would be possible.

Code: Select all

<do_all>
  <do_choose >
    <do_when value="{value@this.colorNum}" exact="0">
      <set_value name="this.var" exact="Green"/>
    </do_when>
    <do_when value="{value@this.colorNum}" exact="1">
      <set_value name="this.var" exact="Blue"/>
    </do_when>
   <do_when value="{value@this.colorNum}" exact="3">
     <set_value name="this.var" exact="Yellow"/>
   </do_when>
   <do_when value="{value@this.colorNum}" exact="4">
     <set_value name="this.var" exact="Red"/>
   </do_when>
  </do_choose>
  
  <play_subtitles text="You have {value@this.var} lips."/>
<do_all>

User avatar
Ketraar
Moderator (DevNet)
Moderator (DevNet)
Posts: 8726
Joined: Fri, 21. May 04, 17:15

Post by Ketraar » Thu, 21. May 09, 10:55

You can't save Text in values.

MFG

Ketraar

Post Reply

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