[DISCUSSION+REGISTRATION] - MSCI Reference

The place to discuss scripting and game modifications for X³: Terran Conflict and X³: Albion Prelude.

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

mark_a_condren
Posts: 1468
Joined: Wed, 3. Aug 05, 05:05
x3tc

Post by mark_a_condren » Thu, 25. Aug 11, 15:32

X2-Illuminatus wrote:IIRC mark_a_condren already posted a pdf- or word-document somewhere with some pieces of information about several script commands. Maybe that can be used as basis.
Links to docs

These are the same file just different formats. They are very much a VIP, they were started so i could build an offline version but they never got very far. You are most welcome to look at them and continue them if you like.

MSCI Scripting Code for X3TCv2_5_PDF_v1.pdf

MSCI Scripting Code for X3TCv2_5_Open_Office.odt

They are both hosted on the X3TC Google code site here


MarCon

User avatar
EmperorJon
Posts: 9378
Joined: Mon, 29. Dec 08, 20:58
x3tc

Post by EmperorJon » Sun, 18. Dec 11, 22:25

I just realised, the new AP script commands being (hopefully) explained in the Survival Guide... is kind of pointless when they could just be put up in the MSCI reference...?
______
I'm Jon. I'm mostly not around any more. If you want to talk, please message me! It's cool.
______

Cycrow
Moderator (Script&Mod)
Moderator (Script&Mod)
Posts: 22201
Joined: Sun, 14. Nov 04, 23:26
x4

Post by Cycrow » Sun, 18. Dec 11, 23:23

ChristmasJon wrote:I just realised, the new AP script commands being (hopefully) explained in the Survival Guide... is kind of pointless when they could just be put up in the MSCI reference...?
they'll be in both

User avatar
peroxyde
Posts: 2230
Joined: Sun, 2. Apr 06, 00:12
x3tc

Post by peroxyde » Tue, 27. Mar 12, 00:14

Hello!
I'm a french scripter (member of NH-team), and will enjoy to help in this huge work.

There's lot of commands i need to test to understand how they works, so if i could share my results, i'll do it with pleasure!

So please sign me in!

User avatar
apricotslice
Posts: 14129
Joined: Sun, 16. May 04, 13:01
x4

Post by apricotslice » Tue, 27. Mar 12, 02:40

Just as a matter of interest, why are there commands in the indexes with no direct link ?

Without a direct link, its almost impossible to find anything, and I was looking for one of them yesterday to find the meaning of one of the feilds. As I found out later, lack of that field because I didnt understand what it wanted, was why the command failed to work.

The documentation isnt much use if you cant easily find it.

User avatar
ScRaT_GER
Posts: 1962
Joined: Tue, 8. Jan 08, 18:19
x3tc

Post by ScRaT_GER » Tue, 27. Mar 12, 10:28

Normally, if there is no direct link, than this command isn't documented.

User avatar
DrBullwinkle
Posts: 5715
Joined: Sat, 17. Dec 11, 01:44
x3tc

Post by DrBullwinkle » Tue, 27. Mar 12, 10:34

Is there a searchable list of MCSI commands anywhere?

I often find myself looking for a command, but do not know which section to check. I search the MCSI Handbook, but that is two games out of date. I can search the individual pages of the MCSI Reference thread, but then I have to search multiple pages every time I want to look something up.

(Which, in my case, happens frequently.) :)

User avatar
peroxyde
Posts: 2230
Joined: Sun, 2. Apr 06, 00:12
x3tc

Post by peroxyde » Tue, 27. Mar 12, 11:35

apricotslice wrote:Just as a matter of interest, why are there commands in the indexes with no direct link ?
There are direct link. But as Scrat said, and as it's written :
(x ... marks unlinked script commands)
Direct link exist in indexes for documented commands (without mark) or with WiP mark



I often find myself looking for a command, but do not know which section to check.
+1


And another question : should we receive a MP when (and if) we have access to the MCSi forum?
[ external image ]
"On apprend en faisant des erreurs, mais le problème c'est qu'en explosifs, l'erreur est fatale." Aldébaran v10
[ external image ]<-- Clef Des Toilettes Privées Du Forum Français décernée par Thoto le 23/06/07

User avatar
Ketraar
EGOSOFT
EGOSOFT
Posts: 11741
Joined: Fri, 21. May 04, 17:15
x4

Post by Ketraar » Tue, 27. Mar 12, 12:24

Access is only for those that will be posting Topics explaining the commands. There is no discussion in that forum. Any questions, suggestions, etc go here.

MFG

Ketraar
Image

User avatar
peroxyde
Posts: 2230
Joined: Sun, 2. Apr 06, 00:12
x3tc

Post by peroxyde » Tue, 27. Mar 12, 17:52

This is why I applied for registration. ^^
But I can leave the description here, if you prefer :





<RetVar/IF><RefObj> fire missile <Var/Ware> on <Value>

=====================================================

[skip|else] if [not]|while[not]|<no returnvalue>|<RetVar/IF> = <RefObj> fire missile <Var/Ware> on <Value>


[skip|else] if [not]|while [not]| = The possible 'Conditional' statements that can be used with this command.
<no returnvalue>|<RetVar/IF> The possible return of the command
<RefObj> The ship (or variable containing it) which fires the missile
<Var/Ware> missile type (or a variable containing it) which is launched
<Value> Variable containing the targeted object



This command allow a ship to fire a missile on a target.

The Missiles don't need to be installed to be fired, but they need to exist at least in the cargo bay.

Of course, the missile must be compatible with the ship which launch it.

A valid target is needed and, for some missile type, this target must be an ennemy.

The return value if the command fail is null and [TRUE] if it succeed.



------------------

Exemple:

$Target = [playership] -> find nearest enemy ship: max.dist = 5000
$missile = [playership] -> find best missile for target $Target
= [playership] -> fire missile $missile on $Target

-----------------

Note :

Often, the command fails even if all parameters have been checked. (I don't know why)
To force a ship to launch a missile, a while is useful:

$launched = null
while not $launched
|  skip if $Ship -> get volume of ware $missile in cargo bay
|  |   break
|  skip if $Target -> exist
|  |   break
|  $launched = $Ship -> fire missile $missile on $Target
|  = wait 100 ms
end




Command location:

           »» Fly Commands
           <RetVar/IF><RefObj> fire missile <Var/Ware> on <Value>
[ external image ]
"On apprend en faisant des erreurs, mais le problème c'est qu'en explosifs, l'erreur est fatale." Aldébaran v10
[ external image ]<-- Clef Des Toilettes Privées Du Forum Français décernée par Thoto le 23/06/07

Orfevs
Posts: 183
Joined: Thu, 22. Jan 09, 23:03
x3tc

Post by Orfevs » Fri, 30. Mar 12, 03:00

There's something I feel is missing from the MSCI index.

Not exactly commands, but rather "allowed syntax" that could be used in-game. Message codes and colors included. I have no idea if special characters can be added through the MSCI editor in-game. I never use it.
However, that doesn't mean you can't use special characters.

Syntax is something I'm closely familiar with though, as I'm still programming on my long winded auto-naming plugin.
(Got tired of the whole thing a while back, but it's working very well now - I'll share it soon™).

By syntax I mean crucial stuff such as using square brackets [ ] in a message or name without adding a proper code yields an empty message from "unknown" the same way colors did pre v3.1.

It's something that should be emphasized.
TCAN TC/AP Artificial Life, Menudriven Automated Ship/Station Namer
Spex: i7 4790K@4Ghz 16Gb DDR3 GTX970Strix(4Gb)
X:R 454 Hours. 15 hours unmodded.

User avatar
apricotslice
Posts: 14129
Joined: Sun, 16. May 04, 13:01
x4

Post by apricotslice » Fri, 30. Mar 12, 03:06

Orfevs wrote:There's something I feel is missing from the MSCI index.

Not exactly commands, but rather "allowed syntax" that could be used in-game. Message codes and colors included. I have no idea if special characters can be added through the MSCI editor in-game. I never use it.
However, that doesn't mean you can't use special characters.

By syntax I mean crucial stuff such as using square brackets [ ] in a message or name without adding a proper code yields an empty message from "unknown" the same way colors did pre v3.1.

It's something that should be emphasized.
I'd agree with that.

The mechanism for interacting with the t files should be documented and thats part of this, as I've seen colours be changed by using t files.

User avatar
Ketraar
EGOSOFT
EGOSOFT
Posts: 11741
Joined: Fri, 21. May 04, 17:15
x4

Post by Ketraar » Fri, 30. Mar 12, 12:08

peroxyde wrote:This is why I applied for registration. ^^
Right, guess none of the MSCI Forum mods has seen it yet. Give it some time and I'm sure someone from there will "fix" that.

MFG

Ketraar
Image

User avatar
apricotslice
Posts: 14129
Joined: Sun, 16. May 04, 13:01
x4

Post by apricotslice » Fri, 30. Mar 12, 12:09

I notice none of the wing commands have been done yet.

Please ?

User avatar
X2-Illuminatus
Moderator (Deutsch)
Moderator (Deutsch)
Posts: 24950
Joined: Sun, 2. Apr 06, 16:38
x4

Post by X2-Illuminatus » Fri, 30. Mar 12, 13:53

peroxyde wrote:This is why I applied for registration. ^^
But I can leave the description here, if you prefer :
I added you to the MSCI group now. Welcome to the team. You should now be able to create and answer topics in the MSCI forum. If that's not yet the case, try to log out and log in again and/or delete your browser's cookies.

If you have any questions feel free to ask in the MSCI forum, here or via PM.
Orfevs wrote:Syntax is something I'm closely familiar with though,...
Sounds like you're volunteering for writing such a syntax article. :) Should I also add you to the group?
Nun verfügbar! X3: Farnham's Legacy - Ein neues Kapitel für einen alten Favoriten

Die komplette X-Roman-Reihe jetzt als Kindle E-Books! (Farnhams Legende, Nopileos, X3: Yoshiko, X3: Hüter der Tore, X3: Wächter der Erde)

Neuauflage der fünf X-Romane als Taschenbuch

The official X-novels Farnham's Legend, Nopileos, X3: Yoshiko as Kindle e-books!

Orfevs
Posts: 183
Joined: Thu, 22. Jan 09, 23:03
x3tc

Post by Orfevs » Fri, 30. Mar 12, 22:49

I was hoping for a more advisory role, but what the heck. Sign me up!
TCAN TC/AP Artificial Life, Menudriven Automated Ship/Station Namer
Spex: i7 4790K@4Ghz 16Gb DDR3 GTX970Strix(4Gb)
X:R 454 Hours. 15 hours unmodded.

User avatar
apricotslice
Posts: 14129
Joined: Sun, 16. May 04, 13:01
x4

Post by apricotslice » Sat, 31. Mar 12, 04:35

Orfevs wrote:I was hoping for a more advisory role, but what the heck. Sign me up!
Do or do not, there is no advise. :lol:

User avatar
X2-Illuminatus
Moderator (Deutsch)
Moderator (Deutsch)
Posts: 24950
Joined: Sun, 2. Apr 06, 16:38
x4

Post by X2-Illuminatus » Sun, 1. Apr 12, 14:59

I was hoping for a more advisory role, but what the heck. Sign me up!
That's the spirit. :) Welcome to the team.
Nun verfügbar! X3: Farnham's Legacy - Ein neues Kapitel für einen alten Favoriten

Die komplette X-Roman-Reihe jetzt als Kindle E-Books! (Farnhams Legende, Nopileos, X3: Yoshiko, X3: Hüter der Tore, X3: Wächter der Erde)

Neuauflage der fünf X-Romane als Taschenbuch

The official X-novels Farnham's Legend, Nopileos, X3: Yoshiko as Kindle e-books!

Orfevs
Posts: 183
Joined: Thu, 22. Jan 09, 23:03
x3tc

Post by Orfevs » Sun, 1. Apr 12, 16:09

Thankee!

I'll soon add an article on script and textfile syntax.
Just have get the rough outline down first.
TCAN TC/AP Artificial Life, Menudriven Automated Ship/Station Namer
Spex: i7 4790K@4Ghz 16Gb DDR3 GTX970Strix(4Gb)
X:R 454 Hours. 15 hours unmodded.

eladan
Posts: 7168
Joined: Sat, 7. Jan 06, 16:01
x4

Post by eladan » Mon, 2. Apr 12, 12:36

Not sure how useful my 3+ year old knowledge will be, or how often I'll be around, but sign me up and I'll try to help.

Post Reply

Return to “X³: Terran Conflict / Albion Prelude - Scripts and Modding”